@backstage/cli-common 0.1.15 → 0.1.16-next.1

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # @backstage/cli-common
 
+## 0.1.16-next.1
+
+### Patch Changes
+
+- 5cfb2a4: Added new `run`, `runOutput`, and `runCheck` utilities to help run child processes in a safe and portable way.
+
+## 0.1.16-next.0
+
+### Patch Changes
+
+- c8c2329: Add proxy configuration from env-vars to create-app tasks
+
 ## 0.1.15
 
 ### Patch Changes

package/dist/errors.cjs.js

@@ -0,0 +1,16 @@
+'use strict';
+
+var errors = require('@backstage/errors');
+
+class ExitCodeError extends errors.CustomErrorBase {
+  code;
+  constructor(code, command) {
+    super(
+      command ? `Command '${command}' exited with code ${code}` : `Child exited with code ${code}`
+    );
+    this.code = code;
+  }
+}
+
+exports.ExitCodeError = ExitCodeError;
+//# sourceMappingURL=errors.cjs.js.map

package/dist/errors.cjs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.cjs.js","sources":["../src/errors.ts"],"sourcesContent":["/*\n * Copyright 2020 The Backstage Authors\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport { CustomErrorBase } from '@backstage/errors';\n\n/**\n * Error thrown when a child process exits with a non-zero code.\n * @public\n */\nexport class ExitCodeError extends CustomErrorBase {\n  readonly code: number;\n\n  constructor(code: number, command?: string) {\n    super(\n      command\n        ? `Command '${command}' exited with code ${code}`\n        : `Child exited with code ${code}`,\n    );\n    this.code = code;\n  }\n}\n"],"names":["CustomErrorBase"],"mappings":";;;;AAsBO,MAAM,sBAAsBA,sBAAA,CAAgB;AAAA,EACxC,IAAA;AAAA,EAET,WAAA,CAAY,MAAc,OAAA,EAAkB;AAC1C,IAAA,KAAA;AAAA,MACE,UACI,CAAA,SAAA,EAAY,OAAO,sBAAsB,IAAI,CAAA,CAAA,GAC7C,0BAA0B,IAAI,CAAA;AAAA,KACpC;AACA,IAAA,IAAA,CAAK,IAAA,GAAO,IAAA;AAAA,EACd;AACF;;;;"}

package/dist/index.cjs.js

@@ -2,10 +2,18 @@
 
 var paths = require('./paths.cjs.js');
 var isChildPath = require('./isChildPath.cjs.js');
+var proxyBootstrap = require('./proxyBootstrap.cjs.js');
+var run = require('./run.cjs.js');
+var errors = require('./errors.cjs.js');
 
 
 
 exports.BACKSTAGE_JSON = paths.BACKSTAGE_JSON;
 exports.findPaths = paths.findPaths;
 exports.isChildPath = isChildPath.isChildPath;
+exports.bootstrapEnvProxyAgents = proxyBootstrap.bootstrapEnvProxyAgents;
+exports.run = run.run;
+exports.runCheck = run.runCheck;
+exports.runOutput = run.runOutput;
+exports.ExitCodeError = errors.ExitCodeError;
 //# sourceMappingURL=index.cjs.js.map

package/dist/index.cjs.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.cjs.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;"}
+{"version":3,"file":"index.cjs.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;;;;;;;"}

package/dist/index.d.ts

@@ -1,3 +1,6 @@
+import { SpawnOptions, ChildProcess } from 'child_process';
+import { CustomErrorBase } from '@backstage/errors';
+
 /**
  * A function that takes a set of path fragments and resolves them into a
  * single complete path, relative to some root.
@@ -44,4 +47,87 @@ declare const BACKSTAGE_JSON = "backstage.json";
  */
 declare function isChildPath(base: string, path: string): boolean;
 
