@lwrjs/view-registry 0.17.2-alpha.2 → 0.17.2-alpha.20

package/build/cjs/index.cjs

@@ -32,6 +32,7 @@ var import_instrumentation = __toModule(require("@lwrjs/instrumentation"));
 var import_utils = __toModule(require("./utils.cjs"));
 var import_link_lwr_resources = __toModule(require("./linkers/link-lwr-resources.cjs"));
 var import_lru_cache = __toModule(require("lru-cache"));
+var import_crypto = __toModule(require("crypto"));
 var import_diagnostics = __toModule(require("@lwrjs/diagnostics"));
 var import_view_handler = __toModule(require("./view-handler.cjs"));
 var LwrViewRegistry = class {
@@ -57,6 +58,12 @@ var LwrViewRegistry = class {
         import_diagnostics.logger.verbose(`View evicted from cache ${key}`);
       }
     });
+    this.metadataCache = new import_lru_cache.LRUCache({
+      max: parseInt(process.env.VIEW_METADATA_CACHE_SIZE ?? "500", 10),
+      dispose: (_value, key) => {
+        import_diagnostics.logger.verbose(`Metadata evicted from cache ${key}`);
+      }
+    });
     observer.onViewSourceChange(({payload}) => this.onViewSourceChange(payload));
     observer.onModuleDefinitionChange(({payload}) => this.onModuleDefinitionChange(payload));
     observer.onAssetSourceChange(({payload}) => this.onAssetSourceChange(payload));
