@memberjunction/react-test-harness 5.36.0 → 5.38.0

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

@@ -1,223 +0,0 @@
-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/lib/runtime-rules/ai-tools-availability-check.js.map

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

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

@@ -1,22 +0,0 @@
-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/lib/runtime-rules/callback-event-validation.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"callback-event-validation.d.ts","sourceRoot":"","sources":["../../../src/lib/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"}