@angular/ssr 19.0.0-next.2 → 19.0.0-next.3

package/fesm2022/ssr.mjs

@@ -1,9 +1,46 @@
 import { APP_BASE_HREF, PlatformLocation } from '@angular/common';
-import { ɵConsole as _Console, ɵresetCompiledComponents as _resetCompiledComponents, createPlatformFactory, platformCore, ApplicationRef, ɵwhenStable as _whenStable, Compiler, InjectionToken } from '@angular/core';
+import { ɵConsole as _Console, createPlatformFactory, platformCore, ApplicationRef, ɵwhenStable as _whenStable, Compiler, InjectionToken, ɵresetCompiledComponents as _resetCompiledComponents } from '@angular/core';
 import { renderModule, renderApplication, INITIAL_CONFIG, ɵINTERNAL_SERVER_PLATFORM_PROVIDERS as _INTERNAL_SERVER_PLATFORM_PROVIDERS, ɵSERVER_CONTEXT as _SERVER_CONTEXT } from '@angular/platform-server';
 import { ɵloadChildren as _loadChildren, Router } from '@angular/router';
 import Critters from '../third_party/critters/index.js';
 
+/**
+ * Manages server-side assets.
+ */
+class ServerAssets {
+    /**
+     * Creates an instance of ServerAsset.
+     *
+     * @param manifest - The manifest containing the server assets.
+     */
+    constructor(manifest) {
+        this.manifest = manifest;
+    }
+    /**
+     * Retrieves the content of a server-side asset using its path.
+     *
+     * @param path - The path to the server asset.
+     * @returns A promise that resolves to the asset content as a string.
+     * @throws Error If the asset path is not found in the manifest, an error is thrown.
+     */
+    async getServerAsset(path) {
+        const asset = this.manifest.assets.get(path);
+        if (!asset) {
+            throw new Error(`Server asset '${path}' does not exist.`);
+        }
+        return asset();
+    }
+    /**
+     * Retrieves and caches the content of 'index.server.html'.
+     *
+     * @returns A promise that resolves to the content of 'index.server.html'.
+     * @throws Error If there is an issue retrieving the asset.
+     */
+    getIndexServerHtml() {
+        return this.getServerAsset('index.server.html');
+    }
+}
+
 /**
  * Custom implementation of the Angular Console service that filters out specific log messages.
  *
@@ -34,6 +71,59 @@ class Console extends _Console {
     }
 }
 
+/**
+ * The Angular app manifest object.
+ * This is used internally to store the current Angular app manifest.
+ */
+let angularAppManifest;
+/**
+ * Sets the Angular app manifest.
+ *
+ * @param manifest - The manifest object to set for the Angular application.
+ */
+function setAngularAppManifest(manifest) {
+    angularAppManifest = manifest;
+}
+/**
+ * Gets the Angular app manifest.
+ *
+ * @returns The Angular app manifest.
+ * @throws Will throw an error if the Angular app manifest is not set.
+ */
+function getAngularAppManifest() {
+    if (!angularAppManifest) {
+        throw new Error('Angular app manifest is not set. ' +
+            `Please ensure you are using the '@angular/build:application' builder to build your server application.`);
+    }
+    return angularAppManifest;
+}
+/**
+ * The Angular app engine manifest object.
+ * This is used internally to store the current Angular app engine manifest.
+ */
+let angularAppEngineManifest;
+/**
+ * Sets the Angular app engine manifest.
+ *
+ * @param manifest - The engine manifest object to set.
+ */
+function setAngularAppEngineManifest(manifest) {
+    angularAppEngineManifest = manifest;
+}
+/**
+ * Gets the Angular app engine manifest.
+ *
+ * @returns The Angular app engine manifest.
+ * @throws Will throw an error if the Angular app engine manifest is not set.
+ */
+function getAngularAppEngineManifest() {
+    if (!angularAppEngineManifest) {
+        throw new Error('Angular app engine manifest is not set. ' +
+            `Please ensure you are using the '@angular/build:application' builder to build your server application.`);
+    }
+    return angularAppEngineManifest;
+}
+
 /**
  * Removes the trailing slash from a URL if it exists.
  *
@@ -149,335 +239,11 @@ function renderAngular(html, bootstrap, url, platformProviders) {
  * Angular modules are identified by the presence of the `ɵmod` static property.
  * This function helps distinguish between Angular modules and bootstrap functions.
  *
- * @param value - The value to be checked.
- * @returns True if the value is an Angular module (i.e., it has the `ɵmod` property), false otherwise.
- */
-function isNgModule(value) {
-    return 'ɵmod' in value;
-}
-
-/**
- * Recursively traverses the Angular router configuration to retrieve routes.
- *
- * Iterates through the router configuration, yielding each route along with its potential
- * redirection or error status. Handles nested routes and lazy-loaded child routes.
- *
- * @param options - An object containing the parameters for traversing routes.
- * @returns An async iterator yielding `RouteResult` objects.
- */
-async function* traverseRoutesConfig(options) {
-    const { routes, compiler, parentInjector, parentRoute } = options;
-    for (const route of routes) {
-        const { path = '', redirectTo, loadChildren, children } = route;
-        const currentRoutePath = joinUrlParts(parentRoute, path);
-        yield {
-            route: currentRoutePath,
-            redirectTo: typeof redirectTo === 'string'
-                ? resolveRedirectTo(currentRoutePath, redirectTo)
-                : undefined,
-        };
-        if (children?.length) {
-            // Recursively process child routes.
-            yield* traverseRoutesConfig({
-                routes: children,
-                compiler,
-                parentInjector,
-                parentRoute: currentRoutePath,
-            });
-        }
-        if (loadChildren) {
-            // Load and process lazy-loaded child routes.
-            const loadedChildRoutes = await _loadChildren(route, compiler, parentInjector).toPromise();
-            if (loadedChildRoutes) {
-                const { routes: childRoutes, injector = parentInjector } = loadedChildRoutes;
-                yield* traverseRoutesConfig({
-                    routes: childRoutes,
-                    compiler,
-                    parentInjector: injector,
-                    parentRoute: currentRoutePath,
-                });
-            }
-        }
-    }
-}
-/**
- * Resolves the `redirectTo` property for a given route.
- *
- * This function processes the `redirectTo` property to ensure that it correctly
- * resolves relative to the current route path. If `redirectTo` is an absolute path,
- * it is returned as is. If it is a relative path, it is resolved based on the current route path.
- *
- * @param routePath - The current route path.
- * @param redirectTo - The target path for redirection.
- * @returns The resolved redirect path as a string.
- */
-function resolveRedirectTo(routePath, redirectTo) {
-    if (redirectTo[0] === '/') {
-        // If the redirectTo path is absolute, return it as is.
-        return redirectTo;
-    }
-    // Resolve relative redirectTo based on the current route path.
-    const segments = routePath.split('/');
-    segments.pop(); // Remove the last segment to make it relative.
-    return joinUrlParts(...segments, redirectTo);
-}
-/**
- * Retrieves routes from the given Angular application.
- *
- * This function initializes an Angular platform, bootstraps the application or module,
- * and retrieves routes from the Angular router configuration. It handles both module-based
- * and function-based bootstrapping. It yields the resulting routes as `RouteResult` objects.
- *
- * @param bootstrap - A function that returns a promise resolving to an `ApplicationRef` or an Angular module to bootstrap.
- * @param document - The initial HTML document used for server-side rendering.
- * This document is necessary to render the application on the server.
- * @param url - The URL for server-side rendering. The URL is used to configure `ServerPlatformLocation`. This configuration is crucial
- * for ensuring that API requests for relative paths succeed, which is essential for accurate route extraction.
- * See:
- *  - https://github.com/angular/angular/blob/d608b857c689d17a7ffa33bbb510301014d24a17/packages/platform-server/src/location.ts#L51
- *  - https://github.com/angular/angular/blob/6882cc7d9eed26d3caeedca027452367ba25f2b9/packages/platform-server/src/http.ts#L44
- * @returns A promise that resolves to an object of type `AngularRouterConfigResult`.
- */
-async function getRoutesFromAngularRouterConfig(bootstrap, document, url) {
-    if (typeof ngDevMode === 'undefined' || ngDevMode) {
-        // Need to clean up GENERATED_COMP_IDS map in `@angular/core`.
-        // Otherwise an incorrect component ID generation collision detected warning will be displayed in development.
-        // See: https://github.com/angular/angular-cli/issues/25924
-        _resetCompiledComponents();
-    }
-    const { protocol, host } = url;
-    // Create and initialize the Angular platform for server-side rendering.
-    const platformRef = createPlatformFactory(platformCore, 'server', [
-        {
-            provide: INITIAL_CONFIG,
-            useValue: { document, url: `${protocol}//${host}/` },
-        },
-        {
-            provide: _Console,
-            useFactory: () => new Console(),
-        },
-        ..._INTERNAL_SERVER_PLATFORM_PROVIDERS,
-    ])();
-    try {
-        let applicationRef;
-        if (isNgModule(bootstrap)) {
-            const moduleRef = await platformRef.bootstrapModule(bootstrap);
-            applicationRef = moduleRef.injector.get(ApplicationRef);
-        }
-        else {
-            applicationRef = await bootstrap();
-        }
-        // Wait until the application is stable.
-        await _whenStable(applicationRef);
-        const injector = applicationRef.injector;
-        const router = injector.get(Router);
-        const routesResults = [];
-        if (router.config.length) {
-            const compiler = injector.get(Compiler);
-            // Retrieve all routes from the Angular router configuration.
-            const traverseRoutes = traverseRoutesConfig({
-                routes: router.config,
-                compiler,
-                parentInjector: injector,
-                parentRoute: '',
-            });
-            for await (const result of traverseRoutes) {
-                routesResults.push(result);
-            }
-        }
-        else {
-            routesResults.push({ route: '' });
-        }
-        const baseHref = injector.get(APP_BASE_HREF, null, { optional: true }) ??
-            injector.get(PlatformLocation).getBaseHrefFromDOM();
-        return {
-            baseHref,
-            routes: routesResults,
-        };
-    }
-    finally {
-        platformRef.destroy();
-    }
-}
-
-/**
- * Manages server-side assets.
- */
-class ServerAssets {
-    /**
-     * Creates an instance of ServerAsset.
-     *
-     * @param manifest - The manifest containing the server assets.
-     */
-    constructor(manifest) {
-        this.manifest = manifest;
-    }
-    /**
-     * Retrieves the content of a server-side asset using its path.
-     *
-     * @param path - The path to the server asset.
-     * @returns A promise that resolves to the asset content as a string.
-     * @throws Error If the asset path is not found in the manifest, an error is thrown.
-     */
-    async getServerAsset(path) {
-        const asset = this.manifest.assets.get(path);
-        if (!asset) {
-            throw new Error(`Server asset '${path}' does not exist.`);
-        }
-        return asset();
-    }
-    /**
-     * Retrieves and caches the content of 'index.server.html'.
-     *
-     * @returns A promise that resolves to the content of 'index.server.html'.
-     * @throws Error If there is an issue retrieving the asset.
-     */
-    getIndexServerHtml() {
-        return this.getServerAsset('index.server.html');
-    }
-}
-
-/**
- * Manages a collection of hooks and provides methods to register and execute them.
- * Hooks are functions that can be invoked with specific arguments to allow modifications or enhancements.
- */
-class Hooks {
-    constructor() {
-        /**
-         * A map of hook names to arrays of hook functions.
-         * Each hook name can have multiple associated functions, which are executed in sequence.
-         */
-        this.store = new Map();
-    }
-    /**
-     * Executes all hooks associated with the specified name, passing the given argument to each hook function.
-     * The hooks are invoked sequentially, and the argument may be modified by each hook.
-     *
-     * @template Hook - The type of the hook name. It should be one of the keys of `HooksMapping`.
-     * @param name - The name of the hook whose functions will be executed.
-     * @param context - The input value to be passed to each hook function. The value is mutated by each hook function.
-     * @returns A promise that resolves once all hook functions have been executed.
-     *
-     * @example
-     * ```typescript
-     * const hooks = new Hooks();
-     * hooks.on('html:transform:pre', async (ctx) => {
-     *   ctx.html = ctx.html.replace(/foo/g, 'bar');
-     *   return ctx.html;
-     * });
-     * const result = await hooks.run('html:transform:pre', { html: '<div>foo</div>' });
-     * console.log(result); // '<div>bar</div>'
-     * ```
-     * @internal
-     */
-    async run(name, context) {
-        const hooks = this.store.get(name);
-        switch (name) {
-            case 'html:transform:pre': {
-                if (!hooks) {
-                    return context.html;
-                }
-                const ctx = { ...context };
-                for (const hook of hooks) {
-                    ctx.html = await hook(ctx);
-                }
-                return ctx.html;
-            }
-            default:
-                throw new Error(`Running hook "${name}" is not supported.`);
-        }
-    }
-    /**
-     * Registers a new hook function under the specified hook name.
-     * This function should be a function that takes an argument of type `T` and returns a `string` or `Promise<string>`.
-     *
-     * @template Hook - The type of the hook name. It should be one of the keys of `HooksMapping`.
-     * @param name - The name of the hook under which the function will be registered.
-     * @param handler - A function to be executed when the hook is triggered. The handler will be called with an argument
-     *                  that may be modified by the hook functions.
-     *
-     * @remarks
-     * - If there are existing handlers registered under the given hook name, the new handler will be added to the list.
-     * - If no handlers are registered under the given hook name, a new list will be created with the handler as its first element.
-     *
-     * @example
-     * ```typescript
-     * hooks.on('html:transform:pre', async (ctx) => {
-     *   return ctx.html.replace(/foo/g, 'bar');
-     * });
-     * ```
-     */
-    on(name, handler) {
-        const hooks = this.store.get(name);
-        if (hooks) {
-            hooks.push(handler);
-        }
-        else {
-            this.store.set(name, [handler]);
-        }
-    }
-    /**
-     * Checks if there are any hooks registered under the specified name.
-     *
-     * @param name - The name of the hook to check.
-     * @returns `true` if there are hooks registered under the specified name, otherwise `false`.
-     */
-    has(name) {
-        return !!this.store.get(name)?.length;
-    }
-}
-
-/**
- * The Angular app manifest object.
- * This is used internally to store the current Angular app manifest.
- */
-let angularAppManifest;
-/**
- * Sets the Angular app manifest.
- *
- * @param manifest - The manifest object to set for the Angular application.
- */
-function setAngularAppManifest(manifest) {
-    angularAppManifest = manifest;
-}
-/**
- * Gets the Angular app manifest.
- *
- * @returns The Angular app manifest.
- * @throws Will throw an error if the Angular app manifest is not set.
- */
-function getAngularAppManifest() {
-    if (!angularAppManifest) {
-        throw new Error('Angular app manifest is not set. ' +
-            `Please ensure you are using the '@angular/build:application' builder to build your server application.`);
-    }
-    return angularAppManifest;
-}
-/**
- * The Angular app engine manifest object.
- * This is used internally to store the current Angular app engine manifest.
- */
-let angularAppEngineManifest;
-/**
- * Sets the Angular app engine manifest.
- *
- * @param manifest - The engine manifest object to set.
- */
-function setAngularAppEngineManifest(manifest) {
-    angularAppEngineManifest = manifest;
-}
-/**
- * Gets the Angular app engine manifest.
- *
- * @returns The Angular app engine manifest.
- * @throws Will throw an error if the Angular app engine manifest is not set.
- */
-function getAngularAppEngineManifest() {
-    if (!angularAppEngineManifest) {
-        throw new Error('Angular app engine manifest is not set. ' +
-            `Please ensure you are using the '@angular/build:application' builder to build your server application.`);
-    }
-    return angularAppEngineManifest;
+ * @param value - The value to be checked.
+ * @returns True if the value is an Angular module (i.e., it has the `ɵmod` property), false otherwise.
+ */
+function isNgModule(value) {
+    return 'ɵmod' in value;
 }
 
 /**
@@ -655,6 +421,259 @@ class RouteTree {
     }
 }
 
+/**
+ * Recursively traverses the Angular router configuration to retrieve routes.
+ *
+ * Iterates through the router configuration, yielding each route along with its potential
+ * redirection or error status. Handles nested routes and lazy-loaded child routes.
+ *
+ * @param options - An object containing the parameters for traversing routes.
+ * @returns An async iterator yielding `RouteResult` objects.
+ */
+async function* traverseRoutesConfig(options) {
+    const { routes, compiler, parentInjector, parentRoute } = options;
+    for (const route of routes) {
+        const { path = '', redirectTo, loadChildren, children } = route;
+        const currentRoutePath = joinUrlParts(parentRoute, path);
+        yield {
+            route: currentRoutePath,
+            redirectTo: typeof redirectTo === 'string'
+                ? resolveRedirectTo(currentRoutePath, redirectTo)
+                : undefined,
+        };
+        if (children?.length) {
+            // Recursively process child routes.
+            yield* traverseRoutesConfig({
+                routes: children,
+                compiler,
+                parentInjector,
+                parentRoute: currentRoutePath,
+            });
+        }
+        if (loadChildren) {
+            // Load and process lazy-loaded child routes.
+            const loadedChildRoutes = await _loadChildren(route, compiler, parentInjector).toPromise();
+            if (loadedChildRoutes) {
+                const { routes: childRoutes, injector = parentInjector } = loadedChildRoutes;
+                yield* traverseRoutesConfig({
+                    routes: childRoutes,
+                    compiler,
+                    parentInjector: injector,
+                    parentRoute: currentRoutePath,
+                });
+            }
+        }
+    }
+}
+/**
+ * Resolves the `redirectTo` property for a given route.
+ *
+ * This function processes the `redirectTo` property to ensure that it correctly
+ * resolves relative to the current route path. If `redirectTo` is an absolute path,
+ * it is returned as is. If it is a relative path, it is resolved based on the current route path.
+ *
+ * @param routePath - The current route path.
+ * @param redirectTo - The target path for redirection.
+ * @returns The resolved redirect path as a string.
+ */
+function resolveRedirectTo(routePath, redirectTo) {
+    if (redirectTo[0] === '/') {
+        // If the redirectTo path is absolute, return it as is.
+        return redirectTo;
+    }
+    // Resolve relative redirectTo based on the current route path.
+    const segments = routePath.split('/');
+    segments.pop(); // Remove the last segment to make it relative.
+    return joinUrlParts(...segments, redirectTo);
+}
+/**
+ * Retrieves routes from the given Angular application.
+ *
+ * This function initializes an Angular platform, bootstraps the application or module,
+ * and retrieves routes from the Angular router configuration. It handles both module-based
+ * and function-based bootstrapping. It yields the resulting routes as `RouteResult` objects.
+ *
+ * @param bootstrap - A function that returns a promise resolving to an `ApplicationRef` or an Angular module to bootstrap.
+ * @param document - The initial HTML document used for server-side rendering.
+ * This document is necessary to render the application on the server.
+ * @param url - The URL for server-side rendering. The URL is used to configure `ServerPlatformLocation`. This configuration is crucial
+ * for ensuring that API requests for relative paths succeed, which is essential for accurate route extraction.
+ * See:
+ *  - https://github.com/angular/angular/blob/d608b857c689d17a7ffa33bbb510301014d24a17/packages/platform-server/src/location.ts#L51
+ *  - https://github.com/angular/angular/blob/6882cc7d9eed26d3caeedca027452367ba25f2b9/packages/platform-server/src/http.ts#L44
+ * @returns A promise that resolves to an object of type `AngularRouterConfigResult`.
+ */
+async function getRoutesFromAngularRouterConfig(bootstrap, document, url) {
+    const { protocol, host } = url;
+    // Create and initialize the Angular platform for server-side rendering.
+    const platformRef = createPlatformFactory(platformCore, 'server', [
+        {
+            provide: INITIAL_CONFIG,
+            useValue: { document, url: `${protocol}//${host}/` },
+        },
+        {
+            provide: _Console,
+            useFactory: () => new Console(),
+        },
+        ..._INTERNAL_SERVER_PLATFORM_PROVIDERS,
+    ])();
+    try {
+        let applicationRef;
+        if (isNgModule(bootstrap)) {
+            const moduleRef = await platformRef.bootstrapModule(bootstrap);
+            applicationRef = moduleRef.injector.get(ApplicationRef);
+        }
+        else {
+            applicationRef = await bootstrap();
+        }
+        // Wait until the application is stable.
+        await _whenStable(applicationRef);
+        const injector = applicationRef.injector;
+        const router = injector.get(Router);
+        const routesResults = [];
+        if (router.config.length) {
+            const compiler = injector.get(Compiler);
+            // Retrieve all routes from the Angular router configuration.
+            const traverseRoutes = traverseRoutesConfig({
+                routes: router.config,
+                compiler,
+                parentInjector: injector,
+                parentRoute: '',
+            });
+            for await (const result of traverseRoutes) {
+                routesResults.push(result);
+            }
+        }
+        else {
+            routesResults.push({ route: '' });
+        }
+        const baseHref = injector.get(APP_BASE_HREF, null, { optional: true }) ??
+            injector.get(PlatformLocation).getBaseHrefFromDOM();
+        return {
+            baseHref,
+            routes: routesResults,
+        };
+    }
+    finally {
+        platformRef.destroy();
+    }
+}
+/**
+ * Asynchronously extracts routes from the Angular application configuration
+ * and creates a `RouteTree` to manage server-side routing.
+ *
+ * @param url - The URL for server-side rendering. The URL is used to configure `ServerPlatformLocation`. This configuration is crucial
+ * for ensuring that API requests for relative paths succeed, which is essential for accurate route extraction.
+ * See:
+ *  - https://github.com/angular/angular/blob/d608b857c689d17a7ffa33bbb510301014d24a17/packages/platform-server/src/location.ts#L51
+ *  - https://github.com/angular/angular/blob/6882cc7d9eed26d3caeedca027452367ba25f2b9/packages/platform-server/src/http.ts#L44
+ * @param manifest - An optional `AngularAppManifest` that contains the application's routing and configuration details.
+ * If not provided, the default manifest is retrieved using `getAngularAppManifest()`.
+ *
+ * @returns A promise that resolves to a populated `RouteTree` containing all extracted routes from the Angular application.
+ */
+async function extractRoutesAndCreateRouteTree(url, manifest = getAngularAppManifest()) {
+    const routeTree = new RouteTree();
+    const document = await new ServerAssets(manifest).getIndexServerHtml();
+    const { baseHref, routes } = await getRoutesFromAngularRouterConfig(manifest.bootstrap(), document, url);
+    for (let { route, redirectTo } of routes) {
+        route = joinUrlParts(baseHref, route);
+        redirectTo = redirectTo === undefined ? undefined : joinUrlParts(baseHref, redirectTo);
+        routeTree.insert(route, { redirectTo });
+    }
+    return routeTree;
+}
+
+/**
+ * Manages a collection of hooks and provides methods to register and execute them.
+ * Hooks are functions that can be invoked with specific arguments to allow modifications or enhancements.
+ */
+class Hooks {
+    constructor() {
+        /**
+         * A map of hook names to arrays of hook functions.
+         * Each hook name can have multiple associated functions, which are executed in sequence.
+         */
+        this.store = new Map();
+    }
+    /**
+     * Executes all hooks associated with the specified name, passing the given argument to each hook function.
+     * The hooks are invoked sequentially, and the argument may be modified by each hook.
+     *
+     * @template Hook - The type of the hook name. It should be one of the keys of `HooksMapping`.
+     * @param name - The name of the hook whose functions will be executed.
+     * @param context - The input value to be passed to each hook function. The value is mutated by each hook function.
+     * @returns A promise that resolves once all hook functions have been executed.
+     *
+     * @example
+     * ```typescript
+     * const hooks = new Hooks();
+     * hooks.on('html:transform:pre', async (ctx) => {
+     *   ctx.html = ctx.html.replace(/foo/g, 'bar');
+     *   return ctx.html;
+     * });
+     * const result = await hooks.run('html:transform:pre', { html: '<div>foo</div>' });
+     * console.log(result); // '<div>bar</div>'
+     * ```
+     * @internal
+     */
+    async run(name, context) {
+        const hooks = this.store.get(name);
+        switch (name) {
+            case 'html:transform:pre': {
+                if (!hooks) {
+                    return context.html;
+                }
+                const ctx = { ...context };
+                for (const hook of hooks) {
+                    ctx.html = await hook(ctx);
+                }
+                return ctx.html;
+            }
+            default:
+                throw new Error(`Running hook "${name}" is not supported.`);
+        }
+    }
+    /**
+     * Registers a new hook function under the specified hook name.
+     * This function should be a function that takes an argument of type `T` and returns a `string` or `Promise<string>`.
+     *
+     * @template Hook - The type of the hook name. It should be one of the keys of `HooksMapping`.
+     * @param name - The name of the hook under which the function will be registered.
+     * @param handler - A function to be executed when the hook is triggered. The handler will be called with an argument
+     *                  that may be modified by the hook functions.
+     *
+     * @remarks
+     * - If there are existing handlers registered under the given hook name, the new handler will be added to the list.
+     * - If no handlers are registered under the given hook name, a new list will be created with the handler as its first element.
+     *
+     * @example
+     * ```typescript
+     * hooks.on('html:transform:pre', async (ctx) => {
+     *   return ctx.html.replace(/foo/g, 'bar');
+     * });
+     * ```
+     */
+    on(name, handler) {
+        const hooks = this.store.get(name);
+        if (hooks) {
+            hooks.push(handler);
+        }
+        else {
+            this.store.set(name, [handler]);
+        }
+    }
+    /**
+     * Checks if there are any hooks registered under the specified name.
+     *
+     * @param name - The name of the hook to check.
+     * @returns `true` if there are hooks registered under the specified name, otherwise `false`.
+     */
+    has(name) {
+        return !!this.store.get(name)?.length;
+    }
+}
+
 /**
  * Manages the application's server routing logic by building and maintaining a route tree.
  *
@@ -696,22 +715,11 @@ class ServerRouter {
         }
         // Create and store a new promise for the build process.
         // This prevents concurrent builds by re-using the same promise.
-        ServerRouter.#extractionPromise ??= (async () => {
-            try {
-                const routeTree = new RouteTree();
-                const document = await new ServerAssets(manifest).getIndexServerHtml();
-                const { baseHref, routes } = await getRoutesFromAngularRouterConfig(manifest.bootstrap(), document, url);
-                for (let { route, redirectTo } of routes) {
-                    route = joinUrlParts(baseHref, route);
-                    redirectTo = redirectTo === undefined ? undefined : joinUrlParts(baseHref, redirectTo);
-                    routeTree.insert(route, { redirectTo });
-                }
-                return new ServerRouter(routeTree);
-            }
-            finally {
-                ServerRouter.#extractionPromise = undefined;
-            }
-        })();
+        ServerRouter.#extractionPromise ??= extractRoutesAndCreateRouteTree(url, manifest)
+            .then((routeTree) => new ServerRouter(routeTree))
+            .finally(() => {
+            ServerRouter.#extractionPromise = undefined;
+        });
         return ServerRouter.#extractionPromise;
     }
     /**
@@ -1016,12 +1024,6 @@ class AngularServerApp {
                 useValue: responseInit,
             });
         }
-        if (typeof ngDevMode === 'undefined' || ngDevMode) {
-            // Need to clean up GENERATED_COMP_IDS map in `@angular/core`.
-            // Otherwise an incorrect component ID generation collision detected warning will be displayed in development.
-            // See: https://github.com/angular/angular-cli/issues/25924
-            _resetCompiledComponents();
-        }
         const { manifest, hooks, assets } = this;
         let html = await assets.getIndexServerHtml();
         // Skip extra microtask if there are no pre hooks.
@@ -1058,6 +1060,12 @@ function getOrCreateAngularServerApp() {
  * typically when server configuration or application state needs to be refreshed.
  */
 function destroyAngularServerApp() {
+    if (typeof ngDevMode === 'undefined' || ngDevMode) {
+        // Need to clean up GENERATED_COMP_IDS map in `@angular/core`.
+        // Otherwise an incorrect component ID generation collision detected warning will be displayed in development.
+        // See: https://github.com/angular/angular-cli/issues/25924
+        _resetCompiledComponents();
+    }
     angularServerApp = undefined;
 }
 
@@ -1202,5 +1210,7 @@ function destroyAngularAppEngine() {
     angularAppEngine = undefined;
 }
 
-export { destroyAngularAppEngine, getOrCreateAngularAppEngine, AngularAppEngine as ɵAngularAppEngine, InlineCriticalCssProcessor as ɵInlineCriticalCssProcessor, ServerRenderContext as ɵServerRenderContext, destroyAngularServerApp as ɵdestroyAngularServerApp, getOrCreateAngularServerApp as ɵgetOrCreateAngularServerApp, getRoutesFromAngularRouterConfig as ɵgetRoutesFromAngularRouterConfig, setAngularAppEngineManifest as ɵsetAngularAppEngineManifest, setAngularAppManifest as ɵsetAngularAppManifest };
+// ɵgetRoutesFromAngularRouterConfig is only used by the Webpack based server builder.
+
+export { destroyAngularAppEngine, getOrCreateAngularAppEngine, AngularAppEngine as ɵAngularAppEngine, InlineCriticalCssProcessor as ɵInlineCriticalCssProcessor, ServerRenderContext as ɵServerRenderContext, destroyAngularServerApp as ɵdestroyAngularServerApp, extractRoutesAndCreateRouteTree as ɵextractRoutesAndCreateRouteTree, getOrCreateAngularServerApp as ɵgetOrCreateAngularServerApp, getRoutesFromAngularRouterConfig as ɵgetRoutesFromAngularRouterConfig, setAngularAppEngineManifest as ɵsetAngularAppEngineManifest, setAngularAppManifest as ɵsetAngularAppManifest };
 //# sourceMappingURL=ssr.mjs.map