plugins/ops-guards/hooks/junctions.mjs

Functions

Imports

It imports no other module of this repo. No module of this repo imports it.

Source

1// The node_modules link probe, as a command (a hooks module cannot read the disk).
2//
3//   node junctions.mjs <target>   prints {"link": "<first node_modules link>" | null}
4//
5// It walks the target with lstat and never follows a link, so the path goes to no
6// shell: a target holding `&` or quotes is only ever a file name here. Node reports a
7// Windows junction as a symbolic link, the same way `dir /AL` lists it.
8import { lstatSync, readdirSync } from 'node:fs'
9import { basename, join } from 'node:path'
10import { pathToFileURL } from 'node:url'
11
12const isNodeModules = (name) => name.toLowerCase() === 'node_modules'
13
14export function findNodeModulesLink(target) {
15  let st
16  try {
17    st = lstatSync(target)
18  } catch {
19    return null
20  }
21  if (st.isSymbolicLink()) return isNodeModules(basename(target)) ? target : null
22  if (!st.isDirectory()) return null
23  const stack = [target]
24  while (stack.length) {
25    const dir = stack.pop()
26    for (const entry of readdirSync(dir, { withFileTypes: true })) {
27      const p = join(dir, entry.name)
28      if (entry.isSymbolicLink()) {
29        if (isNodeModules(entry.name)) return p
30      } else if (entry.isDirectory()) {
31        stack.push(p)
32      }
33    }
34  }
35  return null
36}
37
38if (process.argv[1] && import.meta.url === pathToFileURL(process.argv[1]).href) {
39  console.log(JSON.stringify({ link: findNodeModulesLink(process.argv[2]) }))
40}