@backstage/cli 0.30.0-next.2 → 0.30.0

package/CHANGELOG.md

@@ -1,5 +1,96 @@
 # @backstage/cli
 
+## 0.30.0
+
+### Minor Changes
+
+- cb76663: **BREAKING**: Add support for native ESM in Node.js code. This changes the behavior of dynamic import expressions in Node.js code. Typically this can be fixed by replacing `import(...)` with `require(...)`, with an `as typeof import(...)` cast if needed for types. This is because dynamic imports will no longer be transformed to `require(...)` calls, but instead be left as-is. This in turn allows you to load ESM modules from CommonJS code using `import(...)`.
+
+  This change adds support for the following in Node.js packages, across type checking, package builds, runtime transforms and Jest tests:
+
+  - Dynamic imports that load ESM modules from CommonJS code.
+  - Both `.mjs` and `.mts` files as explicit ESM files, as well as `.cjs` and `.cts` as explicit CommonJS files.
+  - Support for the `"type": "module"` field in `package.json` to indicate that the package is an ESM package.
+
+  There are a few caveats to be aware of:
+
+  - To enable support for native ESM in tests, you need to run the tests with the `--experimental-vm-modules` flag enabled, typically via `NODE_OPTIONS='--experimental-vm-modules'`.
+  - Declaring a package as `"type": "module"` in `package.json` is supported, but in tests it will cause all local transitive dependencies to also be treated as ESM, regardless of whether they declare `"type": "module"` or not.
+  - Node.js has an [ESM interoperability layer with CommonJS](https://nodejs.org/docs/latest-v22.x/api/esm.html#interoperability-with-commonjs) that allows for imports from ESM to identify named exports in CommonJS packages. This interoperability layer is **only** enabled when importing packages with a `.cts` or `.cjs` extension. This is because the interoperability layer is not fully compatible with the NPM ecosystem, and would break package if it was enabled for `.js` files.
+  - Dynamic imports of CommonJS packages will vary in shape depending on the runtime, i.e. test vs local development, etc. It is therefore recommended to avoid dynamic imports of CommonJS packages and instead use `require`, or to use the explicit CommonJS extensions as mentioned above. If you do need to dynamically import CommonJS packages, avoid using `default` exports, as the shape of them vary across different environments and you would otherwise need to manually unwrap the import based on the shape of the module object.
+
+- b30e788: The `new` command is now powered by a new template system that allows you to define your own templates in a declarative way, as well as import existing templates from external sources. See the [CLI templates documentation](https://backstage.io/docs/tooling/cli/templates) for more information.
+
+  The following flags for the `new` command have been deprecated and will be removed in a future release:
+
+  - `--license=<license>`: Configure the global `license` instead.
+  - `--no-private`: Configure the global `private` instead.
+  - `--baseVersion=<version>`: Configure the global `version` instead.
+  - `--npmRegistry=<url>`: Configure the global `publishRegistry` instead.
+  - `--scope=<scope>`: Configure the global `namePrefix` and/or `namePluginInfix` instead.
+
+  As part of this change the template IDs and their options have changed. The following backwards compatibility mappings for the `--select` and `--option` flags are enabled when using the default set of templates, but they will also be removed in the future:
+
+  - `--select=plugin` is mapped to `--select=frontend-plugin` instead.
+  - `--option=id=<id>` is mapped to `--option=pluginId=<id>` instead.
+
+### Patch Changes
+
+- f17ef61: The `versions:bump` command will now reject `*` as a pattern.
+- 86c72c1: The packing process when running `build-workspace` with the `--alwaysYarnPack` flag now respects the `BACKSTAGE_CLI_BUILD_PARALLEL` environment variable, defaulting parallel work limits based on CPU availability.
+- 2167afc: Treat static file assets as always being free from side effects in package builds.
+- f54eed0: Fixed an issue where default feature type information wasn't being added to package.json/exports before publishing if exports didn't exist beforehand
+- 90a1edf: Add check to make sure that the `--link` option for the `start` command is a valid workspace.
+- 207f88f: Fixed the file path pattern of many static assets output as part of the frontend build process, where there was an extra `.` before the extension, leading to names like `image-af7946b..png`.
+- 9638f6d: Only allow pass through of `.mjs` in Jest transform if static ESM is supported.
+- 9d49e04: Replaced dependency `node-libs-browser` with `node-stdlib-browser`
+- 2c14147: Corrected path when trying to add dependency to respective `package.json` when using `yarn new` templates
+- f21b125: Ensure that both global-agent and undici agents are enabled when proxying is enabled.
+- Updated dependencies
+  - @backstage/cli-node@0.2.13
+  - @backstage/config-loader@1.9.6
+  - @backstage/catalog-model@1.7.3
+  - @backstage/cli-common@0.1.15
+  - @backstage/config@1.3.2
+  - @backstage/errors@1.2.7
+  - @backstage/eslint-plugin@0.1.10
+  - @backstage/integration@1.16.1
+  - @backstage/release-manifests@0.0.12
+  - @backstage/types@1.2.1
+
+## 0.30.0-next.3
+
+### Minor Changes
+
+- b30e788: The `new` command is now powered by a new template system that allows you to define your own templates in a declarative way, as well as import existing templates from external sources. See the [CLI templates documentation](https://backstage.io/docs/tooling/cli/templates) for more information.
+
+  The following flags for the `new` command have been deprecated and will be removed in a future release:
+
+  - `--license=<license>`: Configure the global `license` instead.
+  - `--no-private`: Configure the global `private` instead.
+  - `--baseVersion=<version>`: Configure the global `version` instead.
+  - `--npmRegistry=<url>`: Configure the global `publishRegistry` instead.
+  - `--scope=<scope>`: Configure the global `namePrefix` and/or `namePluginInfix` instead.
+
+  As part of this change the template IDs and their options have changed. The following backwards compatibility mappings for the `--select` and `--option` flags are enabled when using the default set of templates, but they will also be removed in the future:
+
+  - `--select=plugin` is mapped to `--select=frontend-plugin` instead.
+  - `--option=id=<id>` is mapped to `--option=pluginId=<id>` instead.
+
+### Patch Changes
+
+- Updated dependencies
+  - @backstage/cli-node@0.2.13-next.1
+  - @backstage/config-loader@1.9.6-next.0
+  - @backstage/catalog-model@1.7.3
+  - @backstage/cli-common@0.1.15
+  - @backstage/config@1.3.2
+  - @backstage/errors@1.2.7
+  - @backstage/eslint-plugin@0.1.10
+  - @backstage/integration@1.16.1
+  - @backstage/release-manifests@0.0.12
+  - @backstage/types@1.2.1
+
 ## 0.30.0-next.2
 
 ### Patch Changes

package/dist/commands/index.cjs.js

@@ -118,6 +118,9 @@ function registerCommands(program) {
     "Pre-fill options for the creation process",
     (opt, arr) => [...arr, opt],
     []
+  ).option(
+    "--skip-install",
+    `Skips running 'yarn install' and 'yarn lint --fix'`
   ).option("--scope <scope>", "The scope to use for new packages").option(
     "--npm-registry <URL>",
     "The package registry to use for new packages"

package/dist/commands/new/new.cjs.js

@@ -2,21 +2,46 @@
 
 Object.defineProperty(exports, '__esModule', { value: true });
 
-var os = require('os');
-var fs = require('fs-extra');
-var path = require('path');
-var FactoryRegistry = require('../../lib/new/FactoryRegistry.cjs.js');
-var cliNode = require('@backstage/cli-node');
-var paths = require('../../lib/paths.cjs.js');
-var errors = require('@backstage/errors');
-var tasks = require('../../lib/tasks.cjs.js');
+var createNewPackage = require('../../lib/new/createNewPackage.cjs.js');
 
-function _interopDefaultCompat (e) { return e && typeof e === 'object' && 'default' in e ? e : { default: e }; }
-
-var os__default = /*#__PURE__*/_interopDefaultCompat(os);
-var fs__default = /*#__PURE__*/_interopDefaultCompat(fs);
-
-function parseOptions(optionStrings) {
+var _new = async (opts) => {
+  const {
+    option: rawArgOptions,
+    select: preselectedTemplateId,
+    skipInstall,
+    scope,
+    private: isPrivate,
+    ...otherGlobals
+  } = opts;
+  const prefilledParams = parseParams(rawArgOptions);
+  let pluginInfix = void 0;
+  let packagePrefix = void 0;
+  if (scope) {
+    const backstagePrefix = scope.startsWith("backstage") ? "" : "backstage-";
+    packagePrefix = scope.includes("/") ? `@${scope}${backstagePrefix}` : `@${scope}/${backstagePrefix}`;
+    pluginInfix = scope.includes("backstage") ? "plugin-" : "backstage-plugin-";
+  }
+  if (isPrivate === false || // set to false with --no-private flag
+  Object.values(otherGlobals).filter(Boolean).length !== 0) {
+    console.warn(
+      `Global template configuration via CLI flags is deprecated, see https://backstage.io/docs/cli/new for information on how to configure package templating`
+    );
+  }
+  await createNewPackage.createNewPackage({
+    prefilledParams,
+    preselectedTemplateId,
+    configOverrides: {
+      license: otherGlobals.license,
+      version: otherGlobals.baseVersion,
+      private: isPrivate,
+      publishRegistry: otherGlobals.npmRegistry,
+      packageNamePrefix: packagePrefix,
+      packageNamePluginInfix: pluginInfix
+    },
+    skipInstall
+  });
+};
+function parseParams(optionStrings) {
   const options = {};
   for (const str of optionStrings) {
     const [key] = str.split("=", 1);
@@ -30,72 +55,6 @@ function parseOptions(optionStrings) {
   }
   return options;
 }
-var _new = async (opts) => {
-  const factory = await FactoryRegistry.FactoryRegistry.interactiveSelect(opts.select);
-  const providedOptions = parseOptions(opts.option);
-  const options = await FactoryRegistry.FactoryRegistry.populateOptions(
-    factory,
-    providedOptions
-  );
-  let defaultVersion = "0.1.0";
-  if (opts.baseVersion) {
-    defaultVersion = opts.baseVersion;
-  } else {
-    const lernaVersion = await fs__default.default.readJson(paths.paths.resolveTargetRoot("lerna.json")).then((pkg) => pkg.version).catch(() => void 0);
-    if (lernaVersion) {
-      defaultVersion = lernaVersion;
-    }
-  }
-  const tempDirs = new Array();
-  async function createTemporaryDirectory(name) {
-    const dir = await fs__default.default.mkdtemp(path.join(os__default.default.tmpdir(), name));
-    tempDirs.push(dir);
-    return dir;
-  }
-  const license = opts.license ?? "Apache-2.0";
-  let modified = false;
-  try {
-    await factory.create(options, {
-      isMonoRepo: await cliNode.isMonoRepo(),
-      defaultVersion,
-      license,
-      scope: opts.scope?.replace(/^@/, ""),
-      npmRegistry: opts.npmRegistry,
-      private: Boolean(opts.private),
-      createTemporaryDirectory,
-      markAsModified() {
-        modified = true;
-      }
-    });
-    tasks.Task.log();
-    tasks.Task.log(`\u{1F389}  Successfully created ${factory.name}`);
-    tasks.Task.log();
-  } catch (error) {
-    errors.assertError(error);
-    tasks.Task.error(error.message);
-    if (modified) {
-      tasks.Task.log("It seems that something went wrong in the creation process \u{1F914}");
-      tasks.Task.log();
-      tasks.Task.log(
-        "We have left the changes that were made intact in case you want to"
-      );
-      tasks.Task.log(
-        "continue manually, but you can also revert the changes and try again."
-      );
-      tasks.Task.error(`\u{1F525}  Failed to create ${factory.name}!`);
-    }
-  } finally {
-    for (const dir of tempDirs) {
-      try {
-        await fs__default.default.remove(dir);
-      } catch (error) {
-        console.error(
-          `Failed to remove temporary directory '${dir}', ${error}`
-        );
-      }
-    }
-  }
-};
 
 exports.default = _new;
 //# sourceMappingURL=new.cjs.js.map

package/dist/commands/start/command.cjs.js

@@ -1,11 +1,37 @@
 'use strict';
 
+var fs = require('fs-extra');
+var node_path = require('node:path');
 var role = require('../../lib/role.cjs.js');
 var startBackend = require('./startBackend.cjs.js');
 var startFrontend = require('./startFrontend.cjs.js');
+var errors = require('@backstage/errors');
+
+function _interopDefaultCompat (e) { return e && typeof e === 'object' && 'default' in e ? e : { default: e }; }
+
+var fs__default = /*#__PURE__*/_interopDefaultCompat(fs);
 
 async function command(opts) {
   const role$1 = await role.findRoleFromCommand(opts);
+  if (opts.link) {
+    const dir = node_path.resolve(opts.link);
+    if (!fs__default.default.pathExistsSync(dir)) {
+      throw new Error(
+        `Invalid workspace link, directory does not exist: ${dir}`
+      );
+    }
+    const pkgJson = await fs__default.default.readJson(node_path.resolve(dir, "package.json")).catch((error) => {
+      throw new errors.ForwardedError(
+        "Failed to read package.json in linked workspace",
+        error
+      );
+    });
+    if (!pkgJson.workspaces) {
+      throw new Error(
+        `Invalid workspace link, directory is not a workspace: ${dir}`
+      );
+    }
+  }
   const options = {
     configPaths: opts.config,
     checksEnabled: Boolean(opts.check),

package/dist/lib/bundler/config.cjs.js

@@ -318,7 +318,7 @@ async function createConfig(paths, options) {
       extensions: [".ts", ".tsx", ".mjs", ".js", ".jsx", ".json", ".wasm"],
       mainFields: ["browser", "module", "main"],
       fallback: {
-        ...pickBy__default.default(require("node-libs-browser")),
+        ...pickBy__default.default(require("node-stdlib-browser")),
         module: false,
         dgram: false,
         dns: false,

package/dist/lib/new/createNewPackage.cjs.js

@@ -0,0 +1,32 @@
+'use strict';
+
+var collectPortableTemplateInput = require('./preparation/collectPortableTemplateInput.cjs.js');
+var loadPortableTemplateConfig = require('./preparation/loadPortableTemplateConfig.cjs.js');
+var selectTemplateInteractively = require('./preparation/selectTemplateInteractively.cjs.js');
+var loadPortableTemplate = require('./preparation/loadPortableTemplate.cjs.js');
+var executePortableTemplate = require('./execution/executePortableTemplate.cjs.js');
+
+async function createNewPackage(options) {
+  const config = await loadPortableTemplateConfig.loadPortableTemplateConfig({
+    overrides: options.configOverrides
+  });
+  const selectedTemplate = await selectTemplateInteractively.selectTemplateInteractively(
+    config,
+    options.preselectedTemplateId
+  );
+  const template = await loadPortableTemplate.loadPortableTemplate(selectedTemplate);
+  const input = await collectPortableTemplateInput.collectPortableTemplateInput({
+    config,
+    template,
+    prefilledParams: options.prefilledParams
+  });
+  await executePortableTemplate.executePortableTemplate({
+    config,
+    template,
+    input,
+    skipInstall: options.skipInstall
+  });
+}
+
+exports.createNewPackage = createNewPackage;
+//# sourceMappingURL=createNewPackage.cjs.js.map

package/dist/lib/new/defaultTemplates.cjs.js

@@ -0,0 +1,16 @@
+'use strict';
+
+const defaultTemplates = [
+  "@backstage/cli/templates/frontend-plugin",
+  "@backstage/cli/templates/backend-plugin",
+  "@backstage/cli/templates/backend-plugin-module",
+  "@backstage/cli/templates/plugin-web-library",
+  "@backstage/cli/templates/plugin-node-library",
+  "@backstage/cli/templates/plugin-common-library",
+  "@backstage/cli/templates/web-library",
+  "@backstage/cli/templates/node-library",
+  "@backstage/cli/templates/scaffolder-backend-module"
+];
+
+exports.defaultTemplates = defaultTemplates;
+//# sourceMappingURL=defaultTemplates.cjs.js.map

package/dist/lib/new/execution/PortableTemplater.cjs.js

@@ -0,0 +1,91 @@
+'use strict';
+
+var handlebars = require('handlebars');
+var camelCase = require('lodash/camelCase');
+var kebabCase = require('lodash/kebabCase');
+var lowerCase = require('lodash/lowerCase');
+var snakeCase = require('lodash/snakeCase');
+var startCase = require('lodash/startCase');
+var upperCase = require('lodash/upperCase');
+var upperFirst = require('lodash/upperFirst');
+var lowerFirst = require('lodash/lowerFirst');
+var Lockfile = require('../../versioning/Lockfile.cjs.js');
+require('minimatch');
+require('@manypkg/get-packages');
+require('chalk');
+require('../../yarn.cjs.js');
+require('../../run.cjs.js');
+var paths = require('../../paths.cjs.js');
+var version = require('../../version.cjs.js');
+
+function _interopDefaultCompat (e) { return e && typeof e === 'object' && 'default' in e ? e : { default: e }; }
+
+var handlebars__default = /*#__PURE__*/_interopDefaultCompat(handlebars);
+var camelCase__default = /*#__PURE__*/_interopDefaultCompat(camelCase);
+var kebabCase__default = /*#__PURE__*/_interopDefaultCompat(kebabCase);
+var lowerCase__default = /*#__PURE__*/_interopDefaultCompat(lowerCase);
+var snakeCase__default = /*#__PURE__*/_interopDefaultCompat(snakeCase);
+var startCase__default = /*#__PURE__*/_interopDefaultCompat(startCase);
+var upperCase__default = /*#__PURE__*/_interopDefaultCompat(upperCase);
+var upperFirst__default = /*#__PURE__*/_interopDefaultCompat(upperFirst);
+var lowerFirst__default = /*#__PURE__*/_interopDefaultCompat(lowerFirst);
+
+const builtInHelpers = {
+  camelCase: camelCase__default.default,
+  kebabCase: kebabCase__default.default,
+  lowerCase: lowerCase__default.default,
+  snakeCase: snakeCase__default.default,
+  startCase: startCase__default.default,
+  upperCase: upperCase__default.default,
+  upperFirst: upperFirst__default.default,
+  lowerFirst: lowerFirst__default.default
+};
+class PortableTemplater {
+  static async create(options = {}) {
+    let lockfile;
+    try {
+      lockfile = await Lockfile.Lockfile.load(paths.paths.resolveTargetRoot("yarn.lock"));
+    } catch {
+    }
+    const versionProvider = version.createPackageVersionProvider(lockfile);
+    const templater = new PortableTemplater(
+      {
+        versionQuery(name, versionHint) {
+          return versionProvider(
+            name,
+            typeof versionHint === "string" ? versionHint : void 0
+          );
+        }
+      },
+      options.values ?? {}
+    );
+    if (options.templatedValues) {
+      templater.appendTemplatedValues(options.templatedValues);
+    }
+    return templater;
+  }
+  #templater;
+  #values;
+  constructor(helpers, values) {
+    this.#templater = handlebars__default.default.create();
+    this.#templater.registerHelper(builtInHelpers);
+    if (helpers) {
+      this.#templater.registerHelper(helpers);
+    }
+    this.#values = values;
+  }
+  template(content) {
+    return this.#templater.compile(content, {
+      strict: true
+    })(this.#values);
+  }
+  appendTemplatedValues(record) {
+    const newValues = Object.fromEntries(
+      Object.entries(record).map(([key, value]) => [key, this.template(value)])
+    );
+    this.#values = { ...this.#values, ...newValues };
+  }
+}
+
+exports.PortableTemplater = PortableTemplater;
+//# sourceMappingURL=PortableTemplater.cjs.js.map

package/dist/lib/new/execution/executePortableTemplate.cjs.js

@@ -0,0 +1,54 @@
+'use strict';
+
+var errors = require('@backstage/errors');
+var codeowners = require('../../codeowners/codeowners.cjs.js');
+var tasks = require('../../tasks.cjs.js');
+var installNewPackage = require('./installNewPackage.cjs.js');
+var writeTemplateContents = require('./writeTemplateContents.cjs.js');
+
+async function executePortableTemplate(options) {
+  const { template, input } = options;
+  let modified = false;
+  try {
+    const { targetDir } = await tasks.Task.forItem(
+      "templating",
+      input.packagePath,
+      () => writeTemplateContents.writeTemplateContents(template, input)
+    );
+    modified = true;
+    await installNewPackage.installNewPackage(input);
+    if (input.owner) {
+      await codeowners.addCodeownersEntry(targetDir, input.owner);
+    }
+    if (!options.skipInstall) {
+      await tasks.Task.forCommand("yarn install", {
+        cwd: targetDir,
+        optional: true
+      });
+      await tasks.Task.forCommand("yarn lint --fix", {
+        cwd: targetDir,
+        optional: true
+      });
+    }
+    tasks.Task.log();
+    tasks.Task.log(`\u{1F389}  Successfully created ${template.name}`);
+    tasks.Task.log();
+  } catch (error) {
+    errors.assertError(error);
+    tasks.Task.error(error.message);
+    if (modified) {
+      tasks.Task.log("It seems that something went wrong in the creation process \u{1F914}");
+      tasks.Task.log();
+      tasks.Task.log(
+        "We have left the changes that were made intact in case you want to"
+      );
+      tasks.Task.log(
+        "continue manually, but you can also revert the changes and try again."
+      );
+      tasks.Task.error(`\u{1F525}  Failed to create ${template.name}!`);
+    }
+  }
+}
+
+exports.executePortableTemplate = executePortableTemplate;
+//# sourceMappingURL=executePortableTemplate.cjs.js.map

package/dist/lib/new/execution/installNewPackage.cjs.js

@@ -0,0 +1,127 @@
+'use strict';
+
+var fs = require('fs-extra');
+var upperFirst = require('lodash/upperFirst');
+var camelCase = require('lodash/camelCase');
+var paths = require('../../paths.cjs.js');
+var tasks = require('../../tasks.cjs.js');
+
+function _interopDefaultCompat (e) { return e && typeof e === 'object' && 'default' in e ? e : { default: e }; }
+
+var fs__default = /*#__PURE__*/_interopDefaultCompat(fs);
+var upperFirst__default = /*#__PURE__*/_interopDefaultCompat(upperFirst);
+var camelCase__default = /*#__PURE__*/_interopDefaultCompat(camelCase);
+
+async function installNewPackage(input) {
+  switch (input.roleParams.role) {
+    case "web-library":
+    case "node-library":
+    case "common-library":
+    case "plugin-web-library":
+    case "plugin-node-library":
+    case "plugin-common-library":
+      return;
+    // No installation action needed for library packages
+    case "frontend-plugin":
+      await addDependency(input, "packages/app/package.json");
+      await tryAddFrontendLegacy(input);
+      return;
+    case "frontend-plugin-module":
+      await addDependency(input, "packages/app/package.json");
+      return;
+    case "backend-plugin":
+      await addDependency(input, "packages/backend/package.json");
+      await tryAddBackend(input);
+      return;
+    case "backend-plugin-module":
+      await addDependency(input, "packages/backend/package.json");
+      await tryAddBackend(input);
+      return;
+    default:
+      throw new Error(
+        `Unsupported role ${input.roleParams.role}`
+      );
+  }
+}
+async function addDependency(input, path) {
+  const pkgJsonPath = paths.paths.resolveTargetRoot(path);
+  const pkgJson = await fs__default.default.readJson(pkgJsonPath).catch((error) => {
+    if (error.code === "ENOENT") {
+      return void 0;
+    }
+    throw error;
+  });
+  if (!pkgJson) {
+    return;
+  }
+  try {
+    pkgJson.dependencies = {
+      ...pkgJson.dependencies,
+      [input.packageName]: `workspace:^`
+    };
+    await fs__default.default.writeJson(path, pkgJson, { spaces: 2 });
+  } catch (error) {
+    throw new Error(`Failed to add package dependencies, ${error}`);
+  }
+}
+async function tryAddFrontendLegacy(input) {
+  const { roleParams } = input;
+  if (roleParams.role !== "frontend-plugin") {
+    throw new Error(
+      "add-frontend-legacy can only be used for frontend plugins"
+    );
+  }
+  const appDefinitionPath = paths.paths.resolveTargetRoot("packages/app/src/App.tsx");
+  if (!await fs__default.default.pathExists(appDefinitionPath)) {
+    return;
+  }
+  await tasks.Task.forItem("app", "adding import", async () => {
+    const content = await fs__default.default.readFile(appDefinitionPath, "utf8");
+    const revLines = content.split("\n").reverse();
+    const lastImportIndex = revLines.findIndex(
+      (line) => line.match(/ from ("|').*("|')/)
+    );
+    const lastRouteIndex = revLines.findIndex(
+      (line) => line.match(/<\/FlatRoutes/)
+    );
+    if (lastImportIndex !== -1 && lastRouteIndex !== -1) {
+      const extensionName = upperFirst__default.default(`${camelCase__default.default(roleParams.pluginId)}Page`);
+      const importLine = `import { ${extensionName} } from '${input.packageName}';`;
+      if (!content.includes(importLine)) {
+        revLines.splice(lastImportIndex, 0, importLine);
+      }
+      const componentLine = `<Route path="/${roleParams.pluginId}" element={<${extensionName} />} />`;
+      if (!content.includes(componentLine)) {
+        const [indentation] = revLines[lastRouteIndex + 1].match(/^\s*/) ?? [];
+        revLines.splice(lastRouteIndex + 1, 0, indentation + componentLine);
+      }
+      const newContent = revLines.reverse().join("\n");
+      await fs__default.default.writeFile(appDefinitionPath, newContent, "utf8");
+    }
+  });
+}
+async function tryAddBackend(input) {
+  const backendIndexPath = paths.paths.resolveTargetRoot(
+    "packages/backend/src/index.ts"
+  );
+  if (!await fs__default.default.pathExists(backendIndexPath)) {
+    return;
+  }
+  await tasks.Task.forItem("backend", `adding ${input.packageName}`, async () => {
+    const content = await fs__default.default.readFile(backendIndexPath, "utf8");
+    const lines = content.split("\n");
+    const backendAddLine = `backend.add(import('${input.packageName}'));`;
+    const backendStartIndex = lines.findIndex(
+      (line) => line.match(/backend.start/)
+    );
+    if (backendStartIndex !== -1) {
+      const [indentation] = lines[backendStartIndex].match(/^\s*/);
+      lines.splice(backendStartIndex, 0, `${indentation}${backendAddLine}`);
+      const newContent = lines.join("\n");
+      await fs__default.default.writeFile(backendIndexPath, newContent, "utf8");
+    }
+  });
+}
+
+exports.installNewPackage = installNewPackage;
+//# sourceMappingURL=installNewPackage.cjs.js.map