@memberjunction/react-test-harness 2.124.0 → 2.125.0

package/dist/lib/constraint-validators/base-constraint-validator.d.ts

@@ -0,0 +1,259 @@
+/**
+ * Base Constraint Validator
+ *
+ * Abstract base class for all constraint validators.
+ * Validators implement business logic for validating prop values at lint-time.
+ *
+ * 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 BaseConstraintValidator {
+ *   async 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';
+import { DynamicValue } from '../prop-value-extractor';
+/**
+ * Abstract base class for constraint validators
+ *
+ * All constraint validators must extend this class and implement the validate() method.
+ */
+export declare abstract class BaseConstraintValidator {
+    /**
+     * 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 BaseConstraintValidator {
+     *   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=base-constraint-validator.d.ts.map

package/dist/lib/constraint-validators/base-constraint-validator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base-constraint-validator.d.ts","sourceRoot":"","sources":["../../../src/lib/constraint-validators/base-constraint-validator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAEH,OAAO,EACL,kBAAkB,EAClB,mBAAmB,EACpB,MAAM,6CAA6C,CAAC;AACrD,OAAO,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AACzD,OAAO,EAAsB,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAE3E;;;;GAIG;AACH,8BAAsB,uBAAuB;IAC3C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;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/lib/constraint-validators/base-constraint-validator.js

@@ -0,0 +1,304 @@
+"use strict";
+/**
+ * Base Constraint Validator
+ *
+ * Abstract base class for all constraint validators.
+ * Validators implement business logic for validating prop values at lint-time.
+ *
+ * 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 BaseConstraintValidator {
+ *   async validate(context, constraint) {
+ *     // Implementation...
+ *   }
+ * }
+ *
+ * // Constraint definition (metadata in spec JSON)
+ * {
+ *   "type": "subset-of-entity-fields",
+ *   "dependsOn": "entityName"
+ * }
+ * ```
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BaseConstraintValidator = void 0;
+const prop_value_extractor_1 = require("../prop-value-extractor");
+/**
+ * Abstract base class for constraint validators
+ *
+ * All constraint validators must extend this class and implement the validate() method.
+ */
+class BaseConstraintValidator {
+    /**
+     * 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 prop_value_extractor_1.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: prop_value_extractor_1.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));
+    }
+}
+exports.BaseConstraintValidator = BaseConstraintValidator;
+//# sourceMappingURL=base-constraint-validator.js.map

package/dist/lib/constraint-validators/base-constraint-validator.js.map

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

package/dist/lib/constraint-validators/index.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Constraint Validators Module
+ *
+ * This module provides the infrastructure for validating component props
+ * against business rules defined in component specifications.
+ *
+ * Validators use MemberJunction's @RegisterClass decorator for automatic discovery.
+ * Each validator is registered with BaseConstraintValidator and its constraint type as the key.
+ *
+ * Key exports:
+ * - BaseConstraintValidator: Abstract base class for all validators
+ * - ValidationContext: Context passed to validators
+ * - Entity/Query metadata types
+ * - Concrete validator implementations (auto-registered via @RegisterClass)
+ */
+export * from './base-constraint-validator';
+export * from './validation-context';
+export * from './subset-of-entity-fields-validator';
+export * from './sql-where-clause-validator';
+export * from './required-when-validator';
+//# sourceMappingURL=index.d.ts.map

package/dist/lib/constraint-validators/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/lib/constraint-validators/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,cAAc,6BAA6B,CAAC;AAC5C,cAAc,sBAAsB,CAAC;AACrC,cAAc,qCAAqC,CAAC;AACpD,cAAc,8BAA8B,CAAC;AAC7C,cAAc,2BAA2B,CAAC"}

package/dist/lib/constraint-validators/index.js

@@ -0,0 +1,37 @@
+"use strict";
+/**
+ * Constraint Validators Module
+ *
+ * This module provides the infrastructure for validating component props
+ * against business rules defined in component specifications.
+ *
+ * Validators use MemberJunction's @RegisterClass decorator for automatic discovery.
+ * Each validator is registered with BaseConstraintValidator and its constraint type as the key.
+ *
+ * Key exports:
+ * - BaseConstraintValidator: Abstract base class for all validators
+ * - ValidationContext: Context passed to validators
+ * - Entity/Query metadata types
+ * - Concrete validator implementations (auto-registered via @RegisterClass)
+ */
+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 __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./base-constraint-validator"), exports);
+__exportStar(require("./validation-context"), exports);
+__exportStar(require("./subset-of-entity-fields-validator"), exports);
+__exportStar(require("./sql-where-clause-validator"), exports);
+__exportStar(require("./required-when-validator"), exports);
+//# sourceMappingURL=index.js.map

package/dist/lib/constraint-validators/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/lib/constraint-validators/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;GAcG;;;;;;;;;;;;;;;;AAEH,8DAA4C;AAC5C,uDAAqC;AACrC,sEAAoD;AACpD,+DAA6C;AAC7C,4DAA0C"}

package/dist/lib/constraint-validators/required-when-validator.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Required-When Constraint Validator
+ *
+ * Validates that a property is present when a specified condition is met.
+ * Used for conditional requirements like "valueField is required when aggregateMethod is 'sum'".
+ *
+ * Config:
+ * - condition: JavaScript expression evaluated with siblingProp as the dependent property value
+ *   Example: "siblingProp === 'sum' || siblingProp === 'average'"
+ *
+ * Example usage in spec JSON:
+ * ```json
+ * {
+ *   "type": "required-when",
+ *   "dependsOn": "aggregateMethod",
+ *   "config": {
+ *     "condition": "siblingProp === 'sum' || siblingProp === 'average' || siblingProp === 'min' || siblingProp === 'max'"
+ *   },
+ *   "errorTemplate": "valueField is required when aggregateMethod is '{aggregateMethod}'"
+ * }
+ * ```
+ */
+import { PropertyConstraint, ConstraintViolation } from '@memberjunction/interactive-component-types';
+import { BaseConstraintValidator } from './base-constraint-validator';
+import { ValidationContext } from './validation-context';
+export declare class RequiredWhenValidator extends BaseConstraintValidator {
+    /**
+     * Get description of this validator
+     */
+    getDescription(): string;
+    /**
+     * Validate that a property is present when a condition is met
+     *
+     * Evaluates a JavaScript condition expression with the dependent property value,
+     * and checks if the current property has a value when the condition is true.
+     *
+     * @param context - Validation context containing property info and sibling props
+     * @param constraint - The constraint definition from the spec
+     * @returns Array of violations (empty if valid)
+     */
+    validate(context: ValidationContext, constraint: PropertyConstraint): ConstraintViolation[];
+}
+//# sourceMappingURL=required-when-validator.d.ts.map