@seontechnologies/playwright-utils 3.10.0

package/dist/esm/api-request/schema-validation/internal/result-builder.d.ts

@@ -0,0 +1,62 @@
+/**
+ * Validation Result Builder
+ *
+ * This module provides utilities for building consistent validation results
+ * with proper formatting, logging, and UI data generation.
+ *
+ * @module ResultBuilder
+ */
+import type { ValidationResult, ValidationErrorDetail } from '../types';
+/**
+ * Build a successful validation result
+ *
+ * @param validationErrors - Array of validation errors (should be empty for success)
+ * @param schemaFormat - Format of the schema that was validated
+ * @param validationTime - Time taken for validation in milliseconds
+ * @param schema - The processed schema object
+ * @returns Complete validation result object
+ */
+export declare function buildValidationResult(validationErrors: ValidationErrorDetail[], schemaFormat: ValidationResult['schemaFormat'], validationTime: number, schema?: object): ValidationResult;
+/**
+ * Build an error validation result for when validation setup fails
+ *
+ * @param error - The error that occurred during validation setup
+ * @param schemaFormat - Format of the schema that was being validated
+ * @param validationTime - Time taken before the error occurred
+ * @returns Complete validation result object with error information
+ */
+export declare function buildErrorResult(error: unknown, schemaFormat: ValidationResult['schemaFormat'], validationTime: number): ValidationResult;
+/**
+ * Create a validation error object with consistent formatting
+ *
+ * @param path - JSON path to the invalid property
+ * @param message - Human-readable error message
+ * @param expected - Expected value or type
+ * @param actual - Actual value or type that failed validation
+ * @returns Formatted validation error object
+ */
+export declare function createValidationError(path: string, message: string, expected: unknown, actual: unknown): ValidationErrorDetail;
+/**
+ * Format validation time with appropriate units
+ *
+ * @param milliseconds - Time in milliseconds
+ * @returns Formatted time string with units
+ */
+export declare function formatValidationTime(milliseconds: number): string;
+/**
+ * Generate UI-friendly status icon based on validation result
+ *
+ * @param success - Whether validation was successful
+ * @param hasWarnings - Whether there are warnings (future use)
+ * @returns Appropriate status icon
+ */
+export declare function getStatusIcon(success: boolean, hasWarnings?: boolean): string;
+/**
+ * Generate a summary of validation errors for UI display
+ *
+ * @param errors - Array of validation errors
+ * @param maxErrors - Maximum number of errors to include in summary
+ * @returns Array of formatted error strings for UI display
+ */
+export declare function summarizeErrors(errors: ValidationErrorDetail[], maxErrors?: number): string[];
+//# sourceMappingURL=result-builder.d.ts.map

package/dist/esm/api-request/schema-validation/internal/result-builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"result-builder.d.ts","sourceRoot":"","sources":["../../../../../src/api-request/schema-validation/internal/result-builder.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,qBAAqB,EAAE,MAAM,UAAU,CAAA;AAIvE;;;;;;;;GAQG;AACH,wBAAgB,qBAAqB,CACnC,gBAAgB,EAAE,qBAAqB,EAAE,EACzC,YAAY,EAAE,gBAAgB,CAAC,cAAc,CAAC,EAC9C,cAAc,EAAE,MAAM,EACtB,MAAM,CAAC,EAAE,MAAM,GACd,gBAAgB,CAuBlB;AAED;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,OAAO,EACd,YAAY,EAAE,gBAAgB,CAAC,cAAc,CAAC,EAC9C,cAAc,EAAE,MAAM,GACrB,gBAAgB,CAyBlB;AAED;;;;;;;;GAQG;AACH,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,OAAO,EACjB,MAAM,EAAE,OAAO,GACd,qBAAqB,CAOvB;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,CAMjE;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,OAAO,EAAE,WAAW,UAAQ,GAAG,MAAM,CAK3E;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAC7B,MAAM,EAAE,qBAAqB,EAAE,EAC/B,SAAS,SAAK,GACb,MAAM,EAAE,CAUV"}

