@seontechnologies/playwright-utils 3.10.0

package/dist/esm/api-request/api-request.js

@@ -0,0 +1,326 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.apiRequest = exports.ApiNetworkError = exports.ApiRequestError = void 0;
+const test_1 = require("@playwright/test");
+const internal_1 = require("../internal");
+const ui_display_1 = require("./ui-display");
+const response_extension_1 = require("./schema-validation/internal/response-extension");
+const promise_extension_1 = require("./schema-validation/internal/promise-extension");
+/** Custom error type for API request failures */
+class ApiRequestError extends Error {
+    constructor(message, status, response, attempt) {
+        super(message);
+        this.status = status;
+        this.response = response;
+        this.attempt = attempt;
+        this.name = 'ApiRequestError';
+    }
+}
+exports.ApiRequestError = ApiRequestError;
+/** Network-level error for connection issues */
+class ApiNetworkError extends Error {
+    constructor(message, originalError) {
+        super(message);
+        this.originalError = originalError;
+        this.name = 'ApiNetworkError';
+    }
+}
+exports.ApiNetworkError = ApiNetworkError;
+/** Creates a step name for API requests that will appear in the Playwright UI */
+const createStepName = ({ method, path, baseUrl, configBaseUrl = '' }) => {
+    const effectiveBaseUrl = baseUrl || configBaseUrl || '';
+    const fullPath = effectiveBaseUrl
+        ? joinUrlParts(effectiveBaseUrl, path)
+        : path;
+    return `API ${method} ${fullPath}`;
+};
+/** Default retry configuration following Cypress patterns - only retries 5xx server errors, not 4xx client errors */
+const DEFAULT_RETRY_CONFIG = {
+    maxRetries: 3,
+    initialDelayMs: 100,
+    backoffMultiplier: 2,
+    maxDelayMs: 5000,
+    enableJitter: true,
+    retryStatusCodes: [500, 502, 503, 504] // Only 5xx server errors (transient issues), never 4xx client errors
+};
+/**
+ * Sleep for a specified number of milliseconds
+ */
+const sleep = (ms) => new Promise((resolve) => setTimeout(resolve, ms));
+/**
+ * Calculate the delay for a retry attempt with exponential backoff and optional jitter
+ */
+const calculateRetryDelay = (attempt, config) => {
+    const baseDelay = config.initialDelayMs * Math.pow(config.backoffMultiplier, attempt);
+    const clampedDelay = Math.min(baseDelay, config.maxDelayMs);
+    if (config.enableJitter) {
+        // Add random jitter ±25% to prevent thundering herd
+        const jitter = clampedDelay * 0.25 * (Math.random() * 2 - 1);
+        return Math.max(0, clampedDelay + jitter);
+    }
+    return clampedDelay;
+};
+/**
+ * Determine if a status code should trigger a retry
+ */
+const shouldRetry = (status, retryStatusCodes) => {
+    return retryStatusCodes.includes(status);
+};
+/**
+ * Execute API request with retry logic (similar to Cypress)
+ */
+const executeWithRetry = async (requestFn, config, context) => {
+    let lastError;
+    let lastResponse;
+    for (let attempt = 0; attempt <= config.maxRetries; attempt++) {
+        try {
+            const response = await requestFn();
+            // Check if response status should trigger a retry
+            if (attempt < config.maxRetries &&
+                shouldRetry(response.status, config.retryStatusCodes)) {
+                lastResponse = response;
+                const delay = calculateRetryDelay(attempt, config);
+                await (0, internal_1.getLogger)().warning(`${context} returned ${response.status} (attempt ${attempt + 1}/${config.maxRetries + 1}), retrying in ${delay.toFixed(0)}ms`);
+                await sleep(delay);
+                continue;
+            }
+            // Success or non-retryable status code
+            return response;
+        }
+        catch (error) {
+            lastError = error instanceof Error ? error : new Error(String(error));
+            if (attempt === config.maxRetries) {
+                // Final attempt failed with an error
+                throw new ApiNetworkError(`${context} failed after ${config.maxRetries + 1} attempts: ${lastError.message}`, lastError);
+            }
+            const delay = calculateRetryDelay(attempt, config);
+            await (0, internal_1.getLogger)().warning(`${context} failed (attempt ${attempt + 1}/${config.maxRetries + 1}), retrying in ${delay.toFixed(0)}ms: ${lastError.message}`);
+            await sleep(delay);
+        }
+    }
+    // This should not be reached, but if we have a response with retryable status
+    if (lastResponse) {
+        throw new ApiRequestError(`${context} failed with status ${lastResponse.status} after ${config.maxRetries + 1} attempts`, lastResponse.status, lastResponse.body, config.maxRetries + 1);
+    }
+    // Fallback error
+    throw new ApiNetworkError(`${context} failed after ${config.maxRetries + 1} attempts`, lastError);
+};
+/**
+ * Base implementation of API request without test step wrapping
+ */
+const apiRequestBase = async ({ request, method, path, baseUrl, configBaseUrl = '', // configBaseUrl from Playwright config
+body = null, headers, params, uiMode = false, page, retryConfig }) => {
+    // common options; if there's a prop, add it to the options object
+    // Note: Playwright expects 'data' for the request body, not 'body'
+    const options = Object.assign({}, body && { data: body }, // Map 'body' to 'data' for Playwright
+    headers && { headers }, params && { params });
+    // Three-tier URL resolution strategy:
+    // 1. Use explicitly provided baseUrl if available (e.g. baseUrl='https://api.example.com/')
+    // 2. Otherwise fall back to Playwright config's configBaseUrl (e.g. configBaseUrl='https://api-dev.com/')
+    // 3. If neither is available, use empty string
+    const effectiveBaseUrl = baseUrl || configBaseUrl || '';
+    // Combine effectiveBaseUrl with path
+    // When base exists: https://api-dev.com/ + /users = https://api-dev.com/users
+    // When no base: /users = /users
+    const fullUrl = effectiveBaseUrl ? joinUrlParts(effectiveBaseUrl, path) : path;
+    // map methods to PW request functions
+    const methodMap = {
+        POST: () => request.post(fullUrl, options),
+        GET: () => request.get(fullUrl, options),
+        PUT: () => request.put(fullUrl, options),
+        DELETE: () => request.delete(fullUrl, options),
+        PATCH: () => request.patch(fullUrl, options),
+        HEAD: () => request.head(fullUrl, options)
+    };
+    const requestFn = methodMap[method];
+    if (!requestFn)
+        throw new Error(`Unsupported HTTP method: ${method}`);
+    // Merge retry config with defaults
+    const effectiveRetryConfig = { ...DEFAULT_RETRY_CONFIG, ...retryConfig };
+    const context = `${method} ${fullUrl}`;
+    // Define the request execution function for retry logic
+    const executeRequest = async () => {
+        // Execute the request with timing
+        const startTime = Date.now();
+        const response = await requestFn();
+        const duration = Date.now() - startTime;
+        const status = response.status();
+        // Parse response body based on content type
+        const contentType = response.headers()['content-type'] || '';
+        const parseResponseBody = async () => {
+            try {
+                if (contentType.includes('application/json')) {
+                    return await response.json();
+                }
+                else if (contentType.includes('text/')) {
+                    return await response.text();
+                }
+                return null;
+            }
+            catch (err) {
+                await (0, internal_1.getLogger)().warning(`Failed to parse response body for status ${status}: ${err}`);
+                return null;
+            }
+        };
+        const responseBody = await parseResponseBody();
+        // Display UI if uiMode is enabled or environment variable is set
+        if (uiMode || shouldDisplayApiUI()) {
+            await displayApiUI({
+                url: fullUrl,
+                method,
+                headers,
+                data: body,
+                params,
+                response,
+                responseBody,
+                duration,
+                status,
+                page,
+                uiMode
+            });
+        }
+        return { status, body: responseBody };
+    };
+    // Use retry logic by default (like Cypress), only disable if explicitly set to maxRetries: 0
+    if (retryConfig?.maxRetries === 0) {
+        // Explicitly disabled - execute directly without retry
+        return executeRequest();
+    }
+    else {
+        // Default retry behavior (like Cypress) - always retry 5xx errors
+        return executeWithRetry(executeRequest, effectiveRetryConfig, context);
+    }
+};
+/**
+ * Determines if API UI should be displayed based on environment variables
+ */
+const shouldDisplayApiUI = () => {
+    const envUiMode = process.env.API_E2E_UI_MODE;
+    if (envUiMode === 'true')
+        return true;
+    if (envUiMode === 'false')
+        return false;
+    // Default is false unless explicitly enabled
+    return false;
+};
+/**
+ * Display API call information in UI format
+ */
+const displayApiUI = async (params) => {
+    try {
+        const requestData = {
+            url: params.url,
+            method: params.method.toUpperCase(),
+            headers: params.headers,
+            data: params.data,
+            params: params.params
+        };
+        const responseData = {
+            status: params.status,
+            statusClass: Math.floor(params.status / 100) + 'xx',
+            statusText: params.response.statusText(),
+            headers: params.response.headers(),
+            body: params.responseBody,
+            duration: params.duration
+        };
+        await (0, ui_display_1.addApiCardToUI)(requestData, responseData, params.page, params.uiMode);
+    }
+    catch (error) {
+        // Silently fail if UI display doesn't work (e.g., no page context)
+        await (0, internal_1.getLogger)().debug(`UI display failed: ${error}`);
+    }
+};
+/**
+ * Simplified helper for making API requests and returning the status and JSON body.
+ * This helper automatically performs the request based on the provided method, path, body, and headers.
+ * It handles URL construction with proper slash handling and response parsing based on content type.
+ *
+ * @param {Object} params - The parameters for the request.
+ * @param {APIRequestContext} params.request - The Playwright request object, used to make the HTTP request.
+ * @param {string} params.method - The HTTP method to use (POST, GET, PUT, DELETE, PATCH, HEAD).
+ * @param {string} params.path - The path or endpoint to send the request to (e.g., '/api/users').
+ * @param {string} [params.baseUrl] - The base URL to prepend to the path (e.g., 'https://api.example.com').
+ * @param {string} [params.configBaseUrl] - Fallback base URL, typically from Playwright config.
+ * @param {unknown} [params.body=null] - The body to send with the request (for POST, PUT, and PATCH requests).
+ * @param {Record<string, string> | undefined} [params.headers] - The headers to include with the request.
+ * @param {Record<string, string | boolean | number> | undefined} [params.params] - Query parameters to include with the request.
+ * @returns {Promise<ApiRequestResponse<T>>} - An object containing the status code and the parsed response body.
+ *    - `status`: The HTTP status code returned by the server.
+ *    - `body`: The parsed response body from the server, typed as T.
+ *
+ * @example
+ * // GET request with default retry behavior (like Cypress - only retries 5xx server errors)
+ * test('fetch user data', async ({ apiRequest }) => {
+ *   const { status, body } = await apiRequest<UserResponse>({
+ *     method: 'GET',
+ *     url: '/api/users/123',
+ *     headers: { 'Authorization': 'Bearer token' }
+ *     // Automatically retries 500, 502, 503, 504 errors (3 attempts with exponential backoff)
+ *     // Never retries 4xx client errors (400, 401, 403, 404, etc.)
+ *   });
+ *
+ *   expect(status).toBe(200);
+ *   expect(body.name).toBe('John Doe');
+ * });
+ *
+ * @example
+ * // 4xx errors fail immediately without retry (good for idempotency)
+ * test('handle validation error', async ({ apiRequest }) => {
+ *   const { status, body } = await apiRequest({
+ *     method: 'POST',
+ *     url: '/api/users',
+ *     body: { name: '' } // Invalid data
+ *     // 400 Bad Request will NOT be retried - fails fast
+ *   });
+ *
+ *   expect(status).toBe(400);
+ * });
+ *
+ * @example
+ * // Disable retry when testing error scenarios
+ * test('test server error handling', async ({ apiRequest }) => {
+ *   const { status } = await apiRequest({
+ *     method: 'GET',
+ *     url: '/api/fail-endpoint',
+ *     retryConfig: { maxRetries: 0 } // Disable retry to test error handling
+ *   });
+ *
+ *   expect(status).toBe(500);
+ * });
+ */
+const apiRequest = (options) => {
+    // By default, wrap in test.step unless explicitly disabled
+    const useTestStep = options.testStep !== false;
+    const promise = (async () => {
+        let baseResponse;
+        if (useTestStep) {
+            baseResponse = await test_1.test.step(createStepName(options), async () => apiRequestBase(options));
+        }
+        else {
+            // When used outside of test context (e.g., global setup)
+            baseResponse = await apiRequestBase(options);
+        }
+        // Create enhanced response with validateSchema method
+        return (0, response_extension_1.createEnhancedResponse)(baseResponse, {
+            method: options.method,
+            path: options.path,
+            body: options.body,
+            headers: options.headers,
+            page: options.page,
+            uiMode: options.uiMode
+        });
+    })();
+    // Return enhanced promise with validateSchema method
+    return (0, promise_extension_1.createEnhancedPromise)(promise);
+};
+exports.apiRequest = apiRequest;
+/** URL normalization to handle edge cases with slashes */
+const joinUrlParts = (base, path) => {
+    if (!base)
+        return path;
+    // Ensure base has trailing slash and path doesn't have leading slash
+    const normalizedBase = base.endsWith('/') ? base : `${base}/`;
+    const normalizedPath = path.startsWith('/') ? path.substring(1) : path;
+    return `${normalizedBase}${normalizedPath}`;
+};
+//# sourceMappingURL=api-request.js.map

