@memberjunction/react-test-harness 5.29.0 → 5.30.0

package/dist/lib/runtime-rules/query-result-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 } from '../lint-utils.js';
+import { RegisterClass } from '@memberjunction/global';
+import * as t from '@babel/types';
+import { BaseLintRule } from '../lint-rule.js';
+import { TypeContext } from '../type-context.js';
+/**
+ * Rule: query-result-field-access-validation
+ *
+ * Enhanced validation of field access on RunQuery results against spec fieldMetadata.
+ * Catches:
+ * - Nonexistent fields (high severity, with closest-match suggestion)
+ * - Field name typos via Levenshtein distance (high severity)
+ * - Case mismatches like `r.productname` vs `r.ProductName` (medium severity)
+ * - Type coercion on GUID fields like `parseInt(r.ID)` (medium severity)
+ * - Optional chaining expressions like `r?.FieldName`
+ * - All array method callbacks: map, filter, reduce, sort, find, some, every, forEach
+ *
+ * Severity: high (nonexistent/typo), medium (case mismatch, type coercion)
+ * Applies to: all components
+ */
+/** Array methods whose callbacks receive row items as the first parameter */
+const ARRAY_METHODS = ['map', 'forEach', 'filter', 'find', 'some', 'every', 'reduce', 'sort', 'flatMap'];
+/**
+ * Resolves the identifier being accessed through optional chaining or regular member access.
+ * Returns { objectName, propertyName } or null if the pattern doesn't match.
+ */
+function resolveMemberAccess(node) {
+    if (node.computed)
+        return null;
+    if (!t.isIdentifier(node.property))
+        return null;
+    if (t.isIdentifier(node.object)) {
+        return {
+            objectName: node.object.name,
+            propertyName: node.property.name,
+        };
+    }
+    return null;
+}
+/**
+ * Extracts the callback parameter name(s) for array iteration methods.
+ * For `reduce`, the item is the second param. For `sort`, both are items.
+ */
+function extractIterationParamNames(callback, methodName) {
+    const params = [];
+    if (methodName === 'reduce') {
+        if (callback.params.length >= 2 && t.isIdentifier(callback.params[1])) {
+            params.push(callback.params[1].name);
+        }
+    }
+    else if (methodName === 'sort') {
+        for (const param of callback.params) {
+            if (t.isIdentifier(param)) {
+                params.push(param.name);
+            }
+        }
+    }
+    else {
+        if (callback.params.length >= 1 && t.isIdentifier(callback.params[0])) {
+            params.push(callback.params[0].name);
+        }
+    }
+    return params;
+}
+let QueryResultFieldAccessValidationRule = class QueryResultFieldAccessValidationRule extends BaseLintRule {
+    get Name() { return 'query-result-field-access-validation'; }
+    get AppliesTo() { return 'all'; }
+    Test(ast, _componentName, componentSpec) {
+        const violations = [];
+        // Skip if no data requirements with queries
+        if (!componentSpec?.dataRequirements?.queries || componentSpec.dataRequirements.queries.length === 0) {
+            return violations;
+        }
+        // Build a map of query names to their valid field names and field types
+        const queryFieldsMap = new Map();
+        const queryFieldTypesMap = new Map(); // queryName -> fieldName -> sqlType
+        const typeContext = new TypeContext(componentSpec);
+        for (const queryReq of componentSpec.dataRequirements.queries) {
+            // Try TypeContext first (uses cached query.fields)
+            const fields = typeContext.getQueryFieldTypes(queryReq.name, queryReq.categoryPath);
+            if (fields && fields.size > 0) {
+                queryFieldsMap.set(queryReq.name, new Set(fields.keys()));
+                const typeMap = new Map();
+                for (const [name, info] of fields) {
+                    if (info.sqlType) {
+                        typeMap.set(name, info.sqlType);
+                    }
+                }
+                queryFieldTypesMap.set(queryReq.name, typeMap);
+            }
+            else if (queryReq.fields && queryReq.fields.length > 0) {
+                // Fallback: use fields directly from spec
+                queryFieldsMap.set(queryReq.name, new Set(queryReq.fields.map(f => f.name)));
+                const typeMap = new Map();
+                for (const f of queryReq.fields) {
+                    if (f.type) {
+                        typeMap.set(f.name, f.type);
+                    }
+                }
+                queryFieldTypesMap.set(queryReq.name, typeMap);
+            }
+        }
+        // Emit skip-with-warning for queries that were declared but have no field metadata
+        for (const queryReq of componentSpec.dataRequirements.queries) {
+            if (!queryFieldsMap.has(queryReq.name)) {
+                violations.push(createViolation('query-result-field-access-validation', 'low', null, `Unable to validate field access on query '${queryReq.name}' results — query field metadata not available. Add fields to dataRequirements.queries for accurate validation.`, queryReq.name));
+            }
+        }
+        // If we couldn't load any query field metadata, skip further validation
+        if (queryFieldsMap.size === 0) {
+            return violations;
+        }
+        // Track RunQuery result variables: varName -> queryName
+        const runQueryResultVars = new Map();
+        // Track .Results arrays: varName -> queryName
+        const queryArrayVars = new Map();
+        /**
+         * Validates a single field access on a query row variable.
+         */
+        function validateFieldAccess(node, paramName, queryName) {
+            const access = resolveMemberAccess(node);
+            if (!access || access.objectName !== paramName)
+                return;
+            const { propertyName } = access;
+            const validFields = queryFieldsMap.get(queryName);
+            if (!validFields)
+                return;
+            // Field exists — no violation
+            if (validFields.has(propertyName))
+                return;
+            // Check for case mismatch first (medium severity)
+            const caseFix = findCaseMismatch(propertyName, validFields);
+            if (caseFix) {
+                violations.push(createViolation('query-result-field-access-validation', 'medium', node, `Field "${propertyName}" on query "${queryName}" has incorrect casing. Did you mean "${caseFix}"?`, `${paramName}.${propertyName}`, {
+                    text: `Use the correct casing: "${caseFix}".`,
+                    example: `// Change:\n${paramName}.${propertyName}\n// To:\n${paramName}.${caseFix}`,
+                }));
+                return;
+            }
+            // Check for close typo via Levenshtein (high severity)
+            const closest = findClosestMatch(propertyName, validFields);
+            const availableFields = Array.from(validFields).slice(0, 10);
+            const moreText = validFields.size > 10 ? ` and ${validFields.size - 10} more` : '';
+            if (closest) {
+                violations.push(createViolation('query-result-field-access-validation', 'high', node, `Field "${propertyName}" does not exist on query "${queryName}". Did you mean "${closest}"? Available fields: ${availableFields.join(', ')}${moreText}`, `${paramName}.${propertyName}`, {
+                    text: `Replace "${propertyName}" with "${closest}".`,
+                    example: `// Change:\n${paramName}.${propertyName}\n// To:\n${paramName}.${closest}`,
+                }));
+            }
+            else {
+                violations.push(createViolation('query-result-field-access-validation', 'high', node, `Field "${propertyName}" does not exist on query "${queryName}". Available fields: ${availableFields.join(', ')}${moreText}`, `${paramName}.${propertyName}`, {
+                    text: `Use one of the valid fields from the "${queryName}" query.`,
+                }));
+            }
+        }
+        /**
+         * Checks for numeric coercion on GUID fields from query results.
+         */
+        function checkTypeCoercion(callNode, queryRowParams) {
+            if (!t.isIdentifier(callNode.callee))
+                return;
+            if (!NUMERIC_COERCION_FUNCTIONS.has(callNode.callee.name))
+                return;
+            if (callNode.arguments.length === 0)
+                return;
+            const arg = callNode.arguments[0];
+            if (!t.isMemberExpression(arg) && !t.isOptionalMemberExpression(arg))
+                return;
+            const access = resolveMemberAccess(arg);
+            if (!access)
+                return;
+            const queryName = queryRowParams.get(access.objectName);
+            if (!queryName)
+                return;
+            const typeMap = queryFieldTypesMap.get(queryName);
+            const sqlType = typeMap?.get(access.propertyName);
+            if (typeof sqlType === 'string' && sqlType.toLowerCase() === 'uniqueidentifier') {
+                violations.push(createViolation('query-result-field-access-validation', 'medium', callNode, `${callNode.callee.name}(${access.objectName}.${access.propertyName}) coerces a uniqueidentifier (GUID) to a number. GUIDs are strings, not numeric values.`, truncateCode(`${callNode.callee.name}(${access.objectName}.${access.propertyName})`), {
+                    text: `"${access.propertyName}" is a uniqueidentifier field. Use it as a string directly.`,
+                    example: `// Instead of:\n${callNode.callee.name}(${access.objectName}.${access.propertyName})\n// Use:\n${access.objectName}.${access.propertyName}  // Already a string`,
+                }));
+            }
+        }
+        /**
+         * Walks a callback body, validating all field accesses on known query row params.
+         */
+        function validateCallbackBody(body, paramNames, queryName) {
+            const queryRowParams = new Map();
+            for (const p of paramNames) {
+                queryRowParams.set(p, queryName);
+            }
+            traverse(body, {
+                MemberExpression(innerPath) {
+                    const objName = t.isIdentifier(innerPath.node.object) ? innerPath.node.object.name : null;
+                    if (objName && queryRowParams.has(objName)) {
+                        validateFieldAccess(innerPath.node, objName, queryName);
+                    }
+                },
+                OptionalMemberExpression(innerPath) {
+                    const objName = t.isIdentifier(innerPath.node.object) ? innerPath.node.object.name : null;
+                    if (objName && queryRowParams.has(objName)) {
+                        validateFieldAccess(innerPath.node, objName, queryName);
+                    }
+                },
+                CallExpression(innerPath) {
+                    checkTypeCoercion(innerPath.node, queryRowParams);
+                },
+                noScope: true,
+            });
+        }
+        // Main traversal
+        traverse(ast, {
+            VariableDeclarator(path) {
+                if (!t.isIdentifier(path.node.id))
+                    return;
+                const varName = path.node.id.name;
+                const init = path.node.init;
+                if (!init)
+                    return;
+                // Detect: const result = await utilities.rq.RunQuery({ QueryName: '...' })
+                if (t.isAwaitExpression(init) && t.isCallExpression(init.argument)) {
+                    const call = init.argument;
+                    if (t.isMemberExpression(call.callee) &&
+                        t.isMemberExpression(call.callee.object) &&
+                        t.isIdentifier(call.callee.property) &&
+                        call.callee.property.name === 'RunQuery') {
+                        if (call.arguments.length > 0 && t.isObjectExpression(call.arguments[0])) {
+                            for (const prop of call.arguments[0].properties) {
+                                if (t.isObjectProperty(prop) &&
+                                    t.isIdentifier(prop.key) &&
+                                    prop.key.name === 'QueryName' &&
+                                    t.isStringLiteral(prop.value)) {
+                                    runQueryResultVars.set(varName, prop.value.value);
+                                    break;
+                                }
+                            }
+                        }
+                    }
+                }
+                // Detect: const rows = result.Results  or  const rows = result?.Results
+                if (t.isMemberExpression(init) || t.isOptionalMemberExpression(init)) {
+                    if (t.isIdentifier(init.object) &&
+                        t.isIdentifier(init.property) &&
+                        init.property.name === 'Results') {
+                        const sourceVar = init.object.name;
+                        const queryName = runQueryResultVars.get(sourceVar);
+                        if (queryName) {
+                            queryArrayVars.set(varName, queryName);
+                        }
+                    }
+                }
+            },
+            CallExpression(path) {
+                if (!t.isMemberExpression(path.node.callee) &&
+                    !t.isOptionalMemberExpression(path.node.callee)) {
+                    return;
+                }
+                const callee = path.node.callee;
+                if (!t.isIdentifier(callee.property))
+                    return;
+                const methodName = callee.property.name;
+                if (!ARRAY_METHODS.includes(methodName))
+                    return;
+                let queryName;
+                // .map() etc. on a tracked array variable
+                if (t.isIdentifier(callee.object)) {
+                    queryName = queryArrayVars.get(callee.object.name);
+                }
+                // .Results.map() — direct chaining on result.Results or result?.Results
+                if ((t.isMemberExpression(callee.object) || t.isOptionalMemberExpression(callee.object)) &&
+                    t.isIdentifier(callee.object.object) &&
+                    t.isIdentifier(callee.object.property) &&
+                    callee.object.property.name === 'Results') {
+                    queryName = runQueryResultVars.get(callee.object.object.name);
+                }
+                if (!queryName)
+                    return;
+                if (path.node.arguments.length === 0)
+                    return;
+                const callback = path.node.arguments[0];
+                if (!t.isArrowFunctionExpression(callback) &&
+                    !t.isFunctionExpression(callback)) {
+                    return;
+                }
+                const paramNames = extractIterationParamNames(callback, methodName);
+                if (paramNames.length === 0)
+                    return;
+                validateCallbackBody(callback.body, paramNames, queryName);
+            },
+        });
+        return violations;
+    }
+};
+QueryResultFieldAccessValidationRule = __decorate([
+    RegisterClass(BaseLintRule, 'query-result-field-access-validation')
+], QueryResultFieldAccessValidationRule);
+export { QueryResultFieldAccessValidationRule };
+//# sourceMappingURL=query-result-field-access-validation.js.map

