@botonic/nx-plugin 2.25.0 → 2.27.0

package/src/migrations/add-lilara-registry/add-lilara-registry.migration.js

@@ -1,49 +0,0 @@
-"use strict";
-var __defProp = Object.defineProperty;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __export = (target, all) => {
-  for (var name in all)
-    __defProp(target, name, { get: all[name], enumerable: true });
-};
-var __copyProps = (to, from, except, desc) => {
-  if (from && typeof from === "object" || typeof from === "function") {
-    for (let key of __getOwnPropNames(from))
-      if (!__hasOwnProp.call(to, key) && key !== except)
-        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
-  }
-  return to;
-};
-var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
-var add_lilara_registry_migration_exports = {};
-__export(add_lilara_registry_migration_exports, {
-  default: () => addLilaraRegistry
-});
-module.exports = __toCommonJS(add_lilara_registry_migration_exports);
-var import_devkit = require("@nx/devkit");
-const NPMRC = ".npmrc";
-const BOTONIC_REGISTRY_PREFIX = "@botonic:registry=";
-const LILARA_REGISTRY_LINE = "@lilara:registry=https://hubtype-489822642696.d.codeartifact.eu-west-1.amazonaws.com/npm/hubtype-internal/";
-async function addLilaraRegistry(tree) {
-  if (!tree.exists(NPMRC)) {
-    import_devkit.logger.info(`\u2139\uFE0F  ${NPMRC} not found \u2013 skipping`);
-    return;
-  }
-  const content = tree.read(NPMRC, "utf-8") ?? "";
-  if (content.includes("@lilara:registry=")) {
-    import_devkit.logger.info("\u2139\uFE0F  @lilara:registry already present \u2013 skipping");
-    return;
-  }
-  const lines = content.split("\n");
-  const botonicIdx = lines.findIndex((l) => l.startsWith(BOTONIC_REGISTRY_PREFIX));
-  let newContent;
-  if (botonicIdx !== -1) {
-    lines.splice(botonicIdx + 1, 0, LILARA_REGISTRY_LINE);
-    newContent = lines.join("\n");
-  } else {
-    newContent = content + (content.endsWith("\n") ? "" : "\n") + LILARA_REGISTRY_LINE + "\n";
-  }
-  tree.write(NPMRC, newContent);
-  import_devkit.logger.info(`\u2705 Added @lilara:registry to ${NPMRC}`);
-}

package/src/migrations/add-lilara-registry/schema.json

@@ -1,5 +0,0 @@
-{
-  "$schema": "http://json-schema.org/schema",
-  "type": "object",
-  "properties": {}
-}

package/src/migrations/fix-css-code-split/fix-css-code-split.migration.md

@@ -1,45 +0,0 @@
-# Fix CSS Code Split Migration
-
-## Summary
-
-Vite generates multiple CSS chunks when code splitting is enabled. Only the main `webchat.botonic.css` (or `webviews.botonic.css`) is injected into `index.html`; secondary chunks like `webchat.botonic-[hash].css` are not referenced, causing styles to fail loading after build.
-
-This migration adds `cssCodeSplit: false` to the vite build config so all CSS is merged into a single file that Vite injects correctly.
-
-## What the automated migration does
-
-- Adds `cssCodeSplit: false` to `vite/webchat.config.ts` build options
-- Adds `cssCodeSplit: false` to `vite/webviews.config.ts` build options
-- Skips files that already have `cssCodeSplit` configured
-
-## What it cannot handle
-
-- Bots with non-standard vite config layout (e.g. config in a different path)
-- Custom build setups that override rollup CSS output
-- Bots that intentionally use multiple CSS entry points
-
-## Manual migration steps
-
-If your bot has customized the vite config or the migration skips your project:
-
-1. Open `vite/webchat.config.ts` and `vite/webviews.config.ts`
-2. In the `build` section, add `cssCodeSplit: false,` after `reportCompressedSize: true,`
-3. Example:
-
-```ts
-build: {
-  outDir: resolve(projectRoot, output.dir),
-  emptyOutDir: true,
-  reportCompressedSize: true,
-  cssCodeSplit: false,  // add this line
-  commonjsOptions: { ... },
-  ...
-}
-```
-
-## Verification checklist
-
-- [ ] Run `nx build <your-bot>` for webchat and webviews
-- [ ] Inspect `dist/webchat/` and `dist/webviews/` — expect single `webchat.botonic.css` and `webviews.botonic.css`
-- [ ] Run `nx serve-bot <your-bot>` and verify styles render correctly
-- [ ] Deploy to staging and confirm no missing CSS in production

