node_runtime.rs

  1use anyhow::{Context as _, Result, anyhow, bail};
  2use async_compression::futures::bufread::GzipDecoder;
  3use async_tar::Archive;
  4use futures::{AsyncReadExt, FutureExt as _, channel::oneshot, future::Shared};
  5use http_client::{HttpClient, Url};
  6use log::Level;
  7use semver::Version;
  8use serde::Deserialize;
  9use smol::io::BufReader;
 10use smol::{fs, lock::Mutex};
 11use std::fmt::Display;
 12use std::{
 13    env::{self, consts},
 14    ffi::OsString,
 15    io,
 16    path::{Path, PathBuf},
 17    process::Output,
 18    sync::Arc,
 19};
 20use util::ResultExt;
 21use util::archive::extract_zip;
 22use util::paths::{SanitizedPath, SanitizedPathBuf};
 23
 24const NODE_CA_CERTS_ENV_VAR: &str = "NODE_EXTRA_CA_CERTS";
 25
 26#[derive(Clone, Debug, Default, Eq, PartialEq)]
 27pub struct NodeBinaryOptions {
 28    pub allow_path_lookup: bool,
 29    pub allow_binary_download: bool,
 30    pub use_paths: Option<(PathBuf, PathBuf)>,
 31}
 32
 33pub enum VersionStrategy<'a> {
 34    /// Install if current version doesn't match pinned version
 35    Pin(&'a str),
 36    /// Install if current version is older than latest version
 37    Latest(&'a str),
 38}
 39
 40#[derive(Clone)]
 41pub struct NodeRuntime(Arc<Mutex<NodeRuntimeState>>);
 42
 43struct NodeRuntimeState {
 44    http: Arc<dyn HttpClient>,
 45    instance: Option<Box<dyn NodeRuntimeTrait>>,
 46    last_options: Option<NodeBinaryOptions>,
 47    options: watch::Receiver<Option<NodeBinaryOptions>>,
 48    shell_env_loaded: Shared<oneshot::Receiver<()>>,
 49}
 50
 51impl NodeRuntime {
 52    pub fn new(
 53        http: Arc<dyn HttpClient>,
 54        shell_env_loaded: Option<oneshot::Receiver<()>>,
 55        options: watch::Receiver<Option<NodeBinaryOptions>>,
 56    ) -> Self {
 57        NodeRuntime(Arc::new(Mutex::new(NodeRuntimeState {
 58            http,
 59            instance: None,
 60            last_options: None,
 61            options,
 62            shell_env_loaded: shell_env_loaded.unwrap_or(oneshot::channel().1).shared(),
 63        })))
 64    }
 65
 66    pub fn unavailable() -> Self {
 67        NodeRuntime(Arc::new(Mutex::new(NodeRuntimeState {
 68            http: Arc::new(http_client::BlockedHttpClient),
 69            instance: None,
 70            last_options: None,
 71            options: watch::channel(Some(NodeBinaryOptions::default())).1,
 72            shell_env_loaded: oneshot::channel().1.shared(),
 73        })))
 74    }
 75
 76    async fn instance(&self) -> Box<dyn NodeRuntimeTrait> {
 77        let mut state = self.0.lock().await;
 78
 79        let options = loop {
 80            if let Some(options) = state.options.borrow().as_ref() {
 81                break options.clone();
 82            }
 83            match state.options.changed().await {
 84                Ok(()) => {}
 85                // failure case not cached
 86                Err(err) => {
 87                    return Box::new(UnavailableNodeRuntime {
 88                        error_message: err.to_string().into(),
 89                    });
 90                }
 91            }
 92        };
 93
 94        if state.last_options.as_ref() != Some(&options) {
 95            state.instance.take();
 96        }
 97        if let Some(instance) = state.instance.as_ref() {
 98            return instance.boxed_clone();
 99        }
100
101        if let Some((node, npm)) = options.use_paths.as_ref() {
102            let instance = match SystemNodeRuntime::new(node.clone(), npm.clone()).await {
103                Ok(instance) => {
104                    log::info!("using Node.js from `node.path` in settings: {:?}", instance);
105                    Box::new(instance)
106                }
107                Err(err) => {
108                    // failure case not cached, since it's cheap to check again
109                    return Box::new(UnavailableNodeRuntime {
110                        error_message: format!(
111                            "failure checking Node.js from `node.path` in settings ({}): {:?}",
112                            node.display(),
113                            err
114                        )
115                        .into(),
116                    });
117                }
118            };
119            state.instance = Some(instance.boxed_clone());
120            state.last_options = Some(options);
121            return instance;
122        }
123
124        let system_node_error = if options.allow_path_lookup {
125            state.shell_env_loaded.clone().await.ok();
126            match SystemNodeRuntime::detect().await {
127                Ok(instance) => {
128                    log::info!("using Node.js found on PATH: {:?}", instance);
129                    state.instance = Some(instance.boxed_clone());
130                    state.last_options = Some(options);
131                    return Box::new(instance);
132                }
133                Err(err) => Some(err),
134            }
135        } else {
136            None
137        };
138
139        let instance = if options.allow_binary_download {
140            let (log_level, why_using_managed) = match system_node_error {
141                Some(err @ DetectError::Other(_)) => (Level::Warn, err.to_string()),
142                Some(err @ DetectError::NotInPath(_)) => (Level::Info, err.to_string()),
143                None => (
144                    Level::Info,
145                    "`node.ignore_system_version` is `true` in settings".to_string(),
146                ),
147            };
148            match ManagedNodeRuntime::install_if_needed(&state.http).await {
149                Ok(instance) => {
150                    log::log!(
151                        log_level,
152                        "using Zed managed Node.js at {} since {}",
153                        instance.installation_path.display(),
154                        why_using_managed
155                    );
156                    Box::new(instance) as Box<dyn NodeRuntimeTrait>
157                }
158                Err(err) => {
159                    // failure case is cached, since downloading + installing may be expensive. The
160                    // downside of this is that it may fail due to an intermittent network issue.
161                    //
162                    // TODO: Have `install_if_needed` indicate which failure cases are retryable
163                    // and/or have shared tracking of when internet is available.
164                    Box::new(UnavailableNodeRuntime {
165                        error_message: format!(
166                            "failure while downloading and/or installing Zed managed Node.js, \
167                            restart Zed to retry: {}",
168                            err
169                        )
170                        .into(),
171                    }) as Box<dyn NodeRuntimeTrait>
172                }
173            }
174        } else if let Some(system_node_error) = system_node_error {
175            // failure case not cached, since it's cheap to check again
176            //
177            // TODO: When support is added for setting `options.allow_binary_download`, update this
178            // error message.
179            return Box::new(UnavailableNodeRuntime {
180                error_message: format!(
181                    "failure while checking system Node.js from PATH: {}",
182                    system_node_error
183                )
184                .into(),
185            });
186        } else {
187            // failure case is cached because it will always happen with these options
188            //
189            // TODO: When support is added for setting `options.allow_binary_download`, update this
190            // error message.
191            Box::new(UnavailableNodeRuntime {
192                error_message: "`node` settings do not allow any way to use Node.js"
193                    .to_string()
194                    .into(),
195            })
196        };
197
198        state.instance = Some(instance.boxed_clone());
199        state.last_options = Some(options);
200        instance
201    }
202
203    pub async fn binary_path(&self) -> Result<PathBuf> {
204        self.instance().await.binary_path()
205    }
206
207    pub async fn run_npm_subcommand(
208        &self,
209        directory: &Path,
210        subcommand: &str,
211        args: &[&str],
212    ) -> Result<Output> {
213        let http = self.0.lock().await.http.clone();
214        self.instance()
215            .await
216            .run_npm_subcommand(Some(directory), http.proxy(), subcommand, args)
217            .await
218    }
219
220    pub async fn npm_package_installed_version(
221        &self,
222        local_package_directory: &Path,
223        name: &str,
224    ) -> Result<Option<String>> {
225        self.instance()
226            .await
227            .npm_package_installed_version(local_package_directory, name)
228            .await
229    }
230
231    pub async fn npm_package_latest_version(&self, name: &str) -> Result<String> {
232        let http = self.0.lock().await.http.clone();
233        let output = self
234            .instance()
235            .await
236            .run_npm_subcommand(
237                None,
238                http.proxy(),
239                "info",
240                &[
241                    name,
242                    "--json",
243                    "--fetch-retry-mintimeout",
244                    "2000",
245                    "--fetch-retry-maxtimeout",
246                    "5000",
247                    "--fetch-timeout",
248                    "5000",
249                ],
250            )
251            .await?;
252
253        let mut info: NpmInfo = serde_json::from_slice(&output.stdout)?;
254        info.dist_tags
255            .latest
256            .or_else(|| info.versions.pop())
257            .with_context(|| format!("no version found for npm package {name}"))
258    }
259
260    pub async fn npm_install_packages(
261        &self,
262        directory: &Path,
263        packages: &[(&str, &str)],
264    ) -> Result<()> {
265        if packages.is_empty() {
266            return Ok(());
267        }
268
269        let packages: Vec<_> = packages
270            .iter()
271            .map(|(name, version)| format!("{name}@{version}"))
272            .collect();
273
274        let mut arguments: Vec<_> = packages.iter().map(|p| p.as_str()).collect();
275        arguments.extend_from_slice(&[
276            "--save-exact",
277            "--fetch-retry-mintimeout",
278            "2000",
279            "--fetch-retry-maxtimeout",
280            "5000",
281            "--fetch-timeout",
282            "5000",
283        ]);
284
285        // This is also wrong because the directory is wrong.
286        self.run_npm_subcommand(directory, "install", &arguments)
287            .await?;
288        Ok(())
289    }
290
291    pub async fn should_install_npm_package(
292        &self,
293        package_name: &str,
294        local_executable_path: &Path,
295        local_package_directory: &Path,
296        version_strategy: VersionStrategy<'_>,
297    ) -> bool {
298        // In the case of the local system not having the package installed,
299        // or in the instances where we fail to parse package.json data,
300        // we attempt to install the package.
301        if fs::metadata(local_executable_path).await.is_err() {
302            return true;
303        }
304
305        let Some(installed_version) = self
306            .npm_package_installed_version(local_package_directory, package_name)
307            .await
308            .log_err()
309            .flatten()
310        else {
311            return true;
312        };
313
314        let Some(installed_version) = Version::parse(&installed_version).log_err() else {
315            return true;
316        };
317
318        match version_strategy {
319            VersionStrategy::Pin(pinned_version) => {
320                let Some(pinned_version) = Version::parse(pinned_version).log_err() else {
321                    return true;
322                };
323                installed_version != pinned_version
324            }
325            VersionStrategy::Latest(latest_version) => {
326                let Some(latest_version) = Version::parse(latest_version).log_err() else {
327                    return true;
328                };
329                installed_version < latest_version
330            }
331        }
332    }
333}
334
335enum ArchiveType {
336    TarGz,
337    Zip,
338}
339
340#[derive(Debug, Deserialize)]
341#[serde(rename_all = "kebab-case")]
342pub struct NpmInfo {
343    #[serde(default)]
344    dist_tags: NpmInfoDistTags,
345    versions: Vec<String>,
346}
347
348#[derive(Debug, Deserialize, Default)]
349pub struct NpmInfoDistTags {
350    latest: Option<String>,
351}
352
353#[async_trait::async_trait]
354trait NodeRuntimeTrait: Send + Sync {
355    fn boxed_clone(&self) -> Box<dyn NodeRuntimeTrait>;
356    fn binary_path(&self) -> Result<PathBuf>;
357
358    async fn run_npm_subcommand(
359        &self,
360        directory: Option<&Path>,
361        proxy: Option<&Url>,
362        subcommand: &str,
363        args: &[&str],
364    ) -> Result<Output>;
365
366    async fn npm_package_installed_version(
367        &self,
368        local_package_directory: &Path,
369        name: &str,
370    ) -> Result<Option<String>>;
371}
372
373#[derive(Clone)]
374struct ManagedNodeRuntime {
375    installation_path: SanitizedPathBuf,
376}
377
378impl ManagedNodeRuntime {
379    const VERSION: &str = "v22.5.1";
380
381    #[cfg(not(windows))]
382    const NODE_PATH: &str = "bin/node";
383    #[cfg(windows)]
384    const NODE_PATH: &str = "node.exe";
385
386    #[cfg(not(windows))]
387    const NPM_PATH: &str = "bin/npm";
388    #[cfg(windows)]
389    const NPM_PATH: &str = "node_modules/npm/bin/npm-cli.js";
390
391    async fn install_if_needed(http: &Arc<dyn HttpClient>) -> Result<Self> {
392        log::info!("Node runtime install_if_needed");
393
394        let os = match consts::OS {
395            "macos" => "darwin",
396            "linux" => "linux",
397            "windows" => "win",
398            other => bail!("Running on unsupported os: {other}"),
399        };
400
401        let arch = match consts::ARCH {
402            "x86_64" => "x64",
403            "aarch64" => "arm64",
404            other => bail!("Running on unsupported architecture: {other}"),
405        };
406
407        let version = Self::VERSION;
408        let folder_name = format!("node-{version}-{os}-{arch}");
409        let node_containing_dir = paths::data_dir().join("node");
410        let node_dir = node_containing_dir.join(folder_name);
411        let node_binary = node_dir.join(Self::NODE_PATH);
412        let npm_file = node_dir.join(Self::NPM_PATH);
413        let node_ca_certs = env::var(NODE_CA_CERTS_ENV_VAR).unwrap_or_else(|_| String::new());
414
415        let valid = if fs::metadata(&node_binary).await.is_ok() {
416            let result = util::command::new_smol_command(&node_binary)
417                .env_clear()
418                .env(NODE_CA_CERTS_ENV_VAR, node_ca_certs)
419                .arg(npm_file)
420                .arg("--version")
421                .args(["--cache".into(), node_dir.join("cache")])
422                .args(["--userconfig".into(), node_dir.join("blank_user_npmrc")])
423                .args(["--globalconfig".into(), node_dir.join("blank_global_npmrc")])
424                .output()
425                .await;
426            match result {
427                Ok(output) => {
428                    if output.status.success() {
429                        true
430                    } else {
431                        log::warn!(
432                            "Zed managed Node.js binary at {} failed check with output: {:?}",
433                            node_binary.display(),
434                            output
435                        );
436                        false
437                    }
438                }
439                Err(err) => {
440                    log::warn!(
441                        "Zed managed Node.js binary at {} failed check, so re-downloading it. \
442                        Error: {}",
443                        node_binary.display(),
444                        err
445                    );
446                    false
447                }
448            }
449        } else {
450            false
451        };
452
453        if !valid {
454            _ = fs::remove_dir_all(&node_containing_dir).await;
455            fs::create_dir(&node_containing_dir)
456                .await
457                .context("error creating node containing dir")?;
458
459            let archive_type = match consts::OS {
460                "macos" | "linux" => ArchiveType::TarGz,
461                "windows" => ArchiveType::Zip,
462                other => bail!("Running on unsupported os: {other}"),
463            };
464
465            let version = Self::VERSION;
466            let file_name = format!(
467                "node-{version}-{os}-{arch}.{extension}",
468                extension = match archive_type {
469                    ArchiveType::TarGz => "tar.gz",
470                    ArchiveType::Zip => "zip",
471                }
472            );
473
474            let url = format!("https://nodejs.org/dist/{version}/{file_name}");
475            log::info!("Downloading Node.js binary from {url}");
476            let mut response = http
477                .get(&url, Default::default(), true)
478                .await
479                .context("error downloading Node binary tarball")?;
480            log::info!("Download of Node.js complete, extracting...");
481
482            let body = response.body_mut();
483            match archive_type {
484                ArchiveType::TarGz => {
485                    let decompressed_bytes = GzipDecoder::new(BufReader::new(response.body_mut()));
486                    let archive = Archive::new(decompressed_bytes);
487                    archive
488                        .unpack(node_containing_dir.as_path().as_path())
489                        .await?;
490                }
491                ArchiveType::Zip => {
492                    extract_zip(node_containing_dir.as_path().as_path(), body).await?
493                }
494            }
495            log::info!("Extracted Node.js to {}", node_containing_dir.display())
496        }
497
498        // Note: Not in the `if !valid {}` so we can populate these for existing installations
499        _ = fs::create_dir(node_dir.join("cache")).await;
500        _ = fs::write(node_dir.join("blank_user_npmrc"), []).await;
501        _ = fs::write(node_dir.join("blank_global_npmrc"), []).await;
502
503        anyhow::Ok(ManagedNodeRuntime {
504            installation_path: node_dir,
505        })
506    }
507}
508
509fn path_with_node_binary_prepended(node_binary: &SanitizedPath) -> Option<OsString> {
510    let existing_path = env::var_os("PATH");
511    let node_bin_dir = node_binary.parent().map(|dir| dir.as_os_str());
512    match (existing_path, node_bin_dir) {
513        (Some(existing_path), Some(node_bin_dir)) => {
514            if let Ok(joined) = env::join_paths(
515                [PathBuf::from(node_bin_dir)]
516                    .into_iter()
517                    .chain(env::split_paths(&existing_path)),
518            ) {
519                Some(joined)
520            } else {
521                Some(existing_path)
522            }
523        }
524        (Some(existing_path), None) => Some(existing_path),
525        (None, Some(node_bin_dir)) => Some(node_bin_dir.to_owned()),
526        _ => None,
527    }
528}
529
530#[async_trait::async_trait]
531impl NodeRuntimeTrait for ManagedNodeRuntime {
532    fn boxed_clone(&self) -> Box<dyn NodeRuntimeTrait> {
533        Box::new(self.clone())
534    }
535
536    fn binary_path(&self) -> Result<PathBuf> {
537        Ok(self.installation_path.join(Self::NODE_PATH))
538    }
539
540    async fn run_npm_subcommand(
541        &self,
542        directory: Option<&Path>,
543        proxy: Option<&Url>,
544        subcommand: &str,
545        args: &[&str],
546    ) -> Result<Output> {
547        let attempt = || async move {
548            let node_binary = self.installation_path.join(Self::NODE_PATH);
549            let npm_file = self.installation_path.join(Self::NPM_PATH);
550            let env_path = path_with_node_binary_prepended(&node_binary).unwrap_or_default();
551
552            anyhow::ensure!(
553                smol::fs::metadata(&node_binary).await.is_ok(),
554                "missing node binary file"
555            );
556            anyhow::ensure!(
557                smol::fs::metadata(&npm_file).await.is_ok(),
558                "missing npm file"
559            );
560
561            let node_ca_certs = env::var(NODE_CA_CERTS_ENV_VAR).unwrap_or_else(|_| String::new());
562
563            let mut command = util::command::new_smol_command(node_binary);
564            command.env_clear();
565            command.env("PATH", env_path);
566            command.env(NODE_CA_CERTS_ENV_VAR, node_ca_certs);
567            command.arg(npm_file).arg(subcommand);
568            command.args(["--cache".into(), self.installation_path.join("cache")]);
569            command.args([
570                "--userconfig".into(),
571                self.installation_path.join("blank_user_npmrc"),
572            ]);
573            command.args([
574                "--globalconfig".into(),
575                self.installation_path.join("blank_global_npmrc"),
576            ]);
577            command.args(args);
578            configure_npm_command(&mut command, directory, proxy);
579            command.output().await.map_err(|e| anyhow!("{e}"))
580        };
581
582        let mut output = attempt().await;
583        if output.is_err() {
584            output = attempt().await;
585            anyhow::ensure!(
586                output.is_ok(),
587                "failed to launch npm subcommand {subcommand} subcommand\nerr: {:?}",
588                output.err()
589            );
590        }
591
592        if let Ok(output) = &output {
593            anyhow::ensure!(
594                output.status.success(),
595                "failed to execute npm {subcommand} subcommand:\nstdout: {:?}\nstderr: {:?}",
596                String::from_utf8_lossy(&output.stdout),
597                String::from_utf8_lossy(&output.stderr)
598            );
599        }
600
601        output.map_err(|e| anyhow!("{e}"))
602    }
603    async fn npm_package_installed_version(
604        &self,
605        local_package_directory: &Path,
606        name: &str,
607    ) -> Result<Option<String>> {
608        read_package_installed_version(local_package_directory.join("node_modules"), name).await
609    }
610}
611
612#[derive(Debug, Clone)]
613pub struct SystemNodeRuntime {
614    node: SanitizedPathBuf,
615    npm: SanitizedPathBuf,
616    global_node_modules: SanitizedPathBuf,
617    scratch_dir: SanitizedPathBuf,
618}
619
620impl SystemNodeRuntime {
621    const MIN_VERSION: semver::Version = Version::new(20, 0, 0);
622    async fn new(node: SanitizedPathBuf, npm: SanitizedPathBuf) -> Result<Self> {
623        let output = util::command::new_smol_command(&node)
624            .arg("--version")
625            .output()
626            .await
627            .with_context(|| format!("running node from {:?}", node))?;
628        if !output.status.success() {
629            anyhow::bail!(
630                "failed to run node --version. stdout: {}, stderr: {}",
631                String::from_utf8_lossy(&output.stdout),
632                String::from_utf8_lossy(&output.stderr),
633            );
634        }
635        let version_str = String::from_utf8_lossy(&output.stdout);
636        let version = semver::Version::parse(version_str.trim().trim_start_matches('v'))?;
637        if version < Self::MIN_VERSION {
638            anyhow::bail!(
639                "node at {} is too old. want: {}, got: {}",
640                node.to_string_lossy(),
641                Self::MIN_VERSION,
642                version
643            )
644        }
645
646        let scratch_dir = paths::data_dir().join("node");
647        fs::create_dir(&scratch_dir).await.ok();
648        fs::create_dir(scratch_dir.join("cache")).await.ok();
649
650        let mut this = Self {
651            node,
652            npm,
653            global_node_modules: SanitizedPathBuf::default(),
654            scratch_dir,
655        };
656        let output = this.run_npm_subcommand(None, None, "root", &["-g"]).await?;
657        this.global_node_modules =
658            PathBuf::from(String::from_utf8_lossy(&output.stdout).to_string()).into();
659
660        Ok(this)
661    }
662
663    async fn detect() -> std::result::Result<Self, DetectError> {
664        let node = which::which("node").map_err(DetectError::NotInPath)?.into();
665        let npm = which::which("npm").map_err(DetectError::NotInPath)?.into();
666        Self::new(node, npm).await.map_err(DetectError::Other)
667    }
668}
669
670enum DetectError {
671    NotInPath(which::Error),
672    Other(anyhow::Error),
673}
674
675impl Display for DetectError {
676    fn fmt(&self, f: &mut std::fmt::Formatter<'_>) -> std::fmt::Result {
677        match self {
678            DetectError::NotInPath(err) => {
679                write!(f, "system Node.js wasn't found on PATH: {}", err)
680            }
681            DetectError::Other(err) => {
682                write!(f, "checking system Node.js failed with error: {}", err)
683            }
684        }
685    }
686}
687
688#[async_trait::async_trait]
689impl NodeRuntimeTrait for SystemNodeRuntime {
690    fn boxed_clone(&self) -> Box<dyn NodeRuntimeTrait> {
691        Box::new(self.clone())
692    }
693
694    fn binary_path(&self) -> Result<PathBuf> {
695        Ok(self.node.clone())
696    }
697
698    async fn run_npm_subcommand(
699        &self,
700        directory: Option<&Path>,
701        proxy: Option<&Url>,
702        subcommand: &str,
703        args: &[&str],
704    ) -> anyhow::Result<Output> {
705        let node_ca_certs = env::var(NODE_CA_CERTS_ENV_VAR).unwrap_or_else(|_| String::new());
706        let mut command = util::command::new_smol_command(self.npm.clone());
707        let path = path_with_node_binary_prepended(&self.node).unwrap_or_default();
708        command
709            .env_clear()
710            .env("PATH", path)
711            .env(NODE_CA_CERTS_ENV_VAR, node_ca_certs)
712            .arg(subcommand)
713            .args(["--cache".into(), self.scratch_dir.join("cache")])
714            .args(args);
715        configure_npm_command(&mut command, directory, proxy);
716        let output = command.output().await?;
717        anyhow::ensure!(
718            output.status.success(),
719            "failed to execute npm {subcommand} subcommand:\nstdout: {:?}\nstderr: {:?}",
720            String::from_utf8_lossy(&output.stdout),
721            String::from_utf8_lossy(&output.stderr)
722        );
723        Ok(output)
724    }
725
726    async fn npm_package_installed_version(
727        &self,
728        local_package_directory: &Path,
729        name: &str,
730    ) -> Result<Option<String>> {
731        read_package_installed_version(local_package_directory.join("node_modules"), name).await
732        // todo: allow returning a globally installed version (requires callers not to hard-code the path)
733    }
734}
735
736pub async fn read_package_installed_version(
737    node_module_directory: PathBuf,
738    name: &str,
739) -> Result<Option<String>> {
740    let package_json_path = node_module_directory.join(name).join("package.json");
741
742    let mut file = match fs::File::open(package_json_path).await {
743        Ok(file) => file,
744        Err(err) => {
745            if err.kind() == io::ErrorKind::NotFound {
746                return Ok(None);
747            }
748
749            Err(err)?
750        }
751    };
752
753    #[derive(Deserialize)]
754    struct PackageJson {
755        version: String,
756    }
757
758    let mut contents = String::new();
759    file.read_to_string(&mut contents).await?;
760    let package_json: PackageJson = serde_json::from_str(&contents)?;
761    Ok(Some(package_json.version))
762}
763
764#[derive(Clone)]
765pub struct UnavailableNodeRuntime {
766    error_message: Arc<String>,
767}
768
769#[async_trait::async_trait]
770impl NodeRuntimeTrait for UnavailableNodeRuntime {
771    fn boxed_clone(&self) -> Box<dyn NodeRuntimeTrait> {
772        Box::new(self.clone())
773    }
774    fn binary_path(&self) -> Result<PathBuf> {
775        bail!("{}", self.error_message)
776    }
777
778    async fn run_npm_subcommand(
779        &self,
780        _: Option<&Path>,
781        _: Option<&Url>,
782        _: &str,
783        _: &[&str],
784    ) -> anyhow::Result<Output> {
785        bail!("{}", self.error_message)
786    }
787
788    async fn npm_package_installed_version(
789        &self,
790        _local_package_directory: &Path,
791        _: &str,
792    ) -> Result<Option<String>> {
793        bail!("{}", self.error_message)
794    }
795}
796
797fn configure_npm_command(
798    command: &mut smol::process::Command,
799    directory: Option<&Path>,
800    proxy: Option<&Url>,
801) {
802    if let Some(directory) = directory {
803        command.current_dir(directory);
804        command.args(["--prefix".into(), directory.to_path_buf()]);
805    }
806
807    if let Some(proxy) = proxy {
808        // Map proxy settings from `http://localhost:10809` to `http://127.0.0.1:10809`
809        // NodeRuntime without environment information can not parse `localhost`
810        // correctly.
811        // TODO: map to `[::1]` if we are using ipv6
812        let proxy = proxy
813            .to_string()
814            .to_ascii_lowercase()
815            .replace("localhost", "127.0.0.1");
816
817        command.args(["--proxy", &proxy]);
818    }
819
820    #[cfg(windows)]
821    {
822        // SYSTEMROOT is a critical environment variables for Windows.
823        if let Some(val) = env::var("SYSTEMROOT")
824            .context("Missing environment variable: SYSTEMROOT!")
825            .log_err()
826        {
827            command.env("SYSTEMROOT", val);
828        }
829        // Without ComSpec, the post-install will always fail.
830        if let Some(val) = env::var("ComSpec")
831            .context("Missing environment variable: ComSpec!")
832            .log_err()
833        {
834            command.env("ComSpec", val);
835        }
836    }
837}