package/dist/esm/api-request/schema-validation/internal/result-builder.js

@@ -0,0 +1,140 @@
+"use strict";
+/**
+ * Validation Result Builder
+ *
+ * This module provides utilities for building consistent validation results
+ * with proper formatting, logging, and UI data generation.
+ *
+ * @module ResultBuilder
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildValidationResult = buildValidationResult;
+exports.buildErrorResult = buildErrorResult;
+exports.createValidationError = createValidationError;
+exports.formatValidationTime = formatValidationTime;
+exports.getStatusIcon = getStatusIcon;
+exports.summarizeErrors = summarizeErrors;
+const internal_1 = require("../../../internal");
+const safe_error_serializer_1 = require("./safe-error-serializer");
+/**
+ * Build a successful validation result
+ *
+ * @param validationErrors - Array of validation errors (should be empty for success)
+ * @param schemaFormat - Format of the schema that was validated
+ * @param validationTime - Time taken for validation in milliseconds
+ * @param schema - The processed schema object
+ * @returns Complete validation result object
+ */
+function buildValidationResult(validationErrors, schemaFormat, validationTime, schema) {
+    const success = validationErrors.length === 0;
+    // Log the extracted schema if DEBUG is enabled
+    if (process.env.DEBUG === 'true' && schema) {
+        void (0, internal_1.getLogger)().debug(`Extracted schema for validation: ${JSON.stringify(schema, null, 2)}`);
+    }
+    return {
+        success,
+        errors: validationErrors,
+        schemaFormat,
+        validationTime,
+        schema,
+        uiData: {
+            statusIcon: success ? '✅' : '❌',
+            validationSummary: success ? 'PASSED' : 'FAILED',
+            schemaInfo: `${schemaFormat} (${validationTime}ms)`,
+            errorDetails: success ? undefined : (0, safe_error_serializer_1.safeErrorDetails)(validationErrors)
+        }
+    };
+}
+/**
+ * Build an error validation result for when validation setup fails
+ *
+ * @param error - The error that occurred during validation setup
+ * @param schemaFormat - Format of the schema that was being validated
+ * @param validationTime - Time taken before the error occurred
+ * @returns Complete validation result object with error information
+ */
+function buildErrorResult(error, schemaFormat, validationTime) {
+    const errorMessage = error instanceof Error
+        ? error.message
+        : (0, safe_error_serializer_1.safeStringify)(error, 'Unknown error');
+    return {
+        success: false,
+        errors: [
+            {
+                path: 'schema',
+                message: `Schema validation setup failed: ${errorMessage}`,
+                expected: 'valid schema',
+                actual: 'invalid schema'
+            }
+        ],
+        schemaFormat,
+        validationTime,
+        uiData: {
+            statusIcon: '❌',
+            validationSummary: 'FAILED',
+            schemaInfo: `Schema Error (${validationTime}ms)`,
+            errorDetails: [errorMessage]
+        }
+    };
+}
+/**
+ * Create a validation error object with consistent formatting
+ *
+ * @param path - JSON path to the invalid property
+ * @param message - Human-readable error message
+ * @param expected - Expected value or type
+ * @param actual - Actual value or type that failed validation
+ * @returns Formatted validation error object
+ */
+function createValidationError(path, message, expected, actual) {
+    return {
+        path,
+        message,
+        expected,
+        actual
+    };
+}
+/**
+ * Format validation time with appropriate units
+ *
+ * @param milliseconds - Time in milliseconds
+ * @returns Formatted time string with units
+ */
+function formatValidationTime(milliseconds) {
+    if (milliseconds < 1000) {
+        return `${milliseconds}ms`;
+    }
+    else {
+        return `${(milliseconds / 1000).toFixed(2)}s`;
+    }
+}
+/**
+ * Generate UI-friendly status icon based on validation result
+ *
+ * @param success - Whether validation was successful
+ * @param hasWarnings - Whether there are warnings (future use)
+ * @returns Appropriate status icon
+ */
+function getStatusIcon(success, hasWarnings = false) {
+    if (success) {
+        return hasWarnings ? '⚠️' : '✅';
+    }
+    return '❌';
+}
+/**
+ * Generate a summary of validation errors for UI display
+ *
+ * @param errors - Array of validation errors
+ * @param maxErrors - Maximum number of errors to include in summary
+ * @returns Array of formatted error strings for UI display
+ */
+function summarizeErrors(errors, maxErrors = 10) {
+    const summary = errors
+        .slice(0, maxErrors)
+        .map((e) => `${e.path}: ${e.message}`);
+    if (errors.length > maxErrors) {
+        summary.push(`... and ${errors.length - maxErrors} more errors`);
+    }
+    return summary;
+}
+//# sourceMappingURL=result-builder.js.map