package/dist/esm/api-request/api-request.js.map

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

package/dist/esm/api-request/fixtures.d.ts

@@ -0,0 +1,3 @@
+export { test } from './api-request-fixture';
+export { test as validateSchemaFixture } from './schema-validation/fixture';
+//# sourceMappingURL=fixtures.d.ts.map

package/dist/esm/api-request/fixtures.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fixtures.d.ts","sourceRoot":"","sources":["../../../src/api-request/fixtures.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,IAAI,EAAE,MAAM,uBAAuB,CAAA;AAI5C,OAAO,EAAE,IAAI,IAAI,qBAAqB,EAAE,MAAM,6BAA6B,CAAA"}

package/dist/esm/api-request/fixtures.js

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.validateSchemaFixture = exports.test = void 0;
+// Export only the fixtures
+// Export the test object directly to match import pattern:
+// import { test as apiRequestFixture } from 'playwright-utils/api-request/fixtures';
+var api_request_fixture_1 = require("./api-request-fixture");
+Object.defineProperty(exports, "test", { enumerable: true, get: function () { return api_request_fixture_1.test; } });
+// Also export the validateSchema fixture
+// import { test as validateSchemaFixture } from 'playwright-utils/api-request/fixtures';
+var fixture_1 = require("./schema-validation/fixture");
+Object.defineProperty(exports, "validateSchemaFixture", { enumerable: true, get: function () { return fixture_1.test; } });
+//# sourceMappingURL=fixtures.js.map

