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

package/dist/esm/core/errors/errors-builder.frontend.services.d.ts

@@ -62,8 +62,8 @@ export declare class ErrorBuilderFrontend {
  * - Single source of truth for error building
  * - Automatic context propagation to ErrorBoundary and RouterErrorBoundary errors
  *
- * User context is managed by ErrorContext, which listens to USER_LOGIN and
- * PRIMARY_SCOPE_CHANGED events (for organization changes) and updates this shared instance.
+ * User context is managed by ErrorContext, which listens to USER_LOGIN / USER_LOGOUT (the person
+ * arriving and leaving) and PRIMARY_SCOPE_CHANGED (organization changes) and updates this shared instance.
  */
 export declare const sharedErrorBuilder: ErrorBuilderFrontend;
 //# sourceMappingURL=errors-builder.frontend.services.d.ts.map

package/dist/esm/core/errors/errors-builder.frontend.services.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"errors-builder.frontend.services.d.ts","sourceRoot":"","sources":["../../../../src/core/errors/errors-builder.frontend.services.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,2BAA2B,EAE3B,SAAS,EACT,kBAAkB,EAClB,mBAAmB,EAEpB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAGvC;;;GAGG;AACH,qBAAa,oBAAoB;IAC/B,OAAO,CAAC,cAAc,CAAC,CAAS;IAChC,OAAO,CAAC,MAAM,CAAC,CAAS;gBAEZ,OAAO,CAAC,EAAE;QACpB,cAAc,CAAC,EAAE,MAAM,CAAC;QACxB,MAAM,CAAC,EAAE,MAAM,CAAC;KACjB;IAKD,oBAAoB,CAAC,cAAc,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI;IAI9D,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI;IAM9C,wBAAwB,CACtB,SAAS,EAAE,SAAS,EACpB,OAAO,GAAE;QACP,sBAAsB,CAAC,EAAE,2BAA2B,CAAC;QACrD,gBAAgB,CAAC,EAAE,MAAM,CAAC;QAC1B,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;KACzB,GACL,mBAAmB;IA4BtB,qBAAqB,CAAC,YAAY,EAAE,kBAAkB,GAAG,mBAAmB;IAiB5E;;;;;;;OAOG;IACH,eAAe,CACb,KAAK,EAAE,KAAK,EACZ,SAAS,EAAE,SAAS,EACpB,iBAAiB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC1C,mBAAmB;IAgBtB;;;;;;;OAOG;IACH,gBAAgB,CACd,KAAK,EAAE,GAAG,EACV,MAAM,CAAC,EAAE,MAAM,EACf,iBAAiB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC1C,mBAAmB;IA0CtB;;;;;;OAMG;IACH,mBAAmB,CACjB,KAAK,EAAE,GAAG,EACV,iBAAiB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC1C,mBAAmB;IAiBtB;;;;;;OAMG;IACH,iBAAiB,CACf,KAAK,EAAE,GAAG,EACV,iBAAiB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC1C,mBAAmB;CAcvB;AAED;;;;;;;;;;GAUG;AACH,eAAO,MAAM,kBAAkB,sBAA6B,CAAC"}
+{"version":3,"file":"errors-builder.frontend.services.d.ts","sourceRoot":"","sources":["../../../../../src/core/errors/errors-builder.frontend.services.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,2BAA2B,EAE3B,SAAS,EACT,kBAAkB,EAClB,mBAAmB,EACwD,MAAM,uBAAuB,CAAC;AAC3G,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAGvC;;;GAGG;AACH,qBAAa,oBAAoB;IAC/B,OAAO,CAAC,cAAc,CAAC,CAAS;IAChC,OAAO,CAAC,MAAM,CAAC,CAAS;gBAEZ,OAAO,CAAC,EAAE;QACpB,cAAc,CAAC,EAAE,MAAM,CAAC;QACxB,MAAM,CAAC,EAAE,MAAM,CAAC;KACjB;IAKD,oBAAoB,CAAC,cAAc,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI;IAI9D,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI;IAM9C,wBAAwB,CACtB,SAAS,EAAE,SAAS,EACpB,OAAO,GAAE;QACP,sBAAsB,CAAC,EAAE,2BAA2B,CAAC;QACrD,gBAAgB,CAAC,EAAE,MAAM,CAAC;QAC1B,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;KACzB,GACL,mBAAmB;IA4BtB,qBAAqB,CAAC,YAAY,EAAE,kBAAkB,GAAG,mBAAmB;IAiB5E;;;;;;;OAOG;IACH,eAAe,CACb,KAAK,EAAE,KAAK,EACZ,SAAS,EAAE,SAAS,EACpB,iBAAiB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC1C,mBAAmB;IAgBtB;;;;;;;OAOG;IACH,gBAAgB,CACd,KAAK,EAAE,GAAG,EACV,MAAM,CAAC,EAAE,MAAM,EACf,iBAAiB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC1C,mBAAmB;IA0CtB;;;;;;OAMG;IACH,mBAAmB,CACjB,KAAK,EAAE,GAAG,EACV,iBAAiB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC1C,mBAAmB;IAiBtB;;;;;;OAMG;IACH,iBAAiB,CACf,KAAK,EAAE,GAAG,EACV,iBAAiB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC1C,mBAAmB;CAcvB;AAED;;;;;;;;;;GAUG;AACH,eAAO,MAAM,kBAAkB,sBAA6B,CAAC"}

package/dist/esm/core/errors/errors-builder.frontend.services.js

@@ -1,4 +1,4 @@
-import { ERROR_DEFINITIONS, ErrorHandling_Strategy, ErrorType, ResourceOperationRiskLevel, } from '@wildo-ai/saas-models';
+import { ERROR_DEFINITIONS, ErrorHandling_Strategy, ErrorType, ResourceOperationRiskLevel, WebSocketSystemErrorCode, describeCaughtError } from '@wildo-ai/saas-models';
 import { ErrorManagementService } from './error-management.frontend.service.js';
 /**
  * Frontend Error Builder
@@ -125,13 +125,13 @@ export class ErrorBuilderFrontend {
      * @returns WildoError_Frontend instance
      */
     buildWebSocketError(error, additionalContext) {
-        const errorType = additionalContext?.errorCode === 'RATE_LIMIT_EXCEEDED'
+        const errorType = additionalContext?.errorCode === WebSocketSystemErrorCode.RATE_LIMIT_EXCEEDED
             ? ErrorType.RATE_LIMIT
             : ErrorType.NETWORK;
         return this.buildWildoError_Frontend(errorType, {
             context: {
                 source: 'websocket',
-                errorMessage: error instanceof Error ? error.message : String(error),
+                errorMessage: describeCaughtError(error),
                 ...(additionalContext || {}),
             },
         });
@@ -147,7 +147,7 @@ export class ErrorBuilderFrontend {
         return this.buildWildoError_Frontend(ErrorType.UNCAUGHT_EXCEPTION, {
             context: {
                 source: 'promise',
-                errorMessage: error instanceof Error ? error.message : String(error),
+                errorMessage: describeCaughtError(error),
                 errorStack: error instanceof Error ? error.stack : undefined,
                 ...(additionalContext || {}),
             },
@@ -162,8 +162,8 @@ export class ErrorBuilderFrontend {
  * - Single source of truth for error building
  * - Automatic context propagation to ErrorBoundary and RouterErrorBoundary errors
  *
- * User context is managed by ErrorContext, which listens to USER_LOGIN and
- * PRIMARY_SCOPE_CHANGED events (for organization changes) and updates this shared instance.
+ * User context is managed by ErrorContext, which listens to USER_LOGIN / USER_LOGOUT (the person
+ * arriving and leaving) and PRIMARY_SCOPE_CHANGED (organization changes) and updates this shared instance.
  */
 export const sharedErrorBuilder = new ErrorBuilderFrontend();
 //# sourceMappingURL=errors-builder.frontend.services.js.map

package/dist/esm/core/errors/errors-builder.frontend.services.js.map

@@ -1 +1 @@
-{"version":3,"file":"errors-builder.frontend.services.js","sourceRoot":"","sources":["../../../../src/core/errors/errors-builder.frontend.services.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n  ERROR_DEFINITIONS,\n  ErrorCustomMessageReference,\n  ErrorHandling_Strategy,\n  ErrorType,\n  WildoError_Backend,\n  WildoError_Frontend,\n  ResourceOperationRiskLevel,\n} from '@wildo-ai/saas-models';\nimport type { ErrorInfo } from 'react';\nimport { ErrorManagementService } from './error-management.frontend.service';\n\n/**\n * Frontend Error Builder\n * Creates unified error configurations and WildoError_Frontend instances for client-side use\n */\nexport class ErrorBuilderFrontend {\n  private organizationId?: string;\n  private userId?: string;\n\n  constructor(context?: {\n    organizationId?: string;\n    userId?: string;\n  }) {\n    this.organizationId = context?.organizationId;\n    this.userId = context?.userId;\n  }\n\n  updateOrganizationId(organizationId: string | undefined): void {\n    this.organizationId = organizationId;\n  }\n\n  updateUserId(userId: string | undefined): void {\n    this.userId = userId;\n  }\n  \n  \n\n  buildWildoError_Frontend(\n    errorType: ErrorType,\n    options: {\n      customMessageReference?: ErrorCustomMessageReference,\n      operationPathKey?: string,\n      context?: Record<string, any>\n    } = {}\n  ): WildoError_Frontend {\n\n    const errorDefinition = ERROR_DEFINITIONS[errorType];\n\n    return {\n      type: errorType,\n      severity: errorDefinition.severity,\n      customMessageReference: options.customMessageReference || errorDefinition.defaultCustomMessageReference,\n      timestamp: new Date(),\n      organizationId: this.organizationId ?? undefined,\n      userId: this.userId ?? undefined,\n      operationPathKey: options.operationPathKey ?? undefined,\n\n      // Frontend actions and config\n      frontendActions: errorDefinition.frontendActions || [],\n      redirectPolicy: errorDefinition.redirectPolicy,\n      errorHandlingStrategy: errorDefinition.errorHandlingStrategy ?? ErrorHandling_Strategy.STOP,\n      retryPolicy: errorDefinition.retryPolicy,\n      maxRetries: errorDefinition.maxRetries,\n      initialDelay: errorDefinition.initialDelay,\n      baseDelay: errorDefinition.baseDelay,\n      \n      showToUser: errorDefinition.showToUser ?? true,\n      context: options.context ?? undefined,\n    };\n  }\n\n\n  buildFromBackendError(backendError: WildoError_Backend): WildoError_Frontend {\n    // Type-safe access to backend error properties\n    const errorType: ErrorType = (backendError as WildoError_Backend).type;\n    const customMessageReference: ErrorCustomMessageReference = (backendError as WildoError_Backend).customMessageReference;\n    const operationPathKey: string | undefined = (backendError as WildoError_Backend).operationPathKey;\n    const context: Record<string, any> | undefined = (backendError as WildoError_Backend).context;\n    \n    return this.buildWildoError_Frontend(\n      errorType,\n      {\n        customMessageReference: customMessageReference ?? undefined,\n        operationPathKey: operationPathKey ?? undefined,\n        context: context ?? undefined\n      }\n    );\n  }\n\n  /**\n   * Build error from React component error\n   * \n   * @param error - The Error object from React\n   * @param errorInfo - React.ErrorInfo with component stack\n   * @param additionalContext - Optional additional context to merge\n   * @returns WildoError_Frontend instance\n   */\n  buildReactError(\n    error: Error,\n    errorInfo: ErrorInfo,\n    additionalContext?: Record<string, unknown>\n  ): WildoError_Frontend {\n    return this.buildWildoError_Frontend(\n      ErrorType.UNCAUGHT_EXCEPTION,\n      {\n        context: {\n          componentStack: errorInfo.componentStack,\n          errorStack: error.stack,\n          errorName: error.name,\n          errorMessage: error.message,\n          timestamp: new Date().toISOString(),\n          ...(additionalContext || {}),\n        },\n      }\n    );\n  }\n\n  /**\n   * Build error from router error\n   * \n   * @param error - The error from router (can be RouteErrorResponse, Error, or any)\n   * @param status - Optional HTTP status code (for RouteErrorResponse)\n   * @param additionalContext - Optional additional context to merge\n   * @returns WildoError_Frontend instance\n   */\n  buildRouterError(\n    error: any,\n    status?: number,\n    additionalContext?: Record<string, unknown>\n  ): WildoError_Frontend {\n    let errorType = ErrorType.UNKNOWN;\n\n    // If status code provided, use centralized HTTP error behavior\n    if (status !== undefined) {\n      const behavior = ErrorManagementService.getHttpErrorBehavior(status, ResourceOperationRiskLevel.MEDIUM);\n      errorType = behavior.errorType;\n    } else if (error instanceof Error) {\n      errorType = ErrorType.UNCAUGHT_EXCEPTION;\n    }\n\n    // Build context based on error type\n    const context: Record<string, unknown> = {\n      pathname: window.location.pathname,\n      timestamp: new Date().toISOString(),\n      ...(additionalContext || {}),\n    };\n\n    // Handle RouteErrorResponse format\n    if (status !== undefined && error?.statusText) {\n      context.status = status;\n      context.statusText = error.statusText;\n      if (error.data) {\n        context.data = error.data;\n      }\n    }\n\n    // Handle Error instance\n    if (error instanceof Error) {\n      context.errorName = error.name;\n      context.errorStack = error.stack;\n      context.errorMessage = error.message;\n    } else if (error !== null && typeof error === 'object') {\n      // Handle other object types\n      context.error = String(error);\n    }\n\n    return this.buildWildoError_Frontend(errorType, {\n      context,\n    });\n  }\n\n  /**\n   * Build error from WebSocket error\n   * \n   * @param error - The error from WebSocket connection\n   * @param additionalContext - Optional additional context to merge\n   * @returns WildoError_Frontend instance\n   */\n  buildWebSocketError(\n    error: any,\n    additionalContext?: Record<string, unknown>\n  ): WildoError_Frontend {\n    const errorType = additionalContext?.errorCode === 'RATE_LIMIT_EXCEEDED'\n      ? ErrorType.RATE_LIMIT\n      : ErrorType.NETWORK;\n\n    return this.buildWildoError_Frontend(\n      errorType,\n      {\n        context: {\n          source: 'websocket',\n          errorMessage: error instanceof Error ? error.message : String(error),\n          ...(additionalContext || {}),\n        },\n      }\n    );\n  }\n\n  /**\n   * Build error from promise rejection\n   * \n   * @param error - The error from rejected promise\n   * @param additionalContext - Optional additional context to merge\n   * @returns WildoError_Frontend instance\n   */\n  buildPromiseError(\n    error: any,\n    additionalContext?: Record<string, unknown>\n  ): WildoError_Frontend {\n    return this.buildWildoError_Frontend(\n      ErrorType.UNCAUGHT_EXCEPTION,\n      {\n        context: {\n          source: 'promise',\n          errorMessage: error instanceof Error ? error.message : String(error),\n          errorStack: error instanceof Error ? error.stack : undefined,\n          ...(additionalContext || {}),\n        },\n      }\n    );\n  }\n\n}\n\n/**\n * Shared singleton instance of ErrorBuilderFrontend\n * \n * This instance is used across all error handling services to ensure:\n * - Consistent user context (userId, organizationId) across all errors\n * - Single source of truth for error building\n * - Automatic context propagation to ErrorBoundary and RouterErrorBoundary errors\n * \n * User context is managed by ErrorContext, which listens to USER_LOGIN and \n * PRIMARY_SCOPE_CHANGED events (for organization changes) and updates this shared instance.\n */\nexport const sharedErrorBuilder = new ErrorBuilderFrontend(); "]}
+{"version":3,"file":"errors-builder.frontend.services.js","sourceRoot":"","sources":["../../../../../src/core/errors/errors-builder.frontend.services.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n  ERROR_DEFINITIONS,\n  ErrorCustomMessageReference,\n  ErrorHandling_Strategy,\n  ErrorType,\n  WildoError_Backend,\n  WildoError_Frontend,\n  ResourceOperationRiskLevel, WebSocketSystemErrorCode, describeCaughtError } from '@wildo-ai/saas-models';\nimport type { ErrorInfo } from 'react';\nimport { ErrorManagementService } from './error-management.frontend.service';\n\n/**\n * Frontend Error Builder\n * Creates unified error configurations and WildoError_Frontend instances for client-side use\n */\nexport class ErrorBuilderFrontend {\n  private organizationId?: string;\n  private userId?: string;\n\n  constructor(context?: {\n    organizationId?: string;\n    userId?: string;\n  }) {\n    this.organizationId = context?.organizationId;\n    this.userId = context?.userId;\n  }\n\n  updateOrganizationId(organizationId: string | undefined): void {\n    this.organizationId = organizationId;\n  }\n\n  updateUserId(userId: string | undefined): void {\n    this.userId = userId;\n  }\n  \n  \n\n  buildWildoError_Frontend(\n    errorType: ErrorType,\n    options: {\n      customMessageReference?: ErrorCustomMessageReference,\n      operationPathKey?: string,\n      context?: Record<string, any>\n    } = {}\n  ): WildoError_Frontend {\n\n    const errorDefinition = ERROR_DEFINITIONS[errorType];\n\n    return {\n      type: errorType,\n      severity: errorDefinition.severity,\n      customMessageReference: options.customMessageReference || errorDefinition.defaultCustomMessageReference,\n      timestamp: new Date(),\n      organizationId: this.organizationId ?? undefined,\n      userId: this.userId ?? undefined,\n      operationPathKey: options.operationPathKey ?? undefined,\n\n      // Frontend actions and config\n      frontendActions: errorDefinition.frontendActions || [],\n      redirectPolicy: errorDefinition.redirectPolicy,\n      errorHandlingStrategy: errorDefinition.errorHandlingStrategy ?? ErrorHandling_Strategy.STOP,\n      retryPolicy: errorDefinition.retryPolicy,\n      maxRetries: errorDefinition.maxRetries,\n      initialDelay: errorDefinition.initialDelay,\n      baseDelay: errorDefinition.baseDelay,\n      \n      showToUser: errorDefinition.showToUser ?? true,\n      context: options.context ?? undefined,\n    };\n  }\n\n\n  buildFromBackendError(backendError: WildoError_Backend): WildoError_Frontend {\n    // Type-safe access to backend error properties\n    const errorType: ErrorType = (backendError as WildoError_Backend).type;\n    const customMessageReference: ErrorCustomMessageReference = (backendError as WildoError_Backend).customMessageReference;\n    const operationPathKey: string | undefined = (backendError as WildoError_Backend).operationPathKey;\n    const context: Record<string, any> | undefined = (backendError as WildoError_Backend).context;\n    \n    return this.buildWildoError_Frontend(\n      errorType,\n      {\n        customMessageReference: customMessageReference ?? undefined,\n        operationPathKey: operationPathKey ?? undefined,\n        context: context ?? undefined\n      }\n    );\n  }\n\n  /**\n   * Build error from React component error\n   * \n   * @param error - The Error object from React\n   * @param errorInfo - React.ErrorInfo with component stack\n   * @param additionalContext - Optional additional context to merge\n   * @returns WildoError_Frontend instance\n   */\n  buildReactError(\n    error: Error,\n    errorInfo: ErrorInfo,\n    additionalContext?: Record<string, unknown>\n  ): WildoError_Frontend {\n    return this.buildWildoError_Frontend(\n      ErrorType.UNCAUGHT_EXCEPTION,\n      {\n        context: {\n          componentStack: errorInfo.componentStack,\n          errorStack: error.stack,\n          errorName: error.name,\n          errorMessage: error.message,\n          timestamp: new Date().toISOString(),\n          ...(additionalContext || {}),\n        },\n      }\n    );\n  }\n\n  /**\n   * Build error from router error\n   * \n   * @param error - The error from router (can be RouteErrorResponse, Error, or any)\n   * @param status - Optional HTTP status code (for RouteErrorResponse)\n   * @param additionalContext - Optional additional context to merge\n   * @returns WildoError_Frontend instance\n   */\n  buildRouterError(\n    error: any,\n    status?: number,\n    additionalContext?: Record<string, unknown>\n  ): WildoError_Frontend {\n    let errorType = ErrorType.UNKNOWN;\n\n    // If status code provided, use centralized HTTP error behavior\n    if (status !== undefined) {\n      const behavior = ErrorManagementService.getHttpErrorBehavior(status, ResourceOperationRiskLevel.MEDIUM);\n      errorType = behavior.errorType;\n    } else if (error instanceof Error) {\n      errorType = ErrorType.UNCAUGHT_EXCEPTION;\n    }\n\n    // Build context based on error type\n    const context: Record<string, unknown> = {\n      pathname: window.location.pathname,\n      timestamp: new Date().toISOString(),\n      ...(additionalContext || {}),\n    };\n\n    // Handle RouteErrorResponse format\n    if (status !== undefined && error?.statusText) {\n      context.status = status;\n      context.statusText = error.statusText;\n      if (error.data) {\n        context.data = error.data;\n      }\n    }\n\n    // Handle Error instance\n    if (error instanceof Error) {\n      context.errorName = error.name;\n      context.errorStack = error.stack;\n      context.errorMessage = error.message;\n    } else if (error !== null && typeof error === 'object') {\n      // Handle other object types\n      context.error = String(error);\n    }\n\n    return this.buildWildoError_Frontend(errorType, {\n      context,\n    });\n  }\n\n  /**\n   * Build error from WebSocket error\n   * \n   * @param error - The error from WebSocket connection\n   * @param additionalContext - Optional additional context to merge\n   * @returns WildoError_Frontend instance\n   */\n  buildWebSocketError(\n    error: any,\n    additionalContext?: Record<string, unknown>\n  ): WildoError_Frontend {\n    const errorType = additionalContext?.errorCode === WebSocketSystemErrorCode.RATE_LIMIT_EXCEEDED\n      ? ErrorType.RATE_LIMIT\n      : ErrorType.NETWORK;\n\n    return this.buildWildoError_Frontend(\n      errorType,\n      {\n        context: {\n          source: 'websocket',\n          errorMessage: describeCaughtError(error),\n          ...(additionalContext || {}),\n        },\n      }\n    );\n  }\n\n  /**\n   * Build error from promise rejection\n   * \n   * @param error - The error from rejected promise\n   * @param additionalContext - Optional additional context to merge\n   * @returns WildoError_Frontend instance\n   */\n  buildPromiseError(\n    error: any,\n    additionalContext?: Record<string, unknown>\n  ): WildoError_Frontend {\n    return this.buildWildoError_Frontend(\n      ErrorType.UNCAUGHT_EXCEPTION,\n      {\n        context: {\n          source: 'promise',\n          errorMessage: describeCaughtError(error),\n          errorStack: error instanceof Error ? error.stack : undefined,\n          ...(additionalContext || {}),\n        },\n      }\n    );\n  }\n\n}\n\n/**\n * Shared singleton instance of ErrorBuilderFrontend\n * \n * This instance is used across all error handling services to ensure:\n * - Consistent user context (userId, organizationId) across all errors\n * - Single source of truth for error building\n * - Automatic context propagation to ErrorBoundary and RouterErrorBoundary errors\n * \n * User context is managed by ErrorContext, which listens to USER_LOGIN / USER_LOGOUT (the person\n * arriving and leaving) and PRIMARY_SCOPE_CHANGED (organization changes) and updates this shared instance.\n */\nexport const sharedErrorBuilder = new ErrorBuilderFrontend(); "]}

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":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EACL,SAAS,EACT,aAAa,EACb,mBAAmB,EACnB,6BAA6B,EAE7B,0BAA0B,EAC1B,mBAAmB,EAEpB,MAAM,uBAAuB,CAAC;AAM/B;;GAEG;AACH,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,OAAO,GAAG,QAAQ,GAAG,WAAW,GAAG,SAAS,GAAG,QAAQ,CAAC;AAM3F;;;GAGG;AACH,MAAM,WAAW,iBAAiB;IAChC,oDAAoD;IACpD,SAAS,EAAE,SAAS,CAAC;IAErB,8CAA8C;IAC9C,QAAQ,EAAE,aAAa,CAAC;IAExB,yCAAyC;IACzC,eAAe,EAAE,mBAAmB,EAAE,CAAC;IAEvC,4CAA4C;IAC5C,cAAc,CAAC,EAAE,6BAA6B,CAAC;IAE/C,4CAA4C;IAC5C,UAAU,EAAE,OAAO,CAAC;IAEpB,8DAA8D;IAC9D,aAAa,CAAC,EAAE,OAAO,CAAC;IAExB,0DAA0D;IAC1D,SAAS,CAAC,EAAE,OAAO,CAAC;IAEpB,yDAAyD;IACzD,WAAW,CAAC,EAAE,OAAO,CAAC;IAEtB,6BAA6B;IAC7B,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB,8BAA8B;IAC9B,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;;GAGG;AACH,MAAM,MAAM,6BAA6B,GAAG,OAAO,CAAC,IAAI,CAAC,iBAAiB,EAAE,WAAW,GAAG,aAAa,CAAC,CAAC,CAAC;AAE1G;;GAEG;AACH,MAAM,WAAW,kCAAkC;IACjD,iDAAiD;IACjD,IAAI,EAAE,iBAAiB,CAAC;IAExB,uDAAuD;IACvD,aAAa,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,0BAA0B,EAAE,6BAA6B,CAAC,CAAC,CAAC;CAC5F;AAMD;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,oDAAoD;IACpD,SAAS,CAAC,EAAE,0BAA0B,CAAC;IAEvC,kCAAkC;IAClC,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB,kEAAkE;IAClE,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAE7B,0DAA0D;IAC1D,MAAM,CAAC,EAAE,OAAO,CAAC;IAEjB,8BAA8B;IAC9B,iBAAiB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC7C;AAED;;;GAGG;AACH,MAAM,WAAW,gBAAiB,SAAQ,gBAAgB;IACxD,iCAAiC;IACjC,GAAG,CAAC,EAAE,MAAM,CAAC;IAEb,2BAA2B;IAC3B,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB,iDAAiD;IACjD,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAE1B,2CAA2C;IAC3C,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED;;;GAGG;AACH,MAAM,WAAW,mBAAoB,SAAQ,gBAAgB;IAC3D,4CAA4C;IAC5C,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAMD;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,0CAA0C;IAC1C,UAAU,EAAE,mBAAmB,CAAC;IAEhC,+CAA+C;IAC/C,QAAQ,EAAE,iBAAiB,CAAC;IAE5B,mCAAmC;IACnC,YAAY,EAAE,OAAO,CAAC;IAEtB,yCAAyC;IACzC,YAAY,EAAE,OAAO,CAAC;CACvB;AAMD;;;GAGG;AACH,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,SAAS,CAAC;IAChB,sBAAsB,EAAE,MAAM,CAAC;IAC/B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,iBAAiB,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;CACrC;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,WAAW,EAAE,gBAAgB,CAAC;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;CACf;AAMD;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,OAAO,CAAC;IAClB,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IACpB,SAAS,EAAE,KAAK,CAAC,SAAS,GAAG,IAAI,CAAC;CACnC;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;IAC1B,QAAQ,CAAC,EAAE,KAAK,CAAC,aAAa,CAAC;QAAE,KAAK,EAAE,KAAK,CAAC;QAAC,SAAS,EAAE,KAAK,CAAC,SAAS,CAAC;QAAC,UAAU,EAAE,MAAM,IAAI,CAAA;KAAE,CAAC,CAAC;IACrG,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,KAAK,CAAC,SAAS,KAAK,IAAI,CAAC;CAC9D;AAED;;;;;;;;GAQG;AACH,MAAM,WAAW,uBAAuB;IACtC,8DAA8D;IAC9D,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,mBAAmB,KAAK,IAAI,CAAC;CAChD;AAMD;;;GAGG;AACH,MAAM,WAAW,gBAAgB;IAC/B,yDAAyD;IACzD,WAAW,EAAE,CAAC,KAAK,EAAE,KAAK,GAAG,GAAG,EAAE,aAAa,CAAC,EAAE,MAAM,EAAE,iBAAiB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC;IAE/G,8CAA8C;IAC9C,gBAAgB,EAAE,CAAC,UAAU,EAAE,mBAAmB,KAAK,IAAI,CAAC;IAE5D,6CAA6C;IAC7C,cAAc,EAAE,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,cAAc,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;CACpE;AAMD;;GAEG;AACH,eAAO,MAAM,6BAA6B,OAAO,CAAC;AAElD;;GAEG;AACH,eAAO,MAAM,oBAAoB,IAAI,CAAC;AAMtC;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CAC/B;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,OAAO,GAAG,aAAa,CAkB5D"}
+{"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"]}