@wildo-ai/saas-models 1.0.1

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

@@ -0,0 +1,375 @@
+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 { NotificationNextStepType } from "../notifications/notifications.shared.schemas.js";
+export var ErrorType;
+(function (ErrorType) {
+    ErrorType["NETWORK"] = "NETWORK";
+    ErrorType["AUTHENTICATION"] = "AUTHENTICATION";
+    ErrorType["AUTHORIZATION"] = "AUTHORIZATION";
+    ErrorType["VALIDATION"] = "VALIDATION";
+    ErrorType["NOT_FOUND"] = "NOT_FOUND";
+    ErrorType["CONFLICT"] = "CONFLICT";
+    ErrorType["RATE_LIMIT"] = "RATE_LIMIT";
+    ErrorType["INTERNAL"] = "INTERNAL";
+    ErrorType["DATABASE"] = "DATABASE";
+    ErrorType["EXTERNAL_SERVICE"] = "EXTERNAL_SERVICE";
+    ErrorType["UNKNOWN"] = "UNKNOWN";
+    ErrorType["UNCAUGHT_EXCEPTION"] = "UNCAUGHT_EXCEPTION";
+    ErrorType["UNHANDLED_REJECTION"] = "UNHANDLED_REJECTION";
+    ErrorType["BUSINESS_RULE"] = "BUSINESS_RULE";
+    ErrorType["INFRASTRUCTURE"] = "INFRASTRUCTURE";
+    ErrorType["CONFIGURATION"] = "CONFIGURATION";
+    // Feature gating errors
+    ErrorType["FEATURE_NOT_AVAILABLE"] = "FEATURE_NOT_AVAILABLE";
+    ErrorType["FEATURE_LIMIT_EXCEEDED"] = "FEATURE_LIMIT_EXCEEDED";
+    ErrorType["INSUFFICIENT_CREDITS"] = "INSUFFICIENT_CREDITS";
+})(ErrorType || (ErrorType = {}));
+/**
+ * Error severity levels
+ */
+export var ErrorSeverity;
+(function (ErrorSeverity) {
+    ErrorSeverity["LOW"] = "low";
+    ErrorSeverity["MEDIUM"] = "medium";
+    ErrorSeverity["HIGH"] = "high";
+    ErrorSeverity["CRITICAL"] = "critical";
+    ErrorSeverity["ALERT"] = "alert";
+    ErrorSeverity["EMERGENCY"] = "emergency";
+})(ErrorSeverity || (ErrorSeverity = {}));
+/**
+ * Frontend-specific error actions
+ */
+export var ErrorActionFrontend;
+(function (ErrorActionFrontend) {
+    ErrorActionFrontend["NOTIFY"] = "NOTIFY";
+    ErrorActionFrontend["REDIRECT"] = "REDIRECT";
+    ErrorActionFrontend["RETRY"] = "RETRY";
+    ErrorActionFrontend["REFRESH_TOKEN"] = "REFRESH_TOKEN";
+    ErrorActionFrontend["DISCONNECT"] = "DISCONNECT";
+    ErrorActionFrontend["SHOW_MODAL"] = "SHOW_MODAL";
+    ErrorActionFrontend["SHOW_TOAST"] = "SHOW_TOAST";
+})(ErrorActionFrontend || (ErrorActionFrontend = {}));
+/**
+ * Backend-specific error actions
+ */
+export var ErrorActionBackend;
+(function (ErrorActionBackend) {
+    ErrorActionBackend["LOG"] = "LOG";
+    ErrorActionBackend["ALERT"] = "ALERT";
+    ErrorActionBackend["RECORD_METRICS"] = "RECORD_METRICS";
+    ErrorActionBackend["TRACE"] = "TRACE";
+    ErrorActionBackend["CIRCUIT_BREAK"] = "CIRCUIT_BREAK";
+    ErrorActionBackend["GRACEFUL_DEGRADATION"] = "GRACEFUL_DEGRADATION";
+})(ErrorActionBackend || (ErrorActionBackend = {}));
+export var Error_Frontend_RedirectPolicy;
+(function (Error_Frontend_RedirectPolicy) {
+    Error_Frontend_RedirectPolicy["LOGIN"] = "login";
+    Error_Frontend_RedirectPolicy["HOME"] = "home";
+    Error_Frontend_RedirectPolicy["HISTORY_BACK"] = "history_back";
+    // NOT_FOUND = 'not_found',
+    // UNAUTHORIZED = 'unauthorized',
+    // ERROR_PAGE = 'error_page',
+})(Error_Frontend_RedirectPolicy || (Error_Frontend_RedirectPolicy = {}));
+export var ErrorHandling_Strategy;
+(function (ErrorHandling_Strategy) {
+    ErrorHandling_Strategy["STOP"] = "stop";
+    ErrorHandling_Strategy["SKIP"] = "skip";
+    ErrorHandling_Strategy["RETRY"] = "retry";
+    ErrorHandling_Strategy["FALLBACK"] = "fallback";
+})(ErrorHandling_Strategy || (ErrorHandling_Strategy = {}));
+export var RetryPolicy_BackoffType;
+(function (RetryPolicy_BackoffType) {
+    RetryPolicy_BackoffType["FIXED"] = "fixed";
+    RetryPolicy_BackoffType["EXPONENTIAL"] = "exponential";
+    RetryPolicy_BackoffType["LINEAR"] = "linear";
+})(RetryPolicy_BackoffType || (RetryPolicy_BackoffType = {}));
+export const WildoErrorSchema = z.object({
+    type: z.enum(ErrorType),
+    severity: z.enum(ErrorSeverity),
+    operationPathKey: z.string().optional(),
+    timestamp: z.date(),
+    context: z.record(z.string(), z.any()).optional(),
+    ipAddress: z.string().optional(),
+    // Resilience and retry policy
+    errorHandlingStrategy: z.enum(ErrorHandling_Strategy).optional(),
+    retryPolicy: z.enum(RetryPolicy_BackoffType).optional(),
+    maxRetries: z.number().optional(),
+    initialDelay: z.number().optional(),
+    baseDelay: z.number().optional(),
+    retryCount: z.number().optional(),
+    lastRetryTime: z.date().optional(),
+});
+// =====================================================
+// Error User Guidance — contextual error resolution hints (Phase 1b)
+// =====================================================
+/**
+ * Structured guidance attached to backend errors.
+ * Tells the frontend what went wrong, how to fix it, and what to do next.
+ *
+ * Populated by `ErrorBuilderBackendService.buildErrorWithGuidance()` for
+ * error types like CONFIGURATION, FEATURE_NOT_AVAILABLE, RATE_LIMIT, etc.
+ *
+ * NOTE: Defined before WildoError_BackendSchema because it's referenced there.
+ */
+export const ErrorUserGuidanceSchema = z.object({
+    /**
+     * i18n lookup key for this guidance block.
+     * Resolves labels under `errors_guidance.{guidanceKey}.{field}`.
+     * If not set, falls back to the error's `customMessageReference`.
+     */
+    guidanceKey: z.string().optional(),
+    /** Human-readable explanation of what went wrong */
+    explanation: z.string().optional(),
+    /** How to resolve the issue */
+    resolution: z.string().optional(),
+    /** Steps already completed before the error occurred */
+    completedSteps: z.array(z.string()).optional(),
+    /** Suggested next action (operation or URL) */
+    nextAction: z.object({
+        label: z.string(),
+        /** Operation path or URL */
+        ref: z.string(),
+        type: z.enum(NotificationNextStepType).default(NotificationNextStepType.OPERATION),
+    }).optional(),
+    /** For rate limits: seconds until retry is available */
+    retryAfterSeconds: z.number().optional(),
+    /** For configuration errors: what configuration elements are missing */
+    missingConfiguration: z.array(z.string()).optional(),
+});
+// =====================================================
+// WildoError — Backend (extends base with backend-specific fields)
+// =====================================================
+export const WildoError_BackendSchema = WildoErrorSchema.extend({
+    backendActions: z.array(z.enum(ErrorActionBackend)),
+    customMessageReference: z.enum(ErrorCustomMessageReference),
+    statusCode: z.number(),
+    stack: z.string().optional(),
+    requestUUID: z.string().optional(),
+    initiatorIds: ExecutionContext_InitiatorIdsSchema.optional().nullable(),
+    executionType: z.enum(ExecutionContext_ExecutionType).optional(),
+    /** Contextual user guidance for error resolution (Phase 1b) */
+    userGuidance: ErrorUserGuidanceSchema.optional(),
+});
+/**
+ * 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.
+ */
+export function isWildoBackendError(error) {
+    return (error !== null &&
+        typeof error === 'object' &&
+        'type' in error &&
+        'statusCode' in error &&
+        'severity' in error &&
+        'customMessageReference' in error);
+}
+// =====================================================
+// WildoError — Frontend
+// =====================================================
+export const WildoError_FrontendSchema = WildoErrorSchema.extend({
+    userId: z.string().optional(),
+    organizationId: z.string().optional(),
+    customMessageReference: z.enum(ErrorCustomMessageReference),
+    frontendActions: z.array(z.enum(ErrorActionFrontend)),
+    redirectPolicy: z.enum(Error_Frontend_RedirectPolicy).optional(),
+    showToUser: z.boolean().optional(),
+    /** Contextual error guidance from backend (Phase 1b) */
+    userGuidance: ErrorUserGuidanceSchema.optional(),
+});
+// =============================================================================
+// VALIDATION ERROR ENTRY — STRUCTURED i18n-READY ERROR FORMAT
+// =============================================================================
+/**
+ * Structured validation error entry with i18n support.
+ *
+ * Validation errors can be either:
+ * - A plain string (legacy format, displayed as-is)
+ * - A `ValidationErrorEntry` (structured format with i18n key + fallback message)
+ *
+ * The structured format allows the frontend to translate error messages
+ * while maintaining backward compatibility with plain strings.
+ */
+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(),
+});
+export const VersionConflictDetailsSchema = z.object({
+    currentVersion: z.number(),
+    expectedVersion: z.number(),
+    conflictingFields: z.array(z.string()),
+    currentValues: z.record(z.string(), z.unknown()),
+    submittedValues: z.record(z.string(), z.unknown()),
+});
+/**
+ * SaaS Error Type Definition
+ * Replaces the previous WildoError class
+ */
+/**
+ * Error Response Schema
+ * Updated to include operationPath and validationErrors (FIX-P6-H1)
+ */
+export const ErrorResponseSchema = z.object({
+    error: z.object({
+        type: z.enum(ErrorType),
+        severity: z.enum(ErrorSeverity),
+        message: z.string(),
+        customMessage: z.string(),
+        customMessageReference: z.string().optional(),
+        code: z.string().optional(),
+        operationPath: z.string().optional(),
+        details: z.object({
+            versionConflict: VersionConflictDetailsSchema.optional(),
+        }).catchall(z.any()).optional(),
+        timestamp: z.string(),
+        initiatorIds: ExecutionContext_InitiatorIdsSchema.optional().nullable(),
+        /** Field-level validation errors. Values are either plain strings or structured i18n entries. */
+        validationErrors: z.record(z.string(), z.union([z.string(), ValidationErrorEntry_Schema])).optional(),
+        /** Contextual user guidance for error resolution (Phase 1b) */
+        userGuidance: ErrorUserGuidanceSchema.optional(),
+    })
+});
+// =============================================================================
+// VALIDATION ERROR RESPONSE SCHEMA
+// =============================================================================
+/**
+ * Standardized validation error response format.
+ * Used by both backend (400/409 responses) and frontend (error parsing).
+ *
+ * The `validationErrors` field maps field names to error values:
+ * - Plain string: displayed as-is (legacy format)
+ * - ValidationErrorEntry: resolved via i18n on frontend
+ */
+export const ValidationErrorResponse_Schema = z.object({
+    /** HTTP status code (400 for validation, 409 for unique constraint) */
+    code: z.number(),
+    /** General error message */
+    message: z.string(),
+    /**
+     * Field-level validation errors.
+     * Field names can be dot-notation paths for nested fields.
+     * Values are either plain strings or structured i18n entries.
+     */
+    validationErrors: z.record(z.string(), z.union([z.string(), ValidationErrorEntry_Schema])).optional(),
+});
+// =============================================================================
+// 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.
+ *
+ * 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.
+ *
+ * @param value - A validation error value
+ * @returns True if the value is a ValidationErrorEntry with a key
+ */
+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;
+}
+/**
+ * Extract validation errors from a raw error response payload.
+ *
+ * Handles multiple formats:
+ * 1. Standard backend ErrorResponse: `{ error: { validationErrors: { ... } } }`
+ * 2. Flat format (legacy): `{ validationErrors: { ... } }`
+ * 3. Pre-parsed interceptor format: `error.validationErrors` on the error object
+ *
+ * @param payload - Raw error response payload (from axios response.data or error object)
+ * @returns Extracted validation errors, or undefined if not found
+ */
+export function extractValidationErrors(payload) {
+    if (!payload || typeof payload !== 'object')
+        return undefined;
+    const obj = payload;
+    // Path 1: Standard nested format { error: { validationErrors } }
+    if (obj.error && typeof obj.error === 'object') {
+        const nested = obj.error;
+        if (nested.validationErrors && typeof nested.validationErrors === 'object' && !Array.isArray(nested.validationErrors)) {
+            const ve = nested.validationErrors;
+            if (Object.keys(ve).length > 0) {
+                return ve;
+            }
+        }
+    }
+    // Path 2: Flat format { validationErrors }
+    if (obj.validationErrors && typeof obj.validationErrors === 'object' && !Array.isArray(obj.validationErrors)) {
+        const ve = obj.validationErrors;
+        if (Object.keys(ve).length > 0) {
+            return ve;
+        }
+    }
+    return undefined;
+}
+// =============================================================================
+// FIELD VALIDATION — REQUEST/RESPONSE SCHEMAS
+// =============================================================================
+/**
+ * Request schema for the validate-field endpoint.
+ *
+ * Used to pre-validate a single field value (e.g., uniqueness check on blur)
+ * before form submission.
+ */
+export const ValidateFieldRequest_Schema = z.object({
+    /** Field name to validate (must match a field in the resource schema) */
+    fieldName: z.string(),
+    /** The value to validate */
+    value: z.unknown(),
+    /** For UPDATE operations: exclude this resource ID from uniqueness check (self-exclusion) */
+    excludeId: z.string().optional(),
+});
+/**
+ * Response schema for the validate-field endpoint.
+ */
+export const ValidateFieldResponse_Schema = z.object({
+    /** Whether the field value is valid */
+    valid: z.boolean(),
+    /** Error details when valid is false */
+    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(),
+    }).optional(),
+});
+//# sourceMappingURL=errors.shared.schemas.js.map

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

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

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

