@lwrjs/core 0.6.0-alpha.1 → 0.6.0-alpha.13

package/build/es/index.js

@@ -5,6 +5,7 @@ import { LwrModuleRegistry } from '@lwrjs/module-registry';
 import { LwrResourceRegistry } from '@lwrjs/resource-registry';
 import { LwrAssetRegistry } from '@lwrjs/asset-registry';
 import { LwrViewRegistry } from '@lwrjs/view-registry';
+import { LwrServerError, createSingleDiagnosticError, descriptions } from '@lwrjs/diagnostics';
 import { normalizeConfig, explodeMode } from './env-config.js';
 import { LwrApplicationObserver } from './lwr-app-observer.js';
 import localeMiddleware from './middlewares/locale-middleware.js';
@@ -52,10 +53,12 @@ async function initContext(app, server, rawLwrConfig) {
     };
     const hookProviders = await getServices(rawLwrConfig.hooks, undefined, rawLwrConfig);
     const { lwrConfig, dataConfig, runtimeConfig } = await runConfigurationsHook(hookProviders, rawLwrConfig, rawDataConfig, rawRuntimeEnvConfig);
+    const assetTransformers = await getServices(rawLwrConfig.assetTransformers, undefined, rawLwrConfig);
     const appObserver = new LwrApplicationObserver();
     const appEmitter = appObserver.createLwrEmitter();
     const compiler = new LwrCompiler();
     const assetRegistry = new LwrAssetRegistry({
+        assetTransformers,
         appObserver,
         appEmitter,
         runtimeEnvironment: runtimeConfig,
@@ -96,9 +99,9 @@ async function initContext(app, server, rawLwrConfig) {
     const { cacheDir, lwc: { modules = [] }, routes, errorRoutes, rootDir, contentDir, layoutsDir, locker, amdLoader, esmLoader, environment, } = lwrConfig;
     const { onModuleDefinitionChange, onModuleSourceChange } = appObserver;
     const { notifyModuleDefinitionChanged, notifyModuleSourceChanged, notifyViewSourceChanged, notifyAssetSourceChanged, } = appEmitter;
-    const providerContext = deepFreeze({
+    const providerContext = {
         compiler,
-        appObserver: { onModuleDefinitionChange, onModuleSourceChange },
+        appObserver: deepFreeze({ onModuleDefinitionChange, onModuleSourceChange }),
         appEmitter: {
             notifyModuleDefinitionChanged: (payload) => notifyModuleDefinitionChanged.call(appEmitter, payload),
             notifyModuleSourceChanged: (payload) => notifyModuleSourceChanged.call(appEmitter, payload),
@@ -106,10 +109,11 @@ async function initContext(app, server, rawLwrConfig) {
             notifyAssetSourceChanged: (payload) => notifyAssetSourceChanged.call(appEmitter, payload),
         },
         moduleRegistry: moduleRegistry.getPublicApi(),
+        moduleBundler: moduleBundler,
         resourceRegistry: resourceRegistry.getPublicApi(),
         viewRegistry: viewRegistry.getPublicApi(),
         assetRegistry: assetRegistry.getPublicApi(),
-        config: {
+        config: deepFreeze({
             cacheDir,
             modules,
             routes,
@@ -121,9 +125,9 @@ async function initContext(app, server, rawLwrConfig) {
             amdLoader,
             esmLoader,
             environment,
-        },
-        runtimeEnvironment: runtimeConfig,
-    });
+        }),
+        runtimeEnvironment: deepFreeze(runtimeConfig),
+    };
     // Module Providers
     const moduleProviders = await getServices(lwrConfig.moduleProviders, providerContext, lwrConfig);
     moduleRegistry.addModuleProviders(moduleProviders);
@@ -132,7 +136,10 @@ async function initContext(app, server, rawLwrConfig) {
     resourceRegistry.addResourceProviders(resourceProviders);
     // View Providers
     const viewProviders = await getServices(lwrConfig.viewProviders, providerContext, lwrConfig);
+    // View Transformers
+    const viewTransformers = await getServices(rawLwrConfig.viewTransformers, providerContext, rawLwrConfig);
     viewRegistry.addViewProviders(viewProviders);
+    viewRegistry.addViewTransformers(viewTransformers);
     await viewRegistry.initializeViewProviders();
     // Asset Providers
     const assetProviders = await getServices(lwrConfig.assetProviders, providerContext, lwrConfig);
@@ -154,9 +161,15 @@ export class LwrApp {
     }
     async init() {
         if (!this.initialized) {
-            const context = await initContext(this.app, this.server, this.config);
-            initMiddlewares(this.app, this.server, context);
             this.initialized = true;
+            try {
+                const context = await initContext(this.app, this.server, this.config);
+                initMiddlewares(this.app, this.server, context);
+            }
+            catch (e) {
+                this.initialized = false;
+                throw e;
+            }
         }
     }
     async listen(callback) {
@@ -165,7 +178,14 @@ export class LwrApp {
         const { serverMode, port } = config;
         server.listen(port || config.port, async () => {
             if (process.env.WARMUP?.toLowerCase() === 'true') {
-                await warmupServer(config, app.getInternalRequestKey());
+                try {
+                    await warmupServer(config, app.getInternalRequestKey());
+                }
+                catch (err) {
+                    throw createSingleDiagnosticError({
+                        description: descriptions.SERVER.WARMUP_ERROR(err.message),
+                    }, LwrServerError);
+                }
             }
             callback?.({ serverMode, port });
         });

package/build/es/middlewares/api-middleware.js

@@ -61,20 +61,20 @@ export default function apiMiddleware(app, context) {
                 // TODO might be able to remove this in the future but not sure how to properly send
                 // back bundleRecord imports with absolute uris (lwc is the main one)
                 if (bundleDef.bundleRecord.imports) {
-                    for (let index = 0; index < bundleDef.bundleRecord.imports.length; index++) {
-                        const theImport = bundleDef.bundleRecord.imports[index];
+                    for (const theImport of bundleDef.bundleRecord.imports) {
+                        const childSpecifier = theImport.specifier;
                         // eslint-disable-next-line no-await-in-loop
-                        const id = await getVersionedModuleId(theImport.specifier, moduleRegistry);
+                        const id = await getVersionedModuleId(childSpecifier, moduleRegistry);
                         // eslint-disable-next-line no-await-in-loop
                         const uri = await moduleRegistry.resolveModuleUri(id, runtimeEnvironment, runtimeParams);
                         resolvedUris.push(uri);
                     }
                 }
                 if (bundleDef.bundleRecord.dynamicImports) {
-                    for (let index = 0; index < bundleDef.bundleRecord.dynamicImports.length; index++) {
-                        const theImport = bundleDef.bundleRecord.dynamicImports[index];
+                    for (const theImport of bundleDef.bundleRecord.dynamicImports) {
+                        const childSpecifier = theImport.specifier;
                         // eslint-disable-next-line no-await-in-loop
-                        const id = await getVersionedModuleId(theImport.specifier, moduleRegistry);
+                        const id = await getVersionedModuleId(childSpecifier, moduleRegistry);
                         // eslint-disable-next-line no-await-in-loop
                         const uri = await moduleRegistry.resolveModuleUri(id, runtimeEnvironment, runtimeParams);
                         resolvedUris.push(uri);

package/build/es/middlewares/ui-middleware.js

@@ -29,7 +29,7 @@ export default function uiMiddleware(app, context) {
                 url: req.originalUrl,
                 params: req.params,
                 query: req.query,
-                requestPath: req.path,
+                requestPath: req.path, // Runtime resolved version vs. the original route path
             };
             const response = req.isJsonRequest()
                 ? await viewHandler.getViewJson(viewRequest, route, runtimeEnvironment, runtimeParams)
@@ -85,7 +85,7 @@ export default function uiMiddleware(app, context) {
                 url,
                 params,
                 query: req.query,
-                requestPath,
+                requestPath, // Runtime resolved version vs. the original route path
             };
             const response = await viewHandler.getViewConfiguration(viewRequest, route, runtimeEnvironment, runtimeParams);
             if (!response) {

package/build/es/middlewares/utils.d.ts

@@ -2,16 +2,13 @@
 import http from 'http';
 import { EnvironmentConfig } from '@lwrjs/types';
 import qs from 'qs';
-interface E extends Error {
-    code: string;
-}
 /**
  * Create a status object Express can return when there is an error
  *
  * @param name - string name of the problem module/resource
- * @param error? - an Error/Diagnostic object
+ * @param error - an Error/Diagnostic object; thrown from try/catch
  */
-export declare function createReturnStatus(name: string, error: E): {
+export declare function createReturnStatus(name: string, error: unknown): {
     status: number;
     message: string;
 };

package/build/es/middlewares/utils.js

@@ -1,4 +1,4 @@
-import { LwrUnresolvableError, descriptions } from '@lwrjs/diagnostics';
+import { LwrUnresolvableError, descriptions, isNodeError } from '@lwrjs/diagnostics';
 import { pathToRegexp } from 'path-to-regexp';
 import qs from 'qs';
 import createDOMPurify from 'dompurify';
@@ -9,11 +9,11 @@ const DOMPurify = createDOMPurify(window);
  * Create a status object Express can return when there is an error
  *
  * @param name - string name of the problem module/resource
- * @param error? - an Error/Diagnostic object
+ * @param error - an Error/Diagnostic object; thrown from try/catch
  */
 export function createReturnStatus(name, error) {
     let returnStatus = { status: 501, message: '' };
-    if (error.code === 'NO_LWC_MODULE_FOUND') {
+    if (isNodeError(error) && error.code === 'NO_LWC_MODULE_FOUND') {
         returnStatus = { status: 404, message: descriptions.UNRESOLVABLE.LWC_MODULE(name).message };
     }
     else if (error instanceof LwrUnresolvableError &&

package/build/es/tools/static-generation.d.ts

@@ -1,5 +1,5 @@
-import { LwrDispatcher, StaticSiteGenerator, LwrRoute, NormalizedLwrGlobalConfig } from '@lwrjs/types';
-import { ResourceContextOpts, SiteConfig } from './types.js';
+import { ImportMetadata, LwrDispatcher, StaticSiteGenerator, LwrRoute, NormalizedLwrGlobalConfig } from '@lwrjs/types';
+import { ResourceContextOpts, SiteConfig, ViewImportMetadata } from './types.js';
 export default class SiteGenerator {
     /**
      * Build a static site in the configured directory
@@ -87,5 +87,37 @@ export default class SiteGenerator {
      *
      */
     private copyAssets;
+    /**
+     * Create a new site config for the current view
+     */
+    private createSiteConfig;
+    private filterExperimentalFeatures;
+    /**
+     * Add any additional import metadata collected during static site generation to the Client Bootstrap Config for this view.
+     */
+    private addAdditionalImportMetadataToViewConfig;
+}
+export declare class ViewImportMetadataImpl implements ViewImportMetadata {
+    private existing;
+    private additional;
+    constructor(existingImportMetadata: ImportMetadata, additionalImportMetadata?: ImportMetadata);
+    /**
+     * Get the additional import metadata collected while generating this view
+     * @returns
+     */
+    getAdditionalImportMetadata(): ImportMetadata;
+    /**
+     * Adds any new imports found to the additional metadata map.  Returns a filtered
+     * map of imports not in the initial view
+     */
+    addAdditionalMetadata(newMetadata: ImportMetadata): ImportMetadata;
+    /**
+     * Filter out any existing import metadata the would have already been sent back with the view from set of additional metadata detected
+     */
+    private filterMetadata;
+    /**
+     * Merge new import metadata into target import metadata
+     */
+    private mergeImportMetadata;
 }
 //# sourceMappingURL=static-generation.d.ts.map

package/build/es/tools/static-generation.js

@@ -19,7 +19,8 @@ export default class SiteGenerator {
             staticSiteGenerator.outputDir = '__generated_site__';
         }
         const outputDir = join(rootDir, staticSiteGenerator.outputDir);
-        console.log(`[INFO] Output Location: ${outputDir}`);
+        console.log(`[INFO] Clear Output Location: ${outputDir}`);
+        fs.rmSync(outputDir, { recursive: true, force: true });
         const urlRewriteMap = new Map();
         // For each locale, generate all the modules
         await this.generateRoutes(staticSiteGenerator, routes, dispatcher, outputDir, urlRewriteMap);
@@ -42,13 +43,13 @@ export default class SiteGenerator {
         for (const locale of staticSiteGenerator.locales) {
             // Generate all the routes
             for (const route of routes) {
-                const siteConfig = createSiteConfig(outputDir, locale, urlRewriteMap);
+                const siteConfig = this.createSiteConfig(outputDir, locale, urlRewriteMap);
                 dispatchRequests.push(generateUrl(route.path, siteConfig));
             }
             // Generate any additional urls
             if (staticSiteGenerator._additionalRoutePaths) {
                 for (const uri of staticSiteGenerator._additionalRoutePaths) {
-                    const siteConfig = createSiteConfig(outputDir, locale, urlRewriteMap);
+                    const siteConfig = this.createSiteConfig(outputDir, locale, urlRewriteMap);
                     dispatchRequests.push(generateUrl(uri, siteConfig));
                 }
             }
@@ -66,7 +67,7 @@ export default class SiteGenerator {
             // Kick off site generation for the current route
             await this.dispatchResourceRecursive(uri, dispatcher, { resourceType: 'route' }, siteConfig);
             // If there is a view config add any extra collected import metadata to the config
-            addAdditionalImportMetadataToViewConfig(siteConfig);
+            this.addAdditionalImportMetadataToViewConfig(siteConfig);
             console.log(`[INFO] End Generate ${locale} ${uri}`);
         };
         return generateRoute.bind(this);
@@ -171,16 +172,18 @@ export default class SiteGenerator {
      * @param dispatcher - Network dispatcher
      */
     async handleMappingResource(url, context, siteConfig, dispatcher) {
-        const { additionalImportMetadata: importMetadata } = siteConfig;
+        const { importMetadata: importMetatdata } = siteConfig;
         const statusCode = context.response?.status;
         // Received a server error
         if (statusCode === 200) {
             // Read JSON
             const newImportMetadata = context.fs?.body;
+            if (!importMetatdata) {
+                console.warn('[WARN] Import metadata collector was never initialized');
+                return;
+            }
             // Filter out and import metadata already included with the view
-            const filteredImportMetadata = filterMetadata(siteConfig.existingImportMetadata, newImportMetadata);
-            // Merge Imports with global collection
-            mergeImportMetadata(importMetadata, filteredImportMetadata);
+            const filteredImportMetadata = importMetatdata.addAdditionalMetadata(newImportMetadata);
             // Build up a list of dispatch requests to kick off in parallel
             const dispatchRequests = [];
             // Iterate through the import mappings and return request uris
@@ -239,7 +242,8 @@ export default class SiteGenerator {
         siteConfig.endpoints = viewDefinition.viewRecord.endpoints;
         // Save existing import metadata
         if (viewDefinition.viewRecord.importMetadata) {
-            mergeImportMetadata(siteConfig.existingImportMetadata, viewDefinition.viewRecord.importMetadata);
+            // Initialize import metadata collector
+            siteConfig.importMetadata = new ViewImportMetadataImpl(viewDefinition.viewRecord.importMetadata);
         }
         // Build up a list of dispatch requests to kick off in parallel
         const dispatchRequests = [];
@@ -396,74 +400,97 @@ export default class SiteGenerator {
             }
         }
     }
-}
-/**
- * Add any additional import metadata collected during static site generation to the Client Bootstrap Config for this view.
- */
-function addAdditionalImportMetadataToViewConfig(siteConfig) {
-    const supportsFingerprints = siteConfig.experimentalFeatures?.ENABLE_FINGERPRINTS;
-    if (supportsFingerprints &&
-        siteConfig.viewConfigPath &&
-        Object.keys(siteConfig.additionalImportMetadata.imports).length > 0) {
-        const imports = siteConfig.additionalImportMetadata.imports
-            ? JSON.stringify(siteConfig.additionalImportMetadata.imports)
-            : '{}';
-        const initImports = `if (!globalThis.LWR.imports) { globalThis.LWR.imports = {}; }`;
-        const mergeImports = `Object.assign(globalThis.LWR.imports, ${imports})`;
-        const index = siteConfig.additionalImportMetadata.index
-            ? JSON.stringify(siteConfig.additionalImportMetadata.index)
-            : '{}';
-        const initIndex = `if (!globalThis.LWR.index) { globalThis.LWR.index = {}; }`;
-        const mergeIndex = `Object.assign(globalThis.LWR.index, ${index})`;
-        fs.appendFileSync(siteConfig.viewConfigPath, `\n// Appended by Static Site Generator\n${initImports}\n${mergeImports}\n${initIndex}\n${mergeIndex}\n`);
+    /**
+     * Create a new site config for the current view
+     */
+    createSiteConfig(outputDir, locale, urlRewriteMap) {
+        const experimentalFeatures = this.filterExperimentalFeatures();
+        return {
+            outputDir,
+            visitedUrls: new Set(),
+            locale,
+            urlRewriteMap,
+            // Only include ENABLE_FINGERPRINTS if true
+            ...experimentalFeatures,
+        };
     }
-}
-/**
- * Create a new site config for the current view
- */
-function createSiteConfig(outputDir, locale, urlRewriteMap) {
-    const experimentalFeatures = filterExperimentalFeatures();
-    return {
-        outputDir,
-        visitedUrls: new Set(),
-        locale,
-        urlRewriteMap,
-        existingImportMetadata: { imports: {}, index: {} },
-        additionalImportMetadata: { imports: {}, index: {} },
-        // Only include ENABLE_FINGERPRINTS if true
-        ...experimentalFeatures,
-    };
-}
-function filterExperimentalFeatures() {
-    if (getExperimentalFeatures().ENABLE_FINGERPRINTS) {
-        return { experimentalFeatures: { ENABLE_FINGERPRINTS: true } };
+    filterExperimentalFeatures() {
+        if (getExperimentalFeatures().ENABLE_FINGERPRINTS) {
+            return { experimentalFeatures: { ENABLE_FINGERPRINTS: true } };
+        }
+        else {
+            return undefined;
+        }
     }
-    else {
-        return undefined;
+    /**
+     * Add any additional import metadata collected during static site generation to the Client Bootstrap Config for this view.
+     */
+    addAdditionalImportMetadataToViewConfig(siteConfig) {
+        const supportsFingerprints = siteConfig.experimentalFeatures?.ENABLE_FINGERPRINTS;
+        const additionalImportMetadata = siteConfig?.importMetadata?.getAdditionalImportMetadata();
+        if (supportsFingerprints &&
+            siteConfig.viewConfigPath &&
+            additionalImportMetadata?.imports &&
+            Object.keys(additionalImportMetadata.imports).length > 0) {
+            const imports = additionalImportMetadata.imports
+                ? JSON.stringify(additionalImportMetadata.imports)
+                : '{}';
+            const initImports = `if (!globalThis.LWR.imports) { globalThis.LWR.imports = {}; }`;
+            const mergeImports = `Object.assign(globalThis.LWR.imports, ${imports})`;
+            const index = additionalImportMetadata.index
+                ? JSON.stringify(additionalImportMetadata.index)
+                : '{}';
+            const initIndex = `if (!globalThis.LWR.index) { globalThis.LWR.index = {}; }`;
+            const mergeIndex = `Object.assign(globalThis.LWR.index, ${index})`;
+            fs.appendFileSync(siteConfig.viewConfigPath, `\n// Appended by Static Site Generator\n${initImports}\n${mergeImports}\n${initIndex}\n${mergeIndex}\n`);
+        }
     }
 }
-/**
- * Merge new import metadata into target import metadata
- */
-function mergeImportMetadata(targetImportMetdadata, newImportMetadata) {
-    Object.assign(targetImportMetdadata.imports, newImportMetadata.imports);
-    Object.assign(targetImportMetdadata.index, newImportMetadata.index);
-}
-/**
- * Filter out any existing import metadata the would have already been sent back with the view from set of additional metadata detected
- */
-function filterMetadata(existingMetadata, newMetadata) {
-    // Filter Imports
-    const importsArray = Object.entries(newMetadata.imports);
-    const filteredImports = importsArray.filter(([key]) => !existingMetadata.imports[key]);
-    const imports = Object.fromEntries(filteredImports);
-    // Filter Index
-    const indexArray = Object.entries(newMetadata.index || {});
-    const filteredIndex = indexArray.filter(([key]) => !existingMetadata.index || !existingMetadata.index[key]);
-    const index = Object.fromEntries(filteredIndex);
-    return {
-        imports,
-        index,
-    };
+// Class used to track import metadata for a view
+export class ViewImportMetadataImpl {
+    constructor(existingImportMetadata, additionalImportMetadata) {
+        this.existing = existingImportMetadata;
+        this.additional = additionalImportMetadata || { imports: {}, index: {} };
+    }
+    /**
+     * Get the additional import metadata collected while generating this view
+     * @returns
+     */
+    getAdditionalImportMetadata() {
+        return this.additional;
+    }
+    /**
+     * Adds any new imports found to the additional metadata map.  Returns a filtered
+     * map of imports not in the initial view
+     */
+    addAdditionalMetadata(newMetadata) {
+        const filteredImports = this.filterMetadata(newMetadata);
+        this.mergeImportMetadata(this.additional, filteredImports);
+        return filteredImports;
+    }
+    /**
+     * Filter out any existing import metadata the would have already been sent back with the view from set of additional metadata detected
+     */
+    filterMetadata(newMetadata) {
+        // Filter Imports
+        const importsArray = Object.entries(newMetadata.imports);
+        const filteredImports = importsArray.filter(([key]) => !this.existing.imports[key]);
+        const imports = Object.fromEntries(filteredImports);
+        // Filter Index
+        const indexArray = Object.entries(newMetadata.index || {});
+        const filteredIndex = indexArray.filter(([key]) => !this.existing.index || !this.existing.index[key]);
+        const index = Object.fromEntries(filteredIndex);
+        return {
+            imports,
+            index,
+        };
+    }
+    /**
+     * Merge new import metadata into target import metadata
+     */
+    mergeImportMetadata(targetImportMetdadata, newImportMetadata) {
+        Object.assign(targetImportMetdadata.imports, newImportMetadata.imports);
+        Object.assign(targetImportMetdadata.index, newImportMetadata.index);
+    }
 }
 //# sourceMappingURL=static-generation.js.map

package/build/es/tools/types.d.ts

@@ -20,14 +20,25 @@ export interface MappingResourceOpts extends BaseResourceContextOpts {
     resourceType: 'mapping';
 }
 export declare type ResourceContextOpts = RouteResourceOpts | AssetResourceOpts | JsResourceOpts | ResResourceOpts | MappingResourceOpts;
+export interface ViewImportMetadata {
+    /**
+     * Get the additional import metadata collected while generating this view
+     * @returns
+     */
+    getAdditionalImportMetadata(): ImportMetadata;
+    /**
+     * Adds any new imports found to the additional metadata map.  Returns a filtered
+     * map of imports not in the initial view
+     */
+    addAdditionalMetadata(newMetadata: ImportMetadata): ImportMetadata;
+}
 export interface SiteConfig {
     outputDir: string;
     visitedUrls: Set<string>;
     locale: string;
     urlRewriteMap: Map<string, string>;
-    existingImportMetadata: ImportMetadata;
-    additionalImportMetadata: ImportMetadata;
     endpoints?: Endpoints;
+    importMetadata?: ViewImportMetadata;
     viewConfigPath?: string;
     experimentalFeatures?: ExperimentalFeatures;
 }

package/build/es/tools/utils/network-dispatcher.d.ts

@@ -1,7 +1,10 @@
+/// <reference types="node" />
+import http from 'http';
 import { LwrDispatcher, FsContext } from '@lwrjs/types';
 export default class NetworkDispatcher implements LwrDispatcher {
     port: number;
     internalRequestKey: string;
+    pool: http.Agent;
     constructor(port: number, internalRequestKey: string);
     dispatchUrl(url: string, method: string, lang: string): Promise<FsContext>;
 }

package/build/es/tools/utils/network-dispatcher.js

@@ -1,8 +1,13 @@
 import http from 'http';
 import https from 'https';
+import { DiagnosticsError } from '@lwrjs/diagnostics';
 export default class NetworkDispatcher {
     constructor(port, internalRequestKey) {
         this.port = port || 3000;
+        const httpClient = this.port == 443 ? https : http;
+        this.pool = new httpClient.Agent({
+            maxSockets: 25,
+        });
         this.internalRequestKey = internalRequestKey || '';
     }
     dispatchUrl(url, method, lang) {
@@ -11,6 +16,7 @@ export default class NetworkDispatcher {
             host: 'localhost',
             port: this.port,
             path: url,
+            agent: this.pool,
             headers: {
                 'Accept-Language': lang,
                 // pass private key to get access to internal metadata
@@ -20,24 +26,42 @@ export default class NetworkDispatcher {
         return new Promise((resolve, reject) => {
             const httpClient = options.port == 443 ? https : http;
             const bodyChunks = [];
+            // console.log(`[INFO][NetworkDispatcher] Request: [${method}][${lang}] ${url}`);
             const req = httpClient.request(options, (res) => {
                 res.on('data', (chunk) => {
                     bodyChunks.push(chunk);
                 });
                 res.on('end', () => {
+                    // console.log(`[END][NetworkDispatcher] Request: [${method}][${lang}] ${url}`);
                     const body = Buffer.concat(bodyChunks).toString();
                     try {
                         const jsonResponse = JSON.parse(body);
                         resolve(jsonResponse);
                     }
                     catch (e) {
-                        console.error(`[NetworkDispatcher] unexpected response body: '${body}'`, e);
+                        console.error(`[ERROR][NetworkDispatcher] unexpected response body: [${method}][${lang}] ${url}: '${body}'`);
+                        if (e instanceof DiagnosticsError) {
+                            console.log('LWR Diagnostic Error: ');
+                            console.log(e.diagnostics);
+                            console.log(e.stack);
+                        }
+                        else {
+                            console.error(e);
+                        }
                         resolve({});
                     }
                 });
             });
             req.on('error', (err) => {
-                console.error('Error occurred fetching metadata: ' + err.message);
+                console.error(`[ERROR][NetworkDispatcher] Request: [${method}][${lang}] ${url}`);
+                if (err instanceof DiagnosticsError) {
+                    console.log('LWR Diagnostic Error: ');
+                    console.log(err.diagnostics);
+                    console.log(err.stack);
+                }
+                else {
+                    console.error(err);
+                }
                 reject(err);
             });
             req.end();

package/build/es/validation/app-config-context.d.ts

@@ -15,13 +15,13 @@ interface ConfigMap {
     bootstrap: NormalizedLwrAppBootstrapConfig;
     locker: RequiredLwrLockerConfig;
 }
-export declare const ROOT_ATTRIBUTE_KEYS: ["amdLoader", "apiVersion", "assets", "assetProviders", "bundleConfig", "cacheDir", "contentDir", "environment", "errorRoutes", "esmLoader", "staticSiteGenerator", "globalData", "globalDataDir", "hooks", "ignoreLwrConfigFile", "lwrConfigFile", "layoutsDir", "locker", "lwc", "lwrVersion", "moduleProviders", "port", "resourceProviders", "rootDir", "routes", "serverMode", "serverType", "templateEngine", "viewProviders"];
+export declare const ROOT_ATTRIBUTE_KEYS: ["amdLoader", "apiVersion", "assets", "assetProviders", "assetTransformers", "bundleConfig", "cacheDir", "contentDir", "environment", "errorRoutes", "esmLoader", "staticSiteGenerator", "globalData", "globalDataDir", "hooks", "ignoreLwrConfigFile", "lwrConfigFile", "layoutsDir", "locker", "lwc", "lwrVersion", "moduleProviders", "port", "resourceProviders", "rootDir", "routes", "serverMode", "serverType", "templateEngine", "viewProviders", "viewTransformers"];
 export declare const ASSET_DIR_ATTRIBUTE_KEYS: ["alias", "dir", "urlPath"];
 export declare const ASSET_FILE_ATTRIBUTE_KEYS: ["alias", "file", "urlPath"];
 export declare const LOCKER_ATTRIBUTE_KEYS: ["enabled", "trustedComponents", "clientOnly"];
 export declare const ROUTE_ATTRIBUTE_KEYS: ["bootstrap", "contentTemplate", "id", "cache", "layoutTemplate", "method", "path", "rootComponent", "routeHandler", "properties"];
 export declare const ERROR_ROUTE_ATTRIBUTE_KEYS: ["bootstrap", "contentTemplate", "id", "layoutTemplate", "rootComponent", "routeHandler", "status", "properties", "cache"];
-export declare const BOOTSTRAP_ATTRIBUTE_KEYS: ["autoBoot", "syntheticShadow", "workers", "services", "configAsSrc"];
+export declare const BOOTSTRAP_ATTRIBUTE_KEYS: ["autoBoot", "syntheticShadow", "workers", "services", "configAsSrc", "experimentalSSR"];
 export declare class ValidationContext {
     diagnostics: Diagnostic[];
     sourceText: string;

package/build/es/validation/app-config-context.js

@@ -11,6 +11,7 @@ export const ROOT_ATTRIBUTE_KEYS = createKeys('root', [
     'apiVersion',
     'assets',
     'assetProviders',
+    'assetTransformers',
     'bundleConfig',
     'cacheDir',
     'contentDir',
@@ -36,6 +37,7 @@ export const ROOT_ATTRIBUTE_KEYS = createKeys('root', [
     'serverType',
     'templateEngine',
     'viewProviders',
+    'viewTransformers',
 ]);
 export const ASSET_DIR_ATTRIBUTE_KEYS = createKeys('assetDir', ['alias', 'dir', 'urlPath']);
 export const ASSET_FILE_ATTRIBUTE_KEYS = createKeys('assetFile', ['alias', 'file', 'urlPath']);
@@ -69,6 +71,7 @@ export const BOOTSTRAP_ATTRIBUTE_KEYS = createKeys('bootstrap', [
     'workers',
     'services',
     'configAsSrc',
+    'experimentalSSR',
 ]);
 const SPECIFIER_REGEX = /^@?[\w-]+(\/[\w-]+)*$/;
 function isNotEmptyString(node) {

package/build/es/validation/app-config.js

@@ -21,6 +21,7 @@ function validateBootstrap(node, validationContext, propPrefix) {
         validationContext.assertValidKeys(node, 'bootstrap', BOOTSTRAP_ATTRIBUTE_KEYS);
         validationContext.assertArrayOfSpecifiers(findNode(node, ['services']), `${propPrefix}.services`);
         validationContext.assertIsBoolean(findNode(node, ['autoBoot']), `${propPrefix}.autoBoot`);
+        validationContext.assertIsBoolean(findNode(node, ['experimentalSSR']), `${propPrefix}.experimentalSSR`);
         validationContext.assertIsBoolean(findNode(node, ['configAsSrc']), `${propPrefix}.configAsSrc`);
         validationContext.assertIsBoolean(findNode(node, ['syntheticShadow']), `${propPrefix}.syntheticShadow`);
         // Each value in the worker map msut be a specifier