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

package/build/cjs/env-config.cjs

@@ -53,6 +53,7 @@ var DEFAULT_LAYOUTS_DIR = "$rootDir/src/layouts";
 var DEFAULT_DATA_DIR = "$rootDir/src/data";
 var DEFAULT_MODULE_PROVIDERS = [
   "@lwrjs/app-service/moduleProvider",
+  "@lwrjs/lwc-ssr/moduleProvider",
   "@lwrjs/lwc-module-provider",
   "@lwrjs/npm-module-provider"
 ];
@@ -63,7 +64,9 @@ var DEFAULT_VIEW_PROVIDERS = [
   "@lwrjs/markdown-view-provider",
   "@lwrjs/base-view-provider"
 ];
+var DEFAULT_VIEW_TRANFORM_PLUGINS = ["@lwrjs/base-view-transformer", "@lwrjs/lwc-ssr/viewTransformer"];
 var DEFAULT_ASSET_PROVIDERS = ["@lwrjs/fs-asset-provider"];
+var DEFAULT_ASSET_TRANFORM_PLUGINS = ["@lwrjs/asset-transformer"];
 var DEFAULT_TEMPLATE_ENGINE = "@lwrjs/base-template-engine";
 var DEFAULT_AMD_LOADER = "lwr/loader";
 var DEFAULT_AMD_LOADER_LEGACY = "lwr/loaderLegacy";
@@ -73,9 +76,17 @@ var DEFAULT_LWR_MODULES = [
   {npm: getLWCEngineSpecifier()},
   {npm: "@lwrjs/client-modules"},
   {npm: "@lwrjs/loader"},
+  {npm: "@lwrjs/o11y"},
   {npm: "@lwrjs/router"},
   {npm: "@lwc/synthetic-shadow"}
 ];