-export { BACKSTAGE_JSON, type Paths, type ResolveFunc, findPaths, isChildPath };
+/**
+ * This function can be called to setup undici and node-fetch Proxy agents.
+ *
+ * You can set GLOBAL_AGENT_HTTP(S)_PROXY to configure a proxy to be used in the
+ * CLIs.
+ *
+ * You can also configure a custom namespace by setting
+ * GLOBAL_AGENT_ENVIRONMENT_VARIABLE_NAMESPACE which will replace the default
+ * "GLOBAL_AGENT_" env-var prefix.
+ *
+ * Make sure to call this function before any other imports.
+ *
+ * @public
+ */
+declare function bootstrapEnvProxyAgents(): void;
+
+/**
+ * Callback function that can be used to receive stdout or stderr data from a child process.
+ *
+ * @public
+ */
+type RunOnOutput = (data: Buffer) => void;
+/**
+ * Options for running a child process with {@link run} or related functions.
+ *
+ * @public
+ */
+type RunOptions = Omit<SpawnOptions, 'env'> & {
+    env?: Partial<NodeJS.ProcessEnv>;
+    onStdout?: RunOnOutput;
+    onStderr?: RunOnOutput;
+    stdio?: SpawnOptions['stdio'];
+};
+/**
+ * Child process handle returned by {@link run}.
+ *
+ * @public
+ */
+interface RunChildProcess extends ChildProcess {
+    /**
+     * Waits for the child process to exit.
+     *
+     * @remarks
+     *
+     * Resolves when the process exits successfully (exit code 0) or is terminated by a signal.
+     * If the process exits with a non-zero exit code, the promise is rejected with an {@link ExitCodeError}.
+     *
+     * @returns A promise that resolves when the process exits successfully or is terminated by a signal, or rejects on error.
+     */
+    waitForExit(): Promise<void>;
+}
+/**
+ * Runs a command and returns a child process handle.
+ *
+ * @public
+ */
+declare function run(args: string[], options?: RunOptions): RunChildProcess;
+/**
+ * Runs a command and returns the stdout.
+ *
+ * @remarks
+ *
+ * On error, both stdout and stderr are attached to the error object as properties.
+ *
+ * @public
+ */
+declare function runOutput(args: string[], options?: RunOptions): Promise<string>;
+/**
+ * Runs a command and returns true if it exits with code 0, false otherwise.
+ *
+ * @public
+ */
+declare function runCheck(args: string[]): Promise<boolean>;
+
+/**
+ * Error thrown when a child process exits with a non-zero code.
+ * @public
+ */
+declare class ExitCodeError extends CustomErrorBase {
+    readonly code: number;
+    constructor(code: number, command?: string);
+}
+
+export { BACKSTAGE_JSON, ExitCodeError, type Paths, type ResolveFunc, type RunChildProcess, type RunOnOutput, type RunOptions, bootstrapEnvProxyAgents, findPaths, isChildPath, run, runCheck, runOutput };

package/dist/isChildPath.cjs.js.map

@@ -1 +1 @@
-{"version":3,"file":"isChildPath.cjs.js","sources":["../src/isChildPath.ts"],"sourcesContent":["/*\n * Copyright 2021 The Backstage Authors\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport { relative, isAbsolute } from 'path';\n\n/**\n * Checks if path is the same as or a child path of base.\n *\n * @public\n */\nexport function isChildPath(base: string, path: string): boolean {\n  const relativePath = relative(base, path);\n  if (relativePath === '') {\n    // The same directory\n    return true;\n  }\n\n  const outsideBase = relativePath.startsWith('..'); // not outside base\n  const differentDrive = isAbsolute(relativePath); // on Windows, this means dir is on a different drive from base.\n\n  return !outsideBase && !differentDrive;\n}\n"],"names":["path","relative","isAbsolute"],"mappings":";;;;AAuBgB,SAAA,WAAA,CAAY,MAAcA,MAAuB,EAAA;AAC/D,EAAM,MAAA,YAAA,GAAeC,aAAS,CAAA,IAAA,EAAMD,MAAI,CAAA;AACxC,EAAA,IAAI,iBAAiB,EAAI,EAAA;AAEvB,IAAO,OAAA,IAAA;AAAA;AAGT,EAAM,MAAA,WAAA,GAAc,YAAa,CAAA,UAAA,CAAW,IAAI,CAAA;AAChD,EAAM,MAAA,cAAA,GAAiBE,gBAAW,YAAY,CAAA;AAE9C,EAAO,OAAA,CAAC,eAAe,CAAC,cAAA;AAC1B;;;;"}
+{"version":3,"file":"isChildPath.cjs.js","sources":["../src/isChildPath.ts"],"sourcesContent":["/*\n * Copyright 2021 The Backstage Authors\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport { relative, isAbsolute } from 'path';\n\n/**\n * Checks if path is the same as or a child path of base.\n *\n * @public\n */\nexport function isChildPath(base: string, path: string): boolean {\n  const relativePath = relative(base, path);\n  if (relativePath === '') {\n    // The same directory\n    return true;\n  }\n\n  const outsideBase = relativePath.startsWith('..'); // not outside base\n  const differentDrive = isAbsolute(relativePath); // on Windows, this means dir is on a different drive from base.\n\n  return !outsideBase && !differentDrive;\n}\n"],"names":["path","relative","isAbsolute"],"mappings":";;;;AAuBO,SAAS,WAAA,CAAY,MAAcA,MAAA,EAAuB;AAC/D,EAAA,MAAM,YAAA,GAAeC,aAAA,CAAS,IAAA,EAAMD,MAAI,CAAA;AACxC,EAAA,IAAI,iBAAiB,EAAA,EAAI;AAEvB,IAAA,OAAO,IAAA;AAAA,EACT;AAEA,EAAA,MAAM,WAAA,GAAc,YAAA,CAAa,UAAA,CAAW,IAAI,CAAA;AAChD,EAAA,MAAM,cAAA,GAAiBE,gBAAW,YAAY,CAAA;AAE9C,EAAA,OAAO,CAAC,eAAe,CAAC,cAAA;AAC1B;;;;"}

