@memberjunction/react-linter 0.0.1 → 5.38.0

package/dist/runtime-rules/ai-tools-availability-check.js

@@ -0,0 +1,223 @@
+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 } from '../lint-utils.js';
+import * as t from '@babel/types';
+import { RegisterClass } from '@memberjunction/global';
+import { BaseLintRule } from '../lint-rule.js';
+/**
+ * Rule: ai-tools-availability-check
+ *
+ * Checks that `utilities.ai` is guarded with a null/undefined check before use.
+ * The `ai` property on the utilities object may be undefined if the AI tools
+ * are not configured or available. Accessing methods on it without a guard
+ * will throw a runtime error.
+ *
+ * Correct patterns:
+ *   if (utilities.ai) { await utilities.ai.ExecutePrompt(...); }
+ *   const result = await utilities.ai?.ExecutePrompt(...);
+ *
+ * Incorrect pattern:
+ *   const result = await utilities.ai.ExecutePrompt(...);
+ *
+ * Severity: medium
+ * Applies to: all components
+ */
+/**
+ * Checks if a NodePath is inside a guard that checks `utilities.ai` for truthiness.
+ * Recognized guard patterns:
+ *   - if (utilities.ai) { ... }
+ *   - if (utilities.ai != null) { ... }
+ *   - utilities.ai && ...
+ */
+function isInsideAiGuard(path) {
+    let current = path.parentPath;
+    while (current) {
+        // Check if statements
+        if (current.isIfStatement()) {
+            if (testChecksUtilitiesAi(current.node.test)) {
+                if (isInConsequent(path.node, current.node)) {
+                    return true;
+                }
+            }
+        }
+        // Check logical && guards: utilities.ai && utilities.ai.ExecutePrompt(...)
+        if (current.isLogicalExpression() && current.node.operator === '&&') {
+            if (testChecksUtilitiesAi(current.node.left)) {
+                return true;
+            }
+        }
+        // Check ternary: utilities.ai ? utilities.ai.ExecutePrompt(...) : null
+        if (current.isConditionalExpression()) {
+            if (testChecksUtilitiesAi(current.node.test)) {
+                return true;
+            }
+        }
+        // Check try/catch: try { utilities.ai.ExecutePrompt(...) } catch { ... }
+        if (current.isTryStatement()) {
+            return true;
+        }
+        // Check for early-return guard in enclosing function:
+        // if (!utilities.ai) return;  OR  if (!utilities.ai) { return; }
+        if (current.isFunction()) {
+            const body = current.get('body');
+            if (body && !Array.isArray(body) && body.isBlockStatement()) {
+                for (const stmt of body.get('body')) {
+                    if (stmt.isIfStatement()) {
+                        const test = stmt.node.test;
+                        // Check for: if (!utilities.ai) return;
+                        if (t.isUnaryExpression(test) && test.operator === '!' && isUtilitiesAiAccess(test.argument)) {
+                            return true;
+                        }
+                        // Check for: if (utilities.ai == null) return;
+                        if (t.isBinaryExpression(test) && (test.operator === '==' || test.operator === '===')) {
+                            if (isUtilitiesAiAccess(test.left) &&
+                                (t.isNullLiteral(test.right) || (t.isIdentifier(test.right) && test.right.name === 'undefined'))) {
+                                return true;
+                            }
+                        }
+                    }
+                }
+            }
+            // Stop walking up past the function boundary
+            break;
+        }
+        current = current.parentPath;
+    }
+    return false;
+}
+/**
+ * Checks if a test expression is checking `utilities.ai` for truthiness.
+ */
+function testChecksUtilitiesAi(test) {
+    // Direct: utilities.ai
+    if (isUtilitiesAiAccess(test)) {
+        return true;
+    }
+    // Negated null check: utilities.ai != null  or  utilities.ai !== null
+    // Also: utilities.ai !== undefined
+    if (t.isBinaryExpression(test) && (test.operator === '!=' || test.operator === '!==')) {
+        if (isUtilitiesAiAccess(test.left) &&
+            (t.isNullLiteral(test.right) || (t.isIdentifier(test.right) && test.right.name === 'undefined'))) {
+            return true;
+        }
+    }
+    // Logical AND chain
+    if (t.isLogicalExpression(test) && test.operator === '&&') {
+        return testChecksUtilitiesAi(test.left) || testChecksUtilitiesAi(test.right);
+    }
+    return false;
+}
+/**
+ * Checks if a node is `utilities.ai` member expression.
+ */
+function isUtilitiesAiAccess(node) {
+    return (t.isMemberExpression(node) &&
+        t.isIdentifier(node.object) &&
+        node.object.name === 'utilities' &&
+        t.isIdentifier(node.property) &&
+        node.property.name === 'ai');
+}
+/**
+ * Checks if targetNode is within the consequent (true branch) of an if statement.
+ */
+function isInConsequent(targetNode, ifStatement) {
+    let found = false;
+    traverse(ifStatement.consequent, {
+        enter(innerPath) {
+            if (innerPath.node === targetNode) {
+                found = true;
+                innerPath.stop();
+            }
+        },
+        noScope: true,
+    });
+    return found;
+}
+/**
+ * Checks if a MemberExpression accesses a property/method on utilities.ai
+ * (i.e., utilities.ai.SomeMethod or utilities.ai.someProperty).
+ */
+function isUtilitiesAiMethodAccess(node) {
+    // The object should be utilities.ai
+    return isUtilitiesAiAccess(node.object);
+}
+/**
+ * Checks if the access uses optional chaining at the ai level.
+ * Pattern: utilities.ai?.ExecutePrompt(...)
+ * In the AST this appears as an OptionalMemberExpression chain.
+ */
+function isOptionalAiAccess(path) {
+    // Check if parent is an optional call expression chained from utilities.ai
+    // Pattern: utilities.ai?.method() results in OptionalCallExpression
+    const parent = path.parent;
+    if (t.isOptionalCallExpression(parent) || t.isOptionalMemberExpression(parent)) {
+        return true;
+    }
+    // Check if the utilities.ai part itself is optional: utilities?.ai?.method()
+    if (t.isOptionalMemberExpression(path.node.object)) {
+        return true;
+    }
+    return false;
+}
+let AiToolsAvailabilityCheckRule = class AiToolsAvailabilityCheckRule extends BaseLintRule {
+    get Name() { return 'ai-tools-availability-check'; }
+    get AppliesTo() { return 'all'; }
+    Test(ast) {
+        const violations = [];
+        // First pass: count total utilities.ai accesses (guarded and unguarded)
+        // If the component uses utilities.ai extensively, it's designed for AI environments
+        let totalAiAccesses = 0;
+        traverse(ast, {
+            MemberExpression(path) {
+                if (isUtilitiesAiMethodAccess(path.node))
+                    totalAiAccesses++;
+            },
+            OptionalMemberExpression(path) {
+                const node = path.node;
+                if (node.object && isUtilitiesAiAccess(node.object))
+                    totalAiAccesses++;
+            },
+        });
+        // If >=3 total accesses, the component is designed for AI environments — skip
+        if (totalAiAccesses >= 3)
+            return violations;
+        traverse(ast, {
+            MemberExpression(path) {
+                // We want to find utilities.ai.SomeMethod or utilities.ai.someProp
+                if (!isUtilitiesAiMethodAccess(path.node))
+                    return;
+                // Skip if using optional chaining
+                if (isOptionalAiAccess(path))
+                    return;
+                // Skip if inside a guard
+                if (isInsideAiGuard(path))
+                    return;
+                const propertyName = t.isIdentifier(path.node.property)
+                    ? path.node.property.name
+                    : '(computed)';
+                violations.push({
+                    rule: 'ai-tools-availability-check',
+                    severity: 'medium',
+                    line: path.node.loc?.start.line ?? 0,
+                    column: path.node.loc?.start.column ?? 0,
+                    message: `Accessing "utilities.ai.${propertyName}" without checking if utilities.ai is available. The ai tools may be undefined if not configured.`,
+                    code: `utilities.ai.${propertyName}`,
+                    suggestion: {
+                        text: `Add a null check before accessing utilities.ai`,
+                        example: `if (utilities.ai) {\n  const result = await utilities.ai.${propertyName}(...);\n}`,
+                    },
+                });
+            },
+        });
+        return violations;
+    }
+};
+AiToolsAvailabilityCheckRule = __decorate([
+    RegisterClass(BaseLintRule, 'ai-tools-availability-check')
+], AiToolsAvailabilityCheckRule);
+export { AiToolsAvailabilityCheckRule };
+//# sourceMappingURL=ai-tools-availability-check.js.map

package/dist/runtime-rules/ai-tools-availability-check.js.map

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

package/dist/runtime-rules/callback-event-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: callback-event-validation
+ *
+ * Consolidated rule that replaces four separate rules:
+ * - callback-parameter-validation: validates callback method parameter counts and types
+ * - callbacks-passthrough-only: ensures callbacks are passed through unchanged to children
+ * - callbacks-usage-validation: validates callbacks are only accessed via allowed methods
+ * - event-invocation-pattern: ensures event props are null-checked before invocation
+ *
+ * Severity: critical / high / medium / low (varies by check)
+ * Applies to: all components
+ */
+export declare class CallbackEventValidationRule extends BaseLintRule {
+    get Name(): string;
+    get AppliesTo(): 'all' | 'child' | 'root';
+    Test(ast: t.File, _componentName: string, componentSpec?: ComponentSpec): Violation[];
+}
+//# sourceMappingURL=callback-event-validation.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"callback-event-validation.d.ts","sourceRoot":"","sources":["../../src/runtime-rules/callback-event-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,EAAE,MAAM,6CAA6C,CAAC;AAc5E;;;;;;;;;;;GAWG;AACH,qBACa,2BAA4B,SAAQ,YAAY;IAC3D,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;CAgCtF"}