@seontechnologies/playwright-utils 3.10.0

package/dist/cjs/api-request/schema-validation/core.js

@@ -0,0 +1,55 @@
+"use strict";
+/** Core schema validation engine */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.detectSchemaFormat = detectSchemaFormat;
+exports.validateSchema = validateSchema;
+const shape_validator_1 = require("./internal/shape-validator");
+const schema_processors_1 = require("./internal/schema-processors");
+const result_builder_1 = require("./internal/result-builder");
+/** Detect schema format based on input */
+function detectSchemaFormat(schema) {
+    if (typeof schema === 'string') {
+        if (schema.endsWith('.yaml') || schema.endsWith('.yml')) {
+            return 'YAML OpenAPI';
+        }
+        return 'JSON OpenAPI';
+    }
+    if (schema && typeof schema === 'object') {
+        // Check if it's a Zod schema
+        if ('_def' in schema &&
+            typeof schema.parse === 'function') {
+            return 'Zod Schema';
+        }
+        // Check if it's an OpenAPI spec (has 'openapi' or 'swagger' field)
+        if (schema.openapi ||
+            schema.swagger) {
+            return 'JSON OpenAPI';
+        }
+        // Default to JSON Schema
+        return 'JSON Schema';
+    }
+    return 'JSON Schema';
+}
+/** Main validation function using strategy pattern */
+async function validateSchema(data, schema, options = {}) {
+    const startTime = Date.now();
+    try {
+        const schemaFormat = detectSchemaFormat(schema);
+        // Process schema using appropriate strategy
+        const processingResult = await (0, schema_processors_1.processSchema)(data, schema, schemaFormat, options);
+        let { validationErrors } = processingResult;
+        const { schemaForResult } = processingResult;
+        // Add shape validation if provided
+        if (options.shape) {
+            const shapeErrors = await (0, shape_validator_1.validateShape)(data, options.shape);
+            validationErrors = [...validationErrors, ...shapeErrors];
+        }
+        const validationTime = Date.now() - startTime;
+        return (0, result_builder_1.buildValidationResult)(validationErrors, schemaFormat, validationTime, schemaForResult);
+    }
+    catch (error) {
+        const validationTime = Date.now() - startTime;
+        return (0, result_builder_1.buildErrorResult)(error, detectSchemaFormat(schema), validationTime);
+    }
+}
+//# sourceMappingURL=core.js.map

package/dist/cjs/api-request/schema-validation/core.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"core.js","sourceRoot":"","sources":["../../../../src/api-request/schema-validation/core.ts"],"names":[],"mappings":";AAAA,oCAAoC;;AAYpC,gDAgCC;AAGD,wCA6CC;AAxFD,gEAA0D;AAC1D,oEAA4D;AAC5D,8DAGkC;AAElC,0CAA0C;AAC1C,SAAgB,kBAAkB,CAChC,MAAuB;IAEvB,IAAI,OAAO,MAAM,KAAK,QAAQ,EAAE,CAAC;QAC/B,IAAI,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;YACxD,OAAO,cAAc,CAAA;QACvB,CAAC;QACD,OAAO,cAAc,CAAA;IACvB,CAAC;IAED,IAAI,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ,EAAE,CAAC;QACzC,6BAA6B;QAC7B,IACE,MAAM,IAAI,MAAM;YAChB,OAAQ,MAA6C,CAAC,KAAK,KAAK,UAAU,EAC1E,CAAC;YACD,OAAO,YAAY,CAAA;QACrB,CAAC;QAED,mEAAmE;QACnE,IACG,MAAkC,CAAC,OAAO;YAC1C,MAAkC,CAAC,OAAO,EAC3C,CAAC;YACD,OAAO,cAAc,CAAA;QACvB,CAAC;QAED,yBAAyB;QACzB,OAAO,aAAa,CAAA;IACtB,CAAC;IAED,OAAO,aAAa,CAAA;AACtB,CAAC;AAED,sDAAsD;AAC/C,KAAK,UAAU,cAAc,CAClC,IAAa,EACb,MAAuB,EACvB,UAMI,EAAE;IAEN,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAA;IAE5B,IAAI,CAAC;QACH,MAAM,YAAY,GAAG,kBAAkB,CAAC,MAAM,CAAC,CAAA;QAE/C,4CAA4C;QAC5C,MAAM,gBAAgB,GAAG,MAAM,IAAA,iCAAa,EAC1C,IAAI,EACJ,MAAM,EACN,YAAY,EACZ,OAAO,CACR,CAAA;QAED,IAAI,EAAE,gBAAgB,EAAE,GAAG,gBAAgB,CAAA;QAC3C,MAAM,EAAE,eAAe,EAAE,GAAG,gBAAgB,CAAA;QAE5C,mCAAmC;QACnC,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC;YAClB,MAAM,WAAW,GAAG,MAAM,IAAA,+BAAa,EAAC,IAAI,EAAE,OAAO,CAAC,KAAK,CAAC,CAAA;YAC5D,gBAAgB,GAAG,CAAC,GAAG,gBAAgB,EAAE,GAAG,WAAW,CAAC,CAAA;QAC1D,CAAC;QAED,MAAM,cAAc,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,CAAA;QAE7C,OAAO,IAAA,sCAAqB,EAC1B,gBAAgB,EAChB,YAAY,EACZ,cAAc,EACd,eAAe,CAChB,CAAA;IACH,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,cAAc,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,CAAA;QAC7C,OAAO,IAAA,iCAAgB,EAAC,KAAK,EAAE,kBAAkB,CAAC,MAAM,CAAC,EAAE,cAAc,CAAC,CAAA;IAC5E,CAAC;AACH,CAAC"}

