@memberjunction/react-linter 0.0.1 → 5.38.0

package/dist/schema-validation/index.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Schema Validation Module
+ *
+ * This module provides comprehensive schema validation for interactive components,
+ * including semantic validation of prop values against business rules and constraints.
+ *
+ * Key Components:
+ * - **Semantic Validators**: Check business rules beyond type safety
+ *   (e.g., field names exist on entities, SQL clauses are valid)
+ * - **Validation Context**: Provides access to component spec, entities, queries
+ * - **Validator Registry**: Plugin system for registering custom validators
+ *
+ * Usage:
+ * ```typescript
+ * import { SemanticValidator, ValidationContext } from './schema-validation';
+ *
+ * // Get a validator from the registry
+ * const registry = SemanticValidatorRegistry.getInstance();
+ * const validator = registry.get('subset-of-entity-fields');
+ *
+ * // Run validation
+ * const violations = validator.validate(context, constraint);
+ * ```
+ */
+export * from './semantic-validators/index.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/schema-validation/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/schema-validation/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH,cAAc,uBAAuB,CAAC"}

package/dist/schema-validation/index.js

@@ -0,0 +1,26 @@
+/**
+ * Schema Validation Module
+ *
+ * This module provides comprehensive schema validation for interactive components,
+ * including semantic validation of prop values against business rules and constraints.
+ *
+ * Key Components:
+ * - **Semantic Validators**: Check business rules beyond type safety
+ *   (e.g., field names exist on entities, SQL clauses are valid)
+ * - **Validation Context**: Provides access to component spec, entities, queries
+ * - **Validator Registry**: Plugin system for registering custom validators
+ *
+ * Usage:
+ * ```typescript
+ * import { SemanticValidator, ValidationContext } from './schema-validation';
+ *
+ * // Get a validator from the registry
+ * const registry = SemanticValidatorRegistry.getInstance();
+ * const validator = registry.get('subset-of-entity-fields');
+ *
+ * // Run validation
+ * const violations = validator.validate(context, constraint);
+ * ```
+ */
+export * from './semantic-validators/index.js';
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/schema-validation/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH,cAAc,uBAAuB,CAAC"}

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

@@ -0,0 +1,23 @@
+/**
+ * Semantic Validators Module
+ *
+ * This module provides the infrastructure for semantic validation of component props.
+ * Semantic validators check business rules and constraints beyond basic type checking,
+ * such as verifying field names exist on entities or SQL clauses reference valid columns.
+ *
+ * Validators use MemberJunction's @RegisterClass decorator for automatic discovery.
+ * Each validator is registered with SemanticValidator and its constraint type as the key.
+ *
+ * Key exports:
+ * - SemanticValidator: Abstract base class for all semantic validators
+ * - ValidationContext: Context passed to validators
+ * - Entity/Query metadata types
+ * - Concrete validator implementations (auto-registered via @RegisterClass)
+ */
+export * from './semantic-validator.js';
+export * from './semantic-validator-registry.js';
+export * from './validation-context.js';
+export * from './subset-of-entity-fields-validator.js';
+export * from './sql-where-clause-validator.js';
+export * from './required-when-validator.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/schema-validation/semantic-validators/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,cAAc,sBAAsB,CAAC;AACrC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,sBAAsB,CAAC;AACrC,cAAc,qCAAqC,CAAC;AACpD,cAAc,8BAA8B,CAAC;AAC7C,cAAc,2BAA2B,CAAC"}

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

@@ -0,0 +1,23 @@
+/**
+ * Semantic Validators Module
+ *
+ * This module provides the infrastructure for semantic validation of component props.
+ * Semantic validators check business rules and constraints beyond basic type checking,
+ * such as verifying field names exist on entities or SQL clauses reference valid columns.
+ *
+ * Validators use MemberJunction's @RegisterClass decorator for automatic discovery.
+ * Each validator is registered with SemanticValidator and its constraint type as the key.
+ *
+ * Key exports:
+ * - SemanticValidator: Abstract base class for all semantic validators
+ * - ValidationContext: Context passed to validators
+ * - Entity/Query metadata types
+ * - Concrete validator implementations (auto-registered via @RegisterClass)
+ */
+export * from './semantic-validator.js';
+export * from './semantic-validator-registry.js';
+export * from './validation-context.js';
+export * from './subset-of-entity-fields-validator.js';
+export * from './sql-where-clause-validator.js';
+export * from './required-when-validator.js';
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/schema-validation/semantic-validators/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,cAAc,sBAAsB,CAAC;AACrC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,sBAAsB,CAAC;AACrC,cAAc,qCAAqC,CAAC;AACpD,cAAc,8BAA8B,CAAC;AAC7C,cAAc,2BAA2B,CAAC"}