package/dist/esm/api-request/fixtures.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fixtures.js","sourceRoot":"","sources":["../../../src/api-request/fixtures.ts"],"names":[],"mappings":";;;AAAA,2BAA2B;AAC3B,2DAA2D;AAC3D,qFAAqF;AACrF,6DAA4C;AAAnC,2GAAA,IAAI,OAAA;AAEb,yCAAyC;AACzC,yFAAyF;AACzF,uDAA2E;AAAlE,gHAAA,IAAI,OAAyB"}

package/dist/esm/api-request/index.d.ts

@@ -0,0 +1,7 @@
+export { apiRequest, type ApiRequestParams, type ApiRequestResponse, type ApiRetryConfig, ApiRequestError, ApiNetworkError } from './api-request';
+export { type ApiRequestFixtureParams } from './api-request-fixture';
+export type { EnhancedApiResponse } from './schema-validation/internal/response-extension';
+export type { EnhancedApiPromise } from './schema-validation/internal/promise-extension';
+export type { SupportedSchema, ValidationMode, ShapeValidator, ShapeAssertion, ValidateSchemaOptions, ValidationErrorDetail, ValidationResult, ValidatedApiResponse } from './schema-validation/types';
+export { ValidationError } from './schema-validation/types';
+//# sourceMappingURL=index.d.ts.map

