@memberjunction/react-linter 0.0.1 → 5.38.0

package/dist/schema-validation/semantic-validators/semantic-validator.d.ts

@@ -0,0 +1,260 @@
+/**
+ * Semantic Validator
+ *
+ * Abstract base class for all semantic validators.
+ * Semantic validators implement business logic for validating prop values at lint-time.
+ * They check semantic correctness beyond type checking (e.g., field names exist on entities).
+ *
+ * Key Concepts:
+ * - **Validators = Code**: Implemented as TypeScript classes
+ * - **Constraints = Metadata**: Declared in component spec JSON
+ * - **Separation**: Validator logic is separate from constraint definitions
+ *
+ * Example:
+ * ```typescript
+ * // Validator implementation (code)
+ * class SubsetOfEntityFieldsValidator extends SemanticValidator {
+ *   validate(context, constraint) {
+ *     // Implementation...
+ *   }
+ * }
+ *
+ * // Constraint definition (metadata in spec JSON)
+ * {
+ *   "type": "subset-of-entity-fields",
+ *   "dependsOn": "entityName"
+ * }
+ * ```
+ */
+import { PropertyConstraint, ConstraintViolation } from '@memberjunction/interactive-component-types';
+import { ValidationContext } from './validation-context.js';
+import { DynamicValue } from '../../prop-value-extractor.js';
+/**
+ * Abstract base class for semantic validators
+ *
+ * All semantic validators must extend this class and implement the validate() method.
+ */
+export declare abstract class SemanticValidator {
+    /**
+     * Validate a prop value against a constraint
+     *
+     * This is the main method that subclasses must implement.
+     * It receives the validation context and constraint definition,
+     * and returns an array of violations (empty if valid).
+     *
+     * Note: Changed from async to sync since validators perform no actual I/O.
+     * This allows seamless integration with the synchronous linter architecture.
+     *
+     * @param context - Validation context with prop value, component spec, entities, etc.
+     * @param constraint - The constraint definition from the component spec
+     * @returns Array of violations (empty if valid)
+     *
+     * @example
+     * ```typescript
+     * class MyValidator extends SemanticValidator {
+     *   validate(context: ValidationContext, constraint: PropertyConstraint): ConstraintViolation[] {
+     *     const violations: ConstraintViolation[] = [];
+     *
+     *     // Check if value can be validated statically
+     *     if (PropValueExtractor.isDynamicValue(context.propertyValue)) {
+     *       return violations; // Skip - can't validate dynamic values
+     *     }
+     *
+     *     // Perform validation logic
+     *     // ...
+     *
+     *     return violations;
+     *   }
+     * }
+     * ```
+     */
+    abstract validate(context: ValidationContext, constraint: PropertyConstraint): ConstraintViolation[];
+    /**
+     * Get the name of this validator
+     *
+     * Used for debugging and error messages.
+     * Defaults to the class name, but can be overridden.
+     *
+     * @returns Validator name
+     */
+    getName(): string;
+    /**
+     * Get a description of what this validator checks
+     *
+     * Used for documentation and error messages.
+     * Should be a brief, user-friendly description.
+     *
+     * @returns Validator description
+     *
+     * @example
+     * ```typescript
+     * getDescription() {
+     *   return "Validates that array elements are valid field names for the specified entity";
+     * }
+     * ```
+     */
+    abstract getDescription(): string;
+    /**
+     * Check if a value is dynamic (can't be validated statically)
+     *
+     * Dynamic values include identifiers (variables) and expressions (function calls, etc.)
+     * that can't be resolved at lint-time.
+     *
+     * @param value - The extracted value to check
+     * @returns True if the value is dynamic
+     *
+     * @example
+     * ```typescript
+     * if (this.isDynamicValue(context.propertyValue)) {
+     *   return []; // Skip validation
+     * }
+     * ```
+     */
+    protected isDynamicValue(value: any): value is DynamicValue;
+    /**
+     * Create a violation with consistent formatting
+     *
+     * Helper method to create ConstraintViolation objects with common fields populated.
+     *
+     * @param type - Violation type (e.g., 'invalid-field', 'type-mismatch')
+     * @param message - Error message
+     * @param severity - Severity level (default: 'high')
+     * @param suggestion - Optional fix suggestion
+     * @param metadata - Optional additional metadata
+     * @returns ConstraintViolation object
+     *
+     * @example
+     * ```typescript
+     * return [
+     *   this.createViolation(
+     *     'invalid-field',
+     *     `Field '${field}' does not exist on entity '${entityName}'`,
+     *     'critical',
+     *     `Use one of: ${validFields.join(', ')}`,
+     *     { field, entityName, validFields }
+     *   )
+     * ];
+     * ```
+     */
+    protected createViolation(type: string, message: string, severity?: 'critical' | 'high' | 'medium' | 'low', suggestion?: string, metadata?: Record<string, any>): ConstraintViolation;
+    /**
+     * Get the dependent prop value
+     *
+     * If the constraint has a `dependsOn` field, this method retrieves
+     * the value of that dependent prop from sibling props.
+     *
+     * Returns null if:
+     * - No dependency is specified
+     * - The dependent prop is not found
+     * - The dependent prop has a dynamic value
+     *
+     * @param context - Validation context
+     * @param constraint - Constraint definition
+     * @returns The dependent prop value, or null if not available
+     *
+     * @example
+     * ```typescript
+     * // Constraint: { type: 'subset-of-entity-fields', dependsOn: 'entityName' }
+     * const entityName = this.getDependentPropValue(context, constraint);
+     * if (!entityName) {
+     *   // Can't validate - entityName not provided or is dynamic
+     *   return [];
+     * }
+     * ```
+     */
+    protected getDependentPropValue(context: ValidationContext, constraint: PropertyConstraint): any;
+    /**
+     * Format a list of values for error messages
+     *
+     * Truncates long lists with "..." and formats values nicely.
+     *
+     * @param values - Array of values
+     * @param maxItems - Maximum items to show (default: 10)
+     * @returns Formatted string
+     *
+     * @example
+     * ```typescript
+     * const fields = ['FirstName', 'LastName', 'Email', ...]; // 50 fields
+     * const formatted = this.formatValueList(fields, 5);
+     * // => "FirstName, LastName, Email, Status, JoinDate... (45 more)"
+     * ```
+     */
+    protected formatValueList(values: any[], maxItems?: number): string;
+    /**
+     * Apply custom error template
+     *
+     * If the constraint has an `errorTemplate`, applies it by replacing
+     * template variables with actual values.
+     *
+     * Template variables:
+     * - {property} - Property name from context
+     * - {value} - Property value from context
+     * - {constraint} - Constraint type
+     * - Custom variables from templateVars parameter
+     *
+     * @param constraint - Constraint definition
+     * @param context - Validation context
+     * @param defaultMessage - Default message to use if no template
+     * @param templateVars - Additional template variables
+     * @returns Formatted message
+     *
+     * @example
+     * ```typescript
+     * // Constraint: { errorTemplate: "Field '{field}' not found on {entityName}" }
+     * const message = this.applyErrorTemplate(
+     *   constraint,
+     *   context,
+     *   `Field '${field}' does not exist`,
+     *   { field: 'FullName', entityName: 'Members' }
+     * );
+     * // => "Field 'FullName' not found on Members"
+     * ```
+     */
+    protected applyErrorTemplate(constraint: PropertyConstraint, context: ValidationContext, defaultMessage: string, templateVars?: Record<string, any>): string;
+    /**
+     * Calculate Levenshtein distance between two strings
+     *
+     * Used for finding similar field names for "Did you mean?" suggestions.
+     *
+     * @param a - First string
+     * @param b - Second string
+     * @returns Edit distance
+     */
+    protected levenshteinDistance(a: string, b: string): number;
+    /**
+     * Find similar strings using Levenshtein distance
+     *
+     * Returns strings sorted by similarity (most similar first).
+     *
+     * @param target - The target string to find matches for
+     * @param candidates - Array of candidate strings
+     * @param maxResults - Maximum number of results (default: 3)
+     * @param maxDistance - Maximum edit distance to consider (default: 3)
+     * @returns Array of similar strings, sorted by distance
+     *
+     * @example
+     * ```typescript
+     * const fields = ['FirstName', 'LastName', 'Email', 'Status'];
+     * const similar = this.findSimilar('FristName', fields, 2);
+     * // => ['FirstName'] (edit distance 1)
+     * ```
+     */
+    protected findSimilar(target: string, candidates: string[], maxResults?: number, maxDistance?: number): string[];
+    /**
+     * Case-insensitive string comparison
+     *
+     * @param a - First string
+     * @param b - Second string
+     * @returns True if strings are equal (case-insensitive)
+     */
+    protected equalsCaseInsensitive(a: string, b: string): boolean;
+    /**
+     * Check if array contains value (case-insensitive for strings)
+     *
+     * @param arr - Array to search
+     * @param value - Value to find
+     * @returns True if array contains the value
+     */
+    protected includesCaseInsensitive(arr: string[], value: string): boolean;
+}
+//# sourceMappingURL=semantic-validator.d.ts.map

