@angular/ssr 0.0.0-PLACEHOLDER → 17.0.0-next.0

package/fesm2022/ssr.mjs

@@ -0,0 +1,289 @@
+import { ɵSERVER_CONTEXT, INITIAL_CONFIG, renderApplication, renderModule } from '@angular/platform-server';
+import * as fs from 'node:fs';
+import { resolve, dirname } from 'node:path';
+import { URL } from 'node:url';
+import Critters from 'critters';
+import { readFile } from 'node:fs/promises';
+
+/**
+ * Pattern used to extract the media query set by Critters in an `onload` handler.
+ */
+const MEDIA_SET_HANDLER_PATTERN = /^this\.media=["'](.*)["'];?$/;
+/**
+ * Name of the attribute used to save the Critters media query so it can be re-assigned on load.
+ */
+const CSP_MEDIA_ATTR = 'ngCspMedia';
+/**
+ * Script text used to change the media value of the link tags.
+ */
+const LINK_LOAD_SCRIPT_CONTENT = [
+    `(() => {`,
+    // Save the `children` in a variable since they're a live DOM node collection.
+    // We iterate over the direct descendants, instead of going through a `querySelectorAll`,
+    // because we know that the tags will be directly inside the `head`.
+    `  const children = document.head.children;`,
+    // Declare `onLoad` outside the loop to avoid leaking memory.
+    // Can't be an arrow function, because we need `this` to refer to the DOM node.
+    `  function onLoad() {this.media = this.getAttribute('${CSP_MEDIA_ATTR}');}`,
+    // Has to use a plain for loop, because some browsers don't support
+    // `forEach` on `children` which is a `HTMLCollection`.
+    `  for (let i = 0; i < children.length; i++) {`,
+    `    const child = children[i];`,
+    `    child.hasAttribute('${CSP_MEDIA_ATTR}') && child.addEventListener('load', onLoad);`,
+    `  }`,
+    `})();`,
+].join('\n');
+class CrittersExtended extends Critters {
+    constructor(optionsExtended, resourceCache) {
+        super({
+            logger: {
+                warn: (s) => this.warnings.push(s),
+                error: (s) => this.errors.push(s),
+                info: () => { },
+            },
+            logLevel: 'warn',
+            path: optionsExtended.outputPath,
+            publicPath: optionsExtended.deployUrl,
+            compress: !!optionsExtended.minify,
+            pruneSource: false,
+            reduceInlineStyles: false,
+            mergeStylesheets: false,
+            // Note: if `preload` changes to anything other than `media`, the logic in
+            // `embedLinkedStylesheetOverride` will have to be updated.
+            preload: 'media',
+            noscriptFallback: true,
+            inlineFonts: true,
+        });
+        this.optionsExtended = optionsExtended;
+        this.resourceCache = resourceCache;
+        this.warnings = [];
+        this.errors = [];
+        this.addedCspScriptsDocuments = new WeakSet();
+        this.documentNonces = new WeakMap();
+        /**
+         * Override of the Critters `embedLinkedStylesheet` method
+         * that makes it work with Angular's CSP APIs.
+         */
+        this.embedLinkedStylesheetOverride = async (link, document) => {
+            if (link.getAttribute('media') === 'print' && link.next?.name === 'noscript') {
+                // Workaround for https://github.com/GoogleChromeLabs/critters/issues/64
+                // NB: this is only needed for the webpack based builders.
+                const media = link.getAttribute('onload')?.match(MEDIA_SET_HANDLER_PATTERN);
+                if (media) {
+                    link.removeAttribute('onload');
+                    link.setAttribute('media', media[1]);
+                    link?.next?.remove();
+                }
+            }
+            const returnValue = await this.initialEmbedLinkedStylesheet(link, document);
+            const cspNonce = this.findCspNonce(document);
+            if (cspNonce) {
+                const crittersMedia = link.getAttribute('onload')?.match(MEDIA_SET_HANDLER_PATTERN);
+                if (crittersMedia) {
+                    // If there's a Critters-generated `onload` handler and the file has an Angular CSP nonce,
+                    // we have to remove the handler, because it's incompatible with CSP. We save the value
+                    // in a different attribute and we generate a script tag with the nonce that uses
+                    // `addEventListener` to apply the media query instead.
+                    link.removeAttribute('onload');
+                    link.setAttribute(CSP_MEDIA_ATTR, crittersMedia[1]);
+                    this.conditionallyInsertCspLoadingScript(document, cspNonce);
+                }
+                // Ideally we would hook in at the time Critters inserts the `style` tags, but there isn't
+                // a way of doing that at the moment so we fall back to doing it any time a `link` tag is
+                // inserted. We mitigate it by only iterating the direct children of the `<head>` which
+                // should be pretty shallow.
+                document.head.children.forEach((child) => {
+                    if (child.tagName === 'style' && !child.hasAttribute('nonce')) {
+                        child.setAttribute('nonce', cspNonce);
+                    }
+                });
+            }
+            return returnValue;
+        };
+        // We can't use inheritance to override `embedLinkedStylesheet`, because it's not declared in
+        // the `Critters` .d.ts which means that we can't call the `super` implementation. TS doesn't
+        // allow for `super` to be cast to a different type.
+        this.initialEmbedLinkedStylesheet = this.embedLinkedStylesheet;
+        this.embedLinkedStylesheet = this.embedLinkedStylesheetOverride;
+    }
+    async readFile(path) {
+        let resourceContent = this.resourceCache.get(path);
+        if (resourceContent === undefined) {
+            resourceContent = await readFile(path, 'utf-8');
+            this.resourceCache.set(path, resourceContent);
+        }
+        return resourceContent;
+    }
+    /**
+     * Finds the CSP nonce for a specific document.
+     */
+    findCspNonce(document) {
+        if (this.documentNonces.has(document)) {
+            // eslint-disable-next-line @typescript-eslint/no-non-null-assertion
+            return this.documentNonces.get(document);
+        }
+        // HTML attribute are case-insensitive, but the parser used by Critters is case-sensitive.
+        const nonceElement = document.querySelector('[ngCspNonce], [ngcspnonce]');
+        const cspNonce = nonceElement?.getAttribute('ngCspNonce') || nonceElement?.getAttribute('ngcspnonce') || null;
+        this.documentNonces.set(document, cspNonce);
+        return cspNonce;
+    }
+    /**
+     * Inserts the `script` tag that swaps the critical CSS at runtime,
+     * if one hasn't been inserted into the document already.
+     */
+    conditionallyInsertCspLoadingScript(document, nonce) {
+        if (this.addedCspScriptsDocuments.has(document)) {
+            return;
+        }
+        if (document.head.textContent.includes(LINK_LOAD_SCRIPT_CONTENT)) {
+            // Script was already added during the build.
+            this.addedCspScriptsDocuments.add(document);
+            return;
+        }
+        const script = document.createElement('script');
+        script.setAttribute('nonce', nonce);
+        script.textContent = LINK_LOAD_SCRIPT_CONTENT;
+        // Append the script to the head since it needs to
+        // run as early as possible, after the `link` tags.
+        document.head.appendChild(script);
+        this.addedCspScriptsDocuments.add(document);
+    }
+}
+class InlineCriticalCssProcessor {
+    constructor(options) {
+        this.options = options;
+        this.resourceCache = new Map();
+    }
+    async process(html, options) {
+        const critters = new CrittersExtended({ ...this.options, ...options }, this.resourceCache);
+        const content = await critters.process(html);
+        return {
+            content,
+            errors: critters.errors.length ? critters.errors : undefined,
+            warnings: critters.warnings.length ? critters.warnings : undefined,
+        };
+    }
+}
+
+const SSG_MARKER_REGEXP = /ng-server-context=["']\w*\|?ssg\|?\w*["']/;
+/**
+ * A common rendering engine utility. This abstracts the logic
+ * for handling the platformServer compiler, the module cache, and
+ * the document loader
+ */
+class CommonEngine {
+    constructor(bootstrap, providers = []) {
+        this.bootstrap = bootstrap;
+        this.providers = providers;
+        this.templateCache = new Map();
+        this.pageIsSSG = new Map();
+        this.inlineCriticalCssProcessor = new InlineCriticalCssProcessor({
+            minify: false,
+        });
+    }
+    /**
+     * Render an HTML document for a specific URL with specified
+     * render options
+     */
+    async render(opts) {
+        const { inlineCriticalCss = true, url } = opts;
+        if (opts.publicPath && opts.documentFilePath && url !== undefined) {
+            const pathname = canParseUrl(url) ? new URL(url).pathname : url;
+            // Remove leading forward slash.
+            const pagePath = resolve(opts.publicPath, pathname.substring(1), 'index.html');
+            if (pagePath !== resolve(opts.documentFilePath)) {
+                // View path doesn't match with prerender path.
+                const pageIsSSG = this.pageIsSSG.get(pagePath);
+                if (pageIsSSG === undefined) {
+                    if (await exists(pagePath)) {
+                        const content = await fs.promises.readFile(pagePath, 'utf-8');
+                        const isSSG = SSG_MARKER_REGEXP.test(content);
+                        this.pageIsSSG.set(pagePath, isSSG);
+                        if (isSSG) {
+                            return content;
+                        }
+                    }
+                    else {
+                        this.pageIsSSG.set(pagePath, false);
+                    }
+                }
+                else if (pageIsSSG) {
+                    // Serve pre-rendered page.
+                    return fs.promises.readFile(pagePath, 'utf-8');
+                }
+            }
+        }
+        // if opts.document dosen't exist then opts.documentFilePath must
+        const extraProviders = [
+            { provide: ɵSERVER_CONTEXT, useValue: 'ssr' },
+            ...(opts.providers ?? []),
+            ...this.providers,
+        ];
+        let document = opts.document;
+        if (!document && opts.documentFilePath) {
+            document = await this.getDocument(opts.documentFilePath);
+        }
+        if (document) {
+            extraProviders.push({
+                provide: INITIAL_CONFIG,
+                useValue: {
+                    document,
+                    url: opts.url,
+                },
+            });
+        }
+        const moduleOrFactory = this.bootstrap || opts.bootstrap;
+        if (!moduleOrFactory) {
+            throw new Error('A module or bootstrap option must be provided.');
+        }
+        const html = await (isBootstrapFn(moduleOrFactory)
+            ? renderApplication(moduleOrFactory, { platformProviders: extraProviders })
+            : renderModule(moduleOrFactory, { extraProviders }));
+        if (!inlineCriticalCss) {
+            return html;
+        }
+        const { content, errors, warnings } = await this.inlineCriticalCssProcessor.process(html, {
+            outputPath: opts.publicPath ?? (opts.documentFilePath ? dirname(opts.documentFilePath) : ''),
+        });
+        // eslint-disable-next-line no-console
+        warnings?.forEach((m) => console.warn(m));
+        // eslint-disable-next-line no-console
+        errors?.forEach((m) => console.error(m));
+        return content;
+    }
+    /** Retrieve the document from the cache or the filesystem */
+    async getDocument(filePath) {
+        let doc = this.templateCache.get(filePath);
+        if (!doc) {
+            doc = await fs.promises.readFile(filePath, 'utf-8');
+            this.templateCache.set(filePath, doc);
+        }
+        return doc;
+    }
+}
+async function exists(path) {
+    try {
+        await fs.promises.access(path, fs.constants.F_OK);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+function isBootstrapFn(value) {
+    // We can differentiate between a module and a bootstrap function by reading `cmp`:
+    return typeof value === 'function' && !('ɵmod' in value);
+}
+// The below can be removed in favor of URL.canParse() when Node.js 18 is dropped
+function canParseUrl(url) {
+    try {
+        return !!new URL(url);
+    }
+    catch {
+        return false;
+    }
+}
+
+export { CommonEngine };
+//# sourceMappingURL=ssr.mjs.map

package/fesm2022/ssr.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"ssr.mjs","sources":["../../../../../../../packages/angular/ssr/src/inline-css-processor.ts","../../../../../../../packages/angular/ssr/src/common-engine.ts"],"sourcesContent":["/**\n * @license\n * Copyright Google LLC All Rights Reserved.\n *\n * Use of this source code is governed by an MIT-style license that can be\n * found in the LICENSE file at https://angular.io/license\n */\n\nimport Critters from 'critters';\nimport { readFile } from 'node:fs/promises';\n\n/**\n * Pattern used to extract the media query set by Critters in an `onload` handler.\n */\nconst MEDIA_SET_HANDLER_PATTERN = /^this\\.media=[\"'](.*)[\"'];?$/;\n\n/**\n * Name of the attribute used to save the Critters media query so it can be re-assigned on load.\n */\nconst CSP_MEDIA_ATTR = 'ngCspMedia';\n\n/**\n * Script text used to change the media value of the link tags.\n */\nconst LINK_LOAD_SCRIPT_CONTENT = [\n  `(() => {`,\n  // Save the `children` in a variable since they're a live DOM node collection.\n  // We iterate over the direct descendants, instead of going through a `querySelectorAll`,\n  // because we know that the tags will be directly inside the `head`.\n  `  const children = document.head.children;`,\n  // Declare `onLoad` outside the loop to avoid leaking memory.\n  // Can't be an arrow function, because we need `this` to refer to the DOM node.\n  `  function onLoad() {this.media = this.getAttribute('${CSP_MEDIA_ATTR}');}`,\n  // Has to use a plain for loop, because some browsers don't support\n  // `forEach` on `children` which is a `HTMLCollection`.\n  `  for (let i = 0; i < children.length; i++) {`,\n  `    const child = children[i];`,\n  `    child.hasAttribute('${CSP_MEDIA_ATTR}') && child.addEventListener('load', onLoad);`,\n  `  }`,\n  `})();`,\n].join('\\n');\n\nexport interface InlineCriticalCssProcessOptions {\n  outputPath?: string;\n}\n\nexport interface InlineCriticalCssProcessorOptions {\n  minify?: boolean;\n  deployUrl?: string;\n}\n\nexport interface InlineCriticalCssResult {\n  content: string;\n  warnings?: string[];\n  errors?: string[];\n}\n\n/** Partial representation of an `HTMLElement`. */\ninterface PartialHTMLElement {\n  getAttribute(name: string): string | null;\n  setAttribute(name: string, value: string): void;\n  hasAttribute(name: string): boolean;\n  removeAttribute(name: string): void;\n  appendChild(child: PartialHTMLElement): void;\n  remove(): void;\n  name: string;\n  textContent: string;\n  tagName: string | null;\n  children: PartialHTMLElement[];\n  next: PartialHTMLElement | null;\n  prev: PartialHTMLElement | null;\n}\n\n/** Partial representation of an HTML `Document`. */\ninterface PartialDocument {\n  head: PartialHTMLElement;\n  createElement(tagName: string): PartialHTMLElement;\n  querySelector(selector: string): PartialHTMLElement | null;\n}\n\n/** Signature of the `Critters.embedLinkedStylesheet` method. */\ntype EmbedLinkedStylesheetFn = (\n  link: PartialHTMLElement,\n  document: PartialDocument,\n) => Promise<unknown>;\n\nclass CrittersExtended extends Critters {\n  readonly warnings: string[] = [];\n  readonly errors: string[] = [];\n  private initialEmbedLinkedStylesheet: EmbedLinkedStylesheetFn;\n  private addedCspScriptsDocuments = new WeakSet<PartialDocument>();\n  private documentNonces = new WeakMap<PartialDocument, string | null>();\n\n  // Inherited from `Critters`, but not exposed in the typings.\n  protected embedLinkedStylesheet!: EmbedLinkedStylesheetFn;\n\n  constructor(\n    readonly optionsExtended: InlineCriticalCssProcessorOptions & InlineCriticalCssProcessOptions,\n    private readonly resourceCache: Map<string, string>,\n  ) {\n    super({\n      logger: {\n        warn: (s: string) => this.warnings.push(s),\n        error: (s: string) => this.errors.push(s),\n        info: () => {},\n      },\n      logLevel: 'warn',\n      path: optionsExtended.outputPath,\n      publicPath: optionsExtended.deployUrl,\n      compress: !!optionsExtended.minify,\n      pruneSource: false,\n      reduceInlineStyles: false,\n      mergeStylesheets: false,\n      // Note: if `preload` changes to anything other than `media`, the logic in\n      // `embedLinkedStylesheetOverride` will have to be updated.\n      preload: 'media',\n      noscriptFallback: true,\n      inlineFonts: true,\n    });\n\n    // We can't use inheritance to override `embedLinkedStylesheet`, because it's not declared in\n    // the `Critters` .d.ts which means that we can't call the `super` implementation. TS doesn't\n    // allow for `super` to be cast to a different type.\n    this.initialEmbedLinkedStylesheet = this.embedLinkedStylesheet;\n    this.embedLinkedStylesheet = this.embedLinkedStylesheetOverride;\n  }\n\n  public override async readFile(path: string): Promise<string> {\n    let resourceContent = this.resourceCache.get(path);\n    if (resourceContent === undefined) {\n      resourceContent = await readFile(path, 'utf-8');\n      this.resourceCache.set(path, resourceContent);\n    }\n\n    return resourceContent;\n  }\n\n  /**\n   * Override of the Critters `embedLinkedStylesheet` method\n   * that makes it work with Angular's CSP APIs.\n   */\n  private embedLinkedStylesheetOverride: EmbedLinkedStylesheetFn = async (link, document) => {\n    if (link.getAttribute('media') === 'print' && link.next?.name === 'noscript') {\n      // Workaround for https://github.com/GoogleChromeLabs/critters/issues/64\n      // NB: this is only needed for the webpack based builders.\n      const media = link.getAttribute('onload')?.match(MEDIA_SET_HANDLER_PATTERN);\n      if (media) {\n        link.removeAttribute('onload');\n        link.setAttribute('media', media[1]);\n        link?.next?.remove();\n      }\n    }\n\n    const returnValue = await this.initialEmbedLinkedStylesheet(link, document);\n    const cspNonce = this.findCspNonce(document);\n\n    if (cspNonce) {\n      const crittersMedia = link.getAttribute('onload')?.match(MEDIA_SET_HANDLER_PATTERN);\n\n      if (crittersMedia) {\n        // If there's a Critters-generated `onload` handler and the file has an Angular CSP nonce,\n        // we have to remove the handler, because it's incompatible with CSP. We save the value\n        // in a different attribute and we generate a script tag with the nonce that uses\n        // `addEventListener` to apply the media query instead.\n        link.removeAttribute('onload');\n        link.setAttribute(CSP_MEDIA_ATTR, crittersMedia[1]);\n        this.conditionallyInsertCspLoadingScript(document, cspNonce);\n      }\n\n      // Ideally we would hook in at the time Critters inserts the `style` tags, but there isn't\n      // a way of doing that at the moment so we fall back to doing it any time a `link` tag is\n      // inserted. We mitigate it by only iterating the direct children of the `<head>` which\n      // should be pretty shallow.\n      document.head.children.forEach((child) => {\n        if (child.tagName === 'style' && !child.hasAttribute('nonce')) {\n          child.setAttribute('nonce', cspNonce);\n        }\n      });\n    }\n\n    return returnValue;\n  };\n\n  /**\n   * Finds the CSP nonce for a specific document.\n   */\n  private findCspNonce(document: PartialDocument): string | null {\n    if (this.documentNonces.has(document)) {\n      // eslint-disable-next-line @typescript-eslint/no-non-null-assertion\n      return this.documentNonces.get(document)!;\n    }\n\n    // HTML attribute are case-insensitive, but the parser used by Critters is case-sensitive.\n    const nonceElement = document.querySelector('[ngCspNonce], [ngcspnonce]');\n    const cspNonce =\n      nonceElement?.getAttribute('ngCspNonce') || nonceElement?.getAttribute('ngcspnonce') || null;\n\n    this.documentNonces.set(document, cspNonce);\n\n    return cspNonce;\n  }\n\n  /**\n   * Inserts the `script` tag that swaps the critical CSS at runtime,\n   * if one hasn't been inserted into the document already.\n   */\n  private conditionallyInsertCspLoadingScript(document: PartialDocument, nonce: string): void {\n    if (this.addedCspScriptsDocuments.has(document)) {\n      return;\n    }\n\n    if (document.head.textContent.includes(LINK_LOAD_SCRIPT_CONTENT)) {\n      // Script was already added during the build.\n      this.addedCspScriptsDocuments.add(document);\n\n      return;\n    }\n\n    const script = document.createElement('script');\n    script.setAttribute('nonce', nonce);\n    script.textContent = LINK_LOAD_SCRIPT_CONTENT;\n    // Append the script to the head since it needs to\n    // run as early as possible, after the `link` tags.\n    document.head.appendChild(script);\n    this.addedCspScriptsDocuments.add(document);\n  }\n}\n\nexport class InlineCriticalCssProcessor {\n  private readonly resourceCache = new Map<string, string>();\n\n  constructor(protected readonly options: InlineCriticalCssProcessorOptions) {}\n\n  async process(\n    html: string,\n    options: InlineCriticalCssProcessOptions,\n  ): Promise<InlineCriticalCssResult> {\n    const critters = new CrittersExtended({ ...this.options, ...options }, this.resourceCache);\n    const content = await critters.process(html);\n\n    return {\n      content,\n      errors: critters.errors.length ? critters.errors : undefined,\n      warnings: critters.warnings.length ? critters.warnings : undefined,\n    };\n  }\n}\n","/**\n * @license\n * Copyright Google LLC All Rights Reserved.\n *\n * Use of this source code is governed by an MIT-style license that can be\n * found in the LICENSE file at https://angular.io/license\n */\n\nimport { ApplicationRef, StaticProvider, Type } from '@angular/core';\nimport {\n  INITIAL_CONFIG,\n  renderApplication,\n  renderModule,\n  ɵSERVER_CONTEXT,\n} from '@angular/platform-server';\nimport * as fs from 'node:fs';\nimport { dirname, resolve } from 'node:path';\nimport { URL } from 'node:url';\nimport { InlineCriticalCssProcessor } from './inline-css-processor';\n\nconst SSG_MARKER_REGEXP = /ng-server-context=[\"']\\w*\\|?ssg\\|?\\w*[\"']/;\n\nexport interface CommonEngineRenderOptions {\n  bootstrap?: Type<{}> | (() => Promise<ApplicationRef>);\n  providers?: StaticProvider[];\n  url?: string;\n  document?: string;\n  documentFilePath?: string;\n  /**\n   * Reduce render blocking requests by inlining critical CSS.\n   * Defaults to true.\n   */\n  inlineCriticalCss?: boolean;\n  /**\n   * Base path location of index file.\n   * Defaults to the 'documentFilePath' dirname when not provided.\n   */\n  publicPath?: string;\n}\n\n/**\n * A common rendering engine utility. This abstracts the logic\n * for handling the platformServer compiler, the module cache, and\n * the document loader\n */\nexport class CommonEngine {\n  private readonly templateCache = new Map<string, string>();\n  private readonly inlineCriticalCssProcessor: InlineCriticalCssProcessor;\n  private readonly pageIsSSG = new Map<string, boolean>();\n\n  constructor(\n    private bootstrap?: Type<{}> | (() => Promise<ApplicationRef>),\n    private providers: StaticProvider[] = [],\n  ) {\n    this.inlineCriticalCssProcessor = new InlineCriticalCssProcessor({\n      minify: false,\n    });\n  }\n\n  /**\n   * Render an HTML document for a specific URL with specified\n   * render options\n   */\n  async render(opts: CommonEngineRenderOptions): Promise<string> {\n    const { inlineCriticalCss = true, url } = opts;\n\n    if (opts.publicPath && opts.documentFilePath && url !== undefined) {\n      const pathname = canParseUrl(url) ? new URL(url).pathname : url;\n      // Remove leading forward slash.\n      const pagePath = resolve(opts.publicPath, pathname.substring(1), 'index.html');\n\n      if (pagePath !== resolve(opts.documentFilePath)) {\n        // View path doesn't match with prerender path.\n        const pageIsSSG = this.pageIsSSG.get(pagePath);\n        if (pageIsSSG === undefined) {\n          if (await exists(pagePath)) {\n            const content = await fs.promises.readFile(pagePath, 'utf-8');\n            const isSSG = SSG_MARKER_REGEXP.test(content);\n            this.pageIsSSG.set(pagePath, isSSG);\n\n            if (isSSG) {\n              return content;\n            }\n          } else {\n            this.pageIsSSG.set(pagePath, false);\n          }\n        } else if (pageIsSSG) {\n          // Serve pre-rendered page.\n          return fs.promises.readFile(pagePath, 'utf-8');\n        }\n      }\n    }\n\n    // if opts.document dosen't exist then opts.documentFilePath must\n    const extraProviders: StaticProvider[] = [\n      { provide: ɵSERVER_CONTEXT, useValue: 'ssr' },\n      ...(opts.providers ?? []),\n      ...this.providers,\n    ];\n\n    let document = opts.document;\n    if (!document && opts.documentFilePath) {\n      document = await this.getDocument(opts.documentFilePath);\n    }\n\n    if (document) {\n      extraProviders.push({\n        provide: INITIAL_CONFIG,\n        useValue: {\n          document,\n          url: opts.url,\n        },\n      });\n    }\n\n    const moduleOrFactory = this.bootstrap || opts.bootstrap;\n    if (!moduleOrFactory) {\n      throw new Error('A module or bootstrap option must be provided.');\n    }\n\n    const html = await (isBootstrapFn(moduleOrFactory)\n      ? renderApplication(moduleOrFactory, { platformProviders: extraProviders })\n      : renderModule(moduleOrFactory, { extraProviders }));\n\n    if (!inlineCriticalCss) {\n      return html;\n    }\n\n    const { content, errors, warnings } = await this.inlineCriticalCssProcessor.process(html, {\n      outputPath: opts.publicPath ?? (opts.documentFilePath ? dirname(opts.documentFilePath) : ''),\n    });\n\n    // eslint-disable-next-line no-console\n    warnings?.forEach((m) => console.warn(m));\n    // eslint-disable-next-line no-console\n    errors?.forEach((m) => console.error(m));\n\n    return content;\n  }\n\n  /** Retrieve the document from the cache or the filesystem */\n  private async getDocument(filePath: string): Promise<string> {\n    let doc = this.templateCache.get(filePath);\n\n    if (!doc) {\n      doc = await fs.promises.readFile(filePath, 'utf-8');\n      this.templateCache.set(filePath, doc);\n    }\n\n    return doc;\n  }\n}\n\nasync function exists(path: fs.PathLike): Promise<boolean> {\n  try {\n    await fs.promises.access(path, fs.constants.F_OK);\n\n    return true;\n  } catch {\n    return false;\n  }\n}\n\nfunction isBootstrapFn(value: unknown): value is () => Promise<ApplicationRef> {\n  // We can differentiate between a module and a bootstrap function by reading `cmp`:\n  return typeof value === 'function' && !('ɵmod' in value);\n}\n\n// The below can be removed in favor of URL.canParse() when Node.js 18 is dropped\nfunction canParseUrl(url: string): boolean {\n  try {\n    return !!new URL(url);\n  } catch {\n    return false;\n  }\n}\n"],"names":[],"mappings":"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"}

package/index.d.ts

@@ -0,0 +1,44 @@
+import { ApplicationRef } from '@angular/core';
+import { StaticProvider } from '@angular/core';
+import { Type } from '@angular/core';
+
+/**
+ * A common rendering engine utility. This abstracts the logic
+ * for handling the platformServer compiler, the module cache, and
+ * the document loader
+ */
+export declare class CommonEngine {
+    private bootstrap?;
+    private providers;
+    private readonly templateCache;
+    private readonly inlineCriticalCssProcessor;
+    private readonly pageIsSSG;
+    constructor(bootstrap?: Type<{}> | (() => Promise<ApplicationRef>) | undefined, providers?: StaticProvider[]);
+    /**
+     * Render an HTML document for a specific URL with specified
+     * render options
+     */
+    render(opts: CommonEngineRenderOptions): Promise<string>;
+    /** Retrieve the document from the cache or the filesystem */
+    private getDocument;
+}
+
+export declare interface CommonEngineRenderOptions {
+    bootstrap?: Type<{}> | (() => Promise<ApplicationRef>);
+    providers?: StaticProvider[];
+    url?: string;
+    document?: string;
+    documentFilePath?: string;
+    /**
+     * Reduce render blocking requests by inlining critical CSS.
+     * Defaults to true.
+     */
+    inlineCriticalCss?: boolean;
+    /**
+     * Base path location of index file.
+     * Defaults to the 'documentFilePath' dirname when not provided.
+     */
+    publicPath?: string;
+}
+
+export { }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@angular/ssr",
-  "version": "0.0.0-PLACEHOLDER",
+  "version": "17.0.0-next.0",
   "description": "Angular server side rendering utilities",
   "license": "MIT",
   "homepage": "https://github.com/angular/angular-cli",
@@ -8,5 +8,28 @@
     "angular",
     "ssr",
     "universal"
-  ]
-}
+  ],
+  "dependencies": {
+    "critters": "0.0.20",
+    "tslib": "^2.3.0"
+  },
+  "peerDependencies": {
+    "@angular/common": "^17.0.0 || ^17.0.0-next.0",
+    "@angular/core": "^17.0.0 || ^17.0.0-next.0"
+  },
+  "schematics": "./schematics/collection.json",
+  "module": "./fesm2022/ssr.mjs",
+  "typings": "./index.d.ts",
+  "type": "module",
+  "exports": {
+    "./package.json": {
+      "default": "./package.json"
+    },
+    ".": {
+      "types": "./index.d.ts",
+      "esm2022": "./esm2022/index.mjs",
+      "esm": "./esm2022/index.mjs",
+      "default": "./fesm2022/ssr.mjs"
+    }
+  }
+}

