@backstage/cli 0.36.0-next.2 → 0.36.1-next.0

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

@@ -1,80 +0,0 @@
-'use strict';
-
-Object.defineProperty(exports, '__esModule', { value: true });
-
-var cleye = require('cleye');
-var startPackage = require('./startPackage.cjs.js');
-var resolveLinkedWorkspace = require('./resolveLinkedWorkspace.cjs.js');
-var role = require('../../../lib/role.cjs.js');
-var cliCommon = require('@backstage/cli-common');
-
-var command = async ({ args, info }) => {
-  const {
-    flags: {
-      config,
-      role: role$1,
-      check,
-      require: requirePath,
-      link,
-      entrypoint,
-      inspect,
-      inspectBrk
-    }
-  } = cleye.cli(
-    {
-      help: info,
-      booleanFlagNegation: true,
-      flags: {
-        config: {
-          type: [String],
-          description: "Config files to load instead of app-config.yaml",
-          default: []
-        },
-        role: {
-          type: String,
-          description: "Run the command with an explicit package role"
-        },
-        check: {
-          type: Boolean,
-          description: "Enable type checking and linting if available"
-        },
-        require: {
-          type: String,
-          description: "Add a --require argument to the node process"
-        },
-        link: {
-          type: String,
-          description: "Link an external workspace for module resolution"
-        },
-        entrypoint: {
-          type: String,
-          description: 'The entrypoint to start from, relative to the package root. Can point to either a file (without extension) or a directory (in which case the index file in that directory is used). Defaults to "dev"'
-        },
-        inspect: {
-          type: String,
-          description: "Enable the Node.js inspector, optionally at a specific host:port"
-        },
-        inspectBrk: {
-          type: String,
-          description: "Enable the Node.js inspector and break before user code starts"
-        }
-      }
-    },
-    void 0,
-    args
-  );
-  await startPackage.startPackage({
-    role: await role.findRoleFromCommand({ role: role$1 }),
-    entrypoint,
-    targetDir: cliCommon.targetPaths.dir,
-    configPaths: config,
-    checksEnabled: Boolean(check),
-    linkedWorkspace: await resolveLinkedWorkspace.resolveLinkedWorkspace(link),
-    inspectEnabled: inspect || (inspect === "" ? true : void 0),
-    inspectBrkEnabled: inspectBrk || (inspectBrk === "" ? true : void 0),
-    require: requirePath
-  });
-};
-
-exports.default = command;
-//# sourceMappingURL=command.cjs.js.map

package/dist/modules/build/commands/package/start/index.cjs.js

@@ -1,10 +0,0 @@
-'use strict';
-
-Object.defineProperty(exports, '__esModule', { value: true });
-
-var command = require('./command.cjs.js');
-
-
-
-exports.default = command.default;
-//# sourceMappingURL=index.cjs.js.map

package/dist/modules/build/commands/package/start/resolveLinkedWorkspace.cjs.js