package/dist/esm/api-request/schema-validation/internal/result-builder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"result-builder.js","sourceRoot":"","sources":["../../../../../src/api-request/schema-validation/internal/result-builder.ts"],"names":[],"mappings":";AAAA;;;;;;;GAOG;;AAeH,sDA4BC;AAUD,4CA6BC;AAWD,sDAYC;AAQD,oDAMC;AASD,sCAKC;AASD,0CAaC;AAxJD,gDAA6C;AAC7C,mEAAyE;AAEzE;;;;;;;;GAQG;AACH,SAAgB,qBAAqB,CACnC,gBAAyC,EACzC,YAA8C,EAC9C,cAAsB,EACtB,MAAe;IAEf,MAAM,OAAO,GAAG,gBAAgB,CAAC,MAAM,KAAK,CAAC,CAAA;IAE7C,+CAA+C;IAC/C,IAAI,OAAO,CAAC,GAAG,CAAC,KAAK,KAAK,MAAM,IAAI,MAAM,EAAE,CAAC;QAC3C,KAAK,IAAA,oBAAS,GAAE,CAAC,KAAK,CACpB,oCAAoC,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CACtE,CAAA;IACH,CAAC;IAED,OAAO;QACL,OAAO;QACP,MAAM,EAAE,gBAAgB;QACxB,YAAY;QACZ,cAAc;QACd,MAAM;QACN,MAAM,EAAE;YACN,UAAU,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG;YAC/B,iBAAiB,EAAE,OAAO,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,QAAQ;YAChD,UAAU,EAAE,GAAG,YAAY,KAAK,cAAc,KAAK;YACnD,YAAY,EAAE,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,IAAA,wCAAgB,EAAC,gBAAgB,CAAC;SACvE;KACF,CAAA;AACH,CAAC;AAED;;;;;;;GAOG;AACH,SAAgB,gBAAgB,CAC9B,KAAc,EACd,YAA8C,EAC9C,cAAsB;IAEtB,MAAM,YAAY,GAChB,KAAK,YAAY,KAAK;QACpB,CAAC,CAAC,KAAK,CAAC,OAAO;QACf,CAAC,CAAC,IAAA,qCAAa,EAAC,KAAK,EAAE,eAAe,CAAC,CAAA;IAE3C,OAAO;QACL,OAAO,EAAE,KAAK;QACd,MAAM,EAAE;YACN;gBACE,IAAI,EAAE,QAAQ;gBACd,OAAO,EAAE,mCAAmC,YAAY,EAAE;gBAC1D,QAAQ,EAAE,cAAc;gBACxB,MAAM,EAAE,gBAAgB;aACzB;SACF;QACD,YAAY;QACZ,cAAc;QACd,MAAM,EAAE;YACN,UAAU,EAAE,GAAG;YACf,iBAAiB,EAAE,QAAQ;YAC3B,UAAU,EAAE,iBAAiB,cAAc,KAAK;YAChD,YAAY,EAAE,CAAC,YAAY,CAAC;SAC7B;KACF,CAAA;AACH,CAAC;AAED;;;;;;;;GAQG;AACH,SAAgB,qBAAqB,CACnC,IAAY,EACZ,OAAe,EACf,QAAiB,EACjB,MAAe;IAEf,OAAO;QACL,IAAI;QACJ,OAAO;QACP,QAAQ;QACR,MAAM;KACP,CAAA;AACH,CAAC;AAED;;;;;GAKG;AACH,SAAgB,oBAAoB,CAAC,YAAoB;IACvD,IAAI,YAAY,GAAG,IAAI,EAAE,CAAC;QACxB,OAAO,GAAG,YAAY,IAAI,CAAA;IAC5B,CAAC;SAAM,CAAC;QACN,OAAO,GAAG,CAAC,YAAY,GAAG,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAA;IAC/C,CAAC;AACH,CAAC;AAED;;;;;;GAMG;AACH,SAAgB,aAAa,CAAC,OAAgB,EAAE,WAAW,GAAG,KAAK;IACjE,IAAI,OAAO,EAAE,CAAC;QACZ,OAAO,WAAW,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,CAAA;IACjC,CAAC;IACD,OAAO,GAAG,CAAA;AACZ,CAAC;AAED;;;;;;GAMG;AACH,SAAgB,eAAe,CAC7B,MAA+B,EAC/B,SAAS,GAAG,EAAE;IAEd,MAAM,OAAO,GAAG,MAAM;SACnB,KAAK,CAAC,CAAC,EAAE,SAAS,CAAC;SACnB,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,OAAO,EAAE,CAAC,CAAA;IAExC,IAAI,MAAM,CAAC,MAAM,GAAG,SAAS,EAAE,CAAC;QAC9B,OAAO,CAAC,IAAI,CAAC,WAAW,MAAM,CAAC,MAAM,GAAG,SAAS,cAAc,CAAC,CAAA;IAClE,CAAC;IAED,OAAO,OAAO,CAAA;AAChB,CAAC"}

