@memberjunction/react-linter 0.0.1 → 5.38.0

package/dist/runtime-rules/entity-field-access-validation.js

@@ -0,0 +1,304 @@
+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 { traverse, createViolation, truncateCode, findClosestMatch, findCaseMismatch, NUMERIC_COERCION_FUNCTIONS, NON_ENTITY_PROPERTIES } from '../lint-utils.js';
+import * as t from '@babel/types';
+import { RegisterClass } from '@memberjunction/global';
+import { BaseLintRule } from '../lint-rule.js';
+import { TypeContext } from '../type-context.js';
+/**
+ * Rule: entity-field-access-validation
+ *
+ * Validates field access on entity row variables using the shared TypeContext.
+ * The TypeInferenceEngine populates variable types (including callback parameters
+ * in .map/.filter/.reduce), so this rule simply checks every MemberExpression
+ * whose object is typed as 'entity-row' and validates the property name.
+ *
+ * Catches:
+ * - Nonexistent fields (high severity, with closest-match suggestion)
+ * - Field name typos via Levenshtein distance (high severity)
+ * - Case mismatches like `m.email` vs `m.Email` (medium severity)
+ * - Type coercion on GUID fields like `parseInt(m.ID)` (medium severity)
+ * - Optional chaining expressions like `m?.FieldName`
+ *
+ * Severity: high (nonexistent/typo), medium (case mismatch, type coercion)
+ * Applies to: all components
+ */
+/**
+ * Looks up a variable's TypeInfo from the TypeContext, including scoped lookups.
+ */
+function lookupVariableTypeInfo(varName, typeContext, path) {
+    let varType = typeContext.getVariableType(varName);
+    if (!varType || varType.type === 'unknown') {
+        // Try with scope prefix from the path
+        let current = path;
+        while (current) {
+            if (current.isFunction()) {
+                let fnName;
+                const node = current.node;
+                if (t.isFunctionDeclaration(node) && node.id) {
+                    fnName = node.id.name;
+                }
+                else if (t.isArrowFunctionExpression(node) || t.isFunctionExpression(node)) {
+                    const parent = current.parent;
+                    if (t.isVariableDeclarator(parent) && t.isIdentifier(parent.id)) {
+                        fnName = parent.id.name;
+                    }
+                }
+                if (fnName) {
+                    varType = typeContext.getVariableType(`${fnName}:${varName}`);
+                    if (varType && varType.type !== 'unknown')
+                        break;
+                }
+            }
+            current = current.parentPath;
+        }
+    }
+    return varType ?? null;
+}
+/**
+ * Resolves the variable name from a MemberExpression or OptionalMemberExpression.
+ * Handles:
+ * - Simple identifiers: `variable.Field`
+ * - Scoped names: callback params in `.map()`, etc.
+ * - Inline indexed access: `result.Results?.[0]?.Field` where [0] yields an entity/query row
+ */
+function resolveVariableType(objectNode, typeContext, path) {
+    // Case 1: Simple identifier — `variable.Field`
+    if (t.isIdentifier(objectNode)) {
+        const varType = lookupVariableTypeInfo(objectNode.name, typeContext, path);
+        if (!varType)
+            return null;
+        if (varType.type === 'entity-row' && varType.entityName) {
+            let fields = varType.fields;
+            // If fields are missing (DB unavailable during type inference), try to
+            // load from TypeContext cache or spec fieldMetadata
+            if (!fields || fields.size === 0) {
+                fields = typeContext.getEntityFieldTypesSync(varType.entityName);
+            }
+            if (fields && fields.size > 0) {
+                return { entityName: varType.entityName, fields };
+            }
+            // Fields still empty — will be handled by the fieldMetadata fallback in the main rule logic
+            return null;
+        }
+        if (varType.type === 'query-row' && varType.queryName) {
+            let fields = varType.fields;
+            if (!fields || fields.size === 0) {
+                fields = typeContext.getQueryFieldTypes(varType.queryName) ?? undefined;
+            }
+            if (fields && fields.size > 0) {
+                return { queryName: varType.queryName, entityName: varType.queryName, fields };
+            }
+            return null;
+        }
+        return null;
+    }
+    // Case 2: Indexed access on .Results — `result.Results?.[0]?.Field` or `result.Results[0].Field`
+    // The object is a computed member/optional-member expression like `result.Results?.[0]`
+    if ((t.isMemberExpression(objectNode) || t.isOptionalMemberExpression(objectNode)) && objectNode.computed) {
+        const arrayExpr = objectNode.object;
+        // arrayExpr should be `result.Results` or `result.Results?`
+        if ((t.isMemberExpression(arrayExpr) || t.isOptionalMemberExpression(arrayExpr)) &&
+            t.isIdentifier(arrayExpr.property) && arrayExpr.property.name === 'Results' &&
+            t.isIdentifier(arrayExpr.object)) {
+            const resultVarType = lookupVariableTypeInfo(arrayExpr.object.name, typeContext, path);
+            if (resultVarType?.type === 'object') {
+                // The .Results array's element type carries the entity/query row info
+                if (resultVarType.entityName) {
+                    const entityFields = typeContext.getEntityFieldTypesSync(resultVarType.entityName);
+                    if (entityFields.size > 0) {
+                        return { entityName: resultVarType.entityName, fields: entityFields };
+                    }
+                }
+                if (resultVarType.queryName) {
+                    const queryFields = typeContext.getQueryFieldTypes(resultVarType.queryName);
+                    if (queryFields && queryFields.size > 0) {
+                        return { queryName: resultVarType.queryName, entityName: resultVarType.queryName, fields: queryFields };
+                    }
+                }
+            }
+        }
+    }
+    return null;
+}
+let EntityFieldAccessValidationRule = class EntityFieldAccessValidationRule extends BaseLintRule {
+    get Name() { return 'entity-field-access-validation'; }
+    get AppliesTo() { return 'all'; }
+    Test(ast, _componentName, componentSpec, _options, sharedTypeContext) {
+        const violations = [];
+        // Use shared TypeContext if available, otherwise create own (backward compat)
+        const typeContext = sharedTypeContext ?? new TypeContext(componentSpec);
+        // Pre-load entity field sets for validation.
+        // Sources: 1) componentSpec.dataRequirements.entities, 2) entity names discovered
+        // by the TypeInferenceEngine from RunView({ EntityName: '...' }) calls in code.
+        const entityFieldSets = new Map();
+        // Track entity names discovered in RunView calls for skip-with-warning
+        const discoveredEntityNames = new Set();
+        function ensureEntityFields(entityName) {
+            if (entityFieldSets.has(entityName))
+                return;
+            const fields = typeContext.getEntityFieldTypesSync(entityName);
+            if (fields.size > 0) {
+                entityFieldSets.set(entityName, Array.from(fields.keys()));
+            }
+        }
+        // Check if spec has fieldMetadata for a given entity
+        function specHasFieldMetadata(entityName) {
+            if (!componentSpec?.dataRequirements?.entities)
+                return false;
+            return componentSpec.dataRequirements.entities.some(e => e.name === entityName && e.fieldMetadata && e.fieldMetadata.length > 0);
+        }
+        // Load from spec if available
+        if (componentSpec?.dataRequirements?.entities) {
+            for (const entityReq of componentSpec.dataRequirements.entities) {
+                ensureEntityFields(entityReq.name);
+                if (!entityFieldSets.has(entityReq.name) && entityReq.fieldMetadata?.length) {
+                    entityFieldSets.set(entityReq.name, entityReq.fieldMetadata.map(f => f.name));
+                }
+            }
+        }
+        // Also discover entity names from RunView calls in the AST
+        // (handles fixtures that don't have dataRequirements but do call RunView)
+        traverse(ast, {
+            CallExpression(p) {
+                const callee = p.node.callee;
+                if (t.isMemberExpression(callee) && t.isIdentifier(callee.property) && callee.property.name === 'RunView') {
+                    if (p.node.arguments.length > 0 && t.isObjectExpression(p.node.arguments[0])) {
+                        for (const prop of p.node.arguments[0].properties) {
+                            if (t.isObjectProperty(prop) && t.isIdentifier(prop.key) && prop.key.name === 'EntityName' && t.isStringLiteral(prop.value)) {
+                                discoveredEntityNames.add(prop.value.value);
+                                ensureEntityFields(prop.value.value);
+                            }
+                        }
+                    }
+                }
+            },
+            noScope: true,
+        });
+        // Emit skip-with-warning for entities discovered in RunView calls but lacking metadata
+        for (const entityName of discoveredEntityNames) {
+            if (!entityFieldSets.has(entityName) && !specHasFieldMetadata(entityName)) {
+                violations.push(createViolation('entity-field-access-validation', 'low', null, `Unable to validate field access on entity '${entityName}' — entity metadata not available. Ensure database connection or add fieldMetadata to dataRequirements for accurate validation.`, entityName));
+            }
+        }
+        // Skip traversal only if there are no entity fields loaded AND no query fields
+        // in the spec that could be resolved through inline expression type resolution
+        const hasQueryFields = componentSpec?.dataRequirements?.queries?.some(q => (q.fields && q.fields.length > 0)) ?? false;
+        if (entityFieldSets.size === 0 && !hasQueryFields)
+            return violations;
+        function validateFieldAccess(node, entityName, validFields, objectName, propertyName) {
+            if (validFields.includes(propertyName))
+                return;
+            // Skip common DOM/React/JS properties — these are never entity fields
+            // and would indicate a scope mismatch (variable shadowed by a different context)
+            if (NON_ENTITY_PROPERTIES.has(propertyName))
+                return;
+            const caseFix = findCaseMismatch(propertyName, validFields);
+            if (caseFix) {
+                violations.push(createViolation('entity-field-access-validation', 'medium', node, `Field "${propertyName}" on entity "${entityName}" has incorrect casing. Did you mean "${caseFix}"?`, `${objectName}.${propertyName}`, { text: `Use the correct casing: "${caseFix}". MemberJunction entity fields use PascalCase.`,
+                    example: `// Change:\n${objectName}.${propertyName}\n// To:\n${objectName}.${caseFix}` }));
+                return;
+            }
+            const closest = findClosestMatch(propertyName, validFields);
+            const preview = validFields.slice(0, 10).join(', ');
+            const more = validFields.length > 10 ? ` and ${validFields.length - 10} more` : '';
+            violations.push(createViolation('entity-field-access-validation', 'high', node, closest
+                ? `Field "${propertyName}" does not exist on entity "${entityName}". Did you mean "${closest}"? Available fields: ${preview}${more}`
+                : `Field "${propertyName}" does not exist on entity "${entityName}". Available fields: ${preview}${more}`, `${objectName}.${propertyName}`, closest
+                ? { text: `Replace "${propertyName}" with "${closest}".`, example: `${objectName}.${closest}` }
+                : { text: `Use one of the valid fields from the "${entityName}" entity.` }));
+        }
+        /**
+         * Gets the valid fields for a resolved entity/query, populating entityFieldSets
+         * on-demand from resolved.fields when not already loaded (e.g., for query-row types
+         * discovered via inline expressions).
+         */
+        function getValidFields(resolved) {
+            let validFields = entityFieldSets.get(resolved.entityName);
+            if (!validFields && resolved.fields.size > 0) {
+                const fieldNames = Array.from(resolved.fields.keys());
+                entityFieldSets.set(resolved.entityName, fieldNames);
+                validFields = fieldNames;
+            }
+            return validFields;
+        }
+        // Traverse all member expressions and check entity-row typed variables
+        traverse(ast, {
+            MemberExpression(path) {
+                if (path.node.computed || !t.isIdentifier(path.node.property))
+                    return;
+                const propertyName = path.node.property.name;
+                let resolved = resolveVariableType(path.node.object, typeContext, path);
+                // Fallback: if we have an entity-row variable but resolveVariableType returned null
+                // (fields unavailable from DB), try to get fields from entityFieldSets (populated from spec fieldMetadata)
+                if (!resolved && t.isIdentifier(path.node.object)) {
+                    const varType = lookupVariableTypeInfo(path.node.object.name, typeContext, path);
+                    if (varType?.type === 'entity-row' && varType.entityName && entityFieldSets.has(varType.entityName)) {
+                        const fieldNames = entityFieldSets.get(varType.entityName);
+                        const fields = new Map(fieldNames.map(n => [n, { type: 'string', fromMetadata: false }]));
+                        resolved = { entityName: varType.entityName, fields };
+                    }
+                }
+                if (!resolved)
+                    return;
+                const validFields = getValidFields(resolved);
+                if (!validFields)
+                    return;
+                const objectName = t.isIdentifier(path.node.object) ? path.node.object.name : '(expr)';
+                validateFieldAccess(path.node, resolved.entityName, validFields, objectName, propertyName);
+            },
+            OptionalMemberExpression(path) {
+                if (path.node.computed || !t.isIdentifier(path.node.property))
+                    return;
+                const propertyName = path.node.property.name;
+                let resolved = resolveVariableType(path.node.object, typeContext, path);
+                // Same fallback for optional chaining
+                if (!resolved && t.isIdentifier(path.node.object)) {
+                    const varType = lookupVariableTypeInfo(path.node.object.name, typeContext, path);
+                    if (varType?.type === 'entity-row' && varType.entityName && entityFieldSets.has(varType.entityName)) {
+                        const fieldNames = entityFieldSets.get(varType.entityName);
+                        const fields = new Map(fieldNames.map(n => [n, { type: 'string', fromMetadata: false }]));
+                        resolved = { entityName: varType.entityName, fields };
+                    }
+                }
+                if (!resolved)
+                    return;
+                const validFields = getValidFields(resolved);
+                if (!validFields)
+                    return;
+                const objectName = t.isIdentifier(path.node.object) ? path.node.object.name : '(expr)';
+                validateFieldAccess(path.node, resolved.entityName, validFields, objectName, propertyName);
+            },
+            // Check for numeric coercion on GUID fields
+            CallExpression(path) {
+                if (!t.isIdentifier(path.node.callee) || !NUMERIC_COERCION_FUNCTIONS.has(path.node.callee.name))
+                    return;
+                if (path.node.arguments.length === 0)
+                    return;
+                const arg = path.node.arguments[0];
+                if (!t.isMemberExpression(arg) && !t.isOptionalMemberExpression(arg))
+                    return;
+                if (arg.computed || !t.isIdentifier(arg.property) || !t.isIdentifier(arg.object))
+                    return;
+                const resolved = resolveVariableType(arg.object, typeContext, path);
+                if (!resolved)
+                    return;
+                const fieldInfo = resolved.fields.get(arg.property.name);
+                if (fieldInfo?.sqlType?.toLowerCase() === 'uniqueidentifier') {
+                    violations.push(createViolation('entity-field-access-validation', 'medium', path.node, `${path.node.callee.name}(${arg.object.name}.${arg.property.name}) coerces a uniqueidentifier (GUID) to a number. GUIDs are strings, not numeric values.`, truncateCode(`${path.node.callee.name}(${arg.object.name}.${arg.property.name})`), { text: `"${arg.property.name}" is a uniqueidentifier field. Use it as a string directly.`,
+                        example: `${arg.object.name}.${arg.property.name}  // Already a string` }));
+                }
+            },
+        });
+        return violations;
+    }
+};
+EntityFieldAccessValidationRule = __decorate([
+    RegisterClass(BaseLintRule, 'entity-field-access-validation')
+], EntityFieldAccessValidationRule);
+export { EntityFieldAccessValidationRule };
+//# sourceMappingURL=entity-field-access-validation.js.map