package/dist/schema-validation/semantic-validators/semantic-validator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"semantic-validator.d.ts","sourceRoot":"","sources":["../../../src/schema-validation/semantic-validators/semantic-validator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAEH,OAAO,EACL,kBAAkB,EAClB,mBAAmB,EACpB,MAAM,6CAA6C,CAAC;AACrD,OAAO,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AACzD,OAAO,EAAsB,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAE9E;;;;GAIG;AACH,8BAAsB,iBAAiB;IACrC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAgCG;IACH,QAAQ,CAAC,QAAQ,CACf,OAAO,EAAE,iBAAiB,EAC1B,UAAU,EAAE,kBAAkB,GAC7B,mBAAmB,EAAE;IAExB;;;;;;;OAOG;IACH,OAAO,IAAI,MAAM;IAIjB;;;;;;;;;;;;;;OAcG;IACH,QAAQ,CAAC,cAAc,IAAI,MAAM;IAMjC;;;;;;;;;;;;;;;OAeG;IACH,SAAS,CAAC,cAAc,CAAC,KAAK,EAAE,GAAG,GAAG,KAAK,IAAI,YAAY;IAI3D;;;;;;;;;;;;;;;;;;;;;;;;OAwBG;IACH,SAAS,CAAC,eAAe,CACvB,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,EACf,QAAQ,GAAE,UAAU,GAAG,MAAM,GAAG,QAAQ,GAAG,KAAc,EACzD,UAAU,CAAC,EAAE,MAAM,EACnB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAC7B,mBAAmB;IAUtB;;;;;;;;;;;;;;;;;;;;;;;;OAwBG;IACH,SAAS,CAAC,qBAAqB,CAC7B,OAAO,EAAE,iBAAiB,EAC1B,UAAU,EAAE,kBAAkB,GAC7B,GAAG;IAkBN;;;;;;;;;;;;;;;OAeG;IACH,SAAS,CAAC,eAAe,CAAC,MAAM,EAAE,GAAG,EAAE,EAAE,QAAQ,GAAE,MAAW,GAAG,MAAM;IAcvE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA6BG;IACH,SAAS,CAAC,kBAAkB,CAC1B,UAAU,EAAE,kBAAkB,EAC9B,OAAO,EAAE,iBAAiB,EAC1B,cAAc,EAAE,MAAM,EACtB,YAAY,GAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAM,GACrC,MAAM;IAwBT;;;;;;;;OAQG;IACH,SAAS,CAAC,mBAAmB,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM;IA+B3D;;;;;;;;;;;;;;;;;OAiBG;IACH,SAAS,CAAC,WAAW,CACnB,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,MAAM,EAAE,EACpB,UAAU,GAAE,MAAU,EACtB,WAAW,GAAE,MAAU,GACtB,MAAM,EAAE;IAYX;;;;;;OAMG;IACH,SAAS,CAAC,qBAAqB,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,OAAO;IAI9D;;;;;;OAMG;IACH,SAAS,CAAC,uBAAuB,CAAC,GAAG,EAAE,MAAM,EAAE,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO;CAGzE"}

