@botonic/nx-plugin 2.23.0

package/src/generators/preset/files/tsconfig.base.json

@@ -0,0 +1,27 @@
+{
+  "compileOnSave": false,
+  "compilerOptions": {
+    "rootDir": ".",
+    "sourceMap": true,
+    "declaration": false,
+    "moduleResolution": "node",
+    "emitDecoratorMetadata": true,
+    "experimentalDecorators": true,
+    "importHelpers": true,
+    "target": "es2015",
+    "module": "esnext",
+    "lib": ["es2020", "dom"],
+    "skipLibCheck": true,
+    "skipDefaultLibCheck": true,
+    "baseUrl": ".",
+    "strict": true,
+    "esModuleInterop": true,
+    "allowSyntheticDefaultImports": true,
+    "forceConsistentCasingInFileNames": true,
+    "resolveJsonModule": true,
+    "isolatedModules": true,
+    "noEmit": true,
+    "jsx": "react-jsx"
+  },
+  "exclude": ["node_modules", "tmp"]
+}

package/src/generators/preset/files/tsconfig.base.json.template

@@ -0,0 +1,27 @@
+{
+  "compileOnSave": false,
+  "compilerOptions": {
+    "rootDir": ".",
+    "sourceMap": true,
+    "declaration": false,
+    "moduleResolution": "bundler",
+    "emitDecoratorMetadata": true,
+    "experimentalDecorators": true,
+    "importHelpers": true,
+    "target": "es2015",
+    "module": "esnext",
+    "lib": ["es2021", "dom", "dom.iterable"],
+    "skipLibCheck": true,
+    "skipDefaultLibCheck": true,
+    "baseUrl": ".",
+    "strict": true,
+    "esModuleInterop": true,
+    "allowSyntheticDefaultImports": true,
+    "forceConsistentCasingInFileNames": true,
+    "resolveJsonModule": true,
+    "isolatedModules": true,
+    "noEmit": true,
+    "jsx": "react-jsx"
+  },
+  "exclude": ["node_modules", "tmp"]
+} 

package/src/generators/preset/files/tsconfig.json

@@ -0,0 +1,9 @@
+{
+  "extends": "./tsconfig.base.json",
+  "compileOnSave": false,
+  "files": [],
+  "references": [
+    // Project references will be automatically managed by Nx
+    // Use 'nx sync' to keep them updated
+  ]
+}

package/src/generators/preset/generator.d.ts

@@ -0,0 +1,4 @@
+import { GeneratorCallback, Tree } from '@nx/devkit';
+import type { PresetGeneratorSchema } from './schema';
+export default function (tree: Tree, options: PresetGeneratorSchema): Promise<GeneratorCallback>;
+export { PresetGeneratorSchema };

package/src/generators/preset/generator.js

