@vltpkg/run 0.0.0-0.1730239248325

package/LICENSE

@@ -0,0 +1,15 @@
+Copyright (c) vlt technology, Inc.
+
+Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met:
+
+1. Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer.
+2. Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution.
+   Subject to the terms and conditions of this license, each copyright holder and contributor hereby grants to those receiving rights under this license a perpetual, worldwide, non-exclusive, no-charge, royalty-free, irrevocable (except for failure to satisfy the conditions of this license) patent license to make, have made, use, offer to sell, sell, import, and otherwise transfer this software, where such license applies only to those patent claims, already acquired or hereafter acquired, licensable by such copyright holder or contributor that are necessarily infringed by:
+
+(a) their Contribution(s) (the licensed copyrights of copyright holders and non-copyrightable additions of contributors, in source or binary form) alone; or
+(b) combination of their Contribution(s) with the work of authorship to which such Contribution(s) was added by such copyright holder or contributor, if, at the time the Contribution is added, such addition causes such combination to be necessarily infringed. The patent license shall not apply to any other combinations which include the Contribution.
+Except as expressly stated above, no rights or licenses from any copyright holder or contributor is granted under this license, whether expressly, by implication, estoppel or otherwise.
+
+DISCLAIMER
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDERS OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

package/README.md

@@ -0,0 +1,62 @@
+# `@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`).
+
+## USAGE
+
+```js
+import { run, exec } from '@vltpkg/run'
+
+const cwd = '/path/to/pkg'
+
+// to run a script, as with `vlt run blah`
+const runResult = await run({
+  // the name of the thing in package.json#scripts
+  event: 'build',
+
+  // the dir where the package.json lives
+  cwd,
+
+  // if the script is not defined in package.json#scripts, just
+  // ignore it and treat as success. Otherwise, treat as an
+  // error. Default false.
+  ignoreMissing: true,
+
+  // extra arguments to pass into the child process
+  args: ['some', 'arguments'],
+
+  // the environment variables to add, defaults to process.env.
+  // note that @vltpkg/run will add some of its own, as well:
+  // - npm_lifecycle_event: the event name
+  // - npm_lifecycle_script: the command in package.json#scripts
+  // - npm_package_json: path to the package.json file
+  // - VLT_* envs for all vlt configuration values that are set
+  env: process.env,
+
+  // set this to `true` to take over the terminal and run in the
+  // foreground, inheriting the parent process's stdio
+  // by default, the script runs in the background.
+  // Only one foreground:true script will be run in parallel!
+  foreground: true,
+
+  // the shell to run the script in. Defaults to `${SHELL}` env
+  // variable if set, otherwise the system specific shell,
+  // `cmd.exe` on windows, and `/bin/sh` on posix.
+  'script-shell': '/usr/bin/bash',
+
+  // pass in a @vltpkg/package-json.PackageJson instance, and
+  // it'll be used for reading the package.json file. Optional,
+  // may improve performance somewhat.
+  packageJson: new PackageJson(),
+})
+
+// to execute an arbitrary command, as with `vlt exec whatever`
+const execResult = await exec({
+  // the command to execute.
+  command: 'do-something',
+  args: ['some', 'arguments'],
+  // other arguments all the same.
+})
+```

package/dist/esm/index.d.ts