package/dist/esm/api-request/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/api-request/index.ts"],"names":[],"mappings":"AACA,OAAO,EACL,UAAU,EACV,KAAK,gBAAgB,EACrB,KAAK,kBAAkB,EACvB,KAAK,cAAc,EACnB,eAAe,EACf,eAAe,EAChB,MAAM,eAAe,CAAA;AAGtB,OAAO,EAAE,KAAK,uBAAuB,EAAE,MAAM,uBAAuB,CAAA;AAGpE,YAAY,EAAE,mBAAmB,EAAE,MAAM,iDAAiD,CAAA;AAE1F,YAAY,EAAE,kBAAkB,EAAE,MAAM,gDAAgD,CAAA;AAExF,YAAY,EACV,eAAe,EACf,cAAc,EACd,cAAc,EACd,cAAc,EACd,qBAAqB,EACrB,qBAAqB,EACrB,gBAAgB,EAChB,oBAAoB,EACrB,MAAM,2BAA2B,CAAA;AAElC,OAAO,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAA"}

package/dist/esm/api-request/index.js

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ValidationError = exports.ApiNetworkError = exports.ApiRequestError = exports.apiRequest = void 0;
+// Export core API request functionality and types
+var api_request_1 = require("./api-request");
+Object.defineProperty(exports, "apiRequest", { enumerable: true, get: function () { return api_request_1.apiRequest; } });
+Object.defineProperty(exports, "ApiRequestError", { enumerable: true, get: function () { return api_request_1.ApiRequestError; } });
+Object.defineProperty(exports, "ApiNetworkError", { enumerable: true, get: function () { return api_request_1.ApiNetworkError; } });
+var types_1 = require("./schema-validation/types");
+Object.defineProperty(exports, "ValidationError", { enumerable: true, get: function () { return types_1.ValidationError; } });
+//# sourceMappingURL=index.js.map

