feat(node): support appEngine in Angular 19 und 20

Author: manfredsteyer

libs/native-federation-node/src/lib/utils/fstart-args-parser.ts

@@ -0,0 +1,74 @@
+import * as fs from 'node:fs';
+
+export type FStartArgs = {
+  entry: string;
+  relBundlePath: string;
+  remotesOrManifestUrl: string;
+};
+
+const defaultArgs: FStartArgs = {
+  entry: './server.mjs',
+  remotesOrManifestUrl: '../browser/federation.manifest.json',
+  relBundlePath: '../browser/',
+};
+
+export function parseFStartArgs() {
+  const args: FStartArgs = {
+    entry: '',
+    remotesOrManifestUrl: '',
+    relBundlePath: '',
+  };
+
+  let key = '';
+  for (let i = 2; i < process.argv.length; i++) {
+    const cand = process.argv[i];
+
+    if (cand.startsWith('--')) {
+      const candKey = cand.substring(2);
+      if (defaultArgs[candKey]) {
+        key = candKey;
+      } else {
+        console.error(`switch ${cand} not supported!`);
+        exitWithUsage(defaultArgs);
+      }
+    } else if (key) {
+      args[key] = cand;
+      key = '';
+    } else {
+      console.error(`unreladed value ${cand}!`);
+      exitWithUsage(defaultArgs);
+    }
+  }
+
+  applyDefaultArgs(args);
+
+  return args;
+}
+
+function applyDefaultArgs(args: FStartArgs) {
+  if (args.relBundlePath && !args.remotesOrManifestUrl) {
+    const cand = defaultArgs.relBundlePath + 'federation.manifest.json';
+    if (fs.existsSync(cand)) {
+      args.remotesOrManifestUrl = cand;
+    }
+  }
+
+  args.entry = args.entry || defaultArgs.entry;
+  args.relBundlePath = args.relBundlePath || defaultArgs.relBundlePath;
+  args.remotesOrManifestUrl =
+    args.remotesOrManifestUrl || defaultArgs.remotesOrManifestUrl;
+
+  if (!fs.existsSync(args.remotesOrManifestUrl)) {
+    args.remotesOrManifestUrl = undefined;
+  }
+}
+
+function exitWithUsage(defaultArgs: FStartArgs) {
+  let args = '';
+  for (const key in defaultArgs) {
+    args += `[--${key} ${defaultArgs[key]}] `;
+  }
+
+  console.log('usage: nfstart ' + args);
+  process.exit(1);
+}

libs/native-federation-node/src/lib/utils/fstart.mjs

@@ -0,0 +1,18 @@
+
+import { initNodeFederation } from '../node/init-node-federation';
+import { parseFStartArgs } from './fstart-args-parser';
+
+
+const args = parseFStartArgs();
+
+(async () => {
+
+  await initNodeFederation({
+    ...(args.remotesOrManifestUrl ? {remotesOrManifestUrl: args.remotesOrManifestUrl}: {}),
+    relBundlePath: args.relBundlePath
+  });
+
+  await import(args.entry);
+
+})();
+

libs/native-federation-node/src/lib/utils/fstart.ts

@@ -1,8 +1,8 @@
 {
   "extends": "./tsconfig.json",
   "compilerOptions": {
-    "module": "ES2015",
-    "target": "ES2015",
+    "module": "ES2022",
+    "target": "ES2022",
     "outDir": "../../dist/out-tsc",
     "declaration": true,
     "types": ["node"]
@@ -12,5 +12,5 @@
     "src/**/*.ts",
     "src/lib/node/import-map-store.ts.bak",
     "src/lib/node/federation-resolver.ts.bak"
-  ]
+, "../native-federation/tools/fstart-args-parser.ts", "../native-federation/tools/fstart.ts"  ]
 }

libs/native-federation-node/tsconfig.lib.json

@@ -0,0 +1,16 @@
+const fs = require('fs');
+const path = require('path');
+
+const source = '../../native-federation-node/src/lib/utils/fstart.mjs';
+const dataUrlFile = '../src/tools/fstart-as-data-url.ts';
+
+const filePath = path.resolve(__dirname, source);
+const fileContent = fs.readFileSync(filePath, 'utf8');
+const base64Content = Buffer.from(fileContent).toString('base64');
+
+// const dataUrl = `data:text/javascript;base64,${base64Content}`;
+
+const outputPath = path.resolve(__dirname, dataUrlFile);
+fs.writeFileSync(outputPath, `export const fstart = "${base64Content}";\n`);
+
+console.log('Created data url for fstart');

libs/native-federation/build/create-data-url.js

@@ -1,6 +1,6 @@
 {
   "name": "@angular-architects/native-federation",
-  "version": "20.0.1",
+  "version": "20.0.2",
   "main": "src/index.js",
   "generators": "./collection.json",
   "builders": "./builders.json",

libs/native-federation/package.json

@@ -48,6 +48,7 @@ import {
   I18nConfig,
   translateFederationArtefacts,
 } from '../../utils/i18n';
+import { fstart } from '../../tools/fstart-as-data-url';
 
 function _buildApplication(options, context, pluginsOrExtensions) {
   let extensions;
@@ -266,6 +267,10 @@ export async function* runBuilder(
     }
   }
 
+  if (activateSsr) {
+    writeFstartScript(fedOptions);
+  }
+  
   const hasLocales = i18n?.locales && Object.keys(i18n.locales).length > 0;
   if (hasLocales && localeFilter) {
     translateFederationArtefacts(
@@ -361,6 +366,14 @@ export async function* runBuilder(
 // eslint-disable-next-line @typescript-eslint/no-explicit-any
 export default createBuilder(runBuilder) as any;
 
+function writeFstartScript(fedOptions: FederationOptions) {
+  const serverOutpath = path.join(fedOptions.outputPath, '../server');
+  const fstartPath = path.join(serverOutpath, 'fstart.mjs');
+  const buffer = Buffer.from(fstart, 'base64');
+  fs.mkdirSync(serverOutpath, { recursive: true });
+  fs.writeFileSync(fstartPath, buffer, 'utf-8');
+}
+
 function getLocaleFilter(
   options: ApplicationBuilderOptions,
   runServer: boolean

libs/native-federation/src/builders/build/builder.ts

@@ -266,7 +266,7 @@ function updateWorkspaceConfig(
 
   if (ssr) {
     projectConfig.architect.build.options.ssr = true;
-    projectConfig.architect.esbuild.options.prerender = false;
+    // projectConfig.architect.esbuild.options.prerender = false;
   }
 
   const serve = projectConfig.architect.serve;

libs/native-federation/src/schematics/init/schematic.ts

@@ -424,8 +424,8 @@ export function loadEsmModule<T>(modulePath: string | URL): Promise<T> {
 //
 function setNgServerMode(): void {
   const fileToPatch = 'node_modules/@angular/core/fesm2022/core.mjs';
-  const lineToAdd = `const ngServerMode = (typeof window === 'undefined') ? true : false;`;
-
+  const lineToAdd = `if (typeof globalThis.ngServerMode ==='undefined') globalThis.ngServerMode = (typeof window === 'undefined') ? true : false;`;
+  
   try {
     if (fs.existsSync(fileToPatch)) {
       let content = fs.readFileSync(fileToPatch, 'utf-8');