@@ -0,0 +1,125 @@
+import { PackageJson } from '@vltpkg/package-json';
+import { PromiseSpawnOptions, type SpawnResultNoStdio, type SpawnResultStdioStrings } from '@vltpkg/promise-spawn';
+import { Manifest } from '@vltpkg/types';
+/** options shared by run() and exec() */
+export type SharedOptions = PromiseSpawnOptions & {
+    /** additional arguments to pass to the command */
+    args?: string[];
+    /** the root of the project, which we don't walk up past */
+    projectRoot: string;
+    /** the directory where the package.json lives and the script runs */
+    cwd: string;
+    /**
+     * environment variables to set. `process.env` is always included,
+     * to omit fields, set them explicitly to undefined.
+     *
+     * vlt will add some of its own, as well:
+     * - npm_lifecycle_event: the event name
+     * - npm_lifecycle_script: the command in package.json#scripts
+     * - npm_package_json: path to the package.json file
+     * - VLT_* envs for all vlt configuration values that are set
+     */
+    env?: NodeJS.ProcessEnv;
+    /**
+     * the shell to run the script in. If not set, then the default
+     * platform-specific shell will be used.
+     */
+    'script-shell'?: boolean | string;
+};
+/**
+ * Options for run() and runFG()
+ */
+export type RunOptions = SharedOptions & {
+    /** the name of the thing in package.json#scripts */
+    arg0: string;
+    /**
+     * pass in a @vltpkg/package-json.PackageJson instance, and
+     * it'll be used for reading the package.json file. Optional,
+     * may improve performance somewhat.
+     */
+    packageJson?: PackageJson;
+    /**
+     * Pass in a manifest to avoid having to read it at all
+     */
+    manifest?: Manifest;
+    /**
+     * if the script is not defined in package.json#scripts, just ignore it and
+     * treat as success. Otherwise, treat as an error. Default false.
+     */
+    ignoreMissing?: boolean;
+    /**
+     * skip the pre/post commands, just run the one specified.
+     * This can be used to run JUST the specified script, without any
+     * pre/post commands.
+     */
+    ignorePrePost?: boolean;
+};
+/**
+ * Options for exec() and execFG()
+ */
+export type ExecOptions = SharedOptions & {
+    /** the command to execute */
+    arg0: string;
+};
+/**
+ * Options for runExec() and runExecFG()
+ */
+export type RunExecOptions = SharedOptions & {
+    /**
+     * Either the command to be executed, or the event to be run
+     */
+    arg0: string;
+    /**
+     * pass in a @vltpkg/package-json.PackageJson instance, and
+     * it'll be used for reading the package.json file. Optional,
+     * may improve performance somewhat.
+     */
+    packageJson?: PackageJson;
+};
+/**
+ * Run a package.json#scripts event in the background
+ */
+export declare const run: (options: RunOptions) => Promise<RunResult>;
+/**
+ * Run a package.json#scripts event in the foreground
+ */
+export declare const runFG: (options: RunOptions) => Promise<RunFGResult>;
+/** Return type of {@link run} */
+export type RunResult = SpawnResultStdioStrings & {
+    pre?: SpawnResultStdioStrings;
+    post?: SpawnResultStdioStrings;
+};
+/** Return type of {@link runFG} */
+export type RunFGResult = SpawnResultNoStdio & {
+    pre?: SpawnResultNoStdio;
+    post?: SpawnResultNoStdio;
+};
+export declare const isRunResult: (v: unknown) => v is RunResult;
+/**
+ * Return type of {@link run} or {@link runFG}, as determined by their base
+ * type
+ *
+ * @internal
+ */
+export type RunImplResult<R extends SpawnResultNoStdio | SpawnResultStdioStrings> = R & {
+    pre?: R;
+    post?: R;
+};
+/**
+ * Execute an arbitrary command in the background
+ */
+export declare const exec: (options: ExecOptions) => Promise<SpawnResultStdioStrings>;
+/**
+ * Execute an arbitrary command in the foreground
+ */
+export declare const execFG: (options: ExecOptions) => Promise<SpawnResultNoStdio>;
+/**
+ * If the arg0 is a defined package.json script, then run(), otherwise exec()
+ */
+export declare const runExec: (options: RunExecOptions) => Promise<RunResult | SpawnResultStdioStrings>;
+/**
+ * If the arg0 is a defined package.json script, then runFG(), otherwise
+ * execFG()
+ */
+export declare const runExecFG: (options: RunExecOptions) => Promise<RunFGResult | SpawnResultNoStdio>;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAA;AAClD,OAAO,EAEL,mBAAmB,EACnB,KAAK,kBAAkB,EACvB,KAAK,uBAAuB,EAC7B,MAAM,uBAAuB,CAAA;AAC9B,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAA;AAiDxC,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;;;;;GAKG;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"}

package/dist/esm/index.js