package/src/migrations/remove-codeartifact-registry/remove-codeartifact-registry.migration.d.ts

@@ -1,2 +0,0 @@
-import type { Tree } from '@nx/devkit';
-export default function removeCodeartifactRegistry(tree: Tree): Promise<void>;

package/src/migrations/remove-codeartifact-registry/remove-codeartifact-registry.migration.js

@@ -1,59 +0,0 @@
-"use strict";
-var __defProp = Object.defineProperty;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __export = (target, all) => {
-  for (var name in all)
-    __defProp(target, name, { get: all[name], enumerable: true });
-};
-var __copyProps = (to, from, except, desc) => {
-  if (from && typeof from === "object" || typeof from === "function") {
-    for (let key of __getOwnPropNames(from))
-      if (!__hasOwnProp.call(to, key) && key !== except)
-        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
-  }
-  return to;
-};
-var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
-var remove_codeartifact_registry_migration_exports = {};
-__export(remove_codeartifact_registry_migration_exports, {
-  default: () => removeCodeartifactRegistry
-});
-module.exports = __toCommonJS(remove_codeartifact_registry_migration_exports);
-var import_devkit = require("@nx/devkit");
-const NPMRC = ".npmrc";
-function isCodeArtifactScopedRegistryLine(line) {
-  const t = line.trim();
-  if (!t.startsWith("@botonic:registry=") && !t.startsWith("@hubtype-lilara:registry=")) {
-    return false;
-  }
-  return t.toLowerCase().includes("codeartifact");
-}
-function isCodeArtifactAuthLine(line) {
-  const t = line.trim();
-  if (!t.toLowerCase().includes("codeartifact")) return false;
-  return t.includes(":always-auth=") || t.includes(":_authToken=");
-}
-async function removeCodeartifactRegistry(tree) {
-  if (!tree.exists(NPMRC)) {
-    import_devkit.logger.info(`\u2139\uFE0F  ${NPMRC} not found \u2013 skipping`);
-    return;
-  }
-  const content = tree.read(NPMRC, "utf-8") ?? "";
-  const lines = content.split("\n");
-  const kept = lines.filter(
-    (l) => !isCodeArtifactScopedRegistryLine(l) && !isCodeArtifactAuthLine(l)
-  );
-  if (kept.length === lines.length) {
-    import_devkit.logger.info("\u2139\uFE0F  No CodeArtifact entries in .npmrc \u2013 skipping");
-    return;
-  }
-  let newContent = kept.join("\n");
-  while (newContent.includes("\n\n\n")) {
-    newContent = newContent.replace(/\n\n\n/g, "\n\n");
-  }
-  if (!newContent.endsWith("\n")) newContent += "\n";
-  tree.write(NPMRC, newContent);
-  import_devkit.logger.info(`\u2705 Removed CodeArtifact registry lines from ${NPMRC}`);
-}

package/src/migrations/remove-codeartifact-registry/schema.json

@@ -1,5 +0,0 @@
-{
-  "$schema": "http://json-schema.org/schema",
-  "type": "object",
-  "properties": {}
-}

package/src/migrations/sync-pending-bot-migrations/schema.json

@@ -1,5 +0,0 @@
-{
-  "$schema": "http://json-schema.org/schema",
-  "type": "object",
-  "properties": {}
-}

package/src/migrations/sync-pending-bot-migrations/sync-pending-bot-migrations.migration.d.ts

@@ -1,2 +0,0 @@
-import type { Tree } from '@nx/devkit';
-export default function syncPendingBotMigrations(tree: Tree): Promise<void>;

package/src/migrations/sync-pending-bot-migrations/sync-pending-bot-migrations.migration.js