package/dist/esm/api-request/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/api-request/index.ts"],"names":[],"mappings":";;;AAAA,kDAAkD;AAClD,6CAOsB;AANpB,yGAAA,UAAU,OAAA;AAIV,8GAAA,eAAe,OAAA;AACf,8GAAA,eAAe,OAAA;AAsBjB,mDAA2D;AAAlD,wGAAA,eAAe,OAAA"}

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

@@ -0,0 +1,13 @@
+/** Core schema validation engine */
+import type { SupportedSchema, ValidationResult, ShapeAssertion } from './types';
+/** Detect schema format based on input */
+export declare function detectSchemaFormat(schema: SupportedSchema): ValidationResult['schemaFormat'];
+/** Main validation function using strategy pattern */
+export declare function validateSchema(data: unknown, schema: SupportedSchema, options?: {
+    shape?: ShapeAssertion;
+    path?: string;
+    endpoint?: string;
+    method?: string;
+    status?: number;
+}): Promise<ValidationResult>;
+//# sourceMappingURL=core.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"core.d.ts","sourceRoot":"","sources":["../../../../src/api-request/schema-validation/core.ts"],"names":[],"mappings":"AAAA,oCAAoC;AAGpC,OAAO,KAAK,EAAE,eAAe,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,SAAS,CAAA;AAQhF,0CAA0C;AAC1C,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,eAAe,GACtB,gBAAgB,CAAC,cAAc,CAAC,CA8BlC;AAED,sDAAsD;AACtD,wBAAsB,cAAc,CAClC,IAAI,EAAE,OAAO,EACb,MAAM,EAAE,eAAe,EACvB,OAAO,GAAE;IACP,KAAK,CAAC,EAAE,cAAc,CAAA;IACtB,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,MAAM,CAAC,EAAE,MAAM,CAAA;CACX,GACL,OAAO,CAAC,gBAAgB,CAAC,CAmC3B"}

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