package/dist/cjs/api-request/schema-validation/fixture.d.ts

@@ -0,0 +1,20 @@
+import type { SupportedSchema, ValidateSchemaOptions, ValidationResult } from './types';
+/**
+ * Fixture that provides the validateSchema function for schema validation
+ */
+export declare const test: import("@playwright/test").TestType<import("@playwright/test").PlaywrightTestArgs & import("@playwright/test").PlaywrightTestOptions & {
+    /**
+     * Validates data against a schema with optional shape assertions
+     *
+     * @example
+     * test('validate response schema', async ({ validateSchema }) => {
+     *   const response = await fetch('/api/data')
+     *   const data = await response.json()
+     *
+     *   const validated = await validateSchema(MySchema, data)
+     *   expect(validated.status).toBe(200)
+     * })
+     */
+    validateSchema: (schema: SupportedSchema, data: unknown, options?: ValidateSchemaOptions) => Promise<ValidationResult>;
+}, import("@playwright/test").PlaywrightWorkerArgs & import("@playwright/test").PlaywrightWorkerOptions>;
+//# sourceMappingURL=fixture.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"fixture.d.ts","sourceRoot":"","sources":["../../../../src/api-request/schema-validation/fixture.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,eAAe,EACf,qBAAqB,EACrB,gBAAgB,EACjB,MAAM,SAAS,CAAA;AAEhB;;GAEG;AACH,eAAO,MAAM,IAAI;IACf;;;;;;;;;;;OAWG;oBACa,CACd,MAAM,EAAE,eAAe,EACvB,IAAI,EAAE,OAAO,EACb,OAAO,CAAC,EAAE,qBAAqB,KAC5B,OAAO,CAAC,gBAAgB,CAAC;wGAa9B,CAAA"}

package/dist/cjs/api-request/schema-validation/fixture.js

@@ -0,0 +1,17 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.test = void 0;
+const test_1 = require("@playwright/test");
+const core_1 = require("./core");
+/**
+ * Fixture that provides the validateSchema function for schema validation
+ */
+exports.test = test_1.test.extend({
+    validateSchema: async ({}, use) => {
+        const validateSchema = async (schema, data, options) => {
+            return await (0, core_1.validateSchema)(data, schema, options);
+        };
+        await use(validateSchema);
+    }
+});
+//# sourceMappingURL=fixture.js.map

package/dist/cjs/api-request/schema-validation/fixture.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fixture.js","sourceRoot":"","sources":["../../../../src/api-request/schema-validation/fixture.ts"],"names":[],"mappings":";;;AAAA,2CAA+C;AAC/C,iCAAiE;AAOjE;;GAEG;AACU,QAAA,IAAI,GAAG,WAAI,CAAC,MAAM,CAkB5B;IACD,cAAc,EAAE,KAAK,EAAE,EAAE,EAAE,GAAG,EAAE,EAAE;QAChC,MAAM,cAAc,GAAG,KAAK,EAC1B,MAAuB,EACvB,IAAa,EACb,OAA+B,EACJ,EAAE;YAC7B,OAAO,MAAM,IAAA,qBAAsB,EAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,CAAA;QAC5D,CAAC,CAAA;QAED,MAAM,GAAG,CAAC,cAAc,CAAC,CAAA;IAC3B,CAAC;CACF,CAAC,CAAA"}

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