@@ -0,0 +1,225 @@
+import { error } from '@vltpkg/error-cause';
+import { PackageJson } from '@vltpkg/package-json';
+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 { walkUp } from 'walk-up-path';
+/** map of which node_modules/.bin folders exist */
+const dotBins = new Map();
+/** Check if a directory exists, and cache result */
+const dirExists = (p) => {
+    const cached = dotBins.get(p);
+    if (cached !== undefined)
+        return cached;
+    try {
+        const isDir = statSync(p).isDirectory();
+        dotBins.set(p, isDir);
+        return isDir;
+    }
+    catch {
+        dotBins.set(p, false);
+        return false;
+    }
+};
+/**
+ * Add all exsting `node_modules/.bin` folders to the PATH that
+ * exist between the cwd and the projectRoot, so dependency bins
+ * are found, with closer paths higher priority.
+ */
+const addPaths = (projectRoot, cwd, env) => {
+    const { PATH = '' } = env;
+    const paths = new Set();
+    for (const p of walkUp(cwd)) {
+        const dotBin = resolve(p, 'node_modules/.bin');
+        if (dirExists(dotBin))
+            paths.add(dotBin);
+        if (p === projectRoot)
+            break;
+    }
+    for (const p of PATH.split(delimiter)) {
+        /* c8 ignore next - pretty rare to have an empty entry */
+        if (p)
+            paths.add(p);
+    }
+    env.PATH = [...paths].join(delimiter);
+    return env;
+};
+/**
+ * Run a package.json#scripts event in the background
+ */
+export const run = async (options) => runImpl(options, exec, '');
+/**
+ * Run a package.json#scripts event in the foreground
+ */
+export const runFG = async (options) => runImpl(options, execFG, null);
+export const isRunResult = (v) => !!v &&
+    typeof v === 'object' &&
+    !Array.isArray(v) &&
+    'stdout' in v &&
+    'stderr' in v &&
+    'status' in v &&
+    'signal' in 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 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
+    // in the package. So, we need to read the actual package.json
+    // in those cases.
+    const untrustworthy = !!(manifest?.gypfile &&
+        arg0 === 'install' &&
+        manifest.scripts?.install === 'node-gyp rebuild');
+    const pj = (untrustworthy ? undefined : manifest) ??
+        packageJson.read(options.cwd);
+    const { scripts } = pj;
+    const command = scripts?.[arg0];
+    if (!command) {
+        if (ignoreMissing) {
+            return {
+                command: '',
+                /* c8 ignore next */
+                args: execArgs.args ?? [],
+                cwd: options.cwd,
+                status: 0,
+                signal: null,
+                stdout: empty,
+                stderr: empty,
+                // `as` to workaround "could be instantiated with arbitrary type".
+                // it's private and used in 2 places, we know that it isn't.
+            };
+        }
+        throw error('Script not defined in package.json', {
+            name: arg0,
+            cwd: options.cwd,
+            args: options.args,
+            path: pjPath,
+            manifest: pj,
+        });
+    }
+    const precommand = !options.ignorePrePost && scripts[`pre${arg0}`];
+    const pre = precommand ?
+        await execImpl({
+            arg0: precommand,
+            ...execArgs,
+            args: [],
+            env: {
+                ...execArgs.env,
+                npm_package_json: pjPath,
+                npm_lifecycle_event: `pre${arg0}`,
+                npm_lifecycle_script: precommand,
+            },
+        })
+        : undefined;
+    if (pre && (pre.status || pre.signal)) {
+        return pre;
+    }
+    const result = await execImpl({
+        arg0: command,
+        ...execArgs,
+        env: {
+            ...execArgs.env,
+            npm_package_json: pjPath,
+            npm_lifecycle_event: arg0,
+            npm_lifecycle_script: command,
+        },
+    });
+    result.pre = pre;
+    if (result.signal || result.status) {
+        return result;
+    }
+    const postcommand = !options.ignorePrePost && scripts[`post${arg0}`];
+    if (!postcommand)
+        return result;
+    const post = await execImpl({
+        arg0: postcommand,
+        ...execArgs,
+        args: [],
+        env: {
+            ...execArgs.env,
+            npm_package_json: pjPath,
+            npm_lifecycle_event: `post${arg0}`,
+            npm_lifecycle_script: postcommand,
+        },
+    });
+    if (post.status || post.signal) {
+        const { status, signal } = post;
+        return Object.assign(result, { post, status, signal });
+    }
+    result.post = post;
+    return result;
+};
+/**
+ * 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 p = promiseSpawn(arg0, args, {
+        ...spawnOptions,
+        shell,
+        stdio: 'pipe',
+        stdioString: true,
+        cwd,
+        env: addPaths(projectRoot, cwd, {
+            ...process.env,
+            ...env,
+        }),
+        windowsHide: true,
+    });
+    proxySignals(p.process);
+    return await p;
+};
+/**
+ * Execute an arbitrary command in the foreground
+ */
+export const execFG = async (options) => {
+    const { arg0, args = [], cwd, projectRoot, env = {}, 'script-shell': shell = true, ...spawnOptions } = options;
+    return new Promise(res => {
+        foregroundChild(arg0, args, {
+            ...spawnOptions,
+            shell,
+            cwd,
+            env: addPaths(projectRoot, cwd, {
+                ...process.env,
+                ...env,
+            }),
+        }, (status, signal) => {
+            res({
+                command: arg0,
+                args,
+                cwd,
+                stdout: null,
+                stderr: null,
+                status,
+                signal,
+            });
+            return false;
+        });
+    });
+};
+const runExecImpl = async (options, runImpl, execImpl) => {
+    const { arg0, packageJson = new PackageJson(), ...args } = options;
+    const pj = packageJson.read(options.cwd);
+    const { scripts } = pj;
+    const command = scripts?.[arg0];
+    if (command) {
+        return runImpl({ ...args, packageJson, arg0 });
+    }
+    else {
+        return execImpl({ ...args, arg0 });
+    }
+};
+/**
+ * If the arg0 is a defined package.json script, then run(), otherwise exec()
+ */
+export const runExec = async (options) => runExecImpl(options, run, exec);
+/**
+ * If the arg0 is a defined package.json script, then runFG(), otherwise
+ * execFG()
+ */
+export const runExecFG = async (options) => runExecImpl(options, runFG, execFG);
+//# sourceMappingURL=index.js.map