package/dist/lib/runtime-rules/query-result-field-access-validation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"query-result-field-access-validation.js","sourceRoot":"","sources":["../../../src/lib/runtime-rules/query-result-field-access-validation.ts"],"names":[],"mappings":";;;;;;AAAA,OAAO,EAAE,QAAQ,EAAY,eAAe,EAAE,YAAY,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,0BAA0B,EAAE,MAAM,eAAe,CAAC;AAClJ,OAAO,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AACvD,OAAO,KAAK,CAAC,MAAM,cAAc,CAAC;AAClC,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAE5C,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAG9C;;;;;;;;;;;;;;GAcG;AAEH,6EAA6E;AAC7E,MAAM,aAAa,GAAG,CAAC,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,SAAS,CAAC,CAAC;AAEzG;;;GAGG;AACH,SAAS,mBAAmB,CAC1B,IAAqD;IAErD,IAAI,IAAI,CAAC,QAAQ;QAAE,OAAO,IAAI,CAAC;IAC/B,IAAI,CAAC,CAAC,CAAC,YAAY,CAAC,IAAI,CAAC,QAAQ,CAAC;QAAE,OAAO,IAAI,CAAC;IAEhD,IAAI,CAAC,CAAC,YAAY,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;QAChC,OAAO;YACL,UAAU,EAAE,IAAI,CAAC,MAAM,CAAC,IAAI;YAC5B,YAAY,EAAE,IAAI,CAAC,QAAQ,CAAC,IAAI;SACjC,CAAC;IACJ,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAGD;;;GAGG;AACH,SAAS,0BAA0B,CACjC,QAA0D,EAC1D,UAAkB;IAElB,MAAM,MAAM,GAAa,EAAE,CAAC;IAE5B,IAAI,UAAU,KAAK,QAAQ,EAAE,CAAC;QAC5B,IAAI,QAAQ,CAAC,MAAM,CAAC,MAAM,IAAI,CAAC,IAAI,CAAC,CAAC,YAAY,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;YACtE,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;QACvC,CAAC;IACH,CAAC;SAAM,IAAI,UAAU,KAAK,MAAM,EAAE,CAAC;QACjC,KAAK,MAAM,KAAK,IAAI,QAAQ,CAAC,MAAM,EAAE,CAAC;YACpC,IAAI,CAAC,CAAC,YAAY,CAAC,KAAK,CAAC,EAAE,CAAC;gBAC1B,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;YAC1B,CAAC;QACH,CAAC;IACH,CAAC;SAAM,CAAC;QACN,IAAI,QAAQ,CAAC,MAAM,CAAC,MAAM,IAAI,CAAC,IAAI,CAAC,CAAC,YAAY,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;YACtE,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;QACvC,CAAC;IACH,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAGM,IAAM,oCAAoC,GAA1C,MAAM,oCAAqC,SAAQ,YAAY;IACpE,IAAI,IAAI,KAAK,OAAO,sCAAsC,CAAC,CAAC,CAAC;IAC7D,IAAI,SAAS,KAA+B,OAAO,KAAK,CAAC,CAAC,CAAC;IAE3D,IAAI,CAAC,GAAW,EAAE,cAAsB,EAAE,aAA6B;QACrE,MAAM,UAAU,GAAgB,EAAE,CAAC;QAEnC,4CAA4C;QAC5C,IAAI,CAAC,aAAa,EAAE,gBAAgB,EAAE,OAAO,IAAI,aAAa,CAAC,gBAAgB,CAAC,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACrG,OAAO,UAAU,CAAC;QACpB,CAAC;QAED,wEAAwE;QACxE,MAAM,cAAc,GAAG,IAAI,GAAG,EAAuB,CAAC;QACtD,MAAM,kBAAkB,GAAG,IAAI,GAAG,EAA+B,CAAC,CAAC,oCAAoC;QACvG,MAAM,WAAW,GAAG,IAAI,WAAW,CAAC,aAAa,CAAC,CAAC;QAEnD,KAAK,MAAM,QAAQ,IAAI,aAAa,CAAC,gBAAgB,CAAC,OAAO,EAAE,CAAC;YAC9D,mDAAmD;YACnD,MAAM,MAAM,GAAG,WAAW,CAAC,kBAAkB,CAAC,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC,YAAY,CAAC,CAAC;YACpF,IAAI,MAAM,IAAI,MAAM,CAAC,IAAI,GAAG,CAAC,EAAE,CAAC;gBAC9B,cAAc,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,EAAE,IAAI,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;gBAC1D,MAAM,OAAO,GAAG,IAAI,GAAG,EAAkB,CAAC;gBAC1C,KAAK,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,MAAM,EAAE,CAAC;oBAClC,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;wBACjB,OAAO,CAAC,GAAG,CAAC,IAAI,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;oBAClC,CAAC;gBACH,CAAC;gBACD,kBAAkB,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;YACjD,CAAC;iBAAM,IAAI,QAAQ,CAAC,MAAM,IAAI,QAAQ,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACzD,0CAA0C;gBAC1C,cAAc,CAAC,GAAG,CAChB,QAAQ,CAAC,IAAI,EACb,IAAI,GAAG,CAAC,QAAQ,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAC1C,CAAC;gBACF,MAAM,OAAO,GAAG,IAAI,GAAG,EAAkB,CAAC;gBAC1C,KAAK,MAAM,CAAC,IAAI,QAAQ,CAAC,MAAM,EAAE,CAAC;oBAChC,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC;wBACX,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC;oBAC9B,CAAC;gBACH,CAAC;gBACD,kBAAkB,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;YACjD,CAAC;QACH,CAAC;QAED,mFAAmF;QACnF,KAAK,MAAM,QAAQ,IAAI,aAAa,CAAC,gBAAgB,CAAC,OAAO,EAAE,CAAC;YAC9D,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;gBACvC,UAAU,CAAC,IAAI,CACb,eAAe,CACb,sCAAsC,EACtC,KAAK,EACL,IAAI,EACJ,6CAA6C,QAAQ,CAAC,IAAI,iHAAiH,EAC3K,QAAQ,CAAC,IAAI,CACd,CACF,CAAC;YACJ,CAAC;QACH,CAAC;QAED,wEAAwE;QACxE,IAAI,cAAc,CAAC,IAAI,KAAK,CAAC,EAAE,CAAC;YAC9B,OAAO,UAAU,CAAC;QACpB,CAAC;QAED,wDAAwD;QACxD,MAAM,kBAAkB,GAAG,IAAI,GAAG,EAAkB,CAAC;QACrD,8CAA8C;QAC9C,MAAM,cAAc,GAAG,IAAI,GAAG,EAAkB,CAAC;QAEjD;;WAEG;QACH,SAAS,mBAAmB,CAC1B,IAAqD,EACrD,SAAiB,EACjB,SAAiB;YAEjB,MAAM,MAAM,GAAG,mBAAmB,CAAC,IAAI,CAAC,CAAC;YACzC,IAAI,CAAC,MAAM,IAAI,MAAM,CAAC,UAAU,KAAK,SAAS;gBAAE,OAAO;YAEvD,MAAM,EAAE,YAAY,EAAE,GAAG,MAAM,CAAC;YAChC,MAAM,WAAW,GAAG,cAAc,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;YAClD,IAAI,CAAC,WAAW;gBAAE,OAAO;YAEzB,8BAA8B;YAC9B,IAAI,WAAW,CAAC,GAAG,CAAC,YAAY,CAAC;gBAAE,OAAO;YAE1C,kDAAkD;YAClD,MAAM,OAAO,GAAG,gBAAgB,CAAC,YAAY,EAAE,WAAW,CAAC,CAAC;YAC5D,IAAI,OAAO,EAAE,CAAC;gBACZ,UAAU,CAAC,IAAI,CACb,eAAe,CACb,sCAAsC,EACtC,QAAQ,EACR,IAAI,EACJ,UAAU,YAAY,eAAe,SAAS,yCAAyC,OAAO,IAAI,EAClG,GAAG,SAAS,IAAI,YAAY,EAAE,EAC9B;oBACE,IAAI,EAAE,4BAA4B,OAAO,IAAI;oBAC7C,OAAO,EAAE,eAAe,SAAS,IAAI,YAAY,aAAa,SAAS,IAAI,OAAO,EAAE;iBACrF,CACF,CACF,CAAC;gBACF,OAAO;YACT,CAAC;YAED,uDAAuD;YACvD,MAAM,OAAO,GAAG,gBAAgB,CAAC,YAAY,EAAE,WAAW,CAAC,CAAC;YAC5D,MAAM,eAAe,GAAG,KAAK,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YAC7D,MAAM,QAAQ,GAAG,WAAW,CAAC,IAAI,GAAG,EAAE,CAAC,CAAC,CAAC,QAAQ,WAAW,CAAC,IAAI,GAAG,EAAE,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC;YAEnF,IAAI,OAAO,EAAE,CAAC;gBACZ,UAAU,CAAC,IAAI,CACb,eAAe,CACb,sCAAsC,EACtC,MAAM,EACN,IAAI,EACJ,UAAU,YAAY,8BAA8B,SAAS,oBAAoB,OAAO,wBAAwB,eAAe,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,QAAQ,EAAE,EACvJ,GAAG,SAAS,IAAI,YAAY,EAAE,EAC9B;oBACE,IAAI,EAAE,YAAY,YAAY,WAAW,OAAO,IAAI;oBACpD,OAAO,EAAE,eAAe,SAAS,IAAI,YAAY,aAAa,SAAS,IAAI,OAAO,EAAE;iBACrF,CACF,CACF,CAAC;YACJ,CAAC;iBAAM,CAAC;gBACN,UAAU,CAAC,IAAI,CACb,eAAe,CACb,sCAAsC,EACtC,MAAM,EACN,IAAI,EACJ,UAAU,YAAY,8BAA8B,SAAS,wBAAwB,eAAe,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,QAAQ,EAAE,EAC5H,GAAG,SAAS,IAAI,YAAY,EAAE,EAC9B;oBACE,IAAI,EAAE,yCAAyC,SAAS,UAAU;iBACnE,CACF,CACF,CAAC;YACJ,CAAC;QACH,CAAC;QAED;;WAEG;QACH,SAAS,iBAAiB,CACxB,QAA0B,EAC1B,cAAmC;YAEnC,IAAI,CAAC,CAAC,CAAC,YAAY,CAAC,QAAQ,CAAC,MAAM,CAAC;gBAAE,OAAO;YAC7C,IAAI,CAAC,0BAA0B,CAAC,GAAG,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC;gBAAE,OAAO;YAClE,IAAI,QAAQ,CAAC,SAAS,CAAC,MAAM,KAAK,CAAC;gBAAE,OAAO;YAE5C,MAAM,GAAG,GAAG,QAAQ,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;YAClC,IAAI,CAAC,CAAC,CAAC,kBAAkB,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,0BAA0B,CAAC,GAAG,CAAC;gBAAE,OAAO;YAE7E,MAAM,MAAM,GAAG,mBAAmB,CAAC,GAAG,CAAC,CAAC;YACxC,IAAI,CAAC,MAAM;gBAAE,OAAO;YAEpB,MAAM,SAAS,GAAG,cAAc,CAAC,GAAG,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;YACxD,IAAI,CAAC,SAAS;gBAAE,OAAO;YAEvB,MAAM,OAAO,GAAG,kBAAkB,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;YAClD,MAAM,OAAO,GAAG,OAAO,EAAE,GAAG,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC;YAElD,IAAI,OAAO,OAAO,KAAK,QAAQ,IAAI,OAAO,CAAC,WAAW,EAAE,KAAK,kBAAkB,EAAE,CAAC;gBAChF,UAAU,CAAC,IAAI,CACb,eAAe,CACb,sCAAsC,EACtC,QAAQ,EACR,QAAQ,EACR,GAAG,QAAQ,CAAC,MAAM,CAAC,IAAI,IAAI,MAAM,CAAC,UAAU,IAAI,MAAM,CAAC,YAAY,yFAAyF,EAC5J,YAAY,CAAC,GAAG,QAAQ,CAAC,MAAM,CAAC,IAAI,IAAI,MAAM,CAAC,UAAU,IAAI,MAAM,CAAC,YAAY,GAAG,CAAC,EACpF;oBACE,IAAI,EAAE,IAAI,MAAM,CAAC,YAAY,6DAA6D;oBAC1F,OAAO,EAAE,mBAAmB,QAAQ,CAAC,MAAM,CAAC,IAAI,IAAI,MAAM,CAAC,UAAU,IAAI,MAAM,CAAC,YAAY,eAAe,MAAM,CAAC,UAAU,IAAI,MAAM,CAAC,YAAY,uBAAuB;iBAC3K,CACF,CACF,CAAC;YACJ,CAAC;QACH,CAAC;QAED;;WAEG;QACH,SAAS,oBAAoB,CAC3B,IAAY,EACZ,UAAoB,EACpB,SAAiB;YAEjB,MAAM,cAAc,GAAG,IAAI,GAAG,EAAkB,CAAC;YACjD,KAAK,MAAM,CAAC,IAAI,UAAU,EAAE,CAAC;gBAC3B,cAAc,CAAC,GAAG,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC;YACnC,CAAC;YAED,QAAQ,CAAC,IAAI,EAAE;gBACb,gBAAgB,CAAC,SAAuC;oBACtD,MAAM,OAAO,GAAG,CAAC,CAAC,YAAY,CAAC,SAAS,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC;oBAC1F,IAAI,OAAO,IAAI,cAAc,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC;wBAC3C,mBAAmB,CAAC,SAAS,CAAC,IAAI,EAAE,OAAO,EAAE,SAAS,CAAC,CAAC;oBAC1D,CAAC;gBACH,CAAC;gBACD,wBAAwB,CAAC,SAA+C;oBACtE,MAAM,OAAO,GAAG,CAAC,CAAC,YAAY,CAAC,SAAS,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC;oBAC1F,IAAI,OAAO,IAAI,cAAc,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC;wBAC3C,mBAAmB,CAAC,SAAS,CAAC,IAAI,EAAE,OAAO,EAAE,SAAS,CAAC,CAAC;oBAC1D,CAAC;gBACH,CAAC;gBACD,cAAc,CAAC,SAAqC;oBAClD,iBAAiB,CAAC,SAAS,CAAC,IAAI,EAAE,cAAc,CAAC,CAAC;gBACpD,CAAC;gBACD,OAAO,EAAE,IAAI;aACd,CAAC,CAAC;QACL,CAAC;QAED,iBAAiB;QACjB,QAAQ,CAAC,GAAG,EAAE;YACZ,kBAAkB,CAAC,IAAoC;gBACrD,IAAI,CAAC,CAAC,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;oBAAE,OAAO;gBAC1C,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC;gBAClC,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC;gBAC5B,IAAI,CAAC,IAAI;oBAAE,OAAO;gBAElB,2EAA2E;gBAC3E,IAAI,CAAC,CAAC,iBAAiB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,gBAAgB,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC;oBACnE,MAAM,IAAI,GAAG,IAAI,CAAC,QAAQ,CAAC;oBAC3B,IACE,CAAC,CAAC,kBAAkB,CAAC,IAAI,CAAC,MAAM,CAAC;wBACjC,CAAC,CAAC,kBAAkB,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC;wBACxC,CAAC,CAAC,YAAY,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC;wBACpC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,KAAK,UAAU,EACxC,CAAC;wBACD,IAAI,IAAI,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC,IAAI,CAAC,CAAC,kBAAkB,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;4BACzE,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,UAAU,EAAE,CAAC;gCAChD,IACE,CAAC,CAAC,gBAAgB,CAAC,IAAI,CAAC;oCACxB,CAAC,CAAC,YAAY,CAAC,IAAI,CAAC,GAAG,CAAC;oCACxB,IAAI,CAAC,GAAG,CAAC,IAAI,KAAK,WAAW;oCAC7B,CAAC,CAAC,eAAe,CAAC,IAAI,CAAC,KAAK,CAAC,EAC7B,CAAC;oCACD,kBAAkB,CAAC,GAAG,CAAC,OAAO,EAAE,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;oCAClD,MAAM;gCACR,CAAC;4BACH,CAAC;wBACH,CAAC;oBACH,CAAC;gBACH,CAAC;gBAED,wEAAwE;gBACxE,IAAI,CAAC,CAAC,kBAAkB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,0BAA0B,CAAC,IAAI,CAAC,EAAE,CAAC;oBACrE,IACE,CAAC,CAAC,YAAY,CAAC,IAAI,CAAC,MAAM,CAAC;wBAC3B,CAAC,CAAC,YAAY,CAAC,IAAI,CAAC,QAAQ,CAAC;wBAC7B,IAAI,CAAC,QAAQ,CAAC,IAAI,KAAK,SAAS,EAChC,CAAC;wBACD,MAAM,SAAS,GAAG,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC;wBACnC,MAAM,SAAS,GAAG,kBAAkB,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;wBACpD,IAAI,SAAS,EAAE,CAAC;4BACd,cAAc,CAAC,GAAG,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC;wBACzC,CAAC;oBACH,CAAC;gBACH,CAAC;YACH,CAAC;YAED,cAAc,CAAC,IAAgC;gBAC7C,IACE,CAAC,CAAC,CAAC,kBAAkB,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC;oBACvC,CAAC,CAAC,CAAC,0BAA0B,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,EAC/C,CAAC;oBACD,OAAO;gBACT,CAAC;gBAED,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC;gBAChC,IAAI,CAAC,CAAC,CAAC,YAAY,CAAC,MAAM,CAAC,QAAQ,CAAC;oBAAE,OAAO;gBAE7C,MAAM,UAAU,GAAG,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC;gBACxC,IAAI,CAAC,aAAa,CAAC,QAAQ,CAAC,UAAU,CAAC;oBAAE,OAAO;gBAEhD,IAAI,SAA6B,CAAC;gBAElC,0CAA0C;gBAC1C,IAAI,CAAC,CAAC,YAAY,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC;oBAClC,SAAS,GAAG,cAAc,CAAC,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;gBACrD,CAAC;gBAED,wEAAwE;gBACxE,IACE,CAAC,CAAC,CAAC,kBAAkB,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,0BAA0B,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;oBACpF,CAAC,CAAC,YAAY,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC;oBACpC,CAAC,CAAC,YAAY,CAAC,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC;oBACtC,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,KAAK,SAAS,EACzC,CAAC;oBACD,SAAS,GAAG,kBAAkB,CAAC,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;gBAChE,CAAC;gBAED,IAAI,CAAC,SAAS;oBAAE,OAAO;gBACvB,IAAI,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,KAAK,CAAC;oBAAE,OAAO;gBAE7C,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;gBACxC,IACE,CAAC,CAAC,CAAC,yBAAyB,CAAC,QAAQ,CAAC;oBACtC,CAAC,CAAC,CAAC,oBAAoB,CAAC,QAAQ,CAAC,EACjC,CAAC;oBACD,OAAO;gBACT,CAAC;gBAED,MAAM,UAAU,GAAG,0BAA0B,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC;gBACpE,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC;oBAAE,OAAO;gBAEpC,oBAAoB,CAAC,QAAQ,CAAC,IAAI,EAAE,UAAU,EAAE,SAAS,CAAC,CAAC;YAC7D,CAAC;SACF,CAAC,CAAC;QAEH,OAAO,UAAU,CAAC;IAClB,CAAC;CACJ,CAAA;AA3TY,oCAAoC;IADhD,aAAa,CAAC,YAAY,EAAE,sCAAsC,CAAC;GACvD,oCAAoC,CA2ThD"}