@@ -0,0 +1,6 @@
+/** Schema validation exports */
+export { validateSchema, detectSchemaFormat } from './core';
+export type { SupportedSchema, ValidationMode, ShapeValidator, ShapeAssertion, ValidateSchemaOptions, ValidationErrorDetail, ValidationResult, ValidatedApiResponse } from './types';
+export { ValidationError } from './types';
+export { test } from './fixture';
+//# sourceMappingURL=index.d.ts.map

package/dist/cjs/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/cjs/api-request/schema-validation/index.js

@@ -0,0 +1,13 @@
+"use strict";
+/** Schema validation exports */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.test = exports.ValidationError = exports.detectSchemaFormat = exports.validateSchema = void 0;
+var core_1 = require("./core");
+Object.defineProperty(exports, "validateSchema", { enumerable: true, get: function () { return core_1.validateSchema; } });
+Object.defineProperty(exports, "detectSchemaFormat", { enumerable: true, get: function () { return core_1.detectSchemaFormat; } });
+var types_1 = require("./types");
+Object.defineProperty(exports, "ValidationError", { enumerable: true, get: function () { return types_1.ValidationError; } });
+// Export the validateSchema fixture
+var fixture_1 = require("./fixture");
+Object.defineProperty(exports, "test", { enumerable: true, get: function () { return fixture_1.test; } });
+//# sourceMappingURL=index.js.map

package/dist/cjs/api-request/schema-validation/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/api-request/schema-validation/index.ts"],"names":[],"mappings":";AAAA,gCAAgC;;;AAEhC,+BAA2D;AAAlD,sGAAA,cAAc,OAAA;AAAE,0GAAA,kBAAkB,OAAA;AAW3C,iCAAyC;AAAhC,wGAAA,eAAe,OAAA;AAExB,oCAAoC;AACpC,qCAAgC;AAAvB,+FAAA,IAAI,OAAA"}

package/dist/cjs/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/cjs/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/cjs/api-request/schema-validation/internal/file-loader.js

@@ -0,0 +1,126 @@
+"use strict";
+/**
+ * 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
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.loadSchemaFromFile = loadSchemaFromFile;
+exports.isValidSchemaFile = isValidSchemaFile;
+exports.getAllowedExtensions = getAllowedExtensions;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const yaml = __importStar(require("js-yaml"));
+/**
+ * Allowed file extensions for schema files
+ */
+const ALLOWED_EXTENSIONS = ['.json', '.yaml', '.yml'];
+/**
+ * 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+)
+ */
+async function loadSchemaFromFile(filePath) {
+    try {
+        const resolvedPath = path.resolve(filePath);
+        // Security: Validate file extensions to prevent loading arbitrary files
+        const fileExtension = path.extname(filePath).toLowerCase();
+        if (!ALLOWED_EXTENSIONS.includes(fileExtension)) {
+            throw new Error(`Invalid file extension: ${fileExtension}. Allowed: ${ALLOWED_EXTENSIONS.join(', ')}`);
+        }
+        // Check if file exists
+        if (!fs.existsSync(resolvedPath)) {
+            throw new Error(`Schema file not found: ${resolvedPath}`);
+        }
+        // Read file content
+        const content = fs.readFileSync(resolvedPath, 'utf8');
+        // Parse based on file extension
+        if (filePath.endsWith('.yaml') || filePath.endsWith('.yml')) {
+            // Security: yaml.load() is safe by default in js-yaml v4+ (no code execution)
+            return yaml.load(content);
+        }
+        else {
+            return JSON.parse(content);
+        }
+    }
+    catch (error) {
+        throw new Error(`Failed to load schema file: ${error instanceof Error ? error.message : String(error)}`);
+    }
+}
+/**
+ * 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
+ */
+function isValidSchemaFile(filePath) {
+    const fileExtension = path.extname(filePath).toLowerCase();
+    return ALLOWED_EXTENSIONS.includes(fileExtension);
+}
+/**
+ * Get the list of allowed file extensions for schema files
+ *
+ * @returns Array of allowed file extensions
+ */
+function getAllowedExtensions() {
+    return ALLOWED_EXTENSIONS;
+}
+//# sourceMappingURL=file-loader.js.map