package/dist/paths.cjs.js.map

@@ -1 +1 @@
-{"version":3,"file":"paths.cjs.js","sources":["../src/paths.ts"],"sourcesContent":["/*\n * Copyright 2020 The Backstage Authors\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport fs from 'fs';\nimport { dirname, resolve as resolvePath } from 'path';\n\n/**\n * A function that takes a set of path fragments and resolves them into a\n * single complete path, relative to some root.\n *\n * @public\n */\nexport type ResolveFunc = (...paths: string[]) => string;\n\n/**\n * Common paths and resolve functions used by the cli.\n * Currently assumes it is being executed within a monorepo.\n *\n * @public\n */\nexport type Paths = {\n  // Root dir of the cli itself, containing package.json\n  ownDir: string;\n\n  // Monorepo root dir of the cli itself. Only accessible when running inside Backstage repo.\n  ownRoot: string;\n\n  // The location of the app that the cli is being executed in\n  targetDir: string;\n\n  // The monorepo root package of the app that the cli is being executed in.\n  targetRoot: string;\n\n  // Resolve a path relative to own repo\n  resolveOwn: ResolveFunc;\n\n  // Resolve a path relative to own monorepo root. Only accessible when running inside Backstage repo.\n  resolveOwnRoot: ResolveFunc;\n\n  // Resolve a path relative to the app\n  resolveTarget: ResolveFunc;\n\n  // Resolve a path relative to the app repo root\n  resolveTargetRoot: ResolveFunc;\n};\n\n// Looks for a package.json with a workspace config to identify the root of the monorepo\nexport function findRootPath(\n  searchDir: string,\n  filterFunc: (pkgJsonPath: string) => boolean,\n): string | undefined {\n  let path = searchDir;\n\n  // Some confidence check to avoid infinite loop\n  for (let i = 0; i < 1000; i++) {\n    const packagePath = resolvePath(path, 'package.json');\n    const exists = fs.existsSync(packagePath);\n    if (exists && filterFunc(packagePath)) {\n      return path;\n    }\n\n    const newPath = dirname(path);\n    if (newPath === path) {\n      return undefined;\n    }\n    path = newPath;\n  }\n\n  throw new Error(\n    `Iteration limit reached when searching for root package.json at ${searchDir}`,\n  );\n}\n\n// Finds the root of a given package\nexport function findOwnDir(searchDir: string) {\n  const path = findRootPath(searchDir, () => true);\n  if (!path) {\n    throw new Error(\n      `No package.json found while searching for package root of ${searchDir}`,\n    );\n  }\n  return path;\n}\n\n// Finds the root of the monorepo that the package exists in. Only accessible when running inside Backstage repo.\nexport function findOwnRootDir(ownDir: string) {\n  const isLocal = fs.existsSync(resolvePath(ownDir, 'src'));\n  if (!isLocal) {\n    throw new Error(\n      'Tried to access monorepo package root dir outside of Backstage repository',\n    );\n  }\n\n  return resolvePath(ownDir, '../..');\n}\n\n/**\n * Find paths related to a package and its execution context.\n *\n * @public\n * @example\n *\n * const paths = findPaths(__dirname)\n */\nexport function findPaths(searchDir: string): Paths {\n  const ownDir = findOwnDir(searchDir);\n  // Drive letter can end up being lowercased here on Windows, bring back to uppercase for consistency\n  const targetDir = fs\n    .realpathSync(process.cwd())\n    .replace(/^[a-z]:/, str => str.toLocaleUpperCase('en-US'));\n\n  // Lazy load this as it will throw an error if we're not inside the Backstage repo.\n  let ownRoot = '';\n  const getOwnRoot = () => {\n    if (!ownRoot) {\n      ownRoot = findOwnRootDir(ownDir);\n    }\n    return ownRoot;\n  };\n\n  // We're not always running in a monorepo, so we lazy init this to only crash commands\n  // that require a monorepo when we're not in one.\n  let targetRoot = '';\n  const getTargetRoot = () => {\n    if (!targetRoot) {\n      targetRoot =\n        findRootPath(targetDir, path => {\n          try {\n            const content = fs.readFileSync(path, 'utf8');\n            const data = JSON.parse(content);\n            return Boolean(data.workspaces);\n          } catch (error) {\n            throw new Error(\n              `Failed to parse package.json file while searching for root, ${error}`,\n            );\n          }\n        }) ?? targetDir; // We didn't find any root package.json, assume we're not in a monorepo\n    }\n    return targetRoot;\n  };\n\n  return {\n    ownDir,\n    get ownRoot() {\n      return getOwnRoot();\n    },\n    targetDir,\n    get targetRoot() {\n      return getTargetRoot();\n    },\n    resolveOwn: (...paths) => resolvePath(ownDir, ...paths),\n    resolveOwnRoot: (...paths) => resolvePath(getOwnRoot(), ...paths),\n    resolveTarget: (...paths) => resolvePath(targetDir, ...paths),\n    resolveTargetRoot: (...paths) => resolvePath(getTargetRoot(), ...paths),\n  };\n}\n\n/**\n * The name of the backstage's config file\n *\n * @public\n */\nexport const BACKSTAGE_JSON = 'backstage.json';\n"],"names":["path","resolvePath","fs","dirname"],"mappings":"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"}
+{"version":3,"file":"paths.cjs.js","sources":["../src/paths.ts"],"sourcesContent":["/*\n * Copyright 2020 The Backstage Authors\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport fs from 'fs';\nimport { dirname, resolve as resolvePath } from 'path';\n\n/**\n * A function that takes a set of path fragments and resolves them into a\n * single complete path, relative to some root.\n *\n * @public\n */\nexport type ResolveFunc = (...paths: string[]) => string;\n\n/**\n * Common paths and resolve functions used by the cli.\n * Currently assumes it is being executed within a monorepo.\n *\n * @public\n */\nexport type Paths = {\n  // Root dir of the cli itself, containing package.json\n  ownDir: string;\n\n  // Monorepo root dir of the cli itself. Only accessible when running inside Backstage repo.\n  ownRoot: string;\n\n  // The location of the app that the cli is being executed in\n  targetDir: string;\n\n  // The monorepo root package of the app that the cli is being executed in.\n  targetRoot: string;\n\n  // Resolve a path relative to own repo\n  resolveOwn: ResolveFunc;\n\n  // Resolve a path relative to own monorepo root. Only accessible when running inside Backstage repo.\n  resolveOwnRoot: ResolveFunc;\n\n  // Resolve a path relative to the app\n  resolveTarget: ResolveFunc;\n\n  // Resolve a path relative to the app repo root\n  resolveTargetRoot: ResolveFunc;\n};\n\n// Looks for a package.json with a workspace config to identify the root of the monorepo\nexport function findRootPath(\n  searchDir: string,\n  filterFunc: (pkgJsonPath: string) => boolean,\n): string | undefined {\n  let path = searchDir;\n\n  // Some confidence check to avoid infinite loop\n  for (let i = 0; i < 1000; i++) {\n    const packagePath = resolvePath(path, 'package.json');\n    const exists = fs.existsSync(packagePath);\n    if (exists && filterFunc(packagePath)) {\n      return path;\n    }\n\n    const newPath = dirname(path);\n    if (newPath === path) {\n      return undefined;\n    }\n    path = newPath;\n  }\n\n  throw new Error(\n    `Iteration limit reached when searching for root package.json at ${searchDir}`,\n  );\n}\n\n// Finds the root of a given package\nexport function findOwnDir(searchDir: string) {\n  const path = findRootPath(searchDir, () => true);\n  if (!path) {\n    throw new Error(\n      `No package.json found while searching for package root of ${searchDir}`,\n    );\n  }\n  return path;\n}\n\n// Finds the root of the monorepo that the package exists in. Only accessible when running inside Backstage repo.\nexport function findOwnRootDir(ownDir: string) {\n  const isLocal = fs.existsSync(resolvePath(ownDir, 'src'));\n  if (!isLocal) {\n    throw new Error(\n      'Tried to access monorepo package root dir outside of Backstage repository',\n    );\n  }\n\n  return resolvePath(ownDir, '../..');\n}\n\n/**\n * Find paths related to a package and its execution context.\n *\n * @public\n * @example\n *\n * const paths = findPaths(__dirname)\n */\nexport function findPaths(searchDir: string): Paths {\n  const ownDir = findOwnDir(searchDir);\n  // Drive letter can end up being lowercased here on Windows, bring back to uppercase for consistency\n  const targetDir = fs\n    .realpathSync(process.cwd())\n    .replace(/^[a-z]:/, str => str.toLocaleUpperCase('en-US'));\n\n  // Lazy load this as it will throw an error if we're not inside the Backstage repo.\n  let ownRoot = '';\n  const getOwnRoot = () => {\n    if (!ownRoot) {\n      ownRoot = findOwnRootDir(ownDir);\n    }\n    return ownRoot;\n  };\n\n  // We're not always running in a monorepo, so we lazy init this to only crash commands\n  // that require a monorepo when we're not in one.\n  let targetRoot = '';\n  const getTargetRoot = () => {\n    if (!targetRoot) {\n      targetRoot =\n        findRootPath(targetDir, path => {\n          try {\n            const content = fs.readFileSync(path, 'utf8');\n            const data = JSON.parse(content);\n            return Boolean(data.workspaces);\n          } catch (error) {\n            throw new Error(\n              `Failed to parse package.json file while searching for root, ${error}`,\n            );\n          }\n        }) ?? targetDir; // We didn't find any root package.json, assume we're not in a monorepo\n    }\n    return targetRoot;\n  };\n\n  return {\n    ownDir,\n    get ownRoot() {\n      return getOwnRoot();\n    },\n    targetDir,\n    get targetRoot() {\n      return getTargetRoot();\n    },\n    resolveOwn: (...paths) => resolvePath(ownDir, ...paths),\n    resolveOwnRoot: (...paths) => resolvePath(getOwnRoot(), ...paths),\n    resolveTarget: (...paths) => resolvePath(targetDir, ...paths),\n    resolveTargetRoot: (...paths) => resolvePath(getTargetRoot(), ...paths),\n  };\n}\n\n/**\n * The name of the backstage's config file\n *\n * @public\n */\nexport const BACKSTAGE_JSON = 'backstage.json';\n"],"names":["path","resolvePath","fs","dirname"],"mappings":"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"}