package/dist/lib/runtime-rules/react-component-naming.d.ts

@@ -0,0 +1,19 @@
+import * as t from '@babel/types';
+import { BaseLintRule } from '../lint-rule.js';
+import { Violation } from '../component-linter.js';
+/**
+ * Rule: react-component-naming
+ *
+ * Ensures that React components follow naming conventions:
+ * - Component names must start with an uppercase letter
+ * - JSX treats lowercase as HTML elements
+ *
+ * Severity: critical
+ * Applies to: all components
+ */
+export declare class ReactComponentNamingRule extends BaseLintRule {
+    get Name(): string;
+    get AppliesTo(): 'all' | 'child' | 'root';
+    Test(ast: t.File, componentName: string): Violation[];
+}
+//# sourceMappingURL=react-component-naming.d.ts.map

package/dist/lib/runtime-rules/react-component-naming.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"react-component-naming.d.ts","sourceRoot":"","sources":["../../../src/lib/runtime-rules/react-component-naming.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,CAAC,MAAM,cAAc,CAAC;AAClC,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAGhD;;;;;;;;;GASG;AACH,qBACa,wBAAyB,SAAQ,YAAY;IACxD,IAAI,IAAI,WAAuC;IAC/C,IAAI,SAAS,IAAI,KAAK,GAAG,OAAO,GAAG,MAAM,CAAkB;IAE3D,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,IAAI,EAAE,aAAa,EAAE,MAAM,GAAG,SAAS,EAAE;CAwEtD"}

