@memberjunction/react-test-harness 2.123.1 → 2.125.0

package/dist/lib/constraint-validators/subset-of-entity-fields-validator.d.ts

@@ -0,0 +1,60 @@
+/**
+ * Subset Of Entity Fields Validator
+ *
+ * Validates that array elements are valid field names for a specified entity.
+ *
+ * This validator is essential for catching errors like:
+ * ```jsx
+ * // ❌ BROKEN - FullName, Status, StartDate don't exist on Members
+ * <EntityDataGrid
+ *   entityName="Members"
+ *   fields={['FullName', 'Status', 'StartDate']}
+ * />
+ *
+ * // ✅ FIXED - FirstName, LastName, Email exist on Members
+ * <EntityDataGrid
+ *   entityName="Members"
+ *   fields={['FirstName', 'LastName', 'Email']}
+ * />
+ * ```
+ *
+ * Constraint Definition:
+ * ```json
+ * {
+ *   "type": "subset-of-entity-fields",
+ *   "dependsOn": "entityName",
+ *   "config": {
+ *     "allowWildcard": false,
+ *     "caseSensitive": false
+ *   }
+ * }
+ * ```
+ */
+import { PropertyConstraint, ConstraintViolation } from '@memberjunction/interactive-component-types';
+import { BaseConstraintValidator } from './base-constraint-validator';
+import { ValidationContext } from './validation-context';
+/**
+ * Validates that array elements are valid field names for an entity
+ *
+ * **Depends On**: Entity name (from entityName prop)
+ * **Validates**: Array of field name strings
+ * **Common Use Cases**:
+ * - EntityDataGrid fields prop
+ * - DataGrid columns (when using entity binding)
+ * - Custom components with entity field arrays
+ */
+export declare class SubsetOfEntityFieldsValidator extends BaseConstraintValidator {
+    /**
+     * Validate that array elements are valid entity field names
+     *
+     * @param context - Validation context
+     * @param constraint - Constraint definition
+     * @returns Array of violations (empty if valid)
+     */
+    validate(context: ValidationContext, constraint: PropertyConstraint): ConstraintViolation[];
+    /**
+     * Get validator description
+     */
+    getDescription(): string;
+}
+//# sourceMappingURL=subset-of-entity-fields-validator.d.ts.map

package/dist/lib/constraint-validators/subset-of-entity-fields-validator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"subset-of-entity-fields-validator.d.ts","sourceRoot":"","sources":["../../../src/lib/constraint-validators/subset-of-entity-fields-validator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AAEH,OAAO,EACL,kBAAkB,EAClB,mBAAmB,EACpB,MAAM,6CAA6C,CAAC;AAErD,OAAO,EAAE,uBAAuB,EAAE,MAAM,6BAA6B,CAAC;AACtE,OAAO,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAGzD;;;;;;;;;GASG;AACH,qBACa,6BAA8B,SAAQ,uBAAuB;IACxE;;;;;;OAMG;IACH,QAAQ,CACN,OAAO,EAAE,iBAAiB,EAC1B,UAAU,EAAE,kBAAkB,GAC7B,mBAAmB,EAAE;IAwMxB;;OAEG;IACH,cAAc,IAAI,MAAM;CAGzB"}

package/dist/lib/constraint-validators/subset-of-entity-fields-validator.js