package/dist/proxyBootstrap.cjs.js

@@ -0,0 +1,16 @@
+'use strict';
+
+function bootstrapEnvProxyAgents() {
+  const globalAgentNamespace = process.env.GLOBAL_AGENT_ENVIRONMENT_VARIABLE_NAMESPACE ?? "GLOBAL_AGENT_";
+  if (process.env[`${globalAgentNamespace}HTTP_PROXY`] || process.env[`${globalAgentNamespace}HTTPS_PROXY`]) {
+    const globalAgent = require("global-agent");
+    globalAgent.bootstrap();
+  }
+  if (process.env.HTTP_PROXY || process.env.HTTPS_PROXY) {
+    const { setGlobalDispatcher, EnvHttpProxyAgent } = require("undici");
+    setGlobalDispatcher(new EnvHttpProxyAgent());
+  }
+}
+
+exports.bootstrapEnvProxyAgents = bootstrapEnvProxyAgents;
+//# sourceMappingURL=proxyBootstrap.cjs.js.map

package/dist/proxyBootstrap.cjs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"proxyBootstrap.cjs.js","sources":["../src/proxyBootstrap.ts"],"sourcesContent":["/*\n * Copyright 2025 The Backstage Authors\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\n/**\n * This function can be called to setup undici and node-fetch Proxy agents.\n *\n * You can set GLOBAL_AGENT_HTTP(S)_PROXY to configure a proxy to be used in the\n * CLIs.\n *\n * You can also configure a custom namespace by setting\n * GLOBAL_AGENT_ENVIRONMENT_VARIABLE_NAMESPACE which will replace the default\n * \"GLOBAL_AGENT_\" env-var prefix.\n *\n * Make sure to call this function before any other imports.\n *\n * @public\n */\nexport function bootstrapEnvProxyAgents() {\n  // see https://www.npmjs.com/package/global-agent\n  const globalAgentNamespace =\n    process.env.GLOBAL_AGENT_ENVIRONMENT_VARIABLE_NAMESPACE ?? 'GLOBAL_AGENT_';\n  if (\n    process.env[`${globalAgentNamespace}HTTP_PROXY`] ||\n    process.env[`${globalAgentNamespace}HTTPS_PROXY`]\n  ) {\n    const globalAgent =\n      require('global-agent') as typeof import('global-agent');\n    globalAgent.bootstrap();\n  }\n\n  if (process.env.HTTP_PROXY || process.env.HTTPS_PROXY) {\n    const { setGlobalDispatcher, EnvHttpProxyAgent } =\n      require('undici') as typeof import('undici');\n    setGlobalDispatcher(new EnvHttpProxyAgent());\n  }\n}\n"],"names":[],"mappings":";;AA8BO,SAAS,uBAAA,GAA0B;AAExC,EAAA,MAAM,oBAAA,GACJ,OAAA,CAAQ,GAAA,CAAI,2CAAA,IAA+C,eAAA;AAC7D,EAAA,IACE,OAAA,CAAQ,GAAA,CAAI,CAAA,EAAG,oBAAoB,CAAA,UAAA,CAAY,CAAA,IAC/C,OAAA,CAAQ,GAAA,CAAI,CAAA,EAAG,oBAAoB,CAAA,WAAA,CAAa,CAAA,EAChD;AACA,IAAA,MAAM,WAAA,GACJ,QAAQ,cAAc,CAAA;AACxB,IAAA,WAAA,CAAY,SAAA,EAAU;AAAA,EACxB;AAEA,EAAA,IAAI,OAAA,CAAQ,GAAA,CAAI,UAAA,IAAc,OAAA,CAAQ,IAAI,WAAA,EAAa;AACrD,IAAA,MAAM,EAAE,mBAAA,EAAqB,iBAAA,EAAkB,GAC7C,QAAQ,QAAQ,CAAA;AAClB,IAAA,mBAAA,CAAoB,IAAI,mBAAmB,CAAA;AAAA,EAC7C;AACF;;;;"}