package/dist/lib/runtime-rules/react-component-naming.js

@@ -0,0 +1,72 @@
+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 * as t from '@babel/types';
+import { BaseLintRule } from '../lint-rule.js';
+import { traverse, createViolation } from '../lint-utils.js';
+/**
+ * Rule: react-component-naming
+ *
+ * Ensures that React components follow naming conventions:
+ * - Component names must start with an uppercase letter
+ * - JSX treats lowercase as HTML elements
+ *
+ * Severity: critical
+ * Applies to: all components
+ */
+let ReactComponentNamingRule = class ReactComponentNamingRule extends BaseLintRule {
+    get Name() { return 'react-component-naming'; }
+    get AppliesTo() { return 'all'; }
+    Test(ast, componentName) {
+        const violations = [];
+        traverse(ast, {
+            FunctionDeclaration(path) {
+                if (path.node.id && path.node.id.name === componentName) {
+                    // Check if it's the main component function
+                    const funcName = path.node.id.name;
+                    // Check if function has component-like parameters (props structure)
+                    const firstParam = path.node.params[0];
+                    const hasComponentProps = firstParam && (t.isObjectPattern(firstParam) || t.isIdentifier(firstParam));
+                    if (hasComponentProps && funcName[0] !== funcName[0].toUpperCase()) {
+                        violations.push(createViolation('react-component-naming', 'critical', path.node.id, `React component "${funcName}" must start with uppercase. JSX treats lowercase as HTML elements.`, `function ${funcName[0].toUpperCase()}${funcName.slice(1)}`));
+                    }
+                }
+                // Also check for any other component-like functions
+                if (path.node.id && path.node.params[0]) {
+                    const funcName = path.node.id.name;
+                    const firstParam = path.node.params[0];
+                    // Check if it looks like a component (has props parameter and returns JSX)
+                    let returnsJSX = false;
+                    path.traverse({
+                        ReturnStatement(returnPath) {
+                            if (returnPath.node.argument && t.isJSXElement(returnPath.node.argument)) {
+                                returnsJSX = true;
+                            }
+                        },
+                    });
+                    if (returnsJSX && t.isObjectPattern(firstParam)) {
+                        // Check if any props match component prop pattern
+                        const propNames = firstParam.properties
+                            .filter((p) => t.isObjectProperty(p))
+                            .filter((p) => t.isIdentifier(p.key))
+                            .map((p) => p.key.name);
+                        const hasComponentLikeProps = propNames.some((name) => ['utilities', 'styles', 'components', 'callbacks', 'savedUserSettings', 'onSaveUserSettings'].includes(name));
+                        if (hasComponentLikeProps && funcName[0] !== funcName[0].toUpperCase()) {
+                            violations.push(createViolation('react-component-naming', 'critical', path.node.id, `Function "${funcName}" appears to be a React component and must start with uppercase.`, `function ${funcName[0].toUpperCase()}${funcName.slice(1)}`));
+                        }
+                    }
+                }
+            },
+        });
+        return violations;
+    }
+};
+ReactComponentNamingRule = __decorate([
+    RegisterClass(BaseLintRule, 'react-component-naming')
+], ReactComponentNamingRule);
+export { ReactComponentNamingRule };
+//# sourceMappingURL=react-component-naming.js.map