@@ -0,0 +1,15 @@
+import { ErrorType, ErrorSeverity } from './errors.shared.schemas.js';
+/**
+ * Check if an error is the "app configuration not initialized" error.
+ * Use this instead of string-matching on error messages.
+ */
+export declare function isAppConfigurationNotInitializedError(error: unknown): boolean;
+/**
+ * Get HTTP status code for error type
+ */
+export declare function getErrorStatusCode(errorType: ErrorType): number;
+/**
+ * Get error severity for error type
+ */
+export declare function getErrorSeverity(errorType: ErrorType): ErrorSeverity;
+//# sourceMappingURL=errors.shared.utils.d.ts.map

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

@@ -0,0 +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

@@ -0,0 +1,23 @@
+import { ERROR_DEFINITIONS } from './errors.shared.definitions.js';
+import { ErrorCustomMessageReference } from './errors.custom-message-ref.shared.definitions.js';
+/**
+ * Check if an error is the "app configuration not initialized" error.
+ * Use this instead of string-matching on error messages.
+ */
+export function isAppConfigurationNotInitializedError(error) {
+    const err = error;
+    return err?.customMessageReference === ErrorCustomMessageReference.APP_CONFIGURATION_NOT_INITIALIZED;
+}
+/**
+ * Get HTTP status code for error type
+ */
+export function getErrorStatusCode(errorType) {
+    return ERROR_DEFINITIONS[errorType].statusCode;
+}
+/**
+ * Get error severity for error type
+ */
+export function getErrorSeverity(errorType) {
+    return ERROR_DEFINITIONS[errorType].severity;
+}
+//# sourceMappingURL=errors.shared.utils.js.map

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

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