@@ -0,0 +1,127 @@
+"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 generator_exports = {};
+__export(generator_exports, {
+  default: () => generator_default
+});
+module.exports = __toCommonJS(generator_exports);
+var import_devkit = require("@nx/devkit");
+var fs = __toESM(require("fs"));
+var path = __toESM(require("path"));
+const MODULE_DIR = __dirname;
+function resolveBotonicVersion(providedVersion) {
+  if (providedVersion && providedVersion !== "{{WORKSPACE_VERSION}}" && providedVersion !== "latest") {
+    return providedVersion.replace(/^[\^~]/, "");
+  }
+  try {
+    const packageJsonPath = path.resolve(
+      MODULE_DIR,
+      "..",
+      "..",
+      "..",
+      "package.json"
+    );
+    const packageJson = JSON.parse(fs.readFileSync(packageJsonPath, "utf-8"));
+    return packageJson.version || "latest";
+  } catch (error) {
+    console.warn("Could not read plugin version, using latest:", error);
+    return "latest";
+  }
+}
+function normalizeOptions(options) {
+  return {
+    ...options,
+    name: options.name,
+    nxWorkspaceRoot: options.nxWorkspaceRoot || ".",
+    packageManager: options.packageManager || "pnpm",
+    botonicVersion: resolveBotonicVersion(options.botonicVersion)
+  };
+}
+async function generator_default(tree, options) {
+  const normalizedOptions = normalizeOptions(options);
+  const tasks = [];
+  console.log("Configuring existing TypeScript workspace with Botonic...");
+  (0, import_devkit.generateFiles)(
+    tree,
+    path.join(MODULE_DIR, "files"),
+    normalizedOptions.nxWorkspaceRoot,
+    {
+      ...normalizedOptions,
+      template: ""
+    }
+  );
+  if (normalizedOptions.packageManager === "pnpm") {
+    const pnpmWorkspacePath = path.join(
+      normalizedOptions.nxWorkspaceRoot,
+      "pnpm-workspace.yaml"
+    );
+    if (tree.exists(pnpmWorkspacePath)) {
+      const content = tree.read(pnpmWorkspacePath, "utf-8") ?? "";
+      if (!/apps\/\*/.test(content)) {
+        const updated = content.replace(
+          /([ \t]*- ["']?packages\/\*["']?)/,
+          '$1\n  - "apps/*"'
+        );
+        tree.write(pnpmWorkspacePath, updated);
+      }
+    }
+  }
+  const gitignorePath = path.join(
+    normalizedOptions.nxWorkspaceRoot,
+    ".gitignore"
+  );
+  if (tree.exists(gitignorePath)) {
+    const content = tree.read(gitignorePath, "utf-8") ?? "";
+    if (!/\.botonic\//.test(content)) {
+      const botonicSection = content.trimEnd().length > 0 ? `
+
+# Botonic (global credentials)
+.botonic/
+` : `# Botonic (global credentials)
+.botonic/
+`;
+      tree.write(gitignorePath, content.trimEnd() + botonicSection);
+    }
+  } else {
+    tree.write(gitignorePath, "# Botonic (global credentials)\n.botonic/\n");
+  }
+  (0, import_devkit.updateJson)(
+    tree,
+    path.join(normalizedOptions.nxWorkspaceRoot, "package.json"),
+    (json) => {
+      json["dependencies"] ??= {};
+      json["devDependencies"] ??= {};
+      json["dependencies"]["@nx/react"] = "latest";
+      json["devDependencies"]["@botonic/nx-plugin"] = normalizedOptions.botonicVersion;
+      return json;
+    }
+  );
+  await (0, import_devkit.formatFiles)(tree);
+  return (0, import_devkit.runTasksInSerial)(...tasks);
+}

package/src/generators/preset/schema.d.ts

@@ -0,0 +1,6 @@
+export interface PresetGeneratorSchema {
+    name: string;
+    packageManager?: 'pnpm' | 'npm';
+    nxWorkspaceRoot?: string;
+    botonicVersion?: string;
+}

package/src/generators/preset/schema.js

@@ -0,0 +1,16 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+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 schema_exports = {};
+module.exports = __toCommonJS(schema_exports);

package/src/generators/preset/schema.json

@@ -0,0 +1,50 @@
+{
+  "$schema": "https://json-schema.org/draft-07/schema",
+  "cli": "nx",
+  "$id": "BotonicPreset",
+  "title": "Create a Botonic Workspace",
+  "description": "Initialize a new workspace for Botonic bot development",
+  "type": "object",
+  "properties": {
+    "name": {
+      "type": "string",
+      "description": "The name of the workspace",
+      "$default": {
+        "$source": "argv",
+        "index": 0
+      },
+      "x-prompt": "What name would you like to use for the workspace?"
+    },
+    "packageManager": {
+      "type": "string",
+      "description": "Package manager to use",
+      "default": "pnpm",
+      "enum": ["npm", "pnpm"],
+      "x-prompt": {
+        "message": "Which package manager would you like to use?",
+        "type": "list",
+        "items": [
+          {
+            "value": "npm",
+            "label": "npm"
+          },
+          {
+            "value": "pnpm",
+            "label": "pnpm"
+          }
+        ]
+      }
+    },
+    "nxWorkspaceRoot": {
+      "type": "string",
+      "description": "Path to the root of the nx workspace",
+      "default": "."
+    },
+    "botonicVersion": {
+      "type": "string",
+      "description": "Botonic packages version. Leave empty to use the same version as the installed @botonic/nx-plugin."
+    }
+  },
+  "required": ["name"],
+  "additionalProperties": true
+}

package/src/generators/remove-custom-message/generator.d.ts

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

package/src/generators/remove-custom-message/generator.js

@@ -0,0 +1,259 @@
+"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 generator_exports = {};
+__export(generator_exports, {
+  default: () => generator_default
+});
+module.exports = __toCommonJS(generator_exports);
+var import_devkit = require("@nx/devkit");
+function normalizeOptions(tree, options) {
+  const projects = (0, import_devkit.getProjects)(tree);
+  const project = projects.get(options.project);
+  if (!project) {
+    throw new Error(`Project "${options.project}" not found`);
+  }
+  if (!project.tags?.includes("botonic:bot-app")) {
+    throw new Error(
+      `Project "${options.project}" is not a botonic bot application. Make sure it has the "botonic:bot-app" tag.`
+    );
+  }
+  const projectConfig = (0, import_devkit.readProjectConfiguration)(tree, options.project);
+  const projectRoot = projectConfig.root;
+  const sourceRoot = projectConfig.sourceRoot || `${projectRoot}/src`;
+  const name = (0, import_devkit.names)(options.name);
+  const fileName = name.fileName;
+  const className = name.className;
+  const propertyName = name.propertyName;
+  const constantName = name.constantName.toUpperCase();
+  const customMessagesPath = options.directory ? `${sourceRoot}/client/custom-messages/${options.directory}` : `${sourceRoot}/client/custom-messages`;
+  const configPath = `${sourceRoot}/shared/constants.ts`;
+  const actionsPath = `${sourceRoot}/server/bot/actions`;
+  const routesPath = `${sourceRoot}/server/bot/routes.ts`;
+  return {
+    ...options,
+    projectName: options.project,
+    projectRoot,
+    fileName,
+    className,
+    propertyName,
+    constantName,
+    customMessagesPath,
+    configPath,
+    actionsPath,
+    routesPath
+  };
+}
+function removeFiles(tree, options) {
+  const filesToRemove = [
+    `${options.customMessagesPath}/${options.fileName}.tsx`,
+    `${options.customMessagesPath}/${options.fileName}.spec.tsx`,
+    `${options.actionsPath}/${options.fileName}.ts`
+  ];
+  const removedFiles = [];
+  const notFoundFiles = [];
+  filesToRemove.forEach((filePath) => {
+    if (tree.exists(filePath)) {
+      tree.delete(filePath);
+      removedFiles.push(filePath);
+    } else {
+      notFoundFiles.push(filePath);
+    }
+  });
+  return { removedFiles, notFoundFiles };
+}
+function removeFromConfig(tree, options) {
+  if (!tree.exists(options.configPath)) {
+    console.warn(`Config file not found at ${options.configPath}`);
+    return false;
+  }
+  const content = tree.read(options.configPath, "utf-8");
+  const lines = content.split("\n");
+  const enumValuePattern = new RegExp(
+    `\\s*${options.constantName}\\s*[=:]\\s*['"]${options.fileName}['"],?`
+  );
+  let found = false;
+  const updatedLines = lines.filter((line) => {
+    if (enumValuePattern.test(line)) {
+      found = true;
+      return false;
+    }
+    return true;
+  });
+  if (found) {
+    tree.write(options.configPath, updatedLines.join("\n"));
+  }
+  return found;
+}
+function removeFromCustomMessagesIndex(tree, options) {
+  const indexPath = `${options.customMessagesPath}/index.ts`;
+  if (!tree.exists(indexPath)) {
+    console.warn(`Custom messages index not found at ${indexPath}`);
+    return false;
+  }
+  const content = tree.read(indexPath, "utf-8");
+  const lines = content.split("\n");
+  let found = false;
+  const updatedLines = lines.filter((line) => {
+    if (line.includes(`import { ${options.className} }`) && line.includes(
+      `./${options.directory ? options.directory + "/" : ""}${options.fileName}`
+    )) {
+      found = true;
+      return false;
+    }
+    if (line.includes(
+      `[CUSTOM_MESSAGE_TYPES.${options.constantName}]: ${options.className}`
+    )) {
+      found = true;
+      return false;
+    }
+    return true;
+  });
+  if (found) {
+    tree.write(indexPath, updatedLines.join("\n"));
+  }
+  return found;
+}
+function removeFromActionsIndex(tree, options) {
+  const indexPath = `${options.actionsPath}/index.ts`;
+  if (!tree.exists(indexPath)) {
+    console.warn(`Actions index not found at ${indexPath}`);
+    return false;
+  }
+  const content = tree.read(indexPath, "utf-8");
+  const exportStatement = `export * from './${options.fileName}'`;
+  if (content.includes(exportStatement)) {
+    const updatedContent = content.replace(exportStatement + "\n", "").replace(exportStatement, "");
+    tree.write(indexPath, updatedContent);
+    return true;
+  }
+  return false;
+}
+function removeFromRoutes(tree, options) {
+  if (!tree.exists(options.routesPath)) {
+    console.warn(`Routes file not found at ${options.routesPath}`);
+    return false;
+  }
+  const content = tree.read(options.routesPath, "utf-8");
+  const lines = content.split("\n");
+  const actionImport = `${options.propertyName}Output`;
+  let found = false;
+  let importStartIndex = -1;
+  let importEndIndex = -1;
+  for (let i = 0; i < lines.length; i++) {
+    if (lines[i].includes("import {") && lines.slice(i, i + 10).some((line) => line.includes("from './actions'"))) {
+      importStartIndex = i;
+      for (let j = i; j < lines.length; j++) {
+        if (lines[j].includes("from './actions'")) {
+          importEndIndex = j;
+          break;
+        }
+      }
+      break;
+    }
+  }
+  if (importStartIndex !== -1 && importEndIndex !== -1) {
+    const importSection = lines.slice(importStartIndex, importEndIndex + 1).join("\n");
+    if (importSection.includes(actionImport)) {
+      for (let i = importStartIndex; i <= importEndIndex; i++) {
+        if (lines[i].includes(actionImport)) {
+          if (lines[i].trim() === `${actionImport},` || lines[i].trim() === actionImport) {
+            lines.splice(i, 1);
+            importEndIndex--;
+          } else {
+            lines[i] = lines[i].replace(`,\\s*${actionImport}`, "").replace(`${actionImport},`, "").replace(actionImport, "");
+          }
+          found = true;
+          break;
+        }
+      }
+    }
+  }
+  let routeStartIndex = -1;
+  let routeEndIndex = -1;
+  for (let i = 0; i < lines.length; i++) {
+    if (lines[i].includes(`text: '${options.fileName}'`) && lines[i + 1]?.includes(actionImport)) {
+      for (let j = i - 1; j >= 0; j--) {
+        if (lines[j].trim() === "{") {
+          routeStartIndex = j;
+          break;
+        }
+      }
+      for (let j = i + 1; j < lines.length; j++) {
+        if (lines[j].includes("},")) {
+          routeEndIndex = j;
+          break;
+        }
+      }
+      break;
+    }
+  }
+  if (routeStartIndex !== -1 && routeEndIndex !== -1) {
+    lines.splice(routeStartIndex, routeEndIndex - routeStartIndex + 1);
+    found = true;
+  }
+  if (found) {
+    tree.write(options.routesPath, lines.join("\n"));
+  }
+  return found;
+}
+async function generator_default(tree, options) {
+  console.log(`\u{1F5D1}\uFE0F  Removing custom message: ${options.name}`);
+  const normalizedOptions = normalizeOptions(tree, options);
+  console.log(`\u{1F4C1} Project: ${normalizedOptions.projectName}`);
+  console.log(`\u{1F4C2} Location: ${normalizedOptions.customMessagesPath}`);
+  if (!options.skipConfirmation) {
+    console.log(`
+\u26A0\uFE0F  This will remove the following:`);
+    console.log(`   - Component: ${normalizedOptions.fileName}.tsx`);
+    console.log(`   - Tests: ${normalizedOptions.fileName}.spec.tsx`);
+    console.log(`   - Action: ${normalizedOptions.fileName}.ts`);
+    console.log(
+      `   - Config enum: CUSTOM_MESSAGE_TYPES.${normalizedOptions.constantName}`
+    );
+    console.log(`   - Registration in customMessages object`);
+    console.log(`   - Route in routes.ts`);
+    console.log(`
+   Continue? This action cannot be undone.`);
+  }
+  const { removedFiles, notFoundFiles } = removeFiles(tree, normalizedOptions);
+  const configUpdated = removeFromConfig(tree, normalizedOptions);
+  const indexUpdated = removeFromCustomMessagesIndex(tree, normalizedOptions);
+  const actionsUpdated = removeFromActionsIndex(tree, normalizedOptions);
+  const routesUpdated = removeFromRoutes(tree, normalizedOptions);
+  await (0, import_devkit.formatFiles)(tree);
+  console.log(
+    `
+\u{1F389} Successfully removed custom message: ${normalizedOptions.className}`
+  );
+  if (removedFiles.length > 0) {
+    console.log(`\u{1F4C1} Removed files:`);
+    removedFiles.forEach((file) => console.log(`   - ${file}`));
+  }
+  if (notFoundFiles.length > 0) {
+    console.log(`\u26A0\uFE0F  Files not found (skipped):`);
+    notFoundFiles.forEach((file) => console.log(`   - ${file}`));
+  }
+  console.log(`\u{1F4DD} Updated configurations:`);
+  console.log(`   - Config enum: ${configUpdated ? "\u2705" : "\u274C"}`);
+  console.log(`   - Custom messages index: ${indexUpdated ? "\u2705" : "\u274C"}`);
+  console.log(`   - Actions index: ${actionsUpdated ? "\u2705" : "\u274C"}`);
+  console.log(`   - Routes: ${routesUpdated ? "\u2705" : "\u274C"}`);
+  console.log(`
+\u{1F680} Custom message removal complete!`);
+}

package/src/generators/remove-custom-message/schema.d.ts

@@ -0,0 +1,6 @@
+export interface RemoveCustomMessageGeneratorSchema {
+    name: string;
+    project: string;
+    directory?: string;
+    skipConfirmation?: boolean;
+}

package/src/generators/remove-custom-message/schema.js

@@ -0,0 +1,16 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+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 schema_exports = {};
+module.exports = __toCommonJS(schema_exports);

package/src/generators/remove-custom-message/schema.json

@@ -0,0 +1,39 @@
+{
+  "$schema": "http://json-schema.org/schema",
+  "cli": "nx",
+  "$id": "RemoveCustomMessage",
+  "title": "Remove a custom message component from Botonic",
+  "description": "Remove a custom message component and clean up all related files and registrations.",
+  "type": "object",
+  "properties": {
+    "name": {
+      "type": "string",
+      "description": "The name of the custom message component to remove.",
+      "$default": {
+        "$source": "argv",
+        "index": 0
+      },
+      "x-prompt": "What is the name of the custom message to remove?",
+      "pattern": "^[a-zA-Z].*$"
+    },
+    "project": {
+      "type": "string",
+      "description": "The name of the botonic project to remove the custom message from.",
+      "x-prompt": "Which botonic project should this custom message be removed from?",
+      "$default": {
+        "$source": "projectName"
+      }
+    },
+    "directory": {
+      "type": "string",
+      "description": "The directory within custom-messages where the component is located (optional).",
+      "alias": "dir"
+    },
+    "skipConfirmation": {
+      "type": "boolean",
+      "description": "Skip the confirmation prompt before removing files.",
+      "default": false
+    }
+  },
+  "required": ["name", "project"]
+}

package/src/generators/shared/bot-app-utils.d.ts

@@ -0,0 +1,25 @@
+import { Tree } from '@nx/devkit';
+export interface BotAppProjectInfo {
+    projectRoot: string;
+    sourceRoot: string;
+}
+export interface StandardPaths {
+    constantsPath: string;
+    actionsPath: string;
+    routesPath: string;
+    customMessagesPath: string;
+    webviewsPath: string;
+}
+export declare function validateBotAppProject(tree: Tree, projectName: string): BotAppProjectInfo;
+export declare function resolveStandardPaths(sourceRoot: string): StandardPaths;
+export declare function addExportToIndex(tree: Tree, indexPath: string, exportStatement: string): void;
+export declare function addConstEntry(tree: Tree, filePath: string, constName: string, key: string, value: string): void;
+/**
+ * Inserts a route block before the flow-builder catch-all route in routes.ts.
+ */
+export declare function insertRouteBeforeFlowBuilder(tree: Tree, routesPath: string, routeLines: string[]): void;
+/**
+ * Adds an action import to routes.ts import from './actions'.
+ * Handles both single-line and multi-line import blocks.
+ */
+export declare function addActionImportToRoutes(tree: Tree, routesPath: string, actionName: string): void;