@vltpkg/graph 0.0.0-0.1730239248325

package/dist/esm/node.js

@@ -0,0 +1,266 @@
+import { getId, hydrateTuple, splitDepID, } from '@vltpkg/dep-id';
+import { typeError } from '@vltpkg/error-cause';
+import { Edge } from './edge.js';
+import { stringifyNode } from './stringify-node.js';
+export class Node {
+    get [Symbol.toStringTag]() {
+        return '@vltpkg/graph.Node';
+    }
+    #options;
+    #location;
+    #optional = false;
+    /**
+     * True if a node is only reachable via optional or peerOptional edges from
+     * any importer.
+     *
+     * Setting this to false, if previously set to true, will also unset
+     * the flag on any optional-flagged non-optional dependencies.
+     */
+    get optional() {
+        return this.#optional;
+    }
+    set optional(optional) {
+        const before = this.#optional;
+        this.#optional = optional;
+        if (before && !optional) {
+            // unset for all deps, as well
+            for (const { to, optional } of this.edgesOut.values()) {
+                if (!optional && to?.optional)
+                    to.optional = false;
+            }
+        }
+    }
+    isOptional() {
+        return this.#optional;
+    }
+    #dev = false;
+    /**
+     * True if a node is only reachable via dev edges from any importer.
+     *
+     * Setting this to false, if previously set to true, will also unset
+     * the flag on any dev-flagged non-dev dependencies.
+     */
+    get dev() {
+        return this.#dev;
+    }
+    set dev(dev) {
+        const before = this.#dev;
+        this.#dev = dev;
+        if (before && !dev) {
+            // unset for all deps, as well
+            for (const { to, dev } of this.edgesOut.values()) {
+                if (!dev && to?.dev)
+                    to.dev = false;
+            }
+        }
+    }
+    isDev() {
+        return this.#dev;
+    }
+    /**
+     * List of edges coming into this node.
+     */
+    edgesIn = new Set();
+    /**
+     * List of edges from this node into other nodes. This usually represents
+     * that the connected node is a direct dependency of this node.
+     */
+    edgesOut = new Map();
+    /**
+     * A reference to the {@link DepID} this node represents in the graph.
+     */
+    id;
+    /**
+     * True if this node is an importer node.
+     */
+    importer = false;
+    /**
+     * True if this node is the project root node.
+     */
+    mainImporter = false;
+    /**
+     * A reference to the graph this node is a part of.
+     */
+    graph;
+    /**
+     * The manifest integrity value.
+     */
+    integrity;
+    /**
+     * The manifest this node represents in the graph.
+     */
+    manifest;
+    /**
+     * Project where this node resides
+     */
+    projectRoot;
+    /**
+     * For registry nodes, this is the registry we fetched them from.
+     * Needed because their un-prefixed dependencies need to come from
+     * the same registry, if it's not the default.
+     */
+    registry;
+    /**
+     * The name of the package represented by this node, this is usually
+     * equivalent to `manifest.name` but in a few ways it may differ such as
+     * nodes loaded from a lockfile that lacks a loaded manifest.
+     * This field should be used to retrieve package names instead.
+     */
+    #name;
+    get name() {
+        if (this.#name)
+            return this.#name;
+        this.#name = this.id;
+        return this.#name;
+    }
+    /**
+     * The location of the node_modules folder where this node's edgesOut
+     * should be linked into. For nodes in the store, this is the parent
+     * directory, since they're extracted into a node_modules folder
+     * side by side with links to their deps. For nodes outside of the store
+     * (ie, importers and arbitrary link deps) this is the node_modules folder
+     * directly inside the node's directory.
+     */
+    get nodeModules() {
+        const loc = this.location;
+        return this.inVltStore() ?
+            loc.substring(0, loc.length - this.name.length - 1)
+            : loc + '/node_modules';
+    }
+    /**
+     * The version of the package represented by this node, this is usually
+     * equivalent to `manifest.version` but in a few ways it may differ such as
+     * nodes loaded from a lockfile that lacks a loaded manifest.
+     * This field should be used to retrieve package versions instead.
+     */
+    version;
+    /**
+     * An address {@link PackageInfoClient} may use to extract this package.
+     */
+    resolved;
+    /**
+     * The file system location for this node.
+     */
+    get location() {
+        if (this.#location) {
+            return this.#location;
+        }
+        this.#location = `./node_modules/.vlt/${this.id}/node_modules/${this.name}`;
+        // if using the default location, it is in the store
+        this.inVltStore = () => true;
+        return this.#location;
+    }
+    set location(location) {
+        this.#location = location;
+        // reset memoization, since it might be elsewhere now
+        if (this.inVltStore !== Node.prototype.inVltStore) {
+            this.inVltStore = Node.prototype.inVltStore;
+        }
+    }
+    constructor(options, id, manifest, spec, name, version) {
+        this.#options = options;
+        this.projectRoot = options.projectRoot;
+        if (id) {
+            this.id = id;
+        }
+        else {
+            if (!manifest || !spec) {
+                throw typeError('A new Node needs either a manifest & spec or an id parameter', {
+                    manifest,
+                });
+            }
+            this.id = getId(spec, manifest);
+        }
+        this.graph = options.graph;
+        this.manifest = manifest;
+        this.#name = name || this.manifest?.name;
+        this.version = version || this.manifest?.version;
+    }
+    /**
+     * return true if this node is located in the vlt store
+     * memoized the first time it's called, since the store location
+     * doesn't change within the context of a single operation.
+     */
+    inVltStore() {
+        // technically this just means it's in *a* vlt store, but we can safely
+        // assume that a user won't construct a path like this by accident,
+        // and there's only ever one store in any given project.
+        const inStore = this.location.endsWith(`.vlt/${this.id}/node_modules/${this.name}`);
+        this.inVltStore = () => inStore;
+        return inStore;
+    }
+    #registryNodeResolved(tuple) {
+        const spec = hydrateTuple(tuple, this.#name, this.#options);
+        this.resolved =
+            this.manifest?.dist?.tarball || spec.conventionalRegistryTarball;
+        this.integrity ??= this.manifest?.dist?.integrity;
+    }
+    equals(other) {
+        return this.id === other.id && this.location === other.location;
+    }
+    /**
+     * Sets the node as an importer along with its location.
+     */
+    setImporterLocation(location) {
+        this.#location = location;
+        this.importer = true;
+    }
+    /**
+     * Sets the appropriate resolve / integrity value for this node.
+     * Note that other places might also set these values, like for
+     * example the lockfile that might have already have this info.
+     */
+    setResolved() {
+        // file | remote | workspace type of ids all points to a URI that
+        // can be used as the `resolved` value, so we split the dep id
+        // for these cases.
+        const tuple = splitDepID(this.id);
+        const [type, resolved] = tuple;
+        switch (type) {
+            case 'registry':
+                this.#registryNodeResolved(tuple);
+                break;
+            default:
+                this.resolved = resolved;
+                break;
+        }
+    }
+    setDefaultLocation() {
+        const def = `./node_modules/.vlt/${this.id}/node_modules/${this.name}`;
+        // only relocate if the location is in node_modules already
+        if (!this.importer &&
+            (!this.#location ||
+                (this.#location !== def &&
+                    /^(?:\.\/)?node_modules\//.test(this.#location)))) {
+            this.#location = def;
+        }
+    }
+    /**
+     * Add an edge from this node connecting it to a direct dependency.
+     */
+    addEdgesTo(type, spec, node) {
+        const edge = new Edge(type, spec, this, node);
+        node?.edgesIn.add(edge);
+        this.edgesOut.set(spec.name, edge);
+        return edge;
+    }
+    toJSON() {
+        return {
+            id: this.id,
+            name: this.name,
+            version: this.version,
+            location: this.location,
+            importer: this.importer,
+            manifest: this.manifest,
+            projectRoot: this.projectRoot,
+            integrity: this.integrity,
+            resolved: this.resolved,
+            dev: this.dev,
+            optional: this.optional,
+        };
+    }
+    toString() {
+        return stringifyNode(this);
+    }
+}
+//# sourceMappingURL=node.js.map

package/dist/esm/node.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"node.js","sourceRoot":"","sources":["../../src/node.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n  DepID,\n  DepIDTuple,\n  getId,\n  hydrateTuple,\n  splitDepID,\n} from '@vltpkg/dep-id'\nimport { typeError } from '@vltpkg/error-cause'\nimport { Spec, SpecOptions } from '@vltpkg/spec'\nimport { Integrity, Manifest } from '@vltpkg/types'\nimport { DependencyTypeShort } from './dependencies.js'\nimport { Edge } from './edge.js'\nimport { GraphLike, NodeLike } from './types.js'\nimport { stringifyNode } from './stringify-node.js'\n\nexport type NodeOptions = SpecOptions & {\n  projectRoot: string\n  graph: GraphLike\n}\n\nexport class Node implements NodeLike {\n  get [Symbol.toStringTag]() {\n    return '@vltpkg/graph.Node'\n  }\n\n  #options: SpecOptions\n  #location?: string\n\n  #optional = false\n  /**\n   * True if a node is only reachable via optional or peerOptional edges from\n   * any importer.\n   *\n   * Setting this to false, if previously set to true, will also unset\n   * the flag on any optional-flagged non-optional dependencies.\n   */\n  get optional() {\n    return this.#optional\n  }\n  set optional(optional: boolean) {\n    const before = this.#optional\n    this.#optional = optional\n    if (before && !optional) {\n      // unset for all deps, as well\n      for (const { to, optional } of this.edgesOut.values()) {\n        if (!optional && to?.optional) to.optional = false\n      }\n    }\n  }\n\n  isOptional(): this is Node & { optional: true } {\n    return this.#optional\n  }\n\n  #dev = false\n  /**\n   * True if a node is only reachable via dev edges from any importer.\n   *\n   * Setting this to false, if previously set to true, will also unset\n   * the flag on any dev-flagged non-dev dependencies.\n   */\n  get dev() {\n    return this.#dev\n  }\n  set dev(dev: boolean) {\n    const before = this.#dev\n    this.#dev = dev\n    if (before && !dev) {\n      // unset for all deps, as well\n      for (const { to, dev } of this.edgesOut.values()) {\n        if (!dev && to?.dev) to.dev = false\n      }\n    }\n  }\n\n  isDev(): this is Node & { dev: true } {\n    return this.#dev\n  }\n\n  /**\n   * List of edges coming into this node.\n   */\n  edgesIn = new Set<Edge>()\n\n  /**\n   * List of edges from this node into other nodes. This usually represents\n   * that the connected node is a direct dependency of this node.\n   */\n  edgesOut = new Map<string, Edge>()\n\n  /**\n   * A reference to the {@link DepID} this node represents in the graph.\n   */\n  id: DepID\n\n  /**\n   * True if this node is an importer node.\n   */\n  importer = false\n\n  /**\n   * True if this node is the project root node.\n   */\n  mainImporter = false\n\n  /**\n   * A reference to the graph this node is a part of.\n   */\n  graph: GraphLike\n\n  /**\n   * The manifest integrity value.\n   */\n  integrity?: Integrity\n\n  /**\n   * The manifest this node represents in the graph.\n   */\n  manifest?: Manifest\n\n  /**\n   * Project where this node resides\n   */\n  projectRoot: string\n\n  /**\n   * For registry nodes, this is the registry we fetched them from.\n   * Needed because their un-prefixed dependencies need to come from\n   * the same registry, if it's not the default.\n   */\n  registry?: string\n\n  /**\n   * The name of the package represented by this node, this is usually\n   * equivalent to `manifest.name` but in a few ways it may differ such as\n   * nodes loaded from a lockfile that lacks a loaded manifest.\n   * This field should be used to retrieve package names instead.\n   */\n  #name?: string\n  get name() {\n    if (this.#name) return this.#name\n    this.#name = this.id\n    return this.#name\n  }\n\n  /**\n   * The location of the node_modules folder where this node's edgesOut\n   * should be linked into. For nodes in the store, this is the parent\n   * directory, since they're extracted into a node_modules folder\n   * side by side with links to their deps. For nodes outside of the store\n   * (ie, importers and arbitrary link deps) this is the node_modules folder\n   * directly inside the node's directory.\n   */\n  get nodeModules() {\n    const loc = this.location\n    return this.inVltStore() ?\n        loc.substring(0, loc.length - this.name.length - 1)\n      : loc + '/node_modules'\n  }\n\n  /**\n   * The version of the package represented by this node, this is usually\n   * equivalent to `manifest.version` but in a few ways it may differ such as\n   * nodes loaded from a lockfile that lacks a loaded manifest.\n   * This field should be used to retrieve package versions instead.\n   */\n  version?: string\n\n  /**\n   * An address {@link PackageInfoClient} may use to extract this package.\n   */\n  resolved?: string\n\n  /**\n   * The file system location for this node.\n   */\n  get location(): string {\n    if (this.#location) {\n      return this.#location\n    }\n    this.#location = `./node_modules/.vlt/${this.id}/node_modules/${this.name}`\n    // if using the default location, it is in the store\n    this.inVltStore = () => true\n    return this.#location\n  }\n\n  set location(location: string) {\n    this.#location = location\n    // reset memoization, since it might be elsewhere now\n    if (this.inVltStore !== Node.prototype.inVltStore) {\n      this.inVltStore = Node.prototype.inVltStore\n    }\n  }\n\n  constructor(\n    options: NodeOptions,\n    id?: DepID,\n    manifest?: Manifest,\n    spec?: Spec,\n    name?: string,\n    version?: string,\n  ) {\n    this.#options = options\n    this.projectRoot = options.projectRoot\n    if (id) {\n      this.id = id\n    } else {\n      if (!manifest || !spec) {\n        throw typeError(\n          'A new Node needs either a manifest & spec or an id parameter',\n          {\n            manifest,\n          },\n        )\n      }\n      this.id = getId(spec, manifest)\n    }\n    this.graph = options.graph\n    this.manifest = manifest\n    this.#name = name || this.manifest?.name\n    this.version = version || this.manifest?.version\n  }\n\n  /**\n   * return true if this node is located in the vlt store\n   * memoized the first time it's called, since the store location\n   * doesn't change within the context of a single operation.\n   */\n  inVltStore(): boolean {\n    // technically this just means it's in *a* vlt store, but we can safely\n    // assume that a user won't construct a path like this by accident,\n    // and there's only ever one store in any given project.\n    const inStore = this.location.endsWith(\n      `.vlt/${this.id}/node_modules/${this.name}`,\n    )\n    this.inVltStore = () => inStore\n    return inStore\n  }\n\n  #registryNodeResolved(tuple: DepIDTuple) {\n    const spec = hydrateTuple(tuple, this.#name, this.#options)\n    this.resolved =\n      this.manifest?.dist?.tarball || spec.conventionalRegistryTarball\n    this.integrity ??= this.manifest?.dist?.integrity\n  }\n\n  equals(other: Node) {\n    return this.id === other.id && this.location === other.location\n  }\n\n  /**\n   * Sets the node as an importer along with its location.\n   */\n  setImporterLocation(location: string) {\n    this.#location = location\n    this.importer = true\n  }\n\n  /**\n   * Sets the appropriate resolve / integrity value for this node.\n   * Note that other places might also set these values, like for\n   * example the lockfile that might have already have this info.\n   */\n  setResolved() {\n    // file | remote | workspace type of ids all points to a URI that\n    // can be used as the `resolved` value, so we split the dep id\n    // for these cases.\n    const tuple = splitDepID(this.id)\n    const [type, resolved] = tuple\n    switch (type) {\n      case 'registry':\n        this.#registryNodeResolved(tuple)\n        break\n      default:\n        this.resolved = resolved\n        break\n    }\n  }\n\n  setDefaultLocation() {\n    const def = `./node_modules/.vlt/${this.id}/node_modules/${this.name}`\n\n    // only relocate if the location is in node_modules already\n    if (\n      !this.importer &&\n      (!this.#location ||\n        (this.#location !== def &&\n          /^(?:\\.\\/)?node_modules\\//.test(this.#location)))\n    ) {\n      this.#location = def\n    }\n  }\n\n  /**\n   * Add an edge from this node connecting it to a direct dependency.\n   */\n  addEdgesTo(type: DependencyTypeShort, spec: Spec, node?: Node) {\n    const edge = new Edge(type, spec, this, node)\n    node?.edgesIn.add(edge)\n    this.edgesOut.set(spec.name, edge)\n    return edge\n  }\n\n  toJSON() {\n    return {\n      id: this.id,\n      name: this.name,\n      version: this.version,\n      location: this.location,\n      importer: this.importer,\n      manifest: this.manifest,\n      projectRoot: this.projectRoot,\n      integrity: this.integrity,\n      resolved: this.resolved,\n      dev: this.dev,\n      optional: this.optional,\n    }\n  }\n\n  toString() {\n    return stringifyNode(this)\n  }\n}\n"]}

package/dist/esm/non-empty-list.d.ts

@@ -0,0 +1,3 @@
+export declare const isNonEmptyList: <T>(list: T[]) => list is [first: T, ...rest: T[]];
+export declare const nonEmptyList: <T>(nodes: T[]) => [first: T, ...rest: T[]] | undefined;
+//# sourceMappingURL=non-empty-list.d.ts.map

package/dist/esm/non-empty-list.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"non-empty-list.d.ts","sourceRoot":"","sources":["../../src/non-empty-list.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,cAAc,GAAI,CAAC,QACxB,CAAC,EAAE,KACR,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC,EAAE,GAAG,IAAI,EAAE,CAAC,EAAE,CAAkB,CAAA;AAEpD,eAAO,MAAM,YAAY,GAAI,CAAC,SAAS,CAAC,EAAE,yCACC,CAAA"}

package/dist/esm/non-empty-list.js

@@ -0,0 +1,3 @@
+export const isNonEmptyList = (list) => !!list.length;
+export const nonEmptyList = (nodes) => isNonEmptyList(nodes) ? nodes : undefined;
+//# sourceMappingURL=non-empty-list.js.map

package/dist/esm/non-empty-list.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"non-empty-list.js","sourceRoot":"","sources":["../../src/non-empty-list.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,cAAc,GAAG,CAC5B,IAAS,EACyB,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAA;AAEpD,MAAM,CAAC,MAAM,YAAY,GAAG,CAAI,KAAU,EAAE,EAAE,CAC5C,cAAc,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAA","sourcesContent":["export const isNonEmptyList = <T>(\n  list: T[],\n): list is [first: T, ...rest: T[]] => !!list.length\n\nexport const nonEmptyList = <T>(nodes: T[]) =>\n  isNonEmptyList(nodes) ? nodes : undefined\n"]}

package/dist/esm/package.json

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

package/dist/esm/reify/add-edge.d.ts

@@ -0,0 +1,11 @@
+import { RollbackRemove } from '@vltpkg/rollback-remove';
+import { Manifest } from '@vltpkg/types';
+import { PathScurry } from 'path-scurry';
+import { Edge } from '../edge.js';
+/**
+ * reify an edge into a node_modules folder, with bins linked
+ * this does NOT chmod the bins to 0o777, because they might not exist
+ * until scripts are run, in the case of non-store deps like workspaces
+ */
+export declare const addEdge: (edge: Edge, manifest: Manifest, scurry: PathScurry, remover: RollbackRemove) => Promise<void>;
+//# sourceMappingURL=add-edge.d.ts.map

package/dist/esm/reify/add-edge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"add-edge.d.ts","sourceRoot":"","sources":["../../../src/reify/add-edge.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAA;AACxD,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAA;AAGxC,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AACxC,OAAO,EAAE,IAAI,EAAE,MAAM,YAAY,CAAA;AAwBjC;;;;GAIG;AACH,eAAO,MAAM,OAAO,SACZ,IAAI,YACA,QAAQ,UACV,UAAU,WACT,cAAc,kBAmBxB,CAAA"}

package/dist/esm/reify/add-edge.js

@@ -0,0 +1,43 @@
+import { mkdir, symlink } from 'fs/promises';
+import { dirname, relative } from 'path';
+import { binPaths } from './bin-paths.js';
+const clobberSymlink = async (target, link, remover, type = 'file') => {
+    await mkdir(dirname(link), { recursive: true });
+    try {
+        await symlink(target, link, type);
+    }
+    catch (e) {
+        const er = e;
+        if (er.code === 'EEXIST') {
+            return remover.rm(link).then(() => symlink(target, link));
+            /* c8 ignore start */
+        }
+        else {
+            throw er;
+        }
+    }
+    /* c8 ignore stop */
+};
+/**
+ * reify an edge into a node_modules folder, with bins linked
+ * this does NOT chmod the bins to 0o777, because they might not exist
+ * until scripts are run, in the case of non-store deps like workspaces
+ */
+export const addEdge = async (edge, manifest, scurry, remover) => {
+    if (!edge.to)
+        return;
+    const binRoot = scurry.resolve(edge.from.nodeModules, '.bin');
+    const path = scurry.resolve(edge.from.nodeModules, edge.spec.name);
+    const promises = [];
+    const target = relative(dirname(path), scurry.resolve(edge.to.location));
+    promises.push(clobberSymlink(target, path, remover, 'dir'));
+    const bp = binPaths(manifest);
+    for (const [key, val] of Object.entries(bp)) {
+        const link = scurry.resolve(binRoot, key);
+        const target = relative(binRoot, scurry.resolve(path, val));
+        // TODO: bash/cmd/pwsh shims on Windows
+        promises.push(clobberSymlink(target, link, remover));
+    }
+    await Promise.all(promises);
+};
+//# sourceMappingURL=add-edge.js.map

package/dist/esm/reify/add-edge.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"add-edge.js","sourceRoot":"","sources":["../../../src/reify/add-edge.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAA;AAC5C,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,MAAM,CAAA;AAGxC,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAA;AAEzC,MAAM,cAAc,GAAG,KAAK,EAC1B,MAAc,EACd,IAAY,EACZ,OAAuB,EACvB,IAAI,GAAG,MAAM,EACb,EAAE;IACF,MAAM,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAA;IAC/C,IAAI,CAAC;QACH,MAAM,OAAO,CAAC,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,CAAA;IACnC,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,MAAM,EAAE,GAAG,CAA0B,CAAA;QACrC,IAAI,EAAE,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;YACzB,OAAO,OAAO,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC,CAAA;YACzD,qBAAqB;QACvB,CAAC;aAAM,CAAC;YACN,MAAM,EAAE,CAAA;QACV,CAAC;IACH,CAAC;IACD,oBAAoB;AACtB,CAAC,CAAA;AAED;;;;GAIG;AACH,MAAM,CAAC,MAAM,OAAO,GAAG,KAAK,EAC1B,IAAU,EACV,QAAkB,EAClB,MAAkB,EAClB,OAAuB,EACvB,EAAE;IACF,IAAI,CAAC,IAAI,CAAC,EAAE;QAAE,OAAM;IACpB,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,MAAM,CAAC,CAAA;IAC7D,MAAM,IAAI,GAAG,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IAClE,MAAM,QAAQ,GAAuB,EAAE,CAAA;IACvC,MAAM,MAAM,GAAG,QAAQ,CACrB,OAAO,CAAC,IAAI,CAAC,EACb,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC,QAAQ,CAAC,CACjC,CAAA;IACD,QAAQ,CAAC,IAAI,CAAC,cAAc,CAAC,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,CAAC,CAAC,CAAA;IAC3D,MAAM,EAAE,GAAG,QAAQ,CAAC,QAAQ,CAAC,CAAA;IAC7B,KAAK,MAAM,CAAC,GAAG,EAAE,GAAG,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC,EAAE,CAAC;QAC5C,MAAM,IAAI,GAAG,MAAM,CAAC,OAAO,CAAC,OAAO,EAAE,GAAG,CAAC,CAAA;QACzC,MAAM,MAAM,GAAG,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC,CAAA;QAC3D,uCAAuC;QACvC,QAAQ,CAAC,IAAI,CAAC,cAAc,CAAC,MAAM,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC,CAAA;IACtD,CAAC;IACD,MAAM,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAA;AAC7B,CAAC,CAAA","sourcesContent":["import { RollbackRemove } from '@vltpkg/rollback-remove'\nimport { Manifest } from '@vltpkg/types'\nimport { mkdir, symlink } from 'fs/promises'\nimport { dirname, relative } from 'path'\nimport { PathScurry } from 'path-scurry'\nimport { Edge } from '../edge.js'\nimport { binPaths } from './bin-paths.js'\n\nconst clobberSymlink = async (\n  target: string,\n  link: string,\n  remover: RollbackRemove,\n  type = 'file',\n) => {\n  await mkdir(dirname(link), { recursive: true })\n  try {\n    await symlink(target, link, type)\n  } catch (e) {\n    const er = e as NodeJS.ErrnoException\n    if (er.code === 'EEXIST') {\n      return remover.rm(link).then(() => symlink(target, link))\n      /* c8 ignore start */\n    } else {\n      throw er\n    }\n  }\n  /* c8 ignore stop */\n}\n\n/**\n * reify an edge into a node_modules folder, with bins linked\n * this does NOT chmod the bins to 0o777, because they might not exist\n * until scripts are run, in the case of non-store deps like workspaces\n */\nexport const addEdge = async (\n  edge: Edge,\n  manifest: Manifest,\n  scurry: PathScurry,\n  remover: RollbackRemove,\n) => {\n  if (!edge.to) return\n  const binRoot = scurry.resolve(edge.from.nodeModules, '.bin')\n  const path = scurry.resolve(edge.from.nodeModules, edge.spec.name)\n  const promises: Promise<unknown>[] = []\n  const target = relative(\n    dirname(path),\n    scurry.resolve(edge.to.location),\n  )\n  promises.push(clobberSymlink(target, path, remover, 'dir'))\n  const bp = binPaths(manifest)\n  for (const [key, val] of Object.entries(bp)) {\n    const link = scurry.resolve(binRoot, key)\n    const target = relative(binRoot, scurry.resolve(path, val))\n    // TODO: bash/cmd/pwsh shims on Windows\n    promises.push(clobberSymlink(target, link, remover))\n  }\n  await Promise.all(promises)\n}\n"]}

package/dist/esm/reify/add-edges.d.ts

@@ -0,0 +1,6 @@
+import type { PackageJson } from '@vltpkg/package-json';
+import type { RollbackRemove } from '@vltpkg/rollback-remove';
+import { PathScurry } from 'path-scurry';
+import type { Diff } from '../diff.js';
+export declare const addEdges: (diff: Diff, packageJson: PackageJson, scurry: PathScurry, remover: RollbackRemove) => Promise<unknown>[];
+//# sourceMappingURL=add-edges.d.ts.map

package/dist/esm/reify/add-edges.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"add-edges.d.ts","sourceRoot":"","sources":["../../../src/reify/add-edges.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAA;AACvD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAA;AAC7D,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AACxC,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,YAAY,CAAA;AAGtC,eAAO,MAAM,QAAQ,SACb,IAAI,eACG,WAAW,UAChB,UAAU,WACT,cAAc,KACtB,OAAO,CAAC,OAAO,CAAC,EASlB,CAAA"}

package/dist/esm/reify/add-edges.js

@@ -0,0 +1,13 @@
+import { addEdge } from './add-edge.js';
+export const addEdges = (diff, packageJson, scurry, remover) => {
+    const actions = [];
+    for (const edge of diff.edges.add) {
+        const { to } = edge;
+        if (!to)
+            continue;
+        const mani = to.manifest ?? packageJson.read(to.location);
+        actions.push(addEdge(edge, mani, scurry, remover));
+    }
+    return actions;
+};
+//# sourceMappingURL=add-edges.js.map

package/dist/esm/reify/add-edges.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"add-edges.js","sourceRoot":"","sources":["../../../src/reify/add-edges.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAA;AAEvC,MAAM,CAAC,MAAM,QAAQ,GAAG,CACtB,IAAU,EACV,WAAwB,EACxB,MAAkB,EAClB,OAAuB,EACH,EAAE;IACtB,MAAM,OAAO,GAAuB,EAAE,CAAA;IACtC,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC;QAClC,MAAM,EAAE,EAAE,EAAE,GAAG,IAAI,CAAA;QACnB,IAAI,CAAC,EAAE;YAAE,SAAQ;QACjB,MAAM,IAAI,GAAG,EAAE,CAAC,QAAQ,IAAI,WAAW,CAAC,IAAI,CAAC,EAAE,CAAC,QAAQ,CAAC,CAAA;QACzD,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC,CAAA;IACpD,CAAC;IACD,OAAO,OAAO,CAAA;AAChB,CAAC,CAAA","sourcesContent":["import type { PackageJson } from '@vltpkg/package-json'\nimport type { RollbackRemove } from '@vltpkg/rollback-remove'\nimport { PathScurry } from 'path-scurry'\nimport type { Diff } from '../diff.js'\nimport { addEdge } from './add-edge.js'\n\nexport const addEdges = (\n  diff: Diff,\n  packageJson: PackageJson,\n  scurry: PathScurry,\n  remover: RollbackRemove,\n): Promise<unknown>[] => {\n  const actions: Promise<unknown>[] = []\n  for (const edge of diff.edges.add) {\n    const { to } = edge\n    if (!to) continue\n    const mani = to.manifest ?? packageJson.read(to.location)\n    actions.push(addEdge(edge, mani, scurry, remover))\n  }\n  return actions\n}\n"]}

package/dist/esm/reify/add-nodes.d.ts

@@ -0,0 +1,7 @@
+import { PackageInfoClient } from '@vltpkg/package-info';
+import { RollbackRemove } from '@vltpkg/rollback-remove';
+import { SpecOptions } from '@vltpkg/spec';
+import { PathScurry } from 'path-scurry';
+import { Diff } from '../diff.js';
+export declare const addNodes: (diff: Diff, scurry: PathScurry, remover: RollbackRemove, options: SpecOptions, packageInfo: PackageInfoClient) => (() => Promise<unknown>)[];
+//# sourceMappingURL=add-nodes.d.ts.map

package/dist/esm/reify/add-nodes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"add-nodes.d.ts","sourceRoot":"","sources":["../../../src/reify/add-nodes.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAA;AAExD,OAAO,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAA;AACxD,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAA;AAC1C,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AACxC,OAAO,EAAE,IAAI,EAAE,MAAM,YAAY,CAAA;AAGjC,eAAO,MAAM,QAAQ,SACb,IAAI,UACF,UAAU,WACT,cAAc,WACd,WAAW,eACP,iBAAiB,KAC7B,CAAC,MAAM,OAAO,CAAC,OAAO,CAAC,CAAC,EA0C1B,CAAA"}

package/dist/esm/reify/add-nodes.js

@@ -0,0 +1,37 @@
+import { hydrate } from '@vltpkg/dep-id';
+import { platformCheck } from '@vltpkg/pick-manifest';
+import { optionalFail } from './optional-fail.js';
+export const addNodes = (diff, scurry, remover, options, packageInfo) => {
+    const actions = [];
+    // fetch and extract all the nodes, removing any in the way
+    for (const node of diff.nodes.add) {
+        /* c8 ignore next - all nodes have manifests by this point */
+        const { manifest = {} } = node;
+        // if it's not in the store, we don't have to extract it, because
+        // we're just linking to a location that already exists.
+        if (!node.inVltStore())
+            continue;
+        // remove anything already there
+        const target = scurry.resolve(node.location);
+        const from = scurry.resolve('');
+        const spec = hydrate(node.id, manifest.name, options);
+        const onErr = optionalFail(diff, node);
+        // if it's optional, and we know it isn't for this platform, or it's
+        // deprecated, don't install it. if it's not optional, try our best.
+        if (onErr &&
+            (manifest.deprecated ||
+                !platformCheck(manifest, process.version, process.platform, process.arch))) {
+            onErr();
+            continue;
+        }
+        actions.push(() => remover
+            .rm(target)
+            .then(() => onErr ?
+            packageInfo
+                .extract(spec, target, { from })
+                .then(x => x, onErr)
+            : packageInfo.extract(spec, target, { from })));
+    }
+    return actions;
+};
+//# sourceMappingURL=add-nodes.js.map

package/dist/esm/reify/add-nodes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"add-nodes.js","sourceRoot":"","sources":["../../../src/reify/add-nodes.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAA;AAExC,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAA;AAKrD,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AAEjD,MAAM,CAAC,MAAM,QAAQ,GAAG,CACtB,IAAU,EACV,MAAkB,EAClB,OAAuB,EACvB,OAAoB,EACpB,WAA8B,EACF,EAAE;IAC9B,MAAM,OAAO,GAA+B,EAAE,CAAA;IAC9C,2DAA2D;IAC3D,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC;QAClC,6DAA6D;QAC7D,MAAM,EAAE,QAAQ,GAAG,EAAE,EAAE,GAAG,IAAI,CAAA;QAC9B,iEAAiE;QACjE,wDAAwD;QACxD,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE;YAAE,SAAQ;QAChC,gCAAgC;QAChC,MAAM,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAA;QAC5C,MAAM,IAAI,GAAG,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC,CAAA;QAC/B,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC,CAAA;QACrD,MAAM,KAAK,GAAG,YAAY,CAAC,IAAI,EAAE,IAAI,CAAC,CAAA;QACtC,oEAAoE;QACpE,oEAAoE;QACpE,IACE,KAAK;YACL,CAAC,QAAQ,CAAC,UAAU;gBAClB,CAAC,aAAa,CACZ,QAAQ,EACR,OAAO,CAAC,OAAO,EACf,OAAO,CAAC,QAAQ,EAChB,OAAO,CAAC,IAAI,CACb,CAAC,EACJ,CAAC;YACD,KAAK,EAAE,CAAA;YACP,SAAQ;QACV,CAAC;QACD,OAAO,CAAC,IAAI,CAAC,GAAG,EAAE,CAChB,OAAO;aACJ,EAAE,CAAC,MAAM,CAAC;aACV,IAAI,CAAC,GAAG,EAAE,CACT,KAAK,CAAC,CAAC;YACL,WAAW;iBACR,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,CAAC;iBAC/B,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,KAAK,CAAC;YACxB,CAAC,CAAC,WAAW,CAAC,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,CAAC,CAC9C,CACJ,CAAA;IACH,CAAC;IACD,OAAO,OAAO,CAAA;AAChB,CAAC,CAAA","sourcesContent":["import { hydrate } from '@vltpkg/dep-id'\nimport { PackageInfoClient } from '@vltpkg/package-info'\nimport { platformCheck } from '@vltpkg/pick-manifest'\nimport { RollbackRemove } from '@vltpkg/rollback-remove'\nimport { SpecOptions } from '@vltpkg/spec'\nimport { PathScurry } from 'path-scurry'\nimport { Diff } from '../diff.js'\nimport { optionalFail } from './optional-fail.js'\n\nexport const addNodes = (\n  diff: Diff,\n  scurry: PathScurry,\n  remover: RollbackRemove,\n  options: SpecOptions,\n  packageInfo: PackageInfoClient,\n): (() => Promise<unknown>)[] => {\n  const actions: (() => Promise<unknown>)[] = []\n  // fetch and extract all the nodes, removing any in the way\n  for (const node of diff.nodes.add) {\n    /* c8 ignore next - all nodes have manifests by this point */\n    const { manifest = {} } = node\n    // if it's not in the store, we don't have to extract it, because\n    // we're just linking to a location that already exists.\n    if (!node.inVltStore()) continue\n    // remove anything already there\n    const target = scurry.resolve(node.location)\n    const from = scurry.resolve('')\n    const spec = hydrate(node.id, manifest.name, options)\n    const onErr = optionalFail(diff, node)\n    // if it's optional, and we know it isn't for this platform, or it's\n    // deprecated, don't install it. if it's not optional, try our best.\n    if (\n      onErr &&\n      (manifest.deprecated ||\n        !platformCheck(\n          manifest,\n          process.version,\n          process.platform,\n          process.arch,\n        ))\n    ) {\n      onErr()\n      continue\n    }\n    actions.push(() =>\n      remover\n        .rm(target)\n        .then(() =>\n          onErr ?\n            packageInfo\n              .extract(spec, target, { from })\n              .then(x => x, onErr)\n          : packageInfo.extract(spec, target, { from }),\n        ),\n    )\n  }\n  return actions\n}\n"]}

package/dist/esm/reify/bin-paths.d.ts

@@ -0,0 +1,4 @@
+import { Manifest } from '@vltpkg/types';
+/** get the bin scripts for a package */
+export declare const binPaths: (manifest: Manifest) => Record<string, string>;
+//# sourceMappingURL=bin-paths.d.ts.map

package/dist/esm/reify/bin-paths.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bin-paths.d.ts","sourceRoot":"","sources":["../../../src/reify/bin-paths.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAA;AAUxC,wCAAwC;AACxC,eAAO,MAAM,QAAQ,aACT,QAAQ,KACjB,MAAM,CAAC,MAAM,EAAE,MAAM,CAYvB,CAAA"}

package/dist/esm/reify/bin-paths.js

@@ -0,0 +1,23 @@
+const parseScope = (scoped) => {
+    if (scoped.startsWith('@')) {
+        const [scope, name, ...rest] = scoped.split('/');
+        if (scope && name && rest.length === 0)
+            return [scope, name];
+    }
+    return [undefined, scoped];
+};
+/** get the bin scripts for a package */
+export const binPaths = (manifest) => {
+    const { name, bin } = manifest;
+    if (bin) {
+        if (name && typeof bin === 'string') {
+            const [_scope, pkg] = parseScope(name);
+            return { [pkg]: bin };
+        }
+        else if (typeof bin === 'object') {
+            return bin;
+        }
+    }
+    return {};
+};
+//# sourceMappingURL=bin-paths.js.map

package/dist/esm/reify/bin-paths.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bin-paths.js","sourceRoot":"","sources":["../../../src/reify/bin-paths.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,GAAG,CAAC,MAAc,EAAgC,EAAE;IAClE,IAAI,MAAM,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;QAC3B,MAAM,CAAC,KAAK,EAAE,IAAI,EAAE,GAAG,IAAI,CAAC,GAAG,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAA;QAChD,IAAI,KAAK,IAAI,IAAI,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,CAAC,KAAK,EAAE,IAAI,CAAC,CAAA;IAC9D,CAAC;IACD,OAAO,CAAC,SAAS,EAAE,MAAM,CAAC,CAAA;AAC5B,CAAC,CAAA;AAED,wCAAwC;AACxC,MAAM,CAAC,MAAM,QAAQ,GAAG,CACtB,QAAkB,EACM,EAAE;IAC1B,MAAM,EAAE,IAAI,EAAE,GAAG,EAAE,GAAG,QAAQ,CAAA;IAE9B,IAAI,GAAG,EAAE,CAAC;QACR,IAAI,IAAI,IAAI,OAAO,GAAG,KAAK,QAAQ,EAAE,CAAC;YACpC,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,UAAU,CAAC,IAAI,CAAC,CAAA;YACtC,OAAO,EAAE,CAAC,GAAG,CAAC,EAAE,GAAG,EAAE,CAAA;QACvB,CAAC;aAAM,IAAI,OAAO,GAAG,KAAK,QAAQ,EAAE,CAAC;YACnC,OAAO,GAAG,CAAA;QACZ,CAAC;IACH,CAAC;IACD,OAAO,EAAE,CAAA;AACX,CAAC,CAAA","sourcesContent":["import { Manifest } from '@vltpkg/types'\n\nconst parseScope = (scoped: string): [string | undefined, string] => {\n  if (scoped.startsWith('@')) {\n    const [scope, name, ...rest] = scoped.split('/')\n    if (scope && name && rest.length === 0) return [scope, name]\n  }\n  return [undefined, scoped]\n}\n\n/** get the bin scripts for a package */\nexport const binPaths = (\n  manifest: Manifest,\n): Record<string, string> => {\n  const { name, bin } = manifest\n\n  if (bin) {\n    if (name && typeof bin === 'string') {\n      const [_scope, pkg] = parseScope(name)\n      return { [pkg]: bin }\n    } else if (typeof bin === 'object') {\n      return bin\n    }\n  }\n  return {}\n}\n"]}

package/dist/esm/reify/build.d.ts

@@ -0,0 +1,5 @@
+import { PackageJson } from '@vltpkg/package-json';
+import { PathScurry } from 'path-scurry';
+import { Diff } from '../diff.js';
+export declare const build: (diff: Diff, packageJson: PackageJson, scurry: PathScurry) => Promise<void>;
+//# sourceMappingURL=build.d.ts.map

package/dist/esm/reify/build.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"build.d.ts","sourceRoot":"","sources":["../../../src/reify/build.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAA;AAKlD,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AACxC,OAAO,EAAE,IAAI,EAAE,MAAM,YAAY,CAAA;AAMjC,eAAO,MAAM,KAAK,SACV,IAAI,eACG,WAAW,UAChB,UAAU,kBAiCnB,CAAA"}

package/dist/esm/reify/build.js

@@ -0,0 +1,90 @@
+// walk the graph of added nodes, building and chmoding their bins
+// at the end, we get back to the importers, and run their prepare
+// script as well as install script.
+import { run } from '@vltpkg/run';
+import { statSync } from 'fs';
+import { chmod } from 'fs/promises';
+import { graphRun } from 'graph-run';
+import { nonEmptyList } from '../non-empty-list.js';
+import { binPaths } from './bin-paths.js';
+import { optionalFail } from './optional-fail.js';
+export const build = async (diff, packageJson, scurry) => {
+    const graph = diff.to;
+    const nodes = nonEmptyList([...graph.importers]);
+    /* c8 ignore next - all graphs have at least one importer */
+    if (!nodes)
+        return;
+    await graphRun({
+        graph: nodes,
+        visit: async (node, signal, path) => {
+            // if it's not an importer or an added node, nothing to do.
+            // TODO: only build importers if it has changed deps, there's never
+            // been a previous build, or it contains something newer than the
+            // most recent build.
+            // For now, just always build all importers, because we don't
+            // track all that other stuff.
+            if (!node.importer && !diff.nodes.add.has(node))
+                return;
+            await visit(packageJson, scurry, node, signal, path).then(x => x, optionalFail(diff, node));
+        },
+        getDeps: node => {
+            const deps = [];
+            for (const { to } of node.edgesOut.values()) {
+                /* c8 ignore next - vanishingly unlikely in practice */
+                if (to)
+                    deps.push(to);
+            }
+            return deps;
+        },
+    });
+};
+const visit = async (packageJson, scurry, node, signal, _path) => {
+    node.manifest ??= packageJson.read(scurry.resolve(node.location));
+    const { manifest } = node;
+    const { scripts = {} } = manifest;
+    const { install, preinstall, postinstall, prepare, preprepare, postprepare, } = scripts;
+    // if it has install script, run it
+    const runInstall = !!(install || preinstall || postinstall);
+    if (runInstall) {
+        await run({
+            signal,
+            arg0: 'install',
+            ignoreMissing: true,
+            packageJson,
+            cwd: node.location,
+            projectRoot: node.projectRoot,
+            manifest,
+        });
+    }
+    // if it's an importer or git, run prepare
+    const prepable = node.id.startsWith('git') || node.importer || !node.inVltStore();
+    const runPrepare = !!(prepare || preprepare || postprepare) && prepable;
+    if (runPrepare) {
+        await run({
+            signal,
+            arg0: 'prepare',
+            ignoreMissing: true,
+            packageJson,
+            cwd: node.location,
+            projectRoot: node.projectRoot,
+            manifest,
+        });
+    }
+    const chmods = [];
+    for (const bin of Object.values(binPaths(manifest))) {
+        const path = scurry.resolve(node.location, bin);
+        chmods.push(makeExecutable(path));
+    }
+    await Promise.all(chmods);
+};
+// 0 is "not yet set"
+// This is defined by doing `0o111 | <mode>` so that systems
+// that create files group-writable result in 0o775 instead of 0o755
+let execMode = 0;
+const makeExecutable = async (path) => {
+    if (!execMode) {
+        execMode = (statSync(path).mode & 0o777) | 0o111;
+    }
+    await chmod(path, execMode);
+};
+//# sourceMappingURL=build.js.map

package/dist/esm/reify/build.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"build.js","sourceRoot":"","sources":["../../../src/reify/build.ts"],"names":[],"mappings":"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","sourcesContent":["// walk the graph of added nodes, building and chmoding their bins\n// at the end, we get back to the importers, and run their prepare\n// script as well as install script.\n\nimport { PackageJson } from '@vltpkg/package-json'\nimport { run } from '@vltpkg/run'\nimport { statSync } from 'fs'\nimport { chmod } from 'fs/promises'\nimport { graphRun } from 'graph-run'\nimport { PathScurry } from 'path-scurry'\nimport { Diff } from '../diff.js'\nimport { Node } from '../node.js'\nimport { nonEmptyList } from '../non-empty-list.js'\nimport { binPaths } from './bin-paths.js'\nimport { optionalFail } from './optional-fail.js'\n\nexport const build = async (\n  diff: Diff,\n  packageJson: PackageJson,\n  scurry: PathScurry,\n) => {\n  const graph = diff.to\n  const nodes = nonEmptyList([...graph.importers])\n  /* c8 ignore next - all graphs have at least one importer */\n  if (!nodes) return\n\n  await graphRun<Node, unknown>({\n    graph: nodes,\n    visit: async (node: Node, signal, path) => {\n      // if it's not an importer or an added node, nothing to do.\n      // TODO: only build importers if it has changed deps, there's never\n      // been a previous build, or it contains something newer than the\n      // most recent build.\n      // For now, just always build all importers, because we don't\n      // track all that other stuff.\n      if (!node.importer && !diff.nodes.add.has(node)) return\n\n      await visit(packageJson, scurry, node, signal, path).then(\n        x => x,\n        optionalFail(diff, node),\n      )\n    },\n\n    getDeps: node => {\n      const deps: Node[] = []\n      for (const { to } of node.edgesOut.values()) {\n        /* c8 ignore next - vanishingly unlikely in practice */\n        if (to) deps.push(to)\n      }\n      return deps\n    },\n  })\n}\n\nconst visit = async (\n  packageJson: PackageJson,\n  scurry: PathScurry,\n  node: Node,\n  signal: AbortSignal,\n  _path: Node[],\n): Promise<void> => {\n  node.manifest ??= packageJson.read(scurry.resolve(node.location))\n  const { manifest } = node\n  const { scripts = {} } = manifest\n\n  const {\n    install,\n    preinstall,\n    postinstall,\n    prepare,\n    preprepare,\n    postprepare,\n  } = scripts\n\n  // if it has install script, run it\n  const runInstall = !!(install || preinstall || postinstall)\n  if (runInstall) {\n    await run({\n      signal,\n      arg0: 'install',\n      ignoreMissing: true,\n      packageJson,\n      cwd: node.location,\n      projectRoot: node.projectRoot,\n      manifest,\n    })\n  }\n\n  // if it's an importer or git, run prepare\n  const prepable =\n    node.id.startsWith('git') || node.importer || !node.inVltStore()\n  const runPrepare =\n    !!(prepare || preprepare || postprepare) && prepable\n\n  if (runPrepare) {\n    await run({\n      signal,\n      arg0: 'prepare',\n      ignoreMissing: true,\n      packageJson,\n      cwd: node.location,\n      projectRoot: node.projectRoot,\n      manifest,\n    })\n  }\n\n  const chmods: Promise<unknown>[] = []\n  for (const bin of Object.values(binPaths(manifest))) {\n    const path = scurry.resolve(node.location, bin)\n    chmods.push(makeExecutable(path))\n  }\n  await Promise.all(chmods)\n}\n\n// 0 is \"not yet set\"\n// This is defined by doing `0o111 | <mode>` so that systems\n// that create files group-writable result in 0o775 instead of 0o755\nlet execMode = 0\nconst makeExecutable = async (path: string) => {\n  if (!execMode) {\n    execMode = (statSync(path).mode & 0o777) | 0o111\n  }\n  await chmod(path, execMode)\n}\n"]}