@lwrjs/view-registry 0.10.0-alpha.14 → 0.10.0-alpha.16

package/build/cjs/index.cjs

@@ -30,12 +30,12 @@ __export(exports, {
 var import_shared_utils = __toModule(require("@lwrjs/shared-utils"));
 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_view_handler = __toModule(require("./view-handler.cjs"));
 var LwrViewRegistry = class {
   constructor(context, globalConfig) {
     this.viewProviders = [];
     this.compiledViews = new Map();
-    this.viewDefinitions = new Map();
     this.immutableAssets = new Map();
     this.pendingViewDefinitions = new import_shared_utils.InflightTasks();
     this.name = "lwr-view-registry";
@@ -49,14 +49,17 @@ var LwrViewRegistry = class {
     this.globalData = context.globalData;
     this.appEmitter = context.appEmitter;
     const observer = context.appObserver;
+    this.viewDefinitions = new import_lru_cache.LRUCache({max: parseInt(process.env.VIEW_CACHE_SIZE || "500", 10)});
     observer.onViewSourceChange(({payload}) => this.onViewSourceChange(payload));
     observer.onModuleDefinitionChange(({payload}) => this.onModuleDefinitionChange(payload));
     observer.onAssetSourceChange(({payload}) => this.onAssetSourceChange(payload));
   }
   async onModuleDefinitionChange(moduleDefinition) {
     const versionedSpecifier = (0, import_shared_utils.getSpecifier)(moduleDefinition);
-    for (const [id, {viewDefinition}] of this.viewDefinitions.entries()) {
-      const {viewRecord} = viewDefinition;
+    for (const [id, viewDefEntry] of this.viewDefinitions.entries()) {
+      const {
+        viewDefinition: {viewRecord}
+      } = viewDefEntry;
       const uriMap = viewRecord.bootstrapModule?.flatGraph.uriMap;
       if (uriMap) {
         Object.keys(uriMap);
@@ -74,12 +77,12 @@ var LwrViewRegistry = class {
     const {contentTemplate, rootComponent} = compiledView.viewId;
     const compiledViewCacheKey = (0, import_shared_utils.getCacheKeyFromJson)({contentTemplate, rootComponent});
     this.compiledViews.set(compiledViewCacheKey, compiledView);
-    for (const [id, {view}] of this.viewDefinitions.entries()) {
+    for (const [id, viewDefEntry] of this.viewDefinitions.entries()) {
       const {
         contentTemplate: eContentTempl,
         layoutTemplate: eLayoutTemplate,
         rootComponent: eRootComponent
-      } = view;
+      } = viewDefEntry.view;
       if (eContentTempl === contentTemplate || eLayoutTemplate === contentTemplate || eRootComponent === rootComponent) {
         this.viewDefinitions.delete(id);
       }
@@ -87,8 +90,10 @@ var LwrViewRegistry = class {
   }
   onAssetSourceChange(asset) {
     const assetId = asset.entry;
-    for (const [id, {viewDefinition}] of this.viewDefinitions.entries()) {
-      const {viewRecord} = viewDefinition;
+    for (const [id, viewDefEntry] of this.viewDefinitions.entries()) {
+      const {
+        viewDefinition: {viewRecord}
+      } = viewDefEntry;
       const someAssets = viewRecord.assetReferences?.some((ref) => {
         return ref.override?.entry === assetId;
       });
@@ -174,11 +179,13 @@ var LwrViewRegistry = class {
     const pendingViewDefCacheKey = viewDefCacheKey + viewParamKey;
     const viewDefinition = await this.pendingViewDefinitions.execute(pendingViewDefCacheKey, () => 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);
       this.viewDefinitions.set(viewDefCacheKey, {
         view,
         viewDefinition,
         paramKey: viewParamKey
-      });
+      }, {ttl: ttl ? ttl * 1e3 : void 0});
     }
     return viewDefinition;
   }

package/build/cjs/linkers/legacy_view_bootstrap.cjs

@@ -82,8 +82,8 @@ async function getHtmlResources(view, viewParams, resourceContext) {
   let bootstrapModuleRef, versionedSpecifier = bootstrapSpecifier;
   const customElementsRecords = [];
   const flattenedElements = (0, import_utils2.flattenCustomElements)(customElements, isSSR);
-  const viewContainsHydratedElements = !isSSR || flattenedElements.some(({props}) => (0, import_shared_utils.hasHydrateDirective)(props));
-  if (viewContainsHydratedElements) {
+  const viewContainsLiveElements = !isSSR || flattenedElements.some(({props}) => (0, import_shared_utils.getHydrateDirective)(props));
+  if (viewContainsLiveElements) {
     if (isAMD) {
       const shimBundle = debug || minify === false ? "lwr-loader-shim-legacy.bundle.js" : "lwr-loader-shim-legacy.bundle.min.js";
       let def = await resourceRegistry.getResource({specifier: shimBundle, version}, runtimeEnvironment, runtimeParams);
@@ -150,7 +150,7 @@ async function getHtmlResources(view, viewParams, resourceContext) {
   await Promise.all(flattenedElements.map(async ({tagName: element, props}) => {
     const graph = await (0, import_shared_utils.getModuleGraphs)((0, import_shared_utils.kebabCaseToModuleSpecifier)(element), {includeUris: true, includeLinkedDefinitions: true, depth}, moduleRegistry, defRegistry, runtimeEnvironment, runtimeParams ? runtimeParams : {}, visitedCache);
     customElementsRecords.push({elementName: element, flatGraph: graph});
-    if (!isSSR || (0, import_shared_utils.hasHydrateDirective)(props)) {
+    if (!isSSR || (0, import_shared_utils.getHydrateDirective)(props)) {
       const specifier = graph.graphs[0].specifier;
       const uri = graph.uriMap[specifier];
       (0, import_preload_utils.setPreloadModulesMeta)(specifier, uri, groups, viewPreloads);
@@ -176,7 +176,7 @@ async function getHtmlResources(view, viewParams, resourceContext) {
       }
     }
   }));
-  if (viewContainsHydratedElements) {
+  if (viewContainsLiveElements) {
     configResources.unshift((0, import_utils2.getViewBootstrapConfigurationResource)({
       id: view.id,
       url: viewParams?.page?.url,

package/build/cjs/linkers/view_bootstrap.cjs

@@ -83,8 +83,8 @@ async function getHtmlResources(view, viewParams, resourceContext) {
   let importMetadata = {imports: {}};
   const customElementsRecords = [];
   const flattenedElements = (0, import_utils2.flattenCustomElements)(customElements, isSSR);
-  const viewContainsHydratedElements = !isSSR || flattenedElements.some(({props}) => (0, import_shared_utils.hasHydrateDirective)(props));
-  if (viewContainsHydratedElements) {
+  const viewContainsLiveElements = !isSSR || flattenedElements.some(({props}) => (0, import_shared_utils.getHydrateDirective)(props));
+  if (viewContainsLiveElements) {
     if (isAMD) {
       const shimBundle = debug || minify === false ? "lwr-loader-shim.bundle.js" : "lwr-loader-shim.bundle.min.js";
       const def = await resourceRegistry.getResource({specifier: shimBundle, version}, runtimeEnvironment, runtimeParams);
@@ -142,7 +142,7 @@ async function getHtmlResources(view, viewParams, resourceContext) {
   for (const {tagName: element, props} of flattenedElements) {
     const graph = await (0, import_shared_utils.getModuleGraphs)((0, import_shared_utils.kebabCaseToModuleSpecifier)(element), {includeUris: true, includeLinkedDefinitions: true, depth}, moduleRegistry, defRegistry, runtimeEnvironment, runtimeParams ? runtimeParams : {}, visitedCache);
     customElementsRecords.push({elementName: element, flatGraph: graph});
-    if (!isSSR || (0, import_shared_utils.hasHydrateDirective)(props)) {
+    if (!isSSR || (0, import_shared_utils.getHydrateDirective)(props)) {
       const specifier = graph.graphs[0].specifier;
       const uri = graph.uriMap[specifier];
       (0, import_preload_utils.setPreloadModulesMeta)(specifier, uri, groups, viewPreloads);
@@ -169,7 +169,7 @@ async function getHtmlResources(view, viewParams, resourceContext) {
       importMetadata = await (0, import_shared_utils.toImportMetadata)(graph, importMetadata, moduleRegistry, runtimeEnvironment, runtimeParams);
     }
   }
-  if (viewContainsHydratedElements) {
+  if (viewContainsLiveElements) {
     configResources.unshift((0, import_utils2.getViewBootstrapConfigurationResource)({
       id: view.id,
       url: viewParams?.page?.url,

package/build/cjs/view-handler.cjs

@@ -127,20 +127,20 @@ var LwrViewHandler = class {
     if (!route.routeHandler) {
       throw new Error("Route handler is required for a CustomView");
     }
-    const routeHandler = this.routeHandlers[route.routeHandler];
-    if (!routeHandler) {
+    const [routeHandlerFn, routeHandlerOptions] = this.routeHandlers[route.routeHandler[0]];
+    if (!routeHandlerFn) {
       throw new Error(`Route handler does not exist for id: ${route.routeHandler}`);
     }
     const {rootDir, assets, contentDir, layoutsDir} = this.globalConfig;
     const paths = {rootDir, assets, contentDir, layoutsDir};
     const locale = runtimeParams.locale;
-    const viewApi = this.getBoundApi(route, runtimeEnvironment, runtimeParams);
-    const response = await routeHandler({...viewRequest, locale}, {route, viewApi, ...paths});
+    const viewApi = this.getBoundApi(viewRequest, route, runtimeEnvironment, runtimeParams);
+    const response = await routeHandlerFn({...viewRequest, locale}, {route, viewApi, ...paths}, routeHandlerOptions);
     return response;
   }
-  getBoundApi(route, runtimeEnvironment, runtimeParams) {
+  getBoundApi(viewRequest, route, runtimeEnvironment, runtimeParams) {
     return {
-      getViewResponse: this.getViewResponse.bind(this, route, runtimeEnvironment, runtimeParams),
+      getViewResponse: this.getViewResponse.bind(this, viewRequest, route, runtimeEnvironment, runtimeParams),
       hasViewResponse: this.hasViewResponse.bind(this, route, runtimeEnvironment, runtimeParams)
     };
   }
@@ -149,10 +149,20 @@ var LwrViewHandler = class {
     const managedView = {...view, id, bootstrap};
     return this.viewRegistry.hasViewDefinition(managedView, viewParams, runtimeEnvironment, runtimeParams, renderOptions);
   }
-  async getViewResponse(route, runtimeEnvironment, runtimeParams = {}, view, viewParams, renderOptions) {
+  async getViewResponse(viewRequest, route, runtimeEnvironment, runtimeParams = {}, view, viewParams, renderOptions) {
     const {id, bootstrap} = route;
     const managedView = {...view, id, bootstrap};
-    const viewDefinition = await this.viewRegistry.getViewDefinition(managedView, viewParams, runtimeEnvironment, runtimeParams, renderOptions);
+    const viewResponse = {
+      view: managedView,
+      viewParams,
+      renderOptions
+    };
+    const {
+      view: normalizedView,
+      viewParams: normalizedViewParams,
+      renderOptions: normalizedRenderOptions
+    } = normalizeViewProperties(viewRequest, viewResponse, route, this.globalConfig);
+    const viewDefinition = await this.viewRegistry.getViewDefinition(normalizedView, normalizedViewParams, runtimeEnvironment, runtimeParams, normalizedRenderOptions);
     return {
       body: viewDefinition.renderedView,
       metadata: {

package/build/es/index.d.ts

@@ -1,5 +1,5 @@
-import { AssetRegistry, CompiledView, Json, LinkedModuleDefinition, LinkedViewDefinition, LwrAppEmitter, LwrAppObserver, ModuleBundler, ModuleRegistry, NormalizedLwrGlobalConfig, PublicViewRegistry, RenderOptions, ResourceRegistry, RuntimeEnvironment, RuntimeParams, View, ViewIdentity, ViewParams, ViewProvider, ViewRegistry, ViewTransformPlugin } from '@lwrjs/types';
-import { AssetSource } from '@lwrjs/types';
+import type { AssetRegistry, AssetSource, CompiledView, Json, LinkedModuleDefinition, LinkedViewDefinition, LwrAppEmitter, LwrAppObserver, ModuleBundler, ModuleRegistry, NormalizedLwrGlobalConfig, PublicViewRegistry, RenderOptions, ResourceRegistry, RuntimeEnvironment, RuntimeParams, View, ViewIdentity, ViewParams, ViewProvider, ViewRegistry, ViewTransformPlugin } from '@lwrjs/types';
+import { LRUCache } from 'lru-cache';
 export { LwrViewHandler } from './view-handler.js';
 interface ViewProviderContext {
     viewTransformers?: ViewTransformPlugin[];
@@ -21,7 +21,7 @@ export declare class LwrViewRegistry implements ViewRegistry {
     name: string;
     viewProviders: ViewProvider[];
     compiledViews: Map<string, CompiledView>;
-    viewDefinitions: Map<string, ViewDefinitionCacheEntry>;
+    viewDefinitions: LRUCache<string, ViewDefinitionCacheEntry>;
     resourceRegistry: ResourceRegistry;
     moduleRegistry: ModuleRegistry;
     moduleBundler: ModuleBundler;

package/build/es/index.js

@@ -1,6 +1,7 @@
-import { extractMetadataFromHtml, getCacheKeyFromJson, getSpecifier, normalizeResourcePath, createStringBuilder, shortestTtl, InflightTasks, } from '@lwrjs/shared-utils';
+import { InflightTasks, createStringBuilder, extractMetadataFromHtml, getCacheKeyFromJson, getSpecifier, normalizeResourcePath, shortestTtl, } from '@lwrjs/shared-utils';
 import { normalizeRenderOptions, normalizeRenderedResult, reduceSourceAssetReferences } from './utils.js';
 import { linkLwrResources } from './linkers/link-lwr-resources.js';
+import { LRUCache } from 'lru-cache';
 export { LwrViewHandler } from './view-handler.js';
 export class LwrViewRegistry {
     constructor(context, globalConfig) {
@@ -8,9 +9,6 @@ export class LwrViewRegistry {
         // Cache of compiled views retrieved from the viewProviders
         //  Cache key: ViewIdentity
         this.compiledViews = new Map();
-        // Cache of linked view definitions, keyed by the View
-        //  Cache key: View
-        this.viewDefinitions = new Map();
         this.immutableAssets = new Map();
         // Cache of unresolved view definitions
         //  Cache key: View + View Params
@@ -29,6 +27,7 @@ export class LwrViewRegistry {
         this.globalData = context.globalData;
         this.appEmitter = context.appEmitter;
         const observer = context.appObserver;
+        this.viewDefinitions = new LRUCache({ max: parseInt(process.env.VIEW_CACHE_SIZE || '500', 10) });
         // Observers for cached entries external dependencies -- view templates, modules, and assets
         observer.onViewSourceChange(({ payload }) => this.onViewSourceChange(payload));
         observer.onModuleDefinitionChange(({ payload }) => this.onModuleDefinitionChange(payload));
@@ -37,8 +36,8 @@ export class LwrViewRegistry {
     async onModuleDefinitionChange(moduleDefinition) {
         const versionedSpecifier = getSpecifier(moduleDefinition);
         // invalidate viewDefinition cache entries with references to the LinkedModuleDefinition
-        for (const [id, { viewDefinition }] of this.viewDefinitions.entries()) {
-            const { viewRecord } = viewDefinition;
+        for (const [id, viewDefEntry] of this.viewDefinitions.entries()) {
+            const { viewDefinition: { viewRecord }, } = viewDefEntry;
             const uriMap = viewRecord.bootstrapModule?.flatGraph.uriMap;
             if (uriMap) {
                 Object.keys(uriMap);
@@ -61,8 +60,8 @@ export class LwrViewRegistry {
         const compiledViewCacheKey = getCacheKeyFromJson({ contentTemplate, rootComponent });
         this.compiledViews.set(compiledViewCacheKey, compiledView);
         // invalidate viewDefinitions cache
-        for (const [id, { view }] of this.viewDefinitions.entries()) {
-            const { contentTemplate: eContentTempl, layoutTemplate: eLayoutTemplate, rootComponent: eRootComponent, } = view;
+        for (const [id, viewDefEntry] of this.viewDefinitions.entries()) {
+            const { contentTemplate: eContentTempl, layoutTemplate: eLayoutTemplate, rootComponent: eRootComponent, } = viewDefEntry.view;
             if (eContentTempl === contentTemplate ||
                 eLayoutTemplate === contentTemplate ||
                 eRootComponent === rootComponent) {
@@ -74,8 +73,8 @@ export class LwrViewRegistry {
     onAssetSourceChange(asset) {
         // invalidate viewDefinition cache entries with references to the AssetSource entry.
         const assetId = asset.entry;
-        for (const [id, { viewDefinition }] of this.viewDefinitions.entries()) {
-            const { viewRecord } = viewDefinition;
+        for (const [id, viewDefEntry] of this.viewDefinitions.entries()) {
+            const { viewDefinition: { viewRecord }, } = viewDefEntry;
             const someAssets = viewRecord.assetReferences?.some((ref) => {
                 return ref.override?.entry === assetId;
             });
@@ -180,11 +179,15 @@ export class LwrViewRegistry {
         const pendingViewDefCacheKey = viewDefCacheKey + viewParamKey;
         const viewDefinition = await this.pendingViewDefinitions.execute(pendingViewDefCacheKey, () => 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);
             this.viewDefinitions.set(viewDefCacheKey, {
                 view,
                 viewDefinition,
                 paramKey: viewParamKey,
-            });
+            }, 
+            // s -> ms
+            { ttl: ttl ? ttl * 1000 : undefined });
         }
         return viewDefinition;
     }

package/build/es/linkers/legacy_view_bootstrap.js

@@ -1,4 +1,4 @@
-import { kebabCaseToModuleSpecifier, getModuleGraphs, GraphDepth, getModuleUriPrefix, logger, explodeSpecifier, isBundler, hasHydrateDirective, } from '@lwrjs/shared-utils';
+import { kebabCaseToModuleSpecifier, getModuleGraphs, GraphDepth, getModuleUriPrefix, logger, explodeSpecifier, isBundler, getHydrateDirective, } 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';
@@ -67,8 +67,8 @@ export async function getHtmlResources(view, viewParams, resourceContext) {
     let bootstrapModuleRef, versionedSpecifier = bootstrapSpecifier;
     const customElementsRecords = [];
     const flattenedElements = flattenCustomElements(customElements, isSSR);
-    const viewContainsHydratedElements = !isSSR || flattenedElements.some(({ props }) => hasHydrateDirective(props));
-    if (viewContainsHydratedElements) {
+    const viewContainsLiveElements = !isSSR || flattenedElements.some(({ props }) => getHydrateDirective(props));
+    if (viewContainsLiveElements) {
         // ------ AMD Required module resources
         if (isAMD) {
             // Keep shim format in sync with view_bootstrap.ts
@@ -161,8 +161,8 @@ export async function getHtmlResources(view, viewParams, resourceContext) {
         const graph = await getModuleGraphs(kebabCaseToModuleSpecifier(element), { includeUris: true, includeLinkedDefinitions: true, depth }, moduleRegistry, defRegistry, runtimeEnvironment, runtimeParams ? runtimeParams : {}, visitedCache);
         // add to the viewRecord
         customElementsRecords.push({ elementName: element, flatGraph: graph });
-        // Only process custom elements that are to be hydrated
-        if (!isSSR || hasHydrateDirective(props)) {
+        // Only process custom elements that are to be hydrated or are CSR-only islands
+        if (!isSSR || getHydrateDirective(props)) {
             // PRELOAD the custom element module as a link resource
             const specifier = graph.graphs[0].specifier;
             const uri = graph.uriMap[specifier];
@@ -193,7 +193,7 @@ export async function getHtmlResources(view, viewParams, resourceContext) {
             }
         }
     }));
-    if (viewContainsHydratedElements) {
+    if (viewContainsLiveElements) {
         // ADD configuration of the bootstrapModule
         configResources.unshift(getViewBootstrapConfigurationResource({
             id: view.id,

package/build/es/linkers/view_bootstrap.js

@@ -1,4 +1,4 @@
-import { kebabCaseToModuleSpecifier, toImportMetadata, getModuleGraphs, getMappingUriPrefix, GraphDepth, logger, explodeSpecifier, isBundler, hasHydrateDirective, } from '@lwrjs/shared-utils';
+import { kebabCaseToModuleSpecifier, toImportMetadata, getModuleGraphs, getMappingUriPrefix, GraphDepth, logger, explodeSpecifier, isBundler, getHydrateDirective, } 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';
@@ -68,8 +68,8 @@ export async function getHtmlResources(view, viewParams, resourceContext) {
     let importMetadata = { imports: {} };
     const customElementsRecords = [];
     const flattenedElements = flattenCustomElements(customElements, isSSR);
-    const viewContainsHydratedElements = !isSSR || flattenedElements.some(({ props }) => hasHydrateDirective(props));
-    if (viewContainsHydratedElements) {
+    const viewContainsLiveElements = !isSSR || flattenedElements.some(({ props }) => getHydrateDirective(props));
+    if (viewContainsLiveElements) {
         // ------ AMD Required module resources
         if (isAMD) {
             // Keep shim format in sync with legacy_view_bootstrap.ts
@@ -147,8 +147,8 @@ export async function getHtmlResources(view, viewParams, resourceContext) {
         const graph = await getModuleGraphs(kebabCaseToModuleSpecifier(element), { includeUris: true, includeLinkedDefinitions: true, depth }, moduleRegistry, defRegistry, runtimeEnvironment, runtimeParams ? runtimeParams : {}, visitedCache);
         // add to the viewRecord
         customElementsRecords.push({ elementName: element, flatGraph: graph });
-        // Only process custom elements that are to be hydrated
-        if (!isSSR || hasHydrateDirective(props)) {
+        // Only process custom elements that are to be hydrated or are CSR-only islands
+        if (!isSSR || getHydrateDirective(props)) {
             // PRELOAD the custom element module as a link resource
             const specifier = graph.graphs[0].specifier;
             const uri = graph.uriMap[specifier];
@@ -181,7 +181,7 @@ export async function getHtmlResources(view, viewParams, resourceContext) {
             importMetadata = await toImportMetadata(graph, importMetadata, moduleRegistry, runtimeEnvironment, runtimeParams);
         }
     }
-    if (viewContainsHydratedElements) {
+    if (viewContainsLiveElements) {
         // ADD configuration of the bootstrapModule
         configResources.unshift(getViewBootstrapConfigurationResource({
             id: view.id,

package/build/es/view-handler.js

@@ -143,26 +143,26 @@ export class LwrViewHandler {
         if (!route.routeHandler) {
             throw new Error('Route handler is required for a CustomView');
         }
-        const routeHandler = this.routeHandlers[route.routeHandler];
-        if (!routeHandler) {
+        const [routeHandlerFn, routeHandlerOptions] = this.routeHandlers[route.routeHandler[0]];
+        if (!routeHandlerFn) {
             throw new Error(`Route handler does not exist for id: ${route.routeHandler}`);
         }
         const { rootDir, assets, contentDir, layoutsDir } = this.globalConfig;
         const paths = { rootDir, assets, contentDir, layoutsDir };
         const locale = runtimeParams.locale;
-        const viewApi = this.getBoundApi(route, runtimeEnvironment, runtimeParams);
-        const response = await routeHandler({ ...viewRequest, locale }, { route: route, viewApi, ...paths });
+        const viewApi = this.getBoundApi(viewRequest, route, runtimeEnvironment, runtimeParams);
+        const response = await routeHandlerFn({ ...viewRequest, locale }, { route: route, viewApi, ...paths }, routeHandlerOptions);
         return response;
     }
     /*
         The Custom Route Handler accessible APIS are bound to runtime request when provided to a
         Route Handler.
     */
-    getBoundApi(route, runtimeEnvironment, runtimeParams) {
+    getBoundApi(viewRequest, route, runtimeEnvironment, runtimeParams) {
         return {
             // Create a version of renderView() to pass to the route handler, it will:
             //  - handle and protect the runtime environment
-            getViewResponse: this.getViewResponse.bind(this, route, runtimeEnvironment, runtimeParams),
+            getViewResponse: this.getViewResponse.bind(this, viewRequest, route, runtimeEnvironment, runtimeParams),
             hasViewResponse: this.hasViewResponse.bind(this, route, runtimeEnvironment, runtimeParams),
         };
     }
@@ -173,12 +173,18 @@ export class LwrViewHandler {
         const managedView = { ...view, id, bootstrap };
         return this.viewRegistry.hasViewDefinition(managedView, viewParams, runtimeEnvironment, runtimeParams, renderOptions);
     }
-    async getViewResponse(route, runtimeEnvironment, runtimeParams = {}, 
+    async getViewResponse(viewRequest, route, runtimeEnvironment, runtimeParams = {}, 
     // custom route handler managed properties
     view, viewParams, renderOptions) {
         const { id, bootstrap } = route;
         const managedView = { ...view, id, bootstrap };
-        const viewDefinition = await this.viewRegistry.getViewDefinition(managedView, viewParams, runtimeEnvironment, runtimeParams, renderOptions);
+        const viewResponse = {
+            view: managedView,
+            viewParams,
+            renderOptions,
+        };
+        const { view: normalizedView, viewParams: normalizedViewParams, renderOptions: normalizedRenderOptions, } = normalizeViewProperties(viewRequest, viewResponse, route, this.globalConfig);
+        const viewDefinition = await this.viewRegistry.getViewDefinition(normalizedView, normalizedViewParams, runtimeEnvironment, runtimeParams, normalizedRenderOptions);
         return {
             body: viewDefinition.renderedView,
             metadata: {

package/package.json

@@ -4,7 +4,7 @@
     "publishConfig": {
         "access": "public"
     },
-    "version": "0.10.0-alpha.14",
+    "version": "0.10.0-alpha.16",
     "homepage": "https://developer.salesforce.com/docs/platform/lwr/overview",
     "repository": {
         "type": "git",
@@ -30,15 +30,16 @@
         "build/**/*.d.ts"
     ],
     "dependencies": {
-        "@lwrjs/app-service": "0.10.0-alpha.14",
-        "@lwrjs/diagnostics": "0.10.0-alpha.14",
-        "@lwrjs/shared-utils": "0.10.0-alpha.14"
+        "@lwrjs/app-service": "0.10.0-alpha.16",
+        "@lwrjs/diagnostics": "0.10.0-alpha.16",
+        "@lwrjs/shared-utils": "0.10.0-alpha.16",
+        "lru-cache": "9.1.2"
     },
     "devDependencies": {
-        "@lwrjs/types": "0.10.0-alpha.14"
+        "@lwrjs/types": "0.10.0-alpha.16"
     },
     "engines": {
         "node": ">=16.0.0 <20"
     },
-    "gitHead": "f80dc1c18719b77c183f339027313be11d69f9dc"
+    "gitHead": "c5a13d471330c0f738d0c783fd1b69f456c544bd"
 }