@vltpkg/run 0.0.0-2 → 0.0.0-21

package/README.md

@@ -2,7 +2,9 @@
 
 # @vltpkg/run
 
-Run a script defined in a `package.json` file (eg, `vlt run` and lifecycle scripts), or an arbitrary command as if it was (eg, `vlt exec`).
+Run a script defined in a `package.json` file (eg, `vlt run` and
+lifecycle scripts), or an arbitrary command as if it was (eg,
+`vlt exec`).
 
 ## Usage
 

package/dist/esm/index.d.ts

@@ -25,6 +25,12 @@ export type SharedOptions = PromiseSpawnOptions & {
      * platform-specific shell will be used.
      */
     'script-shell'?: boolean | string;
+    /**
+     * If true, then `FORCE_COLOR=1` will be set in the environment so that
+     * scripts will typically have colored output enablled, even if the output
+     * is not a tty.
+     */
+    color?: boolean;
 };
 /**
  * Options for run() and runFG()
@@ -41,7 +47,7 @@ export type RunOptions = SharedOptions & {
     /**
      * Pass in a manifest to avoid having to read it at all
      */
-    manifest?: Manifest;
+    manifest?: Pick<Manifest, 'scripts' | 'gypfile'>;
     /**
      * if the script is not defined in package.json#scripts, just ignore it and
      * treat as success. Otherwise, treat as an error. Default false.

package/dist/esm/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAA;AAElD,OAAO,KAAK,EACV,mBAAmB,EACnB,kBAAkB,EAClB,uBAAuB,EACxB,MAAM,uBAAuB,CAAA;AAC9B,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAA;AAiD7C,yCAAyC;AACzC,MAAM,MAAM,aAAa,GAAG,mBAAmB,GAAG;IAChD,kDAAkD;IAClD,IAAI,CAAC,EAAE,MAAM,EAAE,CAAA;IACf,2DAA2D;IAC3D,WAAW,EAAE,MAAM,CAAA;IAEnB,qEAAqE;IACrE,GAAG,EAAE,MAAM,CAAA;IACX;;;;;;;;;OASG;IACH,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAA;IACvB;;;OAGG;IACH,cAAc,CAAC,EAAE,OAAO,GAAG,MAAM,CAAA;CAClC,CAAA;AAED;;GAEG;AACH,MAAM,MAAM,UAAU,GAAG,aAAa,GAAG;IACvC,oDAAoD;IACpD,IAAI,EAAE,MAAM,CAAA;IACZ;;;;OAIG;IACH,WAAW,CAAC,EAAE,WAAW,CAAA;IAEzB;;OAEG;IACH,QAAQ,CAAC,EAAE,QAAQ,CAAA;IAEnB;;;OAGG;IACH,aAAa,CAAC,EAAE,OAAO,CAAA;IAEvB;;;;OAIG;IACH,aAAa,CAAC,EAAE,OAAO,CAAA;CACxB,CAAA;AAED;;GAEG;AACH,MAAM,MAAM,WAAW,GAAG,aAAa,GAAG;IACxC,6BAA6B;IAC7B,IAAI,EAAE,MAAM,CAAA;CACb,CAAA;AAED;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG,aAAa,GAAG;IAC3C;;OAEG;IACH,IAAI,EAAE,MAAM,CAAA;IACZ;;;;OAIG;IACH,WAAW,CAAC,EAAE,WAAW,CAAA;CAC1B,CAAA;AAED;;GAEG;AACH,eAAO,MAAM,GAAG,YAAmB,UAAU,KAAG,OAAO,CAAC,SAAS,CACrC,CAAA;AAE5B;;GAEG;AACH,eAAO,MAAM,KAAK,YACP,UAAU,KAClB,OAAO,CAAC,WAAW,CAAmC,CAAA;AAEzD,iCAAiC;AACjC,MAAM,MAAM,SAAS,GAAG,uBAAuB,GAAG;IAChD,GAAG,CAAC,EAAE,uBAAuB,CAAA;IAC7B,IAAI,CAAC,EAAE,uBAAuB,CAAA;CAC/B,CAAA;AAED,mCAAmC;AACnC,MAAM,MAAM,WAAW,GAAG,kBAAkB,GAAG;IAC7C,GAAG,CAAC,EAAE,kBAAkB,CAAA;IACxB,IAAI,CAAC,EAAE,kBAAkB,CAAA;CAC1B,CAAA;AAED,eAAO,MAAM,WAAW,MAAO,OAAO,KAAG,CAAC,IAAI,SAO/B,CAAA;AAEf;;;;GAIG;AACH,MAAM,MAAM,aAAa,CACvB,CAAC,SAAS,kBAAkB,GAAG,uBAAuB,IACpD,CAAC,GAAG;IAAE,GAAG,CAAC,EAAE,CAAC,CAAC;IAAC,IAAI,CAAC,EAAE,CAAC,CAAA;CAAE,CAAA;AAkH7B;;GAEG;AACH,eAAO,MAAM,IAAI,YACN,WAAW,KACnB,OAAO,CAAC,uBAAuB,CAyBjC,CAAA;AAED;;GAEG;AACH,eAAO,MAAM,MAAM,YACR,WAAW,KACnB,OAAO,CAAC,kBAAkB,CAsC5B,CAAA;AAoBD;;GAEG;AACH,eAAO,MAAM,OAAO,YACT,cAAc,KACtB,OAAO,CAAC,SAAS,GAAG,uBAAuB,CACY,CAAA;AAE1D;;;GAGG;AACH,eAAO,MAAM,SAAS,YACX,cAAc,KACtB,OAAO,CAAC,WAAW,GAAG,kBAAkB,CACc,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAA;AAClD,OAAO,KAAK,EACV,mBAAmB,EACnB,kBAAkB,EAClB,uBAAuB,EACxB,MAAM,uBAAuB,CAAA;AAE9B,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAA;AA2D7C,yCAAyC;AACzC,MAAM,MAAM,aAAa,GAAG,mBAAmB,GAAG;IAChD,kDAAkD;IAClD,IAAI,CAAC,EAAE,MAAM,EAAE,CAAA;IACf,2DAA2D;IAC3D,WAAW,EAAE,MAAM,CAAA;IAEnB,qEAAqE;IACrE,GAAG,EAAE,MAAM,CAAA;IACX;;;;;;;;;OASG;IACH,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAA;IACvB;;;OAGG;IACH,cAAc,CAAC,EAAE,OAAO,GAAG,MAAM,CAAA;IAEjC;;;;OAIG;IACH,KAAK,CAAC,EAAE,OAAO,CAAA;CAChB,CAAA;AAED;;GAEG;AACH,MAAM,MAAM,UAAU,GAAG,aAAa,GAAG;IACvC,oDAAoD;IACpD,IAAI,EAAE,MAAM,CAAA;IACZ;;;;OAIG;IACH,WAAW,CAAC,EAAE,WAAW,CAAA;IAEzB;;OAEG;IACH,QAAQ,CAAC,EAAE,IAAI,CAAC,QAAQ,EAAE,SAAS,GAAG,SAAS,CAAC,CAAA;IAEhD;;;OAGG;IACH,aAAa,CAAC,EAAE,OAAO,CAAA;IAEvB;;;;OAIG;IACH,aAAa,CAAC,EAAE,OAAO,CAAA;CACxB,CAAA;AAED;;GAEG;AACH,MAAM,MAAM,WAAW,GAAG,aAAa,GAAG;IACxC,6BAA6B;IAC7B,IAAI,EAAE,MAAM,CAAA;CACb,CAAA;AAED;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG,aAAa,GAAG;IAC3C;;OAEG;IACH,IAAI,EAAE,MAAM,CAAA;IACZ;;;;OAIG;IACH,WAAW,CAAC,EAAE,WAAW,CAAA;CAC1B,CAAA;AAED;;GAEG;AACH,eAAO,MAAM,GAAG,YAAmB,UAAU,KAAG,OAAO,CAAC,SAAS,CACrC,CAAA;AAE5B;;GAEG;AACH,eAAO,MAAM,KAAK,YACP,UAAU,KAClB,OAAO,CAAC,WAAW,CAAmC,CAAA;AAEzD,iCAAiC;AACjC,MAAM,MAAM,SAAS,GAAG,uBAAuB,GAAG;IAChD,GAAG,CAAC,EAAE,uBAAuB,CAAA;IAC7B,IAAI,CAAC,EAAE,uBAAuB,CAAA;CAC/B,CAAA;AAED,mCAAmC;AACnC,MAAM,MAAM,WAAW,GAAG,kBAAkB,GAAG;IAC7C,GAAG,CAAC,EAAE,kBAAkB,CAAA;IACxB,IAAI,CAAC,EAAE,kBAAkB,CAAA;CAC1B,CAAA;AAED,eAAO,MAAM,WAAW,MAAO,OAAO,KAAG,CAAC,IAAI,SAO/B,CAAA;AAEf;;;;GAIG;AACH,MAAM,MAAM,aAAa,CACvB,CAAC,SAAS,kBAAkB,GAAG,uBAAuB,IACpD,CAAC,GAAG;IAAE,GAAG,CAAC,EAAE,CAAC,CAAC;IAAC,IAAI,CAAC,EAAE,CAAC,CAAA;CAAE,CAAA;AAsH7B;;GAEG;AACH,eAAO,MAAM,IAAI,YACN,WAAW,KACnB,OAAO,CAAC,uBAAuB,CA2BjC,CAAA;AAED;;GAEG;AACH,eAAO,MAAM,MAAM,YACR,WAAW,KACnB,OAAO,CAAC,kBAAkB,CAwC5B,CAAA;AAoBD;;GAEG;AACH,eAAO,MAAM,OAAO,YACT,cAAc,KACtB,OAAO,CAAC,SAAS,GAAG,uBAAuB,CACY,CAAA;AAE1D;;;GAGG;AACH,eAAO,MAAM,SAAS,YACX,cAAc,KACtB,OAAO,CAAC,WAAW,GAAG,kBAAkB,CACc,CAAA"}

package/dist/esm/index.js

@@ -4,7 +4,7 @@ import { promiseSpawn } from '@vltpkg/promise-spawn';
 import { foregroundChild } from 'foreground-child';
 import { proxySignals } from 'foreground-child/proxy-signals';
 import { statSync } from 'node:fs';
-import { delimiter, resolve } from 'node:path';
+import { delimiter, resolve, sep } from 'node:path';
 import { walkUp } from 'walk-up-path';
 /** map of which node_modules/.bin folders exist */
 const dotBins = new Map();