package/schematics/collection.json

@@ -0,0 +1,9 @@
+{
+  "schematics": {
+    "ng-add": {
+      "description": "Adds Angular SSR to the application without affecting any templates",
+      "factory": "./ng-add",
+      "schema": "./ng-add/schema.json"
+    }
+  }
+}

package/schematics/ng-add/files/server.ts.template

@@ -0,0 +1,67 @@
+import 'zone.js/node';
+
+import { APP_BASE_HREF } from '@angular/common';
+import { CommonEngine } from '@angular/ssr';
+import * as express from 'express';
+import { existsSync } from 'node:fs';
+import { join } from 'node:path';
+import <% if (isStandalone) { %>bootstrap<% } else { %>{ AppServerModule }<% } %> from './src/<%= stripTsExtension(main) %>';
+
+// The Express app is exported so that it can be used by serverless Functions.
+export function app(): express.Express {
+  const server = express();
+  const distFolder = join(process.cwd(), '<%= browserDistDirectory %>');
+  const indexHtml = existsSync(join(distFolder, 'index.original.html'))
+    ? join(distFolder, 'index.original.html')
+    : join(distFolder, 'index.html');
+
+  const commonEngine = new CommonEngine();
+
+  server.set('view engine', 'html');
+  server.set('views', distFolder);
+
+  // Example Express Rest API endpoints
+  // server.get('/api/**', (req, res) => { });
+  // Serve static files from /browser
+  server.get('*.*', express.static(distFolder, {
+    maxAge: '1y'
+  }));
+
+  // All regular routes use the Angular engine
+  server.get('*', (req, res, next) => {
+    commonEngine
+      .render({
+        <% if (isStandalone) { %>bootstrap<% } else { %>bootstrap: AppServerModule<% } %>,
+        documentFilePath: indexHtml,
+        url: req.originalUrl,
+        publicPath: distFolder,
+        providers: [{ provide: APP_BASE_HREF, useValue: req.baseUrl }],
+      })
+      .then((html) => res.send(html))
+      .catch((err) => next(err));
+  });
+
+  return server;
+}
+
+function run(): void {
+  const port = process.env['PORT'] || 4000;
+
+  // Start up the Node server
+  const server = app();
+  server.listen(port, () => {
+    console.log(`Node Express server listening on http://localhost:${port}`);
+  });
+}
+
+// Webpack will replace 'require' with '__webpack_require__'
+// '__non_webpack_require__' is a proxy to Node 'require'
+// The below code is to ensure that the server is run only when not requiring the bundle.
+declare const __non_webpack_require__: NodeRequire;
+const mainModule = __non_webpack_require__.main;
+const moduleFilename = mainModule && mainModule.filename || '';
+if (moduleFilename === __filename || moduleFilename.includes('iisnode')) {
+  run();
+}
+
+<% if (isStandalone) { %>export default bootstrap;<% } else { %>export * from './src/<%= stripTsExtension(main) %>';<% } %>

package/schematics/ng-add/index.d.ts

@@ -0,0 +1,10 @@
+/**
+ * @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.io/license
+ */
+import { Rule } from '@angular-devkit/schematics';
+import { Schema as AddUniversalOptions } from './schema';
+export default function (options: AddUniversalOptions): Rule;