package/dist/esm/api-request/schema-validation/internal/safe-error-serializer.d.ts

@@ -0,0 +1,58 @@
+/**
+ * Safe Error Serialization Utility
+ *
+ * Provides defensive error serialization that handles all edge cases:
+ * - String messages (normal case)
+ * - Symbol values (error case)
+ * - Undefined/null values
+ * - Objects that need JSON stringification
+ * - Circular references
+ * - Functions and other non-serializable types
+ *
+ * This utility ensures error serialization never throws and preserves
+ * as much error context as possible.
+ */
+/**
+ * Safely serialize any value to a string, handling all edge cases
+ *
+ * @param value - The value to serialize
+ * @param fallbackPrefix - Prefix for fallback messages
+ * @returns A safe string representation
+ */
+export declare function safeStringify(value: unknown, fallbackPrefix?: string): string;
+/**
+ * Safely extract and serialize error messages from validation errors
+ *
+ * @param errors - Array of validation errors that may contain Symbol values
+ * @param maxLength - Maximum length of the combined error message
+ * @returns Safe string representation of all error messages
+ */
+export declare function safeErrorMessage(errors: Array<{
+    message?: unknown;
+    path?: unknown;
+    [key: string]: unknown;
+}>, maxLength?: number): string;
+/**
+ * Create a safe error message for ValidationError constructor
+ *
+ * @param errors - Array of validation errors
+ * @param context - Additional context for the error
+ * @returns Safe error message string
+ */
+export declare function createValidationErrorMessage(errors: Array<{
+    message?: unknown;
+    path?: unknown;
+    [key: string]: unknown;
+}>, context?: string): string;
+/**
+ * Safe utility to extract error details for UI display
+ *
+ * @param errors - Array of validation errors
+ * @returns Array of safe string representations
+ */
+export declare function safeErrorDetails(errors: Array<{
+    message?: unknown;
+    path?: unknown;
+    [key: string]: unknown;
+}>): string[];
+//# sourceMappingURL=safe-error-serializer.d.ts.map