@@ -0,0 +1,198 @@
+"use strict";
+/**
+ * Subset Of Entity Fields Validator
+ *
+ * Validates that array elements are valid field names for a specified entity.
+ *
+ * This validator is essential for catching errors like:
+ * ```jsx
+ * // ❌ BROKEN - FullName, Status, StartDate don't exist on Members
+ * <EntityDataGrid
+ *   entityName="Members"
+ *   fields={['FullName', 'Status', 'StartDate']}
+ * />
+ *
+ * // ✅ FIXED - FirstName, LastName, Email exist on Members
+ * <EntityDataGrid
+ *   entityName="Members"
+ *   fields={['FirstName', 'LastName', 'Email']}
+ * />
+ * ```
+ *
+ * Constraint Definition:
+ * ```json
+ * {
+ *   "type": "subset-of-entity-fields",
+ *   "dependsOn": "entityName",
+ *   "config": {
+ *     "allowWildcard": false,
+ *     "caseSensitive": false
+ *   }
+ * }
+ * ```
+ */
+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;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SubsetOfEntityFieldsValidator = void 0;
+const global_1 = require("@memberjunction/global");
+const base_constraint_validator_1 = require("./base-constraint-validator");
+/**
+ * Validates that array elements are valid field names for an entity
+ *
+ * **Depends On**: Entity name (from entityName prop)
+ * **Validates**: Array of field name strings
+ * **Common Use Cases**:
+ * - EntityDataGrid fields prop
+ * - DataGrid columns (when using entity binding)
+ * - Custom components with entity field arrays
+ */
+let SubsetOfEntityFieldsValidator = class SubsetOfEntityFieldsValidator extends base_constraint_validator_1.BaseConstraintValidator {
+    /**
+     * Validate that array elements are valid entity field names
+     *
+     * @param context - Validation context
+     * @param constraint - Constraint definition
+     * @returns Array of violations (empty if valid)
+     */
+    validate(context, constraint) {
+        const violations = [];
+        // Check if value is dynamic (can't validate statically)
+        if (this.isDynamicValue(context.propertyValue)) {
+            return violations; // Skip validation
+        }
+        // Get the entity name from dependent prop
+        const entityName = this.getDependentPropValue(context, constraint);
+        if (!entityName || typeof entityName !== 'string') {
+            // Can't validate without entity name
+            return violations;
+        }
+        // Check if entity exists
+        if (!context.hasEntity(entityName)) {
+            // Entity doesn't exist - not this validator's responsibility to report
+            // (should be caught by valid-entity-reference validator)
+            return violations;
+        }
+        // Get entity fields
+        const entityFields = context.getEntityFields(entityName);
+        const fieldNames = entityFields.map((f) => f.name);
+        const fieldNamesLower = fieldNames.map((f) => f.toLowerCase());
+        // Extract config
+        const config = constraint.config || {};
+        const allowWildcard = config.allowWildcard === true;
+        const caseSensitive = config.caseSensitive === true;
+        // Validate the property value is an array
+        if (!Array.isArray(context.propertyValue)) {
+            violations.push(this.createViolation('invalid-type', this.applyErrorTemplate(constraint, context, `Property '${context.propertyName}' must be an array of field names`, { entityName }), 'critical', `Use an array: ${context.propertyName}={['${fieldNames.slice(0, 3).join("', '")}']}`));
+            return violations;
+        }
+        // Validate each element is a string or object with 'field' property
+        for (let i = 0; i < context.propertyValue.length; i++) {
+            const element = context.propertyValue[i];
+            // Skip dynamic values (identifiers, expressions)
+            if (this.isDynamicValue(element)) {
+                continue;
+            }
+            // Extract field name from element
+            let fieldName = null;
+            if (typeof element === 'string') {
+                // Simple string field name
+                fieldName = element;
+            }
+            else if (typeof element === 'object' && element !== null) {
+                // Object with 'field' property (e.g., ColumnDef, FieldDefinition)
+                const fieldProp = element.field;
+                if (typeof fieldProp === 'string') {
+                    fieldName = fieldProp;
+                }
+                else if (this.isDynamicValue(fieldProp)) {
+                    // Dynamic field property - skip validation
+                    continue;
+                }
+                else {
+                    // Object without valid 'field' property
+                    violations.push(this.createViolation('invalid-element-type', this.applyErrorTemplate(constraint, context, `Element at index ${i} in '${context.propertyName}' must be a string or object with 'field' property`, { entityName, index: i, elementType: typeof element }), 'high', `Use string field names or objects with 'field' property from entity '${entityName}'`));
+                    continue;
+                }
+            }
+            else {
+                // Invalid type (not string or object)
+                violations.push(this.createViolation('invalid-element-type', this.applyErrorTemplate(constraint, context, `Element at index ${i} in '${context.propertyName}' must be a string or object, got ${typeof element}`, { entityName, index: i, elementType: typeof element }), 'high', `Use string field names from entity '${entityName}'`));
+                continue;
+            }
+            // At this point, fieldName should be a string
+            if (!fieldName) {
+                continue; // Should not reach here, but safety check
+            }
+            // Check for wildcard
+            if (allowWildcard && fieldName === '*') {
+                continue; // Wildcard is allowed
+            }
+            // Check if field exists
+            let fieldExists = false;
+            let correctCaseName = null;
+            if (caseSensitive) {
+                fieldExists = fieldNames.includes(fieldName);
+            }
+            else {
+                // Case-insensitive check
+                const index = fieldNamesLower.indexOf(fieldName.toLowerCase());
+                fieldExists = index !== -1;
+                if (fieldExists) {
+                    correctCaseName = fieldNames[index];
+                }
+            }
+            if (!fieldExists) {
+                // Field doesn't exist - find similar fields for suggestion
+                const similarFields = this.findSimilar(fieldName, fieldNames, 3, 3);
+                let suggestion = '';
+                if (similarFields.length > 0) {
+                    suggestion = `Did you mean: ${this.formatValueList(similarFields, 3)}?`;
+                }
+                else {
+                    suggestion = `Available fields: ${this.formatValueList(fieldNames, 10)}`;
+                }
+                violations.push(this.createViolation('invalid-field', this.applyErrorTemplate(constraint, context, `Field '${fieldName}' does not exist on entity '${entityName}'`, {
+                    field: fieldName,
+                    entityName,
+                    availableFields: fieldNames.slice(0, 10).join(', '),
+                }), 'critical', suggestion, {
+                    field: fieldName,
+                    entityName,
+                    index: i,
+                    availableFields: fieldNames,
+                    similarFields,
+                }));
+            }
+            else if (!caseSensitive && correctCaseName && correctCaseName !== fieldName) {
+                // Field exists but case doesn't match
+                violations.push(this.createViolation('case-mismatch', this.applyErrorTemplate(constraint, context, `Field '${fieldName}' case doesn't match schema. Expected '${correctCaseName}' on entity '${entityName}'`, {
+                    field: fieldName,
+                    correctCase: correctCaseName,
+                    entityName,
+                }), 'medium', `Use '${correctCaseName}' instead of '${fieldName}'`, {
+                    field: fieldName,
+                    correctCase: correctCaseName,
+                    entityName,
+                    index: i,
+                }));
+            }
+        }
+        return violations;
+    }
+    /**
+     * Get validator description
+     */
+    getDescription() {
+        return 'Validates that array elements are valid field names for the specified entity';
+    }
+};
+exports.SubsetOfEntityFieldsValidator = SubsetOfEntityFieldsValidator;
+exports.SubsetOfEntityFieldsValidator = SubsetOfEntityFieldsValidator = __decorate([
+    (0, global_1.RegisterClass)(base_constraint_validator_1.BaseConstraintValidator, 'subset-of-entity-fields')
+], SubsetOfEntityFieldsValidator);
+//# sourceMappingURL=subset-of-entity-fields-validator.js.map

