@eventra_dev/eventra-cli 2.0.10 → 2.2.0

package/dist/plugin/builtins/sinkPresets.js

@@ -0,0 +1,99 @@
+"use strict";
+/**
+ * Built-in `sinks` presets, plus the npm packages each one is recognised by.
+ *
+ * Package names and what they export were checked against the npm registry and the packages' own
+ * type declarations on 2026-10-08 (`pnpm check:presets` re-checks the names against the registry,
+ * so a rename or a deprecation shows up there instead of as a silent detection gap).
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SINK_PRESETS = exports.PRESET_PACKAGES = void 0;
+exports.detectSinkPresets = detectSinkPresets;
+const pkg = (name, flags = {}) => ({ name, ...flags });
+exports.PRESET_PACKAGES = {
+    posthog: [
+        pkg("posthog-js"),
+        pkg("@posthog/react"),
+        pkg("posthog-js-lite"),
+        pkg("posthog-node"),
+        pkg("posthog-react-native"),
+    ],
+    segment: [
+        pkg("@segment/analytics-next"),
+        pkg("@segment/analytics-node"),
+        pkg("@segment/analytics-react-native"),
+        pkg("@segment/analytics.js-core", { legacy: true }),
+        pkg("analytics-node", { legacy: true }),
+        pkg("@segment/snippet", { detectOnly: true }),
+    ],
+    amplitude: [
+        pkg("@amplitude/analytics-browser"),
+        pkg("@amplitude/analytics-node"),
+        pkg("@amplitude/analytics-react-native"),
+        pkg("@amplitude/marketing-analytics-browser"),
+        pkg("@amplitude/unified"),
+        pkg("amplitude-js", { legacy: true }),
+    ],
+    ga4: [
+        pkg("react-ga4"),
+        pkg("vue-gtag"),
+        pkg("vue-gtag-next", { legacy: true }),
+        pkg("@next/third-parties", { detectOnly: true }),
+        pkg("nuxt-gtag", { detectOnly: true }),
+        pkg("@types/gtag.js", { detectOnly: true }),
+    ],
+};
+/** Packages a rule can vet a receiver against: everything except the detect-only signals. */
+const modulesOf = (preset, only) => exports.PRESET_PACKAGES[preset]
+    .filter((p) => !p.detectOnly && (only === undefined || only.includes(p.name)))
+    .map((p) => p.name);
+exports.SINK_PRESETS = {
+    posthog: [
+        // posthog.capture("x") - the conventional name, posthog-js and posthog-node alike.
+        { callee: "posthog.capture", nameArg: 0, nameProperty: "event" },
+        // Any other receiver name, e.g. `const ph = usePostHog(); ph.capture("x")` or
+        // `const client = new PostHog(key); client.capture({ distinctId, event: "x" })`.
+        { callee: "capture", nameArg: 0, nameProperty: "event", modules: modulesOf("posthog") },
+    ],
+    segment: [
+        // analytics.track("x", props) from analytics.js / @segment/analytics-next, `window.analytics` included;
+        // analytics-node takes `analytics.track({ userId, event: "x" })`.
+        { callee: "analytics.track", nameArg: 0, nameProperty: "event" },
+        // `const [analytics] = await AnalyticsBrowser.load(...)`, `new Analytics({ writeKey })`, any variable name.
+        { callee: "track", nameArg: 0, nameProperty: "event", modules: modulesOf("segment") },
+    ],
+    amplitude: [
+        // amplitude.track("x") / amplitude.track({ event_type: "x" }) / the legacy amplitude.logEvent("x").
+        { callee: "amplitude.track", nameArg: 0, nameProperty: "event_type" },
+        { callee: "amplitude.logEvent", nameArg: 0, nameProperty: "event_type" },
+        // `amplitude.getInstance().logEvent("x")`, `const client = Amplitude.createInstance()`, any variable name.
+        { callee: "track", nameArg: 0, nameProperty: "event_type", modules: modulesOf("amplitude") },
+        { callee: "logEvent", nameArg: 0, nameProperty: "event_type", modules: modulesOf("amplitude") },
+    ],
+    ga4: [
+        // gtag("event", "x", params): the name is the second argument, and only for the "event" command
+        // (`gtag("config", id)` and `gtag("set", ...)` are not events). `window.gtag` and nuxt-gtag's
+        // `const { gtag } = useGtag()` match too.
+        { callee: "gtag", nameArg: 1, when: { arg: 0, equals: "event" } },
+        // @next/third-parties: sendGAEvent("event", "x", params).
+        { callee: "sendGAEvent", nameArg: 1, when: { arg: 0, equals: "event" } },
+        // nuxt-gtag: useTrackEvent("x", params), auto-imported.
+        { callee: "useTrackEvent", nameArg: 0 },
+        // vue-gtag: this.$gtag.event("x", params).
+        { callee: "$gtag.event", nameArg: 0 },
+        // vue-gtag: `import { event } from "vue-gtag"` or `const { event } = useGtag()`.
+        { callee: "event", nameArg: 0, modules: modulesOf("ga4", ["vue-gtag", "vue-gtag-next"]) },
+        // react-ga4: ReactGA.event("x", params) or ReactGA.event({ category, action: "x" }).
+        { callee: "event", nameArg: 0, nameProperty: "action", modules: modulesOf("ga4", ["react-ga4"]) },
+    ],
+};
+/** Which presets a project's dependency names point at, in preset order. */
+function detectSinkPresets(dependencyNames) {
+    const detected = [];
+    for (const [preset, packages] of Object.entries(exports.PRESET_PACKAGES)) {
+        const present = packages.map((p) => p.name).filter((name) => dependencyNames.has(name));
+        if (present.length > 0)
+            detected.push({ preset, packages: present });
+    }
+    return detected;
+}

