@eventra_dev/eventra-cli 1.0.4 → 1.0.6

package/README.md

@@ -206,11 +206,12 @@ pnpm add -D @eventra_dev/cli-plugin-vue
 
 The plugin:
 
-- splits each `.vue` file into virtual TypeScript modules (`App.vue.ts`, `App.vue.template.ts`)
-- extracts `track()` calls from `<script>` blocks
-- detects static `event="feature_name"` attributes in `<template>` (literals only)
+- parses each `.vue` file with the real Vue compiler (`@vue/compiler-sfc`) into a single virtual TypeScript module combining `<script>`/`<script setup>`
+- extracts `track()` calls from the script exactly like a regular `.ts` file (direct calls, wrappers, propagation)
+- detects `event="feature_name"` attributes in `<template>` — both literal and dynamic (`:event="expr"`); dynamic bindings resolve through the same module scope as the script, or surface as a dynamic occurrence if unresolvable
+- Nuxt `.vue` files (pages/layouts/components) are handled the same way; auto-imported composables resolve once the project has run `nuxt prepare`/`nuxt dev`
 
-`sync.include` does **not** need `**/*.vue` manually — the plugin registers `**/*.vue` via `includeGlobs`.
+`sync.include` does **not** need `**/*.vue` manually — the plugin registers `**/*.vue` via `includeGlobs`. See [`@eventra_dev/cli-plugin-vue`](https://www.npmjs.com/package/@eventra_dev/cli-plugin-vue) for details.
 
 ### Before publishing / local development
 

package/dist/analysis/extractor/extractor.js

@@ -9,8 +9,10 @@ const resolver_1 = require("../resolver/resolver");
 const evaluationContext_1 = require("../shared/evaluationContext");
 const propagationExtractor_1 = require("./propagationExtractor");
 const eventValidation_1 = require("../shared/eventValidation");
+const dynamicOccurrence_1 = require("../shared/dynamicOccurrence");
 function extractEvents(index, checker, _config, evaluationCache, exportCache, resolvedCallCache, returnPropagationCache, wrapperRegistry) {
     const events = new Set();
+    const dynamicOccurrences = [];
     // direct track sinks
     for (const call of index.trackCalls) {
         for (const argument of call.trackedArguments) {
@@ -21,12 +23,15 @@ function extractEvents(index, checker, _config, evaluationCache, exportCache, re
                     events.add(normalized);
                 }
             }
+            if (resolved.dynamic) {
+                (0, dynamicOccurrence_1.recordDynamicOccurrence)(call.node, resolved.values, dynamicOccurrences);
+            }
         }
     }
     const propagationVisited = new Set();
     function visit(node) {
         if (typescript_1.default.isCallExpression(node)) {
-            (0, propagationExtractor_1.extractPropagationEvents)(node, checker, wrapperRegistry, resolvedCallCache, returnPropagationCache, evaluationCache, exportCache, events, propagationVisited);
+            (0, propagationExtractor_1.extractPropagationEvents)(node, checker, wrapperRegistry, resolvedCallCache, returnPropagationCache, evaluationCache, exportCache, events, propagationVisited, dynamicOccurrences);
         }
         typescript_1.default.forEachChild(node, visit);
     }
@@ -34,5 +39,6 @@ function extractEvents(index, checker, _config, evaluationCache, exportCache, re
     return {
         events,
         detectedFunctionWrappers: new Set(index.wrappers.map(wrapper => wrapper.symbol.getName())),
+        dynamicOccurrences,
     };
 }

package/dist/analysis/extractor/propagationExtractor.js

@@ -9,6 +9,7 @@ const callResolver_1 = require("../resolver/callResolver");
 const resolver_1 = require("../resolver/resolver");
 const evaluationContext_1 = require("../shared/evaluationContext");
 const eventValidation_1 = require("../shared/eventValidation");
+const dynamicOccurrence_1 = require("../shared/dynamicOccurrence");
 function resolveObjectPath(expression, path) {
     let current = expression;
     for (const segment of path) {
@@ -34,7 +35,7 @@ function resolveObjectPath(expression, path) {
     }
     return current;
 }
-function extractPropagationEvents(call, checker, wrapperRegistry, resolvedCallCache, returnPropagationCache, evaluationCache, exportCache, events, visited) {
+function extractPropagationEvents(call, checker, wrapperRegistry, resolvedCallCache, returnPropagationCache, evaluationCache, exportCache, events, visited, dynamicOccurrences) {
     const resolved = (0, callResolver_1.resolveFunctionFromCall)(call.expression, checker, resolvedCallCache, exportCache);
     if (!resolved) {
         return;
@@ -53,14 +54,14 @@ function extractPropagationEvents(call, checker, wrapperRegistry, resolvedCallCa
     visited.add(signature);
     try {
         for (const propagation of semantic.propagations) {
-            extractPropagation(propagation, call, checker, evaluationCache, resolvedCallCache, returnPropagationCache, exportCache, events);
+            extractPropagation(propagation, call, checker, evaluationCache, resolvedCallCache, returnPropagationCache, exportCache, events, dynamicOccurrences);
         }
     }
     finally {
         visited.delete(signature);
     }
 }
-function extractPropagation(propagation, call, checker, evaluationCache, resolvedCallCache, returnPropagationCache, exportCache, events) {
+function extractPropagation(propagation, call, checker, evaluationCache, resolvedCallCache, returnPropagationCache, exportCache, events, dynamicOccurrences) {
     let argument = call.arguments[propagation.sourceParameterIndex];
     if (!argument) {
         return;
@@ -89,4 +90,7 @@ function extractPropagation(propagation, call, checker, evaluationCache, resolve
             events.add(normalized);
         }
     }
+    if (resolved.dynamic) {
+        (0, dynamicOccurrence_1.recordDynamicOccurrence)(call, resolved.values, dynamicOccurrences);
+    }
 }

package/dist/analysis/resolver/exportResolver.js

@@ -15,6 +15,42 @@ function isConcreteDeclaration(node) {
         || typescript_1.default.isMethodDeclaration(node)
         || typescript_1.default.isPropertyDeclaration(node));
 }
+/**
+ * `declare const x: typeof import("./module")["name"]` (or the dotted form,
+ * `typeof import("./module").name`) is how Nuxt/unplugin-auto-import
+ * generate global ambient bindings for auto-imported exports. A `const`
+ * with no initializer is only legal in an ambient context, so this shape is
+ * unambiguous. Without unwrapping it, this ambient variable is its own
+ * distinct symbol — the wrapper/export registered under the *real*
+ * declaration's symbol would never match a call site that resolves to the
+ * ambient one instead.
+ */
+function resolveAmbientAutoImportSymbol(symbol, checker) {
+    const declarations = symbol.getDeclarations();
+    if (!declarations || declarations.length !== 1) {
+        return null;
+    }
+    const [declaration] = declarations;
+    if (!typescript_1.default.isVariableDeclaration(declaration) || declaration.initializer || !declaration.type) {
+        return null;
+    }
+    let nameNode;
+    const type = declaration.type;
+    if (typescript_1.default.isImportTypeNode(type) && type.qualifier && typescript_1.default.isIdentifier(type.qualifier)) {
+        nameNode = type.qualifier;
+    }
+    else if (typescript_1.default.isIndexedAccessTypeNode(type)
+        && typescript_1.default.isImportTypeNode(type.objectType)
+        && typescript_1.default.isLiteralTypeNode(type.indexType)
+        && typescript_1.default.isStringLiteral(type.indexType.literal)) {
+        nameNode = type.indexType.literal;
+    }
+    if (!nameNode) {
+        return null;
+    }
+    const resolved = checker.getSymbolAtLocation(nameNode);
+    return resolved && resolved !== symbol ? resolved : null;
+}
 function resolveExportedSymbol(symbol, checker, cache, visited) {
     if (typeof symbol.getDeclarations !== "function") {
         return null;
@@ -44,6 +80,13 @@ function resolveExportedSymbol(symbol, checker, cache, visited) {
         cache.set(symbol, resolved);
         return resolved;
     }
+    // ambient auto-import unwrap (Nuxt/unplugin-auto-import style globals)
+    const ambientTarget = resolveAmbientAutoImportSymbol(symbol, checker);
+    if (ambientTarget) {
+        const resolved = resolveExportedSymbol(ambientTarget, checker, cache, seen);
+        cache.set(symbol, resolved);
+        return resolved;
+    }
     // declaration existence
     const declarations = symbol.getDeclarations() ?? [];
     for (const declaration of declarations) {

package/dist/analysis/scanner/scanner.js

@@ -72,7 +72,8 @@ function scanSource(source, checker, wrapperRegistry, plugins) {
             }
             return false;
         });
-        const wrapper = (0, propagationAnalyzer_1.analyzeWrapperPropagation)(fn, checker, localSinks);
+        const wrapper = plugins.detectWrapper({ fn, checker, sinks: localSinks }) ??
+            (0, propagationAnalyzer_1.analyzeWrapperPropagation)(fn, checker, localSinks);
         if (!wrapper) {
             continue;
         }

package/dist/analysis/shared/dynamicOccurrence.js

@@ -0,0 +1,22 @@
+"use strict";
+// src/analysis/shared/dynamicOccurrence.ts
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.recordDynamicOccurrence = recordDynamicOccurrence;
+const typescript_1 = __importDefault(require("typescript"));
+const CALL_TEXT_MAX_LENGTH = 120;
+function recordDynamicOccurrence(call, resolvedValues, out) {
+    const sourceFile = call.getSourceFile();
+    const { line, character } = typescript_1.default.getLineAndCharacterOfPosition(sourceFile, call.getStart(sourceFile));
+    const callText = call.getText(sourceFile);
+    out.push({
+        fileName: sourceFile.fileName,
+        line: line + 1,
+        character,
+        calleeText: call.expression.getText(sourceFile),
+        callText: callText.length > CALL_TEXT_MAX_LENGTH ? `${callText.slice(0, CALL_TEXT_MAX_LENGTH)}…` : callText,
+        resolvedValues,
+    });
+}

package/dist/cli/check.js

@@ -21,7 +21,8 @@ async function check({ fix = false }) {
         process.exit(1);
     }
     console.log(chalk_1.default.blue("Checking events and function wrappers..."));
-    const { engine } = await (0, projectScanner_1.scanProject)(config);
+    const { engine, plugins } = await (0, projectScanner_1.scanProject)(config);
+    await plugins.runDynamicEventReporters(engine.getAllDynamicOccurrences());
     const foundEvents = new Set(engine.getAllEvents());
     const knownEvents = new Set(config.events ?? []);
     const eventDiff = diffSets(foundEvents, knownEvents);

package/dist/cli/sync.js

@@ -15,9 +15,10 @@ async function sync() {
         return;
     }
     console.log(chalk_1.default.blue("Scanning..."));
-    const { engine } = await (0, projectScanner_1.scanProject)(config);
+    const { engine, plugins } = await (0, projectScanner_1.scanProject)(config);
     await (0, scanResults_1.persistScanResults)(config, engine);
     const events = engine.getAllEvents();
     const wrappers = engine.getAllFunctionWrappers();
     console.log(chalk_1.default.green(`Found ${events.length} events, ${wrappers.length} function wrappers`));
+    await plugins.runDynamicEventReporters(engine.getAllDynamicOccurrences());
 }

package/dist/core/EventraEngine.js

@@ -20,6 +20,7 @@ const loadPlugins_1 = require("../plugin/loadPlugins");
 const EMPTY_RESULT = () => ({
     events: new Set(),
     detectedFunctionWrappers: new Set(),
+    dynamicOccurrences: [],
 });
 class EventraEngine {
     compiler;
@@ -253,5 +254,12 @@ class EventraEngine {
     getScanResult(fileName) {
         return this.fileResults.get(this.normalize(fileName)) ?? EMPTY_RESULT();
     }
+    getAllDynamicOccurrences() {
+        const occurrences = [];
+        for (const result of this.fileResults.values()) {
+            occurrences.push(...result.dynamicOccurrences);
+        }
+        return occurrences.sort((a, b) => a.fileName.localeCompare(b.fileName) || a.line - b.line);
+    }
 }
 exports.EventraEngine = EventraEngine;

package/dist/core/projectScanner.js

@@ -76,5 +76,6 @@ async function scanProject(config) {
         engine,
         results,
         files,
+        plugins,
     };
 }

package/dist/plugin/adapters/external.js

@@ -48,10 +48,6 @@ function createStaticCalleeSinkDetector(sink) {
             if (call.arguments.length <= argIndex) {
                 return null;
             }
-            const arg = call.arguments[argIndex];
-            if (!typescript_1.default.isStringLiteral(arg)) {
-                return null;
-            }
             return {
                 call,
                 trackedArguments: [{ index: argIndex, propertyPath: [] }],

package/dist/plugin/builtins/consoleDynamicEventReporter.js

@@ -0,0 +1,24 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerConsoleDynamicEventReporterPlugin = registerConsoleDynamicEventReporterPlugin;
+const chalk_1 = __importDefault(require("chalk"));
+const consoleDynamicEventReporter = {
+    name: "console",
+    report({ occurrences }) {
+        if (occurrences.length === 0) {
+            return;
+        }
+        console.log(chalk_1.default.blue("\nDynamic event names:"));
+        for (const occ of occurrences) {
+            const values = occ.resolvedValues.length > 0 ? ` (resolved: ${occ.resolvedValues.join(", ")})` : "";
+            console.log(chalk_1.default.yellow(`~ ${occ.fileName}:${occ.line} ${occ.calleeText}(...)${values}`));
+        }
+    },
+};
+/** Default reporter: prints unresolved/dynamic event-name call sites to the console (always enabled). */
+function registerConsoleDynamicEventReporterPlugin(registry) {
+    registry.registerDynamicEventReporter(consoleDynamicEventReporter);
+}

package/dist/plugin/loadPlugins.js

@@ -38,6 +38,7 @@ exports.createBuiltinPluginRegistry = createBuiltinPluginRegistry;
 exports.createPluginRegistry = createPluginRegistry;
 const external_1 = require("./adapters/external");
 const eventra_sdk_1 = require("./builtins/eventra-sdk");
+const consoleDynamicEventReporter_1 = require("./builtins/consoleDynamicEventReporter");
 const registry_1 = require("./registry");
 /**
  * Only packages published under the `@eventra_dev` npm scope can ever be
@@ -89,6 +90,7 @@ async function loadExternalPlugin(registry, spec) {
 function createBuiltinPluginRegistry() {
     const registry = new registry_1.PluginRegistry();
     (0, eventra_sdk_1.registerEventraSdkPlugin)(registry);
+    (0, consoleDynamicEventReporter_1.registerConsoleDynamicEventReporterPlugin)(registry);
     return registry;
 }
 /** Built-ins + plugins listed in eventra.json `plugins` array. */

package/dist/plugin/registry.js

@@ -8,6 +8,8 @@ const path_1 = __importDefault(require("path"));
 class PluginRegistry {
     preprocessors = [];
     sinkDetectors = [];
+    wrapperDetectors = [];
+    dynamicEventReporters = [];
     includePatterns = [];
     sourceToVirtuals = new Map();
     registerFilePreprocessor(preprocessor) {
@@ -22,6 +24,18 @@ class PluginRegistry {
         }
         this.sinkDetectors.push(detector);
     }
+    registerWrapperDetector(detector) {
+        if (this.wrapperDetectors.some((d) => d.name === detector.name)) {
+            throw new Error(`Wrapper detector already registered: ${detector.name}`);
+        }
+        this.wrapperDetectors.push(detector);
+    }
+    registerDynamicEventReporter(reporter) {
+        if (this.dynamicEventReporters.some((r) => r.name === reporter.name)) {
+            throw new Error(`Dynamic event reporter already registered: ${reporter.name}`);
+        }
+        this.dynamicEventReporters.push(reporter);
+    }
     registerIncludePattern(pattern) {
         const trimmed = pattern.trim();
         if (!trimmed)
@@ -36,6 +50,12 @@ class PluginRegistry {
     getSinkDetectors() {
         return this.sinkDetectors;
     }
+    getWrapperDetectors() {
+        return this.wrapperDetectors;
+    }
+    getDynamicEventReporters() {
+        return this.dynamicEventReporters;
+    }
     getFilePreprocessors() {
         return this.preprocessors;
     }
@@ -71,6 +91,20 @@ class PluginRegistry {
         }
         return null;
     }
+    detectWrapper(context) {
+        for (const detector of this.wrapperDetectors) {
+            const wrapper = detector.detect(context);
+            if (wrapper) {
+                return wrapper;
+            }
+        }
+        return null;
+    }
+    async runDynamicEventReporters(occurrences) {
+        for (const reporter of this.dynamicEventReporters) {
+            await reporter.report({ occurrences });
+        }
+    }
     normalizePath(fileName) {
         return path_1.default.resolve(fileName).replace(/\\/g, "/");
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@eventra_dev/eventra-cli",
-  "version": "1.0.4",
+  "version": "1.0.6",
   "description": "Static analytics event extraction CLI powered by the TypeScript compiler API",
   "license": "MIT",
   "type": "commonjs",