package/dist/esm/index.js.map

@@ -0,0 +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 {\n  promiseSpawn,\n  PromiseSpawnOptions,\n  type SpawnResultNoStdio,\n  type SpawnResultStdioStrings,\n} from '@vltpkg/promise-spawn'\nimport { 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 *\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"]}

package/dist/esm/package.json

@@ -0,0 +1,3 @@
+{
+  "type": "module"
+}

package/package.json

@@ -0,0 +1,66 @@
+{
+  "name": "@vltpkg/run",
+  "description": "Run package.json scripts and execute commands",
+  "version": "0.0.0-0.1730239248325",
+  "tshy": {
+    "selfLink": false,
+    "dialects": [
+      "esm"
+    ],
+    "exports": {
+      "./package.json": "./package.json",
+      ".": "./src/index.ts"
+    }
+  },
+  "dependencies": {
+    "foreground-child": "^3.2.0",
+    "walk-up-path": "^4.0.0",
+    "@vltpkg/types": "0.0.0-0.1730239248325",
+    "@vltpkg/error-cause": "0.0.0-0.1730239248325",
+    "@vltpkg/promise-spawn": "0.0.0-0.1730239248325",
+    "@vltpkg/package-json": "0.0.0-0.1730239248325"
+  },
+  "devDependencies": {
+    "@eslint/js": "^9.8.0",
+    "@types/eslint__js": "^8.42.3",
+    "@types/node": "^22.4.1",
+    "eslint": "^9.8.0",
+    "prettier": "^3.3.2",
+    "tap": "^21.0.1",
+    "tshy": "^3.0.2",
+    "typescript": "^5.5.4",
+    "typescript-eslint": "^8.0.1"
+  },
+  "license": "BSD-2-Clause-Patent",
+  "engines": {
+    "node": "20 || >=22"
+  },
+  "tap": {
+    "extends": "../../tap-config.yaml"
+  },
+  "prettier": "../../.prettierrc.js",
+  "module": "./dist/esm/index.js",
+  "type": "module",
+  "exports": {
+    "./package.json": "./package.json",
+    ".": {
+      "import": {
+        "types": "./dist/esm/index.d.ts",
+        "default": "./dist/esm/index.js"
+      }
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "format": "prettier --write . --log-level warn --ignore-path ../../.prettierignore --cache",
+    "format:check": "prettier --check . --ignore-path ../../.prettierignore --cache",
+    "lint": "eslint . --fix",
+    "lint:check": "eslint .",
+    "presnap": "tshy",
+    "snap": "tap",
+    "pretest": "tshy",
+    "test": "tap"
+  }
+}