@seontechnologies/playwright-utils 3.10.0

package/dist/types/api-request/schema-validation/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/api-request/schema-validation/index.ts"],"names":[],"mappings":"AAAA,gCAAgC;AAEhC,OAAO,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,QAAQ,CAAA;AAC3D,YAAY,EACV,eAAe,EACf,cAAc,EACd,cAAc,EACd,cAAc,EACd,qBAAqB,EACrB,qBAAqB,EACrB,gBAAgB,EAChB,oBAAoB,EACrB,MAAM,SAAS,CAAA;AAChB,OAAO,EAAE,eAAe,EAAE,MAAM,SAAS,CAAA;AAGzC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA"}

package/dist/types/api-request/schema-validation/internal/file-loader.d.ts

@@ -0,0 +1,50 @@
+/**
+ * Secure File Loading for Schema Validation
+ *
+ * This module provides secure file loading capabilities for schema files
+ * with built-in security validations and format detection.
+ *
+ * @module FileLoader
+ */
+/**
+ * Load schema from file path with comprehensive security validations
+ *
+ * This function provides secure file loading with multiple security checks:
+ * - File extension validation (only .json, .yaml, .yml allowed)
+ * - Path resolution to prevent directory traversal
+ * - Safe YAML parsing (no code execution)
+ * - Comprehensive error handling
+ *
+ * @param filePath - Path to the schema file (relative or absolute)
+ * @returns Parsed schema object
+ * @throws Error if file is not found, has invalid extension, or parsing fails
+ *
+ * @example
+ * ```typescript
+ * // Load JSON schema
+ * const jsonSchema = await loadSchemaFromFile('./schemas/user.json')
+ *
+ * // Load YAML OpenAPI spec
+ * const yamlSchema = await loadSchemaFromFile('./openapi/api.yaml')
+ * ```
+ *
+ * @security
+ * - Only allows specific file extensions to prevent arbitrary file reading
+ * - Uses path.resolve() to prevent directory traversal attacks
+ * - YAML parsing is safe by default (no code execution in js-yaml v4+)
+ */
+export declare function loadSchemaFromFile(filePath: string): Promise<object>;
+/**
+ * Check if a file path has a valid schema file extension
+ *
+ * @param filePath - File path to validate
+ * @returns True if the file has a valid schema extension
+ */
+export declare function isValidSchemaFile(filePath: string): boolean;
+/**
+ * Get the list of allowed file extensions for schema files
+ *
+ * @returns Array of allowed file extensions
+ */
+export declare function getAllowedExtensions(): readonly string[];
+//# sourceMappingURL=file-loader.d.ts.map

package/dist/types/api-request/schema-validation/internal/file-loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-loader.d.ts","sourceRoot":"","sources":["../../../../../src/api-request/schema-validation/internal/file-loader.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAWH;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAsB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAoC1E;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAK3D;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,IAAI,SAAS,MAAM,EAAE,CAExD"}

package/dist/types/api-request/schema-validation/internal/openapi-handler.d.ts

@@ -0,0 +1,43 @@
+/**
+ * OpenAPI Schema Handler
+ *
+ * This module handles OpenAPI specification parsing, schema extraction,
+ * and $ref resolution for API response validation.
+ *
+ * @module OpenApiHandler
+ */
+/**
+ * Resolve $ref references in OpenAPI schema
+ *
+ * @param ref - Reference string (e.g., "#/components/schemas/User")
+ * @param openApiSpec - Complete OpenAPI specification object
+ * @returns Resolved schema object
+ * @throws Error if reference is external or not found
+ */
+export declare function resolveOpenApiRef(ref: string, openApiSpec: Record<string, unknown>): object;
+/**
+ * Extract schema from OpenAPI spec for specific endpoint
+ *
+ * This function navigates through the OpenAPI specification to find
+ * the response schema for a specific endpoint, method, and status code.
+ * It handles parameterized paths and $ref resolution.
+ *
+ * @param openApiSpec - Complete OpenAPI specification object
+ * @param endpoint - API endpoint path (e.g., "/users/{id}")
+ * @param method - HTTP method (GET, POST, etc.)
+ * @param status - HTTP status code (defaults to 200)
+ * @returns JSON Schema object for validation
+ *
+ * @example
+ * ```typescript
+ * const schema = extractOpenApiSchema(
+ *   openApiSpec,
+ *   "/users/{id}",
+ *   "GET",
+ *   200
+ * )
+ * // Returns the JSON schema for GET /users/{id} 200 response
+ * ```
+ */
+export declare function extractOpenApiSchema(openApiSpec: Record<string, unknown>, endpoint?: string, method?: string, status?: number): object;
+//# sourceMappingURL=openapi-handler.d.ts.map

