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

package/build/cjs/index.cjs

@@ -51,7 +51,12 @@ 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)});
+    this.viewDefinitions = new import_lru_cache.LRUCache({
+      max: parseInt(process.env.VIEW_CACHE_SIZE ?? "500", 10),
+      dispose: (_value, key) => {
+        import_diagnostics.logger.verbose(`View evicted from cache ${key}`);
+      }
+    });
     observer.onViewSourceChange(({payload}) => this.onViewSourceChange(payload));
     observer.onModuleDefinitionChange(({payload}) => this.onModuleDefinitionChange(payload));
     observer.onAssetSourceChange(({payload}) => this.onAssetSourceChange(payload));
@@ -173,7 +178,8 @@ var LwrViewRegistry = class {
     }
     return false;
   }
-  async getViewDefinition(view, viewParams, runtimeEnvironment, runtimeParams, renderOptions) {
+  async getViewDefinition(view, viewParams, runtimeEnvironment, runtimeParams = {requestCache: {}}, renderOptions) {
+    runtimeParams.requestCache = runtimeParams.requestCache ?? {};
     try {
       const {freezeAssets, viewParamCacheKey} = (0, import_utils.normalizeRenderOptions)(this.runtimeEnvironment, renderOptions);
       const viewDefCacheKey = (0, import_shared_utils.getCacheKeyFromJson)({
@@ -187,8 +193,8 @@ var LwrViewRegistry = class {
       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}`);
-      if (this.viewDefinitions.has(viewDefCacheKey)) {
-        const viewDefinition2 = this.viewDefinitions.get(viewDefCacheKey);
+      if (this.viewDefinitions.has(viewDefCacheKey) || runtimeParams.requestCache[viewDefCacheKey]) {
+        const viewDefinition2 = this.viewDefinitions.get(viewDefCacheKey) || runtimeParams.requestCache[viewDefCacheKey];
         if (viewDefinition2 && viewDefinition2.paramKey === viewParamKey && viewDefinition2.viewDefinition.immutable) {
           return viewDefinition2.viewDefinition;
         }
@@ -209,11 +215,12 @@ var LwrViewRegistry = class {
       const maxTtl = maxViewCacheTtl && parseInt(maxViewCacheTtl, 10);
       const leastTtl = (0, import_shared_utils.shortestTtl)(viewDefinition.cache?.ttl, route?.cache?.ttl, maxTtl);
       const ttl = leastTtl !== void 0 ? leastTtl === 0 ? 10 : leastTtl * 1e3 : void 0;
-      this.viewDefinitions.set(viewDefCacheKey, {
-        view,
-        viewDefinition,
-        paramKey: viewParamKey
-      }, {ttl});
+      const viewDefCacheEntry = {view, viewDefinition, paramKey: viewParamKey};
+      if (view.bootstrap?.includeCookiesForSSR) {
+        runtimeParams.requestCache[viewDefCacheKey] = viewDefCacheEntry;
+      } else {
+        this.viewDefinitions.set(viewDefCacheKey, viewDefCacheEntry, {ttl});
+      }
       return viewDefinition;
     } catch (err) {
       if (err instanceof import_diagnostics.DiagnosticsError) {
@@ -225,10 +232,10 @@ var LwrViewRegistry = class {
       throw (0, import_diagnostics.createSingleDiagnosticError)({description: import_diagnostics.descriptions.SERVER.UNEXPECTED_ERROR(message)}, import_diagnostics.LwrServerError);
     }
   }
-  async renderView(view, viewParams, runtimeEnvironment, runtimeParams = {}, renderOptions) {
+  async renderView(view, viewParams, runtimeEnvironment, runtimeParams, renderOptions) {
     const {id, contentTemplate, rootComponent, layoutTemplate} = view;
     const lwrResourcesId = `__LWR_RESOURCES__${Date.now()}`;
-    const renderedContent = await this.render({id, contentTemplate, rootComponent}, {...viewParams, lwr_resources: lwrResourcesId}, runtimeParams, runtimeEnvironment, renderOptions);
+    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;
     if (!layout) {
@@ -274,7 +281,8 @@ var LwrViewRegistry = class {
           ...renderedLayout.metadata.serverDebug
         }
       },
-      cache: renderedContent.cache
+      cache: renderedContent.cache,
+      redirect: renderedContent.redirect
     }, {
       view: {...view, layoutTemplate: layoutTemplatePath},
       viewParams,
@@ -286,7 +294,7 @@ var LwrViewRegistry = class {
     });
     return renderedViewDef;
   }
-  async render(viewId, viewParams, runtimeParams, runtimeEnvironment, renderOptions) {
+  async render(viewId, viewParams, runtimeParams, runtimeEnvironment) {
     const globalContext = this.globalData;
     const {id, rootComponent, contentTemplate} = viewId;
     const compiledView = await this.getView({id, contentTemplate, rootComponent});
@@ -354,7 +362,8 @@ var LwrViewRegistry = class {
           assetReferences: (0, import_utils.reduceSourceAssetReferences)(linkedMetadata.assetReferences),
           ...viewRecord
         },
-        cache: {ttl: pageTtl}
+        cache: {ttl: pageTtl},
+        redirect: renderedView.redirect
       };
     }
     return {
@@ -364,7 +373,8 @@ var LwrViewRegistry = class {
         assetReferences: (0, import_utils.reduceSourceAssetReferences)(linkedMetadata.assetReferences),
         moduleResources: []
       },
-      cache: {ttl: pageTtl}
+      cache: {ttl: pageTtl},
+      redirect: renderedView.redirect
     };
   }
 };

package/build/cjs/linkers/legacy_view_bootstrap.cjs

@@ -231,7 +231,8 @@ async function getHtmlResources(view, viewParams, resourceContext) {
       url: viewParams?.page?.url,
       configAsSrc: view.bootstrap?.configAsSrc || false,
       mixedMode: view.bootstrap?.mixedMode || false,
-      nonce: viewParams?.page?.nonce
+      nonce: viewParams?.page?.nonce,
+      ssr: view.bootstrap?.ssr || false
     }, {
       appId: appIdentity.appName,
       bootstrapModule: versionedSpecifier,

package/build/cjs/linkers/link-lwr-resources.cjs

@@ -41,7 +41,7 @@ async function linkLwrResources(source, view, viewParams, cxt) {
     return LEGACY_LOADER ? (0, import_legacy_view_bootstrap.getHtmlResources)(view, viewParams, resourceContext) : (0, import_view_bootstrap.getHtmlResources)(view, viewParams, resourceContext);
   });
   return {
-    renderedView: source.replace(lwrResourcesId, partial),
+    renderedView: source.replace(lwrResourcesId, () => partial),
     viewRecord
   };
 }

package/build/cjs/linkers/utils.cjs

@@ -63,7 +63,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} };`,
+    `globalThis.lwcRuntimeFlags = { ENABLE_MIXED_SHADOW_MODE: ${viewInfo.mixedMode}, ENABLE_WIRE_SYNC_EMIT: ${viewInfo.ssr} };`,
     debug && debugMessage && `console.error(${JSON.stringify(debugMessage)});`
   ].filter(Boolean).join("\n");
   if (viewInfo.configAsSrc) {

package/build/cjs/linkers/view_bootstrap.cjs

@@ -206,7 +206,8 @@ async function getHtmlResources(view, viewParams, resourceContext) {
       url: viewParams?.page?.url,
       configAsSrc: view.bootstrap?.configAsSrc || false,
       mixedMode: view.bootstrap?.mixedMode || false,
-      nonce: viewParams?.page?.nonce
+      nonce: viewParams?.page?.nonce,
+      ssr: view.bootstrap?.ssr || false
     }, {
       appId: appIdentity.appName,
       bootstrapModule: versionedSpecifier,

package/build/cjs/utils.cjs

@@ -27,11 +27,13 @@ __export(exports, {
   addExternalScriptNonce: () => addExternalScriptNonce,
   createJsonModule: () => createJsonModule,
   generateHtmlTag: () => generateHtmlTag,
+  generateLinkHeaders: () => generateLinkHeaders,
   generatePageContext: () => generatePageContext,
   generateViewNonce: () => generateViewNonce,
   getModuleResource: () => getModuleResource,
   getModuleResourceByUri: () => getModuleResourceByUri,
   getViewNonce: () => getViewNonce,
+  isViewDefinitionResponse: () => isViewDefinitionResponse,
   isViewResponse: () => isViewResponse,
   normalizeRenderOptions: () => normalizeRenderOptions,
   normalizeRenderedResult: () => normalizeRenderedResult,
@@ -108,7 +110,8 @@ function normalizeRenderedResult({
   renderedView,
   metadata,
   options,
-  cache
+  cache,
+  redirect
 }) {
   return {
     renderedView,
@@ -121,7 +124,8 @@ function normalizeRenderedResult({
     options: {
       skipMetadataCollection: options ? options.skipMetadataCollection : false
     },
-    cache: cache || {}
+    cache: cache || {},
+    redirect
   };
 }
 function reduceSourceAssetReferences(assets) {
@@ -154,6 +158,9 @@ function generatePageContext({requestPath: url}, {id, contentTemplate, propertie
 function isViewResponse(response) {
   return response.body !== void 0;
 }
+function isViewDefinitionResponse(response) {
+  return response.view !== void 0;
+}
 async function toJsonFormat(viewRequest, viewDefinition, route, runtimeEnvironment, runtimeParams, moduleRegistry) {
   const {viewRecord} = viewDefinition;
   const {bootstrap, id: appName} = route;
@@ -291,3 +298,23 @@ function addExternalScriptNonce(def, nonce) {
     def.nonce = nonce;
   }
 }
+function generateLinkHeaders(assets, patterns) {
+  const assetConfig = {};
+  for (let i = 0; i < patterns.length; i++) {
+    const pattern = patterns[i].match;
+    assets.forEach((asset) => {
+      const path = (asset.override?.uri || asset.url).split("?")[0];
+      if (path.endsWith(pattern)) {
+        assetConfig[path] = patterns[i].attributes;
+      }
+    });
+  }
+  return Object.keys(assetConfig).reduce((linkHeader, path) => {
+    linkHeader = `${linkHeader ? linkHeader + ", " : ""}<${path}>`;
+    const properties = assetConfig[path];
+    for (const prop in properties) {
+      linkHeader += properties[prop] !== "" ? `; ${prop}=${properties[prop]}` : `; ${prop}`;
+    }
+    return linkHeader;
+  }, "");
+}

package/build/cjs/view-handler.cjs

@@ -46,9 +46,11 @@ var LwrViewHandler = class {
       }
       const {view, viewParams, renderOptions} = normalizeViewProperties(viewRequest, response, route, this.globalConfig, runtimeParams);
       const viewDefinition2 = await this.viewRegistry.getViewDefinition(view, viewParams, runtimeEnvironment, runtimeParams, renderOptions);
+      const link2 = !!route?.bootstrap?.preloadResources?.patterns?.length && (0, import_utils.generateLinkHeaders)(viewDefinition2.viewRecord.assetReferences || [], route?.bootstrap?.preloadResources?.patterns || []);
       return {
         ...response,
         body: viewDefinition2.renderedView,
+        ...!!link2 && {headers: {link: link2}},
         metadata: {
           viewDefinition: viewDefinition2
         },
@@ -56,12 +58,14 @@ var LwrViewHandler = class {
       };
     }
     const viewDefinition = await this.getDefaultRouteViewDefinition(viewRequest, route, runtimeEnvironment, runtimeParams);
+    const link = !!route?.bootstrap?.preloadResources?.patterns?.length && (0, import_utils.generateLinkHeaders)(viewDefinition.viewRecord.assetReferences || [], route.bootstrap?.preloadResources?.patterns || []);
     return {
       body: viewDefinition.renderedView,
       metadata: {
         viewDefinition
       },
-      cache: viewDefinition.cache
+      cache: viewDefinition.cache,
+      ...!!link && {headers: {link}}
     };
   }
   async getViewJson(viewRequest, route, runtimeEnvironment, runtimeParams = {}) {
@@ -153,6 +157,19 @@ var LwrViewHandler = class {
     if (response?.locale) {
       runtimeParams.locale = response.locale;
     }
+    if ((0, import_utils.isViewDefinitionResponse)(response)) {
+      let viewDefintionMeta = response.metadata?.viewDefinition;
+      if (!viewDefintionMeta) {
+        viewDefintionMeta = (await viewApi.getViewResponse(response.view, response.viewParams, response.renderOptions)).metadata?.viewDefinition;
+      }
+      const link = !!route?.bootstrap?.preloadResources?.patterns?.length && (0, import_utils.generateLinkHeaders)(viewDefintionMeta?.viewRecord.assetReferences || [], route?.bootstrap?.preloadResources?.patterns || []);
+      if (link) {
+        response.headers = {
+          ...response.headers,
+          link
+        };
+      }
+    }
     return response;
   }
   getBoundApi(viewRequest, route, runtimeEnvironment, runtimeParams) {

package/build/es/index.js

@@ -30,7 +30,12 @@ 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) });
+        this.viewDefinitions = new LRUCache({
+            max: parseInt(process.env.VIEW_CACHE_SIZE ?? '500', 10),
+            dispose: (_value, key) => {
+                logger.verbose(`View 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));
@@ -168,7 +173,8 @@ export class LwrViewRegistry {
         }
         return false;
     }
-    async getViewDefinition(view, viewParams, runtimeEnvironment, runtimeParams, renderOptions) {
+    async getViewDefinition(view, viewParams, runtimeEnvironment, runtimeParams = { requestCache: {} }, renderOptions) {
+        runtimeParams.requestCache = runtimeParams.requestCache ?? {};
         try {
             const { freezeAssets, viewParamCacheKey } = normalizeRenderOptions(this.runtimeEnvironment, renderOptions);
             const viewDefCacheKey = getCacheKeyFromJson({
@@ -189,8 +195,9 @@ export class LwrViewRegistry {
                 : getCacheKeyFromJson(viewParams);
             logger.debug(`[view-registry][getViewDefinition] viewParamKey=${viewParamKey}`);
             // important: cache key does not include the unbounded viewParams
-            if (this.viewDefinitions.has(viewDefCacheKey)) {
-                const viewDefinition = this.viewDefinitions.get(viewDefCacheKey);
+            // check the cross-request cache, then the request cache (which is cleaned up after each base doc request)
+            if (this.viewDefinitions.has(viewDefCacheKey) || runtimeParams.requestCache[viewDefCacheKey]) {
+                const viewDefinition = this.viewDefinitions.get(viewDefCacheKey) || runtimeParams.requestCache[viewDefCacheKey];
                 if (viewDefinition &&
                     viewDefinition.paramKey === viewParamKey &&
                     viewDefinition.viewDefinition.immutable) {
@@ -218,11 +225,17 @@ export class LwrViewRegistry {
             const leastTtl = shortestTtl(viewDefinition.cache?.ttl, route?.cache?.ttl, maxTtl);
             const ttl = leastTtl !== undefined ? (leastTtl === 0 ? 10 : leastTtl * 1000) : undefined;
             // 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,
-            }, { ttl });
+            const viewDefCacheEntry = { view, viewDefinition, paramKey: viewParamKey };
+            if (view.bootstrap?.includeCookiesForSSR) {
+                // important: DO NOT cache authenticated view definitions beyond a single request.
+                // Keep the cache entry only during the request in case viewRegistry.getViewDefinition is called > once.
+                // This can happen when a route handler calls viewApi.getViewResponse then returns a ViewDefinitionResponse.
+                runtimeParams.requestCache[viewDefCacheKey] = viewDefCacheEntry;
+            }
+            else {
+                // Standard cross-request caching
+                this.viewDefinitions.set(viewDefCacheKey, viewDefCacheEntry, { ttl });
+            }
             return viewDefinition;
         }
         catch (err) {
@@ -235,10 +248,10 @@ export class LwrViewRegistry {
             throw createSingleDiagnosticError({ description: descriptions.SERVER.UNEXPECTED_ERROR(message) }, LwrServerError);
         }
     }
-    async renderView(view, viewParams, runtimeEnvironment, runtimeParams = {}, renderOptions) {
+    async renderView(view, viewParams, runtimeEnvironment, runtimeParams, renderOptions) {
         const { id, contentTemplate, rootComponent, layoutTemplate } = view;
         const lwrResourcesId = `__LWR_RESOURCES__${Date.now()}`;
-        const renderedContent = await this.render({ id, contentTemplate, rootComponent }, { ...viewParams, lwr_resources: lwrResourcesId }, runtimeParams, runtimeEnvironment, renderOptions);
+        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);
         const layout = layoutTemplate || renderedContent.compiledView.layoutTemplate;
@@ -291,6 +304,7 @@ export class LwrViewRegistry {
                 },
             },
             cache: renderedContent.cache,
+            redirect: renderedContent.redirect,
         }, 
         // Render Content now contains a layout
         {
@@ -306,7 +320,7 @@ export class LwrViewRegistry {
         });
         return renderedViewDef;
     }
-    async render(viewId, viewParams, runtimeParams, runtimeEnvironment, renderOptions) {
+    async render(viewId, viewParams, runtimeParams, runtimeEnvironment) {
         const globalContext = this.globalData;
         const { id, rootComponent, contentTemplate } = viewId;
         const compiledView = await this.getView({ id, contentTemplate, rootComponent });
@@ -383,6 +397,7 @@ export class LwrViewRegistry {
                     ...viewRecord,
                 },
                 cache: { ttl: pageTtl },
+                redirect: renderedView.redirect,
             };
         }
         return {
@@ -393,6 +408,7 @@ export class LwrViewRegistry {
                 moduleResources: [],
             },
             cache: { ttl: pageTtl },
+            redirect: renderedView.redirect,
         };
     }
 }

package/build/es/linkers/legacy_view_bootstrap.js

@@ -266,6 +266,7 @@ export async function getHtmlResources(view, viewParams, resourceContext) {
             configAsSrc: view.bootstrap?.configAsSrc || false,
             mixedMode: view.bootstrap?.mixedMode || false,
             nonce: viewParams?.page?.nonce,
+            ssr: view.bootstrap?.ssr || false,
         }, {
             appId: appIdentity.appName,
             bootstrapModule: versionedSpecifier,

package/build/es/linkers/link-lwr-resources.js

@@ -16,7 +16,9 @@ export async function linkLwrResources(source, view, viewParams, cxt) {
     });
     // Finally replace the token with the real resources
     return {
-        renderedView: source.replace(lwrResourcesId, partial),
+        // partial may contain regex-token-like characters such as $$,
+        // so we want to bypass regex replacement
+        renderedView: source.replace(lwrResourcesId, () => partial),
         viewRecord,
     };
 }

package/build/es/linkers/utils.js

@@ -37,7 +37,8 @@ export function getViewBootstrapConfigurationResource(viewInfo, config, runtimeE
         })});`,
         `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} };`,
+        // 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)});`,
     ]
         .filter(Boolean)

package/build/es/linkers/view_bootstrap.js

@@ -229,6 +229,7 @@ export async function getHtmlResources(view, viewParams, resourceContext) {
             configAsSrc: view.bootstrap?.configAsSrc || false,
             mixedMode: view.bootstrap?.mixedMode || false,
             nonce: viewParams?.page?.nonce,
+            ssr: view.bootstrap?.ssr || false,
         }, {
             appId: appIdentity.appName,
             bootstrapModule: versionedSpecifier,

package/build/es/utils.d.ts

@@ -1,11 +1,12 @@
-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 } from '@lwrjs/types';
+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 } from '@lwrjs/types';
 export type HTMLResource = Partial<ResourceDefinition>;
 export declare function generateHtmlTag(definition: HTMLResource): Promise<string>;
-export declare function normalizeRenderedResult({ renderedView, metadata, options, cache, }: RenderingResult): NormalizedRenderingResult;
+export declare function normalizeRenderedResult({ renderedView, metadata, options, cache, redirect, }: 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>;
 export declare function isViewResponse(response: RouteHandlerViewResponse): response is ViewResponse;
+export declare function isViewDefinitionResponse(response: RouteHandlerViewResponse): response is ViewDefinitionResponse;
 export declare function toJsonFormat(viewRequest: ViewRequest, viewDefinition: LinkedViewDefinition, route: LwrRoute | LwrErrorRoute, runtimeEnvironment: RuntimeEnvironment, runtimeParams: RuntimeParams, moduleRegistry: ModuleRegistry): Promise<ViewResponse>;
 export declare function getModuleResource(moduleId: Pick<ModuleId, 'specifier' | 'version'>, runtimeEnvironment: RuntimeEnvironment, moduleResourceMeta: ViewModuleResourceContext, defRegistry: ModuleRegistry | ModuleBundler, runtimeParams: RuntimeParams): Promise<ResourceDefinition>;
 export declare function getModuleResourceByUri(uri: string, runtimeEnvironment: RuntimeEnvironment, moduleResourceMeta: ViewModuleResourceContext): ResourceDefinition;
@@ -22,4 +23,5 @@ export declare function generateViewNonce(viewParams: ViewParams): void;
  * Add a nonce to a script definition in view if it is external (not inline)
  */
 export declare function addExternalScriptNonce(def: ResourceDefinition, nonce?: string): void;
+export declare function generateLinkHeaders(assets: RenderedAssetReference[], patterns: Record<string, any>[]): string;
 //# sourceMappingURL=utils.d.ts.map

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, }) {
+export function normalizeRenderedResult({ renderedView, metadata, options, cache, redirect, }) {
     return {
         renderedView,
         metadata: {
@@ -79,6 +79,7 @@ export function normalizeRenderedResult({ renderedView, metadata, options, cache
             skipMetadataCollection: options ? options.skipMetadataCollection : false,
         },
         cache: cache || {},
+        redirect,
     };
 }
 export function reduceSourceAssetReferences(assets) {
@@ -117,6 +118,9 @@ export function generatePageContext({ requestPath: url }, { id, contentTemplate,
 export function isViewResponse(response) {
     return response.body !== undefined;
 }
+export function isViewDefinitionResponse(response) {
+    return response.view !== undefined;
+}
 export async function toJsonFormat(viewRequest, viewDefinition, route, runtimeEnvironment, runtimeParams, moduleRegistry) {
     const { viewRecord } = viewDefinition;
     const { bootstrap, id: appName } = route;
@@ -281,4 +285,30 @@ export function addExternalScriptNonce(def, nonce) {
         def.nonce = nonce;
     }
 }
+export function generateLinkHeaders(assets, patterns) {
+    // store each Path's config in this config
+    const assetConfig = {};
+    // Iterate through the patterns to filter the file paths and populate assetConfig
+    for (let i = 0; i < patterns.length; i++) {
+        const pattern = patterns[i].match;
+        assets.forEach((asset) => {
+            const path = (asset.override?.uri || asset.url).split('?')[0];
+            if (path.endsWith(pattern)) {
+                assetConfig[path] = patterns[i].attributes;
+            }
+        });
+    }
+    // Use the assetConfig to construct the Link Header
+    return Object.keys(assetConfig).reduce((linkHeader, path) => {
+        linkHeader = `${linkHeader ? linkHeader + ', ' : ''}<${path}>`;
+        const properties = assetConfig[path];
+        // Add the properties mentioned on the preloadResource patterns except match prop
+        for (const prop in properties) {
+            // Check if the prop has empty string, if so add the prop name alone
+            // eg: if crossorigin: '' => </global.css>; as=style; crossorigin
+            linkHeader += properties[prop] !== '' ? `; ${prop}=${properties[prop]}` : `; ${prop}`;
+        }
+        return linkHeader;
+    }, '');
+}
 //# sourceMappingURL=utils.js.map

package/build/es/view-handler.js

@@ -1,7 +1,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 { generateHtmlTag, generateLinkHeaders, generatePageContext, isViewResponse, isViewDefinitionResponse, toJsonFormat, } from './utils.js';
 import { DiagnosticsError, LwrApplicationError, createSingleDiagnosticError, descriptions, } from '@lwrjs/diagnostics';
 export class LwrViewHandler {
     constructor(context, globalConfig) {
@@ -27,9 +27,12 @@ export class LwrViewHandler {
             // Process ViewDefinitionResponse
             const { view, viewParams, renderOptions } = normalizeViewProperties(viewRequest, response, route, this.globalConfig, runtimeParams);
             const viewDefinition = await this.viewRegistry.getViewDefinition(view, viewParams, runtimeEnvironment, runtimeParams, renderOptions);
+            const link = !!route?.bootstrap?.preloadResources?.patterns?.length &&
+                generateLinkHeaders(viewDefinition.viewRecord.assetReferences || [], route?.bootstrap?.preloadResources?.patterns || []);
             return {
                 ...response,
                 body: viewDefinition.renderedView,
+                ...(!!link && { headers: { link } }),
                 metadata: {
                     viewDefinition,
                 },
@@ -38,12 +41,15 @@ export class LwrViewHandler {
         }
         // default static view
         const viewDefinition = await this.getDefaultRouteViewDefinition(viewRequest, route, runtimeEnvironment, runtimeParams);
+        const link = !!route?.bootstrap?.preloadResources?.patterns?.length &&
+            generateLinkHeaders(viewDefinition.viewRecord.assetReferences || [], route.bootstrap?.preloadResources?.patterns || []);
         return {
             body: viewDefinition.renderedView,
             metadata: {
                 viewDefinition,
             },
             cache: viewDefinition.cache,
+            ...(!!link && { headers: { link } }),
         };
     }
     // Get the View's JSON Manifest Response
@@ -171,6 +177,24 @@ export class LwrViewHandler {
         if (response?.locale) {
             runtimeParams.locale = response.locale;
         }
+        // Add link headers if this is a viewDefinition response
+        if (isViewDefinitionResponse(response)) {
+            let viewDefintionMeta = response.metadata?.viewDefinition;
+            if (!viewDefintionMeta) {
+                viewDefintionMeta = (await viewApi.getViewResponse(response.view, response.viewParams, response.renderOptions)).metadata?.viewDefinition;
+            }
+            const link = !!route?.bootstrap?.preloadResources?.patterns?.length &&
+                generateLinkHeaders(
+                // idk when metadata?.viewDefinition would be undefined but
+                // it's optional....probably Darrell's fault
+                viewDefintionMeta?.viewRecord.assetReferences || [], route?.bootstrap?.preloadResources?.patterns || []);
+            if (link) {
+                response.headers = {
+                    ...response.headers,
+                    link,
+                };
+            }
+        }
         return response;
     }
     /*

package/package.json

@@ -4,7 +4,7 @@
     "publishConfig": {
         "access": "public"
     },
-    "version": "0.15.0-alpha.2",
+    "version": "0.15.0-alpha.20",
     "homepage": "https://developer.salesforce.com/docs/platform/lwr/overview",
     "repository": {
         "type": "git",
@@ -33,17 +33,17 @@
         "build": "tsc -b"
     },
     "dependencies": {
-        "@lwrjs/app-service": "0.15.0-alpha.2",
-        "@lwrjs/diagnostics": "0.15.0-alpha.2",
-        "@lwrjs/instrumentation": "0.15.0-alpha.2",
-        "@lwrjs/shared-utils": "0.15.0-alpha.2",
+        "@lwrjs/app-service": "0.15.0-alpha.20",
+        "@lwrjs/diagnostics": "0.15.0-alpha.20",
+        "@lwrjs/instrumentation": "0.15.0-alpha.20",
+        "@lwrjs/shared-utils": "0.15.0-alpha.20",
         "lru-cache": "^10.4.3"
     },
     "devDependencies": {
-        "@lwrjs/types": "0.15.0-alpha.2"
+        "@lwrjs/types": "0.15.0-alpha.20"
     },
     "engines": {
         "node": ">=18.0.0"
     },
-    "gitHead": "58fda4341e2aa0f571a63d83f4aa59865e6a54bd"
+    "gitHead": "112ed1a3472b68a90c6884422137006a5dcf032c"
 }