package/dist/run.cjs.js

@@ -0,0 +1,125 @@
+'use strict';
+
+var spawn = require('cross-spawn');
+var errors = require('./errors.cjs.js');
+var errors$1 = require('@backstage/errors');
+
+function _interopDefaultCompat (e) { return e && typeof e === 'object' && 'default' in e ? e : { default: e }; }
+
+var spawn__default = /*#__PURE__*/_interopDefaultCompat(spawn);
+
+function run(args, options = {}) {
+  if (args.length === 0) {
+    throw new Error("run requires at least one argument");
+  }
+  const [name, ...cmdArgs] = args;
+  const { onStdout, onStderr, stdio: customStdio, ...spawnOptions } = options;
+  const env = {
+    ...process.env,
+    FORCE_COLOR: "true",
+    ...options.env ?? {}
+  };
+  const stdio = customStdio ?? [
+    "inherit",
+    onStdout ? "pipe" : "inherit",
+    onStderr ? "pipe" : "inherit"
+  ];
+  const child = spawn__default.default(name, cmdArgs, {
+    ...spawnOptions,
+    stdio,
+    env
+  });
+  if (onStdout && child.stdout) {
+    child.stdout.on("data", onStdout);
+  }
+  if (onStderr && child.stderr) {
+    child.stderr.on("data", onStderr);
+  }
+  const commandName = args.join(" ");
+  let waitPromise;
+  child.waitForExit = async () => {
+    if (waitPromise) {
+      return waitPromise;
+    }
+    waitPromise = new Promise((resolve, reject) => {
+      if (typeof child.exitCode === "number") {
+        if (child.exitCode) {
+          reject(new errors.ExitCodeError(child.exitCode, commandName));
+        } else {
+          resolve();
+        }
+        return;
+      }
+      function onError(error) {
+        cleanup();
+        reject(error);
+      }
+      function onExit(code) {
+        cleanup();
+        if (code) {
+          reject(new errors.ExitCodeError(code, commandName));
+        } else {
+          resolve();
+        }
+      }
+      function onSignal() {
+        if (!child.killed && child.exitCode === null) {
+          child.kill();
+        }
+      }
+      function cleanup() {
+        for (const signal of ["SIGINT", "SIGTERM"]) {
+          process.removeListener(signal, onSignal);
+        }
+        child.removeListener("error", onError);
+        child.removeListener("exit", onExit);
+      }
+      child.once("error", onError);
+      child.once("exit", onExit);
+      for (const signal of ["SIGINT", "SIGTERM"]) {
+        process.addListener(signal, onSignal);
+      }
+    });
+    return waitPromise;
+  };
+  return child;
+}
+async function runOutput(args, options) {
+  const stdoutChunks = [];
+  const stderrChunks = [];
+  if (args.length === 0) {
+    throw new Error("runOutput requires at least one argument");
+  }
+  try {
+    await run(args, {
+      ...options,
+      onStdout: (data) => {
+        stdoutChunks.push(data);
+        options?.onStdout?.(data);
+      },
+      onStderr: (data) => {
+        stderrChunks.push(data);
+        options?.onStderr?.(data);
+      }
+    }).waitForExit();
+    return Buffer.concat(stdoutChunks).toString().trim();
+  } catch (error) {
+    errors$1.assertError(error);
+    error.stdout = Buffer.concat(stdoutChunks).toString();
+    error.stderr = Buffer.concat(stderrChunks).toString();
+    throw error;
+  }
+}
+async function runCheck(args) {
+  try {
+    await run(args).waitForExit();
+    return true;
+  } catch {
+    return false;
+  }
+}
+
+exports.run = run;
+exports.runCheck = runCheck;
+exports.runOutput = runOutput;
+//# sourceMappingURL=run.cjs.js.map