package/dist/types/api-request/schema-validation/internal/openapi-handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"openapi-handler.d.ts","sourceRoot":"","sources":["../../../../../src/api-request/schema-validation/internal/openapi-handler.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAoFH;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAC/B,GAAG,EAAE,MAAM,EACX,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACnC,MAAM,CAkBR;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,oBAAoB,CAClC,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACpC,QAAQ,CAAC,EAAE,MAAM,EACjB,MAAM,CAAC,EAAE,MAAM,EACf,MAAM,SAAM,GACX,MAAM,CAqCR"}

package/dist/types/api-request/schema-validation/internal/promise-extension.d.ts

@@ -0,0 +1,10 @@
+/** Promise extension to add validateSchema method to promises */
+import type { SupportedSchema, ValidateSchemaOptions, ValidatedApiResponse } from '../types';
+import type { EnhancedApiResponse } from './response-extension';
+/** Enhanced Promise with validateSchema method */
+export interface EnhancedApiPromise<T = unknown> extends Promise<EnhancedApiResponse<T>> {
+    validateSchema<TValidated = T>(schema: SupportedSchema, options?: ValidateSchemaOptions): Promise<ValidatedApiResponse<TValidated>>;
+}
+/** Create enhanced promise with validateSchema method */
+export declare function createEnhancedPromise<T>(promise: Promise<EnhancedApiResponse<T>>): EnhancedApiPromise<T>;
+//# sourceMappingURL=promise-extension.d.ts.map

package/dist/types/api-request/schema-validation/internal/promise-extension.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"promise-extension.d.ts","sourceRoot":"","sources":["../../../../../src/api-request/schema-validation/internal/promise-extension.ts"],"names":[],"mappings":"AAAA,iEAAiE;AAEjE,OAAO,KAAK,EACV,eAAe,EACf,qBAAqB,EACrB,oBAAoB,EACrB,MAAM,UAAU,CAAA;AACjB,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAA;AAE/D,kDAAkD;AAClD,MAAM,WAAW,kBAAkB,CAAC,CAAC,GAAG,OAAO,CAC7C,SAAQ,OAAO,CAAC,mBAAmB,CAAC,CAAC,CAAC,CAAC;IACvC,cAAc,CAAC,UAAU,GAAG,CAAC,EAC3B,MAAM,EAAE,eAAe,EACvB,OAAO,CAAC,EAAE,qBAAqB,GAC9B,OAAO,CAAC,oBAAoB,CAAC,UAAU,CAAC,CAAC,CAAA;CAC7C;AAED,yDAAyD;AACzD,wBAAgB,qBAAqB,CAAC,CAAC,EACrC,OAAO,EAAE,OAAO,CAAC,mBAAmB,CAAC,CAAC,CAAC,CAAC,GACvC,kBAAkB,CAAC,CAAC,CAAC,CAYvB"}

package/dist/types/api-request/schema-validation/internal/response-extension.d.ts

@@ -0,0 +1,18 @@
+/** Response extension with validateSchema method */
+import type { SupportedSchema, ValidateSchemaOptions, ValidatedApiResponse } from '../types';
+import type { ApiRequestResponse } from '../../api-request';
+import type { Page } from '@playwright/test';
+/** Enhanced API response with validateSchema method */
+export interface EnhancedApiResponse<T = unknown> extends ApiRequestResponse<T> {
+    validateSchema<TValidated = T>(schema: SupportedSchema, options?: ValidateSchemaOptions): Promise<ValidatedApiResponse<TValidated>>;
+}
+/** Create enhanced response with validateSchema method */
+export declare function createEnhancedResponse<T>(originalResponse: ApiRequestResponse<T>, requestContext?: {
+    method: string;
+    path: string;
+    body?: unknown;
+    headers?: Record<string, string>;
+    page?: Page;
+    uiMode?: boolean;
+}): EnhancedApiResponse<T>;
+//# sourceMappingURL=response-extension.d.ts.map

