@lensmcp/nx-plugin 1.0.0

package/generators/setup-vite/setup-vite.js

@@ -0,0 +1,125 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.setupViteGenerator = setupViteGenerator;
+exports.patchViteConfig = patchViteConfig;
+const devkit_1 = require("@nx/devkit");
+const IMPORT_LINE = `import { lensmcpVitePlugin } from '@lensmcp/vite-plugin';`;
+/**
+ * Wires LensMCP into a host Vite project. Idempotent on every step.
+ *
+ * 1. Locate the project's vite.config.{ts,mts,js,mjs,cts,cjs}.
+ * 2. Add `import { lensmcpVitePlugin } from '@lensmcp/vite-plugin'`
+ *    near the top (after the last existing import).
+ * 3. Insert `lensmcpVitePlugin({ enabled: mode !== 'production' })`
+ *    into the `plugins` array if not already present. We do *not*
+ *    AST-edit — we use string heuristics on the standard
+ *    `defineConfig({ plugins: [...] })` shape. If the file is too
+ *    custom for the heuristics, we print a diff hint and bail.
+ * 4. Add Nx targets: agent-dev, agent-build, agent-verify.
+ */
+async function setupViteGenerator(tree, rawOptions) {
+    const options = {
+        project: rawOptions.project,
+        skipFormat: rawOptions.skipFormat ?? false,
+    };
+    const project = (0, devkit_1.readProjectConfiguration)(tree, options.project);
+    const viteConfigPath = findViteConfig(tree, project.root);
+    if (!viteConfigPath) {
+        throw new Error(`setup-vite: no vite.config.{ts,mts,js,mjs,cts,cjs} found under ${project.root}.`);
+    }
+    const original = tree.read(viteConfigPath, 'utf-8') ?? '';
+    const patched = patchViteConfig(original);
+    if (patched === null) {
+        throw new Error(`setup-vite: could not safely patch ${viteConfigPath}.\n` +
+            `Expected a defineConfig({ plugins: [...] }) or defineConfig(({ mode }) => ({ plugins: [...] })) shape.\n` +
+            `Edit manually: add \`${IMPORT_LINE}\` and push \`lensmcpVitePlugin({ enabled: mode !== 'production' })\` into the plugins array.`);
+    }
+    if (patched !== original) {
+        tree.write(viteConfigPath, patched);
+    }
+    // Idempotent Nx target additions.
+    const targets = { ...(project.targets ?? {}) };
+    if (!targets['agent-dev']) {
+        targets['agent-dev'] = {
+            executor: '@lensmcp/nx-plugin:agent-dev',
+            options: {
+                kind: 'vite-react',
+                chrome: true,
+                headless: true,
+            },
+        };
+        project.targets = targets;
+        (0, devkit_1.updateProjectConfiguration)(tree, options.project, project);
+    }
+    if (!options.skipFormat) {
+        await (0, devkit_1.formatFiles)(tree);
+    }
+}
+exports.default = setupViteGenerator;
+// ---------- helpers ----------
+function findViteConfig(tree, root) {
+    // Nx generates `vite.config.mts` for ESM workspaces — cover every Vite-supported extension.
+    for (const name of [
+        'vite.config.ts',
+        'vite.config.mts',
+        'vite.config.js',
+        'vite.config.mjs',
+        'vite.config.cts',
+        'vite.config.cjs',
+    ]) {
+        const p = (0, devkit_1.joinPathFragments)(root, name);
+        if (tree.exists(p))
+            return p;
+    }
+    return undefined;
+}
+/**
+ * String-heuristic patch:
+ *
+ * 1. If the file already imports `@lensmcp/vite-plugin` and mentions
+ *    `lensmcpVitePlugin(` in the plugins array, return unchanged.
+ * 2. Otherwise insert the import near the top (after the last
+ *    `import …` line) and add the plugin call to the plugins array
+ *    declared by `plugins: [` (first occurrence).
+ *
+ * If neither anchor is found, return `null` so the generator can ask
+ * the user to patch manually.
+ */
+function patchViteConfig(src) {
+    const hasImport = src.includes("from '@lensmcp/vite-plugin'") || src.includes('from "@lensmcp/vite-plugin"');
+    const hasPluginCall = /lensmcpVitePlugin\s*\(/.test(src);
+    if (hasImport && hasPluginCall)
+        return src;
+    const pluginsAnchor = src.indexOf('plugins:');
+    if (pluginsAnchor === -1)
+        return null;
+    const bracketStart = src.indexOf('[', pluginsAnchor);
+    if (bracketStart === -1)
+        return null;
+    let withImport = src;
+    if (!hasImport) {
+        const importLines = [...src.matchAll(/^\s*import .+;?\s*$/gm)];
+        const lastImport = importLines.length > 0 ? importLines[importLines.length - 1] : null;
+        if (lastImport && lastImport.index !== undefined) {
+            const insertAt = lastImport.index + lastImport[0].length;
+            withImport = src.slice(0, insertAt) + `\n${IMPORT_LINE}` + src.slice(insertAt);
+        }
+        else {
+            withImport = `${IMPORT_LINE}\n` + src;
+        }
+    }
+    if (hasPluginCall)
+        return withImport;
+    const adjBracket = withImport.indexOf('[', withImport.indexOf('plugins:'));
+    const before = withImport.slice(0, adjBracket + 1);
+    const after = withImport.slice(adjBracket + 1);
+    // Insert at the start of the array with a trailing comma if the array isn't empty.
+    const trimmedAfter = after.replace(/^\s*/, '');
+    const startsClosed = trimmedAfter.startsWith(']');
+    const separator = startsClosed ? '' : ', ';
+    // `mode` is only in scope for the function-form config (`defineConfig(({ mode }) => …)`).
+    // For the object form, gate on NODE_ENV instead of emitting code that doesn't compile.
+    const hasModeInScope = /defineConfig\s*\(\s*(?:async\s*)?\(\s*\{[^}]*\bmode\b[^}]*\}/.test(withImport);
+    const enabledExpr = hasModeInScope ? "mode !== 'production'" : "process.env.NODE_ENV !== 'production'";
+    return `${before}lensmcpVitePlugin({ enabled: ${enabledExpr} })${separator}${after}`;
+}

package/generators.json

@@ -0,0 +1,22 @@
+{
+  "$schema": "http://json-schema.org/schema",
+  "name": "@lensmcp/nx-plugin",
+  "version": "0.0.1",
+  "generators": {
+    "init": {
+      "factory": "./dist/generators/init/init",
+      "schema": "./dist/generators/init/schema.json",
+      "description": "Install LensMCP into a host Nx workspace (idempotent)."
+    },
+    "setup-vite": {
+      "factory": "./dist/generators/setup-vite/setup-vite",
+      "schema": "./dist/generators/setup-vite/schema.json",
+      "description": "Wire LensMCP into a Vite project (patches vite.config + adds agent-dev target)."
+    },
+    "setup-nest": {
+      "factory": "./dist/generators/setup-nest/setup-nest",
+      "schema": "./dist/generators/setup-nest/schema.json",
+      "description": "Wire LensMCP into a NestJS project (rewrites main.ts bootstrap to createLensmcpNestApp + agent-dev target)."
+    }
+  }
+}

package/index.d.ts

@@ -0,0 +1,14 @@
+export { initGenerator } from './generators/init/init.js';
+export { setupViteGenerator, patchViteConfig } from './generators/setup-vite/setup-vite.js';
+export { setupNestGenerator, patchMainBootstrap, patchAppModule } from './generators/setup-nest/setup-nest.js';
+export { default as agentDevExecutor } from './executors/agent-dev/agent-dev.js';
+export { default as agentBuildExecutor } from './executors/agent-build/agent-build.js';
+export { default as agentVerifyExecutor } from './executors/agent-verify/agent-verify.js';
+export type { InitGeneratorSchema } from './generators/init/schema.js';
+export type { SetupViteGeneratorSchema } from './generators/setup-vite/schema.js';
+export type { SetupNestGeneratorSchema } from './generators/setup-nest/schema.js';
+export type { AgentDevExecutorSchema } from './executors/agent-dev/schema.js';
+export type { AgentBuildExecutorSchema } from './executors/agent-build/schema.js';
+export type { AgentVerifyExecutorSchema } from './executors/agent-verify/schema.js';
+export { initGenerator as default } from './generators/init/init.js';
+//# sourceMappingURL=index.d.ts.map

package/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAC1D,OAAO,EAAE,kBAAkB,EAAE,eAAe,EAAE,MAAM,uCAAuC,CAAC;AAC5F,OAAO,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,cAAc,EAAE,MAAM,uCAAuC,CAAC;AAC/G,OAAO,EAAE,OAAO,IAAI,gBAAgB,EAAE,MAAM,oCAAoC,CAAC;AACjF,OAAO,EAAE,OAAO,IAAI,kBAAkB,EAAE,MAAM,wCAAwC,CAAC;AACvF,OAAO,EAAE,OAAO,IAAI,mBAAmB,EAAE,MAAM,0CAA0C,CAAC;AAC1F,YAAY,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAC;AACvE,YAAY,EAAE,wBAAwB,EAAE,MAAM,mCAAmC,CAAC;AAClF,YAAY,EAAE,wBAAwB,EAAE,MAAM,mCAAmC,CAAC;AAClF,YAAY,EAAE,sBAAsB,EAAE,MAAM,iCAAiC,CAAC;AAC9E,YAAY,EAAE,wBAAwB,EAAE,MAAM,mCAAmC,CAAC;AAClF,YAAY,EAAE,yBAAyB,EAAE,MAAM,oCAAoC,CAAC;AACpF,OAAO,EAAE,aAAa,IAAI,OAAO,EAAE,MAAM,2BAA2B,CAAC"}

package/index.js

@@ -0,0 +1,21 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.default = exports.agentVerifyExecutor = exports.agentBuildExecutor = exports.agentDevExecutor = exports.patchAppModule = exports.patchMainBootstrap = exports.setupNestGenerator = exports.patchViteConfig = exports.setupViteGenerator = exports.initGenerator = void 0;
+const tslib_1 = require("tslib");
+var init_js_1 = require("./generators/init/init.js");
+Object.defineProperty(exports, "initGenerator", { enumerable: true, get: function () { return init_js_1.initGenerator; } });
+var setup_vite_js_1 = require("./generators/setup-vite/setup-vite.js");
+Object.defineProperty(exports, "setupViteGenerator", { enumerable: true, get: function () { return setup_vite_js_1.setupViteGenerator; } });
+Object.defineProperty(exports, "patchViteConfig", { enumerable: true, get: function () { return setup_vite_js_1.patchViteConfig; } });
+var setup_nest_js_1 = require("./generators/setup-nest/setup-nest.js");
+Object.defineProperty(exports, "setupNestGenerator", { enumerable: true, get: function () { return setup_nest_js_1.setupNestGenerator; } });
+Object.defineProperty(exports, "patchMainBootstrap", { enumerable: true, get: function () { return setup_nest_js_1.patchMainBootstrap; } });
+Object.defineProperty(exports, "patchAppModule", { enumerable: true, get: function () { return setup_nest_js_1.patchAppModule; } });
+var agent_dev_js_1 = require("./executors/agent-dev/agent-dev.js");
+Object.defineProperty(exports, "agentDevExecutor", { enumerable: true, get: function () { return tslib_1.__importDefault(agent_dev_js_1).default; } });
+var agent_build_js_1 = require("./executors/agent-build/agent-build.js");
+Object.defineProperty(exports, "agentBuildExecutor", { enumerable: true, get: function () { return tslib_1.__importDefault(agent_build_js_1).default; } });
+var agent_verify_js_1 = require("./executors/agent-verify/agent-verify.js");
+Object.defineProperty(exports, "agentVerifyExecutor", { enumerable: true, get: function () { return tslib_1.__importDefault(agent_verify_js_1).default; } });
+var init_js_2 = require("./generators/init/init.js");
+Object.defineProperty(exports, "default", { enumerable: true, get: function () { return init_js_2.initGenerator; } });

package/package.json

@@ -0,0 +1,47 @@
+{
+  "name": "@lensmcp/nx-plugin",
+  "version": "1.0.0",
+  "main": "./index.js",
+  "module": "./index.js",
+  "types": "./index.d.ts",
+  "exports": {
+    "./package.json": "./package.json",
+    ".": {
+      "types": "./index.d.ts",
+      "import": "./index.js",
+      "default": "./index.js"
+    }
+  },
+  "dependencies": {
+    "@nx/devkit": "22.7.3",
+    "tslib": "^2.3.0"
+  },
+  "generators": "./generators.json",
+  "executors": "./executors.json",
+  "license": "Apache-2.0",
+  "homepage": "https://github.com/kiwiapps-ltd/lensmcp#readme",
+  "bugs": {
+    "url": "https://github.com/kiwiapps-ltd/lensmcp/issues"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "description": "Nx plugin that installs LensMCP into a workspace (generators + agent-dev/build/verify executors).",
+  "keywords": [
+    "lensmcp",
+    "mcp",
+    "observability",
+    "ai-agents",
+    "claude",
+    "nx",
+    "nx-plugin"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/kiwiapps-ltd/lensmcp.git",
+    "directory": "libs/nx-plugin"
+  }
+}