package/dist/esm/api-request/schema-validation/internal/safe-error-serializer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"safe-error-serializer.d.ts","sourceRoot":"","sources":["../../../../../src/api-request/schema-validation/internal/safe-error-serializer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAiFH;;;;;;GAMG;AACH,wBAAgB,aAAa,CAC3B,KAAK,EAAE,OAAO,EACd,cAAc,SAAqB,GAClC,MAAM,CAwBR;AAKD;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,KAAK,CAAC;IAAE,OAAO,CAAC,EAAE,OAAO,CAAC;IAAC,IAAI,CAAC,EAAE,OAAO,CAAC;IAAC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;CAAE,CAAC,EAC5E,SAAS,SAAO,GACf,MAAM,CAyCR;AAED;;;;;;GAMG;AACH,wBAAgB,4BAA4B,CAC1C,MAAM,EAAE,KAAK,CAAC;IAAE,OAAO,CAAC,EAAE,OAAO,CAAC;IAAC,IAAI,CAAC,EAAE,OAAO,CAAC;IAAC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;CAAE,CAAC,EAC5E,OAAO,CAAC,EAAE,MAAM,GACf,MAAM,CAUR;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,KAAK,CAAC;IAAE,OAAO,CAAC,EAAE,OAAO,CAAC;IAAC,IAAI,CAAC,EAAE,OAAO,CAAC;IAAC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;CAAE,CAAC,GAC3E,MAAM,EAAE,CAkBV"}

package/dist/esm/api-request/schema-validation/internal/safe-error-serializer.js