package/dist/types/api-request/schema-validation/internal/response-extension.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"response-extension.d.ts","sourceRoot":"","sources":["../../../../../src/api-request/schema-validation/internal/response-extension.ts"],"names":[],"mappings":"AAAA,oDAAoD;AAWpD,OAAO,KAAK,EACV,eAAe,EACf,qBAAqB,EACrB,oBAAoB,EAErB,MAAM,UAAU,CAAA;AACjB,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAA;AAM3D,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAA;AAqB5C,uDAAuD;AACvD,MAAM,WAAW,mBAAmB,CAAC,CAAC,GAAG,OAAO,CAC9C,SAAQ,kBAAkB,CAAC,CAAC,CAAC;IAC7B,cAAc,CAAC,UAAU,GAAG,CAAC,EAC3B,MAAM,EAAE,eAAe,EACvB,OAAO,CAAC,EAAE,qBAAqB,GAC9B,OAAO,CAAC,oBAAoB,CAAC,UAAU,CAAC,CAAC,CAAA;CAC7C;AAmID,0DAA0D;AAC1D,wBAAgB,sBAAsB,CAAC,CAAC,EACtC,gBAAgB,EAAE,kBAAkB,CAAC,CAAC,CAAC,EACvC,cAAc,CAAC,EAAE;IACf,MAAM,EAAE,MAAM,CAAA;IACd,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,CAAC,EAAE,OAAO,CAAA;IACd,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAChC,IAAI,CAAC,EAAE,IAAI,CAAA;IACX,MAAM,CAAC,EAAE,OAAO,CAAA;CACjB,GACA,mBAAmB,CAAC,CAAC,CAAC,CAoFxB"}

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

package/dist/types/api-request/schema-validation/internal/shape-validator.d.ts

@@ -0,0 +1,96 @@
+/**
+ * Shape Validation Engine
+ *
+ * This module provides advanced shape validation capabilities for API responses,
+ * allowing flexible validation patterns including nested objects, functions, and
+ * direct value comparisons.
+ *
+ * @module ShapeValidator
+ */
+import type { ValidationErrorDetail, ShapeAssertion } from '../types';
+/**
+ * Execute shape validation assertions against data
+ *
+ * Shape validation provides a flexible way to validate data structure and values
+ * without requiring formal schemas. It supports:
+ * - Direct value comparisons
+ * - Function-based validators
+ * - Nested object validation
+ * - Custom validation logic
+ *
+ * @param data - Data to validate against shape assertions
+ * @param shapeAssertion - Shape validation rules
+ * @param basePath - Base path for error reporting (used internally for nesting)
+ * @returns Array of validation errors (empty if valid)
+ *
+ * @example
+ * ```typescript
+ * // Direct value validation
+ * const errors = await validateShape(
+ *   { status: 200, name: "test" },
+ *   { status: 200, name: (value) => typeof value === 'string' }
+ * )
+ *
+ * // Nested validation
+ * const errors = await validateShape(
+ *   { user: { id: 123, name: "John" } },
+ *   { user: { id: 123, name: (value) => value.length > 0 } }
+ * )
+ * ```
+ */
+export declare function validateShape(data: unknown, shapeAssertion: ShapeAssertion, basePath?: string): Promise<ValidationErrorDetail[]>;
+/**
+ * Create a shape validator function for common validation patterns
+ *
+ * @param validatorFn - Function that returns true if value is valid
+ * @param errorMessage - Custom error message for validation failures
+ * @returns Shape validator function
+ *
+ * @example
+ * ```typescript
+ * const emailValidator = createShapeValidator(
+ *   (value) => typeof value === 'string' && value.includes('@'),
+ *   'Must be a valid email address'
+ * )
+ *
+ * const errors = await validateShape(
+ *   { email: 'invalid-email' },
+ *   { email: emailValidator }
+ * )
+ * ```
+ */
+export declare function createShapeValidator(validatorFn: (value: unknown) => boolean, errorMessage: string): (value: unknown) => boolean;
+/**
+ * Common shape validators for typical validation scenarios
+ */
+export declare const ShapeValidators: {
+    /**
+     * Validates that a value is a non-empty string
+     */
+    readonly nonEmptyString: (value: unknown) => boolean;
+    /**
+     * Validates that a value is a positive number
+     */
+    readonly positiveNumber: (value: unknown) => boolean;
+    /**
+     * Validates that a value is a non-empty array
+     */
+    readonly nonEmptyArray: (value: unknown) => boolean;
+    /**
+     * Validates that a value exists (not null or undefined)
+     */
+    readonly exists: (value: unknown) => value is {};
+    /**
+     * Creates a validator for string length constraints
+     */
+    readonly stringLength: (min: number, max?: number) => (value: unknown) => boolean;
+    /**
+     * Creates a validator for numeric range constraints
+     */
+    readonly numberRange: (min: number, max: number) => (value: unknown) => boolean;
+    /**
+     * Creates a validator that checks if value matches one of the allowed values
+     */
+    readonly oneOf: <T>(...allowedValues: T[]) => (value: unknown) => value is T;
+};
+//# sourceMappingURL=shape-validator.d.ts.map

