npm - @wildo-ai/saas-models - Versions diffs - 1.1.5 → 1.1.6 - Mend

@wildo-ai/saas-models 1.1.5 → 1.1.6

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (888) hide show

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

@@ -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
@@ -297,9 +304,9 @@ export var FieldValidationIssueCode;
  */
 export const ValidationErrorEntry_Schema = z.object({
     /** The issue's code; the frontend resolves `errors_validation.<code>.msg`. */
-    code: z.enum(FieldValidationIssueCode),
+    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(),
+    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(),

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

	@@ -1 +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 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"]}
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 { 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 CHANGED Viewed

@@ -12,28 +12,4 @@ 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 CHANGED Viewed

	@@ -1 +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,~~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~~"}
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"}

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

@@ -1,7 +1,5 @@
-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.
@@ -22,41 +20,4 @@ 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 CHANGED Viewed

	@@ -1 +1 @@
1	- {"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"]}
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"]}

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

@@ -3,14 +3,13 @@
  * 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.
+ * 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.
  *
- * 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.
+ * 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;
 /**

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

	@@ -1 +1 @@
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"}
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"}

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

@@ -3,14 +3,13 @@
  * 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.
+ * 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.
  *
- * 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.
+ * 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 function describeThrownValue(error) {
     return error instanceof Error ? error.message : describeNonErrorValue(error);

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

	@@ -1 +1 @@
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"]}
1	+ {"version":3,"file":"thrown-value-description.shared.utils.js","sourceRoot":"","sources":["../../../../src/errors/thrown-value-description.shared.utils.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;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`: a bundle-isolated package (`saas-website`) may reach this package only\n * through `@wildo-ai/saas-models/public-runtime`. It is re-exported there, and `describeCaughtError`\n * (in the import-free `caught-error-description.shared.utils`, #1591 — also on that seam) delegates to\n * it for every value that is not a `WildoError_Backend`, so there is one implementation of the rendering.\n \n Prefer `describeCaughtError`, which is equally light: a value that IS a `WildoError_Backend` reads here\n * 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"]}

package/dist/esm/external-data/external-data-pipeline-description.shared.d.ts ADDED Viewed

@@ -0,0 +1,70 @@
+/**
+ * A pipeline declaration, described for a READER (#1685) — the structured `externalDataPipeline` slice a resource
+ * specification carries.
+ *
+ * ## Why it is derived, never authored
+ *
+ * Before this, a resource's specification described its pipeline in prose (Wonder Todos' `externalCustomers` did, in
+ * `notes` and `businessConstraints`), and prose restating a declaration is a second copy that starts drifting the day
+ * the declaration changes. So the slice is a FUNCTION of the declaration: `resourceSpecification()` attaches it when
+ * it can materialize the resource configuration, and the companion's specification projection derives it from the
+ * configuration it already holds. Nothing here is typed by an author, so nothing here can disagree with what runs.
+ *
+ * ## What it answers
+ *
+ * Where the rows come from (system, entity, dialect), which rows (the source filter, archived rows), how they are
+ * keyed, when a pass runs, what happens to a row that leaves the source — and, per local field, WHAT writes it: the
+ * remote fields it reads and the declared operation, including the four expressions (enum mapping, concatenation,
+ * arithmetic, conditional). `expression` is a one-line rendering of that operation for a person reviewing the
+ * specification; `entry` is the declared data itself, for a reader that needs the exact values.
+ */
+import { ExternalDataMappingEntryKind, ExternalDataPipelineDirection, type ExternalDataFieldMappingEntry, type ExternalDataPipelineDeclaration } from './external-data-pipeline.shared.schemas';
+/** One local field the pipeline writes, and how. */
+export interface ExternalDataPipelineMappingDescription {
+    readonly localField: string;
+    readonly kind: ExternalDataMappingEntryKind;
+    /** Every remote field this entry reads — what the extraction requests for it. Empty for a CONSTANT. */
+    readonly readsRemoteFields: readonly string[];
+    /** The declared operation in one line, for a reviewer. */
+    readonly expression: string;
+    /** The declared entry, exactly as the pipeline runs it. */
+    readonly entry: ExternalDataFieldMappingEntry;
+}
+/** The structured pipeline slice of a resource specification. */
+export interface ExternalDataPipelineDescription {
+    /**
+     * Which way rows travel (#1690). For an OUTBOUND pipeline `source` names where rows are SENT, each mapping entry names
+     * the local field sent and the remote field it lands on, and the inbound-only facts (`population`, `orphanPolicy`,
+     * `sourceFilter`, `archivedRecords`, `incremental`) describe nothing and are null.
+     */
+    readonly direction: ExternalDataPipelineDirection;
+    readonly source: {
+        readonly system: string;
+        readonly entityRef: string;
+        readonly dialect: string;
+    };
+    /** For an OUTBOUND or BIDIRECTIONAL pipeline, the write verbs it sends (`create`, `update`); empty for an inbound one. */
+    readonly sends: readonly string[];
+    /** A BIDIRECTIONAL pipeline's conflict policy (#1723), resolved; null for any other direction. */
+    readonly conflictPolicy: string | null;
+    /** The local field holding each row's remote identity, the key the load merges on. */
+    readonly remoteKeyLocalField: string;
+    readonly sourceFilter: Readonly<Record<string, unknown>> | null;
+    readonly population: string | null;
+    readonly orphanPolicy: string | null;
+    readonly archivedRecords: string | null;
+    readonly scheduleCron: string | null;
+    readonly incremental: {
+        readonly mode: string;
+        readonly fullPassCron: string;
+    } | null;
+    /** The partition stamps; an OUTBOUND pipeline has only the unit a created row is placed by (`key` null). */
+    readonly partitionFields: {
+        readonly unit: string;
+        readonly key: string | null;
+    } | null;
+    readonly mapping: readonly ExternalDataPipelineMappingDescription[];
+}
+/** Describe a PARSED pipeline declaration for a resource specification (#1685). */
+export declare function describeExternalDataPipeline(declaration: ExternalDataPipelineDeclaration): ExternalDataPipelineDescription;
+//# sourceMappingURL=external-data-pipeline-description.shared.d.ts.map

package/dist/esm/external-data/external-data-pipeline-description.shared.d.ts.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"external-data-pipeline-description.shared.d.ts","sourceRoot":"","sources":["../../../../src/external-data/external-data-pipeline-description.shared.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AACH,OAAO,EAIL,4BAA4B,EAC5B,6BAA6B,EAM7B,KAAK,6BAA6B,EAClC,KAAK,+BAA+B,EACrC,MAAM,yCAAyC,CAAC;AAEjD,oDAAoD;AACpD,MAAM,WAAW,sCAAsC;IACrD,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,IAAI,EAAE,4BAA4B,CAAC;IAC5C,uGAAuG;IACvG,QAAQ,CAAC,iBAAiB,EAAE,SAAS,MAAM,EAAE,CAAC;IAC9C,0DAA0D;IAC1D,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,2DAA2D;IAC3D,QAAQ,CAAC,KAAK,EAAE,6BAA6B,CAAC;CAC/C;AAED,iEAAiE;AACjE,MAAM,WAAW,+BAA+B;IAC9C;;;;OAIG;IACH,QAAQ,CAAC,SAAS,EAAE,6BAA6B,CAAC;IAClD,QAAQ,CAAC,MAAM,EAAE;QAAE,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IACnG,0HAA0H;IAC1H,QAAQ,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;IAClC,kGAAkG;IAClG,QAAQ,CAAC,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IACvC,sFAAsF;IACtF,QAAQ,CAAC,mBAAmB,EAAE,MAAM,CAAC;IACrC,QAAQ,CAAC,YAAY,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC;IAChE,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IACnC,QAAQ,CAAC,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IACrC,QAAQ,CAAC,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IACxC,QAAQ,CAAC,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IACrC,QAAQ,CAAC,WAAW,EAAE;QAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;IACtF,4GAA4G;IAC5G,QAAQ,CAAC,eAAe,EAAE;QAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,GAAG,IAAI,CAAC;IACxF,QAAQ,CAAC,OAAO,EAAE,SAAS,sCAAsC,EAAE,CAAC;CACrE;AA6CD,mFAAmF;AACnF,wBAAgB,4BAA4B,CAAC,WAAW,EAAE,+BAA+B,GAAG,+BAA+B,CA4B1H"}

package/dist/esm/external-data/external-data-pipeline-description.shared.js ADDED Viewed

@@ -0,0 +1,92 @@
+/**
+ * A pipeline declaration, described for a READER (#1685) — the structured `externalDataPipeline` slice a resource
+ * specification carries.
+ *
+ * ## Why it is derived, never authored
+ *
+ * Before this, a resource's specification described its pipeline in prose (Wonder Todos' `externalCustomers` did, in
+ * `notes` and `businessConstraints`), and prose restating a declaration is a second copy that starts drifting the day
+ * the declaration changes. So the slice is a FUNCTION of the declaration: `resourceSpecification()` attaches it when
+ * it can materialize the resource configuration, and the companion's specification projection derives it from the
+ * configuration it already holds. Nothing here is typed by an author, so nothing here can disagree with what runs.
+ *
+ * ## What it answers
+ *
+ * Where the rows come from (system, entity, dialect), which rows (the source filter, archived rows), how they are
+ * keyed, when a pass runs, what happens to a row that leaves the source — and, per local field, WHAT writes it: the
+ * remote fields it reads and the declared operation, including the four expressions (enum mapping, concatenation,
+ * arithmetic, conditional). `expression` is a one-line rendering of that operation for a person reviewing the
+ * specification; `entry` is the declared data itself, for a reader that needs the exact values.
+ */
+import { ExternalDataConcatenationPartKind, ExternalDataConditionalOutcomeKind, ExternalDataFieldCoercion, ExternalDataMappingEntryKind, ExternalDataPipelineDirection, ExternalDataUnmappedValuePolicy, listExternalDataMappingEntryRemoteFields, resolveExternalDataConflictPolicy, resolveExternalDataFieldOwner, } from './external-data-pipeline.shared.schemas.js';
+const quoted = (value) => JSON.stringify(value);
+function describeOutcome(outcome) {
+    return outcome.kind === ExternalDataConditionalOutcomeKind.CONSTANT ? quoted(outcome.constant) : `\`${outcome.remoteField}\``;
+}
+/** The one-line rendering of one entry's operation. Total over the entry kinds. */
+function describeMappingExpression(entry) {
+    switch (entry.kind) {
+        case ExternalDataMappingEntryKind.REMOTE_FIELD:
+            return `\`${entry.remoteField}\``
+                + (entry.coercion === ExternalDataFieldCoercion.NONE ? '' : ` (${entry.coercion})`)
+                + (entry.required ? ', required' : '');
+        case ExternalDataMappingEntryKind.CONSTANT:
+            return `constant ${quoted(entry.constant)}`;
+        case ExternalDataMappingEntryKind.REMOTE_REFERENCE:
+            return `foreign key to ${entry.targetResourceType} from \`${entry.remoteField}\``
+                + (entry.valueShape === undefined ? '' : ` (${entry.valueShape})`) + `, unresolved: ${entry.unresolved}`;
+        case ExternalDataMappingEntryKind.ENUM_MAP:
+            return `\`${entry.remoteField}\` mapped: `
+                + entry.values.map(({ remoteValue, localValue }) => `${quoted(remoteValue)} → ${quoted(localValue)}`).join(', ')
+                + `; unmapped: ${entry.unmapped.policy === ExternalDataUnmappedValuePolicy.USE_DEFAULT ? quoted(entry.unmapped.localValue) : 'reject the row'}`
+                + (entry.required ? ', required' : '');
+        case ExternalDataMappingEntryKind.CONCATENATION:
+            return 'concatenation of '
+                + entry.parts.map((part) => (part.kind === ExternalDataConcatenationPartKind.REMOTE_FIELD ? `\`${part.remoteField}\`` : quoted(part.literal))).join(', ')
+                + (entry.separator === '' ? '' : ` joined by ${quoted(entry.separator)}`)
+                + (entry.required ? ', required' : '');
+        case ExternalDataMappingEntryKind.ARITHMETIC:
+            return `\`${entry.remoteField}\` × ${entry.factor}${entry.offset === 0 ? '' : ` + ${entry.offset}`}`
+                + (entry.decimalPlaces === undefined ? '' : `, rounded to ${entry.decimalPlaces} decimal places`)
+                + (entry.required ? ', required' : '');
+        case ExternalDataMappingEntryKind.CONDITIONAL:
+            return `by \`${entry.remoteField}\`: `
+                + entry.cases.map((entryCase) => `${quoted(entryCase.equals)} → ${describeOutcome(entryCase.then)}`).join('; ')
+                + `; otherwise ${describeOutcome(entry.otherwise)}`;
+        default: {
+            const unhandled = entry;
+            throw new Error(`describeExternalDataPipeline: unhandled mapping entry ${quoted(unhandled)}`);
+        }
+    }
+}
+/** Describe a PARSED pipeline declaration for a resource specification (#1685). */
+export function describeExternalDataPipeline(declaration) {
+    const outbound = declaration.direction === ExternalDataPipelineDirection.OUTBOUND;
+    const bidirectional = declaration.direction === ExternalDataPipelineDirection.BIDIRECTIONAL;
+    return {
+        direction: declaration.direction,
+        source: { system: declaration.binding.system, entityRef: declaration.binding.entityRef, dialect: declaration.binding.dialect },
+        sends: outbound || bidirectional ? [...declaration.binding.writableVerbs].sort() : [],
+        conflictPolicy: bidirectional ? resolveExternalDataConflictPolicy(declaration) : null,
+        remoteKeyLocalField: declaration.remoteKeyLocalField,
+        sourceFilter: declaration.sourceFilter ?? null,
+        // Parsed defaults on an OUTBOUND declaration, which refuses them when authored: describing them would state a load
+        // policy for a pipeline that loads nothing.
+        population: outbound ? null : declaration.population,
+        orphanPolicy: outbound ? null : declaration.orphanPolicy,
+        archivedRecords: declaration.archivedRecords?.treatment ?? null,
+        scheduleCron: declaration.scheduleCron ?? null,
+        incremental: declaration.incremental === undefined ? null : { mode: declaration.incremental.mode, fullPassCron: declaration.incremental.fullPassCron },
+        partitionFields: declaration.partitionUnitLocalField === undefined
+            ? null
+            : { unit: declaration.partitionUnitLocalField, key: declaration.partitionKeyLocalField ?? null },
+        mapping: declaration.mapping.map((entry) => ({
+            localField: entry.localField,
+            kind: entry.kind,
+            readsRemoteFields: listExternalDataMappingEntryRemoteFields(entry),
+            expression: describeMappingExpression(entry) + (bidirectional ? ` — owner ${resolveExternalDataFieldOwner(entry)}` : ''),
+            entry,
+        })),
+    };
+}
+//# sourceMappingURL=external-data-pipeline-description.shared.js.map