Fix injected route edge case (#7399)

* fix(#7397): update astro page entryname logic

* chore: add changeset

* fix: update printed log for injected routes

* fix: ensure /index is included

* test: add custom-404-pkg test

* chore: cleanup

.changeset/large-ants-tap.md

@@ -0,0 +1,5 @@
+---
+'astro': patch
+---
+
+Fix edge case where injected routes would cause builds to fail in a PNPM workspace

packages/astro/src/core/build/generate.ts

@@ -29,6 +29,7 @@ import {
 	type BuildInternals,
 } from '../../core/build/internal.js';
 import {
+	isRelativePath,
 	prependForwardSlash,
 	removeLeadingForwardSlash,
 	removeTrailingForwardSlash,
@@ -252,7 +253,11 @@ async function generatePage(
 	};
 
 	const icon = pageData.route.type === 'page' ? green('▶') : magenta('λ');
+	if (isRelativePath(pageData.route.component)) {
+		info(opts.logging, null, `${icon} ${pageData.route.route}`);
+	} else {
 		info(opts.logging, null, `${icon} ${pageData.route.component}`);
+	}
 
 	// Get paths for the route, calling getStaticPaths if needed.
 	const paths = await getPathsForRoute(pageData, pageModule, opts, builtPaths);

packages/astro/src/core/build/static-build.ts

@@ -30,7 +30,7 @@ import {
 } from './plugins/plugin-pages.js';
 import { RESOLVED_RENDERERS_MODULE_ID } from './plugins/plugin-renderers.js';
 import { SSR_VIRTUAL_MODULE_ID } from './plugins/plugin-ssr.js';
-import type { PageBuildData, StaticBuildOptions } from './types';
+import type { AllPagesData, PageBuildData, StaticBuildOptions } from './types';
 import { getTimeStat } from './util.js';
 
 export async function viteBuild(opts: StaticBuildOptions) {
@@ -143,7 +143,7 @@ async function ssrBuild(
 	input: Set<string>,
 	container: AstroBuildPluginContainer
 ) {
-	const { settings, viteConfig } = opts;
+	const { allPages, settings, viteConfig } = opts;
 	const ssr = isServerLikeOutput(settings.config);
 	const out = ssr ? opts.buildConfig.server : getOutDirWithinCwd(settings.config.outDir);
 
@@ -175,7 +175,7 @@ async function ssrBuild(
 					...viteConfig.build?.rollupOptions?.output,
 					entryFileNames(chunkInfo) {
 						if (chunkInfo.facadeModuleId?.startsWith(ASTRO_PAGE_RESOLVED_MODULE_ID)) {
-							return makeAstroPageEntryPointFileName(chunkInfo.facadeModuleId);
+							return makeAstroPageEntryPointFileName(chunkInfo.facadeModuleId, allPages);
 						} else if (
 							// checks if the path of the module we have middleware, e.g. middleware.js / middleware/index.js
 							chunkInfo.moduleIds.find((m) => m.includes('middleware')) !== undefined &&
@@ -418,27 +418,27 @@ async function ssrMoveAssets(opts: StaticBuildOptions) {
 }
 
 /**
- * This function takes as input the virtual module name of an astro page and transform
- * to generate an `.mjs` file:
+ * This function takes the virtual module name of any page entrypoint and
+ * transforms it to generate a final `.mjs` output file.
  *
  * Input: `@astro-page:src/pages/index@_@astro`
- *
  * Output: `pages/index.astro.mjs`
+ * Input: `@astro-page:../node_modules/my-dep/injected@_@astro`
+ * Output: `pages/injected.mjs`
  *
- * 1. We remove the module id prefix, `@astro-page:`
- * 2. We remove `src/`
- * 3. We replace square brackets with underscore, for example `[slug]`
- * 4. At last, we replace the extension pattern with a simple dot
- * 5. We append the `.mjs` string, so the file will always be a JS file
+ * 1. We clean the `facadeModuleId` by removing the `@astro-page:` prefix and `@_@` suffix
+ * 2. We find the matching route pattern in the manifest (or fallback to the cleaned module id)
+ * 3. We replace square brackets with underscore (`[slug]` => `_slug_`) and `...` with `` (`[...slug]` => `_---slug_`).
+ * 4. We append the `.mjs` extension, so the file will always be an ESM module
  *
- * @param facadeModuleId
+ * @param facadeModuleId string
+ * @param pages AllPagesData
  */
-function makeAstroPageEntryPointFileName(facadeModuleId: string) {
-	return `${facadeModuleId
+function makeAstroPageEntryPointFileName(facadeModuleId: string, pages: AllPagesData) {
+	const pageModuleId = facadeModuleId
 		.replace(ASTRO_PAGE_RESOLVED_MODULE_ID, '')
-		.replace('src/', '')
-		.replaceAll('[', '_')
-		.replaceAll(']', '_')
-		// this must be last
-		.replace(ASTRO_PAGE_EXTENSION_POST_PATTERN, '.')}.mjs`;
+		.replace(ASTRO_PAGE_EXTENSION_POST_PATTERN, '.');
+	let name = pages[pageModuleId]?.route?.route ?? pageModuleId;
+	if (name.endsWith('/')) name += 'index';
+	return `pages${name.replaceAll('[', '_').replaceAll(']', '_').replaceAll('...', '---')}.mjs`;
 }

packages/astro/test/custom-404-injected-from-dep.test.js

@@ -0,0 +1,22 @@
+import { expect } from 'chai';
+import { loadFixture } from './test-utils.js';
+
+describe('Custom 404 with injectRoute from dependency', () => {
+	describe('build', () => {
+		/** @type {import('./test-utils.js').Fixture} */
+		let fixture;
+
+		before(async () => {
+			fixture = await loadFixture({
+				root: './fixtures/custom-404-injected-from-dep/',
+				site: 'http://example.com',
+			});
+			await fixture.build();
+		});
+
+		it('Build succeeds', async () => {
+			const html = await fixture.readFile('/404.html');
+			expect(html).to.contain('<!DOCTYPE html>');
+		});
+	});
+});

packages/astro/test/fixtures/custom-404-injected-from-dep/astro.config.mjs

@@ -0,0 +1,18 @@
+import { defineConfig } from 'astro/config';
+
+// https://astro.build/config
+export default defineConfig({
+  integrations: [
+    {
+      name: '404-integration',
+      hooks: {
+        'astro:config:setup': ({ injectRoute }) => {
+          injectRoute({
+            pattern: '404',
+            entryPoint: '@test/custom-404-pkg/404.astro',
+          });
+        },
+      },
+    },
+  ],
+});

packages/astro/test/fixtures/custom-404-injected-from-dep/package.json

@@ -0,0 +1,9 @@
+{
+  "name": "@test/custom-404-injected-from-dep",
+  "version": "0.0.0",
+  "private": true,
+  "dependencies": {
+    "astro": "workspace:*",
+    "@test/custom-404-pkg": "workspace:*"
+  }
+}

packages/astro/test/fixtures/custom-404-injected-from-dep/src/pages/index.astro

@@ -0,0 +1,11 @@
+---
+---
+
+<html lang="en">
+<head>
+  <title>Custom 404</title>
+</head>
+<body>
+  <h1>Home</h1>
+</body>
+</html>

packages/astro/test/fixtures/custom-404-pkg/404.astro

@@ -0,0 +1,13 @@
+---
+const canonicalURL = new URL(Astro.url.pathname, Astro.site);
+---
+
+<html lang="en">
+<head>
+  <title>Not Found - Custom 404</title>
+</head>
+<body>
+  <h1>Page not found</h1>
+	<p>{canonicalURL.pathname}</p>
+</body>
+</html>

packages/astro/test/fixtures/custom-404-pkg/package.json

@@ -0,0 +1,8 @@
+{
+  "name": "@test/custom-404-pkg",
+  "version": "0.0.0",
+  "private": true,
+  "dependencies": {
+    "astro": "workspace:*"
+  }
+}

pnpm-lock.yaml

@@ -1,4 +1,4 @@
-lockfileVersion: '6.1'
+lockfileVersion: '6.0'
 
 settings:
   autoInstallPeers: false
@@ -2499,12 +2499,27 @@ importers:
         specifier: workspace:*
         version: link:../../..
 
+  packages/astro/test/fixtures/custom-404-injected-from-dep:
+    dependencies:
+      '@test/custom-404-pkg':
+        specifier: workspace:*
+        version: link:../custom-404-pkg
+      astro:
+        specifier: workspace:*
+        version: link:../../..
+
   packages/astro/test/fixtures/custom-404-md:
     dependencies:
       astro:
         specifier: workspace:*
         version: link:../../..
 
+  packages/astro/test/fixtures/custom-404-pkg:
+    dependencies:
+      astro:
+        specifier: workspace:*
+        version: link:../../..
+
   packages/astro/test/fixtures/custom-assets-name:
     dependencies:
       '@astrojs/node':