fix(@angular/ssr): include requestContext in RequestHandlerFunction

Added the missing `requestContext` parameter to the `RequestHandlerFunction`.

goldens/public-api/angular/ssr/index.api.md

@@ -33,6 +33,9 @@ export enum RenderMode {
     Server = 1
 }
 
+// @public
+export type RequestHandlerFunction = (request: Request, requestContext?: unknown) => Promise<Response | null> | null | Response;
+
 // @public
 export type ServerRoute = ServerRouteAppShell | ServerRouteClient | ServerRoutePrerender | ServerRoutePrerenderWithParams | ServerRouteServer;
 

goldens/public-api/angular/ssr/node/index.api.md

@@ -43,14 +43,17 @@ export interface CommonEngineRenderOptions {
 }
 
 // @public
-export function createNodeRequestHandler<T extends RequestHandlerFunction>(handler: T): T;
+export function createNodeRequestHandler<T extends NodeRequestHandlerFunction>(handler: T): T;
 
 // @public
 export function createWebRequestFromNodeRequest(nodeRequest: IncomingMessage): Request;
 
 // @public
 export function isMainModule(url: string): boolean;
 
+// @public
+export type NodeRequestHandlerFunction = (req: IncomingMessage, res: ServerResponse, next: (err?: unknown) => void) => Promise<void> | void;
+
 // @public
 export function writeResponseToNodeResponse(source: Response, destination: ServerResponse): Promise<void>;
 

packages/angular/ssr/node/public_api.ts

@@ -14,7 +14,7 @@ export {
 
 export { AngularNodeAppEngine } from './src/app-engine';
 
-export { createNodeRequestHandler } from './src/handler';
+export { createNodeRequestHandler, type NodeRequestHandlerFunction } from './src/handler';
 export { writeResponseToNodeResponse } from './src/response';
 export { createWebRequestFromNodeRequest } from './src/request';
 export { isMainModule } from './src/module';

packages/angular/ssr/node/src/handler.ts

@@ -16,8 +16,10 @@ import type { IncomingMessage, ServerResponse } from 'node:http';
  * @param next - A callback function that signals the completion of the middleware or forwards the error if provided.
  *
  * @returns A Promise that resolves to void or simply void. The handler can be asynchronous.
+ *
+ * @developerPreview
  */
-type RequestHandlerFunction = (
+export type NodeRequestHandlerFunction = (
   req: IncomingMessage,
   res: ServerResponse,
   next: (err?: unknown) => void,
@@ -67,7 +69,7 @@ type RequestHandlerFunction = (
  * ```
  * @developerPreview
  */
-export function createNodeRequestHandler<T extends RequestHandlerFunction>(handler: T): T {
+export function createNodeRequestHandler<T extends NodeRequestHandlerFunction>(handler: T): T {
   (handler as T & { __ng_node_request_handler__?: boolean })['__ng_node_request_handler__'] = true;
 
   return handler;

packages/angular/ssr/public_api.ts

@@ -9,7 +9,7 @@
 export * from './private_export';
 
 export { AngularAppEngine } from './src/app-engine';
-export { createRequestHandler } from './src/handler';
+export { createRequestHandler, type RequestHandlerFunction } from './src/handler';
 
 export {
   type PrerenderFallback,

packages/angular/ssr/src/handler.ts

@@ -9,11 +9,17 @@
 /**
  * Function for handling HTTP requests in a web environment.
  *
- * @param request - The incoming HTTP request object.
+ * @param request - The incoming HTTP request object
+ * @param requestContext - Optional additional context for rendering, such as request metadata.
  * @returns A Promise resolving to a `Response` object, `null`, or directly a `Response`,
  * supporting both synchronous and asynchronous handling.
+ *
+ * @developerPreview
  */
-type RequestHandlerFunction = (request: Request) => Promise<Response | null> | null | Response;
+export type RequestHandlerFunction = (
+  request: Request,
+  requestContext?: unknown,
+) => Promise<Response | null> | null | Response;
 
 /**
  * Annotates a request handler function with metadata, marking it as a special