@seontechnologies/playwright-utils 3.10.0

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

@@ -0,0 +1,341 @@
+"use strict";
+/**
+ * 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
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.processSchema = processSchema;
+const file_loader_1 = require("./file-loader");
+const openapi_handler_1 = require("./openapi-handler");
+const validation_engine_1 = require("./validation-engine");
+/**
+ * Maximum input size for validation (1MB)
+ */
+const MAX_INPUT_SIZE = 1024 * 1024;
+/**
+ * Validates input data before processing to prevent DoS attacks
+ *
+ * @param data - Input data to validate
+ * @throws Error if input is invalid or too large
+ */
+function validateInput(data) {
+    if (data === null || data === undefined) {
+        throw new Error('Input cannot be null or undefined');
+    }
+    try {
+        const serialized = JSON.stringify(data);
+        if (serialized.length > MAX_INPUT_SIZE) {
+            throw new Error(`Input too large for validation (${serialized.length} bytes, max: ${MAX_INPUT_SIZE})`);
+        }
+    }
+    catch (error) {
+        if (error instanceof Error && error.message.includes('circular')) {
+            throw new Error('Input contains circular references and cannot be validated');
+        }
+        throw error;
+    }
+}
+/**
+ * Standardized error transformation utility
+ *
+ * @param error - Raw error from validation library
+ * @param schemaType - Type of schema that produced the error
+ * @param path - Path context for the error
+ * @returns Standardized validation error
+ */
+function createStandardValidationError(error, schemaType, path = 'root') {
+    if (error instanceof Error) {
+        return {
+            path,
+            message: `${schemaType} validation failed: ${error.message}`,
+            expected: 'valid data',
+            actual: 'invalid'
+        };
+    }
+    return {
+        path,
+        message: `${schemaType} validation failed: Unknown error`,
+        expected: 'valid data',
+        actual: 'invalid'
+    };
+}
+/**
+ * AJV instance cache for schema compilation with memory management
+ */
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+const ajvInstanceCache = new Map();
+const MAX_AJV_INSTANCE_CACHE_SIZE = 50;
+/**
+ * Get or create cached AJV instance for specs with components
+ */
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+function getAjvInstance(fullSpec) {
+    if (!fullSpec?.components) {
+        return getDefaultAjv();
+    }
+    // Create a stable cache key from components
+    const cacheKey = JSON.stringify(fullSpec.components);
+    if (!ajvInstanceCache.has(cacheKey)) {
+        // Implement LRU-style eviction if cache is too large
+        if (ajvInstanceCache.size >= MAX_AJV_INSTANCE_CACHE_SIZE) {
+            const firstKey = ajvInstanceCache.keys().next().value;
+            if (firstKey) {
+                ajvInstanceCache.delete(firstKey);
+            }
+        }
+        try {
+            // eslint-disable-next-line @typescript-eslint/no-var-requires
+            const Ajv = require('ajv');
+            ajvInstanceCache.set(cacheKey, new Ajv({
+                strict: false,
+                schemas: [fullSpec]
+            }));
+        }
+        catch {
+            throw new Error('AJV is required for JSON Schema validation. Install with: npm install ajv');
+        }
+    }
+    return ajvInstanceCache.get(cacheKey);
+}
+/**
+ * Creates a default AJV instance
+ */
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+function getDefaultAjv() {
+    try {
+        // eslint-disable-next-line @typescript-eslint/no-var-requires
+        const Ajv = require('ajv');
+        return new Ajv({
+            allErrors: true,
+            verbose: true,
+            strict: false
+        });
+    }
+    catch {
+        throw new Error('AJV is required for JSON Schema validation. Install with: npm install ajv');
+    }
+}
+/**
+ * Validate data against JSON Schema
+ */
+function validateWithJsonSchema(data, schema, fullSpec) {
+    // Check if schema has anyOf/oneOf at the property level
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    const schemaObj = schema;
+    const hasAnyOfProperties = schemaObj.properties &&
+        Object.values(schemaObj.properties).some(
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        (prop) => prop?.anyOf || prop?.oneOf);
+    if (hasAnyOfProperties) {
+        // Handle anyOf/oneOf validation manually for better control
+        return (0, validation_engine_1.validateWithAnyOfSupport)(data, schema);
+    }
+    // Standard validation for schemas without anyOf/oneOf
+    const ajvInstance = getAjvInstance(fullSpec);
+    const validate = ajvInstance.compile(schema);
+    const valid = validate(data);
+    if (valid) {
+        return [];
+    }
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    return (validate.errors || []).map((error) => ({
+        path: error.instancePath || error.schemaPath || 'root',
+        message: error.message || 'Validation failed',
+        expected: error.schema,
+        actual: error.data
+    }));
+}
+/**
+ * Validate data against Zod Schema
+ */
+function validateWithZodSchema(data, 
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+schema) {
+    try {
+        // Lazy load Zod only when needed
+        try {
+            // eslint-disable-next-line @typescript-eslint/no-var-requires
+            require('zod');
+        }
+        catch {
+            throw new Error('Zod is required for Zod schema validation. Install with: npm install zod');
+        }
+        schema.parse(data);
+        return [];
+    }
+    catch (error) {
+        // Try to access ZodError for error handling
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        let ZodError = null;
+        try {
+            // eslint-disable-next-line @typescript-eslint/no-var-requires
+            const zod = require('zod');
+            ZodError = zod.ZodError;
+        }
+        catch {
+            // Zod not available, handle gracefully
+        }
+        if (ZodError && error instanceof ZodError) {
+            // Handle both Zod v3 and v4 compatibility
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
+            const issues = error.issues;
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
+            return issues.map((zodError) => ({
+                path: zodError.path.join('.') || 'root',
+                message: zodError.message,
+                expected: zodError.code,
+                actual: 'invalid'
+            }));
+        }
+        return [
+            {
+                path: 'root',
+                message: error instanceof Error ? error.message : 'Unknown validation error',
+                expected: 'valid data',
+                actual: 'invalid'
+            }
+        ];
+    }
+}
+/**
+ * File-based schema processor (JSON/YAML files)
+ */
+class FileSchemaProcessor {
+    async validate(data, schema, options) {
+        try {
+            // Security: Validate input before processing
+            validateInput(data);
+        }
+        catch (error) {
+            return {
+                validationErrors: [
+                    createStandardValidationError(error, 'File Schema', 'input')
+                ],
+                processedSchema: {},
+                schemaForResult: undefined
+            };
+        }
+        const loadedSchema = await (0, file_loader_1.loadSchemaFromFile)(schema);
+        // Check if it's an OpenAPI file
+        const schemaObj = loadedSchema;
+        const isOpenApi = schemaObj.openapi || schemaObj.swagger;
+        if (isOpenApi) {
+            const targetPath = options.path || options.endpoint;
+            const processedSchema = (0, openapi_handler_1.extractOpenApiSchema)(schemaObj, targetPath, options.method, options.status);
+            const validationErrors = validateWithJsonSchema(data, processedSchema, schemaObj);
+            return {
+                validationErrors,
+                processedSchema,
+                schemaForResult: processedSchema
+            };
+        }
+        else {
+            // Regular JSON Schema file
+            const validationErrors = validateWithJsonSchema(data, loadedSchema);
+            return {
+                validationErrors,
+                processedSchema: loadedSchema,
+                schemaForResult: loadedSchema
+            };
+        }
+    }
+}
+/**
+ * Zod schema processor
+ */
+class ZodSchemaProcessor {
+    async validate(data, schema, 
+    // eslint-disable-next-line @typescript-eslint/no-unused-vars
+    options) {
+        try {
+            // Security: Validate input before processing
+            validateInput(data);
+        }
+        catch (error) {
+            return {
+                validationErrors: [
+                    createStandardValidationError(error, 'Zod Schema', 'input')
+                ],
+                processedSchema: {},
+                schemaForResult: undefined
+            };
+        }
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        const zodSchema = schema;
+        const validationErrors = validateWithZodSchema(data, zodSchema);
+        return {
+            validationErrors,
+            processedSchema: zodSchema,
+            schemaForResult: { type: 'ZodSchema', shape: 'See Zod definition' }
+        };
+    }
+}
+/**
+ * OpenAPI object processor
+ */
+class OpenApiSchemaProcessor {
+    async validate(data, schema, options) {
+        // Security: Validate input before processing
+        validateInput(data);
+        const openApiSpec = schema;
+        const targetPath = options.path || options.endpoint;
+        const processedSchema = (0, openapi_handler_1.extractOpenApiSchema)(openApiSpec, targetPath, options.method, options.status);
+        const validationErrors = validateWithJsonSchema(data, processedSchema, openApiSpec);
+        return {
+            validationErrors,
+            processedSchema,
+            schemaForResult: processedSchema
+        };
+    }
+}
+/**
+ * JSON Schema object processor
+ */
+class JsonSchemaProcessor {
+    async validate(data, schema, 
+    // eslint-disable-next-line @typescript-eslint/no-unused-vars
+    options) {
+        // Security: Validate input before processing
+        validateInput(data);
+        const processedSchema = schema;
+        const validationErrors = validateWithJsonSchema(data, processedSchema);
+        return {
+            validationErrors,
+            processedSchema,
+            schemaForResult: processedSchema
+        };
+    }
+}
+/**
+ * Schema processor registry
+ */
+const processors = {
+    file: new FileSchemaProcessor(),
+    zod: new ZodSchemaProcessor(),
+    openapi: new OpenApiSchemaProcessor(),
+    json: new JsonSchemaProcessor()
+};
+/**
+ * Convenience function to process any schema type
+ */
+async function processSchema(data, schema, schemaFormat, options = {}) {
+    // Special handling for file paths
+    if (typeof schema === 'string') {
+        return processors.file.validate(data, schema, options);
+    }
+    // Handle object schemas based on format
+    if (schemaFormat === 'JSON OpenAPI') {
+        return processors.openapi.validate(data, schema, options);
+    }
+    else if (schemaFormat === 'Zod Schema') {
+        return processors.zod.validate(data, schema, options);
+    }
+    else {
+        return processors.json.validate(data, schema, options);
+    }
+}
+//# sourceMappingURL=schema-processors.js.map

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

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