package/dist/runtime-rules/entity-field-access-validation.js.map

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

package/dist/runtime-rules/event-parameter-validation.d.ts

@@ -0,0 +1,22 @@
+import * as t from '@babel/types';
+import { BaseLintRule } from '../lint-rule.js';
+import { Violation } from '../component-linter.js';
+import { ComponentSpec } from '@memberjunction/interactive-component-types';
+/**
+ * Rule: event-parameter-validation
+ *
+ * Validates that event callback handlers access the correct properties from the
+ * event object, as defined by the component spec's event parameter types.
+ *
+ * Catches LLM mistakes like using `e.data` (AG Grid convention) instead of
+ * `e.record` (MJ DataGrid convention).
+ *
+ * Severity: high
+ * Applies to: all components
+ */
+export declare class EventParameterValidationRule extends BaseLintRule {
+    get Name(): string;
+    get AppliesTo(): 'all' | 'child' | 'root';
+    Test(ast: t.File, _componentName: string, componentSpec?: ComponentSpec): Violation[];
+}
+//# sourceMappingURL=event-parameter-validation.d.ts.map

package/dist/runtime-rules/event-parameter-validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-parameter-validation.d.ts","sourceRoot":"","sources":["../../src/runtime-rules/event-parameter-validation.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,CAAC,MAAM,cAAc,CAAC;AAElC,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAChD,OAAO,EAAE,aAAa,EAAkB,MAAM,6CAA6C,CAAC;AAI5F;;;;;;;;;;;GAWG;AACH,qBACa,4BAA6B,SAAQ,YAAY;IAC5D,IAAI,IAAI,WAAwB;IAChC,IAAI,SAAS,IAAI,KAAK,GAAG,OAAO,GAAG,MAAM,CAAkB;IAE3D,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,IAAI,EAAE,cAAc,EAAE,MAAM,EAAE,aAAa,CAAC,EAAE,aAAa,GAAG,SAAS,EAAE;CAiBtF"}