@angular/ssr 19.0.0-next.1 → 19.0.0-next.10

package/esm2022/src/common-engine/peformance-profiler.mjs

@@ -1,50 +0,0 @@
-/**
- * @license
- * Copyright Google LLC All Rights Reserved.
- *
- * Use of this source code is governed by an MIT-style license that can be
- * found in the LICENSE file at https://angular.dev/license
- */
-const PERFORMANCE_MARK_PREFIX = '🅰️';
-export function printPerformanceLogs() {
-    let maxWordLength = 0;
-    const benchmarks = [];
-    for (const { name, duration } of performance.getEntriesByType('measure')) {
-        if (!name.startsWith(PERFORMANCE_MARK_PREFIX)) {
-            continue;
-        }
-        // `🅰️:Retrieve SSG Page` -> `Retrieve SSG Page:`
-        const step = name.slice(PERFORMANCE_MARK_PREFIX.length + 1) + ':';
-        if (step.length > maxWordLength) {
-            maxWordLength = step.length;
-        }
-        benchmarks.push([step, `${duration.toFixed(1)}ms`]);
-        performance.clearMeasures(name);
-    }
-    /* eslint-disable no-console */
-    console.log('********** Performance results **********');
-    for (const [step, value] of benchmarks) {
-        const spaces = maxWordLength - step.length + 5;
-        console.log(step + ' '.repeat(spaces) + value);
-    }
-    console.log('*****************************************');
-    /* eslint-enable no-console */
-}
-export async function runMethodAndMeasurePerf(label, asyncMethod) {
-    const labelName = `${PERFORMANCE_MARK_PREFIX}:${label}`;
-    const startLabel = `start:${labelName}`;
-    const endLabel = `end:${labelName}`;
-    try {
-        performance.mark(startLabel);
-        return await asyncMethod();
-    }
-    finally {
-        performance.mark(endLabel);
-        performance.measure(labelName, startLabel, endLabel);
-        performance.clearMarks(startLabel);
-        performance.clearMarks(endLabel);
-    }
-}
-export function noopRunMethodAndMeasurePerf(label, asyncMethod) {
-    return asyncMethod();
-}

package/esm2022/src/console.mjs

@@ -1,34 +0,0 @@
-/**
- * @license
- * Copyright Google LLC All Rights Reserved.
- *
- * Use of this source code is governed by an MIT-style license that can be
- * found in the LICENSE file at https://angular.dev/license
- */
-import { ɵConsole } from '@angular/core';
-/**
- * Custom implementation of the Angular Console service that filters out specific log messages.
- *
- * This class extends the internal Angular `ɵConsole` class to provide customized logging behavior.
- * It overrides the `log` method to suppress logs that match certain predefined messages.
- */
-export class Console extends ɵConsole {
-    /**
-     * A set of log messages that should be ignored and not printed to the console.
-     */
-    ignoredLogs = new Set(['Angular is running in development mode.']);
-    /**
-     * Logs a message to the console if it is not in the set of ignored messages.
-     *
-     * @param message - The message to log to the console.
-     *
-     * This method overrides the `log` method of the `ɵConsole` class. It checks if the
-     * message is in the `ignoredLogs` set. If it is not, it delegates the logging to
-     * the parent class's `log` method. Otherwise, the message is suppressed.
-     */
-    log(message) {
-        if (!this.ignoredLogs.has(message)) {
-            super.log(message);
-        }
-    }
-}

package/esm2022/src/hooks.mjs

@@ -1,94 +0,0 @@
-/**
- * @license
- * Copyright Google LLC All Rights Reserved.
- *
- * Use of this source code is governed by an MIT-style license that can be
- * found in the LICENSE file at https://angular.dev/license
- */
-/**
- * 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.
- */
-export class Hooks {
-    /**
-     * A map of hook names to arrays of hook functions.
-     * Each hook name can have multiple associated functions, which are executed in sequence.
-     */
-    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;
-    }
-}

package/esm2022/src/i18n.mjs

@@ -1,41 +0,0 @@
-/**
- * @license
- * Copyright Google LLC All Rights Reserved.
- *
- * Use of this source code is governed by an MIT-style license that can be
- * found in the LICENSE file at https://angular.dev/license
- */
-/**
- * Extracts a potential locale ID from a given URL based on the specified base path.
- *
- * This function parses the URL to locate a potential locale identifier that immediately
- * follows the base path segment in the URL's pathname. If the URL does not contain a valid
- * locale ID, an empty string is returned.
- *
- * @param url - The full URL from which to extract the locale ID.
- * @param basePath - The base path used as the reference point for extracting the locale ID.
- * @returns The extracted locale ID if present, or an empty string if no valid locale ID is found.
- *
- * @example
- * ```js
- * const url = new URL('https://example.com/base/en/page');
- * const basePath = '/base';
- * const localeId = getPotentialLocaleIdFromUrl(url, basePath);
- * console.log(localeId); // Output: 'en'
- * ```
- */
-export function getPotentialLocaleIdFromUrl(url, basePath) {
-    const { pathname } = url;
-    // Move forward of the base path section.
-    let start = basePath.length;
-    if (pathname[start] === '/') {
-        start++;
-    }
-    // Find the next forward slash.
-    let end = pathname.indexOf('/', start);
-    if (end === -1) {
-        end = pathname.length;
-    }
-    // Extract the potential locale id.
-    return pathname.slice(start, end);
-}

package/esm2022/src/manifest.mjs

@@ -1,59 +0,0 @@
-/**
- * @license
- * Copyright Google LLC All Rights Reserved.
- *
- * Use of this source code is governed by an MIT-style license that can be
- * found in the LICENSE file at https://angular.dev/license
- */
-/**
- * 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.
- */
-export 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.
- */
-export 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.
- */
-export 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.
- */
-export 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;
-}