@@ -0,0 +1,221 @@
+"use strict";
+/**
+ * Safe Error Serialization Utility
+ *
+ * Provides defensive error serialization that handles all edge cases:
+ * - String messages (normal case)
+ * - Symbol values (error case)
+ * - Undefined/null values
+ * - Objects that need JSON stringification
+ * - Circular references
+ * - Functions and other non-serializable types
+ *
+ * This utility ensures error serialization never throws and preserves
+ * as much error context as possible.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.safeStringify = safeStringify;
+exports.safeErrorMessage = safeErrorMessage;
+exports.createValidationErrorMessage = createValidationErrorMessage;
+exports.safeErrorDetails = safeErrorDetails;
+/**
+ * Handle primitive types (null, undefined, string, number, boolean, bigint)
+ */
+function handlePrimitiveTypes(value) {
+    if (value === null)
+        return 'null';
+    if (value === undefined)
+        return 'undefined';
+    if (typeof value === 'string')
+        return value;
+    if (typeof value === 'number')
+        return String(value);
+    if (typeof value === 'boolean')
+        return String(value);
+    if (typeof value === 'bigint')
+        return `${value}n`;
+    return null; // Not a primitive type
+}
+/**
+ * Handle Symbol values safely
+ */
+function handleSymbol(value) {
+    try {
+        const description = value.description;
+        return description ? `Symbol(${description})` : 'Symbol()';
+    }
+    catch {
+        return 'Symbol(?)';
+    }
+}
+/**
+ * Handle Function values safely
+ */
+function handleFunction(value) {
+    try {
+        return `Function(${value.name || 'anonymous'})`;
+    }
+    catch {
+        return 'Function(?)';
+    }
+}
+/**
+ * JSON replacer function to handle special types during serialization
+ */
+function createJsonReplacer() {
+    return (key, val) => {
+        // Handle circular references
+        if (typeof val === 'object' && val !== null) {
+            if (seen.has(val)) {
+                return '[Circular Reference]';
+            }
+            seen.add(val);
+        }
+        // Handle special object types
+        if (typeof val === 'symbol')
+            return handleSymbol(val);
+        if (typeof val === 'function') {
+            return handleFunction(val);
+        }
+        if (typeof val === 'bigint')
+            return `${val}n`;
+        if (val instanceof Error)
+            return `Error(${val.message})`;
+        return val;
+    };
+}
+/**
+ * Handle object serialization with fallback strategies
+ */
+function handleObject(value, fallbackPrefix) {
+    try {
+        return JSON.stringify(value, createJsonReplacer());
+    }
+    catch {
+        // If JSON.stringify fails, try toString
+        try {
+            return value.toString();
+        }
+        catch {
+            return `${fallbackPrefix} object`;
+        }
+    }
+    finally {
+        seen.clear();
+    }
+}
+/**
+ * Safely serialize any value to a string, handling all edge cases
+ *
+ * @param value - The value to serialize
+ * @param fallbackPrefix - Prefix for fallback messages
+ * @returns A safe string representation
+ */
+function safeStringify(value, fallbackPrefix = 'Non-serializable') {
+    // Handle primitive types first
+    const primitiveResult = handlePrimitiveTypes(value);
+    if (primitiveResult !== null)
+        return primitiveResult;
+    // Handle Symbol values
+    if (typeof value === 'symbol')
+        return handleSymbol(value);
+    // Handle functions
+    if (typeof value === 'function') {
+        return handleFunction(value);
+    }
+    // Handle objects (excluding null which is handled in primitives)
+    if (typeof value === 'object' && value !== null) {
+        return handleObject(value, fallbackPrefix);
+    }
+    // Final fallback for any remaining types
+    try {
+        return String(value);
+    }
+    catch {
+        return `${fallbackPrefix} value`;
+    }
+}
+// Set to track circular references during JSON.stringify
+const seen = new Set();
+/**
+ * Safely extract and serialize error messages from validation errors
+ *
+ * @param errors - Array of validation errors that may contain Symbol values
+ * @param maxLength - Maximum length of the combined error message
+ * @returns Safe string representation of all error messages
+ */
+function safeErrorMessage(errors, maxLength = 2000) {
+    if (!Array.isArray(errors) || errors.length === 0) {
+        return 'No error details available';
+    }
+    try {
+        const messages = errors
+            .map((error, index) => {
+            if (!error || typeof error !== 'object') {
+                return `Error ${index + 1}: ${safeStringify(error, 'Invalid error')}`;
+            }
+            const message = safeStringify(error.message, 'Unknown error');
+            const path = error.path
+                ? safeStringify(error.path, 'unknown path')
+                : null;
+            return path ? `${path}: ${message}` : message;
+        })
+            .filter((msg) => msg.length > 0) // Remove empty messages
+            .slice(0, 100); // Prevent memory issues with too many errors
+        if (messages.length === 0) {
+            return 'Error messages could not be serialized';
+        }
+        const combined = messages.join(', ');
+        // Truncate if too long to prevent memory/display issues
+        if (combined.length > maxLength) {
+            const truncated = combined.substring(0, maxLength - 20);
+            const errorCount = errors.length;
+            const shownCount = messages.length;
+            return `${truncated}... (${shownCount}/${errorCount} errors shown)`;
+        }
+        return combined;
+    }
+    catch (error) {
+        // Ultimate fallback - this should never happen but provides safety
+        return `Error serialization failed: ${errors.length} error(s) found but could not be displayed. Original error: ${safeStringify(error, 'Serialization error')}`;
+    }
+}
+/**
+ * Create a safe error message for ValidationError constructor
+ *
+ * @param errors - Array of validation errors
+ * @param context - Additional context for the error
+ * @returns Safe error message string
+ */
+function createValidationErrorMessage(errors, context) {
+    const baseMessage = context || 'Schema validation failed';
+    const errorCount = Array.isArray(errors) ? errors.length : 0;
+    if (errorCount === 0) {
+        return `${baseMessage}: No specific errors reported`;
+    }
+    const safeDetails = safeErrorMessage(errors, 1000); // Shorter for error messages
+    return `${baseMessage}: ${safeDetails}`;
+}
+/**
+ * Safe utility to extract error details for UI display
+ *
+ * @param errors - Array of validation errors
+ * @returns Array of safe string representations
+ */
+function safeErrorDetails(errors) {
+    if (!Array.isArray(errors)) {
+        return ['Invalid error format'];
+    }
+    return errors
+        .slice(0, 50) // Limit for UI display
+        .map((error, index) => {
+        if (!error || typeof error !== 'object') {
+            return `Error ${index + 1}: ${safeStringify(error, 'Invalid error')}`;
+        }
+        const message = safeStringify(error.message, 'Unknown error');
+        const path = error.path ? safeStringify(error.path, 'unknown') : null;
+        return path ? `${path}: ${message}` : message;
+    })
+        .filter((detail) => detail.length > 0);
+}
+//# sourceMappingURL=safe-error-serializer.js.map