package/dist/lib/constraint-validators/subset-of-entity-fields-validator.js.map

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

package/dist/lib/constraint-validators/validation-context.d.ts

@@ -0,0 +1,326 @@
+/**
+ * Validation Context
+ *
+ * Provides all the information a constraint validator needs to perform validation.
+ * This context is passed to validators by the linter rule and includes:
+ * - AST node and path information for location tracking
+ * - Component spec for type lookups
+ * - Sibling props for dependency resolution
+ * - Entity/query metadata from data requirements
+ * - Helper methods for common validation tasks
+ */
+import * as t from '@babel/types';
+import { NodePath } from '@babel/traverse';
+import { ComponentSpec } from '@memberjunction/interactive-component-types';
+import { TypeInferenceEngine } from '../type-inference-engine';
+import { ExtractedValue } from '../prop-value-extractor';
+/**
+ * Context object passed to constraint validators
+ *
+ * Contains all information needed to validate a prop value against constraints.
+ */
+export interface ValidationContext {
+    /**
+     * The AST node being validated
+     *
+     * This is typically the JSXAttribute node, but validators can traverse
+     * to child nodes for more specific location information.
+     */
+    node: t.Node;
+    /**
+     * Babel traversal path for the node
+     *
+     * Provides access to parent nodes, scope information, and AST manipulation.
+     * Validators should not modify the AST - this is read-only validation.
+     */
+    path: NodePath<any>;
+    /**
+     * Name of the component being validated
+     *
+     * Example: "DataGrid", "EntityDataGrid", "SimpleChart"
+     */
+    componentName: string;
+    /**
+     * Full component specification
+     *
+     * Provides access to:
+     * - Type definitions (for custom type validation)
+     * - Data requirements (entities, queries)
+     * - Other properties (for cross-property validation)
+     * - Dependency specs (for validating nested components)
+     */
+    componentSpec: ComponentSpec;
+    /**
+     * Name of the property being validated
+     *
+     * Example: "fields", "columns", "entityName", "extraFilter"
+     */
+    propertyName: string;
+    /**
+     * Extracted value of the property
+     *
+     * This is the result of PropValueExtractor.extract() and can be:
+     * - Primitive: string, number, boolean, null
+     * - Array: Array of extracted values
+     * - Object: Record<string, ExtractedValue>
+     * - DynamicValue: { _type: 'identifier' | 'expression', name?, description? }
+     *
+     * If the value is a DynamicValue, validators should typically skip validation
+     * and return an empty violations array (the linter will warn the user).
+     */
+    propertyValue: ExtractedValue;
+    /**
+     * Map of sibling props on the same JSX element
+     *
+     * Key is prop name, value is extracted value.
+     * Used for constraints with `dependsOn` to access related prop values.
+     *
+     * Example:
+     * ```typescript
+     * // <EntityDataGrid entityName="Members" fields={['FirstName', 'LastName']} />
+     * siblingProps.get('entityName') // => "Members"
+     * siblingProps.get('fields') // => ['FirstName', 'LastName']
+     * ```
+     */
+    siblingProps: Map<string, ExtractedValue>;
+    /**
+     * Map of entity name to entity metadata
+     *
+     * Populated from componentSpec.dataRequirements.entities
+     * Used by validators that check field names, entity references, etc.
+     *
+     * Example:
+     * ```typescript
+     * const memberEntity = entities.get('Members');
+     * const fields = memberEntity.fields; // Array of EntityFieldInfo
+     * ```
+     */
+    entities: Map<string, EntityMetadata>;
+    /**
+     * Map of query name to query metadata
+     *
+     * Populated from componentSpec.dataRequirements.queries
+     * Used by validators that check query references and parameters.
+     *
+     * Example:
+     * ```typescript
+     * const query = queries.get('Sales by Region');
+     * const params = query.parameters; // Array of QueryParameter
+     * ```
+     */
+    queries: Map<string, QueryMetadata>;
+    /**
+     * Type inference engine for checking expression types
+     *
+     * Used for advanced type checking beyond what PropValueExtractor provides.
+     * Can infer types of variables, function calls, etc.
+     */
+    typeEngine: TypeInferenceEngine;
+    /**
+     * Get field metadata for an entity
+     *
+     * @param entityName - Name of the entity
+     * @returns Array of field info, or empty array if entity not found
+     *
+     * @example
+     * ```typescript
+     * const fields = context.getEntityFields('Members');
+     * const fieldNames = fields.map(f => f.name);
+     * ```
+     */
+    getEntityFields(entityName: string): EntityFieldInfo[];
+    /**
+     * Get the data type of a specific field on an entity
+     *
+     * @param entityName - Name of the entity
+     * @param fieldName - Name of the field
+     * @returns Data type string (e.g., 'string', 'number', 'date'), or null if not found
+     *
+     * @example
+     * ```typescript
+     * const fieldType = context.getEntityFieldType('Members', 'JoinDate');
+     * // => 'date'
+     * ```
+     */
+    getEntityFieldType(entityName: string, fieldName: string): string | null;
+    /**
+     * Find field names similar to the given field name (for suggestions)
+     *
+     * Uses fuzzy matching (Levenshtein distance or similar) to find close matches.
+     * Useful for "Did you mean?" error messages.
+     *
+     * @param fieldName - The field name to find matches for
+     * @param entityName - Name of the entity to search in
+     * @param maxResults - Maximum number of suggestions (default: 3)
+     * @returns Array of similar field names, sorted by similarity
+     *
+     * @example
+     * ```typescript
+     * const suggestions = context.findSimilarFieldNames('FristName', 'Members', 3);
+     * // => ['FirstName', 'FirstNameNormalized', 'FirstNameMasked']
+     * ```
+     */
+    findSimilarFieldNames(fieldName: string, entityName: string, maxResults?: number): string[];
+    /**
+     * Get parameter metadata for a query
+     *
+     * @param queryName - Name of the query
+     * @returns Array of parameter info, or empty array if query not found
+     *
+     * @example
+     * ```typescript
+     * const params = context.getQueryParameters('Sales by Region');
+     * const requiredParams = params.filter(p => p.required);
+     * ```
+     */
+    getQueryParameters(queryName: string): QueryParameter[];
+    /**
+     * Check if a query exists in the component's data requirements
+     *
+     * @param queryName - Name of the query to check
+     * @param categoryPath - Optional category path for disambiguation
+     * @returns True if the query exists
+     *
+     * @example
+     * ```typescript
+     * if (!context.hasQuery('Sales Report', '/Reports/Sales')) {
+     *   // Query not found
+     * }
+     * ```
+     */
+    hasQuery(queryName: string, categoryPath?: string): boolean;
+    /**
+     * Check if an entity exists in the component's data requirements
+     *
+     * @param entityName - Name of the entity to check
+     * @returns True if the entity exists
+     *
+     * @example
+     * ```typescript
+     * if (!context.hasEntity('Members')) {
+     *   // Entity not found
+     * }
+     * ```
+     */
+    hasEntity(entityName: string): boolean;
+}
+/**
+ * Entity metadata extracted from data requirements
+ */
+export interface EntityMetadata {
+    /**
+     * Entity name
+     */
+    name: string;
+    /**
+     * Entity description (if available)
+     */
+    description?: string;
+    /**
+     * Array of field metadata for this entity
+     */
+    fields: EntityFieldInfo[];
+    /**
+     * Primary key field name(s)
+     */
+    primaryKeys?: string[];
+}
+/**
+ * Field metadata for an entity
+ */
+export interface EntityFieldInfo {
+    /**
+     * Field name
+     */
+    name: string;
+    /**
+     * Data type (e.g., 'string', 'number', 'date', 'boolean')
+     */
+    type: string;
+    /**
+     * SQL data type (e.g., 'nvarchar', 'int', 'datetime', 'bit')
+     */
+    sqlType?: string;
+    /**
+     * Whether this field is required (NOT NULL)
+     */
+    required?: boolean;
+    /**
+     * Field description (if available)
+     */
+    description?: string;
+    /**
+     * Whether this is a primary key field
+     */
+    isPrimaryKey?: boolean;
+    /**
+     * If this is a foreign key, the related entity name
+     */
+    relatedEntity?: string;
+    /**
+     * Maximum length for string fields
+     */
+    maxLength?: number;
+}
+/**
+ * Query metadata extracted from data requirements
+ */
+export interface QueryMetadata {
+    /**
+     * Query name
+     */
+    name: string;
+    /**
+     * Query description (if available)
+     */
+    description?: string;
+    /**
+     * Category path for disambiguation
+     */
+    categoryPath?: string;
+    /**
+     * Array of parameter metadata for this query
+     */
+    parameters: QueryParameter[];
+    /**
+     * Expected result fields (if specified)
+     */
+    resultFields?: Array<{
+        name: string;
+        type: string;
+    }>;
+}
+/**
+ * Parameter metadata for a query
+ */
+export interface QueryParameter {
+    /**
+     * Parameter name
+     */
+    name: string;
+    /**
+     * Parameter data type
+     */
+    type: string;
+    /**
+     * SQL data type
+     */
+    sqlType?: string;
+    /**
+     * Whether this parameter is required
+     */
+    required?: boolean;
+    /**
+     * Default value if not provided
+     */
+    defaultValue?: any;
+    /**
+     * Example/test value for documentation
+     */
+    testValue?: any;
+    /**
+     * Parameter description (if available)
+     */
+    description?: string;
+}
+//# sourceMappingURL=validation-context.d.ts.map

package/dist/lib/constraint-validators/validation-context.d.ts.map

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

package/dist/lib/constraint-validators/validation-context.js

@@ -0,0 +1,14 @@
+"use strict";
+/**
+ * Validation Context
+ *
+ * Provides all the information a constraint validator needs to perform validation.
+ * This context is passed to validators by the linter rule and includes:
+ * - AST node and path information for location tracking
+ * - Component spec for type lookups
+ * - Sibling props for dependency resolution
+ * - Entity/query metadata from data requirements
+ * - Helper methods for common validation tasks
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=validation-context.js.map

package/dist/lib/constraint-validators/validation-context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation-context.js","sourceRoot":"","sources":["../../../src/lib/constraint-validators/validation-context.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;GAUG"}