package/dist/run.cjs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"run.cjs.js","sources":["../src/run.ts"],"sourcesContent":["/*\n * Copyright 2020 The Backstage Authors\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport { ChildProcess, SpawnOptions } from 'child_process';\nimport spawn from 'cross-spawn';\nimport { ExitCodeError } from './errors';\nimport { assertError } from '@backstage/errors';\n\n/**\n * Callback function that can be used to receive stdout or stderr data from a child process.\n *\n * @public\n */\nexport type RunOnOutput = (data: Buffer) => void;\n\n/**\n * Options for running a child process with {@link run} or related functions.\n *\n * @public\n */\nexport type RunOptions = Omit<SpawnOptions, 'env'> & {\n  env?: Partial<NodeJS.ProcessEnv>;\n  onStdout?: RunOnOutput;\n  onStderr?: RunOnOutput;\n  stdio?: SpawnOptions['stdio'];\n};\n\n/**\n * Child process handle returned by {@link run}.\n *\n * @public\n */\nexport interface RunChildProcess extends ChildProcess {\n  /**\n   * Waits for the child process to exit.\n   *\n   * @remarks\n   *\n   * Resolves when the process exits successfully (exit code 0) or is terminated by a signal.\n   * If the process exits with a non-zero exit code, the promise is rejected with an {@link ExitCodeError}.\n   *\n   * @returns A promise that resolves when the process exits successfully or is terminated by a signal, or rejects on error.\n   */\n  waitForExit(): Promise<void>;\n}\n\n/**\n * Runs a command and returns a child process handle.\n *\n * @public\n */\nexport function run(args: string[], options: RunOptions = {}): RunChildProcess {\n  if (args.length === 0) {\n    throw new Error('run requires at least one argument');\n  }\n\n  const [name, ...cmdArgs] = args;\n\n  const { onStdout, onStderr, stdio: customStdio, ...spawnOptions } = options;\n  const env: NodeJS.ProcessEnv = {\n    ...process.env,\n    FORCE_COLOR: 'true',\n    ...(options.env ?? {}),\n  };\n\n  const stdio =\n    customStdio ??\n    ([\n      'inherit',\n      onStdout ? 'pipe' : 'inherit',\n      onStderr ? 'pipe' : 'inherit',\n    ] as ('inherit' | 'pipe')[]);\n\n  const child = spawn(name, cmdArgs, {\n    ...spawnOptions,\n    stdio,\n    env,\n  }) as RunChildProcess;\n\n  if (onStdout && child.stdout) {\n    child.stdout.on('data', onStdout);\n  }\n  if (onStderr && child.stderr) {\n    child.stderr.on('data', onStderr);\n  }\n\n  const commandName = args.join(' ');\n\n  let waitPromise: Promise<void> | undefined;\n\n  child.waitForExit = async (): Promise<void> => {\n    if (waitPromise) {\n      return waitPromise;\n    }\n\n    waitPromise = new Promise<void>((resolve, reject) => {\n      if (typeof child.exitCode === 'number') {\n        if (child.exitCode) {\n          reject(new ExitCodeError(child.exitCode, commandName));\n        } else {\n          resolve();\n        }\n        return;\n      }\n\n      function onError(error: Error) {\n        cleanup();\n        reject(error);\n      }\n\n      function onExit(code: number | null) {\n        cleanup();\n        if (code) {\n          reject(new ExitCodeError(code, commandName));\n        } else {\n          resolve();\n        }\n      }\n\n      function onSignal() {\n        if (!child.killed && child.exitCode === null) {\n          child.kill();\n        }\n      }\n\n      function cleanup() {\n        for (const signal of ['SIGINT', 'SIGTERM'] as const) {\n          process.removeListener(signal, onSignal);\n        }\n        child.removeListener('error', onError);\n        child.removeListener('exit', onExit);\n      }\n\n      child.once('error', onError);\n      child.once('exit', onExit);\n\n      for (const signal of ['SIGINT', 'SIGTERM'] as const) {\n        process.addListener(signal, onSignal);\n      }\n    });\n\n    return waitPromise;\n  };\n\n  return child;\n}\n\n/**\n * Runs a command and returns the stdout.\n *\n * @remarks\n *\n * On error, both stdout and stderr are attached to the error object as properties.\n *\n * @public\n */\nexport async function runOutput(\n  args: string[],\n  options?: RunOptions,\n): Promise<string> {\n  const stdoutChunks: Buffer[] = [];\n  const stderrChunks: Buffer[] = [];\n\n  if (args.length === 0) {\n    throw new Error('runOutput requires at least one argument');\n  }\n\n  try {\n    await run(args, {\n      ...options,\n      onStdout: data => {\n        stdoutChunks.push(data);\n        options?.onStdout?.(data);\n      },\n      onStderr: data => {\n        stderrChunks.push(data);\n        options?.onStderr?.(data);\n      },\n    }).waitForExit();\n\n    return Buffer.concat(stdoutChunks).toString().trim();\n  } catch (error) {\n    assertError(error);\n\n    (error as Error & { stdout?: string }).stdout =\n      Buffer.concat(stdoutChunks).toString();\n    (error as Error & { stderr?: string }).stderr =\n      Buffer.concat(stderrChunks).toString();\n\n    throw error;\n  }\n}\n\n/**\n * Runs a command and returns true if it exits with code 0, false otherwise.\n *\n * @public\n */\nexport async function runCheck(args: string[]): Promise<boolean> {\n  try {\n    await run(args).waitForExit();\n    return true;\n  } catch {\n    return false;\n  }\n}\n"],"names":["spawn","ExitCodeError","assertError"],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@backstage/cli-common",
-  "version": "0.1.15",
+  "version": "0.1.16-next.1",
   "description": "Common functionality used by cli, backend, and create-app",
   "backstage": {
     "role": "node-library"
@@ -34,14 +34,21 @@
     "start": "backstage-cli package start",
     "test": "backstage-cli package test"
   },
+  "dependencies": {
+    "@backstage/errors": "1.2.7",
+    "cross-spawn": "^7.0.3",
+    "global-agent": "^3.0.0",
+    "undici": "^7.2.3"
+  },
   "devDependencies": {
-    "@backstage/cli": "^0.29.0",
+    "@backstage/cli": "0.34.6-next.1",
+    "@types/cross-spawn": "^6.0.2",
     "@types/node": "^20.16.0"
   },
   "typesVersions": {
     "*": {
-      "index": [
-        "dist/index.d.ts"
+      "package.json": [
+        "package.json"
       ]
     }
   }