@@ -187,13 +194,14 @@ var LwrViewRegistry = class {
       const updatableViewParams = {...viewParams};
       (0, import_utils.generateViewNonce)(updatableViewParams);
       const pendingViewDefCacheKey = viewDefCacheKey + viewParamKey;
-      const viewDefinition = await this.pendingViewDefinitions.execute(pendingViewDefCacheKey, () => (0, import_instrumentation.getTracer)().trace({
+      const pendingViewDefCacheKeyHashed = (0, import_crypto.createHash)("md5").update(pendingViewDefCacheKey).digest("hex");
+      const viewDefinition = await this.pendingViewDefinitions.execute(pendingViewDefCacheKeyHashed, () => (0, import_instrumentation.getTracer)().trace({
         name: import_instrumentation.ViewSpan.RenderView,
         attributes: {
           view: view.id,
           ssr: view.bootstrap?.ssr === true
         }
-      }, () => this.renderView(view, updatableViewParams, runtimeEnvironment, runtimeParams, pendingViewDefCacheKey, renderOptions)));
+      }, () => this.renderView(view, updatableViewParams, runtimeEnvironment, runtimeParams, pendingViewDefCacheKeyHashed, renderOptions)));
       viewDefinition.nonce = (0, import_utils.getViewNonce)(updatableViewParams);
       const route = this.globalConfig.routes.find((r) => r.id === view.id);
       const maxViewCacheTtl = (0, import_shared_utils.getFeatureFlags)().MAX_VIEW_CACHE_TTL;
@@ -219,7 +227,7 @@ var LwrViewRegistry = class {
   }
   async renderView(view, viewParams, runtimeEnvironment, runtimeParams, viewCacheKey, renderOptions) {
     const {id, contentTemplate, rootComponent, layoutTemplate} = view;
-    const lwrResourcesId = `__LWR_RESOURCES__${Date.now()}`;
+    const lwrResourcesId = `__LWR_RESOURCES__${viewCacheKey}`;
     const renderedContent = await this.render({id, contentTemplate, rootComponent}, {...viewParams, lwr_resources: lwrResourcesId}, runtimeParams, runtimeEnvironment);
     let normalizedRenderOptions = (0, import_utils.normalizeRenderOptions)(this.runtimeEnvironment, renderedContent.options, renderOptions);
     const layout = layoutTemplate || renderedContent.compiledView.layoutTemplate;
@@ -243,6 +251,10 @@ var LwrViewRegistry = class {
       lwr_resources: lwrResourcesId
     }, runtimeParams, runtimeEnvironment);
     normalizedRenderOptions = (0, import_utils.normalizeRenderOptions)(this.runtimeEnvironment, renderedLayout.options, normalizedRenderOptions);
+    const warnings = [
+      ...renderedContent.metadata.serverDebug?.warnings || [],
+      ...renderedLayout.metadata.serverDebug?.warnings || []
+    ];
     const renderedViewDef = await this.link({
       ...renderedLayout,
       compiledView: {
@@ -262,14 +274,10 @@ var LwrViewRegistry = class {
           ...renderedContent.metadata.serverData,
           ...renderedLayout.metadata.serverData
         },
-        serverDebug: {
-          ...renderedContent.metadata.serverDebug,
-          ...renderedLayout.metadata.serverDebug
-        },
+        serverDebug: {warnings},
         serverBundles: renderedContent.metadata.serverBundles
       },
-      cache: renderedContent.cache,
-      status: renderedContent.status
+      cache: renderedContent.cache
     }, {
       view: {...view, layoutTemplate: layoutTemplatePath},
       viewParams,
@@ -290,7 +298,8 @@ var LwrViewRegistry = class {
       ...runtimeParams,
       ...globalContext,
       ...compiledView.properties,
-      ...viewParams
+      ...viewParams,
+      runtimeParams: {...runtimeParams}
     }, runtimeEnvironment);
     const normalizedResult = (0, import_utils.normalizeRenderedResult)(result);
     return {
@@ -318,17 +327,33 @@ var LwrViewRegistry = class {
       metadata: renderedViewMetadata,
       compiledView: {immutable = true}
     } = renderedView;
+    let traceId;
     const {linkedMetadata, stringBuilder} = (0, import_instrumentation.getTracer)().trace({
       name: import_instrumentation.ViewSpan.ParseView,
       attributes: {
         view: view.id,
         ssr: view.bootstrap?.ssr === true
       }
-    }, () => {
-      const linkedMetadata2 = skipMetadataCollection ? renderedViewMetadata : (0, import_shared_utils.extractMetadataFromHtml)(renderedViewContent, renderedViewMetadata, this.globalConfig);
+    }, (span) => {
+      traceId = span.traceId;
+      let linkedMetadata2 = renderedViewMetadata;
+      if (!skipMetadataCollection) {
+        const contentHash = (0, import_crypto.createHash)("md5").update(renderedViewContent).digest("hex");
+        const cacheKey = `${view.id}:${contentHash}`;
+        if (this.metadataCache.has(cacheKey)) {
+          linkedMetadata2 = this.metadataCache.get(cacheKey);
+        } else {
+          linkedMetadata2 = (0, import_shared_utils.extractMetadataFromHtml)(renderedViewContent, renderedViewMetadata, this.globalConfig);
+          this.metadataCache.set(cacheKey, linkedMetadata2);
+        }
+      }
       const stringBuilder2 = (0, import_shared_utils.createStringBuilder)(renderedViewContent);
       return {linkedMetadata: linkedMetadata2, stringBuilder: stringBuilder2};
     });
+    if (!(0, import_shared_utils.getFeatureFlags)().DISABLE_B3_TRACING && traceId && runtimeParams.viewSpanID) {
+      const content = `00-${traceId}-${runtimeParams.viewSpanID}-01`;
+      (0, import_shared_utils.addHeadMarkup)([{meta: [{name: "traceparent", content}]}], stringBuilder);
+    }
     const mergedViewContext = {
       ...viewContext,
       config: this.globalConfig,
@@ -336,7 +361,6 @@ var LwrViewRegistry = class {
       importer: importer || renderedView.compiledView.filePath
     };
     let pageTtl = renderedView.cache.ttl;
-    let pageStatus = renderedView.status;
     for (const viewTransformer of this.viewTransformers) {
       const linkResults = await (0, import_instrumentation.getTracer)().trace({
         name: import_instrumentation.ViewSpan.Transform,
@@ -346,9 +370,6 @@ var LwrViewRegistry = class {
       }, () => viewTransformer.link?.(stringBuilder, mergedViewContext, linkedMetadata));
       const ttl = linkResults && linkResults.cache?.ttl;
       pageTtl = (0, import_shared_utils.shortestTtl)(ttl || void 0, pageTtl);
-      if (!pageStatus && linkResults) {
-        pageStatus = linkResults.status;
-      }
     }
     const linkedAssetContent = stringBuilder.toString();
     if (linkedAssetContent.includes(lwrResourcesId)) {
@@ -370,7 +391,8 @@ var LwrViewRegistry = class {
             return res;
           res.push({
             url: asset.src,
-            relative: (0, import_shared_utils.isRelative)(asset.src)
+            relative: (0, import_shared_utils.isRelative)(asset.src),
+            integrity: asset.integrity
           });
           return res;
         }, []));
@@ -383,8 +405,7 @@ var LwrViewRegistry = class {
           ...viewRecord,
           serverBundles: linkedMetadata.serverBundles
         },
-        cache: {ttl: pageTtl},
-        status: pageStatus
+        cache: {ttl: pageTtl}
       };
     }
     return {
@@ -395,8 +416,7 @@ var LwrViewRegistry = class {
         moduleResources: [],
         serverBundles: linkedMetadata.serverBundles
       },
-      cache: {ttl: pageTtl},
-      status: pageStatus
+      cache: {ttl: pageTtl}
     };
   }
 };

package/build/cjs/linkers/legacy_view_bootstrap.cjs

@@ -251,7 +251,7 @@ async function getHtmlResources(view, viewParams, resourceContext) {
       }
     }
   }));