package/dist/esm/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/esm/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/esm/api-request/schema-validation/internal/shape-validator.js

@@ -0,0 +1,180 @@
+"use strict";
+/**
+ * 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
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ShapeValidators = void 0;
+exports.validateShape = validateShape;
+exports.createShapeValidator = createShapeValidator;
+/**
+ * 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 } }
+ * )
+ * ```
+ */
+async function validateShape(data, shapeAssertion, basePath = '') {
+    const errors = [];
+    for (const [key, assertion] of Object.entries(shapeAssertion)) {
+        const currentPath = basePath ? `${basePath}.${key}` : key;
+        const dataObj = data;
+        const value = dataObj[key];
+        if (typeof assertion === 'function') {
+            // Shape validator function
+            try {
+                const result = assertion(value);
+                if (result === false) {
+                    errors.push({
+                        path: currentPath,
+                        message: `Shape validation failed for ${key}`,
+                        expected: 'validation to pass',
+                        actual: value
+                    });
+                }
+            }
+            catch (error) {
+                errors.push({
+                    path: currentPath,
+                    message: `Shape validation error: ${error instanceof Error ? error.message : String(error)}`,
+                    expected: 'validation to pass',
+                    actual: value
+                });
+            }
+        }
+        else if (typeof assertion === 'object' &&
+            assertion !== null &&
+            !Array.isArray(assertion)) {
+            // Nested shape assertion
+            if (typeof value === 'object' && value !== null) {
+                const nestedErrors = await validateShape(value, assertion, currentPath);
+                errors.push(...nestedErrors);
+            }
+            else {
+                errors.push({
+                    path: currentPath,
+                    message: 'Expected object for nested shape validation',
+                    expected: 'object',
+                    actual: typeof value
+                });
+            }
+        }
+        else {
+            // Direct value comparison
+            if (value !== assertion) {
+                errors.push({
+                    path: currentPath,
+                    message: `Shape assertion failed: expected ${assertion}, got ${value}`,
+                    expected: assertion,
+                    actual: value
+                });
+            }
+        }
+    }
+    return errors;
+}
+/**
+ * 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 }
+ * )
+ * ```
+ */
+function createShapeValidator(validatorFn, errorMessage) {
+    return (value) => {
+        const isValid = validatorFn(value);
+        if (!isValid) {
+            throw new Error(errorMessage);
+        }
+        return isValid;
+    };
+}
+/**
+ * Common shape validators for typical validation scenarios
+ */
+exports.ShapeValidators = {
+    /**
+     * Validates that a value is a non-empty string
+     */
+    nonEmptyString: (value) => typeof value === 'string' && value.length > 0,
+    /**
+     * Validates that a value is a positive number
+     */
+    positiveNumber: (value) => typeof value === 'number' && value > 0,
+    /**
+     * Validates that a value is a non-empty array
+     */
+    nonEmptyArray: (value) => Array.isArray(value) && value.length > 0,
+    /**
+     * Validates that a value exists (not null or undefined)
+     */
+    exists: (value) => value !== null && value !== undefined,
+    /**
+     * Creates a validator for string length constraints
+     */
+    stringLength: (min, max) => (value) => {
+        if (typeof value !== 'string')
+            return false;
+        if (value.length < min)
+            return false;
+        if (max !== undefined && value.length > max)
+            return false;
+        return true;
+    },
+    /**
+     * Creates a validator for numeric range constraints
+     */
+    numberRange: (min, max) => (value) => {
+        if (typeof value !== 'number')
+            return false;
+        return value >= min && value <= max;
+    },
+    /**
+     * Creates a validator that checks if value matches one of the allowed values
+     */
+    oneOf: (...allowedValues) => (value) => {
+        return allowedValues.includes(value);
+    }
+};
+//# sourceMappingURL=shape-validator.js.map

package/dist/esm/api-request/schema-validation/internal/shape-validator.js.map

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