package/dist/cjs/api-request/schema-validation/internal/file-loader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-loader.js","sourceRoot":"","sources":["../../../../../src/api-request/schema-validation/internal/file-loader.ts"],"names":[],"mappings":";AAAA;;;;;;;GAOG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAsCH,gDAoCC;AAQD,8CAKC;AAOD,oDAEC;AA9FD,uCAAwB;AACxB,2CAA4B;AAC5B,8CAA+B;AAE/B;;GAEG;AACH,MAAM,kBAAkB,GAAG,CAAC,OAAO,EAAE,OAAO,EAAE,MAAM,CAAU,CAAA;AAE9D;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACI,KAAK,UAAU,kBAAkB,CAAC,QAAgB;IACvD,IAAI,CAAC;QACH,MAAM,YAAY,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAA;QAE3C,wEAAwE;QACxE,MAAM,aAAa,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,WAAW,EAAE,CAAA;QAC1D,IACE,CAAC,kBAAkB,CAAC,QAAQ,CAC1B,aAAoD,CACrD,EACD,CAAC;YACD,MAAM,IAAI,KAAK,CACb,2BAA2B,aAAa,cAAc,kBAAkB,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CACtF,CAAA;QACH,CAAC;QAED,uBAAuB;QACvB,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,YAAY,CAAC,EAAE,CAAC;YACjC,MAAM,IAAI,KAAK,CAAC,0BAA0B,YAAY,EAAE,CAAC,CAAA;QAC3D,CAAC;QAED,oBAAoB;QACpB,MAAM,OAAO,GAAG,EAAE,CAAC,YAAY,CAAC,YAAY,EAAE,MAAM,CAAC,CAAA;QAErD,gCAAgC;QAChC,IAAI,QAAQ,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,QAAQ,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;YAC5D,8EAA8E;YAC9E,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,CAAW,CAAA;QACrC,CAAC;aAAM,CAAC;YACN,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAA;QAC5B,CAAC;IACH,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,IAAI,KAAK,CACb,+BAA+B,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CACxF,CAAA;IACH,CAAC;AACH,CAAC;AAED;;;;;GAKG;AACH,SAAgB,iBAAiB,CAAC,QAAgB;IAChD,MAAM,aAAa,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,WAAW,EAAE,CAAA;IAC1D,OAAO,kBAAkB,CAAC,QAAQ,CAChC,aAAoD,CACrD,CAAA;AACH,CAAC;AAED;;;;GAIG;AACH,SAAgB,oBAAoB;IAClC,OAAO,kBAAkB,CAAA;AAC3B,CAAC"}

package/dist/cjs/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/cjs/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/cjs/api-request/schema-validation/internal/openapi-handler.js

