@angular/ssr 19.0.2 → 19.0.4

package/index.d.ts

@@ -35,6 +35,10 @@ export declare class AngularAppEngine {
      * The manifest for the server application.
      */
     private readonly manifest;
+    /**
+     * The number of entry points available in the server application's manifest.
+     */
+    private readonly entryPointsCount;
     /**
      * A cache that holds entry points, keyed by their potential locale string.
      */
@@ -89,12 +93,12 @@ export declare class AngularAppEngine {
  */
 declare interface AngularAppEngineManifest {
     /**
-     * A map of entry points for the server application.
-     * Each entry in the map consists of:
+     * A readonly record of entry points for the server application.
+     * Each entry consists of:
      * - `key`: The base href for the entry point.
      * - `value`: A function that returns a promise resolving to an object of type `EntryPointExports`.
      */
-    readonly entryPoints: ReadonlyMap<string, () => Promise<EntryPointExports>>;
+    readonly entryPoints: Readonly<Record<string, (() => Promise<EntryPointExports>) | undefined>>;
     /**
      * The base path for the server application.
      * This is used to determine the root path of the application.
@@ -107,12 +111,17 @@ declare interface AngularAppEngineManifest {
  */
 declare interface AngularAppManifest {
     /**
-     * A map of assets required by the server application.
-     * Each entry in the map consists of:
+     * The base href for the application.
+     * This is used to determine the root path of the application.
+     */
+    readonly baseHref: string;
+    /**
+     * A readonly record of assets required by the server application.
+     * Each entry consists of:
      * - `key`: The path of the asset.
-     * - `value`: A function returning a promise that resolves to the file contents of the asset.
+     * - `value`: An object of type `ServerAsset`.
      */
-    readonly assets: ReadonlyMap<string, ServerAsset>;
+    readonly assets: Readonly<Record<string, ServerAsset | undefined>>;
     /**
      * The bootstrap mechanism for the server application.
      * A function that returns a promise that resolves to an `NgModule` or a function
@@ -269,13 +278,24 @@ declare class AngularServerApp {
      */
     private handleRendering;
     /**
-     * Returns a promise that rejects if the request is aborted.
+     * Constructs the asset path on the server based on the provided HTTP request.
      *
-     * @param request - The HTTP request object being monitored for abortion.
-     * @returns A promise that never resolves and rejects with an `AbortError`
-     * if the request is aborted.
+     * This method processes the incoming request URL to derive a path corresponding
+     * to the requested asset. It ensures the path points to the correct file (e.g.,
+     * `index.html`) and removes any base href if it is not part of the asset path.
+     *
+     * @param request - The incoming HTTP request object.
+     * @returns The server-relative asset path derived from the request.
      */
-    private waitForRequestAbort;
+    private buildServerAssetPathFromRequest;
+    /**
+     * Runs the registered transform hooks on the given HTML content.
+     *
+     * @param html - The raw HTML content to be transformed.
+     * @param url - The URL associated with the HTML content, used for context during transformations.
+     * @returns A promise that resolves to the transformed HTML string.
+     */
+    private runTransformsOnHtml;
 }
 
 /**
@@ -473,8 +493,6 @@ export declare enum PrerenderFallback {
  * @param options - (Optional) An object containing additional configuration options for server routes.
  * @returns An `EnvironmentProviders` instance with the server routes configuration.
  *
- * @returns An `EnvironmentProviders` object that contains the server routes configuration.
- *
  * @see {@link ServerRoute}
  * @see {@link ServerRoutesConfigOptions}
  * @developerPreview
@@ -694,7 +712,7 @@ declare type RouteTreeNodeMetadataWithoutRoute = Omit<RouteTreeNodeMetadata, 'ro
 declare type SerializableRouteTreeNode = ReadonlyArray<RouteTreeNodeMetadata>;
 
 /**
- * Represents of a server asset stored in the manifest.
+ * Represents a server asset stored in the manifest.
  */
 declare interface ServerAsset {
     /**
@@ -844,23 +862,31 @@ export declare function ɵdestroyAngularServerApp(): void;
  * 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()`.
- * @param invokeGetPrerenderParams - A boolean flag indicating whether to invoke `getPrerenderParams` for parameterized SSG routes
- * to handle prerendering paths. Defaults to `false`.
- * @param includePrerenderFallbackRoutes - A flag indicating whether to include fallback routes in the result. Defaults to `true`.
+ * @param options - An object containing the following options:
+ *  - `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
+ *  - `manifest`: An optional `AngularAppManifest` that contains the application's routing and configuration details.
+ *     If not provided, the default manifest is retrieved using `getAngularAppManifest()`.
+ *  - `invokeGetPrerenderParams`: A boolean flag indicating whether to invoke `getPrerenderParams` for parameterized SSG routes
+ *     to handle prerendering paths. Defaults to `false`.
+ *  - `includePrerenderFallbackRoutes`: A flag indicating whether to include fallback routes in the result. Defaults to `true`.
+ *  - `signal`: An optional `AbortSignal` that can be used to abort the operation.
  *
  * @returns A promise that resolves to an object containing:
  *  - `routeTree`: A populated `RouteTree` containing all extracted routes from the Angular application.
  *  - `appShellRoute`: The specified route for the app-shell, if configured.
  *  - `errors`: An array of strings representing any errors encountered during the route extraction process.
  */
-export declare function ɵextractRoutesAndCreateRouteTree(url: URL, manifest?: AngularAppManifest, invokeGetPrerenderParams?: boolean, includePrerenderFallbackRoutes?: boolean): Promise<{
+export declare function ɵextractRoutesAndCreateRouteTree(options: {
+    url: URL;
+    manifest?: AngularAppManifest;
+    invokeGetPrerenderParams?: boolean;
+    includePrerenderFallbackRoutes?: boolean;
+    signal?: AbortSignal;
+}): Promise<{
     routeTree: RouteTree;
     appShellRoute?: string;
     errors: string[];

package/node/index.d.ts

@@ -187,6 +187,6 @@ export declare type NodeRequestHandlerFunction = (req: IncomingMessage, res: Ser
  * @returns A promise that resolves once the streaming operation is complete.
  * @developerPreview
  */
-export declare function writeResponseToNodeResponse(source: Response, destination: ServerResponse | Http2ServerResponse<Http2ServerRequest>): Promise<void>;
+export declare function writeResponseToNodeResponse(source: Response, destination: ServerResponse | Http2ServerResponse): Promise<void>;
 
 export { }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@angular/ssr",
-  "version": "19.0.2",
+  "version": "19.0.4",
   "description": "Angular server side rendering utilities",
   "license": "MIT",
   "homepage": "https://github.com/angular/angular-cli",