@@ -1,137 +0,0 @@
-"use strict";
-var __create = Object.create;
-var __defProp = Object.defineProperty;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __getProtoOf = Object.getPrototypeOf;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __export = (target, all) => {
-  for (var name in all)
-    __defProp(target, name, { get: all[name], enumerable: true });
-};
-var __copyProps = (to, from, except, desc) => {
-  if (from && typeof from === "object" || typeof from === "function") {
-    for (let key of __getOwnPropNames(from))
-      if (!__hasOwnProp.call(to, key) && key !== except)
-        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
-  }
-  return to;
-};
-var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
-  // If the importer is in node compatibility mode or this is not an ESM
-  // file that has been converted to a CommonJS file using a Babel-
-  // compatible transform (i.e. "__esModule" has not been set), then set
-  // "default" to the CommonJS "module.exports" for node compatibility.
-  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
-  mod
-));
-var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
-var sync_pending_bot_migrations_migration_exports = {};
-__export(sync_pending_bot_migrations_migration_exports, {
-  default: () => syncPendingBotMigrations
-});
-module.exports = __toCommonJS(sync_pending_bot_migrations_migration_exports);
-var import_devkit = require("@nx/devkit");
-var fs = __toESM(require("fs"));
-var path = __toESM(require("path"));
-var import_migration_utils = require("../utils/migration-utils");
-const MODULE_DIR = __dirname;
-const PENDING_FILE = ".botonic/pending-bot-migrations.json";
-function resolveMigrationGuide(relPath) {
-  if (!relPath) return null;
-  return `node_modules/@botonic/nx-plugin/${relPath}`;
-}
-function semverLt(a, b) {
-  const parse = (v) => v.replace(/^[\^~]/, "").split(".").map(Number);
-  const [aMaj, aMin, aPatch] = parse(a);
-  const [bMaj, bMin, bPatch] = parse(b);
-  if (aMaj !== bMaj) return aMaj < bMaj;
-  if (aMin !== bMin) return aMin < bMin;
-  return aPatch < bPatch;
-}
-function readBotAppGenerators(moduleDir, pluginVersion) {
-  try {
-    const generatorsJsonPath = path.resolve(
-      moduleDir,
-      "..",
-      "..",
-      "..",
-      "generators.json"
-    );
-    const generatorsJson = JSON.parse(
-      fs.readFileSync(generatorsJsonPath, "utf-8")
-    );
-    return Object.entries(generatorsJson.generators).filter(([, entry]) => entry["x-bot-app-migration"] === true).map(([name, entry]) => {
-      const rawIntroducedIn = entry["x-introduced-in"];
-      const introducedIn = rawIntroducedIn && rawIntroducedIn !== "{{WORKSPACE_VERSION}}" ? rawIntroducedIn : pluginVersion;
-      return {
-        generator: `@botonic/nx-plugin:${name}`,
-        description: entry.description,
-        introducedIn,
-        migrationGuideRelPath: entry["x-migration-guide"] ?? null
-      };
-    });
-  } catch {
-    import_devkit.logger.warn(
-      "\u26A0\uFE0F  Could not read generators.json \u2013 no bot-app generators queued."
-    );
-    return [];
-  }
-}
-async function syncPendingBotMigrations(tree) {
-  const pluginVersion = (0, import_migration_utils.getPluginVersion)(MODULE_DIR);
-  const BOT_APP_GENERATORS = readBotAppGenerators(MODULE_DIR, pluginVersion);
-  const botProjects = (0, import_migration_utils.findBotApps)(tree);
-  if (botProjects.length === 0) {
-    import_devkit.logger.info(
-      "\u2139\uFE0F  No Botonic bot apps found. Skipping pending migrations setup."
-    );
-    return;
-  }
-  let pendingMigrations = { pending: [] };
-  if (tree.exists(PENDING_FILE)) {
-    try {
-      pendingMigrations = (0, import_devkit.readJson)(tree, PENDING_FILE);
-    } catch {
-      import_devkit.logger.warn(`\u26A0\uFE0F  Could not parse ${PENDING_FILE}, creating fresh.`);
-    }
-  }
-  for (const generatorDef of BOT_APP_GENERATORS) {
-    const botsNeedingGenerator = botProjects.filter((projectPath) => {
-      const botVersion = (0, import_migration_utils.getCurrentBotonicCoreVersion)(tree, projectPath);
-      if (!botVersion) return true;
-      return semverLt(botVersion, generatorDef.introducedIn);
-    });
-    if (botsNeedingGenerator.length === 0) continue;
-    const existing = pendingMigrations.pending.find(
-      (e) => e.generator === generatorDef.generator
-    );
-    if (existing) {
-      import_devkit.logger.info(
-        `\u2139\uFE0F  ${generatorDef.generator} already in pending list \u2013 skipping.`
-      );
-    } else {
-      pendingMigrations.pending.push({
-        version: generatorDef.introducedIn,
-        generator: generatorDef.generator,
-        description: generatorDef.description,
-        migrationGuide: resolveMigrationGuide(
-          generatorDef.migrationGuideRelPath
-        ),
-        appliedTo: []
-      });
-      import_devkit.logger.info(
-        `\u2705 Queued ${generatorDef.generator} for ${botsNeedingGenerator.length} bot(s)`
-      );
-    }
-  }
-  if (!tree.exists(".botonic/.gitkeep")) {
-    tree.write(".botonic/.gitkeep", "");
-  }
-  tree.write(PENDING_FILE, JSON.stringify(pendingMigrations, null, 2));
-  import_devkit.logger.info("");
-  import_devkit.logger.info(
-    `\u{1F4CB} ${PENDING_FILE} updated with ${pendingMigrations.pending.length} pending generator(s).`
-  );
-  import_devkit.logger.info("   Run /update-bot in Cursor to apply them per bot.");
-}

