@seontechnologies/playwright-utils 3.10.0

package/dist/cjs/api-request/schema-validation/internal/response-extension.js

@@ -0,0 +1,212 @@
+"use strict";
+/** Response extension with validateSchema method */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createEnhancedResponse = createEnhancedResponse;
+const test_1 = require("@playwright/test");
+const internal_1 = require("../../../internal");
+const core_1 = require("../core");
+const types_1 = require("../types");
+const safe_error_serializer_1 = require("./safe-error-serializer");
+const ui_display_1 = require("../../ui-display");
+/**
+ * Maps request context to standardized format for UI display
+ */
+function mapRequestContext(context) {
+    return context
+        ? {
+            method: context.method,
+            path: context.path,
+            body: context.body,
+            headers: context.headers
+        }
+        : undefined;
+}
+/** Create successful validation response */
+function createSuccessResponse(originalResponse, validationResult) {
+    return {
+        status: originalResponse.status,
+        body: originalResponse.body,
+        validationResult,
+        originalResponse: originalResponse
+    };
+}
+/** Create return-mode validation response */
+function createReturnModeResponse(originalResponse, validationResult) {
+    return {
+        status: originalResponse.status,
+        body: originalResponse.body,
+        validationResult,
+        originalResponse: originalResponse
+    };
+}
+/** Handle validation failure by throwing Playwright-compatible error */
+function handleValidationFailure(validationResult, requestContext, responseContext) {
+    const errorMessage = (0, safe_error_serializer_1.createValidationErrorMessage)(validationResult.errors, 'Schema validation failed');
+    const error = new types_1.ValidationError(errorMessage, validationResult, requestContext, responseContext);
+    // Use Playwright's expect to throw for proper test integration
+    try {
+        (0, test_1.expect)(validationResult.success, error.message).toBe(true);
+    }
+    catch (playwrightError) {
+        // Create a proper ValidationError that wraps the Playwright error
+        const safeErrorMessage = (0, safe_error_serializer_1.createValidationErrorMessage)(validationResult.errors, 'Schema validation failed');
+        const validationError = new types_1.ValidationError(safeErrorMessage, validationResult, requestContext, responseContext);
+        // Preserve both stacks for debugging
+        if (playwrightError instanceof Error) {
+            validationError.stack = `${validationError.stack}\n\nCaused by:\n${playwrightError.stack}`;
+        }
+        throw validationError;
+    }
+    // This should never be reached due to expect throwing
+    throw error;
+}
+/** Create fallback validation error for unexpected errors */
+function createFallbackValidationError(error, startTime, requestContext, originalResponse) {
+    const validationTime = Date.now() - startTime;
+    const fallbackResult = {
+        success: false,
+        errors: [
+            {
+                path: 'validation',
+                message: `Validation process failed: ${error instanceof Error ? error.message : (0, safe_error_serializer_1.safeStringify)(error, 'Unknown error')}`,
+                expected: 'successful validation',
+                actual: 'validation error'
+            }
+        ],
+        schemaFormat: 'JSON Schema',
+        validationTime,
+        uiData: {
+            statusIcon: '❌',
+            validationSummary: 'FAILED',
+            schemaInfo: `Validation Error (${validationTime}ms)`,
+            errorDetails: [error instanceof Error ? error.message : String(error)]
+        }
+    };
+    return new types_1.ValidationError(`Schema validation process failed: ${error instanceof Error ? error.message : String(error)}`, fallbackResult, requestContext, originalResponse
+        ? {
+            status: originalResponse.status,
+            body: originalResponse.body
+        }
+        : undefined);
+}
+/** Create enhanced response with validateSchema method */
+function createEnhancedResponse(originalResponse, requestContext) {
+    const enhanced = {
+        ...originalResponse,
+        validateSchema: async (schema, options = {}) => {
+            const startTime = Date.now();
+            try {
+                // Run core validation
+                const validationResult = await (0, core_1.validateSchema)(originalResponse.body, schema, {
+                    shape: options.shape,
+                    path: options.path,
+                    endpoint: options.endpoint,
+                    method: options.method,
+                    status: options.status
+                });
+                // Display validation results in UI if enabled
+                if (options.uiMode ||
+                    shouldDisplayValidationUI() ||
+                    requestContext?.uiMode) {
+                    await displayValidationUI({
+                        validationResult,
+                        requestContext: mapRequestContext(requestContext),
+                        responseContext: {
+                            status: originalResponse.status,
+                            body: originalResponse.body
+                        },
+                        page: requestContext?.page
+                    });
+                }
+                // Handle validation failure based on mode
+                if (!validationResult.success) {
+                    if (options.mode === 'return') {
+                        return createReturnModeResponse(originalResponse, validationResult);
+                    }
+                    else {
+                        handleValidationFailure(validationResult, mapRequestContext(requestContext), {
+                            status: originalResponse.status,
+                            body: originalResponse.body
+                        });
+                    }
+                }
+                // Validation successful
+                return createSuccessResponse(originalResponse, validationResult);
+            }
+            catch (error) {
+                // Handle unexpected errors during validation
+                if (error instanceof types_1.ValidationError ||
+                    error.validationResult) {
+                    throw error; // Re-throw validation errors as-is
+                }
+                throw createFallbackValidationError(error, startTime, mapRequestContext(requestContext), originalResponse);
+            }
+        }
+    };
+    return enhanced;
+}
+/** Check if validation UI should be displayed */
+function shouldDisplayValidationUI() {
+    const envUiMode = process.env.API_E2E_UI_MODE;
+    return envUiMode === 'true';
+}
+/** Display validation results in UI */
+async function displayValidationUI(params) {
+    try {
+        if (!params.validationResult.uiData)
+            return;
+        const { validationResult, requestContext, responseContext, page } = params;
+        // Create validation-specific request data
+        const requestData = {
+            url: requestContext?.path || '/unknown',
+            method: requestContext?.method || 'UNKNOWN',
+            headers: requestContext?.headers,
+            data: requestContext?.body,
+            params: undefined,
+            // Add validation-specific markers
+            validationInfo: {
+                schemaFormat: validationResult.schemaFormat,
+                validationTime: validationResult.validationTime,
+                success: validationResult.success,
+                errorCount: validationResult.errors.length
+            }
+        };
+        // Create validation-enhanced response data
+        const responseData = {
+            status: responseContext?.status || 0,
+            statusClass: responseContext?.status
+                ? Math.floor(responseContext.status / 100) + 'xx'
+                : '0xx',
+            statusText: 'OK',
+            headers: {},
+            body: responseContext?.body,
+            duration: validationResult.validationTime,
+            // Add validation results
+            validationResult: validationResult.uiData
+                ? {
+                    icon: validationResult.uiData.statusIcon,
+                    summary: validationResult.uiData.validationSummary,
+                    schemaInfo: validationResult.uiData.schemaInfo,
+                    errors: validationResult.uiData.errorDetails,
+                    schema: validationResult.schema
+                }
+                : undefined
+        };
+        await (0, ui_display_1.addApiCardToUI)(requestData, responseData, page, true);
+        // Also log validation results
+        if (validationResult.success) {
+            await (0, internal_1.getLogger)().info(`✅ Schema validation passed (${validationResult.schemaFormat}, ${validationResult.validationTime}ms)`);
+        }
+        else {
+            await (0, internal_1.getLogger)().warning(`❌ Schema validation failed (${validationResult.errors.length} errors):`);
+            for (const error of validationResult.errors) {
+                await (0, internal_1.getLogger)().warning(`  - ${error.path}: ${error.message}`);
+            }
+        }
+    }
+    catch (error) {
+        // Silent failure for UI display issues
+        await (0, internal_1.getLogger)().debug(`Validation UI display failed: ${error}`);
+    }
+}
+//# sourceMappingURL=response-extension.js.map

package/dist/cjs/api-request/schema-validation/internal/response-extension.js.map

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

package/dist/cjs/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/cjs/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/cjs/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/cjs/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":"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"}

package/dist/cjs/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/cjs/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"}