@wildo-ai/saas-models 1.1.3 → 1.1.5

package/dist/esm/errors/errors.shared.schemas.js

@@ -272,21 +272,33 @@ export const WildoError_FrontendSchema = WildoErrorSchema.extend({
 // VALIDATION ERROR ENTRY — STRUCTURED i18n-READY ERROR FORMAT
 // =============================================================================
 /**
- * Structured validation error entry with i18n support.
+ * Field-validation issues the BACKEND raises, beyond the Zod issue codes a schema produces on its own.
  *
- * Validation errors can be either:
- * - A plain string (legacy format, displayed as-is)
- * - A `ValidationErrorEntry` (structured format with i18n key + fallback message)
+ * Each member is a key of the frontend's `errors_validation` catalog (`errors_validation.<code>.msg`), so the
+ * words a person reads are the application's, in their language. The server sends the code and never the
+ * sentence: RFC 9457 §3.1.4 says a consumer "SHOULD NOT parse the 'detail' member for information;
+ * extensions are more suitable", and §3.2 puts machine-readable facts in extension members.
+ * spec-cite: RFC 9457 (Problem Details for HTTP APIs) §3.1.4, §3.2.
+ */
+export var FieldValidationIssueCode;
+(function (FieldValidationIssueCode) {
+    /** A value already exists on a field declared `.isUnique()`. Raised at write time and by validate-field. */
+    FieldValidationIssueCode["NOT_UNIQUE"] = "not_unique";
+})(FieldValidationIssueCode || (FieldValidationIssueCode = {}));
+/**
+ * A field error the backend raises as a CODE.
+ *
+ * Validation errors reach a form as either:
+ * - a plain string — a message a schema produced, shown as-is;
+ * - a `ValidationErrorEntry` — a code the client renders from its own catalog.
  *
- * The structured format allows the frontend to translate error messages
- * while maintaining backward compatibility with plain strings.
+ * It carries no message on purpose: prose written here is English in every locale, which is what
+ * `.claude/rules/display-text-comes-from-i18n.md` forbids and what #1180 removed.
  */
 export const ValidationErrorEntry_Schema = z.object({
-    /** i18n translation key (e.g., 'validation.unique.conflict') */
-    key: z.string(),
-    /** Fallback English message — always present, used if i18n lookup fails */
-    message: z.string(),
-    /** Interpolation parameters for the i18n template (e.g., { value: "test@example.com", fieldName: "email" }) */
+    /** The issue's code; the frontend resolves `errors_validation.<code>.msg`. */
+    code: z.enum(FieldValidationIssueCode),
+    /** Interpolation parameters for that catalog message. `NOT_UNIQUE` needs none. */
     params: z.record(z.string(), z.string()).optional(),
 });
 export const VersionConflictDetailsSchema = z.object({
@@ -358,47 +370,17 @@ export const ValidationErrorResponse_Schema = z.object({
 // VALIDATION ERROR EXTRACTION UTILITIES
 // =============================================================================
 /**
- * Resolve a ValidationErrorValue to a display string.
- *
- * If the value is a plain string, returns it directly.
- * If it's a structured ValidationErrorEntry, returns the fallback message.
+ * Check whether a validation error value is a coded entry rather than a plain message.
  *
- * Use this as the base resolver. Frontend layers can override by checking
- * for structured entries and resolving via i18n before falling back to this.
- *
- * @param value - A validation error value (string or structured entry)
- * @returns The display string
- */
-export function resolveValidationErrorMessage(value) {
-    if (typeof value === 'string')
-        return value;
-    return value.message;
-}
-/**
- * Check if a validation error value is a structured i18n entry.
+ * There is deliberately NO shared "resolve this to a display string" helper: a coded entry carries no words,
+ * and only the frontend — which holds the catalog and the person's language — can turn it into text. A helper
+ * here could only have invented English (#1180).
  *
  * @param value - A validation error value
- * @returns True if the value is a ValidationErrorEntry with a key
+ * @returns True when the value is a coded `ValidationErrorEntry`
  */
 export function isValidationErrorEntry(value) {
-    return typeof value === 'object' && value !== null && 'key' in value && 'message' in value;
-}
-/**
- * Convert a ValidationErrors map to a plain Record<string, string> by resolving
- * all structured entries to their display messages.
- *
- * This is the backward-compatible conversion used by consumers that only
- * expect plain string error messages.
- *
- * @param errors - Validation errors map (may contain structured entries)
- * @returns Plain string map
- */
-export function resolveValidationErrors(errors) {
-    const resolved = {};
-    for (const [field, value] of Object.entries(errors)) {
-        resolved[field] = resolveValidationErrorMessage(value);
-    }
-    return resolved;
+    return typeof value === 'object' && value !== null && 'code' in value;
 }
 /**
  * Extract validation errors from a raw error response payload.
@@ -457,16 +439,17 @@ export const ValidateFieldRequest_Schema = z.object({
 export const ValidateFieldResponse_Schema = z.object({
     /** Whether the field value is valid */
     valid: z.boolean(),
-    /** Error details when valid is false */
+    /**
+     * The issue when `valid` is false. It carries a CODE, never a sentence: the words are the client's, from
+     * `errors_validation.<code>.msg` (#1180).
+     */
     error: z.object({
         /** Field name that failed validation */
         fieldName: z.string(),
-        /** Display message (fallback English) */
-        message: z.string(),
-        /** i18n key for the error */
-        i18nKey: z.string().optional(),
-        /** i18n interpolation parameters */
-        i18nParams: z.record(z.string(), z.string()).optional(),
+        /** The issue's code, rendered by the client from its own validation catalog. */
+        code: z.enum(FieldValidationIssueCode),
+        /** Interpolation parameters for that catalog message. */
+        params: z.record(z.string(), z.string()).optional(),
     }).optional(),
 });
 //# sourceMappingURL=errors.shared.schemas.js.map

package/dist/esm/errors/errors.shared.schemas.js.map

@@ -1 +1 @@
-{"version":3,"file":"errors.shared.schemas.js","sourceRoot":"","sources":["../../../../src/errors/errors.shared.schemas.ts"],"names":[],"mappings":"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","sourcesContent":["import { z } from \"zod\";\nimport { ExecutionContext_ExecutionType, ExecutionContext_InitiatorIds, ExecutionContext_InitiatorIdsSchema } from \"../runtime/execution-context.shared.schemas\";\nimport { ErrorCustomMessageReference } from \"./errors.custom-message-ref.shared.definitions\";\nimport { NotificationNextStepType } from \"../notifications/notifications.shared.schemas\";\n\n/**\n * The coarse error category of every backend error. Import from\n * `@wildo-ai/saas-models`.\n *\n * The `ErrorType` you pass to `errorBuilder.buildError(type, …)` is the single\n * driver of the HTTP status code, the severity/logging level, and whether the\n * error's `context` is exposed to the client. Pick the type that matches the\n * real condition — never default everything to `INTERNAL`:\n *\n * | ErrorType            | HTTP | Use for                                             |\n * |----------------------|------|-----------------------------------------------------|\n * | `VALIDATION`         | 400  | Bad/malformed input, failed cross-field rules       |\n * | `AUTHENTICATION`     | 401  | Missing/invalid session or credentials              |\n * | `AUTHORIZATION`      | 403  | Authenticated but not permitted                     |\n * | `NOT_FOUND`          | 404  | Requested resource does not exist / not visible     |\n * | `CONFLICT`           | 409  | Uniqueness / version / state conflict               |\n * | `RATE_LIMIT`         | 429  | Too many requests                                   |\n * | `BUSINESS_RULE`      | 422  | Domain rule violated (well-formed but not allowed)  |\n * | `FEATURE_NOT_AVAILABLE` / `FEATURE_LIMIT_EXCEEDED` / `INSUFFICIENT_CREDITS` | 403/402 | Plan/feature gating |\n * | `EXTERNAL_SERVICE`   | 502  | A downstream provider/API failed                    |\n * | `CONFIGURATION`      | 500  | Server misconfiguration                             |\n * | `INTERNAL` / `DATABASE` / `INFRASTRUCTURE` | 500 | Server-side faults (context is stripped from the client) |\n *\n * Only VALIDATION / CONFLICT / RATE_LIMIT expose `context` to the client; every\n * other type strips it (so `context` is log-only). The user-facing wording never\n * comes from `context` — it comes from the `customMessageReference` (see\n * `ErrorCustomMessageReference`), resolved to localized text by `tErrorMessage`.\n */\nexport enum ErrorType {\n/** @wildo_source:part:start saas.models.error-type facet:layer:shared facet:family:error */\n\n  NETWORK = 'NETWORK',\n\n  AUTHENTICATION = 'AUTHENTICATION',\n  AUTHORIZATION = 'AUTHORIZATION',\n\n  VALIDATION = 'VALIDATION',\n\n  /** HTTP 413 — the request body exceeded a size limit (e.g. the OAuth mount's 32 KB cap or a global body\n   *  parser limit). A CLIENT input problem, classified separately from VALIDATION so the response carries the\n   *  precise 413 status framework-wide rather than a generic 400 (and never an INTERNAL 500). */\n  PAYLOAD_TOO_LARGE = 'PAYLOAD_TOO_LARGE',\n\n  NOT_FOUND = 'NOT_FOUND',\n  CONFLICT = 'CONFLICT',\n\n  RATE_LIMIT = 'RATE_LIMIT',\n\n  INTERNAL = 'INTERNAL',\n  DATABASE = 'DATABASE',\n  EXTERNAL_SERVICE = 'EXTERNAL_SERVICE',\n\n  UNKNOWN = 'UNKNOWN',\n  UNCAUGHT_EXCEPTION = 'UNCAUGHT_EXCEPTION',\n  UNHANDLED_REJECTION = 'UNHANDLED_REJECTION',\n\n  BUSINESS_RULE = 'BUSINESS_RULE',\n  INFRASTRUCTURE = 'INFRASTRUCTURE',\n  CONFIGURATION = 'CONFIGURATION',\n\n  // Feature gating errors\n  FEATURE_NOT_AVAILABLE = 'FEATURE_NOT_AVAILABLE',\n  FEATURE_LIMIT_EXCEEDED = 'FEATURE_LIMIT_EXCEEDED',\n  INSUFFICIENT_CREDITS = 'INSUFFICIENT_CREDITS',\n/** @wildo_source:part:end saas.models.error-type */\n}\n\n/**\n * Error severity levels\n */\n\nexport enum ErrorSeverity {\n  LOW = 'low',\n  MEDIUM = 'medium',\n  HIGH = 'high',\n  CRITICAL = 'critical',\n  ALERT = 'alert',\n  EMERGENCY = 'emergency',\n}\n\n/**\n * Frontend-specific error actions\n */\nexport enum ErrorActionFrontend {\n  NOTIFY = 'NOTIFY',\n  REDIRECT = 'REDIRECT',\n  RETRY = 'RETRY',\n  REFRESH_TOKEN = 'REFRESH_TOKEN',\n  DISCONNECT = 'DISCONNECT',\n  SHOW_MODAL = 'SHOW_MODAL',\n  SHOW_TOAST = 'SHOW_TOAST'\n}\n\n/**\n * Backend-specific error actions\n */\nexport enum ErrorActionBackend {\n  LOG = 'LOG',\n  ALERT = 'ALERT',\n  RECORD_METRICS = 'RECORD_METRICS',\n  TRACE = 'TRACE',\n  CIRCUIT_BREAK = 'CIRCUIT_BREAK',\n  GRACEFUL_DEGRADATION = 'GRACEFUL_DEGRADATION'\n}\n\nexport enum Error_Frontend_RedirectPolicy {\n  LOGIN = 'login',\n  HOME = 'home',\n  HISTORY_BACK = 'history_back',\n  // NOT_FOUND = 'not_found',\n  // UNAUTHORIZED = 'unauthorized',\n  // ERROR_PAGE = 'error_page',\n\n}\n\nexport enum ErrorHandling_Strategy {\n  STOP = \"stop\",\n  SKIP = \"skip\",\n  RETRY = \"retry\",\n  FALLBACK = \"fallback\",\n}\n\nexport enum RetryPolicy_BackoffType {\n  FIXED = \"fixed\",\n  EXPONENTIAL = \"exponential\",\n  LINEAR = \"linear\",\n}\n\n\nexport type WildoError_Definition = {\n  type: ErrorType;\n  severity: ErrorSeverity;\n  description: string;\n  defaultCustomMessageReference: ErrorCustomMessageReference;\n\n  errorHandlingStrategy?: ErrorHandling_Strategy;\n  retryPolicy?: RetryPolicy_BackoffType;\n  maxRetries?: number;\n  initialDelay?: number;\n  baseDelay?: number;\n\n  // Frontend-specific config\n  frontendActions: ErrorActionFrontend[];\n  redirectPolicy?: Error_Frontend_RedirectPolicy;\n  showToUser?: boolean;\n\n  // Backend-specific config\n  statusCode: number;\n  backendActions: ErrorActionBackend[];\n\n}\n\nexport type WildoError_Frontend_Definition = Omit<\n  WildoError_Definition,\n  'statusCode' | 'backendActions'\n>;\n\nexport type WildoError_Backend_Definition = Omit<\n  WildoError_Definition,\n  'frontendActions' | 'redirectPolicy' | 'showToUser'\n  >;\n\n\n\nexport const WildoErrorSchema = z.object({\n  type: z.enum(ErrorType),\n  severity: z.enum(ErrorSeverity),\n  operationPathKey: z.string().optional(),\n  timestamp: z.date(),\n\n  /**\n   * Free-form context bag attached to the error.\n   *\n   * The `message` slot is modelled explicitly (L1-6, post-Phase-7\n   * close-out) because consumers across the codebase reach for it\n   * via `error.context.message` as a strongly-typed human-readable\n   * detail string (notably the data-seeding `manual-seed-engine`\n   * extracts it via `isWildoBackendError → context.message` to\n   * surface scope-mismatch and other CONFIGURATION errors back into\n   * the `DataSeedRun.failureReport`). Modeling it here makes the\n   * contract typed at the producer side instead of relying on\n   * `z.record(string, any)` to let any shape through.\n   *\n   * Other fields remain free-form (`catchall(z.any())`) so existing\n   * callers that attach domain-specific keys (e.g. `envKey`,\n   * `headerKey`, `seedKey`) continue to work without a schema bump.\n   */\n  context: z.object({\n    message: z.string().optional(),\n  }).catchall(z.any()).optional(),\n  ipAddress: z.string().optional(),\n\n  // Resilience and retry policy\n  errorHandlingStrategy: z.enum(ErrorHandling_Strategy).optional(),\n  retryPolicy: z.enum(RetryPolicy_BackoffType).optional(),\n  maxRetries: z.number().optional(),\n  initialDelay: z.number().optional(),\n  baseDelay: z.number().optional(),\n  retryCount: z.number().optional(),\n  lastRetryTime: z.date().optional(),\n});\n\nexport type WildoError = z.infer<typeof WildoErrorSchema>;\n\n// =====================================================\n// Error User Guidance — contextual error resolution hints (Phase 1b)\n// =====================================================\n\n/**\n * Structured guidance attached to backend errors.\n * Tells the frontend what went wrong, how to fix it, and what to do next.\n *\n * Populated by `ErrorBuilderBackendService.buildErrorWithGuidance()` for\n * error types like CONFIGURATION, FEATURE_NOT_AVAILABLE, RATE_LIMIT, etc.\n *\n * NOTE: Defined before WildoError_BackendSchema because it's referenced there.\n */\nexport const ErrorUserGuidanceSchema = z.object({\n  /**\n   * i18n lookup key for this guidance block.\n   * Resolves labels under `errors_guidance.{guidanceKey}.{field}`.\n   * If not set, falls back to the error's `customMessageReference`.\n   */\n  guidanceKey: z.string().optional(),\n  /** Human-readable explanation of what went wrong */\n  explanation: z.string().optional(),\n  /** How to resolve the issue */\n  resolution: z.string().optional(),\n  /** Steps already completed before the error occurred */\n  completedSteps: z.array(z.string()).optional(),\n  /** Suggested next action (operation or URL) */\n  nextAction: z.object({\n    label: z.string(),\n    /** Operation path or URL */\n    ref: z.string(),\n    type: z.enum(NotificationNextStepType).default(NotificationNextStepType.OPERATION),\n  }).optional(),\n  /** For rate limits: seconds until retry is available */\n  retryAfterSeconds: z.number().optional(),\n  /** For configuration errors: what configuration elements are missing */\n  missingConfiguration: z.array(z.string()).optional(),\n});\n\nexport type ErrorUserGuidance = z.infer<typeof ErrorUserGuidanceSchema>;\n\n// =====================================================\n// WildoError — Backend (extends base with backend-specific fields)\n// =====================================================\n\nexport const WildoError_BackendSchema = WildoErrorSchema.extend({\n  backendActions: z.array(z.enum(ErrorActionBackend)),\n  customMessageReference: z.enum(ErrorCustomMessageReference),\n  statusCode: z.number(),\n  stack: z.string().optional(),\n  /** The request-correlation id (see `ExecutionContext.correlationId`). Populated from the EC when one was threaded, else from the ambient request-context ALS frame — that fallback is what attributes the many `buildError` call sites that pass no EC. */\n  correlationId: z.string().optional(),\n  initiatorIds: ExecutionContext_InitiatorIdsSchema.optional().nullable(),\n  executionType: z.enum(ExecutionContext_ExecutionType).optional(),\n  /** Contextual user guidance for error resolution (Phase 1b) */\n  userGuidance: ErrorUserGuidanceSchema.optional(),\n});\n\nexport type WildoError_Backend = z.infer<typeof WildoError_BackendSchema>;\n\n/**\n * Type guard for WildoError_Backend — safely identifies engine-thrown errors in catch blocks.\n *\n * Replaces the unsafe `(error as any).type` pattern. Checks for the 4 structural\n * properties that distinguish WildoError_Backend from arbitrary Error objects.\n */\nexport function isWildoBackendError(error: unknown): error is WildoError_Backend {\n  return (\n    error !== null &&\n    typeof error === 'object' &&\n    'type' in error &&\n    'statusCode' in error &&\n    'severity' in error &&\n    'customMessageReference' in error\n  );\n}\n\n// =====================================================\n// WildoError — Frontend\n// =====================================================\n\nexport const WildoError_FrontendSchema = WildoErrorSchema.extend({\n  userId: z.string().optional(),\n  organizationId: z.string().optional(),\n  customMessageReference: z.enum(ErrorCustomMessageReference),\n  frontendActions: z.array(z.enum(ErrorActionFrontend)),\n  redirectPolicy: z.enum(Error_Frontend_RedirectPolicy).optional(),\n\n  showToUser: z.boolean().optional(),\n\n  /**\n   * When true, the GLOBAL error handler must NOT surface a user-facing toast or\n   * modal for this error — the originating caller already owns the failure UX\n   * (e.g. a resource form shows `NOTIFY_RESOURCE_ERROR` + inline field errors).\n   * Derived from the per-request `silent` flag. Side-effects (auth-logout,\n   * redirect, dedup, analytics) still run.\n   *\n   * MUST be a declared schema field: the frontend event bus Zod-parses\n   * `ERROR_OCCURED` payloads and strips unknown keys, so an untyped\n   * `(error as any).suppressUserDisplay` would be dropped before the handler\n   * ever reads it.\n   */\n  suppressUserDisplay: z.boolean().optional(),\n\n  /**\n   * When true, the error must drive a logout through the AuthSession fast-path.\n   * `GlobalErrorHandler` detects `triggerLogout` (independently of the error's\n   * `type`) and calls `logout()` — guarded by `isAuthenticated()` so it never\n   * logs out when no session is active — then strips the `DISCONNECT`\n   * frontendAction from the delegated actions so the ErrorContext fallback does\n   * not double-trigger a logout. Derived from the HTTP error-behavior matrix\n   * (`HttpErrorBehavior.triggerLogout`, e.g. a 401 invalid session).\n   *\n   * Intentionally NOT additionally gated on `type === AUTHENTICATION`: the\n   * error's `type` comes from the backend payload (`backendErrorType ||\n   * behavior.errorType` in `buildWildoError`), so a 401 the backend typed as\n   * something else would still carry `triggerLogout` from the status matrix —\n   * an extra type gate would silently swallow that logout. Mirrors\n   * `handleHttpError`'s `shouldLogout`, which is triggerLogout-only.\n   *\n   * MUST be a declared schema field — same reason as `suppressUserDisplay`\n   * above: the frontend event bus Zod-parses `ERROR_OCCURED` payloads and\n   * strips unknown keys, so an untyped `(error as any).triggerLogout` set by\n   * `buildWildoError` would be dropped before `GlobalErrorHandler` ever reads\n   * it, leaving the AuthSession logout fast-path permanently dead.\n   */\n  triggerLogout: z.boolean().optional(),\n\n  /** Contextual error guidance from backend (Phase 1b) */\n  userGuidance: ErrorUserGuidanceSchema.optional(),\n});\n\nexport type WildoError_Frontend = z.infer<typeof WildoError_FrontendSchema>;\n\n\n// =============================================================================\n// VALIDATION ERROR ENTRY — STRUCTURED i18n-READY ERROR FORMAT\n// =============================================================================\n\n/**\n * Structured validation error entry with i18n support.\n *\n * Validation errors can be either:\n * - A plain string (legacy format, displayed as-is)\n * - A `ValidationErrorEntry` (structured format with i18n key + fallback message)\n *\n * The structured format allows the frontend to translate error messages\n * while maintaining backward compatibility with plain strings.\n */\nexport const ValidationErrorEntry_Schema = z.object({\n  /** i18n translation key (e.g., 'validation.unique.conflict') */\n  key: z.string(),\n  /** Fallback English message — always present, used if i18n lookup fails */\n  message: z.string(),\n  /** Interpolation parameters for the i18n template (e.g., { value: \"test@example.com\", fieldName: \"email\" }) */\n  params: z.record(z.string(), z.string()).optional(),\n});\n\nexport type ValidationErrorEntry = z.infer<typeof ValidationErrorEntry_Schema>;\n\nexport const VersionConflictDetailsSchema = z.object({\n  currentVersion: z.number(),\n  expectedVersion: z.number(),\n  conflictingFields: z.array(z.string()),\n  currentValues: z.record(z.string(), z.unknown()),\n  submittedValues: z.record(z.string(), z.unknown()),\n});\n\nexport type VersionConflictDetails = z.infer<typeof VersionConflictDetailsSchema>;\n\n/**\n * SaaS Error Type Definition\n * Replaces the previous WildoError class\n */\n\n/**\n * Error Response Schema\n * Updated to include operationPath and validationErrors (FIX-P6-H1)\n */\nexport const ErrorResponseSchema = z.object({\n  error: z.object({\n    type: z.enum(ErrorType),\n    severity: z.enum(ErrorSeverity),\n    message: z.string(),\n    customMessage: z.string(),\n    customMessageReference: z.string().optional(),\n    code: z.string().optional(),\n    operationPath: z.string().optional(),\n    /**\n     * Request-correlation id (see `ExecutionContext.correlationId`) — a safe, non-PII support/trace id\n     * the client can quote and that joins this response to the backend log lines + audit rows for the\n     * same request. Present for any request-scoped error (the error's captured id, or the ambient\n     * request-context frame at send time).\n     */\n    correlationId: z.string().optional(),\n    details: z.object({\n      versionConflict: VersionConflictDetailsSchema.optional(),\n    }).catchall(z.any()).optional(),\n    timestamp: z.string(),\n    initiatorIds: ExecutionContext_InitiatorIdsSchema.optional().nullable(),\n    /** Field-level validation errors. Values are either plain strings or structured i18n entries. */\n    validationErrors: z.record(z.string(), z.union([z.string(), ValidationErrorEntry_Schema])).optional(),\n    /** Contextual user guidance for error resolution (Phase 1b) */\n    userGuidance: ErrorUserGuidanceSchema.optional(),\n  })\n});\n\nexport type ErrorResponse = z.infer<typeof ErrorResponseSchema>;\n\n/**\n * A single validation error value: either a plain string or a structured entry.\n * Backend can return either format; frontend handles both transparently.\n */\nexport type ValidationErrorValue = string | ValidationErrorEntry;\n\n/**\n * Field-level validation errors map.\n * Keys are dot-notation field paths (e.g., \"email\", \"address.city\").\n * Values are either plain strings or structured i18n entries.\n */\nexport type ValidationErrors = Record<string, ValidationErrorValue>;\n\n// =============================================================================\n// VALIDATION ERROR RESPONSE SCHEMA\n// =============================================================================\n\n/**\n * Standardized validation error response format.\n * Used by both backend (400/409 responses) and frontend (error parsing).\n *\n * The `validationErrors` field maps field names to error values:\n * - Plain string: displayed as-is (legacy format)\n * - ValidationErrorEntry: resolved via i18n on frontend\n */\nexport const ValidationErrorResponse_Schema = z.object({\n  /** HTTP status code (400 for validation, 409 for unique constraint) */\n  code: z.number(),\n  /** General error message */\n  message: z.string(),\n  /**\n   * Field-level validation errors.\n   * Field names can be dot-notation paths for nested fields.\n   * Values are either plain strings or structured i18n entries.\n   */\n  validationErrors: z.record(z.string(), z.union([z.string(), ValidationErrorEntry_Schema])).optional(),\n});\n\nexport type ValidationErrorResponse = z.infer<typeof ValidationErrorResponse_Schema>;\n\n// =============================================================================\n// PARSED HTTP ERROR — TYPED FRONTEND ERROR REPRESENTATION\n// =============================================================================\n\n/**\n * Parsed HTTP error — the typed result of processing an HTTP error response.\n *\n * This is the frontend counterpart of WildoError_Backend. It provides typed\n * access to all error properties that the HTTP client interceptor extracts\n * from the backend's ErrorResponse format.\n *\n * Replaces the previous untyped `error as Record<string, unknown>` pattern.\n */\nexport interface ParsedHttpError {\n  /** HTTP status code (e.g., 400, 401, 409, 500) */\n  httpStatus: number;\n  /** Error type from the backend error classification */\n  errorType: ErrorType;\n  /** Human-readable error message */\n  message: string;\n  /** Field-level validation errors (present for 400/409/422 responses) */\n  validationErrors?: ValidationErrors;\n  /** Additional error context/details from the backend */\n  details?: Record<string, any>;\n  /** Operation path that triggered the error */\n  operationPath?: string;\n  /** Structured user-facing guidance for error resolution */\n  userGuidance?: ErrorUserGuidance;\n}\n\n// =============================================================================\n// VALIDATION ERROR EXTRACTION UTILITIES\n// =============================================================================\n\n/**\n * Resolve a ValidationErrorValue to a display string.\n *\n * If the value is a plain string, returns it directly.\n * If it's a structured ValidationErrorEntry, returns the fallback message.\n *\n * Use this as the base resolver. Frontend layers can override by checking\n * for structured entries and resolving via i18n before falling back to this.\n *\n * @param value - A validation error value (string or structured entry)\n * @returns The display string\n */\nexport function resolveValidationErrorMessage(value: ValidationErrorValue): string {\n  if (typeof value === 'string') return value;\n  return value.message;\n}\n\n/**\n * Check if a validation error value is a structured i18n entry.\n *\n * @param value - A validation error value\n * @returns True if the value is a ValidationErrorEntry with a key\n */\nexport function isValidationErrorEntry(value: ValidationErrorValue): value is ValidationErrorEntry {\n  return typeof value === 'object' && value !== null && 'key' in value && 'message' in value;\n}\n\n/**\n * Convert a ValidationErrors map to a plain Record<string, string> by resolving\n * all structured entries to their display messages.\n *\n * This is the backward-compatible conversion used by consumers that only\n * expect plain string error messages.\n *\n * @param errors - Validation errors map (may contain structured entries)\n * @returns Plain string map\n */\nexport function resolveValidationErrors(errors: ValidationErrors): Record<string, string> {\n  const resolved: Record<string, string> = {};\n  for (const [field, value] of Object.entries(errors)) {\n    resolved[field] = resolveValidationErrorMessage(value);\n  }\n  return resolved;\n}\n\n/**\n * Extract validation errors from a raw error response payload.\n *\n * Handles multiple formats:\n * 1. Standard backend ErrorResponse: `{ error: { validationErrors: { ... } } }`\n * 2. Flat format (legacy): `{ validationErrors: { ... } }`\n * 3. Pre-parsed interceptor format: `error.validationErrors` on the error object\n *\n * @param payload - Raw error response payload (from axios response.data or error object)\n * @returns Extracted validation errors, or undefined if not found\n */\nexport function extractValidationErrors(payload: unknown): ValidationErrors | undefined {\n  if (!payload || typeof payload !== 'object') return undefined;\n\n  const obj = payload as Record<string, unknown>;\n\n  // Path 1: Standard nested format { error: { validationErrors } }\n  if (obj.error && typeof obj.error === 'object') {\n    const nested = obj.error as Record<string, unknown>;\n    if (nested.validationErrors && typeof nested.validationErrors === 'object' && !Array.isArray(nested.validationErrors)) {\n      const ve = nested.validationErrors as Record<string, unknown>;\n      if (Object.keys(ve).length > 0) {\n        return ve as ValidationErrors;\n      }\n    }\n  }\n\n  // Path 2: Flat format { validationErrors }\n  if (obj.validationErrors && typeof obj.validationErrors === 'object' && !Array.isArray(obj.validationErrors)) {\n    const ve = obj.validationErrors as Record<string, unknown>;\n    if (Object.keys(ve).length > 0) {\n      return ve as ValidationErrors;\n    }\n  }\n\n  return undefined;\n}\n\n// =============================================================================\n// FIELD VALIDATION — REQUEST/RESPONSE SCHEMAS\n// =============================================================================\n\n/**\n * Request schema for the validate-field endpoint.\n *\n * Used to pre-validate a single field value (e.g., uniqueness check on blur)\n * before form submission.\n */\nexport const ValidateFieldRequest_Schema = z.object({\n  /** Field name to validate (must match a field in the resource schema) */\n  fieldName: z.string(),\n  /** The value to validate */\n  value: z.unknown(),\n  /** For UPDATE operations: exclude this resource ID from uniqueness check (self-exclusion) */\n  excludeId: z.string().optional(),\n});\n\nexport type ValidateFieldRequest = z.infer<typeof ValidateFieldRequest_Schema>;\n\n/**\n * Response schema for the validate-field endpoint.\n */\nexport const ValidateFieldResponse_Schema = z.object({\n  /** Whether the field value is valid */\n  valid: z.boolean(),\n  /** Error details when valid is false */\n  error: z.object({\n    /** Field name that failed validation */\n    fieldName: z.string(),\n    /** Display message (fallback English) */\n    message: z.string(),\n    /** i18n key for the error */\n    i18nKey: z.string().optional(),\n    /** i18n interpolation parameters */\n    i18nParams: z.record(z.string(), z.string()).optional(),\n  }).optional(),\n});\n\nexport type ValidateFieldResponse = z.infer<typeof ValidateFieldResponse_Schema>;\n"]}
+{"version":3,"file":"errors.shared.schemas.js","sourceRoot":"","sources":["../../../../src/errors/errors.shared.schemas.ts"],"names":[],"mappings":"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","sourcesContent":["import { z } from \"zod\";\nimport { ExecutionContext_ExecutionType, ExecutionContext_InitiatorIds, ExecutionContext_InitiatorIdsSchema } from \"../runtime/execution-context.shared.schemas\";\nimport { ErrorCustomMessageReference } from \"./errors.custom-message-ref.shared.definitions\";\nimport { NotificationNextStepType } from \"../notifications/notifications.shared.schemas\";\n\n/**\n * The coarse error category of every backend error. Import from\n * `@wildo-ai/saas-models`.\n *\n * The `ErrorType` you pass to `errorBuilder.buildError(type, …)` is the single\n * driver of the HTTP status code, the severity/logging level, and whether the\n * error's `context` is exposed to the client. Pick the type that matches the\n * real condition — never default everything to `INTERNAL`:\n *\n * | ErrorType            | HTTP | Use for                                             |\n * |----------------------|------|-----------------------------------------------------|\n * | `VALIDATION`         | 400  | Bad/malformed input, failed cross-field rules       |\n * | `AUTHENTICATION`     | 401  | Missing/invalid session or credentials              |\n * | `AUTHORIZATION`      | 403  | Authenticated but not permitted                     |\n * | `NOT_FOUND`          | 404  | Requested resource does not exist / not visible     |\n * | `CONFLICT`           | 409  | Uniqueness / version / state conflict               |\n * | `RATE_LIMIT`         | 429  | Too many requests                                   |\n * | `BUSINESS_RULE`      | 422  | Domain rule violated (well-formed but not allowed)  |\n * | `FEATURE_NOT_AVAILABLE` / `FEATURE_LIMIT_EXCEEDED` / `INSUFFICIENT_CREDITS` | 403/402 | Plan/feature gating |\n * | `EXTERNAL_SERVICE`   | 502  | A downstream provider/API failed                    |\n * | `CONFIGURATION`      | 500  | Server misconfiguration                             |\n * | `INTERNAL` / `DATABASE` / `INFRASTRUCTURE` | 500 | Server-side faults (context is stripped from the client) |\n *\n * Only VALIDATION / CONFLICT / RATE_LIMIT expose `context` to the client; every\n * other type strips it (so `context` is log-only). The user-facing wording never\n * comes from `context` — it comes from the `customMessageReference` (see\n * `ErrorCustomMessageReference`), resolved to localized text by `tErrorMessage`.\n */\nexport enum ErrorType {\n/** @wildo_source:part:start saas.models.error-type facet:layer:shared facet:family:error */\n\n  NETWORK = 'NETWORK',\n\n  AUTHENTICATION = 'AUTHENTICATION',\n  AUTHORIZATION = 'AUTHORIZATION',\n\n  VALIDATION = 'VALIDATION',\n\n  /** HTTP 413 — the request body exceeded a size limit (e.g. the OAuth mount's 32 KB cap or a global body\n   *  parser limit). A CLIENT input problem, classified separately from VALIDATION so the response carries the\n   *  precise 413 status framework-wide rather than a generic 400 (and never an INTERNAL 500). */\n  PAYLOAD_TOO_LARGE = 'PAYLOAD_TOO_LARGE',\n\n  NOT_FOUND = 'NOT_FOUND',\n  CONFLICT = 'CONFLICT',\n\n  RATE_LIMIT = 'RATE_LIMIT',\n\n  INTERNAL = 'INTERNAL',\n  DATABASE = 'DATABASE',\n  EXTERNAL_SERVICE = 'EXTERNAL_SERVICE',\n\n  UNKNOWN = 'UNKNOWN',\n  UNCAUGHT_EXCEPTION = 'UNCAUGHT_EXCEPTION',\n  UNHANDLED_REJECTION = 'UNHANDLED_REJECTION',\n\n  BUSINESS_RULE = 'BUSINESS_RULE',\n  INFRASTRUCTURE = 'INFRASTRUCTURE',\n  CONFIGURATION = 'CONFIGURATION',\n\n  // Feature gating errors\n  FEATURE_NOT_AVAILABLE = 'FEATURE_NOT_AVAILABLE',\n  FEATURE_LIMIT_EXCEEDED = 'FEATURE_LIMIT_EXCEEDED',\n  INSUFFICIENT_CREDITS = 'INSUFFICIENT_CREDITS',\n/** @wildo_source:part:end saas.models.error-type */\n}\n\n/**\n * Error severity levels\n */\n\nexport enum ErrorSeverity {\n  LOW = 'low',\n  MEDIUM = 'medium',\n  HIGH = 'high',\n  CRITICAL = 'critical',\n  ALERT = 'alert',\n  EMERGENCY = 'emergency',\n}\n\n/**\n * Frontend-specific error actions\n */\nexport enum ErrorActionFrontend {\n  NOTIFY = 'NOTIFY',\n  REDIRECT = 'REDIRECT',\n  RETRY = 'RETRY',\n  REFRESH_TOKEN = 'REFRESH_TOKEN',\n  DISCONNECT = 'DISCONNECT',\n  SHOW_MODAL = 'SHOW_MODAL',\n  SHOW_TOAST = 'SHOW_TOAST'\n}\n\n/**\n * Backend-specific error actions\n */\nexport enum ErrorActionBackend {\n  LOG = 'LOG',\n  ALERT = 'ALERT',\n  RECORD_METRICS = 'RECORD_METRICS',\n  TRACE = 'TRACE',\n  CIRCUIT_BREAK = 'CIRCUIT_BREAK',\n  GRACEFUL_DEGRADATION = 'GRACEFUL_DEGRADATION'\n}\n\nexport enum Error_Frontend_RedirectPolicy {\n  LOGIN = 'login',\n  HOME = 'home',\n  HISTORY_BACK = 'history_back',\n  // NOT_FOUND = 'not_found',\n  // UNAUTHORIZED = 'unauthorized',\n  // ERROR_PAGE = 'error_page',\n\n}\n\nexport enum ErrorHandling_Strategy {\n  STOP = \"stop\",\n  SKIP = \"skip\",\n  RETRY = \"retry\",\n  FALLBACK = \"fallback\",\n}\n\nexport enum RetryPolicy_BackoffType {\n  FIXED = \"fixed\",\n  EXPONENTIAL = \"exponential\",\n  LINEAR = \"linear\",\n}\n\n\nexport type WildoError_Definition = {\n  type: ErrorType;\n  severity: ErrorSeverity;\n  description: string;\n  defaultCustomMessageReference: ErrorCustomMessageReference;\n\n  errorHandlingStrategy?: ErrorHandling_Strategy;\n  retryPolicy?: RetryPolicy_BackoffType;\n  maxRetries?: number;\n  initialDelay?: number;\n  baseDelay?: number;\n\n  // Frontend-specific config\n  frontendActions: ErrorActionFrontend[];\n  redirectPolicy?: Error_Frontend_RedirectPolicy;\n  showToUser?: boolean;\n\n  // Backend-specific config\n  statusCode: number;\n  backendActions: ErrorActionBackend[];\n\n}\n\nexport type WildoError_Frontend_Definition = Omit<\n  WildoError_Definition,\n  'statusCode' | 'backendActions'\n>;\n\nexport type WildoError_Backend_Definition = Omit<\n  WildoError_Definition,\n  'frontendActions' | 'redirectPolicy' | 'showToUser'\n  >;\n\n\n\nexport const WildoErrorSchema = z.object({\n  type: z.enum(ErrorType),\n  severity: z.enum(ErrorSeverity),\n  operationPathKey: z.string().optional(),\n  timestamp: z.date(),\n\n  /**\n   * Free-form context bag attached to the error.\n   *\n   * The `message` slot is modelled explicitly (L1-6, post-Phase-7\n   * close-out) because consumers across the codebase reach for it\n   * via `error.context.message` as a strongly-typed human-readable\n   * detail string (notably the data-seeding `manual-seed-engine`\n   * extracts it via `isWildoBackendError → context.message` to\n   * surface scope-mismatch and other CONFIGURATION errors back into\n   * the `DataSeedRun.failureReport`). Modeling it here makes the\n   * contract typed at the producer side instead of relying on\n   * `z.record(string, any)` to let any shape through.\n   *\n   * Other fields remain free-form (`catchall(z.any())`) so existing\n   * callers that attach domain-specific keys (e.g. `envKey`,\n   * `headerKey`, `seedKey`) continue to work without a schema bump.\n   */\n  context: z.object({\n    message: z.string().optional(),\n  }).catchall(z.any()).optional(),\n  ipAddress: z.string().optional(),\n\n  // Resilience and retry policy\n  errorHandlingStrategy: z.enum(ErrorHandling_Strategy).optional(),\n  retryPolicy: z.enum(RetryPolicy_BackoffType).optional(),\n  maxRetries: z.number().optional(),\n  initialDelay: z.number().optional(),\n  baseDelay: z.number().optional(),\n  retryCount: z.number().optional(),\n  lastRetryTime: z.date().optional(),\n});\n\nexport type WildoError = z.infer<typeof WildoErrorSchema>;\n\n// =====================================================\n// Error User Guidance — contextual error resolution hints (Phase 1b)\n// =====================================================\n\n/**\n * Structured guidance attached to backend errors.\n * Tells the frontend what went wrong, how to fix it, and what to do next.\n *\n * Populated by `ErrorBuilderBackendService.buildErrorWithGuidance()` for\n * error types like CONFIGURATION, FEATURE_NOT_AVAILABLE, RATE_LIMIT, etc.\n *\n * NOTE: Defined before WildoError_BackendSchema because it's referenced there.\n */\nexport const ErrorUserGuidanceSchema = z.object({\n  /**\n   * i18n lookup key for this guidance block.\n   * Resolves labels under `errors_guidance.{guidanceKey}.{field}`.\n   * If not set, falls back to the error's `customMessageReference`.\n   */\n  guidanceKey: z.string().optional(),\n  /** Human-readable explanation of what went wrong */\n  explanation: z.string().optional(),\n  /** How to resolve the issue */\n  resolution: z.string().optional(),\n  /** Steps already completed before the error occurred */\n  completedSteps: z.array(z.string()).optional(),\n  /** Suggested next action (operation or URL) */\n  nextAction: z.object({\n    label: z.string(),\n    /** Operation path or URL */\n    ref: z.string(),\n    type: z.enum(NotificationNextStepType).default(NotificationNextStepType.OPERATION),\n  }).optional(),\n  /** For rate limits: seconds until retry is available */\n  retryAfterSeconds: z.number().optional(),\n  /** For configuration errors: what configuration elements are missing */\n  missingConfiguration: z.array(z.string()).optional(),\n});\n\nexport type ErrorUserGuidance = z.infer<typeof ErrorUserGuidanceSchema>;\n\n// =====================================================\n// WildoError — Backend (extends base with backend-specific fields)\n// =====================================================\n\nexport const WildoError_BackendSchema = WildoErrorSchema.extend({\n  backendActions: z.array(z.enum(ErrorActionBackend)),\n  customMessageReference: z.enum(ErrorCustomMessageReference),\n  statusCode: z.number(),\n  stack: z.string().optional(),\n  /** The request-correlation id (see `ExecutionContext.correlationId`). Populated from the EC when one was threaded, else from the ambient request-context ALS frame — that fallback is what attributes the many `buildError` call sites that pass no EC. */\n  correlationId: z.string().optional(),\n  initiatorIds: ExecutionContext_InitiatorIdsSchema.optional().nullable(),\n  executionType: z.enum(ExecutionContext_ExecutionType).optional(),\n  /** Contextual user guidance for error resolution (Phase 1b) */\n  userGuidance: ErrorUserGuidanceSchema.optional(),\n});\n\nexport type WildoError_Backend = z.infer<typeof WildoError_BackendSchema>;\n\n/**\n * Type guard for WildoError_Backend — safely identifies engine-thrown errors in catch blocks.\n *\n * Replaces the unsafe `(error as any).type` pattern. Checks for the 4 structural\n * properties that distinguish WildoError_Backend from arbitrary Error objects.\n */\nexport function isWildoBackendError(error: unknown): error is WildoError_Backend {\n  return (\n    error !== null &&\n    typeof error === 'object' &&\n    'type' in error &&\n    'statusCode' in error &&\n    'severity' in error &&\n    'customMessageReference' in error\n  );\n}\n\n// =====================================================\n// WildoError — Frontend\n// =====================================================\n\nexport const WildoError_FrontendSchema = WildoErrorSchema.extend({\n  userId: z.string().optional(),\n  organizationId: z.string().optional(),\n  customMessageReference: z.enum(ErrorCustomMessageReference),\n  frontendActions: z.array(z.enum(ErrorActionFrontend)),\n  redirectPolicy: z.enum(Error_Frontend_RedirectPolicy).optional(),\n\n  showToUser: z.boolean().optional(),\n\n  /**\n   * When true, the GLOBAL error handler must NOT surface a user-facing toast or\n   * modal for this error — the originating caller already owns the failure UX\n   * (e.g. a resource form shows `NOTIFY_RESOURCE_ERROR` + inline field errors).\n   * Derived from the per-request `silent` flag. Side-effects (auth-logout,\n   * redirect, dedup, analytics) still run.\n   *\n   * MUST be a declared schema field: the frontend event bus Zod-parses\n   * `ERROR_OCCURED` payloads and strips unknown keys, so an untyped\n   * `(error as any).suppressUserDisplay` would be dropped before the handler\n   * ever reads it.\n   */\n  suppressUserDisplay: z.boolean().optional(),\n\n  /**\n   * When true, the error must drive a logout through the AuthSession fast-path.\n   * `GlobalErrorHandler` detects `triggerLogout` (independently of the error's\n   * `type`) and calls `logout()` — guarded by `isAuthenticated()` so it never\n   * logs out when no session is active — then strips the `DISCONNECT`\n   * frontendAction from the delegated actions so the ErrorContext fallback does\n   * not double-trigger a logout. Derived from the HTTP error-behavior matrix\n   * (`HttpErrorBehavior.triggerLogout`, e.g. a 401 invalid session).\n   *\n   * Intentionally NOT additionally gated on `type === AUTHENTICATION`: the\n   * error's `type` comes from the backend payload (`backendErrorType ||\n   * behavior.errorType` in `buildWildoError`), so a 401 the backend typed as\n   * something else would still carry `triggerLogout` from the status matrix —\n   * an extra type gate would silently swallow that logout. Mirrors\n   * `handleHttpError`'s `shouldLogout`, which is triggerLogout-only.\n   *\n   * MUST be a declared schema field — same reason as `suppressUserDisplay`\n   * above: the frontend event bus Zod-parses `ERROR_OCCURED` payloads and\n   * strips unknown keys, so an untyped `(error as any).triggerLogout` set by\n   * `buildWildoError` would be dropped before `GlobalErrorHandler` ever reads\n   * it, leaving the AuthSession logout fast-path permanently dead.\n   */\n  triggerLogout: z.boolean().optional(),\n\n  /** Contextual error guidance from backend (Phase 1b) */\n  userGuidance: ErrorUserGuidanceSchema.optional(),\n});\n\nexport type WildoError_Frontend = z.infer<typeof WildoError_FrontendSchema>;\n\n\n// =============================================================================\n// VALIDATION ERROR ENTRY — STRUCTURED i18n-READY ERROR FORMAT\n// =============================================================================\n\n/**\n * Field-validation issues the BACKEND raises, beyond the Zod issue codes a schema produces on its own.\n *\n * Each member is a key of the frontend's `errors_validation` catalog (`errors_validation.<code>.msg`), so the\n * words a person reads are the application's, in their language. The server sends the code and never the\n * sentence: RFC 9457 §3.1.4 says a consumer \"SHOULD NOT parse the 'detail' member for information;\n * extensions are more suitable\", and §3.2 puts machine-readable facts in extension members.\n * spec-cite: RFC 9457 (Problem Details for HTTP APIs) §3.1.4, §3.2.\n */\nexport enum FieldValidationIssueCode {\n  /** A value already exists on a field declared `.isUnique()`. Raised at write time and by validate-field. */\n  NOT_UNIQUE = 'not_unique',\n}\n\n/**\n * A field error the backend raises as a CODE.\n *\n * Validation errors reach a form as either:\n * - a plain string — a message a schema produced, shown as-is;\n * - a `ValidationErrorEntry` — a code the client renders from its own catalog.\n *\n * It carries no message on purpose: prose written here is English in every locale, which is what\n * `.claude/rules/display-text-comes-from-i18n.md` forbids and what #1180 removed.\n */\nexport const ValidationErrorEntry_Schema = z.object({\n  /** The issue's code; the frontend resolves `errors_validation.<code>.msg`. */\n  code: z.enum(FieldValidationIssueCode),\n  /** Interpolation parameters for that catalog message. `NOT_UNIQUE` needs none. */\n  params: z.record(z.string(), z.string()).optional(),\n});\n\nexport type ValidationErrorEntry = z.infer<typeof ValidationErrorEntry_Schema>;\n\nexport const VersionConflictDetailsSchema = z.object({\n  currentVersion: z.number(),\n  expectedVersion: z.number(),\n  conflictingFields: z.array(z.string()),\n  currentValues: z.record(z.string(), z.unknown()),\n  submittedValues: z.record(z.string(), z.unknown()),\n});\n\nexport type VersionConflictDetails = z.infer<typeof VersionConflictDetailsSchema>;\n\n/**\n * SaaS Error Type Definition\n * Replaces the previous WildoError class\n */\n\n/**\n * Error Response Schema\n * Updated to include operationPath and validationErrors (FIX-P6-H1)\n */\nexport const ErrorResponseSchema = z.object({\n  error: z.object({\n    type: z.enum(ErrorType),\n    severity: z.enum(ErrorSeverity),\n    message: z.string(),\n    customMessage: z.string(),\n    customMessageReference: z.string().optional(),\n    code: z.string().optional(),\n    operationPath: z.string().optional(),\n    /**\n     * Request-correlation id (see `ExecutionContext.correlationId`) — a safe, non-PII support/trace id\n     * the client can quote and that joins this response to the backend log lines + audit rows for the\n     * same request. Present for any request-scoped error (the error's captured id, or the ambient\n     * request-context frame at send time).\n     */\n    correlationId: z.string().optional(),\n    details: z.object({\n      versionConflict: VersionConflictDetailsSchema.optional(),\n    }).catchall(z.any()).optional(),\n    timestamp: z.string(),\n    initiatorIds: ExecutionContext_InitiatorIdsSchema.optional().nullable(),\n    /** Field-level validation errors. Values are either plain strings or structured i18n entries. */\n    validationErrors: z.record(z.string(), z.union([z.string(), ValidationErrorEntry_Schema])).optional(),\n    /** Contextual user guidance for error resolution (Phase 1b) */\n    userGuidance: ErrorUserGuidanceSchema.optional(),\n  })\n});\n\nexport type ErrorResponse = z.infer<typeof ErrorResponseSchema>;\n\n/**\n * A single validation error value: either a plain string or a structured entry.\n * Backend can return either format; frontend handles both transparently.\n */\nexport type ValidationErrorValue = string | ValidationErrorEntry;\n\n/**\n * Field-level validation errors map.\n * Keys are dot-notation field paths (e.g., \"email\", \"address.city\").\n * Values are either plain strings or structured i18n entries.\n */\nexport type ValidationErrors = Record<string, ValidationErrorValue>;\n\n// =============================================================================\n// VALIDATION ERROR RESPONSE SCHEMA\n// =============================================================================\n\n/**\n * Standardized validation error response format.\n * Used by both backend (400/409 responses) and frontend (error parsing).\n *\n * The `validationErrors` field maps field names to error values:\n * - Plain string: displayed as-is (legacy format)\n * - ValidationErrorEntry: resolved via i18n on frontend\n */\nexport const ValidationErrorResponse_Schema = z.object({\n  /** HTTP status code (400 for validation, 409 for unique constraint) */\n  code: z.number(),\n  /** General error message */\n  message: z.string(),\n  /**\n   * Field-level validation errors.\n   * Field names can be dot-notation paths for nested fields.\n   * Values are either plain strings or structured i18n entries.\n   */\n  validationErrors: z.record(z.string(), z.union([z.string(), ValidationErrorEntry_Schema])).optional(),\n});\n\nexport type ValidationErrorResponse = z.infer<typeof ValidationErrorResponse_Schema>;\n\n// =============================================================================\n// PARSED HTTP ERROR — TYPED FRONTEND ERROR REPRESENTATION\n// =============================================================================\n\n/**\n * Parsed HTTP error — the typed result of processing an HTTP error response.\n *\n * This is the frontend counterpart of WildoError_Backend. It provides typed\n * access to all error properties that the HTTP client interceptor extracts\n * from the backend's ErrorResponse format.\n *\n * Replaces the previous untyped `error as Record<string, unknown>` pattern.\n */\nexport interface ParsedHttpError {\n  /** HTTP status code (e.g., 400, 401, 409, 500) */\n  httpStatus: number;\n  /** Error type from the backend error classification */\n  errorType: ErrorType;\n  /** Human-readable error message */\n  message: string;\n  /** Field-level validation errors (present for 400/409/422 responses) */\n  validationErrors?: ValidationErrors;\n  /** Additional error context/details from the backend */\n  details?: Record<string, any>;\n  /** Operation path that triggered the error */\n  operationPath?: string;\n  /** Structured user-facing guidance for error resolution */\n  userGuidance?: ErrorUserGuidance;\n}\n\n// =============================================================================\n// VALIDATION ERROR EXTRACTION UTILITIES\n// =============================================================================\n\n/**\n * Check whether a validation error value is a coded entry rather than a plain message.\n *\n * There is deliberately NO shared \"resolve this to a display string\" helper: a coded entry carries no words,\n * and only the frontend — which holds the catalog and the person's language — can turn it into text. A helper\n * here could only have invented English (#1180).\n *\n * @param value - A validation error value\n * @returns True when the value is a coded `ValidationErrorEntry`\n */\nexport function isValidationErrorEntry(value: ValidationErrorValue): value is ValidationErrorEntry {\n  return typeof value === 'object' && value !== null && 'code' in value;\n}\n\n/**\n * Extract validation errors from a raw error response payload.\n *\n * Handles multiple formats:\n * 1. Standard backend ErrorResponse: `{ error: { validationErrors: { ... } } }`\n * 2. Flat format (legacy): `{ validationErrors: { ... } }`\n * 3. Pre-parsed interceptor format: `error.validationErrors` on the error object\n *\n * @param payload - Raw error response payload (from axios response.data or error object)\n * @returns Extracted validation errors, or undefined if not found\n */\nexport function extractValidationErrors(payload: unknown): ValidationErrors | undefined {\n  if (!payload || typeof payload !== 'object') return undefined;\n\n  const obj = payload as Record<string, unknown>;\n\n  // Path 1: Standard nested format { error: { validationErrors } }\n  if (obj.error && typeof obj.error === 'object') {\n    const nested = obj.error as Record<string, unknown>;\n    if (nested.validationErrors && typeof nested.validationErrors === 'object' && !Array.isArray(nested.validationErrors)) {\n      const ve = nested.validationErrors as Record<string, unknown>;\n      if (Object.keys(ve).length > 0) {\n        return ve as ValidationErrors;\n      }\n    }\n  }\n\n  // Path 2: Flat format { validationErrors }\n  if (obj.validationErrors && typeof obj.validationErrors === 'object' && !Array.isArray(obj.validationErrors)) {\n    const ve = obj.validationErrors as Record<string, unknown>;\n    if (Object.keys(ve).length > 0) {\n      return ve as ValidationErrors;\n    }\n  }\n\n  return undefined;\n}\n\n// =============================================================================\n// FIELD VALIDATION — REQUEST/RESPONSE SCHEMAS\n// =============================================================================\n\n/**\n * Request schema for the validate-field endpoint.\n *\n * Used to pre-validate a single field value (e.g., uniqueness check on blur)\n * before form submission.\n */\nexport const ValidateFieldRequest_Schema = z.object({\n  /** Field name to validate (must match a field in the resource schema) */\n  fieldName: z.string(),\n  /** The value to validate */\n  value: z.unknown(),\n  /** For UPDATE operations: exclude this resource ID from uniqueness check (self-exclusion) */\n  excludeId: z.string().optional(),\n});\n\nexport type ValidateFieldRequest = z.infer<typeof ValidateFieldRequest_Schema>;\n\n/**\n * Response schema for the validate-field endpoint.\n */\nexport const ValidateFieldResponse_Schema = z.object({\n  /** Whether the field value is valid */\n  valid: z.boolean(),\n  /**\n   * The issue when `valid` is false. It carries a CODE, never a sentence: the words are the client's, from\n   * `errors_validation.<code>.msg` (#1180).\n   */\n  error: z.object({\n    /** Field name that failed validation */\n    fieldName: z.string(),\n    /** The issue's code, rendered by the client from its own validation catalog. */\n    code: z.enum(FieldValidationIssueCode),\n    /** Interpolation parameters for that catalog message. */\n    params: z.record(z.string(), z.string()).optional(),\n  }).optional(),\n});\n\nexport type ValidateFieldResponse = z.infer<typeof ValidateFieldResponse_Schema>;\n"]}

package/dist/esm/errors/errors.shared.utils.d.ts

@@ -12,4 +12,28 @@ export declare function getErrorStatusCode(errorType: ErrorType): number;
  * Get error severity for error type
  */
 export declare function getErrorSeverity(errorType: ErrorType): ErrorSeverity;
+/**
+ * A caught value as ONE readable line, for a destination whose contract is genuinely `string`: an
+ * error message, a persisted terminal diagnostic, a DLQ record, a thrown `Error`'s text.
+ *
+ * It exists because the obvious inline form — take `.message` when the value is an `Error`, else
+ * `String(...)` it — is wrong for the engine's own error type: a {@link WildoError_Backend} is a plain
+ * object, NOT an `Error`, so it takes the `String(...)` branch and every structured failure reads as the literal
+ * `'[object Object]'` — unreadable, and identical for every distinct fault. `check:inline-error-stringify`
+ * holds that form shrink-only (#1518).
+ *
+ * It lives HERE, beside {@link isWildoBackendError}, because this is the lowest layer every package
+ * can import: the frontend, the specifications, the test lanes and the backend alike. The backend
+ * library's `describeCaughtError` delegates to it, so there is one implementation.
+ *
+ * For a `WildoError_Backend`: the human `context.message` when present, else the stable
+ * `customMessageReference` code. For LOGGING, prefer a structured projection over this string.
+ */
+export declare function describeCaughtError(error: unknown): string;
+/**
+ * `"<kind>: <message>"` for ANY caught value — {@link describeCaughtError} for a destination that also
+ * needs WHAT KIND of thing failed: a failure digest or dedup key, a persisted terminal diagnostic, a
+ * classifier. A `WildoError_Backend` has no `name`; its kind is `type/customMessageReference`.
+ */
+export declare function describeCaughtErrorWithKind(error: unknown): string;
 //# sourceMappingURL=errors.shared.utils.d.ts.map

package/dist/esm/errors/errors.shared.utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"errors.shared.utils.d.ts","sourceRoot":"","sources":["../../../../src/errors/errors.shared.utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAInE;;;GAGG;AACH,wBAAgB,qCAAqC,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAG7E;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,SAAS,GAAG,MAAM,CAE/D;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,SAAS,GAAG,aAAa,CAEpE"}
+{"version":3,"file":"errors.shared.utils.d.ts","sourceRoot":"","sources":["../../../../src/errors/errors.shared.utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,aAAa,EAAuB,MAAM,yBAAyB,CAAC;AAKxF;;;GAGG;AACH,wBAAgB,qCAAqC,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAG7E;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,SAAS,GAAG,MAAM,CAE/D;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,SAAS,GAAG,aAAa,CAEpE;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAQ1D;AAED;;;;GAIG;AACH,wBAAgB,2BAA2B,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAKlE"}

package/dist/esm/errors/errors.shared.utils.js

@@ -1,5 +1,7 @@
+import { isWildoBackendError } from './errors.shared.schemas.js';
 import { ERROR_DEFINITIONS } from './errors.shared.definitions.js';
 import { ErrorCustomMessageReference } from './errors.custom-message-ref.shared.definitions.js';
+import { describeNonErrorValue, describeThrownValue } from './thrown-value-description.shared.utils.js';
 /**
  * Check if an error is the "app configuration not initialized" error.
  * Use this instead of string-matching on error messages.
@@ -20,4 +22,41 @@ export function getErrorStatusCode(errorType) {
 export function getErrorSeverity(errorType) {
     return ERROR_DEFINITIONS[errorType].severity;
 }
+/**
+ * A caught value as ONE readable line, for a destination whose contract is genuinely `string`: an
+ * error message, a persisted terminal diagnostic, a DLQ record, a thrown `Error`'s text.
+ *
+ * It exists because the obvious inline form — take `.message` when the value is an `Error`, else
+ * `String(...)` it — is wrong for the engine's own error type: a {@link WildoError_Backend} is a plain
+ * object, NOT an `Error`, so it takes the `String(...)` branch and every structured failure reads as the literal
+ * `'[object Object]'` — unreadable, and identical for every distinct fault. `check:inline-error-stringify`
+ * holds that form shrink-only (#1518).
+ *
+ * It lives HERE, beside {@link isWildoBackendError}, because this is the lowest layer every package
+ * can import: the frontend, the specifications, the test lanes and the backend alike. The backend
+ * library's `describeCaughtError` delegates to it, so there is one implementation.
+ *
+ * For a `WildoError_Backend`: the human `context.message` when present, else the stable
+ * `customMessageReference` code. For LOGGING, prefer a structured projection over this string.
+ */
+export function describeCaughtError(error) {
+    if (isWildoBackendError(error)) {
+        const detail = error.context?.message;
+        return typeof detail === 'string' && detail.length > 0
+            ? detail
+            : String(error.customMessageReference);
+    }
+    return describeThrownValue(error);
+}
+/**
+ * `"<kind>: <message>"` for ANY caught value — {@link describeCaughtError} for a destination that also
+ * needs WHAT KIND of thing failed: a failure digest or dedup key, a persisted terminal diagnostic, a
+ * classifier. A `WildoError_Backend` has no `name`; its kind is `type/customMessageReference`.
+ */
+export function describeCaughtErrorWithKind(error) {
+    if (isWildoBackendError(error)) {
+        return `${error.type}/${error.customMessageReference}: ${describeCaughtError(error)}`;
+    }
+    return error instanceof Error ? `${error.name}: ${error.message}` : describeNonErrorValue(error);
+}
 //# sourceMappingURL=errors.shared.utils.js.map

package/dist/esm/errors/errors.shared.utils.js.map

@@ -1 +1 @@
-{"version":3,"file":"errors.shared.utils.js","sourceRoot":"","sources":["../../../../src/errors/errors.shared.utils.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAC;AAChE,OAAO,EAAE,2BAA2B,EAAE,MAAM,gDAAgD,CAAC;AAE7F;;;GAGG;AACH,MAAM,UAAU,qCAAqC,CAAC,KAAc;IAClE,MAAM,GAAG,GAAG,KAA+D,CAAC;IAC5E,OAAO,GAAG,EAAE,sBAAsB,KAAK,2BAA2B,CAAC,iCAAiC,CAAC;AACvG,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,kBAAkB,CAAC,SAAoB;IACrD,OAAO,iBAAiB,CAAC,SAAS,CAAC,CAAC,UAAU,CAAC;AACjD,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAAC,SAAoB;IACnD,OAAO,iBAAiB,CAAC,SAAS,CAAC,CAAC,QAAQ,CAAC;AAC/C,CAAC","sourcesContent":["import { ErrorType, ErrorSeverity } from './errors.shared.schemas';\nimport { ERROR_DEFINITIONS } from './errors.shared.definitions';\nimport { ErrorCustomMessageReference } from './errors.custom-message-ref.shared.definitions';\n\n/**\n * Check if an error is the \"app configuration not initialized\" error.\n * Use this instead of string-matching on error messages.\n */\nexport function isAppConfigurationNotInitializedError(error: unknown): boolean {\n  const err = error as { customMessageReference?: string } | null | undefined;\n  return err?.customMessageReference === ErrorCustomMessageReference.APP_CONFIGURATION_NOT_INITIALIZED;\n}\n\n/**\n * Get HTTP status code for error type\n */\nexport function getErrorStatusCode(errorType: ErrorType): number {\n  return ERROR_DEFINITIONS[errorType].statusCode;\n}\n\n/**\n * Get error severity for error type\n */\nexport function getErrorSeverity(errorType: ErrorType): ErrorSeverity {\n  return ERROR_DEFINITIONS[errorType].severity;\n}\n"]}
+{"version":3,"file":"errors.shared.utils.js","sourceRoot":"","sources":["../../../../src/errors/errors.shared.utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAA4B,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AACxF,OAAO,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAC;AAChE,OAAO,EAAE,2BAA2B,EAAE,MAAM,gDAAgD,CAAC;AAC7F,OAAO,EAAE,qBAAqB,EAAE,mBAAmB,EAAE,MAAM,yCAAyC,CAAC;AAErG;;;GAGG;AACH,MAAM,UAAU,qCAAqC,CAAC,KAAc;IAClE,MAAM,GAAG,GAAG,KAA+D,CAAC;IAC5E,OAAO,GAAG,EAAE,sBAAsB,KAAK,2BAA2B,CAAC,iCAAiC,CAAC;AACvG,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,kBAAkB,CAAC,SAAoB;IACrD,OAAO,iBAAiB,CAAC,SAAS,CAAC,CAAC,UAAU,CAAC;AACjD,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAAC,SAAoB;IACnD,OAAO,iBAAiB,CAAC,SAAS,CAAC,CAAC,QAAQ,CAAC;AAC/C,CAAC;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,UAAU,mBAAmB,CAAC,KAAc;IAChD,IAAI,mBAAmB,CAAC,KAAK,CAAC,EAAE,CAAC;QAC/B,MAAM,MAAM,GAAG,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC;QACtC,OAAO,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC;YACpD,CAAC,CAAC,MAAM;YACR,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,sBAAsB,CAAC,CAAC;IAC3C,CAAC;IACD,OAAO,mBAAmB,CAAC,KAAK,CAAC,CAAC;AACpC,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,2BAA2B,CAAC,KAAc;IACxD,IAAI,mBAAmB,CAAC,KAAK,CAAC,EAAE,CAAC;QAC/B,OAAO,GAAG,KAAK,CAAC,IAAI,IAAI,KAAK,CAAC,sBAAsB,KAAK,mBAAmB,CAAC,KAAK,CAAC,EAAE,CAAC;IACxF,CAAC;IACD,OAAO,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,IAAI,KAAK,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,qBAAqB,CAAC,KAAK,CAAC,CAAC;AACnG,CAAC","sourcesContent":["import { ErrorType, ErrorSeverity, isWildoBackendError } from './errors.shared.schemas';\nimport { ERROR_DEFINITIONS } from './errors.shared.definitions';\nimport { ErrorCustomMessageReference } from './errors.custom-message-ref.shared.definitions';\nimport { describeNonErrorValue, describeThrownValue } from './thrown-value-description.shared.utils';\n\n/**\n * Check if an error is the \"app configuration not initialized\" error.\n * Use this instead of string-matching on error messages.\n */\nexport function isAppConfigurationNotInitializedError(error: unknown): boolean {\n  const err = error as { customMessageReference?: string } | null | undefined;\n  return err?.customMessageReference === ErrorCustomMessageReference.APP_CONFIGURATION_NOT_INITIALIZED;\n}\n\n/**\n * Get HTTP status code for error type\n */\nexport function getErrorStatusCode(errorType: ErrorType): number {\n  return ERROR_DEFINITIONS[errorType].statusCode;\n}\n\n/**\n * Get error severity for error type\n */\nexport function getErrorSeverity(errorType: ErrorType): ErrorSeverity {\n  return ERROR_DEFINITIONS[errorType].severity;\n}\n\n/**\n * A caught value as ONE readable line, for a destination whose contract is genuinely `string`: an\n * error message, a persisted terminal diagnostic, a DLQ record, a thrown `Error`'s text.\n *\n * It exists because the obvious inline form — take `.message` when the value is an `Error`, else\n * `String(...)` it — is wrong for the engine's own error type: a {@link WildoError_Backend} is a plain\n * object, NOT an `Error`, so it takes the `String(...)` branch and every structured failure reads as the literal\n * `'[object Object]'` — unreadable, and identical for every distinct fault. `check:inline-error-stringify`\n * holds that form shrink-only (#1518).\n *\n * It lives HERE, beside {@link isWildoBackendError}, because this is the lowest layer every package\n * can import: the frontend, the specifications, the test lanes and the backend alike. The backend\n * library's `describeCaughtError` delegates to it, so there is one implementation.\n *\n * For a `WildoError_Backend`: the human `context.message` when present, else the stable\n * `customMessageReference` code. For LOGGING, prefer a structured projection over this string.\n */\nexport function describeCaughtError(error: unknown): string {\n  if (isWildoBackendError(error)) {\n    const detail = error.context?.message;\n    return typeof detail === 'string' && detail.length > 0\n      ? detail\n      : String(error.customMessageReference);\n  }\n  return describeThrownValue(error);\n}\n\n/**\n * `\"<kind>: <message>\"` for ANY caught value — {@link describeCaughtError} for a destination that also\n * needs WHAT KIND of thing failed: a failure digest or dedup key, a persisted terminal diagnostic, a\n * classifier. A `WildoError_Backend` has no `name`; its kind is `type/customMessageReference`.\n */\nexport function describeCaughtErrorWithKind(error: unknown): string {\n  if (isWildoBackendError(error)) {\n    return `${error.type}/${error.customMessageReference}: ${describeCaughtError(error)}`;\n  }\n  return error instanceof Error ? `${error.name}: ${error.message}` : describeNonErrorValue(error);\n}\n\n"]}

package/dist/esm/errors/thrown-value-description.shared.utils.d.ts

@@ -0,0 +1,27 @@
+/**
+ * A caught value as ONE readable line — the part of `describeCaughtError` that knows nothing about the
+ * engine's own error type, and therefore needs no import at all.
+ *
+ * Split out (2026-09-24) so a BROWSER-bound package can describe a caught value without importing the
+ * root of `@wildo-ai/saas-models`: `describeCaughtError` must recognise a `WildoError_Backend`, which
+ * pulls the error schemas and definitions, while a bundle-isolated package (`saas-website`) may reach
+ * this package only through `@wildo-ai/saas-models/public-runtime`. It is re-exported there, and
+ * `describeCaughtError` delegates to it for every value that is not a `WildoError_Backend`, so there is
+ * still one implementation of the rendering.
+ *
+ * Use `describeCaughtError` wherever the root is importable: a value that IS a `WildoError_Backend`
+ * reads here as its identifying fields rather than its human message.
+ */
+export declare function describeThrownValue(error: unknown): string;
+/**
+ * Render a thrown value that is neither an `Error` nor a {@link WildoError_Backend}.
+ *
+ * `String(value)` renders EVERY plain object as `'[object Object]'`, so distinct faults become one
+ * string. Measured 2026-09-23 (#1273): a playbook failed inside the journey's choreography and the run
+ * record persisted `'[object Object]'` as its only diagnostic. So an object is rendered by its
+ * {@link IDENTIFYING_FIELDS} with their scalar values, and by the NAMES of its other fields — never
+ * their values, which is where the data a fault carries lives (see that constant). A cyclic object
+ * needs no serialization this way, and the result is bounded.
+ */
+export declare function describeNonErrorValue(value: unknown): string;
+//# sourceMappingURL=thrown-value-description.shared.utils.d.ts.map

package/dist/esm/errors/thrown-value-description.shared.utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"thrown-value-description.shared.utils.d.ts","sourceRoot":"","sources":["../../../../src/errors/thrown-value-description.shared.utils.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAE1D;AAmBD;;;;;;;;;GASG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAoB5D"}

package/dist/esm/errors/thrown-value-description.shared.utils.js

@@ -0,0 +1,67 @@
+/**
+ * A caught value as ONE readable line — the part of `describeCaughtError` that knows nothing about the
+ * engine's own error type, and therefore needs no import at all.
+ *
+ * Split out (2026-09-24) so a BROWSER-bound package can describe a caught value without importing the
+ * root of `@wildo-ai/saas-models`: `describeCaughtError` must recognise a `WildoError_Backend`, which
+ * pulls the error schemas and definitions, while a bundle-isolated package (`saas-website`) may reach
+ * this package only through `@wildo-ai/saas-models/public-runtime`. It is re-exported there, and
+ * `describeCaughtError` delegates to it for every value that is not a `WildoError_Backend`, so there is
+ * still one implementation of the rendering.
+ *
+ * Use `describeCaughtError` wherever the root is importable: a value that IS a `WildoError_Backend`
+ * reads here as its identifying fields rather than its human message.
+ */
+export function describeThrownValue(error) {
+    return error instanceof Error ? error.message : describeNonErrorValue(error);
+}
+/**
+ * The fields of a thrown plain object that IDENTIFY the fault, rendered with their values — in this
+ * order. Everything else on the object is named by KEY only.
+ *
+ * The split is the logging rule, stated once: a diagnostic carries what failed, never the data it
+ * failed on. A provider's structured-generation error is a plain object whose other fields are the
+ * model's generated `text`, the provider `response` body and the rejected `cause.value`; rendering the
+ * whole object put all three into error logs and into trace telemetry every sink emits (measured
+ * 2026-09-24 on `agents.backend.service.structured-output-limit`, five pins red). An engine or
+ * application fault object names itself through these keys — `{ kind, reason }`, `{ code, message }` —
+ * so its diagnostic survives intact.
+ */
+const IDENTIFYING_FIELDS = ['name', 'code', 'kind', 'type', 'status', 'statusCode', 'reason', 'message'];
+/** The longest diagnostic this renders; a longer one is cut and says so. */
+const NON_ERROR_DESCRIPTION_LIMIT = 400;
+/**
+ * Render a thrown value that is neither an `Error` nor a {@link WildoError_Backend}.
+ *
+ * `String(value)` renders EVERY plain object as `'[object Object]'`, so distinct faults become one
+ * string. Measured 2026-09-23 (#1273): a playbook failed inside the journey's choreography and the run
+ * record persisted `'[object Object]'` as its only diagnostic. So an object is rendered by its
+ * {@link IDENTIFYING_FIELDS} with their scalar values, and by the NAMES of its other fields — never
+ * their values, which is where the data a fault carries lives (see that constant). A cyclic object
+ * needs no serialization this way, and the result is bounded.
+ */
+export function describeNonErrorValue(value) {
+    if (typeof value !== 'object' || value === null)
+        return String(value);
+    let keys;
+    try {
+        keys = Object.keys(value);
+    }
+    catch {
+        return String(value);
+    }
+    const record = value;
+    const identifying = IDENTIFYING_FIELDS.filter((key) => {
+        const field = record[key];
+        return (typeof field === 'string' && field.length > 0) || typeof field === 'number' || typeof field === 'boolean';
+    });
+    const parts = identifying.map((key) => `${key}: ${String(record[key])}`);
+    const otherKeys = keys.filter((key) => !identifying.includes(key));
+    if (otherKeys.length > 0)
+        parts.push(`fields: ${otherKeys.join(', ')}`);
+    const description = `{${parts.join('; ')}}`;
+    return description.length > NON_ERROR_DESCRIPTION_LIMIT
+        ? `${description.slice(0, NON_ERROR_DESCRIPTION_LIMIT)}… (truncated)`
+        : description;
+}
+//# sourceMappingURL=thrown-value-description.shared.utils.js.map

package/dist/esm/errors/thrown-value-description.shared.utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"thrown-value-description.shared.utils.js","sourceRoot":"","sources":["../../../../src/errors/thrown-value-description.shared.utils.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,mBAAmB,CAAC,KAAc;IAChD,OAAO,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,qBAAqB,CAAC,KAAK,CAAC,CAAC;AAC/E,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,kBAAkB,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,YAAY,EAAE,QAAQ,EAAE,SAAS,CAAU,CAAC;AAElH,4EAA4E;AAC5E,MAAM,2BAA2B,GAAG,GAAG,CAAC;AAExC;;;;;;;;;GASG;AACH,MAAM,UAAU,qBAAqB,CAAC,KAAc;IAClD,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC;IACtE,IAAI,IAAc,CAAC;IACnB,IAAI,CAAC;QACH,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC5B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC;IACvB,CAAC;IACD,MAAM,MAAM,GAAG,KAAgC,CAAC;IAChD,MAAM,WAAW,GAAG,kBAAkB,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE;QACpD,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;QAC1B,OAAO,CAAC,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,OAAO,KAAK,KAAK,SAAS,CAAC;IACpH,CAAC,CAAC,CAAC;IACH,MAAM,KAAK,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,GAAG,KAAK,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC;IACzE,MAAM,SAAS,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAE,WAAiC,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC;IAC1F,IAAI,SAAS,CAAC,MAAM,GAAG,CAAC;QAAE,KAAK,CAAC,IAAI,CAAC,WAAW,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACxE,MAAM,WAAW,GAAG,IAAI,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC;IAC5C,OAAO,WAAW,CAAC,MAAM,GAAG,2BAA2B;QACrD,CAAC,CAAC,GAAG,WAAW,CAAC,KAAK,CAAC,CAAC,EAAE,2BAA2B,CAAC,eAAe;QACrE,CAAC,CAAC,WAAW,CAAC;AAClB,CAAC","sourcesContent":["/**\n * A caught value as ONE readable line — the part of `describeCaughtError` that knows nothing about the\n * engine's own error type, and therefore needs no import at all.\n *\n * Split out (2026-09-24) so a BROWSER-bound package can describe a caught value without importing the\n * root of `@wildo-ai/saas-models`: `describeCaughtError` must recognise a `WildoError_Backend`, which\n * pulls the error schemas and definitions, while a bundle-isolated package (`saas-website`) may reach\n * this package only through `@wildo-ai/saas-models/public-runtime`. It is re-exported there, and\n * `describeCaughtError` delegates to it for every value that is not a `WildoError_Backend`, so there is\n * still one implementation of the rendering.\n *\n * Use `describeCaughtError` wherever the root is importable: a value that IS a `WildoError_Backend`\n * reads here as its identifying fields rather than its human message.\n */\nexport function describeThrownValue(error: unknown): string {\n  return error instanceof Error ? error.message : describeNonErrorValue(error);\n}\n\n/**\n * The fields of a thrown plain object that IDENTIFY the fault, rendered with their values — in this\n * order. Everything else on the object is named by KEY only.\n *\n * The split is the logging rule, stated once: a diagnostic carries what failed, never the data it\n * failed on. A provider's structured-generation error is a plain object whose other fields are the\n * model's generated `text`, the provider `response` body and the rejected `cause.value`; rendering the\n * whole object put all three into error logs and into trace telemetry every sink emits (measured\n * 2026-09-24 on `agents.backend.service.structured-output-limit`, five pins red). An engine or\n * application fault object names itself through these keys — `{ kind, reason }`, `{ code, message }` —\n * so its diagnostic survives intact.\n */\nconst IDENTIFYING_FIELDS = ['name', 'code', 'kind', 'type', 'status', 'statusCode', 'reason', 'message'] as const;\n\n/** The longest diagnostic this renders; a longer one is cut and says so. */\nconst NON_ERROR_DESCRIPTION_LIMIT = 400;\n\n/**\n * Render a thrown value that is neither an `Error` nor a {@link WildoError_Backend}.\n *\n * `String(value)` renders EVERY plain object as `'[object Object]'`, so distinct faults become one\n * string. Measured 2026-09-23 (#1273): a playbook failed inside the journey's choreography and the run\n * record persisted `'[object Object]'` as its only diagnostic. So an object is rendered by its\n * {@link IDENTIFYING_FIELDS} with their scalar values, and by the NAMES of its other fields — never\n * their values, which is where the data a fault carries lives (see that constant). A cyclic object\n * needs no serialization this way, and the result is bounded.\n */\nexport function describeNonErrorValue(value: unknown): string {\n  if (typeof value !== 'object' || value === null) return String(value);\n  let keys: string[];\n  try {\n    keys = Object.keys(value);\n  } catch {\n    return String(value);\n  }\n  const record = value as Record<string, unknown>;\n  const identifying = IDENTIFYING_FIELDS.filter((key) => {\n    const field = record[key];\n    return (typeof field === 'string' && field.length > 0) || typeof field === 'number' || typeof field === 'boolean';\n  });\n  const parts = identifying.map((key) => `${key}: ${String(record[key])}`);\n  const otherKeys = keys.filter((key) => !(identifying as readonly string[]).includes(key));\n  if (otherKeys.length > 0) parts.push(`fields: ${otherKeys.join(', ')}`);\n  const description = `{${parts.join('; ')}}`;\n  return description.length > NON_ERROR_DESCRIPTION_LIMIT\n    ? `${description.slice(0, NON_ERROR_DESCRIPTION_LIMIT)}… (truncated)`\n    : description;\n}\n"]}