package/src/migrations/sync-pending-bot-migrations/sync-pending-bot-migrations.migration.md

@@ -1,19 +0,0 @@
-# Sync Pending Bot Migrations
-
-## Summary
-
-This migration sets up the per-bot migration tracking system. It writes `.botonic/pending-bot-migrations.json` listing all bot-app code generators that need to be applied to each bot in the workspace.
-
-After this migration runs, use the `/update-bot` Cursor command to apply pending generators to individual bots one at a time.
-
-## What the automated migration does
-
-- Finds all Botonic bot apps in the workspace (projects tagged `botonic:bot-app`)
-- Determines which bots are behind the current plugin version
-- Writes `.botonic/pending-bot-migrations.json` with the list of generators to apply
-- Does not modify any bot code — code transforms happen when you run `/update-bot`
-
-## Verification checklist
-
-- [ ] `.botonic/pending-bot-migrations.json` exists in the workspace root
-- [ ] Run `/update-bot` in Cursor and follow the prompts to update each bot

package/src/migrations/update-cursor-commands-to-stubs/schema.json

@@ -1,5 +0,0 @@
-{
-  "$schema": "http://json-schema.org/schema",
-  "properties": {},
-  "required": []
-}

package/src/migrations/update-cursor-commands-to-stubs/update-cursor-commands-to-stubs.migration.d.ts

@@ -1,2 +0,0 @@
-import type { Tree } from '@nx/devkit';
-export default function updateCursorCommandsToStubs(tree: Tree): Promise<void>;

package/src/migrations/update-cursor-commands-to-stubs/update-cursor-commands-to-stubs.migration.js