package/dist/schema-validation/semantic-validators/semantic-validator.js

@@ -0,0 +1,301 @@
+/**
+ * Semantic Validator
+ *
+ * Abstract base class for all semantic validators.
+ * Semantic validators implement business logic for validating prop values at lint-time.
+ * They check semantic correctness beyond type checking (e.g., field names exist on entities).
+ *
+ * Key Concepts:
+ * - **Validators = Code**: Implemented as TypeScript classes
+ * - **Constraints = Metadata**: Declared in component spec JSON
+ * - **Separation**: Validator logic is separate from constraint definitions
+ *
+ * Example:
+ * ```typescript
+ * // Validator implementation (code)
+ * class SubsetOfEntityFieldsValidator extends SemanticValidator {
+ *   validate(context, constraint) {
+ *     // Implementation...
+ *   }
+ * }
+ *
+ * // Constraint definition (metadata in spec JSON)
+ * {
+ *   "type": "subset-of-entity-fields",
+ *   "dependsOn": "entityName"
+ * }
+ * ```
+ */
+import { PropValueExtractor } from '../../prop-value-extractor.js';
+/**
+ * Abstract base class for semantic validators
+ *
+ * All semantic validators must extend this class and implement the validate() method.
+ */
+export class SemanticValidator {
+    /**
+     * Get the name of this validator
+     *
+     * Used for debugging and error messages.
+     * Defaults to the class name, but can be overridden.
+     *
+     * @returns Validator name
+     */
+    getName() {
+        return this.constructor.name;
+    }
+    // ============================================================================
+    // Protected Helper Methods
+    // ============================================================================
+    /**
+     * Check if a value is dynamic (can't be validated statically)
+     *
+     * Dynamic values include identifiers (variables) and expressions (function calls, etc.)
+     * that can't be resolved at lint-time.
+     *
+     * @param value - The extracted value to check
+     * @returns True if the value is dynamic
+     *
+     * @example
+     * ```typescript
+     * if (this.isDynamicValue(context.propertyValue)) {
+     *   return []; // Skip validation
+     * }
+     * ```
+     */
+    isDynamicValue(value) {
+        return PropValueExtractor.isDynamicValue(value);
+    }
+    /**
+     * Create a violation with consistent formatting
+     *
+     * Helper method to create ConstraintViolation objects with common fields populated.
+     *
+     * @param type - Violation type (e.g., 'invalid-field', 'type-mismatch')
+     * @param message - Error message
+     * @param severity - Severity level (default: 'high')
+     * @param suggestion - Optional fix suggestion
+     * @param metadata - Optional additional metadata
+     * @returns ConstraintViolation object
+     *
+     * @example
+     * ```typescript
+     * return [
+     *   this.createViolation(
+     *     'invalid-field',
+     *     `Field '${field}' does not exist on entity '${entityName}'`,
+     *     'critical',
+     *     `Use one of: ${validFields.join(', ')}`,
+     *     { field, entityName, validFields }
+     *   )
+     * ];
+     * ```
+     */
+    createViolation(type, message, severity = 'high', suggestion, metadata) {
+        return {
+            type,
+            message,
+            severity,
+            suggestion,
+            metadata,
+        };
+    }
+    /**
+     * Get the dependent prop value
+     *
+     * If the constraint has a `dependsOn` field, this method retrieves
+     * the value of that dependent prop from sibling props.
+     *
+     * Returns null if:
+     * - No dependency is specified
+     * - The dependent prop is not found
+     * - The dependent prop has a dynamic value
+     *
+     * @param context - Validation context
+     * @param constraint - Constraint definition
+     * @returns The dependent prop value, or null if not available
+     *
+     * @example
+     * ```typescript
+     * // Constraint: { type: 'subset-of-entity-fields', dependsOn: 'entityName' }
+     * const entityName = this.getDependentPropValue(context, constraint);
+     * if (!entityName) {
+     *   // Can't validate - entityName not provided or is dynamic
+     *   return [];
+     * }
+     * ```
+     */
+    getDependentPropValue(context, constraint) {
+        if (!constraint.dependsOn) {
+            return null;
+        }
+        const dependentValue = context.siblingProps.get(constraint.dependsOn);
+        if (!dependentValue) {
+            return null;
+        }
+        if (this.isDynamicValue(dependentValue)) {
+            return null;
+        }
+        return dependentValue;
+    }
+    /**
+     * Format a list of values for error messages
+     *
+     * Truncates long lists with "..." and formats values nicely.
+     *
+     * @param values - Array of values
+     * @param maxItems - Maximum items to show (default: 10)
+     * @returns Formatted string
+     *
+     * @example
+     * ```typescript
+     * const fields = ['FirstName', 'LastName', 'Email', ...]; // 50 fields
+     * const formatted = this.formatValueList(fields, 5);
+     * // => "FirstName, LastName, Email, Status, JoinDate... (45 more)"
+     * ```
+     */
+    formatValueList(values, maxItems = 10) {
+        if (values.length === 0) {
+            return '(none)';
+        }
+        if (values.length <= maxItems) {
+            return values.map((v) => `'${v}'`).join(', ');
+        }
+        const shown = values.slice(0, maxItems).map((v) => `'${v}'`);
+        const remaining = values.length - maxItems;
+        return `${shown.join(', ')}... (${remaining} more)`;
+    }
+    /**
+     * Apply custom error template
+     *
+     * If the constraint has an `errorTemplate`, applies it by replacing
+     * template variables with actual values.
+     *
+     * Template variables:
+     * - {property} - Property name from context
+     * - {value} - Property value from context
+     * - {constraint} - Constraint type
+     * - Custom variables from templateVars parameter
+     *
+     * @param constraint - Constraint definition
+     * @param context - Validation context
+     * @param defaultMessage - Default message to use if no template
+     * @param templateVars - Additional template variables
+     * @returns Formatted message
+     *
+     * @example
+     * ```typescript
+     * // Constraint: { errorTemplate: "Field '{field}' not found on {entityName}" }
+     * const message = this.applyErrorTemplate(
+     *   constraint,
+     *   context,
+     *   `Field '${field}' does not exist`,
+     *   { field: 'FullName', entityName: 'Members' }
+     * );
+     * // => "Field 'FullName' not found on Members"
+     * ```
+     */
+    applyErrorTemplate(constraint, context, defaultMessage, templateVars = {}) {
+        if (!constraint.errorTemplate) {
+            return defaultMessage;
+        }
+        let message = constraint.errorTemplate;
+        // Standard variables
+        const vars = {
+            property: context.propertyName,
+            value: PropValueExtractor.describe(context.propertyValue),
+            constraint: constraint.type,
+            ...templateVars,
+        };
+        // Replace template variables
+        for (const [key, value] of Object.entries(vars)) {
+            const regex = new RegExp(`\\{${key}\\}`, 'g');
+            message = message.replace(regex, String(value));
+        }
+        return message;
+    }
+    /**
+     * Calculate Levenshtein distance between two strings
+     *
+     * Used for finding similar field names for "Did you mean?" suggestions.
+     *
+     * @param a - First string
+     * @param b - Second string
+     * @returns Edit distance
+     */
+    levenshteinDistance(a, b) {
+        const matrix = [];
+        // Initialize first column
+        for (let i = 0; i <= b.length; i++) {
+            matrix[i] = [i];
+        }
+        // Initialize first row
+        for (let j = 0; j <= a.length; j++) {
+            matrix[0][j] = j;
+        }
+        // Fill matrix
+        for (let i = 1; i <= b.length; i++) {
+            for (let j = 1; j <= a.length; j++) {
+                if (b.charAt(i - 1) === a.charAt(j - 1)) {
+                    matrix[i][j] = matrix[i - 1][j - 1];
+                }
+                else {
+                    matrix[i][j] = Math.min(matrix[i - 1][j - 1] + 1, // substitution
+                    matrix[i][j - 1] + 1, // insertion
+                    matrix[i - 1][j] + 1 // deletion
+                    );
+                }
+            }
+        }
+        return matrix[b.length][a.length];
+    }
+    /**
+     * Find similar strings using Levenshtein distance
+     *
+     * Returns strings sorted by similarity (most similar first).
+     *
+     * @param target - The target string to find matches for
+     * @param candidates - Array of candidate strings
+     * @param maxResults - Maximum number of results (default: 3)
+     * @param maxDistance - Maximum edit distance to consider (default: 3)
+     * @returns Array of similar strings, sorted by distance
+     *
+     * @example
+     * ```typescript
+     * const fields = ['FirstName', 'LastName', 'Email', 'Status'];
+     * const similar = this.findSimilar('FristName', fields, 2);
+     * // => ['FirstName'] (edit distance 1)
+     * ```
+     */
+    findSimilar(target, candidates, maxResults = 3, maxDistance = 3) {
+        const withDistances = candidates
+            .map((candidate) => ({
+            value: candidate,
+            distance: this.levenshteinDistance(target.toLowerCase(), candidate.toLowerCase()),
+        }))
+            .filter((item) => item.distance <= maxDistance)
+            .sort((a, b) => a.distance - b.distance);
+        return withDistances.slice(0, maxResults).map((item) => item.value);
+    }
+    /**
+     * Case-insensitive string comparison
+     *
+     * @param a - First string
+     * @param b - Second string
+     * @returns True if strings are equal (case-insensitive)
+     */
+    equalsCaseInsensitive(a, b) {
+        return a.toLowerCase() === b.toLowerCase();
+    }
+    /**
+     * Check if array contains value (case-insensitive for strings)
+     *
+     * @param arr - Array to search
+     * @param value - Value to find
+     * @returns True if array contains the value
+     */
+    includesCaseInsensitive(arr, value) {
+        return arr.some((item) => this.equalsCaseInsensitive(item, value));
+    }
+}
+//# sourceMappingURL=semantic-validator.js.map

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

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

