refactor: simplify user code

Author: pieh

demo/server.ts

@@ -1,15 +1,11 @@
 import { CommonEngine } from '@angular/ssr/node'
+import { render } from '@netlify/angular-runtime/common-engine'
 
 const commonEngine = new CommonEngine()
 
-export default async function HttpHandler(
-  request: Request,
-  context: any,
-  commonEngineRenderArgs: any,
-): Promise<Response> {
-  // customize if you want to
+// 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 new Response(await commonEngine.render(commonEngineRenderArgs), {
-    headers: { 'content-type': 'text/html' },
-  })
+  return await render(commonEngine)
 }

demo/src/app/app.routes.server.ts

@@ -1,6 +1,9 @@
 import { RenderMode, ServerRoute } from '@angular/ssr'
 
 export const serverRoutes: ServerRoute[] = [
+  // dashboard component demonstrates "netlify.request" and "netlify.context" injection injection
+  // which only really work for SSR, so we are forcing SSR mode here
+  { path: 'dashboard', renderMode: RenderMode.Server },
   { path: 'detail/:id', renderMode: RenderMode.Server },
   {
     path: '**',

demo/tsconfig.json

@@ -13,7 +13,7 @@
     "sourceMap": true,
     "declaration": false,
     "experimentalDecorators": true,
-    "moduleResolution": "node",
+    "moduleResolution": "bundler",
     "importHelpers": true,
     "target": "ES2022",
     "module": "ES2022",

package-lock.json

@@ -5,9 +5,22 @@
   "main": "src/index.js",
   "files": [
     "src/**/*.js",
+    "src/**/*.mjs",
     "src/**/*.json",
     "manifest.yml"
   ],
+  "exports": {
+    "./package.json": {
+      "default": "./package.json"
+    },
+    ".": {
+      "default": "./src/index.js"
+    },
+    "./common-engine": {
+      "types": "./src/common-engine.d.ts",
+      "default": "./src/common-engine.mjs"
+    }
+  },
   "scripts": {
     "format": "run-s format:check-fix:*",
     "format:ci": "run-s format:check:*",
@@ -60,6 +73,7 @@
     "node": ">=18.13.0"
   },
   "devDependencies": {
+    "@angular/ssr": "^19.0.0-rc.1",
     "@opentelemetry/api": "~1.8.0",
     "@netlify/eslint-config-node": "^7.0.1",
     "@types/node": "^16.3.1",
@@ -74,6 +88,14 @@
     "fs-extra": "^11.1.1",
     "semver": "^7.5.4"
   },
+  "peerDependencies": {
+    "@angular/ssr": "^19.0.0-rc.1"
+  },
+  "peerDependenciesMeta": {
+    "@angular/ssr": {
+      "optional": true
+    }
+  },
   "jest": {
     "testMatch": [
       "**/test/**/*.js"

package.json

@@ -0,0 +1,3 @@
+import { CommonEngine } from '@angular/ssr/node'
+
+export declare function render(commonEngine: CommonEngine): Promise<Response>

src/common-engine.d.ts

@@ -0,0 +1,6 @@
+export const render = async (commonEngine) => {
+  const commonEngineRenderArgs = globalThis.CommonEngineArgsFactory.get()
+  return new Response(await commonEngine.render(commonEngineRenderArgs), {
+    headers: { 'content-type': 'text/html' },
+  })
+}