Turbopack: add NEXT_TURBOPACK_WRITE_ROUTES_HASHES_MANIFEST to write hashes into manifest (#86257)

### What?

Add an env var to write route hashes into a diagnostics file.

Author: sokra

Cargo.lock

@@ -21,6 +21,7 @@ use next_api::{
         ProjectOptions, WatchOptions,
     },
     route::Endpoint,
+    routes_hashes_manifest::routes_hashes_manifest_asset_if_enabled,
 };
 use next_core::tracing_presets::{
     TRACING_NEXT_OVERVIEW_TARGETS, TRACING_NEXT_TARGETS, TRACING_NEXT_TURBO_TASKS_TARGETS,
@@ -175,6 +176,9 @@ pub struct NapiProjectOptions {
     /// debugging/profiling purposes.
     pub no_mangling: bool,
 
+    /// Whether to write the route hashes manifest.
+    pub write_routes_hashes_manifest: bool,
+
     /// The version of Node.js that is available/currently running.
     pub current_node_js_version: RcStr,
 }
@@ -220,6 +224,9 @@ pub struct NapiPartialProjectOptions {
     /// The browserslist query to use for targeting browsers.
     pub browserslist_query: Option<RcStr>,
 
+    /// Whether to write the route hashes manifest.
+    pub write_routes_hashes_manifest: Option<bool>,
+
     /// When the code is minified, this opts out of the default mangling of
     /// local names for variables, functions etc., which can be useful for
     /// debugging/profiling purposes.
@@ -277,6 +284,7 @@ impl From<NapiProjectOptions> for ProjectOptions {
             preview_props,
             browserslist_query,
             no_mangling,
+            write_routes_hashes_manifest,
             current_node_js_version,
         } = val;
         ProjectOptions {
@@ -292,6 +300,7 @@ impl From<NapiProjectOptions> for ProjectOptions {
             preview_props: preview_props.into(),
             browserslist_query,
             no_mangling,
+            write_routes_hashes_manifest,
             current_node_js_version,
         }
     }
@@ -312,6 +321,7 @@ impl From<NapiPartialProjectOptions> for PartialProjectOptions {
             preview_props,
             browserslist_query,
             no_mangling,
+            write_routes_hashes_manifest,
         } = val;
         PartialProjectOptions {
             root_path,
@@ -326,6 +336,7 @@ impl From<NapiPartialProjectOptions> for PartialProjectOptions {
             preview_props: preview_props.map(|props| props.into()),
             browserslist_query,
             no_mangling,
+            write_routes_hashes_manifest,
         }
     }
 }
@@ -1057,12 +1068,15 @@ async fn output_assets_operation(
 
     let nft = next_server_nft_assets(project).await?;
 
+    let routes_hashes_manifest = routes_hashes_manifest_asset_if_enabled(project).await?;
+
     whole_app_module_graphs.as_side_effect().await?;
 
     Ok(Vc::cell(
         output_assets
             .into_iter()
             .chain(nft.iter().copied())
+            .chain(routes_hashes_manifest.iter().copied())
             .collect(),
     ))
 }

crates/napi/src/next_api/project.rs

@@ -28,6 +28,7 @@ swc_core = { workspace = true }
 tracing = { workspace = true }
 turbo-rcstr = { workspace = true }
 turbo-tasks = { workspace = true }
+turbo-tasks-hash = { workspace = true }
 turbo-tasks-env = { workspace = true }
 turbo-tasks-fs = { workspace = true }
 turbo-unix-path = { workspace = true }

crates/next-api/Cargo.toml

@@ -21,6 +21,7 @@ mod pages;
 pub mod paths;
 pub mod project;
 pub mod route;
+pub mod routes_hashes_manifest;
 mod server_actions;
 mod versioned_content_map;
 mod webpack_stats;

crates/next-api/src/lib.rs

@@ -1713,7 +1713,11 @@ impl Endpoint for PageEndpoint {
     async fn module_graphs(self: Vc<Self>) -> Result<Vc<ModuleGraphs>> {
         let client_module_graph = self.client_module_graph().to_resolved().await?;
         let ssr_module_graph = self.ssr_module_graph().to_resolved().await?;
-        Ok(Vc::cell(vec![client_module_graph, ssr_module_graph]))
+        Ok(Vc::cell(if client_module_graph != ssr_module_graph {
+            vec![client_module_graph, ssr_module_graph]
+        } else {
+            vec![ssr_module_graph]
+        }))
     }
 }
 

crates/next-api/src/pages.rs

@@ -189,6 +189,9 @@ pub struct ProjectOptions {
     /// debugging/profiling purposes.
     pub no_mangling: bool,
 
+    /// Whether to write the route hashes manifest.
+    pub write_routes_hashes_manifest: bool,
+
     /// The version of Node.js that is available/currently running.
     pub current_node_js_version: RcStr,
 }
@@ -237,6 +240,9 @@ pub struct PartialProjectOptions {
     /// local names for variables, functions etc., which can be useful for
     /// debugging/profiling purposes.
     pub no_mangling: Option<bool>,
+
+    /// Whether to write the route hashes manifest.
+    pub write_routes_hashes_manifest: Option<bool>,
 }
 
 #[derive(
@@ -357,6 +363,7 @@ impl ProjectContainer {
             preview_props,
             browserslist_query,
             no_mangling,
+            write_routes_hashes_manifest,
         } = options;
 
         let resolved_self = self.to_resolved().await?;
@@ -404,6 +411,9 @@ impl ProjectContainer {
         if let Some(no_mangling) = no_mangling {
             new_options.no_mangling = no_mangling;
         }
+        if let Some(write_routes_hashes_manifest) = write_routes_hashes_manifest {
+            new_options.write_routes_hashes_manifest = write_routes_hashes_manifest;
+        }
 
         // TODO: Handle mode switch, should prevent mode being switched.
         let watch = new_options.watch;
@@ -468,6 +478,7 @@ impl ProjectContainer {
         let preview_props;
         let browserslist_query;
         let no_mangling;
+        let write_routes_hashes_manifest;
         let current_node_js_version;
         {
             let options = self.options_state.get();
@@ -491,6 +502,7 @@ impl ProjectContainer {
             preview_props = options.preview_props.clone();
             browserslist_query = options.browserslist_query.clone();
             no_mangling = options.no_mangling;
+            write_routes_hashes_manifest = options.write_routes_hashes_manifest;
             current_node_js_version = options.current_node_js_version.clone();
         }
 
@@ -516,6 +528,7 @@ impl ProjectContainer {
             encryption_key,
             preview_props,
             no_mangling,
+            write_routes_hashes_manifest,
             current_node_js_version,
         }
         .cell())
@@ -603,6 +616,9 @@ pub struct Project {
     /// debugging/profiling purposes.
     no_mangling: bool,
 
+    /// Whether to write the route hashes manifest.
+    write_routes_hashes_manifest: bool,
+
     current_node_js_version: RcStr,
 }
 
@@ -823,6 +839,11 @@ impl Project {
         Ok(Vc::cell(self.watch.enable))
     }
 
+    #[turbo_tasks::function]
+    pub(super) fn should_write_routes_hashes_manifest(&self) -> Result<Vc<bool>> {
+        Ok(Vc::cell(self.write_routes_hashes_manifest))
+    }
+
     #[turbo_tasks::function]
     pub(super) async fn per_page_module_graph(&self) -> Result<Vc<bool>> {
         Ok(Vc::cell(*self.mode.await? == NextMode::Development))