package/dist/plugin/loadPlugins.js

@@ -32,11 +32,17 @@ var __importStar = (this && this.__importStar) || (function () {
         return result;
     };
 })();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.isTrustedPluginSpecifier = isTrustedPluginSpecifier;
 exports.createBuiltinPluginRegistry = createBuiltinPluginRegistry;
 exports.createPluginRegistry = createPluginRegistry;
+const module_1 = require("module");
+const path_1 = __importDefault(require("path"));
 const external_1 = require("./adapters/external");
+const configuredSinks_1 = require("./builtins/configuredSinks");
 const eventra_sdk_1 = require("./builtins/eventra-sdk");
 const consoleDynamicEventReporter_1 = require("./builtins/consoleDynamicEventReporter");
 const registry_1 = require("./registry");
@@ -68,6 +74,19 @@ function pluginLoadHint(spec) {
     }
     return "";
 }
+/**
+ * Plugins are installed in the user's project, not next to the CLI (a global
+ * install, npx or a pnpm layout would not find them from here), so resolve from
+ * the project first and fall back to normal resolution relative to the CLI.
+ */
+function resolveFromProject(spec) {
+    try {
+        return (0, module_1.createRequire)(path_1.default.join(process.cwd(), "package.json")).resolve(spec);
+    }
+    catch {
+        return spec;
+    }
+}
 async function loadExternalPlugin(registry, spec) {
     const trimmed = spec.trim();
     // Defensive-only: the sole caller (createPluginRegistry) already does
@@ -79,7 +98,7 @@ async function loadExternalPlugin(registry, spec) {
         return;
     let mod;
     try {
-        mod = await Promise.resolve(`${trimmed}`).then(s => __importStar(require(s)));
+        mod = await Promise.resolve(`${resolveFromProject(trimmed)}`).then(s => __importStar(require(s)));
     }
     catch (err) {
         // Node's dynamic import() only ever rejects with an Error (module
@@ -107,12 +126,13 @@ function createBuiltinPluginRegistry() {
 /** Built-ins + plugins listed in eventra.json `plugins` array. */
 async function createPluginRegistry(config) {
     const registry = createBuiltinPluginRegistry();
+    (0, configuredSinks_1.registerConfiguredSinks)(registry, config.sinks);
     for (const spec of config.plugins ?? []) {
         const trimmed = spec.trim();
         if (!trimmed)
             continue;
         if (!isTrustedPluginSpecifier(trimmed)) {
-            console.warn(`Eventra: skipping plugin "${trimmed}" — only official @eventra_dev/cli-plugin-* packages can be loaded.${pluginLoadHint(trimmed)}`);
+            console.warn(`Eventra: skipping plugin "${trimmed}" - only official @eventra_dev/cli-plugin-* packages can be loaded.${pluginLoadHint(trimmed)}`);
             continue;
         }
         await loadExternalPlugin(registry, trimmed);

package/dist/plugin/registry.js

@@ -5,6 +5,16 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.PluginRegistry = void 0;
 const path_1 = __importDefault(require("path"));
+// the synthetic callee each framework plugin uses for a template `event=...`
+const TEMPLATE_CALLEE = /^__eventra_[a-z]+_template_event__$/;
+// `__eventra_x_template_event__(expr)` (callText may be cut with an ellipsis)
+function templateExpression(occurrence) {
+    const open = occurrence.callText.indexOf("(");
+    let expression = open === -1 ? occurrence.callText : occurrence.callText.slice(open + 1);
+    expression = expression.endsWith(")") ? expression.slice(0, -1) : expression;
+    // Angular qualifies a bare name with `this.`; the template never writes it
+    return occurrence.calleeText.includes("_angular_") ? expression.replace(/^this\./, "") : expression;
+}
 class PluginRegistry {
     preprocessors = [];
     sinkDetectors = [];
@@ -101,9 +111,48 @@ class PluginRegistry {
         return null;
     }
     async runDynamicEventReporters(occurrences) {
+        const attributed = this.attributeToSources(occurrences);
         for (const reporter of this.dynamicEventReporters) {
-            await reporter.report({ occurrences });
+            await reporter.report({ occurrences: attributed });
+        }
+    }
+    /**
+     * Occurrences are found in virtual modules (`App.vue.ts`). Point them back
+     * at the file the user wrote, and flag the ones that come from generated
+     * code so reporters do not print a line number that exists nowhere.
+     */
+    attributeToSources(occurrences) {
+        if (this.sourceToVirtuals.size === 0) {
+            return occurrences;
         }
+        const virtualToSource = new Map();
+        for (const [source, virtuals] of this.sourceToVirtuals) {
+            for (const virtual of virtuals) {
+                if (virtual !== source) {
+                    virtualToSource.set(virtual, source);
+                }
+            }
+        }
+        return occurrences.map((occurrence) => {
+            const source = virtualToSource.get(this.normalizePath(occurrence.fileName));
+            if (!source) {
+                return occurrence;
+            }
+            const template = TEMPLATE_CALLEE.test(occurrence.calleeText);
+            if (template) {
+                return {
+                    ...occurrence,
+                    fileName: source,
+                    inTemplate: true,
+                    eventExpression: templateExpression(occurrence),
+                };
+            }
+            // an Angular template module embeds the component class: lines there
+            // are generated, the real call is also reported from the class file
+            return source.toLowerCase().endsWith(".html")
+                ? { ...occurrence, fileName: source, inGeneratedCode: true }
+                : { ...occurrence, fileName: source };
+        });
     }
     normalizePath(fileName) {
         return path_1.default.resolve(fileName).replace(/\\/g, "/");

package/package.json

@@ -1,8 +1,12 @@
 {
   "name": "@eventra_dev/eventra-cli",
-  "version": "2.0.10",
+  "version": "2.2.0",
   "description": "Static analytics event extraction CLI powered by the TypeScript compiler API",
   "license": "MIT",
+  "author": {
+    "name": "and-1991",
+    "url": "https://github.com/and-1991"
+  },
   "type": "commonjs",
   "bin": {
     "eventra": "./dist/index.js"
@@ -31,7 +35,10 @@
     "test:unit": "vitest run",
     "test:coverage": "vitest run --coverage",
     "test:e2e": "pnpm run clean && pnpm run build && tsx tests/run.ts",
-    "clean": "rm -rf dist"
+    "clean": "rm -rf dist",
+    "test:mutation": "stryker run",
+    "check:presets": "tsx scripts/check-preset-packages.ts",
+    "typecheck": "tsc --noEmit -p tsconfig.json"
   },
   "dependencies": {
     "chalk": "^4.1.2",
@@ -43,6 +50,8 @@
     "typescript": "^5.3.0"
   },
   "devDependencies": {
+    "@stryker-mutator/core": "9.6.1",
+    "@stryker-mutator/vitest-runner": "9.6.1",
     "@types/fs-extra": "^11.0.4",
     "@types/inquirer": "^9.0.9",
     "@types/node": "^20.0.0",