@@ -0,0 +1,147 @@
+"use strict";
+/**
+ * OpenAPI Schema Handler
+ *
+ * This module handles OpenAPI specification parsing, schema extraction,
+ * and $ref resolution for API response validation.
+ *
+ * @module OpenApiHandler
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveOpenApiRef = resolveOpenApiRef;
+exports.extractOpenApiSchema = extractOpenApiSchema;
+const internal_1 = require("../../../internal");
+/**
+ * Fallback schema when extraction fails or no endpoint specified
+ */
+const FALLBACK_SCHEMA = {
+    type: 'object',
+    properties: {
+        status: { type: 'number' },
+        data: { type: 'object' }
+    },
+    required: ['status']
+};
+/**
+ * Validate OpenAPI specification structure
+ *
+ * @param openApiSpec - OpenAPI specification object to validate
+ * @throws Error if specification is invalid
+ */
+function validateOpenApiSpec(openApiSpec) {
+    if (!openApiSpec || typeof openApiSpec !== 'object') {
+        throw new Error('Invalid OpenAPI specification: must be a non-null object');
+    }
+    const paths = openApiSpec.paths;
+    if (!paths || typeof paths !== 'object') {
+        throw new Error('Invalid OpenAPI specification: missing or invalid "paths" object');
+    }
+}
+/**
+ * Find path definition in OpenAPI spec, handling parameterized paths
+ *
+ * @param paths - Paths object from OpenAPI spec
+ * @param endpoint - Endpoint path to find
+ * @returns Path definition object
+ * @throws Error if path not found
+ */
+function findPathDefinition(paths, endpoint) {
+    const pathDef = paths[endpoint] || paths[endpoint.replace(/\{[^}]+\}/g, '{id}')];
+    if (!pathDef) {
+        throw new Error(`Endpoint ${endpoint} not found in OpenAPI spec`);
+    }
+    return pathDef;
+}
+/**
+ * Extract response schema from method definition
+ *
+ * @param methodDef - Method definition from OpenAPI spec
+ * @param status - HTTP status code
+ * @returns Schema object or undefined
+ */
+function extractResponseSchema(methodDef, status) {
+    const responses = methodDef.responses;
+    const statusKey = String(status);
+    const responseDef = responses[statusKey] || responses['default'];
+    if (!responseDef) {
+        return undefined;
+    }
+    const content = responseDef.content;
+    const jsonContent = content?.['application/json'];
+    return jsonContent?.schema;
+}
+/**
+ * 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
+ */
+function resolveOpenApiRef(ref, openApiSpec) {
+    if (!ref.startsWith('#/')) {
+        throw new Error(`External references not supported: ${ref}`);
+    }
+    const pathParts = ref.substring(2).split('/');
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    let current = openApiSpec;
+    for (const part of pathParts) {
+        current = current[part];
+        if (!current) {
+            throw new Error(`Reference not found: ${ref}`);
+        }
+    }
+    // Return the full resolved schema, preserving anyOf/oneOf structures
+    return current;
+}
+/**
+ * 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
+ * ```
+ */
+function extractOpenApiSchema(openApiSpec, endpoint, method, status = 200) {
+    // Early return for missing endpoint/method
+    if (!endpoint || !method) {
+        return FALLBACK_SCHEMA;
+    }
+    try {
+        validateOpenApiSpec(openApiSpec);
+        const paths = openApiSpec.paths;
+        const pathDef = findPathDefinition(paths, endpoint);
+        const methodDef = pathDef[method.toLowerCase()];
+        if (!methodDef) {
+            throw new Error(`Method ${method} not found for endpoint ${endpoint}`);
+        }
+        let schema = extractResponseSchema(methodDef, status);
+        // Resolve $ref if present
+        if (schema && typeof schema === 'object' && '$ref' in schema) {
+            const ref = schema['$ref'];
+            schema = resolveOpenApiRef(ref, openApiSpec);
+        }
+        return schema || FALLBACK_SCHEMA;
+    }
+    catch (error) {
+        void (0, internal_1.getLogger)().warning(`OpenAPI schema extraction failed: ${error instanceof Error ? error.message : String(error)}`);
+        return FALLBACK_SCHEMA;
+    }
+}
+//# sourceMappingURL=openapi-handler.js.map

package/dist/cjs/api-request/schema-validation/internal/openapi-handler.js.map

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

package/dist/cjs/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/cjs/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/cjs/api-request/schema-validation/internal/promise-extension.js

@@ -0,0 +1,14 @@
+"use strict";
+/** Promise extension to add validateSchema method to promises */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createEnhancedPromise = createEnhancedPromise;
+/** Create enhanced promise with validateSchema method */
+function createEnhancedPromise(promise) {
+    const enhanced = promise;
+    enhanced.validateSchema = async (schema, options = {}) => {
+        const response = await promise;
+        return response.validateSchema(schema, options);
+    };
+    return enhanced;
+}
+//# sourceMappingURL=promise-extension.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"promise-extension.js","sourceRoot":"","sources":["../../../../../src/api-request/schema-validation/internal/promise-extension.ts"],"names":[],"mappings":";AAAA,iEAAiE;;AAmBjE,sDAcC;AAfD,yDAAyD;AACzD,SAAgB,qBAAqB,CACnC,OAAwC;IAExC,MAAM,QAAQ,GAAG,OAAgC,CAAA;IAEjD,QAAQ,CAAC,cAAc,GAAG,KAAK,EAC7B,MAAuB,EACvB,UAAiC,EAAE,EACQ,EAAE;QAC7C,MAAM,QAAQ,GAAG,MAAM,OAAO,CAAA;QAC9B,OAAO,QAAQ,CAAC,cAAc,CAAa,MAAM,EAAE,OAAO,CAAC,CAAA;IAC7D,CAAC,CAAA;IAED,OAAO,QAAQ,CAAA;AACjB,CAAC"}

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