feat(@angular/ssr): add attachNodeGlobalErrorHandlers to manage unhandled errors

Implement the `attachNodeGlobalErrorHandlers` function to handle 'unhandledRejection' and 'uncaughtException' events in Node.js. This function logs errors to the console, preventing unhandled errors from crashing the server. It is particularly useful for zoneless apps, ensuring error handling without relying on zones.

Author: alan-agius4

Diff for: goldens/public-api/angular/ssr/node/index.api.md

@@ -16,6 +16,9 @@ export class AngularNodeAppEngine {
     render(request: IncomingMessage, requestContext?: unknown): Promise<Response | null>;
 }
 
+// @public
+export function attachNodeGlobalErrorHandlers(): void;
+
 // @public
 export class CommonEngine {
     constructor(options?: CommonEngineOptions | undefined);

Diff for: packages/angular/ssr/node/public_api.ts

@@ -16,3 +16,4 @@ export { AngularNodeAppEngine } from './src/app-engine';
 
 export { writeResponseToNodeResponse } from './src/response';
 export { createWebRequestFromNodeRequest } from './src/request';
+export { attachNodeGlobalErrorHandlers } from './src/errors';

Diff for: packages/angular/ssr/node/src/errors.ts

@@ -0,0 +1,22 @@
+/**
+ * @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
+ */
+
+/**
+ * Attaches listeners to the Node.js process to capture and handle unhandled rejections and uncaught exceptions.
+ * Captured errors are logged to the console. This function logs errors to the console, preventing unhandled errors
+ * from crashing the server. It is particularly useful for Zoneless apps, ensuring error handling without relying on Zone.js.
+ *
+ * @developerPreview
+ */
+export function attachNodeGlobalErrorHandlers(): void {
+  process
+    // eslint-disable-next-line no-console
+    .on('unhandledRejection', (error) => console.error('unhandledRejection', error))
+    // eslint-disable-next-line no-console
+    .on('uncaughtException', (error) => console.error('uncaughtException', error));
+}