package/dist/schema-validation/semantic-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 { SemanticValidator } from './semantic-validator.js';
+import { ValidationContext } from './validation-context.js';
+export declare class RequiredWhenValidator extends SemanticValidator {
+    /**
+     * 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

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

@@ -0,0 +1 @@
+{"version":3,"file":"required-when-validator.d.ts","sourceRoot":"","sources":["../../../src/schema-validation/semantic-validators/required-when-validator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,OAAO,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,MAAM,6CAA6C,CAAC;AAEtG,OAAO,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AACzD,OAAO,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAEzD,qBACa,qBAAsB,SAAQ,iBAAiB;IAC1D;;OAEG;IACH,cAAc,IAAI,MAAM;IAIxB;;;;;;;;;OASG;IACH,QAAQ,CAAC,OAAO,EAAE,iBAAiB,EAAE,UAAU,EAAE,kBAAkB,GAAG,mBAAmB,EAAE;CAmD5F"}

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

@@ -0,0 +1,94 @@
+/**
+ * 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}'"
+ * }
+ * ```
+ */
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+import { RegisterClass } from '@memberjunction/global';
+import { SemanticValidator } from './semantic-validator.js';
+let RequiredWhenValidator = class RequiredWhenValidator extends SemanticValidator {
+    /**
+     * Get description of this validator
+     */
+    getDescription() {
+        return 'Validates that a property is present when a specified condition is met based on another property value';
+    }
+    /**
+     * 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, constraint) {
+        const violations = [];
+        if (!constraint.dependsOn) {
+            return violations; // Can't validate without a dependency
+        }
+        const dependentPropValue = context.siblingProps.get(constraint.dependsOn);
+        // If dependent prop doesn't exist, condition doesn't apply
+        if (dependentPropValue === undefined || dependentPropValue === null) {
+            return violations;
+        }
+        const condition = constraint.config?.condition;
+        if (!condition || typeof condition !== 'string') {
+            console.warn(`required-when validator missing condition config for ${context.propertyName}`);
+            return violations;
+        }
+        // Evaluate the condition
+        let conditionMet = false;
+        try {
+            // Create a safe evaluation context
+            const siblingProp = dependentPropValue;
+            // eslint-disable-next-line no-eval
+            conditionMet = eval(condition);
+        }
+        catch (error) {
+            console.error(`Error evaluating required-when condition "${condition}":`, error);
+            return violations;
+        }
+        // If condition is met, check if the property has a value
+        if (conditionMet) {
+            const hasValue = context.propertyValue !== undefined &&
+                context.propertyValue !== null &&
+                context.propertyValue !== '';
+            if (!hasValue) {
+                const message = constraint.errorTemplate
+                    ? constraint.errorTemplate.replace(`{${constraint.dependsOn}}`, String(dependentPropValue))
+                    : `${context.propertyName} is required when ${constraint.dependsOn} is ${dependentPropValue}`;
+                violations.push(this.createViolation('missing-required-prop', message, 'high'));
+            }
+        }
+        return violations;
+    }
+};
+RequiredWhenValidator = __decorate([
+    RegisterClass(SemanticValidator, 'required-when')
+], RequiredWhenValidator);
+export { RequiredWhenValidator };
+//# sourceMappingURL=required-when-validator.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"required-when-validator.js","sourceRoot":"","sources":["../../../src/schema-validation/semantic-validators/required-when-validator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;;;;;;;AAGH,OAAO,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AACvD,OAAO,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAIlD,IAAM,qBAAqB,GAA3B,MAAM,qBAAsB,SAAQ,iBAAiB;IAC1D;;OAEG;IACH,cAAc;QACZ,OAAO,wGAAwG,CAAC;IAClH,CAAC;IAED;;;;;;;;;OASG;IACH,QAAQ,CAAC,OAA0B,EAAE,UAA8B;QACjE,MAAM,UAAU,GAA0B,EAAE,CAAC;QAE7C,IAAI,CAAC,UAAU,CAAC,SAAS,EAAE,CAAC;YAC1B,OAAO,UAAU,CAAC,CAAC,sCAAsC;QAC3D,CAAC;QAED,MAAM,kBAAkB,GAAG,OAAO,CAAC,YAAY,CAAC,GAAG,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC;QAE1E,2DAA2D;QAC3D,IAAI,kBAAkB,KAAK,SAAS,IAAI,kBAAkB,KAAK,IAAI,EAAE,CAAC;YACpE,OAAO,UAAU,CAAC;QACpB,CAAC;QAED,MAAM,SAAS,GAAG,UAAU,CAAC,MAAM,EAAE,SAAS,CAAC;QAC/C,IAAI,CAAC,SAAS,IAAI,OAAO,SAAS,KAAK,QAAQ,EAAE,CAAC;YAChD,OAAO,CAAC,IAAI,CAAC,wDAAwD,OAAO,CAAC,YAAY,EAAE,CAAC,CAAC;YAC7F,OAAO,UAAU,CAAC;QACpB,CAAC;QAED,yBAAyB;QACzB,IAAI,YAAY,GAAG,KAAK,CAAC;QACzB,IAAI,CAAC;YACH,mCAAmC;YACnC,MAAM,WAAW,GAAG,kBAAkB,CAAC;YACvC,mCAAmC;YACnC,YAAY,GAAG,IAAI,CAAC,SAAS,CAAC,CAAC;QACjC,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,CAAC,KAAK,CAAC,6CAA6C,SAAS,IAAI,EAAE,KAAK,CAAC,CAAC;YACjF,OAAO,UAAU,CAAC;QACpB,CAAC;QAED,yDAAyD;QACzD,IAAI,YAAY,EAAE,CAAC;YACjB,MAAM,QAAQ,GAAG,OAAO,CAAC,aAAa,KAAK,SAAS;gBACpC,OAAO,CAAC,aAAa,KAAK,IAAI;gBAC9B,OAAO,CAAC,aAAa,KAAK,EAAE,CAAC;YAE7C,IAAI,CAAC,QAAQ,EAAE,CAAC;gBACd,MAAM,OAAO,GAAG,UAAU,CAAC,aAAa;oBACtC,CAAC,CAAC,UAAU,CAAC,aAAa,CAAC,OAAO,CAAC,IAAI,UAAU,CAAC,SAAS,GAAG,EAAE,MAAM,CAAC,kBAAkB,CAAC,CAAC;oBAC3F,CAAC,CAAC,GAAG,OAAO,CAAC,YAAY,qBAAqB,UAAU,CAAC,SAAS,OAAO,kBAAkB,EAAE,CAAC;gBAEhG,UAAU,CAAC,IAAI,CACb,IAAI,CAAC,eAAe,CAAC,uBAAuB,EAAE,OAAO,EAAE,MAAM,CAAC,CAC/D,CAAC;YACJ,CAAC;QACH,CAAC;QAED,OAAO,UAAU,CAAC;IACpB,CAAC;CACF,CAAA;AArEY,qBAAqB;IADjC,aAAa,CAAC,iBAAiB,EAAE,eAAe,CAAC;GACrC,qBAAqB,CAqEjC"}

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

@@ -0,0 +1,122 @@
+/**
+ * Semantic Validator Registry
+ *
+ * Centralized registry for semantic validators that provides a plugin system
+ * for registering and retrieving validators by their constraint type.
+ *
+ * This registry uses the singleton pattern to ensure validators are only
+ * registered once across the application.
+ *
+ * Usage:
+ * ```typescript
+ * // Get the singleton instance
+ * const registry = SemanticValidatorRegistry.getInstance();
+ *
+ * // Register a custom validator
+ * registry.register(new MyCustomValidator());
+ *
+ * // Retrieve a validator by type
+ * const validator = registry.get('subset-of-entity-fields');
+ * ```
+ *
+ * Built-in validators are automatically registered on first access:
+ * - subset-of-entity-fields
+ * - sql-where-clause
+ * - required-when
+ */
+import { SemanticValidator } from './semantic-validator.js';
+/**
+ * Registry for semantic validators
+ *
+ * Provides plugin system for validation constraints with singleton pattern
+ * to ensure validators are only instantiated once.
+ */
+export declare class SemanticValidatorRegistry {
+    private static instance;
+    private validators;
+    /**
+     * Private constructor to enforce singleton pattern
+     */
+    private constructor();
+    /**
+     * Get the singleton instance of the registry
+     *
+     * @returns The singleton registry instance
+     */
+    static getInstance(): SemanticValidatorRegistry;
+    /**
+     * Register built-in semantic validators
+     *
+     * Called automatically during construction.
+     * Registers the core validators that ship with the linter.
+     */
+    private registerBuiltInValidators;
+    /**
+     * Register a semantic validator
+     *
+     * Validators are keyed by the constraint type they handle.
+     * If a validator for the same type already exists, it will be overridden.
+     *
+     * @param validator - Validator instance to register
+     *
+     * @example
+     * ```typescript
+     * const registry = SemanticValidatorRegistry.getInstance();
+     * registry.register(new MyCustomValidator());
+     * ```
+     */
+    register(validator: SemanticValidator): void;
+    /**
+     * Get validator type from validator instance
+     *
+     * Extracts the constraint type by checking the @RegisterClass metadata.
+     * Falls back to deriving from class name if metadata is not available.
+     *
+     * @param validator - Validator instance
+     * @returns Constraint type string
+     */
+    private getValidatorType;
+    /**
+     * Get a validator by constraint type
+     *
+     * @param type - Constraint type (e.g., 'subset-of-entity-fields')
+     * @returns Validator instance, or undefined if not registered
+     *
+     * @example
+     * ```typescript
+     * const validator = registry.get('subset-of-entity-fields');
+     * if (validator) {
+     *   const violations = validator.validate(context, constraint);
+     * }
+     * ```
+     */
+    get(type: string): SemanticValidator | undefined;
+    /**
+     * Get all registered validators
+     *
+     * @returns Map of constraint type to validator instance
+     *
+     * @example
+     * ```typescript
+     * const allValidators = registry.getAll();
+     * for (const [type, validator] of allValidators) {
+     *   console.log(`${type}: ${validator.getDescription()}`);
+     * }
+     * ```
+     */
+    getAll(): Map<string, SemanticValidator>;
+    /**
+     * Check if a validator is registered for a constraint type
+     *
+     * @param type - Constraint type to check
+     * @returns True if a validator is registered
+     */
+    has(type: string): boolean;
+    /**
+     * Get list of all registered constraint types
+     *
+     * @returns Array of constraint type strings
+     */
+    getTypes(): string[];
+}
+//# sourceMappingURL=semantic-validator-registry.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"semantic-validator-registry.d.ts","sourceRoot":"","sources":["../../../src/schema-validation/semantic-validators/semantic-validator-registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAEH,OAAO,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAKzD;;;;;GAKG;AACH,qBAAa,yBAAyB;IACpC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAA4B;IACnD,OAAO,CAAC,UAAU,CAAiC;IAEnD;;OAEG;IACH,OAAO;IAKP;;;;OAIG;IACH,MAAM,CAAC,WAAW,IAAI,yBAAyB;IAO/C;;;;;OAKG;IACH,OAAO,CAAC,yBAAyB;IAMjC;;;;;;;;;;;;;OAaG;IACH,QAAQ,CAAC,SAAS,EAAE,iBAAiB,GAAG,IAAI;IAQ5C;;;;;;;;OAQG;IACH,OAAO,CAAC,gBAAgB;IAqBxB;;;;;;;;;;;;;OAaG;IACH,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,iBAAiB,GAAG,SAAS;IAIhD;;;;;;;;;;;;OAYG;IACH,MAAM,IAAI,GAAG,CAAC,MAAM,EAAE,iBAAiB,CAAC;IAIxC;;;;;OAKG;IACH,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAI1B;;;;OAIG;IACH,QAAQ,IAAI,MAAM,EAAE;CAGrB"}

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

@@ -0,0 +1,166 @@
+/**
+ * Semantic Validator Registry
+ *
+ * Centralized registry for semantic validators that provides a plugin system
+ * for registering and retrieving validators by their constraint type.
+ *
+ * This registry uses the singleton pattern to ensure validators are only
+ * registered once across the application.
+ *
+ * Usage:
+ * ```typescript
+ * // Get the singleton instance
+ * const registry = SemanticValidatorRegistry.getInstance();
+ *
+ * // Register a custom validator
+ * registry.register(new MyCustomValidator());
+ *
+ * // Retrieve a validator by type
+ * const validator = registry.get('subset-of-entity-fields');
+ * ```
+ *
+ * Built-in validators are automatically registered on first access:
+ * - subset-of-entity-fields
+ * - sql-where-clause
+ * - required-when
+ */
+import { SubsetOfEntityFieldsValidator } from './subset-of-entity-fields-validator.js';
+import { SqlWhereClauseValidator } from './sql-where-clause-validator.js';
+import { RequiredWhenValidator } from './required-when-validator.js';
+/**
+ * Registry for semantic validators
+ *
+ * Provides plugin system for validation constraints with singleton pattern
+ * to ensure validators are only instantiated once.
+ */
+export class SemanticValidatorRegistry {
+    /**
+     * Private constructor to enforce singleton pattern
+     */
+    constructor() {
+        this.validators = new Map();
+        this.registerBuiltInValidators();
+    }
+    /**
+     * Get the singleton instance of the registry
+     *
+     * @returns The singleton registry instance
+     */
+    static getInstance() {
+        if (!SemanticValidatorRegistry.instance) {
+            SemanticValidatorRegistry.instance = new SemanticValidatorRegistry();
+        }
+        return SemanticValidatorRegistry.instance;
+    }
+    /**
+     * Register built-in semantic validators
+     *
+     * Called automatically during construction.
+     * Registers the core validators that ship with the linter.
+     */
+    registerBuiltInValidators() {
+        this.register(new SubsetOfEntityFieldsValidator());
+        this.register(new SqlWhereClauseValidator());
+        this.register(new RequiredWhenValidator());
+    }
+    /**
+     * Register a semantic validator
+     *
+     * Validators are keyed by the constraint type they handle.
+     * If a validator for the same type already exists, it will be overridden.
+     *
+     * @param validator - Validator instance to register
+     *
+     * @example
+     * ```typescript
+     * const registry = SemanticValidatorRegistry.getInstance();
+     * registry.register(new MyCustomValidator());
+     * ```
+     */
+    register(validator) {
+        // Get the constraint type from the validator's @RegisterClass decorator
+        // For now, we extract it from the class name by convention
+        // In the future, this could be read from metadata
+        const type = this.getValidatorType(validator);
+        this.validators.set(type, validator);
+    }
+    /**
+     * Get validator type from validator instance
+     *
+     * Extracts the constraint type by checking the @RegisterClass metadata.
+     * Falls back to deriving from class name if metadata is not available.
+     *
+     * @param validator - Validator instance
+     * @returns Constraint type string
+     */
+    getValidatorType(validator) {
+        // Type is stored in MJGlobal.Instance.ClassFactory during @RegisterClass
+        // For built-in validators, we know the types:
+        if (validator instanceof SubsetOfEntityFieldsValidator) {
+            return 'subset-of-entity-fields';
+        }
+        if (validator instanceof SqlWhereClauseValidator) {
+            return 'sql-where-clause';
+        }
+        if (validator instanceof RequiredWhenValidator) {
+            return 'required-when';
+        }
+        // Fallback: derive from class name (e.g., SubsetOfEntityFieldsValidator -> subset-of-entity-fields)
+        const className = validator.constructor.name;
+        return className
+            .replace(/Validator$/, '') // Remove "Validator" suffix
+            .replace(/([A-Z])/g, (match, p1, offset) => (offset > 0 ? '-' : '') + p1.toLowerCase())
+            .replace(/^-/, ''); // Remove leading dash if present
+    }
+    /**
+     * Get a validator by constraint type
+     *
+     * @param type - Constraint type (e.g., 'subset-of-entity-fields')
+     * @returns Validator instance, or undefined if not registered
+     *
+     * @example
+     * ```typescript
+     * const validator = registry.get('subset-of-entity-fields');
+     * if (validator) {
+     *   const violations = validator.validate(context, constraint);
+     * }
+     * ```
+     */
+    get(type) {
+        return this.validators.get(type);
+    }
+    /**
+     * Get all registered validators
+     *
+     * @returns Map of constraint type to validator instance
+     *
+     * @example
+     * ```typescript
+     * const allValidators = registry.getAll();
+     * for (const [type, validator] of allValidators) {
+     *   console.log(`${type}: ${validator.getDescription()}`);
+     * }
+     * ```
+     */
+    getAll() {
+        return new Map(this.validators);
+    }
+    /**
+     * Check if a validator is registered for a constraint type
+     *
+     * @param type - Constraint type to check
+     * @returns True if a validator is registered
+     */
+    has(type) {
+        return this.validators.has(type);
+    }
+    /**
+     * Get list of all registered constraint types
+     *
+     * @returns Array of constraint type strings
+     */
+    getTypes() {
+        return Array.from(this.validators.keys());
+    }
+}
+//# sourceMappingURL=semantic-validator-registry.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"semantic-validator-registry.js","sourceRoot":"","sources":["../../../src/schema-validation/semantic-validators/semantic-validator-registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAGH,OAAO,EAAE,6BAA6B,EAAE,MAAM,qCAAqC,CAAC;AACpF,OAAO,EAAE,uBAAuB,EAAE,MAAM,8BAA8B,CAAC;AACvE,OAAO,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AAElE;;;;;GAKG;AACH,MAAM,OAAO,yBAAyB;IAIpC;;OAEG;IACH;QACE,IAAI,CAAC,UAAU,GAAG,IAAI,GAAG,EAAE,CAAC;QAC5B,IAAI,CAAC,yBAAyB,EAAE,CAAC;IACnC,CAAC;IAED;;;;OAIG;IACH,MAAM,CAAC,WAAW;QAChB,IAAI,CAAC,yBAAyB,CAAC,QAAQ,EAAE,CAAC;YACxC,yBAAyB,CAAC,QAAQ,GAAG,IAAI,yBAAyB,EAAE,CAAC;QACvE,CAAC;QACD,OAAO,yBAAyB,CAAC,QAAQ,CAAC;IAC5C,CAAC;IAED;;;;;OAKG;IACK,yBAAyB;QAC/B,IAAI,CAAC,QAAQ,CAAC,IAAI,6BAA6B,EAAE,CAAC,CAAC;QACnD,IAAI,CAAC,QAAQ,CAAC,IAAI,uBAAuB,EAAE,CAAC,CAAC;QAC7C,IAAI,CAAC,QAAQ,CAAC,IAAI,qBAAqB,EAAE,CAAC,CAAC;IAC7C,CAAC;IAED;;;;;;;;;;;;;OAaG;IACH,QAAQ,CAAC,SAA4B;QACnC,wEAAwE;QACxE,2DAA2D;QAC3D,kDAAkD;QAClD,MAAM,IAAI,GAAG,IAAI,CAAC,gBAAgB,CAAC,SAAS,CAAC,CAAC;QAC9C,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;IACvC,CAAC;IAED;;;;;;;;OAQG;IACK,gBAAgB,CAAC,SAA4B;QACnD,yEAAyE;QACzE,8CAA8C;QAC9C,IAAI,SAAS,YAAY,6BAA6B,EAAE,CAAC;YACvD,OAAO,yBAAyB,CAAC;QACnC,CAAC;QACD,IAAI,SAAS,YAAY,uBAAuB,EAAE,CAAC;YACjD,OAAO,kBAAkB,CAAC;QAC5B,CAAC;QACD,IAAI,SAAS,YAAY,qBAAqB,EAAE,CAAC;YAC/C,OAAO,eAAe,CAAC;QACzB,CAAC;QAED,oGAAoG;QACpG,MAAM,SAAS,GAAG,SAAS,CAAC,WAAW,CAAC,IAAI,CAAC;QAC7C,OAAO,SAAS;aACb,OAAO,CAAC,YAAY,EAAE,EAAE,CAAC,CAAC,4BAA4B;aACtD,OAAO,CAAC,UAAU,EAAE,CAAC,KAAK,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE,CAAC;aACtF,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,CAAC,iCAAiC;IACzD,CAAC;IAED;;;;;;;;;;;;;OAaG;IACH,GAAG,CAAC,IAAY;QACd,OAAO,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IACnC,CAAC;IAED;;;;;;;;;;;;OAYG;IACH,MAAM;QACJ,OAAO,IAAI,GAAG,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IAClC,CAAC;IAED;;;;;OAKG;IACH,GAAG,CAAC,IAAY;QACd,OAAO,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IACnC,CAAC;IAED;;;;OAIG;IACH,QAAQ;QACN,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,EAAE,CAAC,CAAC;IAC5C,CAAC;CACF"}