-  if (viewContainsLiveElements || serverDebug?.message) {
+  if (viewContainsLiveElements || serverDebug?.warnings?.length) {
     if ((0, import_shared_utils.isLocalDev)()) {
       const localDevSpecifier = "lwr_local_dev/bootstrap";
       rootComponents.push(localDevSpecifier);
@@ -278,7 +278,7 @@ async function getHtmlResources(view, viewParams, resourceContext) {
       serverData,
       ...isAMD && {requiredModules: requiredAmdModules},
       ...isAMD && {preloadModules: viewPreloads.specifiers}
-    }, runtimeEnvironment, runtimeParams, serverDebug?.message));
+    }, runtimeEnvironment, runtimeParams, serverDebug?.warnings));
   }
   if (!isAMD && hmrEnabled) {
     configResources.unshift((0, import_utils2.getViewHmrConfigurationResource)(view, viewMetadata));

package/build/cjs/linkers/preload-utils.cjs

@@ -31,7 +31,7 @@ var import_diagnostics = __toModule(require("@lwrjs/diagnostics"));
 var import_shared_utils = __toModule(require("@lwrjs/shared-utils"));
 function setPreloadModulesMeta(specifier, uri, integrity, groups, preloads) {
   if (!uri) {
-    throw new import_diagnostics.LwrApplicationError(import_diagnostics.descriptions.APPLICATION.PRELOAD_MODULE(specifier));
+    throw new import_diagnostics.LwrInvalidError(import_diagnostics.descriptions.INVALID.PRELOAD_MODULE(specifier));
   }
   const [removedVersion, version] = specifier.split("/v/");
   const normalizedSpecifier = version === import_shared_utils.VERSION_NOT_PROVIDED ? removedVersion : specifier;

package/build/cjs/linkers/utils.cjs

@@ -29,9 +29,10 @@ __export(exports, {
   getViewBootstrapConfigurationResource: () => getViewBootstrapConfigurationResource,
   getViewHmrConfigurationResource: () => getViewHmrConfigurationResource
 });
+var import_diagnostics = __toModule(require("@lwrjs/diagnostics"));
 var import_shared_utils = __toModule(require("@lwrjs/shared-utils"));
 var CONTENT_TYPE = "application/javascript";
-function getViewBootstrapConfigurationResource(viewInfo, config, runtimeEnvironment, runtimeParams, debugMessage) {
+function getViewBootstrapConfigurationResource(viewInfo, config, runtimeEnvironment, runtimeParams, warnings) {
   const {compat, debug, hmrEnabled, apiVersion, format} = runtimeEnvironment;
   const isESM = format === "esm";
   const defaultUrl = (0, import_shared_utils.getModuleUriPrefix)(runtimeEnvironment, runtimeParams);
@@ -51,8 +52,12 @@ function getViewBootstrapConfigurationResource(viewInfo, config, runtimeEnvironm
   };
   const lwrEnv = {
     SSR: false,
+    SSREnabled: !!viewInfo.ssr,
     ...(0, import_shared_utils.buildEnvironmentContext)(runtimeParams)
   };
+  let warnMessages = `console.group('Server-side rendering warnings:');`;
+  warnings?.forEach((warning) => warnMessages += `console.warn('${(0, import_diagnostics.stringifyError)(warning)}');`);
+  warnMessages += "console.groupEnd();";
   const configString = [
     "/* This script is generated */",
     "/* Client Bootstrap configuration */",
@@ -64,7 +69,7 @@ function getViewBootstrapConfigurationResource(viewInfo, config, runtimeEnvironm
     `globalThis.LWR = {...globalThis.LWR, env: ${JSON.stringify(lwrEnv)}};`,
     `globalThis.process={...globalThis.process,env:{...globalThis.process?.env,...${JSON.stringify(nodeEnv)}}};`,
     `globalThis.lwcRuntimeFlags = { ENABLE_MIXED_SHADOW_MODE: ${viewInfo.mixedMode}, ENABLE_WIRE_SYNC_EMIT: ${viewInfo.ssr} };`,
-    debug && debugMessage && `console.error(${JSON.stringify(debugMessage)});`
+    warnings?.length && warnMessages
   ].filter(Boolean).join("\n");
   if (viewInfo.configAsSrc) {
     const viewUrl = viewInfo.url || "/";

package/build/cjs/linkers/view_bootstrap.cjs

@@ -234,7 +234,7 @@ async function getHtmlResources(view, viewParams, resourceContext) {
       importMetadata = await (0, import_shared_utils.toImportMetadata)(graph, importMetadata, moduleRegistry, runtimeEnvironment, runtimeParams);
     }
   }
-  if (viewContainsLiveElements || serverDebug?.message) {
+  if (viewContainsLiveElements || serverDebug?.warnings?.length) {
     configResources.unshift((0, import_utils2.getViewBootstrapConfigurationResource)({
       id: view.id,
       url: viewParams?.page?.url,
@@ -252,7 +252,7 @@ async function getHtmlResources(view, viewParams, resourceContext) {
       serverData,
       ...isAMD && {requiredModules: requiredAmdModules},
       ...isAMD && {preloadModules: viewPreloads.specifiers}
-    }, runtimeEnvironment, runtimeParams, serverDebug?.message));
+    }, runtimeEnvironment, runtimeParams, serverDebug?.warnings));
   }
   if (!isAMD && hmrEnabled) {
     configResources.unshift((0, import_utils2.getViewHmrConfigurationResource)(view, viewMetadata));

package/build/cjs/utils.cjs

@@ -112,8 +112,7 @@ function normalizeRenderedResult({
   renderedView,
   metadata,
   options,
-  cache,
-  status
+  cache
 }) {
   return {
     renderedView,
@@ -127,16 +126,16 @@ function normalizeRenderedResult({
     options: {
       skipMetadataCollection: options ? options.skipMetadataCollection : false
     },
-    cache: cache || {},
-    status
+    cache: cache || {}
   };
 }
 function reduceSourceAssetReferences(assets) {
-  return assets.map(({url, tagName, override}) => {
+  return assets.map(({url, tagName, override, integrity}) => {
     return {
       url,
       tagName,
-      override
+      override,
+      integrity
     };
   });
 }
@@ -314,7 +313,7 @@ function generateLinkHeaders(assets, patterns) {
       for (const filePattern of matchPatterns) {
         const regex = new RegExp(filePattern);
         if (regex.test(path)) {
-          matched = pattern.attributes;
+          matched = pattern.attributes || {};
           break;
         }
       }
@@ -323,6 +322,9 @@ function generateLinkHeaders(assets, patterns) {
     }
     if (matched) {
       assetConfig[path] = matched;
+      if (assetRef.integrity) {
+        assetConfig[path].integrity = assetRef.integrity;
+      }
     }
   }
   return Object.keys(assetConfig).reduce((linkHeader, path) => {

package/build/es/index.d.ts

@@ -47,6 +47,7 @@ export declare class LwrViewRegistry implements ViewRegistry {
     getViewDefinition(view: View, viewParams: ViewParams, runtimeEnvironment: RuntimeEnvironment, runtimeParams?: RuntimeParams, renderOptions?: RenderOptions): Promise<LinkedViewDefinition>;
     private renderView;
     private render;
+    private metadataCache;
     private link;
 }
 //# sourceMappingURL=index.d.ts.map

package/build/es/index.js

@@ -1,9 +1,10 @@
-import { InflightTasks, createStringBuilder, extractMetadataFromHtml, getCacheKeyFromJson, getFeatureFlags, getSpecifier, isLocalDev, normalizeResourcePath, shortestTtl, isRelative, } from '@lwrjs/shared-utils';
+import { InflightTasks, addHeadMarkup, createStringBuilder, extractMetadataFromHtml, getCacheKeyFromJson, getFeatureFlags, getSpecifier, isLocalDev, isRelative, normalizeResourcePath, shortestTtl, } from '@lwrjs/shared-utils';
 import { getTracer, ViewSpan } from '@lwrjs/instrumentation';
 import { generateViewNonce, getViewNonce, normalizeRenderOptions, normalizeRenderedResult, reduceSourceAssetReferences, getViewDefCacheKey, } from './utils.js';
 import { linkLwrResources } from './linkers/link-lwr-resources.js';
 // TODO: investigate perf impact W-16056356
 import { LRUCache } from 'lru-cache';
+import { createHash } from 'crypto';
 import { LwrError, LwrServerError, descriptions, logger } from '@lwrjs/diagnostics';
 export { LwrViewHandler } from './view-handler.js';
 export class LwrViewRegistry {
@@ -37,6 +38,12 @@ export class LwrViewRegistry {
                 logger.verbose(`View evicted from cache ${key}`);
             },
         });
+        this.metadataCache = new LRUCache({
+            max: parseInt(process.env.VIEW_METADATA_CACHE_SIZE ?? '500', 10),
+            dispose: (_value, key) => {
+                logger.verbose(`Metadata evicted from cache ${key}`);
+            },
+        });
         // Observers for cached entries external dependencies -- view templates, modules, and assets
         observer.onViewSourceChange(({ payload }) => this.onViewSourceChange(payload));
         observer.onModuleDefinitionChange(({ payload }) => this.onModuleDefinitionChange(payload));
@@ -194,13 +201,16 @@ export class LwrViewRegistry {
             const updatableViewParams = { ...viewParams };
             generateViewNonce(updatableViewParams);
             const pendingViewDefCacheKey = viewDefCacheKey + viewParamKey;
-            const viewDefinition = await this.pendingViewDefinitions.execute(pendingViewDefCacheKey, () => getTracer().trace({
+            const pendingViewDefCacheKeyHashed = createHash('md5')
+                .update(pendingViewDefCacheKey)
+                .digest('hex');
+            const viewDefinition = await this.pendingViewDefinitions.execute(pendingViewDefCacheKeyHashed, () => getTracer().trace({
                 name: ViewSpan.RenderView,
                 attributes: {
                     view: view.id,
                     ssr: view.bootstrap?.ssr === true,
                 },
-            }, () => this.renderView(view, updatableViewParams, runtimeEnvironment, runtimeParams, pendingViewDefCacheKey, renderOptions)));
+            }, () => this.renderView(view, updatableViewParams, runtimeEnvironment, runtimeParams, pendingViewDefCacheKeyHashed, renderOptions)));
             // Once the view is generated add the nonce to the response so it can be cached and then added to the headers
             viewDefinition.nonce = getViewNonce(updatableViewParams);
             const route = this.globalConfig.routes.find((r) => r.id === view.id);
@@ -236,7 +246,7 @@ export class LwrViewRegistry {
     }
     async renderView(view, viewParams, runtimeEnvironment, runtimeParams, viewCacheKey, renderOptions) {
         const { id, contentTemplate, rootComponent, layoutTemplate } = view;
-        const lwrResourcesId = `__LWR_RESOURCES__${Date.now()}`;
+        const lwrResourcesId = `__LWR_RESOURCES__${viewCacheKey}`;
         const renderedContent = await this.render({ id, contentTemplate, rootComponent }, { ...viewParams, lwr_resources: lwrResourcesId }, runtimeParams, runtimeEnvironment);
         // normalize the renderOptions provided by the CompiledView content with the request options.
         let normalizedRenderOptions = normalizeRenderOptions(this.runtimeEnvironment, renderedContent.options, renderOptions);
@@ -264,6 +274,10 @@ export class LwrViewRegistry {
             lwr_resources: lwrResourcesId,
         }, runtimeParams, runtimeEnvironment);
         normalizedRenderOptions = normalizeRenderOptions(this.runtimeEnvironment, renderedLayout.options, normalizedRenderOptions);
+        const warnings = [
+            ...(renderedContent.metadata.serverDebug?.warnings || []),
+            ...(renderedLayout.metadata.serverDebug?.warnings || []),
+        ];
         const renderedViewDef = await this.link({
             ...renderedLayout,
             // Rendered Layout view's immutability is a composite of the layouts mutability and the body's mutability
@@ -285,14 +299,10 @@ export class LwrViewRegistry {
                     ...renderedContent.metadata.serverData,
                     ...renderedLayout.metadata.serverData,
                 },
-                serverDebug: {
-                    ...renderedContent.metadata.serverDebug,
-                    ...renderedLayout.metadata.serverDebug,
-                },
+                serverDebug: { warnings },
                 serverBundles: renderedContent.metadata.serverBundles, // 1st pass of SSR
             },
             cache: renderedContent.cache,
-            status: renderedContent.status,
         }, 
         // Render Content now contains a layout
         {
@@ -328,6 +338,8 @@ export class LwrViewRegistry {
             ...globalContext,
             ...compiledView.properties,
             ...viewParams,
+            // provides access to runtimeParams which are not overwritten by context/props/viewParams
+            runtimeParams: { ...runtimeParams },
         }, runtimeEnvironment);
         const normalizedResult = normalizeRenderedResult(result);
         return {
@@ -343,19 +355,37 @@ export class LwrViewRegistry {
         const runtimeEnvironment = { ...runtimeEnv, immutableAssets: freezeAssets };
         // normalize/extract metadata
         const { renderedView: renderedViewContent, metadata: renderedViewMetadata, compiledView: { immutable = true }, } = renderedView;
+        let traceId;
         const { linkedMetadata, stringBuilder } = getTracer().trace({
             name: ViewSpan.ParseView,
             attributes: {
                 view: view.id,
                 ssr: view.bootstrap?.ssr === true,
             },
-        }, () => {
-            const linkedMetadata = skipMetadataCollection
-                ? renderedViewMetadata
-                : extractMetadataFromHtml(renderedViewContent, renderedViewMetadata, this.globalConfig);
+        }, (span) => {
+            traceId = span.traceId;
+            let linkedMetadata = renderedViewMetadata;
+            if (!skipMetadataCollection) {
+                // Create a unique key based on view ID and content hash
+                const contentHash = createHash('md5').update(renderedViewContent).digest('hex');
+                const cacheKey = `${view.id}:${contentHash}`;
+                if (this.metadataCache.has(cacheKey)) {
+                    linkedMetadata = this.metadataCache.get(cacheKey);
+                }
+                else {
+                    linkedMetadata = extractMetadataFromHtml(renderedViewContent, renderedViewMetadata, this.globalConfig);
+                    this.metadataCache.set(cacheKey, linkedMetadata);
+                }
+            }
             const stringBuilder = createStringBuilder(renderedViewContent);
             return { linkedMetadata, stringBuilder };
         });
+        // Add distributed tracing meta tag to pass tracing info to the client
+        // {version}-{traceId}-{spanId}-{sampleDecision} and version is always 00
+        if (!getFeatureFlags().DISABLE_B3_TRACING && traceId && runtimeParams.viewSpanID) {
+            const content = `00-${traceId}-${runtimeParams.viewSpanID}-01`;
+            addHeadMarkup([{ meta: [{ name: 'traceparent', content }] }], stringBuilder);
+        }
         const mergedViewContext = {
             ...viewContext,
             config: this.globalConfig,
@@ -364,7 +394,6 @@ export class LwrViewRegistry {
         };
         // Note: this is the TTL for the page NOT for the view registry cache
         let pageTtl = renderedView.cache.ttl;
-        let pageStatus = renderedView.status;
         for (const viewTransformer of this.viewTransformers) {
             // eslint-disable-next-line no-await-in-loop
             const linkResults = await getTracer().trace({
@@ -376,10 +405,6 @@ export class LwrViewRegistry {
             // Keep track of the shortest TTL from each view transformer (e.g. lwcSsrViewTransformer)
             const ttl = linkResults && linkResults.cache?.ttl;
             pageTtl = shortestTtl(ttl || undefined, pageTtl);
-            // Set the status info, if it doesn't already exist
-            if (!pageStatus && linkResults) {
-                pageStatus = linkResults.status;
-            }
         }
         const linkedAssetContent = stringBuilder.toString();
         // Link LWR related resources
@@ -406,6 +431,7 @@ export class LwrViewRegistry {
                     res.push({
                         url: asset.src,
                         relative: isRelative(asset.src),
+                        integrity: asset.integrity,
                     });
                     return res;
                 }, []));
@@ -420,7 +446,6 @@ export class LwrViewRegistry {
                     serverBundles: linkedMetadata.serverBundles,
                 },
                 cache: { ttl: pageTtl },
-                status: pageStatus,
             };
         }
         return {
@@ -432,7 +457,6 @@ export class LwrViewRegistry {
                 serverBundles: linkedMetadata.serverBundles,
             },
             cache: { ttl: pageTtl },
-            status: pageStatus,
         };
     }
 }

package/build/es/linkers/legacy_view_bootstrap.js

@@ -290,7 +290,7 @@ export async function getHtmlResources(view, viewParams, resourceContext) {
             }
         }
     }));
-    if (viewContainsLiveElements || serverDebug?.message) {
+    if (viewContainsLiveElements || serverDebug?.warnings?.length) {
         if (isLocalDev()) {
             // ADD the client-side bootstrap module and mapping for local-dev
             const localDevSpecifier = 'lwr_local_dev/bootstrap';
@@ -320,7 +320,7 @@ export async function getHtmlResources(view, viewParams, resourceContext) {
             ...(isAMD && { requiredModules: requiredAmdModules }),
             // in AMD we need to tell the loader what modules we are preloading
             ...(isAMD && { preloadModules: viewPreloads.specifiers }),
-        }, runtimeEnvironment, runtimeParams, serverDebug?.message));
+        }, runtimeEnvironment, runtimeParams, serverDebug?.warnings));
     }
     if (!isAMD && hmrEnabled) {
         configResources.unshift(getViewHmrConfigurationResource(view, viewMetadata));

package/build/es/linkers/preload-utils.js

@@ -1,4 +1,4 @@
-import { LwrApplicationError, descriptions, logger } from '@lwrjs/diagnostics';
+import { LwrInvalidError, descriptions, logger } from '@lwrjs/diagnostics';
 import { explodeSpecifier, getGroupName, getVersionedModuleId, normalizeVersionToUri, VERSION_NOT_PROVIDED, getSpecifier, isGroupie, } from '@lwrjs/shared-utils';
 /**
  * keeps track of preloadModules metadata
@@ -6,7 +6,7 @@ import { explodeSpecifier, getGroupName, getVersionedModuleId, normalizeVersionT
 export function setPreloadModulesMeta(specifier, uri, integrity, groups, preloads) {
     // Throw a very specific error if we get this back and the uri property is not set
     if (!uri) {
-        throw new LwrApplicationError(descriptions.APPLICATION.PRELOAD_MODULE(specifier));
+        throw new LwrInvalidError(descriptions.INVALID.PRELOAD_MODULE(specifier));
     }
     // We need to support version-less preloadModules, including version-less rootComponents.
     // Removing the "/v/version_not_provided" hack from the preloadModules specifier

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

@@ -1,5 +1,5 @@
 import type { ClientBootstrapConfig, RuntimeEnvironment, RuntimeParams, ResourceDefinition, RenderedViewMetadata, CustomElementReference, View, ViewInfo, FlattenedModuleGraphs } from '@lwrjs/types';
-export declare function getViewBootstrapConfigurationResource(viewInfo: ViewInfo, config: ClientBootstrapConfig, runtimeEnvironment: RuntimeEnvironment, runtimeParams: RuntimeParams, debugMessage?: string): ResourceDefinition;
+export declare function getViewBootstrapConfigurationResource(viewInfo: ViewInfo, config: ClientBootstrapConfig, runtimeEnvironment: RuntimeEnvironment, runtimeParams: RuntimeParams, warnings?: (Error | string)[]): ResourceDefinition;
 export declare function getViewHmrConfigurationResource(view: View, viewMetadata: RenderedViewMetadata): ResourceDefinition;
 export declare function flattenCustomElements(arr: CustomElementReference[], isSSR?: boolean): CustomElementReference[];
 export declare function getBundleIntegrity(bootstrapModuleGraph: FlattenedModuleGraphs, versionedSpecifier: string): string | undefined;

package/build/es/linkers/utils.js

@@ -1,6 +1,7 @@
+import { stringifyError } from '@lwrjs/diagnostics';
 import { buildEnvironmentContext, getMappingUriPrefix, getModuleUriPrefix, getClientBootstrapConfigurationUri, hashContent, } from '@lwrjs/shared-utils';
 const CONTENT_TYPE = 'application/javascript';
-export function getViewBootstrapConfigurationResource(viewInfo, config, runtimeEnvironment, runtimeParams, debugMessage) {
+export function getViewBootstrapConfigurationResource(viewInfo, config, runtimeEnvironment, runtimeParams, warnings) {
     const { compat, debug, hmrEnabled, apiVersion, format } = runtimeEnvironment;
     const isESM = format === 'esm';
     const defaultUrl = getModuleUriPrefix(runtimeEnvironment, runtimeParams);
@@ -24,9 +25,13 @@ export function getViewBootstrapConfigurationResource(viewInfo, config, runtimeE
     const lwrEnv = {
         // Note: SSR is always false because this script is executed on the client
         SSR: false,
+        SSREnabled: !!viewInfo.ssr,
         // Used by `lwr/environment`
         ...buildEnvironmentContext(runtimeParams),
     };
+    let warnMessages = `console.group('Server-side rendering warnings:');`;
+    warnings?.forEach((warning) => (warnMessages += `console.warn('${stringifyError(warning)}');`));
+    warnMessages += 'console.groupEnd();';
     const configString = [
         '/* This script is generated */',
         '/* Client Bootstrap configuration */',
@@ -39,7 +44,7 @@ export function getViewBootstrapConfigurationResource(viewInfo, config, runtimeE
         `globalThis.process={...globalThis.process,env:{...globalThis.process?.env,...${JSON.stringify(nodeEnv)}}};`,
         // TODO: evaluate moving these to app layer
         `globalThis.lwcRuntimeFlags = { ENABLE_MIXED_SHADOW_MODE: ${viewInfo.mixedMode}, ENABLE_WIRE_SYNC_EMIT: ${viewInfo.ssr} };`,
-        debug && debugMessage && `console.error(${JSON.stringify(debugMessage)});`,
+        warnings?.length && warnMessages,
     ]
         .filter(Boolean)
         .join('\n');

package/build/es/linkers/view_bootstrap.js

@@ -262,7 +262,7 @@ export async function getHtmlResources(view, viewParams, resourceContext) {
             importMetadata = await toImportMetadata(graph, importMetadata, moduleRegistry, runtimeEnvironment, runtimeParams);
         }
     }
-    if (viewContainsLiveElements || serverDebug?.message) {
+    if (viewContainsLiveElements || serverDebug?.warnings?.length) {
         // ADD configuration of the bootstrapModule
         configResources.unshift(getViewBootstrapConfigurationResource({
             id: view.id,
@@ -282,7 +282,7 @@ export async function getHtmlResources(view, viewParams, resourceContext) {
             ...(isAMD && { requiredModules: requiredAmdModules }),
             // in AMD we need to tell the loader what modules we are preloading
             ...(isAMD && { preloadModules: viewPreloads.specifiers }),
-        }, runtimeEnvironment, runtimeParams, serverDebug?.message));
+        }, runtimeEnvironment, runtimeParams, serverDebug?.warnings));
     }
     if (!isAMD && hmrEnabled) {
         configResources.unshift(getViewHmrConfigurationResource(view, viewMetadata));

package/build/es/utils.d.ts

@@ -1,7 +1,7 @@
 import type { AssetReference, JsonCompatible, LinkedViewDefinition, LwrErrorRoute, LwrRoute, ModuleBundler, ModuleId, ModuleJson, ModuleRegistry, NormalizedRenderingResult, PublicModuleRegistry, RenderOptions, RenderedAssetReference, RenderingResult, ResourceDefinition, RouteHandlerViewResponse, RuntimeEnvironment, RuntimeParams, ViewModuleResourceContext, ViewPageContext, ViewParams, ViewRequest, ViewResponse, ViewDefinitionResponse, View } from '@lwrjs/types';
 export type HTMLResource = Partial<ResourceDefinition>;
 export declare function generateHtmlTag(definition: HTMLResource): Promise<string>;
-export declare function normalizeRenderedResult({ renderedView, metadata, options, cache, status, }: RenderingResult): NormalizedRenderingResult;
+export declare function normalizeRenderedResult({ renderedView, metadata, options, cache, }: RenderingResult): NormalizedRenderingResult;
 export declare function reduceSourceAssetReferences(assets: AssetReference[]): RenderedAssetReference[];
 export declare function normalizeRenderOptions(runtimeEnvironment: RuntimeEnvironment, overrideRenderOptions?: RenderOptions, baseRenderOptions?: RenderOptions): Required<RenderOptions>;
 export declare function generatePageContext({ requestPath: url }: ViewRequest, { id, contentTemplate, properties }: LwrRoute | LwrErrorRoute, runtimeParams: RuntimeParams): JsonCompatible<ViewPageContext>;

package/build/es/utils.js

@@ -66,7 +66,7 @@ export async function generateHtmlTag(definition) {
     }
     throw new Error(`Invalid external Resource Definition: missing a "src": "${definition.specifier}"`);
 }
-export function normalizeRenderedResult({ renderedView, metadata, options, cache, status, }) {
+export function normalizeRenderedResult({ renderedView, metadata, options, cache, }) {
     return {
         renderedView,
         metadata: {
@@ -80,15 +80,15 @@ export function normalizeRenderedResult({ renderedView, metadata, options, cache
             skipMetadataCollection: options ? options.skipMetadataCollection : false,
         },
         cache: cache || {},
-        status,
     };
 }
 export function reduceSourceAssetReferences(assets) {
-    return assets.map(({ url, tagName, override }) => {
+    return assets.map(({ url, tagName, override, integrity }) => {
         return {
             url,
             tagName,
             override,
+            integrity,
         };
     });
 }
@@ -300,7 +300,7 @@ export function generateLinkHeaders(assets, patterns) {
             for (const filePattern of matchPatterns) {
                 const regex = new RegExp(filePattern);
                 if (regex.test(path)) {
-                    matched = pattern.attributes;
+                    matched = pattern.attributes || {};
                     break;
                 }
             }
@@ -309,6 +309,10 @@ export function generateLinkHeaders(assets, patterns) {
         }
         if (matched) {
             assetConfig[path] = matched;
+            if (assetRef.integrity) {
+                // always add the integrity attribute, if it exists
+                assetConfig[path].integrity = assetRef.integrity;
+            }
         }
     }
     // Use the assetConfig to construct the Link Header

package/package.json

@@ -4,7 +4,7 @@
     "publishConfig": {
         "access": "public"
     },
-    "version": "0.17.2-alpha.2",
+    "version": "0.17.2-alpha.20",
     "homepage": "https://developer.salesforce.com/docs/platform/lwr/overview",
     "repository": {
         "type": "git",
@@ -33,20 +33,20 @@
         "build": "tsc -b"
     },
     "dependencies": {
-        "@lwrjs/app-service": "0.17.2-alpha.2",
-        "@lwrjs/diagnostics": "0.17.2-alpha.2",
-        "@lwrjs/instrumentation": "0.17.2-alpha.2",
-        "@lwrjs/shared-utils": "0.17.2-alpha.2",
+        "@lwrjs/app-service": "0.17.2-alpha.20",
+        "@lwrjs/diagnostics": "0.17.2-alpha.20",
+        "@lwrjs/instrumentation": "0.17.2-alpha.20",
+        "@lwrjs/shared-utils": "0.17.2-alpha.20",
         "lru-cache": "^10.4.3"
     },
     "devDependencies": {
-        "@lwrjs/types": "0.17.2-alpha.2"
+        "@lwrjs/types": "0.17.2-alpha.20"
     },
     "engines": {
-        "node": ">=18.0.0"
+        "node": ">=20.0.0"
     },
     "volta": {
         "extends": "../../../package.json"
     },
-    "gitHead": "739b237f5d7f2c1989142cb505a56cc763f21976"
+    "gitHead": "871213620dec8ff886be421339f1e90e86dbee96"
 }