package/dist/lib/runtime-rules/react-component-naming.js.map

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

package/dist/lib/runtime-rules/react-hooks-rules.d.ts

@@ -0,0 +1,27 @@
+import * as t from '@babel/types';
+import { BaseLintRule } from '../lint-rule.js';
+import { Violation } from '../component-linter.js';
+/**
+ * Rule: react-hooks-rules
+ *
+ * Enforces the Rules of Hooks:
+ * 1. Only call hooks at the top level (not inside loops, conditions, or nested functions)
+ * 2. Only call hooks from React functions (components or custom hooks)
+ * 3. Hooks must be called in the same order on every render
+ *
+ * Detects:
+ * - Hooks called inside non-component/non-hook functions
+ * - Hooks called conditionally (if statements, ternary, logical expressions)
+ * - Hooks called inside loops
+ * - Hooks called inside try/catch blocks (high severity warning)
+ * - Hooks called after conditional early returns
+ *
+ * Severity: critical (most violations), high (try/catch blocks)
+ * Applies to: all components
+ */
+export declare class ReactHooksRulesRule extends BaseLintRule {
+    get Name(): string;
+    get AppliesTo(): 'all' | 'child' | 'root';
+    Test(ast: t.File, componentName: string): Violation[];
+}
+//# sourceMappingURL=react-hooks-rules.d.ts.map

package/dist/lib/runtime-rules/react-hooks-rules.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"react-hooks-rules.d.ts","sourceRoot":"","sources":["../../../src/lib/runtime-rules/react-hooks-rules.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,CAAC,MAAM,cAAc,CAAC;AAClC,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAgChD;;;;;;;;;;;;;;;;;GAiBG;AACH,qBACa,mBAAoB,SAAQ,YAAY;IACnD,IAAI,IAAI,WAAkC;IAC1C,IAAI,SAAS,IAAI,KAAK,GAAG,OAAO,GAAG,MAAM,CAAkB;IAE3D,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,IAAI,EAAE,aAAa,EAAE,MAAM,GAAG,SAAS,EAAE;CAqLtD"}