@@ -1,34 +0,0 @@
-'use strict';
-
-var errors = require('@backstage/errors');
-var fs = require('fs-extra');
-var posix = require('node:path/posix');
-
-function _interopDefaultCompat (e) { return e && typeof e === 'object' && 'default' in e ? e : { default: e }; }
-
-var fs__default = /*#__PURE__*/_interopDefaultCompat(fs);
-
-async function resolveLinkedWorkspace(linkPath) {
-  if (!linkPath) {
-    return void 0;
-  }
-  const dir = posix.resolve(linkPath);
-  if (!fs__default.default.pathExistsSync(dir)) {
-    throw new Error(`Invalid workspace link, directory does not exist: ${dir}`);
-  }
-  const pkgJson = await fs__default.default.readJson(posix.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}`
-    );
-  }
-  return dir;
-}
-
-exports.resolveLinkedWorkspace = resolveLinkedWorkspace;
-//# sourceMappingURL=resolveLinkedWorkspace.cjs.js.map

package/dist/modules/build/commands/package/start/startBackend.cjs.js

@@ -1,46 +0,0 @@
-'use strict';
-
-var fs = require('fs-extra');
-var path = require('node:path');
-var cliCommon = require('@backstage/cli-common');
-var runBackend = require('../../../lib/runner/runBackend.cjs.js');
-
-function _interopDefaultCompat (e) { return e && typeof e === 'object' && 'default' in e ? e : { default: e }; }
-
-var fs__default = /*#__PURE__*/_interopDefaultCompat(fs);
-
-async function startBackend(options) {
-  const waitForExit = await runBackend.runBackend({
-    targetDir: options.targetDir,
-    entry: "src/index",
-    inspectEnabled: options.inspectEnabled,
-    inspectBrkEnabled: options.inspectBrkEnabled,
-    linkedWorkspace: options.linkedWorkspace,
-    require: options.require
-  });
-  await waitForExit();
-}
-async function startBackendPlugin(options) {
-  const hasDevIndexEntry = await fs__default.default.pathExists(
-    path.resolve(options.targetDir ?? cliCommon.targetPaths.dir, "dev/index.ts")
-  );
-  if (!hasDevIndexEntry) {
-    console.warn(
-      `The 'dev' directory is missing. Please create a proper dev/index.ts in order to start the plugin.`
-    );
-    return;
-  }
-  const waitForExit = await runBackend.runBackend({
-    targetDir: options.targetDir,
-    entry: "dev/index",
-    inspectEnabled: options.inspectEnabled,
-    inspectBrkEnabled: options.inspectBrkEnabled,
-    require: options.require,
-    linkedWorkspace: options.linkedWorkspace
-  });
-  await waitForExit();
-}
-
-exports.startBackend = startBackend;
-exports.startBackendPlugin = startBackendPlugin;
-//# sourceMappingURL=startBackend.cjs.js.map

package/dist/modules/build/commands/package/start/startFrontend.cjs.js

@@ -1,50 +0,0 @@
-'use strict';
-
-var fs = require('fs-extra');
-var path = require('node:path');
-require('yn');
-require('@rspack/core');
-require('react-dev-utils/FileSizeReporter');
-require('react-dev-utils/formatWebpackMessages');
-require('eslint-rspack-plugin');
-require('ts-checker-rspack-plugin');
-require('html-webpack-plugin');
-require('react-dev-utils/ModuleScopePlugin');
-require('@module-federation/enhanced/rspack');
-require('lodash/pickBy');
-var cliCommon = require('@backstage/cli-common');
-require('../../../../../wiring/version.cjs.js');
-var hasReactDomClient = require('../../../lib/bundler/hasReactDomClient.cjs.js');
-require('@manypkg/get-packages');
-require('chalk');
-require('../../../lib/bundler/packageDetection.cjs.js');
-var moduleFederation = require('../../../lib/bundler/moduleFederation.cjs.js');
-var server = require('../../../lib/bundler/server.cjs.js');
-
-async function startFrontend(options) {
-  const packageJson = await fs.readJson(
-    path.resolve(options.targetDir ?? cliCommon.targetPaths.dir, "package.json")
-  );
-  if (!hasReactDomClient.hasReactDomClient()) {
-    console.warn(
-      "React 17 is now deprecated! Please follow the Backstage migration guide to update to React 18: https://backstage.io/docs/tutorials/react18-migration/"
-    );
-  }
-  const waitForExit = await server.serveBundle({
-    entry: options.entry,
-    targetDir: options.targetDir,
-    checksEnabled: options.checksEnabled,
-    configPaths: options.configPaths,
-    verifyVersions: options.verifyVersions,
-    skipOpenBrowser: options.skipOpenBrowser,
-    linkedWorkspace: options.linkedWorkspace,
-    moduleFederationRemote: options.isModuleFederationRemote ? await moduleFederation.getModuleFederationRemoteOptions(
-      packageJson,
-      path.resolve(cliCommon.targetPaths.dir)
-    ) : void 0
-  });
-  await waitForExit();
-}
-
-exports.startFrontend = startFrontend;
-//# sourceMappingURL=startFrontend.cjs.js.map

package/dist/modules/build/commands/package/start/startPackage.cjs.js

@@ -1,53 +0,0 @@
-'use strict';
-
-var startBackend = require('./startBackend.cjs.js');
-var startFrontend = require('./startFrontend.cjs.js');
-var path = require('node:path');
-var glob = require('glob');
-
-function resolveEntryPath(entrypoint = "dev", targetDir) {
-  const { dir: entryDir, name: entryName } = path.parse(entrypoint);
-  const [entryFile] = glob.glob.sync(`${path.resolve(targetDir, entryDir, entryName)}.*`);
-  if (entryFile) {
-    return path.join(entryDir, entryName);
-  }
-  return path.join(entryDir, entryName, "index");
-}
-async function startPackage(options) {
-  switch (options.role) {
-    case "backend":
-      return startBackend.startBackend(options);
-    case "backend-plugin":
-    case "backend-plugin-module":
-    case "node-library":
-      return startBackend.startBackendPlugin(options);
-    case "frontend":
-      return startFrontend.startFrontend({
-        ...options,
-        entry: "src/index",
-        verifyVersions: true
-      });
-    case "web-library":
-    case "frontend-plugin":
-    case "frontend-plugin-module":
-      return startFrontend.startFrontend({
-        ...options,
-        entry: resolveEntryPath(options.entrypoint, options.targetDir)
-      });
-    case "frontend-dynamic-container":
-      return startFrontend.startFrontend({
-        entry: "src/index",
-        ...options,
-        skipOpenBrowser: true,
-        isModuleFederationRemote: true
-      });
-    default:
-      throw new Error(
-        `Start command is not supported for package role '${options.role}'`
-      );
-  }
-}
-
-exports.resolveEntryPath = resolveEntryPath;
-exports.startPackage = startPackage;
-//# sourceMappingURL=startPackage.cjs.js.map

package/dist/modules/build/commands/repo/build.cjs.js

@@ -1,149 +0,0 @@
-'use strict';
-
-Object.defineProperty(exports, '__esModule', { value: true });
-
-var chalk = require('chalk');
-var cleye = require('cleye');
-var path = require('node:path');
-var packager = require('../../lib/builder/packager.cjs.js');
-var cliCommon = require('@backstage/cli-common');
-var cliNode = require('@backstage/cli-node');
-var buildFrontend = require('../../lib/buildFrontend.cjs.js');
-var buildBackend = require('../../lib/buildBackend.cjs.js');
-var optionsParser = require('../../lib/optionsParser.cjs.js');
-
-function _interopDefaultCompat (e) { return e && typeof e === 'object' && 'default' in e ? e : { default: e }; }
-
-var chalk__default = /*#__PURE__*/_interopDefaultCompat(chalk);
-
-var build = async ({ args, info }) => {
-  const {
-    flags: { all, since, minify }
-  } = cleye.cli(
-    {
-      help: info,
-      booleanFlagNegation: true,
-      flags: {
-        all: {
-          type: Boolean,
-          description: "Build all packages, including bundled app and backend packages."
-        },
-        since: {
-          type: String,
-          description: "Only build packages and their dev dependents that changed since the specified ref"
-        },
-        minify: {
-          type: Boolean,
-          description: "Minify the generated code. Does not apply to app package (app is minified by default)."
-        }
-      }
-    },
-    void 0,
-    args
-  );
-  let packages = await cliNode.PackageGraph.listTargetPackages();
-  const webpack = process.env.LEGACY_WEBPACK_BUILD ? require("webpack") : void 0;
-  if (since) {
-    const graph = cliNode.PackageGraph.fromPackages(packages);
-    const changedPackages = await graph.listChangedPackages({
-      ref: since,
-      analyzeLockfile: true
-    });
-    const withDevDependents = graph.collectPackageNames(
-      changedPackages.map((pkg) => pkg.name),
-      (pkg) => pkg.localDevDependents.keys()
-    );
-    packages = Array.from(withDevDependents).map((name) => graph.get(name));
-  }
-  const apps = new Array();
-  const backends = new Array();
-  const parseBuildScript = optionsParser.createScriptOptionsParser(["package", "build"], {
-    role: { type: "string" },
-    minify: { type: "boolean" },
-    "skip-build-dependencies": { type: "boolean" },
-    stats: { type: "boolean" },
-    config: { type: "string", multiple: true },
-    "module-federation": { type: "boolean" }
-  });
-  const options = packages.flatMap((pkg) => {
-    const role = pkg.packageJson.backstage?.role ?? cliNode.PackageRoles.detectRoleFromPackage(pkg.packageJson);
-    if (!role) {
-      console.warn(`Ignored ${pkg.packageJson.name} because it has no role`);
-      return [];
-    }
-    if (role === "frontend") {
-      apps.push(pkg);
-      return [];
-    } else if (role === "backend") {
-      backends.push(pkg);
-      return [];
-    }
-    const outputs = packager.getOutputsForRole(role);
-    if (outputs.size === 0) {
-      console.warn(`Ignored ${pkg.packageJson.name} because it has no output`);
-      return [];
-    }
-    const buildOptions = parseBuildScript(pkg.packageJson.scripts?.build);
-    if (!buildOptions) {
-      console.warn(
-        `Ignored ${pkg.packageJson.name} because it does not have a matching build script`
-      );
-      return [];
-    }
-    return {
-      targetDir: pkg.dir,
-      packageJson: pkg.packageJson,
-      outputs,
-      logPrefix: `${chalk__default.default.cyan(path.relative(cliCommon.targetPaths.rootDir, pkg.dir))}: `,
-      workspacePackages: packages,
-      minify: minify ?? Boolean(buildOptions.minify)
-    };
-  });
-  console.log("Building packages");
-  await packager.buildPackages(options);
-  if (all) {
-    console.log("Building apps");
-    await cliNode.runConcurrentTasks({
-      items: apps,
-      concurrencyFactor: 1 / 2,
-      worker: async (pkg) => {
-        const buildOptions = parseBuildScript(pkg.packageJson.scripts?.build);
-        if (!buildOptions) {
-          console.warn(
-            `Ignored ${pkg.packageJson.name} because it does not have a matching build script`
-          );
-          return;
-        }
-        const configPaths = buildOptions.config;
-        await buildFrontend.buildFrontend({
-          targetDir: pkg.dir,
-          configPaths: Array.isArray(configPaths) ? configPaths : [],
-          writeStats: Boolean(buildOptions.stats),
-          webpack
-        });
-      }
-    });
-    console.log("Building backends");
-    await cliNode.runConcurrentTasks({
-      items: backends,
-      concurrencyFactor: 1 / 2,
-      worker: async (pkg) => {
-        const buildOptions = parseBuildScript(pkg.packageJson.scripts?.build);
-        if (!buildOptions) {
-          console.warn(
-            `Ignored ${pkg.packageJson.name} because it does not have a matching build script`
-          );
-          return;
-        }
-        await buildBackend.buildBackend({
-          targetDir: pkg.dir,
-          skipBuildDependencies: true,
-          minify: minify ?? Boolean(buildOptions.minify)
-        });
-      }
-    });
-  }
-};
-
-exports.default = build;
-//# sourceMappingURL=build.cjs.js.map

package/dist/modules/build/commands/repo/clean.cjs.js

@@ -1,41 +0,0 @@
-'use strict';
-
-Object.defineProperty(exports, '__esModule', { value: true });
-
-var cleye = require('cleye');
-var fs = require('fs-extra');
-var path = require('node:path');
-var cliNode = require('@backstage/cli-node');
-var cliCommon = require('@backstage/cli-common');
-
-function _interopDefaultCompat (e) { return e && typeof e === 'object' && 'default' in e ? e : { default: e }; }
-
-var fs__default = /*#__PURE__*/_interopDefaultCompat(fs);
-
-var clean = async ({ args, info }) => {
-  cleye.cli({ help: info, booleanFlagNegation: true }, void 0, args);
-  const packages = await cliNode.PackageGraph.listTargetPackages();
-  await fs__default.default.remove(cliCommon.targetPaths.resolveRoot("dist"));
-  await fs__default.default.remove(cliCommon.targetPaths.resolveRoot("dist-types"));
-  await fs__default.default.remove(cliCommon.targetPaths.resolveRoot("coverage"));
-  await Promise.all(
-    Array.from(Array(10), async () => {
-      while (packages.length > 0) {
-        const pkg = packages.pop();
-        const cleanScript = pkg.packageJson.scripts?.clean;
-        if (cleanScript === "backstage-cli clean" || cleanScript === "backstage-cli package clean") {
-          await fs__default.default.remove(path.resolve(pkg.dir, "dist"));
-          await fs__default.default.remove(path.resolve(pkg.dir, "dist-types"));
-          await fs__default.default.remove(path.resolve(pkg.dir, "coverage"));
-        } else if (cleanScript) {
-          await cliCommon.run(["yarn", "run", "clean"], {
-            cwd: pkg.dir
-          }).waitForExit();
-        }
-      }
-    })
-  );
-};
-
-exports.default = clean;
-//# sourceMappingURL=clean.cjs.js.map

package/dist/modules/build/commands/repo/start.cjs.js

@@ -1,199 +0,0 @@
-'use strict';
-
-Object.defineProperty(exports, '__esModule', { value: true });
-
-var cliNode = require('@backstage/cli-node');
-var path = require('node:path');
-var cliCommon = require('@backstage/cli-common');
-var cleye = require('cleye');
-var resolveLinkedWorkspace = require('../package/start/resolveLinkedWorkspace.cjs.js');
-var startPackage = require('../package/start/startPackage.cjs.js');
-var node_util = require('node:util');
-
-const ACCEPTED_PACKAGE_ROLES = [
-  "frontend",
-  "backend",
-  "frontend-plugin",
-  "backend-plugin"
-];
-var start = async ({ args, info }) => {
-  const {
-    flags: { plugin, config, require: requirePath, link, inspect, inspectBrk },
-    _: namesOrPaths
-  } = cleye.cli(
-    {
-      help: { ...info, usage: `${info.usage} [packages...]` },
-      booleanFlagNegation: true,
-      parameters: ["[packages...]"],
-      flags: {
-        plugin: {
-          type: [String],
-          description: "Start the dev entry-point for any matching plugin package in the repo",
-          default: []
-        },
-        config: {
-          type: [String],
-          description: "Config files to load instead of app-config.yaml",
-          default: []
-        },
-        require: {
-          type: String,
-          description: "Add a --require argument to the node process. Applies to backend package only"
-        },
-        link: {
-          type: String,
-          description: "Link an external workspace for module resolution"
-        },
-        inspect: {
-          type: String,
-          description: "Enable the Node.js inspector, optionally at a specific host:port"
-        },
-        inspectBrk: {
-          type: String,
-          description: "Enable the Node.js inspector and break before user code starts"
-        }
-      }
-    },
-    void 0,
-    args
-  );
-  const targetPackages = await findTargetPackages(namesOrPaths, plugin);
-  const packageOptions = await resolvePackageOptions(targetPackages, {
-    config,
-    inspect: inspect || (inspect === "" ? true : void 0),
-    inspectBrk: inspectBrk || (inspectBrk === "" ? true : void 0),
-    require: requirePath,
-    link
-  });
-  if (packageOptions.length === 0) {
-    console.log("No packages found to start");
-    return;
-  }
-  console.log(
-    `Starting ${packageOptions.map(({ pkg }) => pkg.packageJson.name).join(", ")}`
-  );
-  await Promise.all(packageOptions.map((entry) => startPackage.startPackage(entry.options)));
-};
-async function findTargetPackages(namesOrPaths, pluginIds) {
-  const targetPackages = new Array();
-  const packages = await cliNode.PackageGraph.listTargetPackages();
-  for (const pluginId of pluginIds) {
-    const matchingPackages = packages.filter((pkg) => {
-      return pluginId === pkg.packageJson.backstage?.pluginId && ACCEPTED_PACKAGE_ROLES.includes(pkg.packageJson.backstage.role);
-    });
-    if (matchingPackages.length === 0) {
-      throw new Error(
-        `Unable to find any plugin packages with plugin ID '${pluginId}'. Make sure backstage.pluginId is set in your package.json files by running 'yarn fix --publish'.`
-      );
-    }
-    targetPackages.push(...matchingPackages);
-  }
-  if (targetPackages.length > 0) {
-    return targetPackages;
-  }
-  for (const nameOrPath of namesOrPaths) {
-    let matchingPackage = packages.find(
-      (pkg) => nameOrPath === pkg.packageJson.name
-    );
-    if (!matchingPackage) {
-      const absPath = cliCommon.targetPaths.resolveRoot(nameOrPath);
-      matchingPackage = packages.find(
-        (pkg) => path.relative(pkg.dir, absPath) === ""
-      );
-    }
-    if (!matchingPackage) {
-      throw new Error(`Unable to find package by name '${nameOrPath}'`);
-    }
-    targetPackages.push(matchingPackage);
-  }
-  if (targetPackages.length > 0) {
-    return targetPackages;
-  }
-  for (const role of ["frontend", "backend"]) {
-    const matchingPackages = packages.filter(
-      (pkg) => pkg.packageJson.backstage?.role === role
-    );
-    if (matchingPackages.length > 1) {
-      const expectedPath = cliCommon.targetPaths.resolveRoot(
-        role === "frontend" ? "packages/app" : "packages/backend"
-      );
-      const matchByPath = matchingPackages.find(
-        (pkg) => path.relative(expectedPath, pkg.dir) === ""
-      );
-      if (matchByPath) {
-        targetPackages.push(matchByPath);
-        continue;
-      }
-      throw new Error(
-        `Found multiple packages with role '${role}' but none of the use the default path '${expectedPath}',choose which packages you want to run by passing the package names explicitly as arguments, for example 'yarn backstage-cli repo start my-app my-backend'.`
-      );
-    }
-    targetPackages.push(...matchingPackages);
-  }
-  if (targetPackages.length > 0) {
-    return targetPackages;
-  }
-  for (const role of ["frontend-plugin", "backend-plugin"]) {
-    const matchingPackages = packages.filter(
-      (pkg) => pkg.packageJson.backstage?.role === role
-    );
-    if (matchingPackages.length > 1) {
-      throw new Error(
-        `Found multiple packages with role '${role}', please choose which packages you want to run by passing the package names explicitly as arguments, for example 'yarn backstage-cli repo start my-plugin my-plugin-backend'.`
-      );
-    }
-    targetPackages.push(...matchingPackages);
-  }
-  if (targetPackages.length > 0) {
-    return targetPackages;
-  }
-  throw new Error(
-    `Unable to find any packages with role 'frontend', 'backend', 'frontend-plugin', or 'backend-plugin'.`
-  );
-}
-async function resolvePackageOptions(targetPackages, options) {
-  const linkedWorkspace = await resolveLinkedWorkspace.resolveLinkedWorkspace(options.link);
-  return targetPackages.flatMap((pkg) => {
-    const startScript = pkg.packageJson.scripts?.start;
-    if (!startScript) {
-      console.log(
-        `No start script found for package ${pkg.packageJson.name}, skipping...`
-      );
-      return [];
-    }
-    const { values: parsedOpts } = node_util.parseArgs({
-      args: startScript.split(" "),
-      strict: false,
-      options: {
-        config: {
-          type: "string",
-          multiple: true
-        },
-        require: {
-          type: "string"
-        }
-      }
-    });
-    const parsedRequire = typeof parsedOpts.require === "string" ? parsedOpts.require : void 0;
-    const parsedConfig = parsedOpts.config?.filter((c) => typeof c === "string") ?? [];
-    return [
-      {
-        pkg,
-        options: {
-          role: pkg.packageJson.backstage?.role,
-          targetDir: pkg.dir,
-          configPaths: options.config.length > 0 ? options.config : parsedConfig,
-          checksEnabled: false,
-          linkedWorkspace,
-          inspectEnabled: options.inspect,
-          inspectBrkEnabled: options.inspectBrk,
-          require: options.require ?? parsedRequire
-        }
-      }
-    ];
-  });
-}
-
-exports.default = start;
-exports.findTargetPackages = findTargetPackages;
-//# sourceMappingURL=start.cjs.js.map