package/dist/types/api-request/schema-validation/internal/shape-validator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shape-validator.d.ts","sourceRoot":"","sources":["../../../../../src/api-request/schema-validation/internal/shape-validator.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,qBAAqB,EAAE,cAAc,EAAE,MAAM,UAAU,CAAA;AAErE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,wBAAsB,aAAa,CACjC,IAAI,EAAE,OAAO,EACb,cAAc,EAAE,cAAc,EAC9B,QAAQ,SAAK,GACZ,OAAO,CAAC,qBAAqB,EAAE,CAAC,CA+DlC;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,oBAAoB,CAClC,WAAW,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,OAAO,EACxC,YAAY,EAAE,MAAM,GACnB,CAAC,KAAK,EAAE,OAAO,KAAK,OAAO,CAQ7B;AAED;;GAEG;AACH,eAAO,MAAM,eAAe;IAC1B;;OAEG;qCACqB,OAAO;IAG/B;;OAEG;qCACqB,OAAO;IAE/B;;OAEG;oCACoB,OAAO;IAE9B;;OAEG;6BACa,OAAO;IAEvB;;OAEG;iCACiB,MAAM,QAAQ,MAAM,aAAa,OAAO;IAO5D;;OAEG;gCACgB,MAAM,OAAO,MAAM,aAAa,OAAO;IAK1D;;OAEG;qBAEA,CAAC,oBAAoB,CAAC,EAAE,aACjB,OAAO,KAAG,KAAK,IAAI,CAAC;CAGtB,CAAA"}

package/dist/types/api-request/schema-validation/internal/validation-engine.d.ts

@@ -0,0 +1,63 @@
+/**
+ * Advanced Schema Validation Engine
+ *
+ * This module provides comprehensive validation for JSON Schema objects with support for:
+ * - Complex schema patterns (anyOf, oneOf, allOf)
+ * - Required field validation
+ * - Property-level validation
+ * - Nested schema validation
+ * - AJV integration with caching
+ *
+ * @module ValidationEngine
+ */
+import type { ValidationErrorDetail } from '../types';
+/**
+ * Main validation function with comprehensive anyOf/oneOf support
+ *
+ * This is the primary entry point for complex JSON Schema validation.
+ * It orchestrates all validation steps:
+ * 1. Basic structure validation (type checking)
+ * 2. Required field validation
+ * 3. Property-level validation with complex constraint support
+ *
+ * @param data - Data to validate against the schema
+ * @param schema - JSON Schema object with validation rules
+ * @param fullSpec - Complete schema specification for reference resolution
+ * @returns Array of validation errors (empty array means valid)
+ *
+ * @example
+ * ```typescript
+ * const schema = {
+ *   type: 'object',
+ *   required: ['name'],
+ *   properties: {
+ *     name: { type: 'string' },
+ *     age: { anyOf: [{ type: 'number' }, { type: 'null' }] }
+ *   }
+ * }
+ *
+ * const errors = validateWithAnyOfSupport(data, schema)
+ * if (errors.length === 0) {
+ *   console.log('Data is valid!')
+ * }
+ * ```
+ */
+export declare function validateWithAnyOfSupport(data: unknown, schema: any): ValidationErrorDetail[];
+/**
+ * Helper function to create detailed validation error objects
+ *
+ * @param path - JSON path to the invalid property
+ * @param message - Human-readable error description
+ * @param expected - Expected value or type
+ * @param actual - Actual value or type that failed validation
+ * @returns Standardized validation error object
+ */
+export declare function createValidationError(path: string, message: string, expected: unknown, actual: unknown): ValidationErrorDetail;
+/**
+ * Helper function to format validation errors for logging
+ *
+ * @param errors - Array of validation errors
+ * @returns Formatted error summary string
+ */
+export declare function formatValidationErrors(errors: ValidationErrorDetail[]): string;
+//# sourceMappingURL=validation-engine.d.ts.map

