@wildo-ai/saas-models 1.1.4 → 1.1.6

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

@@ -155,6 +155,7 @@ export declare const ErrorUserGuidanceSchema: z.ZodObject<{
     guidanceKey: z.ZodOptional<z.ZodString>;
     explanation: z.ZodOptional<z.ZodString>;
     resolution: z.ZodOptional<z.ZodString>;
+    params: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>>;
     completedSteps: z.ZodOptional<z.ZodArray<z.ZodString>>;
     nextAction: z.ZodOptional<z.ZodObject<{
         label: z.ZodString;
@@ -197,12 +198,20 @@ export declare const WildoError_BackendSchema: z.ZodObject<{
         consumableTokenId: z.ZodOptional<z.ZodString>;
         webhookProviderId: z.ZodOptional<z.ZodString>;
         anonymousUserId: z.ZodOptional<z.ZodString>;
+        inboundDeliveryId: z.ZodOptional<z.ZodString>;
+        inboundHandlerRef: z.ZodOptional<z.ZodString>;
+        inboundScopeUserId: z.ZodOptional<z.ZodString>;
+        inboundSender: z.ZodOptional<z.ZodObject<{
+            channel: z.ZodEnum<typeof import("..").InboundChannelKind>;
+            assurance: z.ZodEnum<typeof import("..").InboundSenderAssurance>;
+        }, z.core.$strict>>;
     }, z.core.$strip>>>;
     executionType: z.ZodOptional<z.ZodEnum<typeof ExecutionContext_ExecutionType>>;
     userGuidance: z.ZodOptional<z.ZodObject<{
         guidanceKey: z.ZodOptional<z.ZodString>;
         explanation: z.ZodOptional<z.ZodString>;
         resolution: z.ZodOptional<z.ZodString>;
+        params: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>>;
         completedSteps: z.ZodOptional<z.ZodArray<z.ZodString>>;
         nextAction: z.ZodOptional<z.ZodObject<{
             label: z.ZodString;
@@ -218,7 +227,8 @@ export type WildoError_Backend = z.infer<typeof WildoError_BackendSchema>;
  * Type guard for WildoError_Backend — safely identifies engine-thrown errors in catch blocks.
  *
  * Replaces the unsafe `(error as any).type` pattern. Checks for the 4 structural
- * properties that distinguish WildoError_Backend from arbitrary Error objects.
+ * properties that distinguish WildoError_Backend from arbitrary Error objects — the check itself
+ * lives in {@link isWildoBackendErrorShape}, an import-free atom the bundle-safe describers share.
  */
 export declare function isWildoBackendError(error: unknown): error is WildoError_Backend;
 export declare const WildoError_FrontendSchema: z.ZodObject<{
@@ -249,6 +259,7 @@ export declare const WildoError_FrontendSchema: z.ZodObject<{
         guidanceKey: z.ZodOptional<z.ZodString>;
         explanation: z.ZodOptional<z.ZodString>;
         resolution: z.ZodOptional<z.ZodString>;
+        params: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>>;
         completedSteps: z.ZodOptional<z.ZodArray<z.ZodString>>;
         nextAction: z.ZodOptional<z.ZodObject<{
             label: z.ZodString;
@@ -261,18 +272,30 @@ export declare const WildoError_FrontendSchema: z.ZodObject<{
 }, z.core.$strip>;
 export type WildoError_Frontend = z.infer<typeof WildoError_FrontendSchema>;
 /**
- * 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 declare enum FieldValidationIssueCode {
+    /** A value already exists on a field declared `.isUnique()`. Raised at write time and by validate-field. */
+    NOT_UNIQUE = "not_unique"
+}
+/**
+ * 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 declare const ValidationErrorEntry_Schema: z.ZodObject<{
-    key: z.ZodString;
-    message: z.ZodString;
+    code: z.ZodEnum<typeof FieldValidationIssueCode>;
     params: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
 }, z.core.$strip>;
 export type ValidationErrorEntry = z.infer<typeof ValidationErrorEntry_Schema>;
@@ -323,16 +346,23 @@ export declare const ErrorResponseSchema: z.ZodObject<{
             consumableTokenId: z.ZodOptional<z.ZodString>;
             webhookProviderId: z.ZodOptional<z.ZodString>;
             anonymousUserId: z.ZodOptional<z.ZodString>;
+            inboundDeliveryId: z.ZodOptional<z.ZodString>;
+            inboundHandlerRef: z.ZodOptional<z.ZodString>;
+            inboundScopeUserId: z.ZodOptional<z.ZodString>;
+            inboundSender: z.ZodOptional<z.ZodObject<{
+                channel: z.ZodEnum<typeof import("..").InboundChannelKind>;
+                assurance: z.ZodEnum<typeof import("..").InboundSenderAssurance>;
+            }, z.core.$strict>>;
         }, z.core.$strip>>>;
         validationErrors: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
-            key: z.ZodString;
-            message: z.ZodString;
+            code: z.ZodEnum<typeof FieldValidationIssueCode>;
             params: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
         }, z.core.$strip>]>>>;
         userGuidance: z.ZodOptional<z.ZodObject<{
             guidanceKey: z.ZodOptional<z.ZodString>;
             explanation: z.ZodOptional<z.ZodString>;
             resolution: z.ZodOptional<z.ZodString>;
+            params: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>>;
             completedSteps: z.ZodOptional<z.ZodArray<z.ZodString>>;
             nextAction: z.ZodOptional<z.ZodObject<{
                 label: z.ZodString;
@@ -368,8 +398,7 @@ export declare const ValidationErrorResponse_Schema: z.ZodObject<{
     code: z.ZodNumber;
     message: z.ZodString;
     validationErrors: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
-        key: z.ZodString;
-        message: z.ZodString;
+        code: z.ZodEnum<typeof FieldValidationIssueCode>;
         params: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
     }, z.core.$strip>]>>>;
 }, z.core.$strip>;
@@ -400,36 +429,16 @@ export interface ParsedHttpError {
     userGuidance?: ErrorUserGuidance;
 }
 /**
- * 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.
- *
- * Use this as the base resolver. Frontend layers can override by checking
- * for structured entries and resolving via i18n before falling back to this.
+ * Check whether a validation error value is a coded entry rather than a plain message.
  *
- * @param value - A validation error value (string or structured entry)
- * @returns The display string
- */
-export declare function resolveValidationErrorMessage(value: ValidationErrorValue): string;
-/**
- * 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 declare function isValidationErrorEntry(value: ValidationErrorValue): value is ValidationErrorEntry;
-/**
- * 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 declare function resolveValidationErrors(errors: ValidationErrors): Record<string, string>;
 /**
  * Extract validation errors from a raw error response payload.
  *
@@ -461,9 +470,8 @@ export declare const ValidateFieldResponse_Schema: z.ZodObject<{
     valid: z.ZodBoolean;
     error: z.ZodOptional<z.ZodObject<{
         fieldName: z.ZodString;
-        message: z.ZodString;
-        i18nKey: z.ZodOptional<z.ZodString>;
-        i18nParams: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+        code: z.ZodEnum<typeof FieldValidationIssueCode>;
+        params: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
     }, z.core.$strip>>;
 }, z.core.$strip>;
 export type ValidateFieldResponse = z.infer<typeof ValidateFieldResponse_Schema>;

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

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

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

@@ -1,6 +1,7 @@
 import { z } from "zod";
 import { ExecutionContext_ExecutionType, ExecutionContext_InitiatorIdsSchema } from "../runtime/execution-context.shared.schemas.js";
 import { ErrorCustomMessageReference } from "./errors.custom-message-ref.shared.definitions.js";
+import { isWildoBackendErrorShape } from './caught-error-description.shared.utils.js';
 import { NotificationNextStepType } from "../notifications/notifications.shared.schemas.js";
 /**
  * The coarse error category of every backend error. Import from
@@ -176,6 +177,16 @@ export const ErrorUserGuidanceSchema = z.object({
     explanation: z.string().optional(),
     /** How to resolve the issue */
     resolution: z.string().optional(),
+    /**
+     * Values the localized guidance label interpolates (`{name}` placeholders, the one label syntax).
+     *
+     * A localized label outranks the raw `explanation` / `resolution` strings, so without params a label
+     * could only ever say something STATIC — and a refusal whose useful part is dynamic (the companion's
+     * secrets section relaying the CLI's own sentence, #1637) had to choose between a translated label
+     * that hides the reason and an untranslated raw string. Params let the label carry the sentence and the
+     * dynamic part both. Values are shown to the user: never put a secret or an internal identifier here.
+     */
+    params: z.record(z.string(), z.union([z.string(), z.number()])).optional(),
     /** Steps already completed before the error occurred */
     completedSteps: z.array(z.string()).optional(),
     /** Suggested next action (operation or URL) */
@@ -209,15 +220,11 @@ export const WildoError_BackendSchema = WildoErrorSchema.extend({
  * Type guard for WildoError_Backend — safely identifies engine-thrown errors in catch blocks.
  *
  * Replaces the unsafe `(error as any).type` pattern. Checks for the 4 structural
- * properties that distinguish WildoError_Backend from arbitrary Error objects.
+ * properties that distinguish WildoError_Backend from arbitrary Error objects — the check itself
+ * lives in {@link isWildoBackendErrorShape}, an import-free atom the bundle-safe describers share.
  */
 export function isWildoBackendError(error) {
-    return (error !== null &&
-        typeof error === 'object' &&
-        'type' in error &&
-        'statusCode' in error &&
-        'severity' in error &&
-        'customMessageReference' in error);
+    return isWildoBackendErrorShape(error);
 }
 // =====================================================
 // WildoError — Frontend
@@ -272,22 +279,34 @@ 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.
+ *
+ * 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 can be either:
- * - A plain string (legacy format, displayed as-is)
- * - A `ValidationErrorEntry` (structured format with i18n key + fallback message)
+ * 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" }) */
-    params: z.record(z.string(), z.string()).optional(),
+    /** The issue's code; the frontend resolves `errors_validation.<code>.msg`. */
+    code: z.enum(FieldValidationIssueCode).describe("A stable code for the field's problem, to branch on or to look up in your own message catalog. `not_unique`: another record already has this value in a field that must be unique."),
+    /** Interpolation parameters for that catalog message. `NOT_UNIQUE` needs none. */
+    params: z.record(z.string(), z.string()).optional().describe("Values to fill into the message for that code. Absent when the code needs none."),
 });
 export const VersionConflictDetailsSchema = z.object({
     currentVersion: z.number(),
@@ -358,47 +377,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 +446,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":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,8BAA8B,EAAiC,mCAAmC,EAAE,MAAM,6CAA6C,CAAC;AACjK,OAAO,EAAE,2BAA2B,EAAE,MAAM,gDAAgD,CAAC;AAC7F,OAAO,EAAE,wBAAwB,EAAE,MAAM,+CAA+C,CAAC;AAEzF;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,MAAM,CAAN,IAAY,SAqCX;AArCD,WAAY,SAAS;IACrB,4FAA4F;IAE1F,gCAAmB,CAAA;IAEnB,8CAAiC,CAAA;IACjC,4CAA+B,CAAA;IAE/B,sCAAyB,CAAA;IAEzB;;mGAE+F;IAC/F,oDAAuC,CAAA;IAEvC,oCAAuB,CAAA;IACvB,kCAAqB,CAAA;IAErB,sCAAyB,CAAA;IAEzB,kCAAqB,CAAA;IACrB,kCAAqB,CAAA;IACrB,kDAAqC,CAAA;IAErC,gCAAmB,CAAA;IACnB,sDAAyC,CAAA;IACzC,wDAA2C,CAAA;IAE3C,4CAA+B,CAAA;IAC/B,8CAAiC,CAAA;IACjC,4CAA+B,CAAA;IAE/B,wBAAwB;IACxB,4DAA+C,CAAA;IAC/C,8DAAiD,CAAA;IACjD,0DAA6C,CAAA;IAC/C,oDAAoD;AACpD,CAAC,EArCW,SAAS,KAAT,SAAS,QAqCpB;AAED;;GAEG;AAEH,MAAM,CAAN,IAAY,aAOX;AAPD,WAAY,aAAa;IACvB,4BAAW,CAAA;IACX,kCAAiB,CAAA;IACjB,8BAAa,CAAA;IACb,sCAAqB,CAAA;IACrB,gCAAe,CAAA;IACf,wCAAuB,CAAA;AACzB,CAAC,EAPW,aAAa,KAAb,aAAa,QAOxB;AAED;;GAEG;AACH,MAAM,CAAN,IAAY,mBAQX;AARD,WAAY,mBAAmB;IAC7B,wCAAiB,CAAA;IACjB,4CAAqB,CAAA;IACrB,sCAAe,CAAA;IACf,sDAA+B,CAAA;IAC/B,gDAAyB,CAAA;IACzB,gDAAyB,CAAA;IACzB,gDAAyB,CAAA;AAC3B,CAAC,EARW,mBAAmB,KAAnB,mBAAmB,QAQ9B;AAED;;GAEG;AACH,MAAM,CAAN,IAAY,kBAOX;AAPD,WAAY,kBAAkB;IAC5B,iCAAW,CAAA;IACX,qCAAe,CAAA;IACf,uDAAiC,CAAA;IACjC,qCAAe,CAAA;IACf,qDAA+B,CAAA;IAC/B,mEAA6C,CAAA;AAC/C,CAAC,EAPW,kBAAkB,KAAlB,kBAAkB,QAO7B;AAED,MAAM,CAAN,IAAY,6BAQX;AARD,WAAY,6BAA6B;IACvC,gDAAe,CAAA;IACf,8CAAa,CAAA;IACb,8DAA6B,CAAA;IAC7B,2BAA2B;IAC3B,iCAAiC;IACjC,6BAA6B;AAE/B,CAAC,EARW,6BAA6B,KAA7B,6BAA6B,QAQxC;AAED,MAAM,CAAN,IAAY,sBAKX;AALD,WAAY,sBAAsB;IAChC,uCAAa,CAAA;IACb,uCAAa,CAAA;IACb,yCAAe,CAAA;IACf,+CAAqB,CAAA;AACvB,CAAC,EALW,sBAAsB,KAAtB,sBAAsB,QAKjC;AAED,MAAM,CAAN,IAAY,uBAIX;AAJD,WAAY,uBAAuB;IACjC,0CAAe,CAAA;IACf,sDAA2B,CAAA;IAC3B,4CAAiB,CAAA;AACnB,CAAC,EAJW,uBAAuB,KAAvB,uBAAuB,QAIlC;AAsCD,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,CAAC,MAAM,CAAC;IACvC,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC;IACvB,QAAQ,EAAE,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC;IAC/B,gBAAgB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACvC,SAAS,EAAE,CAAC,CAAC,IAAI,EAAE;IAEnB;;;;;;;;;;;;;;;;OAgBG;IACH,OAAO,EAAE,CAAC,CAAC,MAAM,CAAC;QAChB,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;KAC/B,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC,QAAQ,EAAE;IAC/B,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAEhC,8BAA8B;IAC9B,qBAAqB,EAAE,CAAC,CAAC,IAAI,CAAC,sBAAsB,CAAC,CAAC,QAAQ,EAAE;IAChE,WAAW,EAAE,CAAC,CAAC,IAAI,CAAC,uBAAuB,CAAC,CAAC,QAAQ,EAAE;IACvD,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACjC,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACnC,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAChC,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACjC,aAAa,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,QAAQ,EAAE;CACnC,CAAC,CAAC;AAIH,wDAAwD;AACxD,qEAAqE;AACrE,wDAAwD;AAExD;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC9C;;;;OAIG;IACH,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAClC,oDAAoD;IACpD,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAClC,+BAA+B;IAC/B,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACjC,wDAAwD;IACxD,cAAc,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;IAC9C,+CAA+C;IAC/C,UAAU,EAAE,CAAC,CAAC,MAAM,CAAC;QACnB,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE;QACjB,4BAA4B;QAC5B,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE;QACf,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,wBAAwB,CAAC,CAAC,OAAO,CAAC,wBAAwB,CAAC,SAAS,CAAC;KACnF,CAAC,CAAC,QAAQ,EAAE;IACb,wDAAwD;IACxD,iBAAiB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACxC,wEAAwE;IACxE,oBAAoB,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;CACrD,CAAC,CAAC;AAIH,wDAAwD;AACxD,mEAAmE;AACnE,wDAAwD;AAExD,MAAM,CAAC,MAAM,wBAAwB,GAAG,gBAAgB,CAAC,MAAM,CAAC;IAC9D,cAAc,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC;IACnD,sBAAsB,EAAE,CAAC,CAAC,IAAI,CAAC,2BAA2B,CAAC;IAC3D,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE;IACtB,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC5B,2PAA2P;IAC3P,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACpC,YAAY,EAAE,mCAAmC,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;IACvE,aAAa,EAAE,CAAC,CAAC,IAAI,CAAC,8BAA8B,CAAC,CAAC,QAAQ,EAAE;IAChE,+DAA+D;IAC/D,YAAY,EAAE,uBAAuB,CAAC,QAAQ,EAAE;CACjD,CAAC,CAAC;AAIH;;;;;GAKG;AACH,MAAM,UAAU,mBAAmB,CAAC,KAAc;IAChD,OAAO,CACL,KAAK,KAAK,IAAI;QACd,OAAO,KAAK,KAAK,QAAQ;QACzB,MAAM,IAAI,KAAK;QACf,YAAY,IAAI,KAAK;QACrB,UAAU,IAAI,KAAK;QACnB,wBAAwB,IAAI,KAAK,CAClC,CAAC;AACJ,CAAC;AAED,wDAAwD;AACxD,wBAAwB;AACxB,wDAAwD;AAExD,MAAM,CAAC,MAAM,yBAAyB,GAAG,gBAAgB,CAAC,MAAM,CAAC;IAC/D,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC7B,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACrC,sBAAsB,EAAE,CAAC,CAAC,IAAI,CAAC,2BAA2B,CAAC;IAC3D,eAAe,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAC;IACrD,cAAc,EAAE,CAAC,CAAC,IAAI,CAAC,6BAA6B,CAAC,CAAC,QAAQ,EAAE;IAEhE,UAAU,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;IAElC;;;;;;;;;;;OAWG;IACH,mBAAmB,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;IAE3C;;;;;;;;;;;;;;;;;;;;;OAqBG;IACH,aAAa,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;IAErC,wDAAwD;IACxD,YAAY,EAAE,uBAAuB,CAAC,QAAQ,EAAE;CACjD,CAAC,CAAC;AAKH,gFAAgF;AAChF,8DAA8D;AAC9D,gFAAgF;AAEhF;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,2BAA2B,GAAG,CAAC,CAAC,MAAM,CAAC;IAClD,gEAAgE;IAChE,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE;IACf,2EAA2E;IAC3E,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;IACnB,+GAA+G;IAC/G,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;CACpD,CAAC,CAAC;AAIH,MAAM,CAAC,MAAM,4BAA4B,GAAG,CAAC,CAAC,MAAM,CAAC;IACnD,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE;IAC1B,eAAe,EAAE,CAAC,CAAC,MAAM,EAAE;IAC3B,iBAAiB,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;IACtC,aAAa,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC;IAChD,eAAe,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC;CACnD,CAAC,CAAC;AAIH;;;GAGG;AAEH;;;GAGG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC1C,KAAK,EAAE,CAAC,CAAC,MAAM,CAAC;QACd,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC;QACvB,QAAQ,EAAE,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC;QAC/B,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;QACnB,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE;QACzB,sBAAsB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;QAC7C,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;QAC3B,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;QACpC;;;;;WAKG;QACH,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;QACpC,OAAO,EAAE,CAAC,CAAC,MAAM,CAAC;YAChB,eAAe,EAAE,4BAA4B,CAAC,QAAQ,EAAE;SACzD,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC,QAAQ,EAAE;QAC/B,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;QACrB,YAAY,EAAE,mCAAmC,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;QACvE,iGAAiG;QACjG,gBAAgB,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,2BAA2B,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;QACrG,+DAA+D;QAC/D,YAAY,EAAE,uBAAuB,CAAC,QAAQ,EAAE;KACjD,CAAC;CACH,CAAC,CAAC;AAiBH,gFAAgF;AAChF,mCAAmC;AACnC,gFAAgF;AAEhF;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,8BAA8B,GAAG,CAAC,CAAC,MAAM,CAAC;IACrD,uEAAuE;IACvE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;IAChB,4BAA4B;IAC5B,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;IACnB;;;;OAIG;IACH,gBAAgB,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,2BAA2B,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;CACtG,CAAC,CAAC;AAkCH,gFAAgF;AAChF,wCAAwC;AACxC,gFAAgF;AAEhF;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,6BAA6B,CAAC,KAA2B;IACvE,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IAC5C,OAAO,KAAK,CAAC,OAAO,CAAC;AACvB,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,sBAAsB,CAAC,KAA2B;IAChE,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,IAAI,KAAK,IAAI,SAAS,IAAI,KAAK,CAAC;AAC7F,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,uBAAuB,CAAC,MAAwB;IAC9D,MAAM,QAAQ,GAA2B,EAAE,CAAC;IAC5C,KAAK,MAAM,CAAC,KAAK,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;QACpD,QAAQ,CAAC,KAAK,CAAC,GAAG,6BAA6B,CAAC,KAAK,CAAC,CAAC;IACzD,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,uBAAuB,CAAC,OAAgB;IACtD,IAAI,CAAC,OAAO,IAAI,OAAO,OAAO,KAAK,QAAQ;QAAE,OAAO,SAAS,CAAC;IAE9D,MAAM,GAAG,GAAG,OAAkC,CAAC;IAE/C,iEAAiE;IACjE,IAAI,GAAG,CAAC,KAAK,IAAI,OAAO,GAAG,CAAC,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC/C,MAAM,MAAM,GAAG,GAAG,CAAC,KAAgC,CAAC;QACpD,IAAI,MAAM,CAAC,gBAAgB,IAAI,OAAO,MAAM,CAAC,gBAAgB,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,gBAAgB,CAAC,EAAE,CAAC;YACtH,MAAM,EAAE,GAAG,MAAM,CAAC,gBAA2C,CAAC;YAC9D,IAAI,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBAC/B,OAAO,EAAsB,CAAC;YAChC,CAAC;QACH,CAAC;IACH,CAAC;IAED,2CAA2C;IAC3C,IAAI,GAAG,CAAC,gBAAgB,IAAI,OAAO,GAAG,CAAC,gBAAgB,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAC,EAAE,CAAC;QAC7G,MAAM,EAAE,GAAG,GAAG,CAAC,gBAA2C,CAAC;QAC3D,IAAI,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC/B,OAAO,EAAsB,CAAC;QAChC,CAAC;IACH,CAAC;IAED,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,gFAAgF;AAChF,8CAA8C;AAC9C,gFAAgF;AAEhF;;;;;GAKG;AACH,MAAM,CAAC,MAAM,2BAA2B,GAAG,CAAC,CAAC,MAAM,CAAC;IAClD,yEAAyE;IACzE,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;IACrB,4BAA4B;IAC5B,KAAK,EAAE,CAAC,CAAC,OAAO,EAAE;IAClB,6FAA6F;IAC7F,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CACjC,CAAC,CAAC;AAIH;;GAEG;AACH,MAAM,CAAC,MAAM,4BAA4B,GAAG,CAAC,CAAC,MAAM,CAAC;IACnD,uCAAuC;IACvC,KAAK,EAAE,CAAC,CAAC,OAAO,EAAE;IAClB,wCAAwC;IACxC,KAAK,EAAE,CAAC,CAAC,MAAM,CAAC;QACd,wCAAwC;QACxC,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;QACrB,yCAAyC;QACzC,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;QACnB,6BAA6B;QAC7B,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;QAC9B,oCAAoC;QACpC,UAAU,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;KACxD,CAAC,CAAC,QAAQ,EAAE;CACd,CAAC,CAAC","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 { isWildoBackendErrorShape } from './caught-error-description.shared.utils';\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  /**\n   * Values the localized guidance label interpolates (`{name}` placeholders, the one label syntax).\n   *\n   * A localized label outranks the raw `explanation` / `resolution` strings, so without params a label\n   * could only ever say something STATIC — and a refusal whose useful part is dynamic (the companion's\n   * secrets section relaying the CLI's own sentence, #1637) had to choose between a translated label\n   * that hides the reason and an untranslated raw string. Params let the label carry the sentence and the\n   * dynamic part both. Values are shown to the user: never put a secret or an internal identifier here.\n   */\n  params: z.record(z.string(), z.union([z.string(), z.number()])).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 — the check itself\n * lives in {@link isWildoBackendErrorShape}, an import-free atom the bundle-safe describers share.\n */\nexport function isWildoBackendError(error: unknown): error is WildoError_Backend {\n  return isWildoBackendErrorShape(error);\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).describe(\"A stable code for the field's problem, to branch on or to look up in your own message catalog. `not_unique`: another record already has this value in a field that must be unique.\"),\n  /** Interpolation parameters for that catalog message. `NOT_UNIQUE` needs none. */\n  params: z.record(z.string(), z.string()).optional().describe(\"Values to fill into the message for that code. Absent when the code needs none.\"),\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.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,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"}

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

@@ -0,0 +1,26 @@
+/**
+ * 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`: 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`
+ * (in the import-free `caught-error-description.shared.utils`, #1591 — also on that seam) delegates to
+ * it for every value that is not a `WildoError_Backend`, so there is one implementation of the rendering.
+ *
+ * Prefer `describeCaughtError`, which is equally light: 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;;;;;;;;;;;;GAYG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAE1D;AAmBD;;;;;;;;;GASG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAoB5D"}