docs: update readme for angular@19

Author: pieh

README.md

@@ -76,10 +76,71 @@ To test this in local development, run your Angular project using `netlify serve
 ```sh
 netlify serve
 ```
+### App Engine Developer Preview usage with Angular@19
 
-## Limitations
+If you opt into the App Engine Developer Preview accessing `Request` and `Context` objects is streamlined. Instead of custom Netlify prefixed providers, you should use the standardized injection tokens for those provided by `@angular/ssr` instead:
 
-- The [`server.ts` file](https://angular.dev/guide/ssr#configure-server-side-rendering) that's part of the Angular scaffolding is meant for deploying to a VM, and is not compatible with this Netlify build plugin. If you applied changes to that file, you'll need to replicate them in an Edge Function. See (#135)[https://github.com/netlify/angular-runtime/issues/135] for an example.
+```diff
++import { REQUEST, REQUEST_CONTEXT } from '@angular/ssr/tokens'
+import type { Context } from "@netlify/edge-functions"
+
+export class FooComponent {
+
+  constructor(
+    // ...
+-    @Inject('netlify.request') @Optional() request?: Request,
+-    @Inject('netlify.context') @Optional() context?: Context,
++    @Inject(REQUEST) @Optional() request?: Request,
++    @Inject(REQUEST_CONTEXT) @Optional() context?: Context,
+  ) {
+    console.log(`Rendering Foo for path ${request?.url} from location ${context?.geo?.city}`)
+    // ...
+  }
+  
+}
+```
+
+## Customizing request handling
+
+Starting with Angular@19. The build plugin makes use of `server.ts` file to handle requests. The default Angular scaffolding does generate incompatible code for Netlify so build plugin will generate a compatible `server.ts` file for you automatically. If you need to customize the request handling, you can do so by starting with copying one of code snippets below to your `server.ts` file.
+
+If you did not opt into the App Engine Developer Preview:
+
+```ts
+import { CommonEngine } from '@angular/ssr/node'
+import { render } from '@netlify/angular-runtime/common-engine'
+import type { Context } from "@netlify/edge-functions"
+
+const commonEngine = new CommonEngine()
+
+export default async function HttpHandler(request: Request, context: Context): Promise<Response> {
+  // customize if you want to have custom request handling by checking request.url
+  // and returning instance of Response
+
+  return await render(commonEngine)
+}
+```
+
+If you opted into the App Engine Developer Preview:
+
+```ts
+import { AngularAppEngine, createRequestHandler } from '@angular/ssr'
+import type { Context } from "@netlify/edge-functions"
+
+const angularAppEngine = new AngularAppEngine()
+
+export const reqHandler = createRequestHandler(async (request: Request, context: Context) => {
+  // customize if you want to have custom request handling by checking request.url
+  // and returning instance of Response
+
+  const result = await angularAppEngine.handle(request, context)
+  return result || new Response('Not found', { status: 404 })
+})
+```
+
+### Limitations
+
+The [`server.ts` file](https://angular.dev/guide/ssr#configure-server-side-rendering) that's part of the Angular scaffolding is meant for deploying to a VM, and is not compatible with this Netlify build plugin for Angular@17 and Angular@18. If you applied changes to that file, you'll need to replicate them in an Edge Function. See (#135)[https://github.com/netlify/angular-runtime/issues/135] for an example.
 
 ## CLI Usage
 

src/helpers/serverModuleHelpers.js

@@ -13,10 +13,7 @@ import { render } from '@netlify/angular-runtime/common-engine'
 
 const commonEngine = new CommonEngine()
 
-// eslint-disable-next-line @typescript-eslint/no-unused-vars
 export default async function HttpHandler(request: Request, context: any): Promise<Response> {
-  // customize if you want to have custom request handling
-
   return await render(commonEngine)
 }
 `
@@ -25,7 +22,6 @@ export default async function HttpHandler(request: Request, context: any): Promi
 const NetlifyServerTsAppEngine = /* typescript */ `import { AngularAppEngine, createRequestHandler } from '@angular/ssr'
 const angularAppEngine = new AngularAppEngine()
 
-// @ts-expect-error - createRequestHandler expects a function with single Request argument and doesn't allow context argument
 export const reqHandler = createRequestHandler(async (request: Request, context: any) => {
   const result = await angularAppEngine.handle(request, context)
   return result || new Response('Not found', { status: 404 })