package/dist/types/api-request/schema-validation/internal/validation-engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation-engine.d.ts","sourceRoot":"","sources":["../../../../../src/api-request/schema-validation/internal/validation-engine.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,UAAU,CAAA;AA0VrD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,wBAAgB,wBAAwB,CACtC,IAAI,EAAE,OAAO,EAEb,MAAM,EAAE,GAAG,GACV,qBAAqB,EAAE,CAsBzB;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,sBAAsB,CACpC,MAAM,EAAE,qBAAqB,EAAE,GAC9B,MAAM,CAWR"}

package/dist/types/api-request/schema-validation/types.d.ts

@@ -0,0 +1,92 @@
+/** Schema validation types for API request responses */
+import type { ZodSchema } from 'zod';
+import type { ApiRequestResponse } from '../api-request';
+/** Supported schema formats */
+export type SupportedSchema = object | ZodSchema | string;
+/** Validation mode - throw errors or return results */
+export type ValidationMode = 'throw' | 'return';
+/** Shape validation function for custom assertions */
+export type ShapeValidator<T = unknown> = (value: T) => boolean | void;
+/** Shape validation object with nested assertions */
+export type ShapeAssertion = {
+    [key: string]: unknown | ShapeValidator | ShapeAssertion;
+};
+/** Options for validateSchema method */
+export type ValidateSchemaOptions = {
+    /** Custom shape assertions to run alongside schema validation */
+    shape?: ShapeAssertion;
+    /** Validation mode - 'throw' (default) or 'return' */
+    mode?: ValidationMode;
+    /** Enable UI mode display for this validation */
+    uiMode?: boolean;
+    /** For OpenAPI schemas - target specific path (interchangeable with endpoint) */
+    path?: string;
+    /** For OpenAPI schemas - target specific endpoint (interchangeable with path) */
+    endpoint?: string;
+    /** For OpenAPI schemas - target specific HTTP method */
+    method?: string;
+    /** For OpenAPI schemas - target specific status code */
+    status?: number;
+};
+/** Validation error details */
+export type ValidationErrorDetail = {
+    /** JSON path to the error location */
+    path: string;
+    /** Error message */
+    message: string;
+    /** Expected value or constraint */
+    expected?: unknown;
+    /** Actual value that failed validation */
+    actual?: unknown;
+};
+/** Validation result details */
+export type ValidationResult = {
+    /** Whether validation passed */
+    success: boolean;
+    /** List of validation errors (empty if success) */
+    errors: ValidationErrorDetail[];
+    /** Schema format that was used */
+    schemaFormat: 'JSON Schema' | 'Zod Schema' | 'YAML OpenAPI' | 'JSON OpenAPI';
+    /** Validation execution time in milliseconds */
+    validationTime: number;
+    /** The actual schema used for validation (for debugging) */
+    schema?: object;
+    /** UI display data if uiMode is enabled */
+    uiData?: {
+        statusIcon: '✅' | '❌';
+        validationSummary: string;
+        schemaInfo: string;
+        errorDetails?: string[];
+    };
+};
+/** Enhanced API response with validation result */
+export type ValidatedApiResponse<T = unknown> = ApiRequestResponse<T> & {
+    /** Validation result details */
+    validationResult: ValidationResult;
+    /** Original response before validation */
+    originalResponse: ApiRequestResponse<T>;
+};
+/** Validation error thrown when schema validation fails */
+export declare class ValidationError extends Error {
+    readonly validationResult: ValidationResult;
+    readonly requestContext?: {
+        method: string;
+        path: string;
+        body?: unknown;
+        headers?: Record<string, string>;
+    } | undefined;
+    readonly responseContext?: {
+        status: number;
+        body: unknown;
+    } | undefined;
+    constructor(message: string, validationResult: ValidationResult, requestContext?: {
+        method: string;
+        path: string;
+        body?: unknown;
+        headers?: Record<string, string>;
+    } | undefined, responseContext?: {
+        status: number;
+        body: unknown;
+    } | undefined);
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types/api-request/schema-validation/types.d.ts.map

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

package/dist/types/api-request/ui-display.d.ts

@@ -0,0 +1,42 @@
+/**
+ * UI display functionality for API requests
+ * Adapted from pw-api-plugin to provide rich visual feedback in Playwright UI
+ */
+import { type Page } from '@playwright/test';
+/** Request data interface for UI display */
+export interface RequestDataInterface {
+    url: string;
+    method: string;
+    headers?: object;
+    data?: any;
+    params?: object;
+    otherOptions?: object;
+    validationInfo?: {
+        schemaFormat: string;
+        validationTime: number;
+        success: boolean;
+        errorCount: number;
+    };
+}
+/** Response data interface for UI display */
+export interface ResponseDataInterface {
+    status: number;
+    statusClass: string;
+    statusText: string;
+    headers?: object;
+    body?: any;
+    duration?: number;
+    validationResult?: {
+        icon: '✅' | '❌';
+        summary: string;
+        schemaInfo: string;
+        errors?: string[];
+        schema?: object;
+    };
+}
+/**
+ * Adds an API card to the UI by updating the page content with the provided request and response data.
+ * Only works when a page context is available (UI tests)
+ */
+export declare const addApiCardToUI: (requestData: RequestDataInterface, responseData: ResponseDataInterface, page?: Page, uiMode?: boolean) => Promise<void>;
+//# sourceMappingURL=ui-display.d.ts.map

package/dist/types/api-request/ui-display.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ui-display.d.ts","sourceRoot":"","sources":["../../../src/api-request/ui-display.ts"],"names":[],"mappings":"AACA;;;GAGG;AAEH,OAAO,EAAQ,KAAK,IAAI,EAAE,MAAM,kBAAkB,CAAA;AAGlD,4CAA4C;AAC5C,MAAM,WAAW,oBAAoB;IACnC,GAAG,EAAE,MAAM,CAAA;IACX,MAAM,EAAE,MAAM,CAAA;IACd,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,IAAI,CAAC,EAAE,GAAG,CAAA;IACV,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,cAAc,CAAC,EAAE;QACf,YAAY,EAAE,MAAM,CAAA;QACpB,cAAc,EAAE,MAAM,CAAA;QACtB,OAAO,EAAE,OAAO,CAAA;QAChB,UAAU,EAAE,MAAM,CAAA;KACnB,CAAA;CACF;AAED,6CAA6C;AAC7C,MAAM,WAAW,qBAAqB;IACpC,MAAM,EAAE,MAAM,CAAA;IACd,WAAW,EAAE,MAAM,CAAA;IACnB,UAAU,EAAE,MAAM,CAAA;IAClB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,IAAI,CAAC,EAAE,GAAG,CAAA;IACV,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,gBAAgB,CAAC,EAAE;QACjB,IAAI,EAAE,GAAG,GAAG,GAAG,CAAA;QACf,OAAO,EAAE,MAAM,CAAA;QACf,UAAU,EAAE,MAAM,CAAA;QAClB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAA;QACjB,MAAM,CAAC,EAAE,MAAM,CAAA;KAChB,CAAA;CACF;AAED;;;GAGG;AACH,eAAO,MAAM,cAAc,GACzB,aAAa,oBAAoB,EACjC,cAAc,qBAAqB,EACnC,OAAO,IAAI,EACX,SAAS,OAAO,KACf,OAAO,CAAC,IAAI,CAgCd,CAAA"}

package/dist/types/auth-session/apply-user-cookies-to-browser-context.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Utility to apply user authentication to a browser context
+ *
+ * This utility takes a user's token and applies it to a browser context
+ * without persisting it to disk, making it ideal for ephemeral test users.
+ */
+import type { BrowserContext } from '@playwright/test';
+/**
+ * Apply a user's authentication token to a browser context
+ * Uses the auth provider to extract and apply cookies to a browser context
+ *
+ * @param context The browser context to apply the auth token to
+ * @param tokenData The storage state object or user data containing the token
+ * @returns The context with auth applied
+ */
+export declare function applyUserCookiesToBrowserContext(context: BrowserContext, tokenData: Record<string, unknown>): Promise<BrowserContext>;
+//# sourceMappingURL=apply-user-cookies-to-browser-context.d.ts.map