+var DEFAULT_BUNDLE_EXCLUSIONS = [
+  "lwc",
+  "@lwc/synthetic-shadow",
+  "lwr/navigation",
+  "lwr/esmLoader",
+  "lwr/profiler"
+];
 var DEFAULT_LWR_CONFIG = {
   port: PORT,
   ignoreLwrConfigFile: false,
@@ -85,6 +96,8 @@ var DEFAULT_LWR_CONFIG = {
   serverMode: MODE,
   apiVersion: DEFAULT_API_VERSION,
   assets: DEFAULT_ASSETS_DIR,
+  assetProviders: DEFAULT_ASSET_PROVIDERS,
+  assetTransformers: DEFAULT_ASSET_TRANFORM_PLUGINS,
   contentDir: DEFAULT_CONTENT_DIR,
   layoutsDir: DEFAULT_LAYOUTS_DIR,
   staticSiteGenerator: DEFAULT_GENERATOR_CONFIG,
@@ -94,12 +107,13 @@ var DEFAULT_LWR_CONFIG = {
   moduleProviders: DEFAULT_MODULE_PROVIDERS,
   resourceProviders: DEFAULT_RESOURCE_PROVIDERS,
   viewProviders: DEFAULT_VIEW_PROVIDERS,
+  viewTransformers: DEFAULT_VIEW_TRANFORM_PLUGINS,
   templateEngine: DEFAULT_TEMPLATE_ENGINE,
   environment: {},
   lwc: {modules: []},
   routes: [],
   errorRoutes: [],
-  bundleConfig: {},
+  bundleConfig: {exclude: DEFAULT_BUNDLE_EXCLUSIONS},
   serverType: DEFAULT_SERVER_TYPE,
   locker: import_shared_utils.DEFAULT_LWR_LOCKER_CONFIG
 };
@@ -208,6 +222,15 @@ function mergeLWCConfigs(config1, config2) {
     interchangeableModules: mergedInterchangeableModules.length ? mergedInterchangeableModules : void 0
   };
 }
+function mergeBundleConfig(jsonConfig, config) {
+  const defaultExclusions = config?.bundleConfig?.UNSAFE_lwrDefaultExclude || jsonConfig?.bundleConfig?.UNSAFE_lwrDefaultExclude || DEFAULT_BUNDLE_EXCLUSIONS;
+  const configExclusions = config?.bundleConfig?.exclude || jsonConfig?.bundleConfig?.exclude || [];
+  return {
+    ...jsonConfig?.bundleConfig,
+    ...config?.bundleConfig,
+    exclude: [...new Set([...defaultExclusions, ...configExclusions])]
+  };
+}
 function mergeLockerConfig(jsonConfig, config) {
   const defaultNamespaces = import_shared_utils.DEFAULT_LOCKER_TRUSTED_CMP;
   const configNamespaces = config?.locker?.trustedComponents || jsonConfig?.locker?.trustedComponents || [];
@@ -232,8 +255,16 @@ function normalizeLwcConfig(config) {
     interchangeableModulesMap: config.interchangeableModules ? (0, import_shared_utils.normalizeInterchangeableModuleConfig)(config.interchangeableModules) : void 0
   };
 }
+function trimLwrConfig(config) {
+  Object.keys(config).forEach((k) => {
+    if (config[k] === void 0)
+      delete config[k];
+  });
+  return config;
+}
 function normalizeConfig(config) {
-  if (config) {
+  if (config !== void 0) {
+    config = trimLwrConfig(config);
     (0, import_app_config.validateLwrAppConfig)(JSON.stringify(config), "pre");
   }
   const rootDir = import_path.default.resolve(config?.rootDir || DEFAULT_ROOT_DIR);
@@ -243,6 +274,7 @@ function normalizeConfig(config) {
     ...lwrJsonConfig,
     ...config,
     lwc: normalizeLwcConfig(mergeLWCConfigs(lwrJsonConfig, config)),
+    bundleConfig: mergeBundleConfig(lwrJsonConfig, config),
     locker: mergeLockerConfig(lwrJsonConfig, config),
     rootDir
   };
@@ -264,9 +296,11 @@ function normalizeConfig(config) {
       interchangeableModulesMap: mergedLwrGlobalConfig.lwc.interchangeableModulesMap
     },
     moduleProviders: normalizeServices(mergedLwrGlobalConfig.moduleProviders, rootDir),
-    assetProviders: normalizeServices(DEFAULT_ASSET_PROVIDERS, rootDir),
+    assetProviders: normalizeServices(mergedLwrGlobalConfig.assetProviders, rootDir),
+    assetTransformers: normalizeServices(mergedLwrGlobalConfig.assetTransformers, rootDir),
     resourceProviders: normalizeServices(mergedLwrGlobalConfig.resourceProviders, rootDir),
     viewProviders: normalizeServices(mergedLwrGlobalConfig.viewProviders, rootDir),
+    viewTransformers: normalizeServices(mergedLwrGlobalConfig.viewTransformers, rootDir),
     routes: normalizeRoutes(mergedLwrGlobalConfig.routes, {rootDir, assets, contentDir, layoutsDir}),
     errorRoutes: normalizeRoutes(mergedLwrGlobalConfig.errorRoutes, {
       rootDir,

package/build/cjs/index.cjs

@@ -35,6 +35,7 @@ var import_module_registry = __toModule(require("@lwrjs/module-registry"));
 var import_resource_registry = __toModule(require("@lwrjs/resource-registry"));
 var import_asset_registry = __toModule(require("@lwrjs/asset-registry"));
 var import_view_registry = __toModule(require("@lwrjs/view-registry"));
+var import_diagnostics = __toModule(require("@lwrjs/diagnostics"));
 var import_env_config = __toModule(require("./env-config.cjs"));
 var import_lwr_app_observer = __toModule(require("./lwr-app-observer.cjs"));
 var import_locale_middleware = __toModule(require("./middlewares/locale-middleware.cjs"));
@@ -77,10 +78,12 @@ async function initContext(app, server, rawLwrConfig) {
   };
   const hookProviders = await getServices(rawLwrConfig.hooks, void 0, rawLwrConfig);
   const {lwrConfig, dataConfig, runtimeConfig} = await (0, import_hooks.runConfigurationsHook)(hookProviders, rawLwrConfig, rawDataConfig, rawRuntimeEnvConfig);
+  const assetTransformers = await getServices(rawLwrConfig.assetTransformers, void 0, rawLwrConfig);
   const appObserver = new import_lwr_app_observer.LwrApplicationObserver();
   const appEmitter = appObserver.createLwrEmitter();
   const compiler = new import_compiler.LwrCompiler();
   const assetRegistry = new import_asset_registry.LwrAssetRegistry({
+    assetTransformers,
     appObserver,
     appEmitter,
     runtimeEnvironment: runtimeConfig
@@ -136,9 +139,9 @@ async function initContext(app, server, rawLwrConfig) {
     notifyViewSourceChanged,
     notifyAssetSourceChanged
   } = appEmitter;
-  const providerContext = (0, import_shared_utils.deepFreeze)({
+  const providerContext = {
     compiler,
-    appObserver: {onModuleDefinitionChange, onModuleSourceChange},
+    appObserver: (0, import_shared_utils.deepFreeze)({onModuleDefinitionChange, onModuleSourceChange}),
     appEmitter: {
       notifyModuleDefinitionChanged: (payload) => notifyModuleDefinitionChanged.call(appEmitter, payload),
       notifyModuleSourceChanged: (payload) => notifyModuleSourceChanged.call(appEmitter, payload),
@@ -146,10 +149,11 @@ async function initContext(app, server, rawLwrConfig) {
       notifyAssetSourceChanged: (payload) => notifyAssetSourceChanged.call(appEmitter, payload)
     },
     moduleRegistry: moduleRegistry.getPublicApi(),
+    moduleBundler,
     resourceRegistry: resourceRegistry.getPublicApi(),
     viewRegistry: viewRegistry.getPublicApi(),
     assetRegistry: assetRegistry.getPublicApi(),
-    config: {
+    config: (0, import_shared_utils.deepFreeze)({
       cacheDir,
       modules,
       routes,
@@ -161,15 +165,17 @@ async function initContext(app, server, rawLwrConfig) {
       amdLoader,
       esmLoader,
       environment
-    },
-    runtimeEnvironment: runtimeConfig
-  });
+    }),
+    runtimeEnvironment: (0, import_shared_utils.deepFreeze)(runtimeConfig)
+  };
   const moduleProviders = await getServices(lwrConfig.moduleProviders, providerContext, lwrConfig);
   moduleRegistry.addModuleProviders(moduleProviders);
   const resourceProviders = await getServices(lwrConfig.resourceProviders, providerContext, lwrConfig);
   resourceRegistry.addResourceProviders(resourceProviders);
   const viewProviders = await getServices(lwrConfig.viewProviders, providerContext, lwrConfig);
+  const viewTransformers = await getServices(rawLwrConfig.viewTransformers, providerContext, rawLwrConfig);
   viewRegistry.addViewProviders(viewProviders);
+  viewRegistry.addViewTransformers(viewTransformers);
   await viewRegistry.initializeViewProviders();
   const assetProviders = await getServices(lwrConfig.assetProviders, providerContext, lwrConfig);
   assetRegistry.addAssetProviders(assetProviders);
@@ -190,9 +196,14 @@ var LwrApp = class {
   }
   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) {
@@ -201,7 +212,13 @@ var LwrApp = class {
     const {serverMode, port} = config;
     server.listen(port || config.port, async () => {
       if (process.env.WARMUP?.toLowerCase() === "true") {
-        await (0, import_server_warmup.warmupServer)(config, app.getInternalRequestKey());
+        try {
+          await (0, import_server_warmup.warmupServer)(config, app.getInternalRequestKey());
+        } catch (err) {
+          throw (0, import_diagnostics.createSingleDiagnosticError)({
+            description: import_diagnostics.descriptions.SERVER.WARMUP_ERROR(err.message)
+          }, import_diagnostics.LwrServerError);
+        }
       }
       callback?.({serverMode, port});
     });

package/build/cjs/middlewares/api-middleware.cjs

@@ -82,17 +82,17 @@ function apiMiddleware(app, context) {
       const resolvedUris = [];
       if (req.isSiteGeneration()) {
         if (bundleDef.bundleRecord.imports) {
-          for (let index = 0; index < bundleDef.bundleRecord.imports.length; index++) {
-            const theImport = bundleDef.bundleRecord.imports[index];
-            const id = await (0, import_shared_utils.getVersionedModuleId)(theImport.specifier, moduleRegistry);
+          for (const theImport of bundleDef.bundleRecord.imports) {
+            const childSpecifier = theImport.specifier;
+            const id = await (0, import_shared_utils.getVersionedModuleId)(childSpecifier, moduleRegistry);
             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];
-            const id = await (0, import_shared_utils.getVersionedModuleId)(theImport.specifier, moduleRegistry);
+          for (const theImport of bundleDef.bundleRecord.dynamicImports) {
+            const childSpecifier = theImport.specifier;
+            const id = await (0, import_shared_utils.getVersionedModuleId)(childSpecifier, moduleRegistry);
             const uri = await moduleRegistry.resolveModuleUri(id, runtimeEnvironment, runtimeParams);
             resolvedUris.push(uri);
           }

package/build/cjs/middlewares/utils.cjs

@@ -37,7 +37,7 @@ var window = new import_jsdom.JSDOM("").window;
 var DOMPurify = (0, import_dompurify.default)(window);
 function createReturnStatus(name, error) {
   let returnStatus = {status: 501, message: ""};
-  if (error.code === "NO_LWC_MODULE_FOUND") {
+  if ((0, import_diagnostics.isNodeError)(error) && error.code === "NO_LWC_MODULE_FOUND") {
     returnStatus = {status: 404, message: import_diagnostics.descriptions.UNRESOLVABLE.LWC_MODULE(name).message};
   } else if (error instanceof import_diagnostics.LwrUnresolvableError && error.diagnostics[0].description.category === "lwrUnresolvable/invalid") {
     returnStatus = {status: 400, message: error.message};

package/build/cjs/tools/static-generation.cjs

@@ -24,6 +24,7 @@ var __toModule = (module2) => {
 // packages/@lwrjs/core/src/tools/static-generation.ts
 __markAsModule(exports);
 __export(exports, {
+  ViewImportMetadataImpl: () => ViewImportMetadataImpl,
   default: () => static_generation_default
 });
 var import_shared_utils = __toModule(require("@lwrjs/shared-utils"));
@@ -39,7 +40,8 @@ var SiteGenerator = class {
       staticSiteGenerator.outputDir = "__generated_site__";
     }
     const outputDir = (0, import_path.join)(rootDir, staticSiteGenerator.outputDir);
-    console.log(`[INFO] Output Location: ${outputDir}`);
+    console.log(`[INFO] Clear Output Location: ${outputDir}`);
+    import_fs_extra.default.rmSync(outputDir, {recursive: true, force: true});
     const urlRewriteMap = new Map();
     await this.generateRoutes(staticSiteGenerator, routes, dispatcher, outputDir, urlRewriteMap);
     this.writeNetlifyRedirectConfig(outputDir, urlRewriteMap);
@@ -54,12 +56,12 @@ var SiteGenerator = class {
     const generateUrl = this.createGenerateURLFunction(dispatcher);
     for (const locale of staticSiteGenerator.locales) {
       for (const route of routes) {
-        const siteConfig = createSiteConfig(outputDir, locale, urlRewriteMap);
+        const siteConfig = this.createSiteConfig(outputDir, locale, urlRewriteMap);
         dispatchRequests.push(generateUrl(route.path, siteConfig));
       }
       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));
         }
       }
@@ -71,7 +73,7 @@ var SiteGenerator = class {
       const locale = siteConfig.locale;
       console.log(`[INFO] Start Generate: ${locale} ${uri}`);
       await this.dispatchResourceRecursive(uri, dispatcher, {resourceType: "route"}, siteConfig);
-      addAdditionalImportMetadataToViewConfig(siteConfig);
+      this.addAdditionalImportMetadataToViewConfig(siteConfig);
       console.log(`[INFO] End Generate ${locale} ${uri}`);
     };
     return generateRoute.bind(this);
@@ -130,12 +132,15 @@ var SiteGenerator = class {
     await Promise.all(dispatchRequests);
   }
   async handleMappingResource(url, context, siteConfig, dispatcher) {
-    const {additionalImportMetadata: importMetadata} = siteConfig;
+    const {importMetadata: importMetatdata} = siteConfig;
     const statusCode = context.response?.status;
     if (statusCode === 200) {
       const newImportMetadata = context.fs?.body;
-      const filteredImportMetadata = filterMetadata(siteConfig.existingImportMetadata, newImportMetadata);
-      mergeImportMetadata(importMetadata, filteredImportMetadata);
+      if (!importMetatdata) {
+        console.warn("[WARN] Import metadata collector was never initialized");
+        return;
+      }
+      const filteredImportMetadata = importMetatdata.addAdditionalMetadata(newImportMetadata);
       const dispatchRequests = [];
       for (const uri of Object.keys(filteredImportMetadata.imports)) {
         dispatchRequests.push(this.dispatchResourceRecursive(uri, dispatcher, {resourceType: "js"}, siteConfig));
@@ -165,7 +170,7 @@ var SiteGenerator = class {
   async handleViewDefinition(viewDefinition, siteConfig, dispatcher) {
     siteConfig.endpoints = viewDefinition.viewRecord.endpoints;
     if (viewDefinition.viewRecord.importMetadata) {
-      mergeImportMetadata(siteConfig.existingImportMetadata, viewDefinition.viewRecord.importMetadata);
+      siteConfig.importMetadata = new ViewImportMetadataImpl(viewDefinition.viewRecord.importMetadata);
     }
     const dispatchRequests = [];
     const assets = viewDefinition.viewRecord.assetReferences || [];
@@ -276,58 +281,71 @@ var SiteGenerator = class {
       }
     }
   }
-};
-var static_generation_default = SiteGenerator;
-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})`;
-    import_fs_extra.default.appendFileSync(siteConfig.viewConfigPath, `
+  createSiteConfig(outputDir, locale, urlRewriteMap) {
+    const experimentalFeatures = this.filterExperimentalFeatures();
+    return {
+      outputDir,
+      visitedUrls: new Set(),
+      locale,
+      urlRewriteMap,
+      ...experimentalFeatures
+    };
+  }
+  filterExperimentalFeatures() {
+    if ((0, import_shared_utils.getExperimentalFeatures)().ENABLE_FINGERPRINTS) {
+      return {experimentalFeatures: {ENABLE_FINGERPRINTS: true}};
+    } else {
+      return void 0;
+    }
+  }
+  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})`;
+      import_fs_extra.default.appendFileSync(siteConfig.viewConfigPath, `
 // Appended by Static Site Generator
 ${initImports}
 ${mergeImports}
 ${initIndex}
 ${mergeIndex}
 `);
+    }
+  }
+};
+var static_generation_default = SiteGenerator;
+var ViewImportMetadataImpl = class {
+  constructor(existingImportMetadata, additionalImportMetadata) {
+    this.existing = existingImportMetadata;
+    this.additional = additionalImportMetadata || {imports: {}, index: {}};
+  }
+  getAdditionalImportMetadata() {
+    return this.additional;
   }
-}
-function createSiteConfig(outputDir, locale, urlRewriteMap) {
-  const experimentalFeatures = filterExperimentalFeatures();
-  return {
-    outputDir,
-    visitedUrls: new Set(),
-    locale,
-    urlRewriteMap,
-    existingImportMetadata: {imports: {}, index: {}},
-    additionalImportMetadata: {imports: {}, index: {}},
-    ...experimentalFeatures
-  };
-}
-function filterExperimentalFeatures() {
-  if ((0, import_shared_utils.getExperimentalFeatures)().ENABLE_FINGERPRINTS) {
-    return {experimentalFeatures: {ENABLE_FINGERPRINTS: true}};
-  } else {
-    return void 0;
+  addAdditionalMetadata(newMetadata) {
+    const filteredImports = this.filterMetadata(newMetadata);
+    this.mergeImportMetadata(this.additional, filteredImports);
+    return filteredImports;
   }
-}
-function mergeImportMetadata(targetImportMetdadata, newImportMetadata) {
-  Object.assign(targetImportMetdadata.imports, newImportMetadata.imports);
-  Object.assign(targetImportMetdadata.index, newImportMetadata.index);
-}
-function filterMetadata(existingMetadata, newMetadata) {
-  const importsArray = Object.entries(newMetadata.imports);
-  const filteredImports = importsArray.filter(([key]) => !existingMetadata.imports[key]);
-  const imports = Object.fromEntries(filteredImports);
-  const indexArray = Object.entries(newMetadata.index || {});
-  const filteredIndex = indexArray.filter(([key]) => !existingMetadata.index || !existingMetadata.index[key]);
-  const index = Object.fromEntries(filteredIndex);
-  return {
-    imports,
-    index
-  };
-}
+  filterMetadata(newMetadata) {
+    const importsArray = Object.entries(newMetadata.imports);
+    const filteredImports = importsArray.filter(([key]) => !this.existing.imports[key]);
+    const imports = Object.fromEntries(filteredImports);
+    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
+    };
+  }
+  mergeImportMetadata(targetImportMetdadata, newImportMetadata) {
+    Object.assign(targetImportMetdadata.imports, newImportMetadata.imports);
+    Object.assign(targetImportMetdadata.index, newImportMetadata.index);
+  }
+};

package/build/cjs/tools/utils/network-dispatcher.cjs

@@ -28,9 +28,14 @@ __export(exports, {
 });
 var import_http = __toModule(require("http"));
 var import_https = __toModule(require("https"));
+var import_diagnostics = __toModule(require("@lwrjs/diagnostics"));
 var NetworkDispatcher = class {
   constructor(port, internalRequestKey) {
     this.port = port || 3e3;
+    const httpClient = this.port == 443 ? import_https.default : import_http.default;
+    this.pool = new httpClient.Agent({
+      maxSockets: 25
+    });
     this.internalRequestKey = internalRequestKey || "";
   }
   dispatchUrl(url, method, lang) {
@@ -39,6 +44,7 @@ var NetworkDispatcher = class {
       host: "localhost",
       port: this.port,
       path: url,
+      agent: this.pool,
       headers: {
         "Accept-Language": lang,
         "lwr-metadata-request": this.internalRequestKey
@@ -57,13 +63,27 @@ var NetworkDispatcher = class {
             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 import_diagnostics.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 import_diagnostics.DiagnosticsError) {
+          console.log("LWR Diagnostic Error: ");
+          console.log(err.diagnostics);
+          console.log(err.stack);
+        } else {
+          console.error(err);
+        }
         reject(err);
       });
       req.end();

package/build/cjs/validation/app-config-context.cjs

@@ -44,6 +44,7 @@ var ROOT_ATTRIBUTE_KEYS = createKeys("root", [
   "apiVersion",
   "assets",
   "assetProviders",
+  "assetTransformers",
   "bundleConfig",
   "cacheDir",
   "contentDir",
@@ -68,7 +69,8 @@ var ROOT_ATTRIBUTE_KEYS = createKeys("root", [
   "serverMode",
   "serverType",
   "templateEngine",
-  "viewProviders"
+  "viewProviders",
+  "viewTransformers"
 ]);
 var ASSET_DIR_ATTRIBUTE_KEYS = createKeys("assetDir", ["alias", "dir", "urlPath"]);
 var ASSET_FILE_ATTRIBUTE_KEYS = createKeys("assetFile", ["alias", "file", "urlPath"]);
@@ -101,7 +103,8 @@ var BOOTSTRAP_ATTRIBUTE_KEYS = createKeys("bootstrap", [
   "syntheticShadow",
   "workers",
   "services",
-  "configAsSrc"
+  "configAsSrc",
+  "experimentalSSR"
 ]);
 var SPECIFIER_REGEX = /^@?[\w-]+(\/[\w-]+)*$/;
 function isNotEmptyString(node) {

package/build/cjs/validation/app-config.cjs

@@ -42,6 +42,7 @@ function validateBootstrap(node, validationContext, propPrefix) {
     validationContext.assertValidKeys(node, "bootstrap", import_app_config_context.BOOTSTRAP_ATTRIBUTE_KEYS);
     validationContext.assertArrayOfSpecifiers((0, import_jsonc_parser.findNodeAtLocation)(node, ["services"]), `${propPrefix}.services`);
     validationContext.assertIsBoolean((0, import_jsonc_parser.findNodeAtLocation)(node, ["autoBoot"]), `${propPrefix}.autoBoot`);
+    validationContext.assertIsBoolean((0, import_jsonc_parser.findNodeAtLocation)(node, ["experimentalSSR"]), `${propPrefix}.experimentalSSR`);
     validationContext.assertIsBoolean((0, import_jsonc_parser.findNodeAtLocation)(node, ["configAsSrc"]), `${propPrefix}.configAsSrc`);
     validationContext.assertIsBoolean((0, import_jsonc_parser.findNodeAtLocation)(node, ["syntheticShadow"]), `${propPrefix}.syntheticShadow`);
     const workers = (0, import_jsonc_parser.findNodeAtLocation)(node, ["workers"]);

package/build/es/env-config.js

@@ -26,6 +26,7 @@ const DEFAULT_DATA_DIR = '$rootDir/src/data';
 // Providers
 const DEFAULT_MODULE_PROVIDERS = [
     '@lwrjs/app-service/moduleProvider',
+    '@lwrjs/lwc-ssr/moduleProvider',
     '@lwrjs/lwc-module-provider',
     '@lwrjs/npm-module-provider',
 ];
@@ -36,7 +37,9 @@ const DEFAULT_VIEW_PROVIDERS = [
     '@lwrjs/markdown-view-provider',
     '@lwrjs/base-view-provider',
 ];
+const DEFAULT_VIEW_TRANFORM_PLUGINS = ['@lwrjs/base-view-transformer', '@lwrjs/lwc-ssr/viewTransformer'];
 const DEFAULT_ASSET_PROVIDERS = ['@lwrjs/fs-asset-provider'];
+const DEFAULT_ASSET_TRANFORM_PLUGINS = ['@lwrjs/asset-transformer'];
 // Packages/modules
 const DEFAULT_TEMPLATE_ENGINE = '@lwrjs/base-template-engine';
 const DEFAULT_AMD_LOADER = 'lwr/loader';
@@ -47,9 +50,17 @@ const DEFAULT_LWR_MODULES = [
     { npm: getLWCEngineSpecifier() },
     { npm: '@lwrjs/client-modules' },
     { npm: '@lwrjs/loader' },
+    { npm: '@lwrjs/o11y' },
     { npm: '@lwrjs/router' },
     { npm: '@lwc/synthetic-shadow' },
 ];
+const DEFAULT_BUNDLE_EXCLUSIONS = [
+    'lwc',
+    '@lwc/synthetic-shadow',
+    'lwr/navigation',
+    'lwr/esmLoader',
+    'lwr/profiler',
+];
 // Default config objects
 const DEFAULT_LWR_CONFIG = {
     port: PORT,
@@ -60,6 +71,8 @@ const DEFAULT_LWR_CONFIG = {
     serverMode: MODE,
     apiVersion: DEFAULT_API_VERSION,
     assets: DEFAULT_ASSETS_DIR,
+    assetProviders: DEFAULT_ASSET_PROVIDERS,
+    assetTransformers: DEFAULT_ASSET_TRANFORM_PLUGINS,
     contentDir: DEFAULT_CONTENT_DIR,
     layoutsDir: DEFAULT_LAYOUTS_DIR,
     staticSiteGenerator: DEFAULT_GENERATOR_CONFIG,
@@ -69,12 +82,13 @@ const DEFAULT_LWR_CONFIG = {
     moduleProviders: DEFAULT_MODULE_PROVIDERS,
     resourceProviders: DEFAULT_RESOURCE_PROVIDERS,
     viewProviders: DEFAULT_VIEW_PROVIDERS,
+    viewTransformers: DEFAULT_VIEW_TRANFORM_PLUGINS,
     templateEngine: DEFAULT_TEMPLATE_ENGINE,
     environment: {},
     lwc: { modules: [] },
     routes: [],
     errorRoutes: [],
-    bundleConfig: {},
+    bundleConfig: { exclude: DEFAULT_BUNDLE_EXCLUSIONS },
     serverType: DEFAULT_SERVER_TYPE,
     locker: DEFAULT_LWR_LOCKER_CONFIG,
 };
@@ -192,6 +206,18 @@ function mergeLWCConfigs(config1, config2) {
             : undefined,
     };
 }
+// merge default bundle exclusions with any bundle exclusions specified in config
+function mergeBundleConfig(jsonConfig, config) {
+    const defaultExclusions = config?.bundleConfig?.UNSAFE_lwrDefaultExclude ||
+        jsonConfig?.bundleConfig?.UNSAFE_lwrDefaultExclude ||
+        DEFAULT_BUNDLE_EXCLUSIONS;
+    const configExclusions = config?.bundleConfig?.exclude || jsonConfig?.bundleConfig?.exclude || [];
+    return {
+        ...jsonConfig?.bundleConfig,
+        ...config?.bundleConfig,
+        exclude: [...new Set([...defaultExclusions, ...configExclusions])],
+    };
+}
 // merge default locker trusted namespaces/cmps with any trusted namespaces/cmps specified in config
 function mergeLockerConfig(jsonConfig, config) {
     const defaultNamespaces = DEFAULT_LOCKER_TRUSTED_CMP;
@@ -222,6 +248,13 @@ function normalizeLwcConfig(config) {
             : undefined,
     };
 }
+function trimLwrConfig(config) {
+    Object.keys(config).forEach((k) => {
+        if (config[k] === undefined)
+            delete config[k];
+    });
+    return config;
+}
 /**
  * Merge and normalize all LWR configurations.
  *
@@ -233,7 +266,8 @@ function normalizeLwcConfig(config) {
  * @returns the merged and normalized LWR configuration
  */
 export function normalizeConfig(config) {
-    if (config) {
+    if (config !== undefined) {
+        config = trimLwrConfig(config);
         validateLwrAppConfig(JSON.stringify(config), 'pre');
     }
     // Merge all configurations together, and return
@@ -246,6 +280,7 @@ export function normalizeConfig(config) {
         ...lwrJsonConfig,
         ...config,
         lwc: normalizeLwcConfig(mergeLWCConfigs(lwrJsonConfig, config)),
+        bundleConfig: mergeBundleConfig(lwrJsonConfig, config),
         locker: mergeLockerConfig(lwrJsonConfig, config),
         rootDir,
     };
@@ -270,9 +305,11 @@ export function normalizeConfig(config) {
             interchangeableModulesMap: mergedLwrGlobalConfig.lwc.interchangeableModulesMap,
         },
         moduleProviders: normalizeServices(mergedLwrGlobalConfig.moduleProviders, rootDir),
-        assetProviders: normalizeServices(DEFAULT_ASSET_PROVIDERS, rootDir),
+        assetProviders: normalizeServices(mergedLwrGlobalConfig.assetProviders, rootDir),
+        assetTransformers: normalizeServices(mergedLwrGlobalConfig.assetTransformers, rootDir),
         resourceProviders: normalizeServices(mergedLwrGlobalConfig.resourceProviders, rootDir),
         viewProviders: normalizeServices(mergedLwrGlobalConfig.viewProviders, rootDir),
+        viewTransformers: normalizeServices(mergedLwrGlobalConfig.viewTransformers, rootDir),
         routes: normalizeRoutes(mergedLwrGlobalConfig.routes, { rootDir, assets, contentDir, layoutsDir }),
         errorRoutes: normalizeRoutes(mergedLwrGlobalConfig.errorRoutes, {
             rootDir,