@lwrjs/view-registry 0.12.0-alpha.9 → 0.12.0

package/build/cjs/index.cjs

@@ -57,6 +57,10 @@ var LwrViewRegistry = class {
     observer.onAssetSourceChange(({payload}) => this.onAssetSourceChange(payload));
   }
   async onModuleDefinitionChange(moduleDefinition) {
+    if (process.env.MRT_HMR === "true") {
+      this.viewDefinitions.clear();
+      return;
+    }
     const versionedSpecifier = (0, import_shared_utils.getSpecifier)(moduleDefinition);
     for (const [id, viewDefEntry] of this.viewDefinitions.entries()) {
       const {
@@ -76,6 +80,10 @@ var LwrViewRegistry = class {
     }
   }
   async onViewSourceChange(compiledView) {
+    if (process.env.MRT_HMR === "true") {
+      this.viewDefinitions.clear();
+      return;
+    }
     const {contentTemplate, rootComponent} = compiledView.viewId;
     const compiledViewCacheKey = (0, import_shared_utils.getCacheKeyFromJson)({contentTemplate, rootComponent});
     this.compiledViews.set(compiledViewCacheKey, compiledView);
@@ -167,44 +175,54 @@ var LwrViewRegistry = class {
     return false;
   }
   async getViewDefinition(view, viewParams, runtimeEnvironment, runtimeParams, renderOptions) {
-    const {skipCaching, freezeAssets, viewParamCacheKey} = (0, import_utils.normalizeRenderOptions)(this.runtimeEnvironment, renderOptions);
-    const viewDefCacheKey = (0, import_shared_utils.getCacheKeyFromJson)({
-      ...view,
-      freezeAssets,
-      locale: runtimeParams?.locale,
-      basePath: runtimeParams?.basePath,
-      debug: runtimeEnvironment.debug
-    });
-    import_diagnostics.logger.debug(`[view-registry][getViewDefinition] viewDefCacheKey=${viewDefCacheKey}`);
-    const viewParamKey = viewParamCacheKey ? (0, import_shared_utils.getCacheKeyFromJson)(viewParamCacheKey) : (0, import_shared_utils.getCacheKeyFromJson)(viewParams);
-    import_diagnostics.logger.debug(`[view-registry][getViewDefinition] viewParamKey=${viewParamKey}`);
-    const cacheDisabled = process.env.NOCACHE === "true" || skipCaching;
-    if (cacheDisabled === false && this.viewDefinitions.has(viewDefCacheKey)) {
-      const viewDefinition2 = this.viewDefinitions.get(viewDefCacheKey);
-      if (viewDefinition2 && viewDefinition2.paramKey === viewParamKey && viewDefinition2.viewDefinition.immutable) {
-        return viewDefinition2.viewDefinition;
+    try {
+      const {skipCaching, freezeAssets, viewParamCacheKey} = (0, import_utils.normalizeRenderOptions)(this.runtimeEnvironment, renderOptions);
+      const viewDefCacheKey = (0, import_shared_utils.getCacheKeyFromJson)({
+        ...view,
+        freezeAssets,
+        locale: runtimeParams?.locale,
+        basePath: runtimeParams?.basePath,
+        debug: runtimeEnvironment.debug
+      });
+      import_diagnostics.logger.debug(`[view-registry][getViewDefinition] viewDefCacheKey=${viewDefCacheKey}`);
+      const viewParamKey = viewParamCacheKey ? (0, import_shared_utils.getCacheKeyFromJson)(viewParamCacheKey) : (0, import_shared_utils.getCacheKeyFromJson)(viewParams);
+      import_diagnostics.logger.debug(`[view-registry][getViewDefinition] viewParamKey=${viewParamKey}`);
+      const cacheDisabled = process.env.NOCACHE === "true" || skipCaching;
+      if (cacheDisabled === false && this.viewDefinitions.has(viewDefCacheKey)) {
+        const viewDefinition2 = this.viewDefinitions.get(viewDefCacheKey);
+        if (viewDefinition2 && viewDefinition2.paramKey === viewParamKey && viewDefinition2.viewDefinition.immutable) {
+          return viewDefinition2.viewDefinition;
+        }
       }
-    }
-    const pendingViewDefCacheKey = viewDefCacheKey + viewParamKey;
-    const viewDefinition = await this.pendingViewDefinitions.execute(pendingViewDefCacheKey, () => (0, import_instrumentation.getTracer)().trace({
-      name: import_instrumentation.ViewSpan.RenderView,
-      attributes: {
-        view: view.id,
-        ssr: view.bootstrap?.ssr === true
+      const pendingViewDefCacheKey = viewDefCacheKey + viewParamKey;
+      const viewDefinition = await this.pendingViewDefinitions.execute(pendingViewDefCacheKey, () => (0, import_instrumentation.getTracer)().trace({
+        name: import_instrumentation.ViewSpan.RenderView,
+        attributes: {
+          view: view.id,
+          ssr: view.bootstrap?.ssr === true
+        }
+      }, () => this.renderView(view, viewParams, runtimeEnvironment, runtimeParams, renderOptions)));
+      if (cacheDisabled === false) {
+        const route = this.globalConfig.routes.find((r) => r.id === view.id);
+        const ttl = (0, import_shared_utils.shortestTtl)(viewDefinition.cache?.ttl, route?.cache?.ttl);
+        if (ttl !== 0) {
+          this.viewDefinitions.set(viewDefCacheKey, {
+            view,
+            viewDefinition,
+            paramKey: viewParamKey
+          }, {ttl: ttl ? ttl * 1e3 : void 0});
+        }
       }
-    }, () => this.renderView(view, viewParams, runtimeEnvironment, runtimeParams, renderOptions)));
-    if (cacheDisabled === false) {
-      const route = this.globalConfig.routes.find((r) => r.id === view.id);
-      const ttl = (0, import_shared_utils.shortestTtl)(viewDefinition.cache?.ttl, route?.cache?.ttl);
-      if (ttl !== 0) {
-        this.viewDefinitions.set(viewDefCacheKey, {
-          view,
-          viewDefinition,
-          paramKey: viewParamKey
-        }, {ttl: ttl ? ttl * 1e3 : void 0});
+      return viewDefinition;
+    } catch (err) {
+      if (err instanceof import_diagnostics.DiagnosticsError) {
+        throw err;
       }
+      import_diagnostics.logger.error(`Failed to get view definition "${view.id}"`);
+      import_diagnostics.logger.error(err);
+      const message = err instanceof Error ? err.message : String(err);
+      throw (0, import_diagnostics.createSingleDiagnosticError)({description: import_diagnostics.descriptions.SERVER.UNEXPECTED_ERROR(message)}, import_diagnostics.LwrServerError);
     }
-    return viewDefinition;
   }
   async renderView(view, viewParams, runtimeEnvironment, runtimeParams = {}, renderOptions) {
     const {id, contentTemplate, rootComponent, layoutTemplate} = view;
@@ -305,6 +323,7 @@ var LwrViewRegistry = class {
     const linkedMetadata = skipMetadataCollection ? renderedViewMetadata : await (0, import_shared_utils.extractMetadataFromHtml)(renderedViewContent, renderedViewMetadata, this.globalConfig);
     const mergedViewContext = {
       ...viewContext,
+      config: this.globalConfig,
       runtimeEnvironment,
       importer: importer || renderedView.compiledView.filePath
     };

package/build/cjs/linkers/legacy_view_bootstrap.cjs

@@ -32,6 +32,14 @@ var import_identity = __toModule(require("@lwrjs/app-service/identity"));
 var import_utils = __toModule(require("../utils.cjs"));
 var import_utils2 = __toModule(require("./utils.cjs"));
 var import_preload_utils = __toModule(require("./preload-utils.cjs"));
+function includeIdFactory(bundleConfig) {
+  return (moduleRef) => {
+    if ((0, import_shared_utils.isExternalSpecifier)(moduleRef.specifier, bundleConfig)) {
+      return false;
+    }
+    return true;
+  };
+}
 async function getHtmlResources(view, viewParams, resourceContext) {
   const {
     runtimeEnvironment,
@@ -46,11 +54,21 @@ async function getHtmlResources(view, viewParams, resourceContext) {
   const version = lwrVersion;
   const isAMD = format === "amd";
   const {bundleConfig} = resourceContext;
-  const {external = {}} = bundleConfig;
+  const {external = {}, exclude = []} = bundleConfig;
   const groups = isAMD ? bundleConfig.groups || {} : {};
-  const isExternal = function(rawSpecifier) {
+  const getPreloadUri = function(rawSpecifier, uriMap) {
     const {specifier} = (0, import_shared_utils.explodeSpecifier)(rawSpecifier);
-    return Object.keys(external).some((e) => specifier === e);
+    if (Object.keys(external).some((e) => specifier === e))
+      return;
+    const uri = uriMap[rawSpecifier];
+    if (!uri && (exclude.includes(specifier) || (0, import_shared_utils.isGroupie)(specifier, groups))) {
+      import_diagnostics.logger.warn({
+        label: "view-registry",
+        message: `Skipping preload of unknown static import: ${rawSpecifier}`
+      });
+      return;
+    }
+    return uri;
   };
   const {
     id: appName,
@@ -61,6 +79,9 @@ async function getHtmlResources(view, viewParams, resourceContext) {
   } = view;
   const defRegistry = bundle ? moduleBundler : moduleRegistry;
   const depth = isAMD ? {static: import_shared_utils.GraphDepth.ALL, dynamic: 1} : {static: import_shared_utils.GraphDepth.NONE, dynamic: 0};
+  if (isAMD) {
+    depth.includeId = includeIdFactory(bundleConfig);
+  }
   const appIdentity = {
     appName,
     format: runtimeEnvironment.format,
@@ -127,8 +148,8 @@ async function getHtmlResources(view, viewParams, resourceContext) {
     }
     moduleResources.push((0, import_utils.getModuleResourceByUri)(uri, runtimeEnvironment, {isPreload: false, isSSR}));
     for (const depSpecifier of bootstrapModuleGraph.graphs[0].static) {
-      if (!isExternal(depSpecifier)) {
-        const uri2 = bootstrapModuleGraph.uriMap[depSpecifier];
+      const uri2 = getPreloadUri(depSpecifier, bootstrapModuleGraph.uriMap);
+      if (uri2) {
         (0, import_preload_utils.setPreloadModulesMeta)(depSpecifier, uri2, groups, viewPreloads);
       }
     }
@@ -169,8 +190,8 @@ async function getHtmlResources(view, viewParams, resourceContext) {
       (0, import_preload_utils.setPreloadModulesMeta)(specifier, uri, groups, viewPreloads);
       if (bundle) {
         for (const depSpecifier of graph.graphs[0].static) {
-          if (!isExternal(depSpecifier)) {
-            const uri2 = graph.uriMap[depSpecifier];
+          const uri2 = getPreloadUri(depSpecifier, graph.uriMap);
+          if (uri2) {
             (0, import_preload_utils.setPreloadModulesMeta)(depSpecifier, uri2, groups, viewPreloads);
           }
         }

package/build/cjs/linkers/utils.cjs

@@ -45,8 +45,10 @@ function getViewBootstrapConfigurationResource(viewInfo, config, runtimeEnvironm
     },
     ...debug && {modifiers: {debug: "true"}}
   };
-  const environment = {
-    NODE_ENV: runtimeEnvironment.serverMode,
+  const nodeEnv = {
+    NODE_ENV: runtimeEnvironment.serverMode
+  };
+  const lwrEnv = {
     SSR: false,
     ...(0, import_shared_utils.buildEnvironmentContext)(runtimeParams)
   };
@@ -58,9 +60,10 @@ function getViewBootstrapConfigurationResource(viewInfo, config, runtimeEnvironm
       ...config,
       endpoints
     })});`,
-    `globalThis.process = { env: ${JSON.stringify(environment)} };`,
+    `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} };`,
-    debug && debugMessage && `console.warn(${JSON.stringify(debugMessage)});`
+    debug && debugMessage && `console.error(${JSON.stringify(debugMessage)});`
   ].filter(Boolean).join("\n");
   if (viewInfo.configAsSrc) {
     const viewUrl = viewInfo.url || "/";

package/build/cjs/linkers/view_bootstrap.cjs

@@ -48,11 +48,21 @@ async function getHtmlResources(view, viewParams, resourceContext) {
   const isAMD = format === "amd";
   const depth = isAMD ? {static: import_shared_utils.GraphDepth.ALL, dynamic: 1} : {static: import_shared_utils.GraphDepth.NONE, dynamic: 1};
   const {bundleConfig} = resourceContext;
-  const {external = {}} = bundleConfig;
+  const {external = {}, exclude = []} = bundleConfig;
   const groups = isAMD ? bundleConfig.groups || {} : {};
-  const isExternal = function(rawSpecifier) {
+  const getPreloadUri = function(rawSpecifier, uriMap) {
     const {specifier} = (0, import_shared_utils.explodeSpecifier)(rawSpecifier);
-    return Object.keys(external).some((e) => specifier === e);
+    if (Object.keys(external).some((e) => specifier === e))
+      return;
+    const uri = uriMap[rawSpecifier];
+    if (!uri && (exclude.includes(specifier) || (0, import_shared_utils.isGroupie)(specifier, groups))) {
+      import_diagnostics.logger.warn({
+        label: "view-registry",
+        message: `Skipping preload of unknown static import: ${rawSpecifier}`
+      });
+      return;
+    }
+    return uri;
   };
   const {
     id: appName,
@@ -118,8 +128,8 @@ async function getHtmlResources(view, viewParams, resourceContext) {
     }
     moduleResources.push((0, import_utils.getModuleResourceByUri)(uri, runtimeEnvironment, {isPreload: false, isSSR}));
     for (const depSpecifier of bootstrapModuleGraph.graphs[0].static) {
-      if (!isExternal(depSpecifier)) {
-        const uri2 = bootstrapModuleGraph.uriMap[depSpecifier];
+      const uri2 = getPreloadUri(depSpecifier, bootstrapModuleGraph.uriMap);
+      if (uri2) {
         (0, import_preload_utils.setPreloadModulesMeta)(depSpecifier, uri2, groups, viewPreloads);
       }
     }
@@ -161,8 +171,8 @@ async function getHtmlResources(view, viewParams, resourceContext) {
       (0, import_preload_utils.setPreloadModulesMeta)(specifier, uri, groups, viewPreloads);
       if (bundle) {
         for (const depSpecifier of graph.graphs[0].static) {
-          if (!isExternal(depSpecifier)) {
-            const uri2 = graph.uriMap[depSpecifier];
+          const uri2 = getPreloadUri(depSpecifier, graph.uriMap);
+          if (uri2) {
             (0, import_preload_utils.setPreloadModulesMeta)(depSpecifier, uri2, groups, viewPreloads);
           }
         }

package/build/cjs/view-handler.cjs

@@ -30,6 +30,7 @@ var import_path = __toModule(require("path"));
 var import_shared_utils = __toModule(require("@lwrjs/shared-utils"));
 var import_instrumentation = __toModule(require("@lwrjs/instrumentation"));
 var import_utils = __toModule(require("./utils.cjs"));
+var import_diagnostics = __toModule(require("@lwrjs/diagnostics"));
 var LwrViewHandler = class {
   constructor(context, globalConfig) {
     this.globalConfig = globalConfig;
@@ -128,6 +129,7 @@ var LwrViewHandler = class {
     const {rootDir, assets, contentDir, layoutsDir} = this.globalConfig;
     const paths = {rootDir, assets, contentDir, layoutsDir};
     const locale = runtimeParams.locale;
+    const basePath = runtimeParams.basePath;
     const viewApi = this.getBoundApi(viewRequest, route, runtimeEnvironment, runtimeParams);
     const response = await (0, import_instrumentation.getTracer)().trace({
       name: import_instrumentation.ViewSpan.ExecuteRouteHandler,
@@ -135,7 +137,17 @@ var LwrViewHandler = class {
         view: route.id,
         route: viewRequest.requestPath
       }
-    }, async () => routeHandlerFn({...viewRequest, locale}, {route, viewApi, ...paths}, routeHandlerOptions));
+    }, async () => {
+      try {
+        return await routeHandlerFn({...viewRequest, locale, basePath}, {route, viewApi, ...paths}, routeHandlerOptions);
+      } catch (err) {
+        if (err instanceof import_diagnostics.DiagnosticsError) {
+          throw err;
+        }
+        const message = err instanceof Error ? err.message : String(err);
+        throw (0, import_diagnostics.createSingleDiagnosticError)({description: import_diagnostics.descriptions.APPLICATION.ROUTE_HANDLER_ERROR(route.id, message)}, import_diagnostics.LwrApplicationError);
+      }
+    });
     return response;
   }
   getBoundApi(viewRequest, route, runtimeEnvironment, runtimeParams) {

package/build/es/index.js

@@ -3,7 +3,7 @@ import { getTracer, ViewSpan } from '@lwrjs/instrumentation';
 import { normalizeRenderOptions, normalizeRenderedResult, reduceSourceAssetReferences } from './utils.js';
 import { linkLwrResources } from './linkers/link-lwr-resources.js';
 import { LRUCache } from 'lru-cache';
-import { logger } from '@lwrjs/diagnostics';
+import { DiagnosticsError, LwrServerError, createSingleDiagnosticError, descriptions, logger, } from '@lwrjs/diagnostics';
 export { LwrViewHandler } from './view-handler.js';
 export class LwrViewRegistry {
     constructor(context, globalConfig) {
@@ -36,6 +36,11 @@ export class LwrViewRegistry {
         observer.onAssetSourceChange(({ payload }) => this.onAssetSourceChange(payload));
     }
     async onModuleDefinitionChange(moduleDefinition) {
+        // TODO we will make this more robust in the future w/ full MRT HMR
+        if (process.env.MRT_HMR === 'true') {
+            this.viewDefinitions.clear();
+            return;
+        }
         const versionedSpecifier = getSpecifier(moduleDefinition);
         // invalidate viewDefinition cache entries with references to the LinkedModuleDefinition
         for (const [id, viewDefEntry] of this.viewDefinitions.entries()) {
@@ -57,6 +62,11 @@ export class LwrViewRegistry {
         }
     }
     async onViewSourceChange(compiledView) {
+        // TODO we will make this more robust in the future w/ full MRT HMR
+        if (process.env.MRT_HMR === 'true') {
+            this.viewDefinitions.clear();
+            return;
+        }
         // invalidate compiledViews and viewDefinition cache entries with references to the CompiledView template id.
         const { contentTemplate, rootComponent } = compiledView.viewId;
         const compiledViewCacheKey = getCacheKeyFromJson({ contentTemplate, rootComponent });
@@ -159,55 +169,66 @@ export class LwrViewRegistry {
         return false;
     }
     async getViewDefinition(view, viewParams, runtimeEnvironment, runtimeParams, renderOptions) {
-        const { skipCaching, freezeAssets, viewParamCacheKey } = normalizeRenderOptions(this.runtimeEnvironment, renderOptions);
-        const viewDefCacheKey = getCacheKeyFromJson({
-            ...view,
-            freezeAssets,
-            locale: runtimeParams?.locale,
-            basePath: runtimeParams?.basePath,
-            debug: runtimeEnvironment.debug,
-        });
-        logger.debug(`[view-registry][getViewDefinition] viewDefCacheKey=${viewDefCacheKey}`);
-        // viewParams is an unbounded object and can be very large (17MB/view for developer.salesforce.com). Allowing consumers
-        // to provide a simple override avoids the excess memory / performance overhead of serializing & storing the viewParams
-        // on every request, while still reusing our caching logic.
-        const viewParamKey = viewParamCacheKey
-            ? getCacheKeyFromJson(viewParamCacheKey)
-            : getCacheKeyFromJson(viewParams);
-        logger.debug(`[view-registry][getViewDefinition] viewParamKey=${viewParamKey}`);
-        const cacheDisabled = process.env.NOCACHE === 'true' || skipCaching;
-        // important: cache key does not include the unbounded viewParams
-        if (cacheDisabled === false && this.viewDefinitions.has(viewDefCacheKey)) {
-            const viewDefinition = this.viewDefinitions.get(viewDefCacheKey);
-            if (viewDefinition &&
-                viewDefinition.paramKey === viewParamKey &&
-                viewDefinition.viewDefinition.immutable) {
-                return viewDefinition.viewDefinition;
+        try {
+            const { skipCaching, freezeAssets, viewParamCacheKey } = normalizeRenderOptions(this.runtimeEnvironment, renderOptions);
+            const viewDefCacheKey = getCacheKeyFromJson({
+                ...view,
+                freezeAssets,
+                locale: runtimeParams?.locale,
+                basePath: runtimeParams?.basePath,
+                debug: runtimeEnvironment.debug,
+            });
+            logger.debug(`[view-registry][getViewDefinition] viewDefCacheKey=${viewDefCacheKey}`);
+            // viewParams is an unbounded object and can be very large (17MB/view for developer.salesforce.com). Allowing consumers
+            // to provide a simple override avoids the excess memory / performance overhead of serializing & storing the viewParams
+            // on every request, while still reusing our caching logic.
+            const viewParamKey = viewParamCacheKey
+                ? getCacheKeyFromJson(viewParamCacheKey)
+                : getCacheKeyFromJson(viewParams);
+            logger.debug(`[view-registry][getViewDefinition] viewParamKey=${viewParamKey}`);
+            const cacheDisabled = process.env.NOCACHE === 'true' || skipCaching;
+            // important: cache key does not include the unbounded viewParams
+            if (cacheDisabled === false && this.viewDefinitions.has(viewDefCacheKey)) {
+                const viewDefinition = this.viewDefinitions.get(viewDefCacheKey);
+                if (viewDefinition &&
+                    viewDefinition.paramKey === viewParamKey &&
+                    viewDefinition.viewDefinition.immutable) {
+                    return viewDefinition.viewDefinition;
+                }
+            }
+            const pendingViewDefCacheKey = viewDefCacheKey + viewParamKey;
+            const viewDefinition = await this.pendingViewDefinitions.execute(pendingViewDefCacheKey, () => getTracer().trace({
+                name: ViewSpan.RenderView,
+                attributes: {
+                    view: view.id,
+                    ssr: view.bootstrap?.ssr === true,
+                },
+            }, () => this.renderView(view, viewParams, runtimeEnvironment, runtimeParams, renderOptions)));
+            if (cacheDisabled === false) {
+                const route = this.globalConfig.routes.find((r) => r.id === view.id);
+                const ttl = shortestTtl(viewDefinition.cache?.ttl, route?.cache?.ttl);
+                if (ttl !== 0) {
+                    // cache view definition for the shortest ttl or until it is the least recently used when ttl is undefined
+                    this.viewDefinitions.set(viewDefCacheKey, {
+                        view,
+                        viewDefinition,
+                        paramKey: viewParamKey,
+                    }, 
+                    // s -> ms
+                    { ttl: ttl ? ttl * 1000 : undefined });
+                }
             }
+            return viewDefinition;
         }
-        const pendingViewDefCacheKey = viewDefCacheKey + viewParamKey;
-        const viewDefinition = await this.pendingViewDefinitions.execute(pendingViewDefCacheKey, () => getTracer().trace({
-            name: ViewSpan.RenderView,
-            attributes: {
-                view: view.id,
-                ssr: view.bootstrap?.ssr === true,
-            },
-        }, () => this.renderView(view, viewParams, runtimeEnvironment, runtimeParams, renderOptions)));
-        if (cacheDisabled === false) {
-            const route = this.globalConfig.routes.find((r) => r.id === view.id);
-            const ttl = shortestTtl(viewDefinition.cache?.ttl, route?.cache?.ttl);
-            if (ttl !== 0) {
-                // cache view definition for the shortest ttl or until it is the least recently used when ttl is undefined
-                this.viewDefinitions.set(viewDefCacheKey, {
-                    view,
-                    viewDefinition,
-                    paramKey: viewParamKey,
-                }, 
-                // s -> ms
-                { ttl: ttl ? ttl * 1000 : undefined });
+        catch (err) {
+            if (err instanceof DiagnosticsError) {
+                throw err;
             }
+            logger.error(`Failed to get view definition "${view.id}"`);
+            logger.error(err);
+            const message = err instanceof Error ? err.message : String(err);
+            throw createSingleDiagnosticError({ description: descriptions.SERVER.UNEXPECTED_ERROR(message) }, LwrServerError);
         }
-        return viewDefinition;
     }
     async renderView(view, viewParams, runtimeEnvironment, runtimeParams = {}, renderOptions) {
         const { id, contentTemplate, rootComponent, layoutTemplate } = view;
@@ -319,6 +340,7 @@ export class LwrViewRegistry {
             : await extractMetadataFromHtml(renderedViewContent, renderedViewMetadata, this.globalConfig);
         const mergedViewContext = {
             ...viewContext,
+            config: this.globalConfig,
             runtimeEnvironment,
             importer: importer || renderedView.compiledView.filePath,
         };

package/build/es/linkers/legacy_view_bootstrap.js

@@ -1,9 +1,20 @@
 import { logger } from '@lwrjs/diagnostics';
-import { kebabCaseToModuleSpecifier, getModuleGraphs, GraphDepth, getModuleUriPrefix, explodeSpecifier, isBundler, getHydrateDirective, } from '@lwrjs/shared-utils';
+import { kebabCaseToModuleSpecifier, getModuleGraphs, GraphDepth, getModuleUriPrefix, explodeSpecifier, isBundler, getHydrateDirective, isGroupie, isExternalSpecifier, } from '@lwrjs/shared-utils';
 import { AppResourceEnum, getAppSpecifier } from '@lwrjs/app-service/identity';
 import { generateHtmlTag, getModuleResourceByUri } from '../utils.js';
 import { flattenCustomElements, getViewBootstrapConfigurationResource, getViewHmrConfigurationResource, } from './utils.js';
 import { setPreloadModulesMeta, getPreloadModulesMeta } from './preload-utils.js';
+function includeIdFactory(bundleConfig) {
+    return (moduleRef) => {
+        // Do not bundle externals, including the loader module, which is auto bundled
+        // with the shim + loader combo
+        if (isExternalSpecifier(moduleRef.specifier, bundleConfig)) {
+            // Do not include externals in the required imports but also return false to indicate it should not be in the bundle
+            return false;
+        }
+        return true;
+    };
+}
 export async function getHtmlResources(view, viewParams, resourceContext) {
     const { runtimeEnvironment, runtimeParams, moduleRegistry, moduleBundler, resourceRegistry, viewMetadata, } = resourceContext;
     const { lwrVersion, format, hmrEnabled, bundle, debug, minify } = runtimeEnvironment;
@@ -11,12 +22,26 @@ export async function getHtmlResources(view, viewParams, resourceContext) {
     const version = lwrVersion;
     const isAMD = format === 'amd';
     const { bundleConfig } = resourceContext;
-    const { external = {} } = bundleConfig;
+    const { external = {}, exclude = [] } = bundleConfig;
     // Bundling groups is only supported in AMD for now
     const groups = isAMD ? bundleConfig.groups || {} : {};
-    const isExternal = function (rawSpecifier) {
+    const getPreloadUri = function (rawSpecifier, uriMap) {
         const { specifier } = explodeSpecifier(rawSpecifier);
-        return Object.keys(external).some((e) => specifier === e);
+        // do not preload externals; this is the app's responsibility
+        if (Object.keys(external).some((e) => specifier === e))
+            return;
+        const uri = uriMap[rawSpecifier];
+        // if there is no uri for an exclude or groupie, they've been handled via another specifier
+        // eg: if a bundle group has already been added to the URI map, its groups will not also be added
+        if (!uri && (exclude.includes(specifier) || isGroupie(specifier, groups))) {
+            // warn instead of throwing from setPreloadModulesMeta()
+            logger.warn({
+                label: 'view-registry',
+                message: `Skipping preload of unknown static import: ${rawSpecifier}`,
+            });
+            return;
+        }
+        return uri;
     };
     const { id: appName, bootstrap: { services, module: bootstrapModule, preloadModules = [] } = {
         services: [],
@@ -26,6 +51,9 @@ export async function getHtmlResources(view, viewParams, resourceContext) {
     const depth = isAMD
         ? { static: GraphDepth.ALL, dynamic: 1 }
         : { static: GraphDepth.NONE, dynamic: 0 };
+    if (isAMD) {
+        depth.includeId = includeIdFactory(bundleConfig);
+    }
     // The Application Bootstrap (ABS) module resource is EITHER
     //      - configured as routes[x].bootstrap.module OR
     //      - defaulted as "@lwrjs/app-service/{appName}/module/{format}"
@@ -130,8 +158,8 @@ export async function getHtmlResources(view, viewParams, resourceContext) {
         moduleResources.push(getModuleResourceByUri(uri, runtimeEnvironment, { isPreload: false, isSSR }));
         // PRELOAD the bootstrap module static dependencies as preloaded script resources
         for (const depSpecifier of bootstrapModuleGraph.graphs[0].static) {
-            if (!isExternal(depSpecifier)) {
-                const uri = bootstrapModuleGraph.uriMap[depSpecifier];
+            const uri = getPreloadUri(depSpecifier, bootstrapModuleGraph.uriMap);
+            if (uri) {
                 setPreloadModulesMeta(depSpecifier, uri, groups, viewPreloads);
             }
         }
@@ -186,8 +214,8 @@ export async function getHtmlResources(view, viewParams, resourceContext) {
             // PRELOAD custom element static deps as link resources when bundling is ON
             if (bundle) {
                 for (const depSpecifier of graph.graphs[0].static) {
-                    if (!isExternal(depSpecifier)) {
-                        const uri = graph.uriMap[depSpecifier];
+                    const uri = getPreloadUri(depSpecifier, graph.uriMap);
+                    if (uri) {
                         setPreloadModulesMeta(depSpecifier, uri, groups, viewPreloads);
                     }
                 }

package/build/es/linkers/utils.js

@@ -17,9 +17,11 @@ export function getViewBootstrapConfigurationResource(viewInfo, config, runtimeE
         },
         ...(debug && { modifiers: { debug: 'true' } }),
     };
-    const environment = {
+    const nodeEnv = {
         // TODO: W-12639529 change NODE_ENV after addressing downstream customers
         NODE_ENV: runtimeEnvironment.serverMode,
+    };
+    const lwrEnv = {
         // Note: SSR is always false because this script is executed on the client
         SSR: false,
         // Used by `lwr/environment`
@@ -33,9 +35,10 @@ export function getViewBootstrapConfigurationResource(viewInfo, config, runtimeE
             ...config,
             endpoints,
         })});`,
-        `globalThis.process = { env: ${JSON.stringify(environment)} };`,
+        `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} };`,
-        debug && debugMessage && `console.warn(${JSON.stringify(debugMessage)});`,
+        debug && debugMessage && `console.error(${JSON.stringify(debugMessage)});`,
     ]
         .filter(Boolean)
         .join('\n');

package/build/es/linkers/view_bootstrap.js

@@ -1,5 +1,5 @@
 import { logger } from '@lwrjs/diagnostics';
-import { kebabCaseToModuleSpecifier, toImportMetadata, getModuleGraphs, getMappingUriPrefix, GraphDepth, explodeSpecifier, isBundler, getHydrateDirective, } from '@lwrjs/shared-utils';
+import { kebabCaseToModuleSpecifier, toImportMetadata, getModuleGraphs, getMappingUriPrefix, GraphDepth, explodeSpecifier, isBundler, getHydrateDirective, isGroupie, } from '@lwrjs/shared-utils';
 import { AppResourceEnum, getAppSpecifier } from '@lwrjs/app-service/identity';
 import { generateHtmlTag, getModuleResourceByUri } from '../utils.js';
 import { flattenCustomElements, getViewBootstrapConfigurationResource, getViewHmrConfigurationResource, } from './utils.js';
@@ -15,12 +15,23 @@ export async function getHtmlResources(view, viewParams, resourceContext) {
         ? { static: GraphDepth.ALL, dynamic: 1 }
         : { static: GraphDepth.NONE, dynamic: 1 };
     const { bundleConfig } = resourceContext;
-    const { external = {} } = bundleConfig;
+    const { external = {}, exclude = [] } = bundleConfig;
     // Bundling groups is only supported in AMD for now
     const groups = isAMD ? bundleConfig.groups || {} : {};
-    const isExternal = function (rawSpecifier) {
+    const getPreloadUri = function (rawSpecifier, uriMap) {
         const { specifier } = explodeSpecifier(rawSpecifier);
-        return Object.keys(external).some((e) => specifier === e);
+        if (Object.keys(external).some((e) => specifier === e))
+            return;
+        const uri = uriMap[rawSpecifier];
+        if (!uri && (exclude.includes(specifier) || isGroupie(specifier, groups))) {
+            // warn instead of throwing from setPreloadModulesMeta()
+            logger.warn({
+                label: 'view-registry',
+                message: `Skipping preload of unknown static import: ${rawSpecifier}`,
+            });
+            return;
+        }
+        return uri;
     };
     const { id: appName, bootstrap: { services, module: bootstrapModule, preloadModules = [] } = {
         services: [],
@@ -114,8 +125,8 @@ export async function getHtmlResources(view, viewParams, resourceContext) {
         moduleResources.push(getModuleResourceByUri(uri, runtimeEnvironment, { isPreload: false, isSSR }));
         // PRELOAD the bootstrap module static dependencies as preloaded script resources
         for (const depSpecifier of bootstrapModuleGraph.graphs[0].static) {
-            if (!isExternal(depSpecifier)) {
-                const uri = bootstrapModuleGraph.uriMap[depSpecifier];
+            const uri = getPreloadUri(depSpecifier, bootstrapModuleGraph.uriMap);
+            if (uri) {
                 setPreloadModulesMeta(depSpecifier, uri, groups, viewPreloads);
             }
         }
@@ -172,8 +183,8 @@ export async function getHtmlResources(view, viewParams, resourceContext) {
             // PRELOAD custom element static deps as link resources when bundling is ON
             if (bundle) {
                 for (const depSpecifier of graph.graphs[0].static) {
-                    if (!isExternal(depSpecifier)) {
-                        const uri = graph.uriMap[depSpecifier];
+                    const uri = getPreloadUri(depSpecifier, graph.uriMap);
+                    if (uri) {
                         setPreloadModulesMeta(depSpecifier, uri, groups, viewPreloads);
                     }
                 }

package/build/es/view-handler.js

@@ -2,6 +2,7 @@ import { resolve } from 'path';
 import { normalizeResourcePath, shortestTtl } from '@lwrjs/shared-utils';
 import { getTracer, ViewSpan } from '@lwrjs/instrumentation';
 import { generateHtmlTag, generatePageContext, isViewResponse, toJsonFormat } from './utils.js';
+import { DiagnosticsError, LwrApplicationError, createSingleDiagnosticError, descriptions, } from '@lwrjs/diagnostics';
 export class LwrViewHandler {
     constructor(context, globalConfig) {
         this.globalConfig = globalConfig;
@@ -144,15 +145,26 @@ export class LwrViewHandler {
         const { rootDir, assets, contentDir, layoutsDir } = this.globalConfig;
         const paths = { rootDir, assets, contentDir, layoutsDir };
         const locale = runtimeParams.locale;
+        const basePath = runtimeParams.basePath;
         const viewApi = this.getBoundApi(viewRequest, route, runtimeEnvironment, runtimeParams);
-        // TODO: add trace attributes
         const response = await getTracer().trace({
             name: ViewSpan.ExecuteRouteHandler,
             attributes: {
                 view: route.id,
                 route: viewRequest.requestPath,
             },
-        }, async () => routeHandlerFn({ ...viewRequest, locale }, { route: route, viewApi, ...paths }, routeHandlerOptions));
+        }, async () => {
+            try {
+                return await routeHandlerFn({ ...viewRequest, locale, basePath }, { route: route, viewApi, ...paths }, routeHandlerOptions);
+            }
+            catch (err) {
+                if (err instanceof DiagnosticsError) {
+                    throw err;
+                }
+                const message = err instanceof Error ? err.message : String(err);
+                throw createSingleDiagnosticError({ description: descriptions.APPLICATION.ROUTE_HANDLER_ERROR(route.id, message) }, LwrApplicationError);
+            }
+        });
         return response;
     }
     /*

package/package.json

@@ -4,7 +4,7 @@
     "publishConfig": {
         "access": "public"
     },
-    "version": "0.12.0-alpha.9",
+    "version": "0.12.0",
     "homepage": "https://developer.salesforce.com/docs/platform/lwr/overview",
     "repository": {
         "type": "git",
@@ -30,17 +30,17 @@
         "build/**/*.d.ts"
     ],
     "dependencies": {
-        "@lwrjs/app-service": "0.12.0-alpha.9",
-        "@lwrjs/diagnostics": "0.12.0-alpha.9",
-        "@lwrjs/instrumentation": "0.12.0-alpha.9",
-        "@lwrjs/shared-utils": "0.12.0-alpha.9",
+        "@lwrjs/app-service": "0.12.0",
+        "@lwrjs/diagnostics": "0.12.0",
+        "@lwrjs/instrumentation": "0.12.0",
+        "@lwrjs/shared-utils": "0.12.0",
         "lru-cache": "^10.2.0"
     },
     "devDependencies": {
-        "@lwrjs/types": "0.12.0-alpha.9"
+        "@lwrjs/types": "0.12.0"
     },
     "engines": {
         "node": ">=18.0.0"
     },
-    "gitHead": "58b28fbc6300b704ac17f8878423120de0e376d7"
+    "gitHead": "90f93604b26003e1e1eb85bb0d1f34f4fc9e9ff9"
 }