package/dist/schema-validation/semantic-validators/sql-where-clause-validator.d.ts

@@ -0,0 +1,115 @@
+/**
+ * SQL WHERE Clause Validator
+ *
+ * Validates SQL WHERE clauses for syntax and field references.
+ * Uses SQLParser for accurate AST-based validation with regex fallback.
+ *
+ * This validator is essential for catching errors like:
+ * ```jsx
+ * // ❌ BROKEN - LastModified doesn't exist on Products
+ * <EntityDataGrid
+ *   entityName="Products"
+ *   extraFilter="Status='Active' AND LastModified > '2024-01-01'"
+ * />
+ *
+ * // ✅ FIXED - CreatedAt exists on Products
+ * <EntityDataGrid
+ *   entityName="Products"
+ *   extraFilter="Status='Active' AND CreatedAt > '2024-01-01'"
+ * />
+ * ```
+ *
+ * Validation Levels:
+ * - **Level 1**: Field existence (IMPLEMENTED)
+ * - **Level 2**: Type compatibility (FUTURE)
+ * - **Level 3**: SQL function validation (FUTURE)
+ *
+ * Constraint Definition:
+ * ```json
+ * {
+ *   "type": "sql-where-clause",
+ *   "dependsOn": "entityName",
+ *   "config": {
+ *     "caseSensitive": false
+ *   }
+ * }
+ * ```
+ */
+import { PropertyConstraint, ConstraintViolation } from '@memberjunction/interactive-component-types';
+import { SemanticValidator } from './semantic-validator.js';
+import { ValidationContext } from './validation-context.js';
+/**
+ * Validates SQL WHERE clauses for syntax and field references
+ *
+ * **Depends On**: Entity name (from entityName prop)
+ * **Validates**: SQL WHERE clause string
+ * **Common Use Cases**:
+ * - EntityDataGrid extraFilter prop
+ * - RunView ExtraFilter parameter
+ * - Custom components with SQL filtering
+ *
+ * **Implementation**: Uses SQLParser for accurate AST-based validation
+ * with regex fallback for edge cases.
+ */
+export declare class SqlWhereClauseValidator extends SemanticValidator {
+    /**
+     * SQL keywords that are not field references
+     * Used in regex fallback when AST parsing fails
+     */
+    private static readonly SQL_KEYWORDS;
+    /**
+     * Validate SQL WHERE clause
+     *
+     * @param context - Validation context
+     * @param constraint - Constraint definition
+     * @returns Array of violations (empty if valid)
+     */
+    validate(context: ValidationContext, constraint: PropertyConstraint): ConstraintViolation[];
+    /**
+     * Validate WHERE clause using AST parsing (Level 1: Field existence)
+     *
+     * Uses SQLParser to accurately extract column references.
+     *
+     * @param whereClause - SQL WHERE clause
+     * @param entityName - Entity name for context
+     * @param fieldNames - Valid field names
+     * @param fieldNamesLower - Lowercase field names for case-insensitive matching
+     * @param caseSensitive - Whether to check case sensitivity
+     * @param context - Validation context
+     * @param constraint - Constraint definition
+     * @returns Array of violations
+     */
+    private validateWithAST;
+    /**
+     * Extract column references from SQL AST
+     *
+     * Pattern based on MJQueryEntity.extractColumnReferences (lines 563-590)
+     * Recursively traverses the AST to find all column_ref nodes.
+     *
+     * @param expr - Expression node from AST
+     * @param referencedColumns - Set to collect column names
+     */
+    private extractColumnReferences;
+    /**
+     * Fallback regex-based validation for when SQL parsing fails
+     *
+     * Less accurate than AST parsing but handles edge cases.
+     * Violations from regex fallback have 'high' severity instead of 'critical'
+     * to indicate less certainty.
+     *
+     * @param whereClause - SQL WHERE clause
+     * @param entityName - Entity name for context
+     * @param fieldNames - Valid field names
+     * @param fieldNamesLower - Lowercase field names
+     * @param caseSensitive - Whether to check case sensitivity
+     * @param context - Validation context
+     * @param constraint - Constraint definition
+     * @returns Array of violations
+     */
+    private validateWithRegex;
+    /**
+     * Get validator description
+     */
+    getDescription(): string;
+}
+//# sourceMappingURL=sql-where-clause-validator.d.ts.map

package/dist/schema-validation/semantic-validators/sql-where-clause-validator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sql-where-clause-validator.d.ts","sourceRoot":"","sources":["../../../src/schema-validation/semantic-validators/sql-where-clause-validator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AAEH,OAAO,EACL,kBAAkB,EAClB,mBAAmB,EACpB,MAAM,6CAA6C,CAAC;AAErD,OAAO,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AACzD,OAAO,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AASzD;;;;;;;;;;;;GAYG;AACH,qBACa,uBAAwB,SAAQ,iBAAiB;IAC5D;;;OAGG;IACH,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,YAAY,CAajC;IAEH;;;;;;OAMG;IACH,QAAQ,CACN,OAAO,EAAE,iBAAiB,EAC1B,UAAU,EAAE,kBAAkB,GAC7B,mBAAmB,EAAE;IA0ExB;;;;;;;;;;;;;OAaG;IACH,OAAO,CAAC,eAAe;IAiHvB;;;;;;;;OAQG;IACH,OAAO,CAAC,uBAAuB;IAwD/B;;;;;;;;;;;;;;;OAeG;IACH,OAAO,CAAC,iBAAiB;IA6GzB;;OAEG;IACH,cAAc,IAAI,MAAM;CAGzB"}