astro 4.7.1 → 4.8.0

package/dist/content/utils.d.ts

@@ -38,10 +38,6 @@ export declare const collectionConfigParser: z.ZodUnion<[z.ZodObject<{
     type: "data";
     schema?: any;
 }>]>;
-export declare function getDotAstroTypeReference({ root, srcDir }: {
-    root: URL;
-    srcDir: URL;
-}): string;
 export declare const contentConfigParser: z.ZodObject<{
     collections: z.ZodRecord<z.ZodString, z.ZodUnion<[z.ZodObject<{
         type: z.ZodDefault<z.ZodOptional<z.ZodLiteral<"content">>>;

package/dist/content/utils.js

@@ -7,7 +7,7 @@ import { normalizePath } from "vite";
 import { z } from "zod";
 import { AstroError, AstroErrorData, MarkdownError, errorMap } from "../core/errors/index.js";
 import { isYAMLException } from "../core/errors/utils.js";
-import { CONTENT_FLAGS, CONTENT_TYPES_FILE, PROPAGATED_ASSET_FLAG } from "./consts.js";
+import { CONTENT_FLAGS, PROPAGATED_ASSET_FLAG } from "./consts.js";
 import { createImage } from "./runtime-assets.js";
 const collectionConfigParser = z.union([
   z.object({
@@ -19,13 +19,6 @@ const collectionConfigParser = z.union([
     schema: z.any().optional()
   })
 ]);
-function getDotAstroTypeReference({ root, srcDir }) {
-  const { cacheDir } = getContentPaths({ root, srcDir });
-  const contentTypesRelativeToSrcDir = normalizePath(
-    path.relative(fileURLToPath(srcDir), fileURLToPath(new URL(CONTENT_TYPES_FILE, cacheDir)))
-  );
-  return `/// <reference path=${JSON.stringify(contentTypesRelativeToSrcDir)} />`;
-}
 const contentConfigParser = z.object({
   collections: z.record(collectionConfigParser)
 });
@@ -178,22 +171,19 @@ function getEntryType(entryPath, paths, contentFileExts, dataFileExts) {
 function hasUnderscoreBelowContentDirectoryPath(fileUrl, contentDir) {
   const parts = fileUrl.pathname.replace(contentDir.pathname, "").split("/");
   for (const part of parts) {
-    if (part.startsWith("_"))
-      return true;
+    if (part.startsWith("_")) return true;
   }
   return false;
 }
 function getYAMLErrorLine(rawData, objectKey) {
-  if (!rawData)
-    return 0;
+  if (!rawData) return 0;
   const indexOfObjectKey = rawData.search(
     // Match key either at the top of the file or after a newline
     // Ensures matching on top-level object keys only
     new RegExp(`(
 |^)${objectKey}`)
   );
-  if (indexOfObjectKey === -1)
-    return 0;
+  if (indexOfObjectKey === -1) return 0;
   const dataBeforeKey = rawData.substring(0, indexOfObjectKey + 1);
   const numNewlinesBeforeKey = dataBeforeKey.split("\n").length;
   return numNewlinesBeforeKey;
@@ -359,7 +349,6 @@ export {
   getContentPaths,
   getDataEntryExts,
   getDataEntryId,
-  getDotAstroTypeReference,
   getEntryCollectionName,
   getEntryConfigByExtMap,
   getEntryData,

package/dist/content/vite-plugin-content-assets.d.ts

@@ -1,6 +1,6 @@
 import type { Plugin } from 'vite';
 import type { AstroSettings } from '../@types/astro.js';
-import { type BuildInternals } from '../core/build/internal.js';
+import type { BuildInternals } from '../core/build/internal.js';
 import type { AstroBuildPlugin } from '../core/build/plugin.js';
 import type { StaticBuildOptions } from '../core/build/types.js';
 export declare function astroContentAssetPropagationPlugin({ mode, settings, }: {

package/dist/content/vite-plugin-content-assets.js

@@ -1,8 +1,6 @@
 import { extname } from "node:path";
 import { pathToFileURL } from "node:url";
 import { getAssetsPrefix } from "../assets/utils/getAssetsPrefix.js";
-import { getParentModuleInfos, moduleIsTopLevelPage } from "../core/build/graph.js";
-import { getPageDataByViteID } from "../core/build/internal.js";
 import { createViteLoader } from "../core/module-loader/vite.js";
 import { joinPaths, prependForwardSlash } from "../core/path.js";
 import { getStylesForURL } from "../vite-plugin-astro-server/css.js";
@@ -124,51 +122,21 @@ function astroConfigBuildPlugin(options, internals) {
         };
         for (const chunk of outputs) {
           if (chunk.type === "chunk" && (chunk.code.includes(LINKS_PLACEHOLDER) || chunk.code.includes(SCRIPTS_PLACEHOLDER))) {
-            let entryStyles = /* @__PURE__ */ new Set();
-            let entryLinks = /* @__PURE__ */ new Set();
-            let entryScripts = /* @__PURE__ */ new Set();
-            if (options.settings.config.experimental.contentCollectionCache) {
-              for (const id of chunk.moduleIds) {
-                const _entryCss = internals.propagatedStylesMap.get(id);
-                const _entryScripts = internals.propagatedScriptsMap.get(id);
-                if (_entryCss) {
-                  for (const value of _entryCss) {
-                    if (value.type === "inline")
-                      entryStyles.add(value.content);
-                    if (value.type === "external")
-                      entryLinks.add(value.src);
-                  }
-                }
-                if (_entryScripts) {
-                  for (const value of _entryScripts) {
-                    entryScripts.add(value);
-                  }
+            const entryStyles = /* @__PURE__ */ new Set();
+            const entryLinks = /* @__PURE__ */ new Set();
+            const entryScripts = /* @__PURE__ */ new Set();
+            for (const id of chunk.moduleIds) {
+              const _entryCss = internals.propagatedStylesMap.get(id);
+              const _entryScripts = internals.propagatedScriptsMap.get(id);
+              if (_entryCss) {
+                for (const value of _entryCss) {
+                  if (value.type === "inline") entryStyles.add(value.content);
+                  if (value.type === "external") entryLinks.add(value.src);
                 }
               }
-            } else {
-              for (const id of Object.keys(chunk.modules)) {
-                for (const pageInfo of getParentModuleInfos(id, ssrPluginContext)) {
-                  if (moduleIsTopLevelPage(pageInfo)) {
-                    const pageViteID = pageInfo.id;
-                    const pageData = getPageDataByViteID(internals, pageViteID);
-                    if (!pageData)
-                      continue;
-                    const _entryCss = pageData.propagatedStyles?.get(id);
-                    const _entryScripts = pageData.propagatedScripts?.get(id);
-                    if (_entryCss) {
-                      for (const value of _entryCss) {
-                        if (value.type === "inline")
-                          entryStyles.add(value.content);
-                        if (value.type === "external")
-                          entryLinks.add(value.src);
-                      }
-                    }
-                    if (_entryScripts) {
-                      for (const value of _entryScripts) {
-                        entryScripts.add(value);
-                      }
-                    }
-                  }
+              if (_entryScripts) {
+                for (const value of _entryScripts) {
+                  entryScripts.add(value);
                 }
               }
             }
@@ -193,8 +161,7 @@ function astroConfigBuildPlugin(options, internals) {
               const entryFileNames = /* @__PURE__ */ new Set();
               for (const output of clientOutputs) {
                 for (const clientChunk of output.output) {
-                  if (clientChunk.type !== "chunk")
-                    continue;
+                  if (clientChunk.type !== "chunk") continue;
                   for (const [id] of Object.entries(clientChunk.modules)) {
                     if (entryScripts.has(id)) {
                       entryFileNames.add(clientChunk.fileName);

package/dist/content/vite-plugin-content-imports.js

@@ -4,7 +4,7 @@ import * as devalue from "devalue";
 import { getProxyCode } from "../assets/utils/proxy.js";
 import { AstroError } from "../core/errors/errors.js";
 import { AstroErrorData } from "../core/errors/index.js";
-import { isServerLikeOutput } from "../prerender/utils.js";
+import { isServerLikeOutput } from "../core/util.js";
 import { CONTENT_FLAG, DATA_FLAG } from "./consts.js";
 import {
   getContentEntryExts,
@@ -23,8 +23,7 @@ import {
 } from "./utils.js";
 function getContentRendererByViteId(viteId, settings) {
   let ext = viteId.split(".").pop();
-  if (!ext)
-    return void 0;
+  if (!ext) return void 0;
   for (const contentEntryType of settings.contentEntryTypes) {
     if (Boolean(contentEntryType.getRenderModule) && contentEntryType.extensions.includes("." + ext)) {
       return contentEntryType.getRenderModule;
@@ -103,8 +102,7 @@ export const _internal = {
         viteServer.watcher.on("all", async (event, entry) => {
           if (CHOKIDAR_MODIFIED_EVENTS.includes(event)) {
             const entryType = getEntryType(entry, contentPaths, contentEntryExts, dataEntryExts);
-            if (!COLLECTION_TYPES_TO_INVALIDATE_ON.includes(entryType))
-              return;
+            if (!COLLECTION_TYPES_TO_INVALIDATE_ON.includes(entryType)) return;
             if (entryType === "content" || entryType === "data") {
               await reloadContentConfigObserver({ fs, settings, viteServer });
             }
@@ -116,8 +114,7 @@ export const _internal = {
                     viteServer.moduleGraph.invalidateModule(mod);
                   }
                 } catch (e) {
-                  if (e.code === "ERR_CLOSED_SERVER")
-                    break;
+                  if (e.code === "ERR_CLOSED_SERVER") break;
                   throw e;
                 }
               }
@@ -132,8 +129,7 @@ export const _internal = {
       name: "astro:content-render-imports",
       async transform(contents, viteId) {
         const contentRenderer = getContentRendererByViteId(viteId, settings);
-        if (!contentRenderer)
-          return;
+        if (!contentRenderer) return;
         const fileId = viteId.split("?")[0];
         return contentRenderer.bind(this)({ viteId, contents, fileUrl: pathToFileURL(fileId) });
       }
@@ -229,8 +225,7 @@ async function getEntryModuleBaseInfo({
   }
   const entry = pathToFileURL(fileId);
   const collection = getEntryCollectionName({ entry, contentDir });
-  if (collection === void 0)
-    throw new AstroError(AstroErrorData.UnknownContentCollectionError);
+  if (collection === void 0) throw new AstroError(AstroErrorData.UnknownContentCollectionError);
   const collectionConfig = contentConfig?.collections[collection];
   return {
     collectionConfig,

package/dist/content/vite-plugin-content-virtual-mod.js

@@ -7,8 +7,7 @@ import {} from "vite";
 import { encodeName } from "../core/build/util.js";
 import { AstroError, AstroErrorData } from "../core/errors/index.js";
 import { appendForwardSlash, removeFileExtension } from "../core/path.js";
-import { rootRelativePath } from "../core/util.js";
-import { isServerLikeOutput } from "../prerender/utils.js";
+import { isServerLikeOutput, rootRelativePath } from "../core/util.js";
 import {
   CONTENT_FLAG,
   CONTENT_RENDER_FLAG,
@@ -143,12 +142,9 @@ function getStringifiedCollectionFromLookup(wantedType, relContentDir, lookupMap
     normalize = (slug) => `${removeFileExtension(encodeName(slug)).replace(relContentDir, "./")}${suffix}`;
   } else {
     let suffix = "";
-    if (wantedType === "content")
-      suffix = CONTENT_FLAG;
-    else if (wantedType === "data")
-      suffix = DATA_FLAG;
-    else if (wantedType === "render")
-      suffix = CONTENT_RENDER_FLAG;
+    if (wantedType === "content") suffix = CONTENT_FLAG;
+    else if (wantedType === "data") suffix = DATA_FLAG;
+    else if (wantedType === "render") suffix = CONTENT_RENDER_FLAG;
     normalize = (slug) => `${slug}?${suffix}`;
   }
   for (const { type, entries } of Object.values(lookupMap)) {
@@ -188,11 +184,9 @@ async function generateLookupMap({
     promises.push(
       limit(async () => {
         const entryType = getEntryType(filePath, contentPaths, contentEntryExts, dataEntryExts);
-        if (entryType !== "content" && entryType !== "data")
-          return;
+        if (entryType !== "content" && entryType !== "data") return;
         const collection = getEntryCollectionName({ contentDir, entry: pathToFileURL(filePath) });
-        if (!collection)
-          throw UnexpectedLookupMapError;
+        if (!collection) throw UnexpectedLookupMapError;
         if (lookupMap[collection]?.type && lookupMap[collection].type !== entryType) {
           throw new AstroError({
             ...AstroErrorData.MixedContentDataCollectionError,
@@ -201,8 +195,7 @@ async function generateLookupMap({
         }
         if (entryType === "content") {
           const contentEntryType = contentEntryConfigByExt.get(extname(filePath));
-          if (!contentEntryType)
-            throw UnexpectedLookupMapError;
+          if (!contentEntryType) throw UnexpectedLookupMapError;
           const { id, slug: generatedSlug } = await getContentEntryIdAndSlug({
             entry: pathToFileURL(filePath),
             contentDir,

package/dist/core/app/index.js

@@ -1,6 +1,5 @@
 import { normalizeTheLocale } from "../../i18n/index.js";
 import {
-  DEFAULT_404_COMPONENT,
   REROUTABLE_STATUS_CODES,
   REROUTE_DIRECTIVE_HEADER,
   clientAddressSymbol,
@@ -19,7 +18,6 @@ import {
   prependForwardSlash,
   removeTrailingForwardSlash
 } from "../path.js";
-import { RedirectSinglePageBuiltModule } from "../redirects/index.js";
 import { RenderContext } from "../render-context.js";
 import { createAssetLink } from "../render/ssr-element.js";
 import { ensure404Route } from "../routing/astro-designed-error-pages.js";
@@ -44,7 +42,7 @@ class App {
       routes: manifest.routes.map((route) => route.routeData)
     });
     this.#baseWithoutTrailingSlash = removeTrailingForwardSlash(this.#manifest.base);
-    this.#pipeline = this.#createPipeline(streaming);
+    this.#pipeline = this.#createPipeline(this.#manifestData, streaming);
     this.#adapterLogger = new AstroIntegrationLogger(
       this.#logger.options,
       this.#manifest.adapterName
@@ -56,17 +54,18 @@ class App {
   /**
    * Creates a pipeline by reading the stored manifest
    *
+   * @param manifestData
    * @param streaming
    * @private
    */
-  #createPipeline(streaming = false) {
+  #createPipeline(manifestData, streaming = false) {
     if (this.#manifest.checkOrigin) {
       this.#manifest.middleware = sequence(
         createOriginCheckMiddleware(),
         this.#manifest.middleware
       );
     }
-    return AppPipeline.create({
+    return AppPipeline.create(manifestData, {
       logger: this.#logger,
       manifest: this.#manifest,
       mode: "production",
@@ -106,15 +105,13 @@ class App {
   }
   match(request) {
     const url = new URL(request.url);
-    if (this.#manifest.assets.has(url.pathname))
-      return void 0;
+    if (this.#manifest.assets.has(url.pathname)) return void 0;
     let pathname = this.#computePathnameFromDomain(request);
     if (!pathname) {
       pathname = prependForwardSlash(this.removeBase(url.pathname));
     }
     let routeData = matchRoute(pathname, this.#manifestData);
-    if (!routeData || routeData.prerender)
-      return void 0;
+    if (!routeData || routeData.prerender) return void 0;
     return routeData;
   }
   #computePathnameFromDomain(request) {
@@ -210,7 +207,7 @@ class App {
     }
     const pathname = this.#getPathnameFromRequest(request);
     const defaultStatus = this.#getDefaultStatusCode(routeData, pathname);
-    const mod = await this.#getModuleForRoute(routeData);
+    const mod = await this.#pipeline.getModuleForRoute(routeData);
     let response;
     try {
       const renderContext = RenderContext.create({
@@ -245,8 +242,7 @@ class App {
     return response;
   }
   #logRenderOptionsDeprecationWarning() {
-    if (this.#renderOptionsDeprecationWarningShown)
-      return;
+    if (this.#renderOptionsDeprecationWarningShown) return;
     this.#logger.warn(
       "deprecated",
       `The adapter ${this.#manifest.adapterName} is using a deprecated signature of the 'app.render()' method. From Astro 4.0, locals and routeData are provided as properties on an optional object to this method. Using the old signature will cause an error in Astro 5.0. See https://github.com/withastro/astro/pull/9199 for more information.`
@@ -287,7 +283,7 @@ class App {
         const override = { status };
         return this.#mergeResponses(response2, originalResponse, override);
       }
-      const mod = await this.#getModuleForRoute(errorRouteData);
+      const mod = await this.#pipeline.getModuleForRoute(errorRouteData);
       try {
         const renderContext = RenderContext.create({
           locals,
@@ -354,41 +350,10 @@ class App {
       }
     }
     const route = removeTrailingForwardSlash(routeData.route);
-    if (route.endsWith("/404"))
-      return 404;
-    if (route.endsWith("/500"))
-      return 500;
+    if (route.endsWith("/404")) return 404;
+    if (route.endsWith("/500")) return 500;
     return 200;
   }
-  async #getModuleForRoute(route) {
-    if (route.component === DEFAULT_404_COMPONENT) {
-      return {
-        page: async () => ({ default: () => new Response(null, { status: 404 }) }),
-        renderers: []
-      };
-    }
-    if (route.type === "redirect") {
-      return RedirectSinglePageBuiltModule;
-    } else {
-      if (this.#manifest.pageMap) {
-        const importComponentInstance = this.#manifest.pageMap.get(route.component);
-        if (!importComponentInstance) {
-          throw new Error(
-            `Unexpectedly unable to find a component instance for route ${route.route}`
-          );
-        }
-        const pageModule = await importComponentInstance();
-        return pageModule;
-      } else if (this.#manifest.pageModule) {
-        const importComponentInstance = this.#manifest.pageModule;
-        return importComponentInstance;
-      } else {
-        throw new Error(
-          "Astro couldn't find the correct page to render, probably because it wasn't correctly mapped for SSR usage. This is an internal error, please file an issue."
-        );
-      }
-    }
-  }
 }
 export {
   App,

package/dist/core/app/node.js

@@ -36,7 +36,9 @@ class NodeApp extends App {
     const protocol = req.headers["x-forwarded-proto"] ?? ("encrypted" in req.socket && req.socket.encrypted ? "https" : "http");
     const hostname = req.headers["x-forwarded-host"] ?? req.headers.host ?? req.headers[":authority"];
     const port = req.headers["x-forwarded-port"];
-    const url = `${protocol}://${hostname}${port ? `:${port}` : ""}${req.url}`;
+    const portInHostname = typeof hostname === "string" && typeof port === "string" && hostname.endsWith(port);
+    const hostnamePort = portInHostname ? hostname : hostname + (port ? `:${port}` : "");
+    const url = `${protocol}://${hostnamePort}${req.url}`;
     const options = {
       method: req.method || "GET",
       headers: makeRequestHeaders(req)
@@ -69,8 +71,7 @@ class NodeApp extends App {
   static async writeResponse(source, destination) {
     const { status, headers, body } = source;
     destination.writeHead(status, createOutgoingHttpHeaders(headers));
-    if (!body)
-      return destination.end();
+    if (!body) return destination.end();
     try {
       const reader = body.getReader();
       destination.on("close", () => {

package/dist/core/app/pipeline.d.ts

@@ -1,7 +1,12 @@
-import type { RouteData, SSRResult } from '../../@types/astro.js';
+import type { ComponentInstance, ManifestData, RewritePayload, RouteData, SSRResult } from '../../@types/astro.js';
 import { Pipeline } from '../base-pipeline.js';
+import type { SinglePageBuiltModule } from '../build/types.js';
 export declare class AppPipeline extends Pipeline {
-    static create({ logger, manifest, mode, renderers, resolve, serverLike, streaming, }: Pick<AppPipeline, 'logger' | 'manifest' | 'mode' | 'renderers' | 'resolve' | 'serverLike' | 'streaming'>): AppPipeline;
+    #private;
+    static create(manifestData: ManifestData, { logger, manifest, mode, renderers, resolve, serverLike, streaming, }: Pick<AppPipeline, 'logger' | 'manifest' | 'mode' | 'renderers' | 'resolve' | 'serverLike' | 'streaming'>): AppPipeline;
     headElements(routeData: RouteData): Pick<SSRResult, 'scripts' | 'styles' | 'links'>;
     componentMetadata(): void;
+    getComponentByRoute(routeData: RouteData): Promise<ComponentInstance>;
+    tryRewrite(payload: RewritePayload): Promise<[RouteData, ComponentInstance]>;
+    getModuleForRoute(route: RouteData): Promise<SinglePageBuiltModule>;
 }

package/dist/core/app/pipeline.js

@@ -1,7 +1,10 @@
 import { Pipeline } from "../base-pipeline.js";
+import { DEFAULT_404_COMPONENT } from "../constants.js";
+import { RedirectSinglePageBuiltModule } from "../redirects/component.js";
 import { createModuleScriptElement, createStylesheetElementSet } from "../render/ssr-element.js";
 class AppPipeline extends Pipeline {
-  static create({
+  #manifestData;
+  static create(manifestData, {
     logger,
     manifest,
     mode,
@@ -10,7 +13,17 @@ class AppPipeline extends Pipeline {
     serverLike,
     streaming
   }) {
-    return new AppPipeline(logger, manifest, mode, renderers, resolve, serverLike, streaming);
+    const pipeline = new AppPipeline(
+      logger,
+      manifest,
+      mode,
+      renderers,
+      resolve,
+      serverLike,
+      streaming
+    );
+    pipeline.#manifestData = manifestData;
+    return pipeline;
   }
   headElements(routeData) {
     const routeInfo = this.manifest.routes.find((route) => route.routeData === routeData);
@@ -33,6 +46,61 @@ class AppPipeline extends Pipeline {
   }
   componentMetadata() {
   }
+  async getComponentByRoute(routeData) {
+    const module = await this.getModuleForRoute(routeData);
+    return module.page();
+  }
+  async tryRewrite(payload) {
+    let foundRoute;
+    for (const route of this.#manifestData.routes) {
+      if (payload instanceof URL) {
+        if (route.pattern.test(payload.pathname)) {
+          foundRoute = route;
+          break;
+        }
+      } else if (payload instanceof Request) {
+        const url = new URL(payload.url);
+        if (route.pattern.test(url.pathname)) {
+          foundRoute = route;
+          break;
+        }
+      } else if (route.pattern.test(decodeURI(payload))) {
+        foundRoute = route;
+        break;
+      }
+    }
+    if (foundRoute) {
+      const componentInstance = await this.getComponentByRoute(foundRoute);
+      return [foundRoute, componentInstance];
+    }
+    throw new Error("Route not found");
+  }
+  async getModuleForRoute(route) {
+    if (route.component === DEFAULT_404_COMPONENT) {
+      return {
+        page: async () => ({ default: () => new Response(null, { status: 404 }) }),
+        renderers: []
+      };
+    }
+    if (route.type === "redirect") {
+      return RedirectSinglePageBuiltModule;
+    } else {
+      if (this.manifest.pageMap) {
+        const importComponentInstance = this.manifest.pageMap.get(route.component);
+        if (!importComponentInstance) {
+          throw new Error(
+            `Unexpectedly unable to find a component instance for route ${route.route}`
+          );
+        }
+        return await importComponentInstance();
+      } else if (this.manifest.pageModule) {
+        return this.manifest.pageModule;
+      }
+      throw new Error(
+        "Astro couldn't find the correct page to render, probably because it wasn't correctly mapped for SSR usage. This is an internal error, please file an issue."
+      );
+    }
+  }
 }
 export {
   AppPipeline

package/dist/core/app/types.d.ts

@@ -52,6 +52,7 @@ export type SSRManifest = {
     i18n: SSRManifestI18n | undefined;
     middleware: MiddlewareHandler;
     checkOrigin: boolean;
+    rewritingEnabled: boolean;
 };
 export type SSRManifestI18n = {
     fallback: Record<string, string> | undefined;

package/dist/core/base-pipeline.d.ts

@@ -1,4 +1,4 @@
-import type { MiddlewareHandler, RouteData, RuntimeMode, SSRLoadedRenderer, SSRManifest, SSRResult } from '../@types/astro.js';
+import type { ComponentInstance, MiddlewareHandler, RewritePayload, RouteData, RuntimeMode, SSRLoadedRenderer, SSRManifest, SSRResult } from '../@types/astro.js';
 import type { Logger } from './logger/core.js';
 import { RouteCache } from './render/route-cache.js';
 /**
@@ -55,6 +55,21 @@ export declare abstract class Pipeline {
     site?: URL | undefined);
     abstract headElements(routeData: RouteData): Promise<HeadElements> | HeadElements;
     abstract componentMetadata(routeData: RouteData): Promise<SSRResult['componentMetadata']> | void;
+    /**
+     * It attempts to retrieve the `RouteData` that matches the input `url`, and the component that belongs to the `RouteData`.
+     *
+     * ## Errors
+     *
+     * - if not `RouteData` is found
+     *
+     * @param {RewritePayload} rewritePayload
+     */
+    abstract tryRewrite(rewritePayload: RewritePayload): Promise<[RouteData, ComponentInstance]>;
+    /**
+     * Tells the pipeline how to retrieve a component give a `RouteData`
+     * @param routeData
+     */
+    abstract getComponentByRoute(routeData: RouteData): Promise<ComponentInstance>;
 }
 export interface HeadElements extends Pick<SSRResult, 'scripts' | 'styles' | 'links'> {
 }