feat: add default-packages file support for fnm install

.changeset/shy-otters-install.md

@@ -0,0 +1,6 @@
+---
+"fnm": minor
+---
+
+Added support for `default-packages` file. When present at `$FNM_DIR/default-packages`, packages listed in this file are automatically installed globally after every `fnm install`. Compatible with nvm's default-packages format.
+

docs/commands.md

@@ -270,6 +270,9 @@ Options:
 
           [env: FNM_ARCH]
 
+      --reinstall-packages-from <version>
+          Reinstall global packages from a specified Node version after installing. Analogous to nvm's --reinstall-packages-from flag
+
       --version-file-strategy <VERSION_FILE_STRATEGY>
           A strategy for how to resolve the Node version. Used whenever `fnm use` or `fnm install` is called without a version, or when `--use-on-cd` is configured on evaluation
 
@@ -414,6 +417,10 @@ Options:
       --use-on-cd
           Print the script to change Node versions every directory change
 
+          When entering a directory with a version file, fnm switches to that version. When entering a directory without a version file, fnm switches to the default version.
+
+          This applies to both `local` and `recursive` version file strategies.
+
       --arch <ARCH>
           Override the architecture of the installed Node binary. Defaults to arch of fnm binary
 

docs/configuration.md

@@ -52,6 +52,14 @@ error: Can't find version in dotfiles. Please provide a version manually to the
 
 Runs [`corepack enable`](https://nodejs.org/api/corepack.html#enabling-the-feature) when a new version of Node.js is installed. Experimental due to the fact Corepack itself is experimental.
 
+### `default-packages` file
+
+When present at `$FNM_DIR/default-packages` (or `~/.local/share/fnm/default-packages`), fnm will automatically install packages listed in this file globally after every `fnm install` by running `npm install -g`.
+
+The file format is one package spec per line (supports `@version`), and lines starting with `#` are ignored.
+
+This is compatible with nvm's `default-packages` format.
+
 ### `--resolve-engines`
 
 **🧪 Experimental**

e2e/__snapshots__/default-packages.test.ts.snap

@@ -0,0 +1,27 @@
+// Jest Snapshot v1, https://goo.gl/fbAQLP
+
+exports[`Bash installs default packages: Bash 1`] = `
+"set -e
+eval "$(fnm env)"
+fnm install 18
+(fnm exec --using=18 npm list -g --depth=0) | grep 'is-odd' || (echo "Expected output to contain 'is-odd'" && exit 1)"
+`;
+
+exports[`Bash missing default-packages file does not error: Bash 1`] = `
+"set -e
+eval "$(fnm env)"
+fnm install 18"
+`;
+
+exports[`PowerShell installs default packages: PowerShell 1`] = `
+"$ErrorActionPreference = "Stop"
+fnm env | Out-String | Invoke-Expression
+fnm install 18
+$($__out__ = $(fnm exec --using=18 npm list -g --depth=0 | Select-String 'is-odd'); if ($__out__ -eq $null) { exit 1 } else { $__out__ })"
+`;
+
+exports[`PowerShell missing default-packages file does not error: PowerShell 1`] = `
+"$ErrorActionPreference = "Stop"
+fnm env | Out-String | Invoke-Expression
+fnm install 18"
+`;

e2e/default-packages.test.ts

@@ -0,0 +1,44 @@
+import fs from "fs"
+import path from "path"
+import { script } from "./shellcode/script.js"
+import { Bash, PowerShell } from "./shellcode/shells.js"
+import describe from "./describe.js"
+import testTmpDir from "./shellcode/test-tmp-dir.js"
+
+for (const shell of [Bash, PowerShell]) {
+  describe(shell, () => {
+    test(`installs default packages`, async () => {
+      const fnmDir = path.join(testTmpDir(), "fnm")
+      fs.mkdirSync(fnmDir, { recursive: true })
+      fs.writeFileSync(path.join(fnmDir, "default-packages"), "is-odd\n")
+
+      await script(shell)
+        .then(shell.env({}))
+        .then(shell.call("fnm", ["install", "18"]))
+        .then(
+          shell.scriptOutputContains(
+            shell.call("fnm", [
+              "exec",
+              "--using=18",
+              "npm",
+              "list",
+              "-g",
+              "--depth=0",
+            ]),
+            "'is-odd'"
+          )
+        )
+        .takeSnapshot(shell)
+        .execute(shell)
+    })
+
+    test(`missing default-packages file does not error`, async () => {
+      await script(shell)
+        .then(shell.env({}))
+        .then(shell.call("fnm", ["install", "18"]))
+        .takeSnapshot(shell)
+        .execute(shell)
+    })
+  })
+}
+

src/commands/install.rs

@@ -172,6 +172,8 @@ impl Command for Install {
             enable_corepack(&version, config)?;
         }
 
+        install_default_packages(&version, config)?;
+
         if use_installed {
             use_installed_version(&version, config)?;
         }
@@ -205,6 +207,55 @@ fn enable_corepack(version: &Version, config: &FnmConfig) -> Result<(), Error> {
     Ok(())
 }
 
+fn parse_default_packages_file(file_path: &std::path::Path) -> Result<Vec<String>, std::io::Error> {
+    let contents = match std::fs::read_to_string(file_path) {
+        Ok(contents) => contents,
+        Err(err) if err.kind() == std::io::ErrorKind::NotFound => return Ok(vec![]),
+        Err(err) => return Err(err),
+    };
+
+    Ok(contents
+        .lines()
+        .filter_map(|line| {
+            let trimmed = line.trim();
+            if trimmed.is_empty() || trimmed.starts_with('#') {
+                None
+            } else {
+                Some(trimmed.to_string())
+            }
+        })
+        .collect())
+}
+
+fn install_default_packages(version: &Version, config: &FnmConfig) -> Result<(), Error> {
+    let packages = parse_default_packages_file(&config.default_packages_file())?;
+    if packages.is_empty() {
+        return Ok(());
+    }
+
+    let npm_path = version.installation_path(config);
+    let npm_path = if cfg!(windows) {
+        npm_path.join("npm.cmd")
+    } else {
+        npm_path.join("bin").join("npm")
+    };
+
+    let mut args: Vec<&str> = Vec::with_capacity(2 + packages.len());
+    args.push("install");
+    args.push("--global");
+    for package_spec in &packages {
+        for arg in package_spec.split_whitespace() {
+            args.push(arg);
+        }
+    }
+
+    super::exec::Exec::new_for_version(version, npm_path.to_str().unwrap(), &args)
+        .apply(config)
+        .map_err(|source| Error::DefaultPackagesError { source })?;
+
+    Ok(())
+}
+
 fn use_installed_version(version: &Version, config: &FnmConfig) -> Result<(), Error> {
     Use {
         version: Some(UserVersionReader::Direct(UserVersion::Full(
@@ -235,6 +286,8 @@ pub enum Error {
         source: super::exec::Error,
     },
     #[error(transparent)]
+    DefaultPackagesError { source: super::exec::Error },
+    #[error(transparent)]
     UseError {
         source: Box<<Use as Command>::Error>,
     },
@@ -319,4 +372,40 @@ mod tests {
             .unwrap()
             .exists());
     }
+
+    #[test]
+    fn test_parse_default_packages_file() {
+        let base_dir = tempfile::tempdir().unwrap();
+        let file_path = base_dir.path().join("default-packages");
+        std::fs::write(
+            &file_path,
+            r"
+# this is a comment
+
+typescript
+prettier@3
+@scope/name
+",
+        )
+        .unwrap();
+
+        let packages = parse_default_packages_file(&file_path).unwrap();
+        assert_eq!(
+            packages,
+            vec![
+                "typescript".to_string(),
+                "prettier@3".to_string(),
+                "@scope/name".to_string(),
+            ]
+        );
+    }
+
+    #[test]
+    fn test_parse_default_packages_file_missing() {
+        let base_dir = tempfile::tempdir().unwrap();
+        let file_path = base_dir.path().join("default-packages");
+
+        let packages = parse_default_packages_file(&file_path).unwrap();
+        assert_eq!(packages, Vec::<String>::new());
+    }
 }

src/config.rs

@@ -164,6 +164,10 @@ impl FnmConfig {
             .ensure_exists_silently()
     }
 
+    pub fn default_packages_file(&self) -> std::path::PathBuf {
+        self.base_dir_with_default().join("default-packages")
+    }
+
     pub fn multishell_storage(&self) -> std::path::PathBuf {
         self.directories.multishell_storage()
     }