@@ -23,6 +23,7 @@ const dirExists = (p) => {
         return false;
     }
 };
+const nmBin = `${sep}node_modules${sep}.bin`;
 /**
  * Add all exsting `node_modules/.bin` folders to the PATH that
  * exist between the cwd and the projectRoot, so dependency bins
@@ -30,7 +31,15 @@ const dirExists = (p) => {
  */
 const addPaths = (projectRoot, cwd, env) => {
     const { PATH = '' } = env;
+    const PATHsplit = PATH.split(delimiter);
     const paths = new Set();
+    // anything in the PATH that already has node_modules/.bin is a thing
+    // we put there, perhaps for the vlx exec cache usage
+    for (const p of PATHsplit) {
+        if (p.endsWith(nmBin)) {
+            paths.add(p);
+        }
+    }
     for (const p of walkUp(cwd)) {
         const dotBin = resolve(p, 'node_modules/.bin');
         if (dirExists(dotBin))
@@ -65,7 +74,7 @@ export const isRunResult = (v) => !!v &&
  * Internal implementation of run() and runFG(), since they're mostly identical
  */
 const runImpl = async (options, execImpl, empty) => {
-    const { arg0, packageJson = new PackageJson(), ignoreMissing = false, manifest, ...execArgs } = options;
+    const { arg0, packageJson = new PackageJson(), ignoreMissing = false, manifest, 'script-shell': shell = true, ...execArgs } = options;
     const pjPath = resolve(options.cwd, 'package.json');
     // npm adds a `"install": "node-gyp rebuild"` if a binding.gyp
     // is present at the time of publish, EVEN IF it's not included
@@ -106,6 +115,7 @@ const runImpl = async (options, execImpl, empty) => {
         await execImpl({
             arg0: precommand,
             ...execArgs,
+            'script-shell': shell,
             args: [],
             env: {
                 ...execArgs.env,
@@ -121,6 +131,7 @@ const runImpl = async (options, execImpl, empty) => {
     const result = await execImpl({
         arg0: command,
         ...execArgs,
+        'script-shell': shell,
         env: {
             ...execArgs.env,
             npm_package_json: pjPath,
@@ -138,6 +149,7 @@ const runImpl = async (options, execImpl, empty) => {
     const post = await execImpl({
         arg0: postcommand,
         ...execArgs,
+        'script-shell': shell,
         args: [],
         env: {
             ...execArgs.env,
@@ -157,7 +169,7 @@ const runImpl = async (options, execImpl, empty) => {
  * Execute an arbitrary command in the background
  */
 export const exec = async (options) => {
-    const { arg0, args = [], cwd, env = {}, projectRoot, 'script-shell': shell = true, ...spawnOptions } = options;
+    const { arg0, args = [], cwd, env = {}, projectRoot, 'script-shell': shell = false, color = false, ...spawnOptions } = options;
     const p = promiseSpawn(arg0, args, {
         ...spawnOptions,
         shell,
@@ -167,6 +179,7 @@ export const exec = async (options) => {
         env: addPaths(projectRoot, cwd, {
             ...process.env,
             ...env,
+            FORCE_COLOR: color ? '1' : '0',
         }),
         windowsHide: true,
     });
@@ -177,7 +190,7 @@ export const exec = async (options) => {
  * Execute an arbitrary command in the foreground
  */
 export const execFG = async (options) => {
-    const { arg0, args = [], cwd, projectRoot, env = {}, 'script-shell': shell = true, ...spawnOptions } = options;
+    const { arg0, args = [], cwd, projectRoot, env = {}, 'script-shell': shell = false, color = true, ...spawnOptions } = options;
     return new Promise(res => {
         foregroundChild(arg0, args, {
             ...spawnOptions,
@@ -186,6 +199,7 @@ export const execFG = async (options) => {
             env: addPaths(projectRoot, cwd, {
                 ...process.env,
                 ...env,
+                FORCE_COLOR: color ? '1' : '0',
             }),
         }, (status, signal) => {
             res({

package/dist/esm/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"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","sourcesContent":["import { error } from '@vltpkg/error-cause'\nimport { PackageJson } from '@vltpkg/package-json'\nimport { promiseSpawn } from '@vltpkg/promise-spawn'\nimport type {\n  PromiseSpawnOptions,\n  SpawnResultNoStdio,\n  SpawnResultStdioStrings,\n} from '@vltpkg/promise-spawn'\nimport type { Manifest } from '@vltpkg/types'\nimport { foregroundChild } from 'foreground-child'\nimport { proxySignals } from 'foreground-child/proxy-signals'\nimport { statSync } from 'node:fs'\nimport { delimiter, resolve } from 'node:path'\nimport { walkUp } from 'walk-up-path'\n\n/** map of which node_modules/.bin folders exist */\nconst dotBins = new Map<string, boolean>()\n\n/** Check if a directory exists, and cache result */\nconst dirExists = (p: string) => {\n  const cached = dotBins.get(p)\n  if (cached !== undefined) return cached\n  try {\n    const isDir = statSync(p).isDirectory()\n    dotBins.set(p, isDir)\n    return isDir\n  } catch {\n    dotBins.set(p, false)\n    return false\n  }\n}\n\n/**\n * Add all exsting `node_modules/.bin` folders to the PATH that\n * exist between the cwd and the projectRoot, so dependency bins\n * are found, with closer paths higher priority.\n */\nconst addPaths = (\n  projectRoot: string,\n  cwd: string,\n  env: NodeJS.ProcessEnv,\n): NodeJS.ProcessEnv => {\n  const { PATH = '' } = env\n  const paths = new Set<string>()\n  for (const p of walkUp(cwd)) {\n    const dotBin = resolve(p, 'node_modules/.bin')\n    if (dirExists(dotBin)) paths.add(dotBin)\n    if (p === projectRoot) break\n  }\n  for (const p of PATH.split(delimiter)) {\n    /* c8 ignore next - pretty rare to have an empty entry */\n    if (p) paths.add(p)\n  }\n  env.PATH = [...paths].join(delimiter)\n  return env\n}\n\n/** options shared by run() and exec() */\nexport type SharedOptions = PromiseSpawnOptions & {\n  /** additional arguments to pass to the command */\n  args?: string[]\n  /** the root of the project, which we don't walk up past */\n  projectRoot: string\n\n  /** the directory where the package.json lives and the script runs */\n  cwd: string\n  /**\n   * environment variables to set. `process.env` is always included,\n   * to omit fields, set them explicitly to undefined.\n   *\n   * vlt will add some of its own, as well:\n   * - npm_lifecycle_event: the event name\n   * - npm_lifecycle_script: the command in package.json#scripts\n   * - npm_package_json: path to the package.json file\n   * - VLT_* envs for all vlt configuration values that are set\n   */\n  env?: NodeJS.ProcessEnv\n  /**\n   * the shell to run the script in. If not set, then the default\n   * platform-specific shell will be used.\n   */\n  'script-shell'?: boolean | string\n}\n\n/**\n * Options for run() and runFG()\n */\nexport type RunOptions = SharedOptions & {\n  /** the name of the thing in package.json#scripts */\n  arg0: string\n  /**\n   * pass in a @vltpkg/package-json.PackageJson instance, and\n   * it'll be used for reading the package.json file. Optional,\n   * may improve performance somewhat.\n   */\n  packageJson?: PackageJson\n\n  /**\n   * Pass in a manifest to avoid having to read it at all\n   */\n  manifest?: Manifest\n\n  /**\n   * if the script is not defined in package.json#scripts, just ignore it and\n   * treat as success. Otherwise, treat as an error. Default false.\n   */\n  ignoreMissing?: boolean\n\n  /**\n   * skip the pre/post commands, just run the one specified.\n   * This can be used to run JUST the specified script, without any\n   * pre/post commands.\n   */\n  ignorePrePost?: boolean\n}\n\n/**\n * Options for exec() and execFG()\n */\nexport type ExecOptions = SharedOptions & {\n  /** the command to execute */\n  arg0: string\n}\n\n/**\n * Options for runExec() and runExecFG()\n */\nexport type RunExecOptions = SharedOptions & {\n  /**\n   * Either the command to be executed, or the event to be run\n   */\n  arg0: string\n  /**\n   * pass in a @vltpkg/package-json.PackageJson instance, and\n   * it'll be used for reading the package.json file. Optional,\n   * may improve performance somewhat.\n   */\n  packageJson?: PackageJson\n}\n\n/**\n * Run a package.json#scripts event in the background\n */\nexport const run = async (options: RunOptions): Promise<RunResult> =>\n  runImpl(options, exec, '')\n\n/**\n * Run a package.json#scripts event in the foreground\n */\nexport const runFG = async (\n  options: RunOptions,\n): Promise<RunFGResult> => runImpl(options, execFG, null)\n\n/** Return type of {@link run} */\nexport type RunResult = SpawnResultStdioStrings & {\n  pre?: SpawnResultStdioStrings\n  post?: SpawnResultStdioStrings\n}\n\n/** Return type of {@link runFG} */\nexport type RunFGResult = SpawnResultNoStdio & {\n  pre?: SpawnResultNoStdio\n  post?: SpawnResultNoStdio\n}\n\nexport const isRunResult = (v: unknown): v is RunResult =>\n  !!v &&\n  typeof v === 'object' &&\n  !Array.isArray(v) &&\n  'stdout' in v &&\n  'stderr' in v &&\n  'status' in v &&\n  'signal' in v\n\n/**\n * Return type of {@link run} or {@link runFG}, as determined by their base\n * type\n * @internal\n */\nexport type RunImplResult<\n  R extends SpawnResultNoStdio | SpawnResultStdioStrings,\n> = R & { pre?: R; post?: R }\n\n/**\n * Internal implementation of run() and runFG(), since they're mostly identical\n */\nconst runImpl = async <\n  R extends SpawnResultNoStdio | SpawnResultStdioStrings,\n>(\n  options: RunOptions,\n  execImpl: (options: ExecOptions) => Promise<R>,\n  empty: R['stdout'],\n): Promise<RunImplResult<R>> => {\n  const {\n    arg0,\n    packageJson = new PackageJson(),\n    ignoreMissing = false,\n    manifest,\n    ...execArgs\n  } = options\n  const pjPath = resolve(options.cwd, 'package.json')\n  // npm adds a `\"install\": \"node-gyp rebuild\"` if a binding.gyp\n  // is present at the time of publish, EVEN IF it's not included\n  // in the package. So, we need to read the actual package.json\n  // in those cases.\n  const untrustworthy = !!(\n    manifest?.gypfile &&\n    arg0 === 'install' &&\n    manifest.scripts?.install === 'node-gyp rebuild'\n  )\n  const pj =\n    (untrustworthy ? undefined : manifest) ??\n    packageJson.read(options.cwd)\n  const { scripts } = pj\n  const command = scripts?.[arg0]\n  if (!command) {\n    if (ignoreMissing) {\n      return {\n        command: '',\n        /* c8 ignore next */\n        args: execArgs.args ?? [],\n        cwd: options.cwd,\n        status: 0,\n        signal: null,\n        stdout: empty,\n        stderr: empty,\n        // `as` to workaround \"could be instantiated with arbitrary type\".\n        // it's private and used in 2 places, we know that it isn't.\n      } as R\n    }\n    throw error('Script not defined in package.json', {\n      name: arg0,\n      cwd: options.cwd,\n      args: options.args,\n      path: pjPath,\n      manifest: pj,\n    })\n  }\n\n  const precommand = !options.ignorePrePost && scripts[`pre${arg0}`]\n  const pre =\n    precommand ?\n      await execImpl({\n        arg0: precommand,\n        ...execArgs,\n        args: [],\n        env: {\n          ...execArgs.env,\n          npm_package_json: pjPath,\n          npm_lifecycle_event: `pre${arg0}`,\n          npm_lifecycle_script: precommand,\n        },\n      })\n    : undefined\n  if (pre && (pre.status || pre.signal)) {\n    return pre as RunImplResult<R>\n  }\n  const result: RunImplResult<R> = await execImpl({\n    arg0: command,\n    ...execArgs,\n    env: {\n      ...execArgs.env,\n      npm_package_json: pjPath,\n      npm_lifecycle_event: arg0,\n      npm_lifecycle_script: command,\n    },\n  })\n  result.pre = pre\n  if (result.signal || result.status) {\n    return result\n  }\n\n  const postcommand = !options.ignorePrePost && scripts[`post${arg0}`]\n  if (!postcommand) return result\n\n  const post = await execImpl({\n    arg0: postcommand,\n    ...execArgs,\n    args: [],\n    env: {\n      ...execArgs.env,\n      npm_package_json: pjPath,\n      npm_lifecycle_event: `post${arg0}`,\n      npm_lifecycle_script: postcommand,\n    },\n  })\n\n  if (post.status || post.signal) {\n    const { status, signal } = post\n    return Object.assign(result, { post, status, signal })\n  }\n  result.post = post\n  return result\n}\n\n/**\n * Execute an arbitrary command in the background\n */\nexport const exec = async (\n  options: ExecOptions,\n): Promise<SpawnResultStdioStrings> => {\n  const {\n    arg0,\n    args = [],\n    cwd,\n    env = {},\n    projectRoot,\n    'script-shell': shell = true,\n    ...spawnOptions\n  } = options\n\n  const p = promiseSpawn(arg0, args, {\n    ...spawnOptions,\n    shell,\n    stdio: 'pipe',\n    stdioString: true,\n    cwd,\n    env: addPaths(projectRoot, cwd, {\n      ...process.env,\n      ...env,\n    }),\n    windowsHide: true,\n  })\n  proxySignals(p.process)\n  return await p\n}\n\n/**\n * Execute an arbitrary command in the foreground\n */\nexport const execFG = async (\n  options: ExecOptions,\n): Promise<SpawnResultNoStdio> => {\n  const {\n    arg0,\n    args = [],\n    cwd,\n    projectRoot,\n    env = {},\n    'script-shell': shell = true,\n    ...spawnOptions\n  } = options\n\n  return new Promise<SpawnResultNoStdio>(res => {\n    foregroundChild(\n      arg0,\n      args,\n      {\n        ...spawnOptions,\n        shell,\n        cwd,\n        env: addPaths(projectRoot, cwd, {\n          ...process.env,\n          ...env,\n        }),\n      },\n      (status, signal) => {\n        res({\n          command: arg0,\n          args,\n          cwd,\n          stdout: null,\n          stderr: null,\n          status,\n          signal,\n        })\n        return false\n      },\n    )\n  })\n}\n\nconst runExecImpl = async <\n  R extends SpawnResultNoStdio | SpawnResultStdioStrings,\n>(\n  options: RunExecOptions,\n  runImpl: (options: RunOptions) => Promise<RunImplResult<R>>,\n  execImpl: (options: ExecOptions) => Promise<R>,\n): Promise<R | RunImplResult<R>> => {\n  const { arg0, packageJson = new PackageJson(), ...args } = options\n  const pj = packageJson.read(options.cwd)\n  const { scripts } = pj\n  const command = scripts?.[arg0]\n  if (command) {\n    return runImpl({ ...args, packageJson, arg0 })\n  } else {\n    return execImpl({ ...args, arg0 })\n  }\n}\n\n/**\n * If the arg0 is a defined package.json script, then run(), otherwise exec()\n */\nexport const runExec = async (\n  options: RunExecOptions,\n): Promise<RunResult | SpawnResultStdioStrings> =>\n  runExecImpl<SpawnResultStdioStrings>(options, run, exec)\n\n/**\n * If the arg0 is a defined package.json script, then runFG(), otherwise\n * execFG()\n */\nexport const runExecFG = async (\n  options: RunExecOptions,\n): Promise<RunFGResult | SpawnResultNoStdio> =>\n  runExecImpl<SpawnResultNoStdio>(options, runFG, execFG)\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"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","sourcesContent":["import { error } from '@vltpkg/error-cause'\nimport { PackageJson } from '@vltpkg/package-json'\nimport type {\n  PromiseSpawnOptions,\n  SpawnResultNoStdio,\n  SpawnResultStdioStrings,\n} from '@vltpkg/promise-spawn'\nimport { promiseSpawn } from '@vltpkg/promise-spawn'\nimport type { Manifest } from '@vltpkg/types'\nimport { foregroundChild } from 'foreground-child'\nimport { proxySignals } from 'foreground-child/proxy-signals'\nimport { statSync } from 'node:fs'\nimport { delimiter, resolve, sep } from 'node:path'\nimport { walkUp } from 'walk-up-path'\n\n/** map of which node_modules/.bin folders exist */\nconst dotBins = new Map<string, boolean>()\n\n/** Check if a directory exists, and cache result */\nconst dirExists = (p: string) => {\n  const cached = dotBins.get(p)\n  if (cached !== undefined) return cached\n  try {\n    const isDir = statSync(p).isDirectory()\n    dotBins.set(p, isDir)\n    return isDir\n  } catch {\n    dotBins.set(p, false)\n    return false\n  }\n}\n\nconst nmBin = `${sep}node_modules${sep}.bin`\n\n/**\n * Add all exsting `node_modules/.bin` folders to the PATH that\n * exist between the cwd and the projectRoot, so dependency bins\n * are found, with closer paths higher priority.\n */\nconst addPaths = (\n  projectRoot: string,\n  cwd: string,\n  env: NodeJS.ProcessEnv,\n): NodeJS.ProcessEnv => {\n  const { PATH = '' } = env\n  const PATHsplit = PATH.split(delimiter)\n  const paths = new Set<string>()\n  // anything in the PATH that already has node_modules/.bin is a thing\n  // we put there, perhaps for the vlx exec cache usage\n  for (const p of PATHsplit) {\n    if (p.endsWith(nmBin)) {\n      paths.add(p)\n    }\n  }\n  for (const p of walkUp(cwd)) {\n    const dotBin = resolve(p, 'node_modules/.bin')\n    if (dirExists(dotBin)) paths.add(dotBin)\n    if (p === projectRoot) break\n  }\n  for (const p of PATH.split(delimiter)) {\n    /* c8 ignore next - pretty rare to have an empty entry */\n    if (p) paths.add(p)\n  }\n  env.PATH = [...paths].join(delimiter)\n  return env\n}\n\n/** options shared by run() and exec() */\nexport type SharedOptions = PromiseSpawnOptions & {\n  /** additional arguments to pass to the command */\n  args?: string[]\n  /** the root of the project, which we don't walk up past */\n  projectRoot: string\n\n  /** the directory where the package.json lives and the script runs */\n  cwd: string\n  /**\n   * environment variables to set. `process.env` is always included,\n   * to omit fields, set them explicitly to undefined.\n   *\n   * vlt will add some of its own, as well:\n   * - npm_lifecycle_event: the event name\n   * - npm_lifecycle_script: the command in package.json#scripts\n   * - npm_package_json: path to the package.json file\n   * - VLT_* envs for all vlt configuration values that are set\n   */\n  env?: NodeJS.ProcessEnv\n  /**\n   * the shell to run the script in. If not set, then the default\n   * platform-specific shell will be used.\n   */\n  'script-shell'?: boolean | string\n\n  /**\n   * If true, then `FORCE_COLOR=1` will be set in the environment so that\n   * scripts will typically have colored output enablled, even if the output\n   * is not a tty.\n   */\n  color?: boolean\n}\n\n/**\n * Options for run() and runFG()\n */\nexport type RunOptions = SharedOptions & {\n  /** the name of the thing in package.json#scripts */\n  arg0: string\n  /**\n   * pass in a @vltpkg/package-json.PackageJson instance, and\n   * it'll be used for reading the package.json file. Optional,\n   * may improve performance somewhat.\n   */\n  packageJson?: PackageJson\n\n  /**\n   * Pass in a manifest to avoid having to read it at all\n   */\n  manifest?: Pick<Manifest, 'scripts' | 'gypfile'>\n\n  /**\n   * if the script is not defined in package.json#scripts, just ignore it and\n   * treat as success. Otherwise, treat as an error. Default false.\n   */\n  ignoreMissing?: boolean\n\n  /**\n   * skip the pre/post commands, just run the one specified.\n   * This can be used to run JUST the specified script, without any\n   * pre/post commands.\n   */\n  ignorePrePost?: boolean\n}\n\n/**\n * Options for exec() and execFG()\n */\nexport type ExecOptions = SharedOptions & {\n  /** the command to execute */\n  arg0: string\n}\n\n/**\n * Options for runExec() and runExecFG()\n */\nexport type RunExecOptions = SharedOptions & {\n  /**\n   * Either the command to be executed, or the event to be run\n   */\n  arg0: string\n  /**\n   * pass in a @vltpkg/package-json.PackageJson instance, and\n   * it'll be used for reading the package.json file. Optional,\n   * may improve performance somewhat.\n   */\n  packageJson?: PackageJson\n}\n\n/**\n * Run a package.json#scripts event in the background\n */\nexport const run = async (options: RunOptions): Promise<RunResult> =>\n  runImpl(options, exec, '')\n\n/**\n * Run a package.json#scripts event in the foreground\n */\nexport const runFG = async (\n  options: RunOptions,\n): Promise<RunFGResult> => runImpl(options, execFG, null)\n\n/** Return type of {@link run} */\nexport type RunResult = SpawnResultStdioStrings & {\n  pre?: SpawnResultStdioStrings\n  post?: SpawnResultStdioStrings\n}\n\n/** Return type of {@link runFG} */\nexport type RunFGResult = SpawnResultNoStdio & {\n  pre?: SpawnResultNoStdio\n  post?: SpawnResultNoStdio\n}\n\nexport const isRunResult = (v: unknown): v is RunResult =>\n  !!v &&\n  typeof v === 'object' &&\n  !Array.isArray(v) &&\n  'stdout' in v &&\n  'stderr' in v &&\n  'status' in v &&\n  'signal' in v\n\n/**\n * Return type of {@link run} or {@link runFG}, as determined by their base\n * type\n * @internal\n */\nexport type RunImplResult<\n  R extends SpawnResultNoStdio | SpawnResultStdioStrings,\n> = R & { pre?: R; post?: R }\n\n/**\n * Internal implementation of run() and runFG(), since they're mostly identical\n */\nconst runImpl = async <\n  R extends SpawnResultNoStdio | SpawnResultStdioStrings,\n>(\n  options: RunOptions,\n  execImpl: (options: ExecOptions) => Promise<R>,\n  empty: R['stdout'],\n): Promise<RunImplResult<R>> => {\n  const {\n    arg0,\n    packageJson = new PackageJson(),\n    ignoreMissing = false,\n    manifest,\n    'script-shell': shell = true,\n    ...execArgs\n  } = options\n  const pjPath = resolve(options.cwd, 'package.json')\n  // npm adds a `\"install\": \"node-gyp rebuild\"` if a binding.gyp\n  // is present at the time of publish, EVEN IF it's not included\n  // in the package. So, we need to read the actual package.json\n  // in those cases.\n  const untrustworthy = !!(\n    manifest?.gypfile &&\n    arg0 === 'install' &&\n    manifest.scripts?.install === 'node-gyp rebuild'\n  )\n  const pj =\n    (untrustworthy ? undefined : manifest) ??\n    packageJson.read(options.cwd)\n  const { scripts } = pj\n  const command = scripts?.[arg0]\n  if (!command) {\n    if (ignoreMissing) {\n      return {\n        command: '',\n        /* c8 ignore next */\n        args: execArgs.args ?? [],\n        cwd: options.cwd,\n        status: 0,\n        signal: null,\n        stdout: empty,\n        stderr: empty,\n        // `as` to workaround \"could be instantiated with arbitrary type\".\n        // it's private and used in 2 places, we know that it isn't.\n      } as R\n    }\n    throw error('Script not defined in package.json', {\n      name: arg0,\n      cwd: options.cwd,\n      args: options.args,\n      path: pjPath,\n      manifest: pj,\n    })\n  }\n\n  const precommand = !options.ignorePrePost && scripts[`pre${arg0}`]\n  const pre =\n    precommand ?\n      await execImpl({\n        arg0: precommand,\n        ...execArgs,\n        'script-shell': shell,\n        args: [],\n        env: {\n          ...execArgs.env,\n          npm_package_json: pjPath,\n          npm_lifecycle_event: `pre${arg0}`,\n          npm_lifecycle_script: precommand,\n        },\n      })\n    : undefined\n  if (pre && (pre.status || pre.signal)) {\n    return pre as RunImplResult<R>\n  }\n  const result: RunImplResult<R> = await execImpl({\n    arg0: command,\n    ...execArgs,\n    'script-shell': shell,\n    env: {\n      ...execArgs.env,\n      npm_package_json: pjPath,\n      npm_lifecycle_event: arg0,\n      npm_lifecycle_script: command,\n    },\n  })\n  result.pre = pre\n  if (result.signal || result.status) {\n    return result\n  }\n\n  const postcommand = !options.ignorePrePost && scripts[`post${arg0}`]\n  if (!postcommand) return result\n\n  const post = await execImpl({\n    arg0: postcommand,\n    ...execArgs,\n    'script-shell': shell,\n    args: [],\n    env: {\n      ...execArgs.env,\n      npm_package_json: pjPath,\n      npm_lifecycle_event: `post${arg0}`,\n      npm_lifecycle_script: postcommand,\n    },\n  })\n\n  if (post.status || post.signal) {\n    const { status, signal } = post\n    return Object.assign(result, { post, status, signal })\n  }\n  result.post = post\n  return result\n}\n\n/**\n * Execute an arbitrary command in the background\n */\nexport const exec = async (\n  options: ExecOptions,\n): Promise<SpawnResultStdioStrings> => {\n  const {\n    arg0,\n    args = [],\n    cwd,\n    env = {},\n    projectRoot,\n    'script-shell': shell = false,\n    color = false,\n    ...spawnOptions\n  } = options\n\n  const p = promiseSpawn(arg0, args, {\n    ...spawnOptions,\n    shell,\n    stdio: 'pipe',\n    stdioString: true,\n    cwd,\n    env: addPaths(projectRoot, cwd, {\n      ...process.env,\n      ...env,\n      FORCE_COLOR: color ? '1' : '0',\n    }),\n    windowsHide: true,\n  })\n  proxySignals(p.process)\n  return await p\n}\n\n/**\n * Execute an arbitrary command in the foreground\n */\nexport const execFG = async (\n  options: ExecOptions,\n): Promise<SpawnResultNoStdio> => {\n  const {\n    arg0,\n    args = [],\n    cwd,\n    projectRoot,\n    env = {},\n    'script-shell': shell = false,\n    color = true,\n    ...spawnOptions\n  } = options\n\n  return new Promise<SpawnResultNoStdio>(res => {\n    foregroundChild(\n      arg0,\n      args,\n      {\n        ...spawnOptions,\n        shell,\n        cwd,\n        env: addPaths(projectRoot, cwd, {\n          ...process.env,\n          ...env,\n          FORCE_COLOR: color ? '1' : '0',\n        }),\n      },\n      (status, signal) => {\n        res({\n          command: arg0,\n          args,\n          cwd,\n          stdout: null,\n          stderr: null,\n          status,\n          signal,\n        })\n        return false\n      },\n    )\n  })\n}\n\nconst runExecImpl = async <\n  R extends SpawnResultNoStdio | SpawnResultStdioStrings,\n>(\n  options: RunExecOptions,\n  runImpl: (options: RunOptions) => Promise<RunImplResult<R>>,\n  execImpl: (options: ExecOptions) => Promise<R>,\n): Promise<R | RunImplResult<R>> => {\n  const { arg0, packageJson = new PackageJson(), ...args } = options\n  const pj = packageJson.read(options.cwd)\n  const { scripts } = pj\n  const command = scripts?.[arg0]\n  if (command) {\n    return runImpl({ ...args, packageJson, arg0 })\n  } else {\n    return execImpl({ ...args, arg0 })\n  }\n}\n\n/**\n * If the arg0 is a defined package.json script, then run(), otherwise exec()\n */\nexport const runExec = async (\n  options: RunExecOptions,\n): Promise<RunResult | SpawnResultStdioStrings> =>\n  runExecImpl<SpawnResultStdioStrings>(options, run, exec)\n\n/**\n * If the arg0 is a defined package.json script, then runFG(), otherwise\n * execFG()\n */\nexport const runExecFG = async (\n  options: RunExecOptions,\n): Promise<RunFGResult | SpawnResultNoStdio> =>\n  runExecImpl<SpawnResultNoStdio>(options, runFG, execFG)\n"]}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@vltpkg/run",
   "description": "Run package.json scripts and execute commands",
-  "version": "0.0.0-2",
+  "version": "0.0.0-21",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/vltpkg/vltpkg.git",
@@ -19,24 +19,23 @@
     }
   },
   "dependencies": {
-    "foreground-child": "^3.2.0",
+    "foreground-child": "^3.3.1",
     "walk-up-path": "^4.0.0",
-    "@vltpkg/error-cause": "0.0.0-2",
-    "@vltpkg/package-json": "0.0.0-2",
-    "@vltpkg/promise-spawn": "0.0.0-2",
-    "@vltpkg/types": "0.0.0-2"
+    "@vltpkg/error-cause": "0.0.0-21",
+    "@vltpkg/package-json": "0.0.0-21",
+    "@vltpkg/promise-spawn": "0.0.0-21",
+    "@vltpkg/types": "0.0.0-21"
   },
   "devDependencies": {
-    "@eslint/js": "^9.20.0",
-    "@types/eslint__js": "^8.42.3",
-    "@types/node": "^22.13.1",
-    "eslint": "^9.20.0",
-    "prettier": "^3.4.2",
+    "@eslint/js": "^9.28.0",
+    "@types/node": "^22.15.29",
+    "eslint": "^9.28.0",
+    "prettier": "^3.6.0",
     "tap": "^21.1.0",
     "tshy": "^3.0.2",
-    "typedoc": "0.27.6",
+    "typedoc": "~0.27.9",
     "typescript": "5.7.3",
-    "typescript-eslint": "^8.23.0"
+    "typescript-eslint": "^8.33.1"
   },
   "license": "BSD-2-Clause-Patent",
   "engines": {
@@ -68,6 +67,7 @@
     "snap": "tap",
     "test": "tap",
     "posttest": "tsc --noEmit",
+    "tshy": "tshy",
     "typecheck": "tsc --noEmit"
   }
 }