@@ -1,61 +0,0 @@
-"use strict";
-var __defProp = Object.defineProperty;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __export = (target, all) => {
-  for (var name in all)
-    __defProp(target, name, { get: all[name], enumerable: true });
-};
-var __copyProps = (to, from, except, desc) => {
-  if (from && typeof from === "object" || typeof from === "function") {
-    for (let key of __getOwnPropNames(from))
-      if (!__hasOwnProp.call(to, key) && key !== except)
-        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
-  }
-  return to;
-};
-var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
-var update_cursor_commands_to_stubs_migration_exports = {};
-__export(update_cursor_commands_to_stubs_migration_exports, {
-  default: () => updateCursorCommandsToStubs
-});
-module.exports = __toCommonJS(update_cursor_commands_to_stubs_migration_exports);
-var import_devkit = require("@nx/devkit");
-const STUB_UPDATE_BOT = `# Update Botonic Bot
-
-Applies pending bot-app migrations from \`.botonic/pending-bot-migrations.json\` to a single bot.
-
-Follow the full workflow in: \`node_modules/@botonic/nx-plugin/src/cursor-commands/update-bot.md\`
-`;
-const STUB_UPDATE_BOTONIC = `# Update Botonic Workspace
-
-Updates the Botonic plugin to the latest version and queues pending bot-app migrations.
-
-Follow the full workflow in: \`node_modules/@botonic/nx-plugin/src/cursor-commands/update-botonic.md\`
-`;
-const UPDATE_BOT_MD = ".cursor/commands/update-bot.md";
-const UPDATE_BOTONIC_MD = ".cursor/commands/update-botonic.md";
-function isAlreadyStub(content, canonicalRef) {
-  return content.includes(canonicalRef);
-}
-async function updateCursorCommandsToStubs(tree) {
-  if (tree.exists(UPDATE_BOT_MD)) {
-    const content = tree.read(UPDATE_BOT_MD, "utf-8") ?? "";
-    if (isAlreadyStub(content, "cursor-commands/update-bot.md")) {
-      import_devkit.logger.info("\u2139\uFE0F  update-bot.md is already a stub \u2013 skipping");
-    } else {
-      tree.write(UPDATE_BOT_MD, STUB_UPDATE_BOT);
-      import_devkit.logger.info("\u2705 Replaced update-bot.md with stable stub");
-    }
-  }
-  if (tree.exists(UPDATE_BOTONIC_MD)) {
-    const content = tree.read(UPDATE_BOTONIC_MD, "utf-8") ?? "";
-    if (isAlreadyStub(content, "cursor-commands/update-botonic.md")) {
-      import_devkit.logger.info("\u2139\uFE0F  update-botonic.md is already a stub \u2013 skipping");
-    } else {
-      tree.write(UPDATE_BOTONIC_MD, STUB_UPDATE_BOTONIC);
-      import_devkit.logger.info("\u2705 Replaced update-botonic.md with stable stub");
-    }
-  }
-}

package/src/migrations/update-pnpm-workspace-scripts/schema.json

@@ -1,4 +0,0 @@
-{
-  "type": "object",
-  "properties": {}
-}

package/src/migrations/update-pnpm-workspace-scripts/update-pnpm-workspace-scripts.migration.d.ts

@@ -1,2 +0,0 @@
-import type { Tree } from '@nx/devkit';
-export default function updatePnpmWorkspaceScripts(tree: Tree): Promise<void>;

package/src/migrations/update-pnpm-workspace-scripts/update-pnpm-workspace-scripts.migration.js

@@ -1,47 +0,0 @@
-"use strict";
-var __defProp = Object.defineProperty;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __export = (target, all) => {
-  for (var name in all)
-    __defProp(target, name, { get: all[name], enumerable: true });
-};
-var __copyProps = (to, from, except, desc) => {
-  if (from && typeof from === "object" || typeof from === "function") {
-    for (let key of __getOwnPropNames(from))
-      if (!__hasOwnProp.call(to, key) && key !== except)
-        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
-  }
-  return to;
-};
-var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
-var update_pnpm_workspace_scripts_migration_exports = {};
-__export(update_pnpm_workspace_scripts_migration_exports, {
-  default: () => updatePnpmWorkspaceScripts
-});
-module.exports = __toCommonJS(update_pnpm_workspace_scripts_migration_exports);
-var import_devkit = require("@nx/devkit");
-const FIND_MIGRATION_GUIDES = ".cursor/scripts/update-bot/find-migration-guides.sh";
-async function updatePnpmWorkspaceScripts(tree) {
-  if (!tree.exists(FIND_MIGRATION_GUIDES)) {
-    import_devkit.logger.info(
-      `\u2139\uFE0F  ${FIND_MIGRATION_GUIDES} not found \u2013 skipping pnpm script update`
-    );
-    return;
-  }
-  const content = tree.read(FIND_MIGRATION_GUIDES, "utf-8");
-  if (!content || !content.includes("npm install")) {
-    import_devkit.logger.info(
-      `\u2139\uFE0F  ${FIND_MIGRATION_GUIDES} already references pnpm \u2013 skipping`
-    );
-    return;
-  }
-  tree.write(
-    FIND_MIGRATION_GUIDES,
-    content.replace(/npm install/g, "pnpm install")
-  );
-  import_devkit.logger.info(
-    `\u2705 Updated ${FIND_MIGRATION_GUIDES} to reference pnpm instead of npm`
-  );
-}