package/dist/esm/api-request/schema-validation/internal/safe-error-serializer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"safe-error-serializer.js","sourceRoot":"","sources":["../../../../../src/api-request/schema-validation/internal/safe-error-serializer.ts"],"names":[],"mappings":"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"}

package/dist/esm/api-request/schema-validation/internal/schema-processors.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Schema Processing Strategies
+ *
+ * This module implements the Strategy pattern for processing different schema formats.
+ * Each processor handles a specific schema type and validation logic.
+ *
+ * @module SchemaProcessors
+ */
+import type { ValidationErrorDetail, SupportedSchema } from '../types';
+/**
+ * Common options for schema processing
+ */
+export interface SchemaProcessingOptions {
+    shape?: unknown;
+    path?: string;
+    endpoint?: string;
+    method?: string;
+    status?: number;
+}
+/**
+ * Result of schema processing
+ */
+export interface SchemaProcessingResult {
+    validationErrors: ValidationErrorDetail[];
+    processedSchema: object;
+    schemaForResult?: object;
+}
+/**
+ * Base interface for schema processors
+ */
+export interface SchemaProcessor {
+    validate(data: unknown, schema: SupportedSchema, options: SchemaProcessingOptions): Promise<SchemaProcessingResult>;
+}
+/**
+ * Convenience function to process any schema type
+ */
+export declare function processSchema(data: unknown, schema: SupportedSchema, schemaFormat: string, options?: SchemaProcessingOptions): Promise<SchemaProcessingResult>;
+//# sourceMappingURL=schema-processors.d.ts.map

package/dist/esm/api-request/schema-validation/internal/schema-processors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-processors.d.ts","sourceRoot":"","sources":["../../../../../src/api-request/schema-validation/internal/schema-processors.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,qBAAqB,EAAE,eAAe,EAAE,MAAM,UAAU,CAAA;AAKtE;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,KAAK,CAAC,EAAE,OAAO,CAAA;IACf,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,gBAAgB,EAAE,qBAAqB,EAAE,CAAA;IACzC,eAAe,EAAE,MAAM,CAAA;IACvB,eAAe,CAAC,EAAE,MAAM,CAAA;CACzB;AAOD;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,QAAQ,CACN,IAAI,EAAE,OAAO,EACb,MAAM,EAAE,eAAe,EACvB,OAAO,EAAE,uBAAuB,GAC/B,OAAO,CAAC,sBAAsB,CAAC,CAAA;CACnC;AAuYD;;GAEG;AACH,wBAAsB,aAAa,CACjC,IAAI,EAAE,OAAO,EACb,MAAM,EAAE,eAAe,EACvB,YAAY,EAAE,MAAM,EACpB,OAAO,GAAE,uBAA4B,GACpC,OAAO,CAAC,sBAAsB,CAAC,CAcjC"}