package/esm2022/src/request.mjs

@@ -1,63 +0,0 @@
-/**
- * @license
- * Copyright Google LLC All Rights Reserved.
- *
- * Use of this source code is governed by an MIT-style license that can be
- * found in the LICENSE file at https://angular.dev/license
- */
-/**
- * Converts a Node.js `IncomingMessage` into a Web Standard `Request`.
- *
- * @param nodeRequest - The Node.js `IncomingMessage` object to convert.
- * @returns A Web Standard `Request` object.
- */
-export function createWebRequestFromNodeRequest(nodeRequest) {
-    const { headers, method = 'GET' } = nodeRequest;
-    const withBody = method !== 'GET' && method !== 'HEAD';
-    return new Request(createRequestUrl(nodeRequest), {
-        method,
-        headers: createRequestHeaders(headers),
-        body: withBody ? nodeRequest : undefined,
-        duplex: withBody ? 'half' : undefined,
-    });
-}
-/**
- * Creates a `Headers` object from Node.js `IncomingHttpHeaders`.
- *
- * @param nodeHeaders - The Node.js `IncomingHttpHeaders` object to convert.
- * @returns A `Headers` object containing the converted headers.
- */
-function createRequestHeaders(nodeHeaders) {
-    const headers = new Headers();
-    for (const [name, value] of Object.entries(nodeHeaders)) {
-        if (typeof value === 'string') {
-            headers.append(name, value);
-        }
-        else if (Array.isArray(value)) {
-            for (const item of value) {
-                headers.append(name, item);
-            }
-        }
-    }
-    return headers;
-}
-/**
- * Creates a `URL` object from a Node.js `IncomingMessage`, taking into account the protocol, host, and port.
- *
- * @param nodeRequest - The Node.js `IncomingMessage` object to extract URL information from.
- * @returns A `URL` object representing the request URL.
- */
-function createRequestUrl(nodeRequest) {
-    const { headers, socket, url = '' } = nodeRequest;
-    const protocol = headers['x-forwarded-proto'] ?? ('encrypted' in socket && socket.encrypted ? 'https' : 'http');
-    const hostname = headers['x-forwarded-host'] ?? headers.host ?? headers[':authority'];
-    const port = headers['x-forwarded-port'] ?? socket.localPort;
-    if (Array.isArray(hostname)) {
-        throw new Error('host value cannot be an array.');
-    }
-    let hostnameWithPort = hostname;
-    if (port && !hostname?.includes(':')) {
-        hostnameWithPort += `:${port}`;
-    }
-    return new URL(url, `${protocol}://${hostnameWithPort}`);
-}

package/esm2022/src/response.mjs

@@ -1,58 +0,0 @@
-/**
- * @license
- * Copyright Google LLC All Rights Reserved.
- *
- * Use of this source code is governed by an MIT-style license that can be
- * found in the LICENSE file at https://angular.dev/license
- */
-/**
- * Streams a web-standard `Response` into a Node.js `ServerResponse`.
- *
- * @param source - The web-standard `Response` object to stream from.
- * @param destination - The Node.js `ServerResponse` object to stream into.
- * @returns A promise that resolves once the streaming operation is complete.
- */
-export async function writeResponseToNodeResponse(source, destination) {
-    const { status, headers, body } = source;
-    destination.statusCode = status;
-    let cookieHeaderSet = false;
-    for (const [name, value] of headers.entries()) {
-        if (name === 'set-cookie') {
-            if (cookieHeaderSet) {
-                continue;
-            }
-            // Sets the 'set-cookie' header only once to ensure it is correctly applied.
-            // Concatenating 'set-cookie' values can lead to incorrect behavior, so we use a single value from `headers.getSetCookie()`.
-            destination.setHeader(name, headers.getSetCookie());
-            cookieHeaderSet = true;
-        }
-        else {
-            destination.setHeader(name, value);
-        }
-    }
-    if (!body) {
-        destination.end();
-        return;
-    }
-    try {
-        const reader = body.getReader();
-        destination.on('close', () => {
-            reader.cancel().catch((error) => {
-                // eslint-disable-next-line no-console
-                console.error(`An error occurred while writing the response body for: ${destination.req.url}.`, error);
-            });
-        });
-        // eslint-disable-next-line no-constant-condition
-        while (true) {
-            const { done, value } = await reader.read();
-            if (done) {
-                destination.end();
-                break;
-            }
-            destination.write(value);
-        }
-    }
-    catch {
-        destination.end('Internal server error.');
-    }
-}

package/esm2022/src/routes/ng-routes.mjs

@@ -1,157 +0,0 @@
-/**
- * @license
- * Copyright Google LLC All Rights Reserved.
- *
- * Use of this source code is governed by an MIT-style license that can be
- * found in the LICENSE file at https://angular.dev/license
- */
-import { APP_BASE_HREF, PlatformLocation } from '@angular/common';
-import { ApplicationRef, Compiler, createPlatformFactory, platformCore, ɵwhenStable as whenStable, ɵConsole, ɵresetCompiledComponents, } from '@angular/core';
-import { INITIAL_CONFIG, ɵINTERNAL_SERVER_PLATFORM_PROVIDERS as INTERNAL_SERVER_PLATFORM_PROVIDERS, } from '@angular/platform-server';
-import { Router, ɵloadChildren as loadChildrenHelper } from '@angular/router';
-import { Console } from '../console';
-import { isNgModule } from '../utils/ng';
-import { joinUrlParts } from '../utils/url';
-/**
- * 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 loadChildrenHelper(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`.
- */
-export 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();
-    }
-}