@mainwp/control 1.0.0

package/dist/validation/schema-validator.js

@@ -0,0 +1,147 @@
+/**
+ * Schema Validator for mainwpcontrol
+ *
+ * AJV-based input validation against ability JSON schemas.
+ * Caches compiled schemas for performance.
+ */
+import AjvModule from 'ajv';
+import { SchemaValidationError } from '../utils/errors.js';
+// Handle ESM default export
+const Ajv = AjvModule.default ?? AjvModule;
+/**
+ * Schema Validator class
+ */
+export class SchemaValidator {
+    ajv;
+    schemaCache = new Map();
+    constructor() {
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        this.ajv = new Ajv({
+            allErrors: true, // Collect all errors, not just first
+            strict: false, // Allow unknown keywords (for ability schema extensions)
+            coerceTypes: true, // Coerce strings to numbers, etc.
+            useDefaults: true, // Apply default values from schema
+        });
+    }
+    /**
+     * Validate input against a JSON schema
+     *
+     * @param input - The input data to validate
+     * @param schema - The JSON schema to validate against
+     * @param schemaId - Optional ID for caching compiled schema
+     * @returns Validation result with any errors
+     */
+    validate(input, schema, schemaId) {
+        const validate = this.getCompiledSchema(schema, schemaId);
+        // Clone input so AJV coerceTypes/useDefaults mutates the clone, not the caller's object
+        const coerced = structuredClone(input);
+        const valid = validate(coerced);
+        if (valid) {
+            return { valid: true, coerced };
+        }
+        const errors = this.formatErrors(validate.errors ?? []);
+        return { valid: false, errors, coerced };
+    }
+    /**
+     * Validate input and throw if invalid
+     *
+     * @param input - The input data to validate
+     * @param schema - The JSON schema to validate against
+     * @param abilityName - Name of the ability (for error message)
+     * @throws SchemaValidationError if validation fails
+     */
+    validateOrThrow(input, schema, abilityName) {
+        const result = this.validate(input, schema, abilityName);
+        if (!result.valid && result.errors) {
+            const errorMessages = result.errors.map((e) => `${e.path}: ${e.message}`).join('; ');
+            throw new SchemaValidationError(`Invalid input for ability "${abilityName}": ${errorMessages}`, result.errors, `Check the ability schema with \`mainwpcontrol abilities info ${abilityName}\` for required fields and types`);
+        }
+        return result;
+    }
+    /**
+     * Check if input would be valid (without detailed errors)
+     */
+    isValid(input, schema, schemaId) {
+        const validate = this.getCompiledSchema(schema, schemaId);
+        return validate(structuredClone(input));
+    }
+    /**
+     * Get or compile schema
+     */
+    getCompiledSchema(schema, schemaId) {
+        // Try cache if ID provided
+        if (schemaId) {
+            const cached = this.schemaCache.get(schemaId);
+            if (cached) {
+                return cached;
+            }
+        }
+        // Compile schema
+        const compiled = this.ajv.compile(schema);
+        // Cache if ID provided
+        if (schemaId) {
+            this.schemaCache.set(schemaId, compiled);
+        }
+        return compiled;
+    }
+    /**
+     * Format AJV errors into structured errors
+     */
+    formatErrors(ajvErrors) {
+        return ajvErrors.map((error) => ({
+            path: error.instancePath || '/',
+            message: this.formatErrorMessage(error),
+            keyword: error.keyword,
+            params: error.params,
+        }));
+    }
+    /**
+     * Format a single error into a human-readable message
+     */
+    formatErrorMessage(error) {
+        switch (error.keyword) {
+            case 'required':
+                return `Missing required property: ${error.params['missingProperty']}`;
+            case 'type':
+                return `Expected ${error.params['type']}, got ${typeof error.data}`;
+            case 'enum':
+                return `Must be one of: ${error.params['allowedValues'].join(', ')}`;
+            case 'minLength':
+                return `Must be at least ${error.params['limit']} characters`;
+            case 'maxLength':
+                return `Must be at most ${error.params['limit']} characters`;
+            case 'minimum':
+                return `Must be >= ${error.params['limit']}`;
+            case 'maximum':
+                return `Must be <= ${error.params['limit']}`;
+            case 'pattern':
+                return `Must match pattern: ${error.params['pattern']}`;
+            case 'format':
+                return `Must be a valid ${error.params['format']}`;
+            case 'additionalProperties':
+                return `Unknown property: ${error.params['additionalProperty']}`;
+            default:
+                return error.message ?? 'Validation failed';
+        }
+    }
+    /**
+     * Clear the schema cache
+     */
+    clearCache() {
+        this.schemaCache.clear();
+    }
+}
+/**
+ * Singleton instance
+ */
+let instance = null;
+/**
+ * Get the schema validator singleton
+ */
+export function getSchemaValidator() {
+    if (!instance) {
+        instance = new SchemaValidator();
+    }
+    return instance;
+}
+//# sourceMappingURL=schema-validator.js.map

package/dist/validation/schema-validator.js.map

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