@lwrjs/shared-utils 0.17.2-alpha.9 → 0.18.0

package/build/cjs/env.cjs

@@ -8,12 +8,22 @@ var __export = (target, all) => {
 // packages/@lwrjs/shared-utils/src/env.ts
 __markAsModule(exports);
 __export(exports, {
+  B3_PARENT_ID: () => B3_PARENT_ID,
+  B3_SAMPLED: () => B3_SAMPLED,
+  B3_SPAN_ID: () => B3_SPAN_ID,
+  B3_TRACE_ID: () => B3_TRACE_ID,
+  CORRELATION_ID: () => CORRELATION_ID,
+  MRT_REQUEST_CLASS: () => MRT_REQUEST_CLASS,
   REQUEST_DEPTH_HEADER: () => REQUEST_DEPTH_HEADER,
-  REQUEST_DEPTH_KEY: () => REQUEST_DEPTH_KEY,
+  ROUTE_CORE_HEADER: () => ROUTE_CORE_HEADER,
+  TRUE_CLIENT_IP: () => TRUE_CLIENT_IP,
   buildEnvironmentContext: () => buildEnvironmentContext,
   getFeatureFlags: () => getFeatureFlags,
+  getTraceHeaders: () => getTraceHeaders,
   isLambdaEnv: () => isLambdaEnv,
+  isLocalAuthEnabled: () => isLocalAuthEnabled,
   isLocalDev: () => isLocalDev,
+  isLocalPreview: () => isLocalPreview,
   parseRequestDepth: () => parseRequestDepth
 });
 if (getFeatureFlags().REEVALUATE_MODULES && !getFeatureFlags().LEGACY_LOADER) {
@@ -27,12 +37,15 @@ function getFeatureFlags() {
     EXPERIMENTAL_UNVERSIONED_ALIASES: parseBooleanFlag("EXPERIMENTAL_UNVERSIONED_ALIASES"),
     LEGACY_LOADER: parseBooleanFlag("LEGACY_LOADER"),
     LWR_TRACING: parseTracingFlag(),
+    DISABLE_B3_TRACING: parseBooleanFlag("DISABLE_B3_TRACING"),
     MAX_VIEW_CACHE_TTL: parseStringFlag("MAX_VIEW_CACHE_TTL"),
     REEVALUATE_MODULES: parseBooleanFlag("REEVALUATE_MODULES"),
     SSR_COMPILER_ENABLED: parseBooleanFlag("SSR_COMPILER_ENABLED"),
     SSR_LOADER_PER_REQUEST: parseBooleanFlag("SSR_LOADER_PER_REQUEST"),
     VIEW_CACHE_SIZE: parseStringFlag("VIEW_CACHE_SIZE"),
-    EXPERIMENTAL_ASSET_HEADERS: parseStringFlag("EXPERIMENTAL_ASSET_HEADERS")
+    EXPERIMENTAL_ASSET_HEADERS: parseStringFlag("EXPERIMENTAL_ASSET_HEADERS"),
+    SSR_TIMEOUT: parseStringFlag("SSR_TIMEOUT"),
+    PRELOAD_INCLUDED_MODULES: parseBooleanFlag("PRELOAD_INCLUDED_MODULES")
   };
 }
 function parseBooleanFlag(flag) {
@@ -52,6 +65,12 @@ function isLambdaEnv() {
 function isLocalDev() {
   return process.env.MRT_HMR === "true";
 }
+function isLocalPreview() {
+  return process.env.LOCAL_PREVIEW_MODE === "true";
+}
+function isLocalAuthEnabled() {
+  return process.env.AUTH_TOKEN !== void 0;
+}
 function buildEnvironmentContext(runtimeParams) {
   const basePath = runtimeParams.basePath;
   const locale = runtimeParams.locale;
@@ -64,11 +83,18 @@ function buildEnvironmentContext(runtimeParams) {
     uiBasePath
   };
 }
-var REQUEST_DEPTH_HEADER = "X-SFDC-Request-Depth";
-var REQUEST_DEPTH_KEY = REQUEST_DEPTH_HEADER.toLowerCase();
+var TRUE_CLIENT_IP = "true-client-ip";
+var CORRELATION_ID = "x-correlation-id";
+var B3_TRACE_ID = "x-b3-traceid";
+var B3_SPAN_ID = "x-b3-spanid";
+var B3_PARENT_ID = "x-b3-parentspanid";
+var B3_SAMPLED = "x-b3-sampled";
+var MRT_REQUEST_CLASS = "x-mobify-request-class";
+var ROUTE_CORE_HEADER = "x-sfdc-route-core";
+var REQUEST_DEPTH_HEADER = "x-sfdc-request-depth";
 function parseRequestDepth(headers = {}, query = {}) {
   let maxDepth = 0;
-  const value = headers && headers[REQUEST_DEPTH_KEY];
+  const value = headers && headers[REQUEST_DEPTH_HEADER];
   if (value) {
     if (Array.isArray(value)) {
       for (const depth of value) {
@@ -86,11 +112,29 @@ function parseRequestDepth(headers = {}, query = {}) {
       }
     }
   }
-  if (query[REQUEST_DEPTH_KEY]) {
-    const queryValue = parseInt(query[REQUEST_DEPTH_KEY], 10);
+  if (query[REQUEST_DEPTH_HEADER]) {
+    const queryValue = parseInt(query[REQUEST_DEPTH_HEADER], 10);
     if (!isNaN(queryValue) && queryValue > maxDepth) {
       maxDepth = queryValue;
     }
   }
   return maxDepth;
 }
+function getTraceHeaders(runtimeParams, span) {
+  const headers = {};
+  if (runtimeParams.trueClientIP)
+    headers[TRUE_CLIENT_IP] = runtimeParams.trueClientIP;
+  if (runtimeParams.correlationID)
+    headers[CORRELATION_ID] = runtimeParams.correlationID;
+  if (!getFeatureFlags().DISABLE_B3_TRACING) {
+    if (span?.traceId) {
+      headers[B3_TRACE_ID] = span.traceId;
+      headers[B3_SAMPLED] = parseTracingFlag() ? "1" : "0";
+    }
+    if (span?.spanId)
+      headers[B3_SPAN_ID] = span.spanId;
+    if (span?.parentSpanId)
+      headers[B3_PARENT_ID] = span.parentSpanId;
+  }
+  return headers;
+}

package/build/cjs/html-meta.cjs

@@ -166,7 +166,6 @@ function extractMetadataFromHtml(htmlSource, viewMetadata, appConfig) {
     }
   });
   return {
-    ...viewMetadata,
     customElements: customElements.filter((ce) => !nestedIslands || hasHydrationDirective(ce.props)),
     assetReferences
   };

package/build/cjs/identity.cjs

@@ -127,7 +127,7 @@ async function getVersionedModuleId(rawSpecifier, moduleRegistry, runtimeParams)
   return {...moduleId, version: moduleEntry.version};
 }
 function isSpecifier(specifier) {
-  return !!specifier && /^@?[\w-]+(\/[\w-]+)*$/.test(specifier);
+  return !!specifier && /^@?[\w-.]+(\/[\w-.]+)*$/.test(specifier);
 }
 var RE_SCOPED = /^(@[^/]+\/[^/@]+)(?:\/([^@]+))?(?:@([\s\S]+))?/;
 var RE_NORMAL = /^([^/@]+)(?:\/([^@]+))?(?:@([\s\S]+))?/;

package/build/cjs/launch.cjs

@@ -27,7 +27,7 @@ __export(exports, {
   launch: () => launch
 });
 var import_os = __toModule(require("os"));
-async function launch(port, https) {
+async function launch(port, https, path) {
   const {exec} = await Promise.resolve().then(() => __toModule(require("child_process")));
   let cmd = "open";
   if (process.platform == "win32") {
@@ -39,5 +39,9 @@ async function launch(port, https) {
       cmd = "xdg-open";
     }
   }
-  exec(`${cmd} ${https ? "https" : "http"}://localhost:${port}`);
+  const finalPath = path ? path.startsWith("/") ? path : `/${path}` : "";
+  const protocol = https ? "https" : "http";
+  const url = `${protocol}://localhost:${port}${finalPath}/`;
+  exec(`${cmd} ${url}`);
+  return url;
 }

package/build/cjs/serialize.cjs

@@ -24,11 +24,15 @@ var __toModule = (module2) => {
 // packages/@lwrjs/shared-utils/src/serialize.ts
 __markAsModule(exports);
 __export(exports, {
+  addHeadMarkup: () => addHeadMarkup,
+  addToHead: () => addToHead,
+  createHeadMarkup: () => createHeadMarkup,
   replaceStringFromLocation: () => replaceStringFromLocation,
   serializeModuleToJson: () => serializeModuleToJson,
   shortestTtl: () => shortestTtl
 });
 var import_ms = __toModule(require("ms"));
+var import_diagnostics = __toModule(require("@lwrjs/diagnostics"));
 async function createJsonModule(moduleId, moduleRegistry, runtimeEnvironment, runtimeParams) {
   const {
     ownHash,
@@ -84,3 +88,57 @@ function shortestTtl(newTtl, oldTtl, maxTtl) {
   }
   return shortest;
 }
+function createMetaTags(meta) {
+  return meta.reduce((metaStr, {name, content, httpEquiv}) => {
+    if (!name && !content && !httpEquiv)
+      return metaStr;
+    const nameStr = name ? ` name="${name}"` : "", httpEquivStr = httpEquiv ? ` http-equiv="${httpEquiv}"` : "", contentStr = content ? ` content="${content}"` : "";
+    return metaStr + `<meta${nameStr}${httpEquivStr}${contentStr}>
+`;
+  }, "");
+}
+function createScriptTags(scripts) {
+  return scripts.reduce((scriptStr, {body}) => scriptStr + `<script type="application/ld+json">${body}</script>
+`, "");
+}
+function createLinkTags(links) {
+  return links.reduce((linkStr, {href, rel, as, fetchpriority}) => {
+    const relStr = rel ? ` rel="${rel}"` : "", asStr = as ? ` as="${as}"` : "", fetchStr = fetchpriority ? ` fetchpriority="${fetchpriority}"` : "";
+    return linkStr + `<link href="${href}"${relStr}${asStr}${fetchStr}>
+`;
+  }, "");
+}
+function createStyleTags(styles) {
+  return styles.reduce((styleStr, {body, id}) => {
+    const idStr = id ? ` id="${id}"` : "";
+    return styleStr + `<style type="text/css"${idStr}>${body}</style>
+`;
+  }, "");
+}
+function createHeadMarkup(markup) {
+  let hasTitle = false;
+  return markup.reduce((str, {title, scripts = [], meta = [], links = [], styles = []} = {}) => {
+    if (title && !hasTitle) {
+      hasTitle = true;
+      str += `<title>${title}</title>
+`;
+    }
+    return str + createMetaTags(meta) + createScriptTags(scripts) + createLinkTags(links) + createStyleTags(styles);
+  }, "");
+}
+function addHeadMarkup(markup, stringBuilder) {
+  const headMarkup = createHeadMarkup(markup);
+  if (headMarkup) {
+    addToHead(headMarkup, stringBuilder);
+  }
+}
+function addToHead(markup, stringBuilder) {
+  if (markup) {
+    const headIndex = stringBuilder.original.indexOf("</head>");
+    if (headIndex >= 0) {
+      stringBuilder.prependLeft(headIndex, markup);
+    } else {
+      import_diagnostics.logger.error("Adding head markup failed. Could not find the </head> tag.");
+    }
+  }
+}

package/build/es/env.d.ts

@@ -12,11 +12,35 @@ export declare function isLambdaEnv(): boolean;
  * @returns true if running in localdev mode
  */
 export declare function isLocalDev(): boolean;
+/**
+ * This function is used to determine if lwr is running in the context of local preview.
+ *
+ * @returns true if running in preview mode
+ */
+export declare function isLocalPreview(): boolean;
+/**
+ * This function is used to determine if lwr is running with an authenticated context locally
+ *
+ * @returns true if local dev/preview authentication is enabled
+ */
+export declare function isLocalAuthEnabled(): boolean;
 /**
  * Create a serializable context for user-land exposed environment variables
  */
 export declare function buildEnvironmentContext(runtimeParams: RuntimeParams): EnvironmentContext;
-export declare const REQUEST_DEPTH_HEADER = "X-SFDC-Request-Depth";
-export declare const REQUEST_DEPTH_KEY: string;
+export declare const TRUE_CLIENT_IP = "true-client-ip";
+export declare const CORRELATION_ID = "x-correlation-id";
+export declare const B3_TRACE_ID = "x-b3-traceid";
+export declare const B3_SPAN_ID = "x-b3-spanid";
+export declare const B3_PARENT_ID = "x-b3-parentspanid";
+export declare const B3_SAMPLED = "x-b3-sampled";
+export declare const MRT_REQUEST_CLASS = "x-mobify-request-class";
+export declare const ROUTE_CORE_HEADER = "x-sfdc-route-core";
+export declare const REQUEST_DEPTH_HEADER = "x-sfdc-request-depth";
 export declare function parseRequestDepth(headers?: Headers, query?: Record<string, string>): number;
+export declare function getTraceHeaders(runtimeParams: RuntimeParams, span?: {
+    traceId: string;
+    spanId: string;
+    parentSpanId?: string;
+}): HeadersInit;
 //# sourceMappingURL=env.d.ts.map

package/build/es/env.js

@@ -14,6 +14,8 @@ export function getFeatureFlags() {
         LEGACY_LOADER: parseBooleanFlag('LEGACY_LOADER'),
         // Enable metrics log level 'off', 'default' or 'verbose'
         LWR_TRACING: parseTracingFlag(),
+        // Turn off distributed tracing (B3 headers, traceparent meta tag, MRT span exporting)
+        DISABLE_B3_TRACING: parseBooleanFlag('DISABLE_B3_TRACING'),
         // Max size of ViewDefinition time to live
         MAX_VIEW_CACHE_TTL: parseStringFlag('MAX_VIEW_CACHE_TTL'),
         // Forces SSR to re-evaluate modules for every page render. By default, modules are evaluated only once.
@@ -28,6 +30,10 @@ export function getFeatureFlags() {
         // Expected format is `<header_key_1>: <header_value_1>, header_value_2>; <header_key_2>: <header_value_2>`
         // E.g., assetHeadersString Cloudflare-CDN-Cache-Control: max-age=2813308004; Cache-Tag: ABC123;
         EXPERIMENTAL_ASSET_HEADERS: parseStringFlag('EXPERIMENTAL_ASSET_HEADERS'),
+        // Sets the timeout for SSR on lambda in ms
+        SSR_TIMEOUT: parseStringFlag('SSR_TIMEOUT'),
+        // Pushes the includedModules of each root component bundle into clientBootstrapConfig.preloadModules
+        PRELOAD_INCLUDED_MODULES: parseBooleanFlag('PRELOAD_INCLUDED_MODULES'),
     };
 }
 /**
@@ -70,6 +76,22 @@ export function isLocalDev() {
     // TODO still need to formalize environment variable names
     return process.env.MRT_HMR === 'true';
 }
+/**
+ * This function is used to determine if lwr is running in the context of local preview.
+ *
+ * @returns true if running in preview mode
+ */
+export function isLocalPreview() {
+    return process.env.LOCAL_PREVIEW_MODE === 'true';
+}
+/**
+ * This function is used to determine if lwr is running with an authenticated context locally
+ *
+ * @returns true if local dev/preview authentication is enabled
+ */
+export function isLocalAuthEnabled() {
+    return process.env.AUTH_TOKEN !== undefined;
+}
 /**
  * Create a serializable context for user-land exposed environment variables
  */
@@ -89,11 +111,20 @@ export function buildEnvironmentContext(runtimeParams) {
         uiBasePath,
     };
 }
-export const REQUEST_DEPTH_HEADER = 'X-SFDC-Request-Depth';
-export const REQUEST_DEPTH_KEY = REQUEST_DEPTH_HEADER.toLowerCase();
+// headers used by LWR-Node and LWR@MRT
+export const TRUE_CLIENT_IP = 'true-client-ip'; // public IP of the original request source, eg: 13.123.12.3
+export const CORRELATION_ID = 'x-correlation-id'; // shared correlation ID for the request
+export const B3_TRACE_ID = 'x-b3-traceid'; // trace ID shared across service boundaries for a page request, set to inbound B3 header || lwr.handle.view trace ID
+export const B3_SPAN_ID = 'x-b3-spanid'; // span ID for a trace
+export const B3_PARENT_ID = 'x-b3-parentspanid'; // parent span ID for a trace
+export const B3_SAMPLED = 'x-b3-sampled'; // "0" = tracing is off, "1" = tracing is on
+export const MRT_REQUEST_CLASS = 'x-mobify-request-class'; // contains the site base path, eg: basePath=/mysite
+export const ROUTE_CORE_HEADER = 'x-sfdc-route-core'; // helps route requests to Core efficiently, value: true
+export const REQUEST_DEPTH_HEADER = 'x-sfdc-request-depth'; // tracks the request depth to prevent cycles to the LWR server, eg: 2
+// standard headers: Forwarded (eg: host=dev.testing.com;proto=https), Host (eg: darrell.sandbox.my.site.com), Cookie (holds the SID for auth'ed requests)
 export function parseRequestDepth(headers = {}, query = {}) {
     let maxDepth = 0;
-    const value = headers && headers[REQUEST_DEPTH_KEY];
+    const value = headers && headers[REQUEST_DEPTH_HEADER];
     if (value) {
         if (Array.isArray(value)) {
             for (const depth of value) {
@@ -112,12 +143,30 @@ export function parseRequestDepth(headers = {}, query = {}) {
             }
         }
     }
-    if (query[REQUEST_DEPTH_KEY]) {
-        const queryValue = parseInt(query[REQUEST_DEPTH_KEY], 10);
+    if (query[REQUEST_DEPTH_HEADER]) {
+        const queryValue = parseInt(query[REQUEST_DEPTH_HEADER], 10);
         if (!isNaN(queryValue) && queryValue > maxDepth) {
             maxDepth = queryValue;
         }
     }
     return maxDepth;
 }
+export function getTraceHeaders(runtimeParams, span) {
+    const headers = {};
+    if (runtimeParams.trueClientIP)
+        headers[TRUE_CLIENT_IP] = runtimeParams.trueClientIP;
+    if (runtimeParams.correlationID)
+        headers[CORRELATION_ID] = runtimeParams.correlationID;
+    if (!getFeatureFlags().DISABLE_B3_TRACING) {
+        if (span?.traceId) {
+            headers[B3_TRACE_ID] = span.traceId;
+            headers[B3_SAMPLED] = parseTracingFlag() ? '1' : '0';
+        }
+        if (span?.spanId)
+            headers[B3_SPAN_ID] = span.spanId;
+        if (span?.parentSpanId)
+            headers[B3_PARENT_ID] = span.parentSpanId;
+    }
+    return headers;
+}
 //# sourceMappingURL=env.js.map

package/build/es/html-meta.d.ts

@@ -1,11 +1,11 @@
-import type { NormalizedLwrGlobalConfig, RenderedViewMetadata } from '@lwrjs/types';
+import type { HtmlMetadata, NormalizedLwrGlobalConfig, RenderedViewMetadata } from '@lwrjs/types';
 export declare function isRelative(url: string): boolean;
 export declare function isSelfUrl(url: string): boolean;
 /**
  * Pull the custom elements and img tags out of an HTML string, to use as metadata
  * @param htmlSource - An HTML string to parse
  */
-export declare function extractMetadataFromHtml(htmlSource: string, viewMetadata: RenderedViewMetadata, appConfig: NormalizedLwrGlobalConfig): RenderedViewMetadata;
+export declare function extractMetadataFromHtml(htmlSource: string, viewMetadata: RenderedViewMetadata, appConfig: NormalizedLwrGlobalConfig): HtmlMetadata;
 export declare const HYDRATE_DIRECTIVE = "lwr:hydrate";
 export declare const HYDRATE_LOAD_VALUE = "load";
 export declare const HYDRATE_CLIENT_VALUE = "client-only";

package/build/es/html-meta.js

@@ -165,7 +165,6 @@ export function extractMetadataFromHtml(htmlSource, viewMetadata, appConfig) {
         },
     });
     return {
-        ...viewMetadata,
         customElements: customElements.filter((ce) => !nestedIslands || hasHydrationDirective(ce.props)),
         assetReferences,
     };

package/build/es/identity.js

@@ -128,7 +128,7 @@ export async function getVersionedModuleId(rawSpecifier, moduleRegistry, runtime
     return { ...moduleId, version: moduleEntry.version };
 }
 export function isSpecifier(specifier) {
-    return !!specifier && /^@?[\w-]+(\/[\w-]+)*$/.test(specifier);
+    return !!specifier && /^@?[\w-.]+(\/[\w-.]+)*$/.test(specifier);
 }
 const RE_SCOPED = /^(@[^/]+\/[^/@]+)(?:\/([^@]+))?(?:@([\s\S]+))?/;
 const RE_NORMAL = /^([^/@]+)(?:\/([^@]+))?(?:@([\s\S]+))?/;

package/build/es/interchangeable-modules.js

@@ -4,9 +4,9 @@ import resolve from 'resolve';
 import { readFile } from './fs.js';
 const CONFIG_FILES = ['package.json', 'lwc.config.json', 'lwr.config.json'];
 class NoLwcModuleError extends Error {
+    code = 'NO_LWC_MODULE_FOUND';
     constructor() {
         super('No LWC module found');
-        this.code = 'NO_LWC_MODULE_FOUND';
     }
 }
 function isNpmModuleRecord(module) {

package/build/es/launch.d.ts

@@ -4,5 +4,5 @@
  * @param port - the port number
  * @param https - if true, use https
  */
-export declare function launch(port: number, https?: boolean): Promise<void>;
+export declare function launch(port: number, https?: boolean, path?: string): Promise<string>;
 //# sourceMappingURL=launch.d.ts.map

package/build/es/launch.js

@@ -5,7 +5,7 @@ import { release } from 'os';
  * @param port - the port number
  * @param https - if true, use https
  */
-export async function launch(port, https) {
+export async function launch(port, https, path) {
     const { exec } = await import('child_process');
     let cmd = 'open';
     if (process.platform == 'win32') {
@@ -19,6 +19,11 @@ export async function launch(port, https) {
             cmd = 'xdg-open';
         }
     }
-    exec(`${cmd} ${https ? 'https' : 'http'}://localhost:${port}`);
+    // Ensure the path begins with '/' if provided
+    const finalPath = path ? (path.startsWith('/') ? path : `/${path}`) : '';
+    const protocol = https ? 'https' : 'http';
+    const url = `${protocol}://localhost:${port}${finalPath}/`;
+    exec(`${cmd} ${url}`);
+    return url;
 }
 //# sourceMappingURL=launch.js.map

package/build/es/lwr-app-observer.js

@@ -4,6 +4,7 @@ const MODULE_SOURCE_CHANGED_EVENT = 'module_source_changed';
 const VIEW_SOURCE_CHANGED_EVENT = 'view_source_changed';
 const ASSET_SOURCE_CHANGED_EVENT = 'asset_source_changed';
 class LwrEmitter {
+    observer;
     constructor(observer) {
         this.observer = observer;
     }

package/build/es/serialize.d.ts

@@ -1,4 +1,4 @@
-import type { LinkedModuleDefinition, ModuleJsonDefinition, ModuleRegistry, RuntimeParams } from '@lwrjs/types';
+import type { HeadMarkup, LinkedModuleDefinition, LwrStringBuilder, ModuleJsonDefinition, ModuleRegistry, RuntimeParams } from '@lwrjs/types';
 /**
  * Take a Module Definition and return its JSON serialization
  *
@@ -26,4 +26,22 @@ export declare function replaceStringFromLocation(src: string, { startOffset, en
  * @returns - the shorter of the two TTLs IN SECONDS, undefined if both TTLs are missing
  */
 export declare function shortestTtl(newTtl?: string | number, oldTtl?: string | number, maxTtl?: string | number): number | undefined;
+/**
+ * Serialize head markup metadata into an HTML string
+ * @param markup An array of markup metadata objects
+ * @returns A string of HTML generated from markup metadata
+ */
+export declare function createHeadMarkup(markup: (HeadMarkup | undefined)[]): string;
+/**
+ * Serialize HeadMarkup config into HTML, then add it to the <head> of a base doc
+ * @param markup An array of markup metadata objects
+ * @param stringBuilder The string builder for a base document
+ */
+export declare function addHeadMarkup(markup: (HeadMarkup | undefined)[], stringBuilder: LwrStringBuilder): void;
+/**
+ * Add an HTML string to the <head> of a base doc
+ * @param markup An HTML string
+ * @param stringBuilder The string builder for a base document
+ */
+export declare function addToHead(markup: string, stringBuilder: LwrStringBuilder): void;
 //# sourceMappingURL=serialize.d.ts.map

package/build/es/serialize.js

@@ -1,4 +1,5 @@
 import ms from 'ms';
+import { logger } from '@lwrjs/diagnostics';
 // Given a Module Identifier, return a JSON entry
 async function createJsonModule(moduleId, moduleRegistry, runtimeEnvironment, runtimeParams) {
     const { ownHash, moduleEntry: { version }, } = await moduleRegistry.getModule(moduleId, runtimeParams);
@@ -67,4 +68,81 @@ export function shortestTtl(newTtl, oldTtl, maxTtl) {
     }
     return shortest;
 }
+/** HEAD MARKUP UTILS */
+function createMetaTags(meta) {
+    return meta.reduce((metaStr, { name, content, httpEquiv }) => {
+        if (!name && !content && !httpEquiv)
+            return metaStr; // do not create empty <meta> tags
+        const nameStr = name ? ` name="${name}"` : '', httpEquivStr = httpEquiv ? ` http-equiv="${httpEquiv}"` : '', contentStr = content ? ` content="${content}"` : '';
+        return metaStr + `<meta${nameStr}${httpEquivStr}${contentStr}>\n`;
+    }, '');
+}
+function createScriptTags(scripts) {
+    return scripts.reduce((scriptStr, { body }) => scriptStr + `<script type="application/ld+json">${body}</script>\n`, '');
+}
+function createLinkTags(links) {
+    return links.reduce((linkStr, { href, rel, as, fetchpriority }) => {
+        const relStr = rel ? ` rel="${rel}"` : '', asStr = as ? ` as="${as}"` : '', fetchStr = fetchpriority ? ` fetchpriority="${fetchpriority}"` : '';
+        return linkStr + `<link href="${href}"${relStr}${asStr}${fetchStr}>\n`;
+    }, '');
+}
+function createStyleTags(styles) {
+    return styles.reduce((styleStr, { body, id }) => {
+        const idStr = id ? ` id="${id}"` : '';
+        return styleStr + `<style type="text/css"${idStr}>${body}</style>\n`;
+    }, '');
+}
+/**
+ * Serialize head markup metadata into an HTML string
+ * @param markup An array of markup metadata objects
+ * @returns A string of HTML generated from markup metadata
+ */
+export function createHeadMarkup(markup) {
+    // Loop through the <title>, <script>, <meta>, and <link> tag information
+    // Create an HTML string for each tag
+    let hasTitle = false;
+    return markup.reduce((str, { title, scripts = [], meta = [], links = [], styles = [] } = {}) => {
+        if (title && !hasTitle) {
+            // first <title> wins
+            hasTitle = true;
+            str += `<title>${title}</title>\n`;
+        }
+        return (str +
+            createMetaTags(meta) +
+            createScriptTags(scripts) +
+            createLinkTags(links) +
+            createStyleTags(styles));
+    }, '');
+}
+/**
+ * Serialize HeadMarkup config into HTML, then add it to the <head> of a base doc
+ * @param markup An array of markup metadata objects
+ * @param stringBuilder The string builder for a base document
+ */
+export function addHeadMarkup(markup, stringBuilder) {
+    // Create HTML tags for each item in the SsrDataResponse.markup bag
+    const headMarkup = createHeadMarkup(markup);
+    if (headMarkup) {
+        // Add all the links to the <head> section of the base document
+        addToHead(headMarkup, stringBuilder);
+    }
+}
+/**
+ * Add an HTML string to the <head> of a base doc
+ * @param markup An HTML string
+ * @param stringBuilder The string builder for a base document
+ */
+export function addToHead(markup, stringBuilder) {
+    // Create HTML tags for each item in the SsrDataResponse.markup bag
+    if (markup) {
+        // Add all the links to the <head> section of the base document
+        const headIndex = stringBuilder.original.indexOf('</head>');
+        if (headIndex >= 0) {
+            stringBuilder.prependLeft(headIndex, markup);
+        }
+        else {
+            logger.error('Adding head markup failed. Could not find the </head> tag.');
+        }
+    }
+}
 //# sourceMappingURL=serialize.js.map

package/build/es/tasks.js

@@ -1,4 +1,8 @@
 class Task {
+    taskFunction;
+    caller;
+    resolve;
+    reject;
     constructor(taskFunction, caller, resolve, reject) {
         this.taskFunction = taskFunction;
         this.caller = caller;
@@ -11,9 +15,10 @@ class Task {
  * If more tasks than that are asked to execute they are put in a queue until there is space in the pool
  */
 export class TaskPool {
+    size;
+    queue = [];
+    running = 0;
     constructor(size) {
-        this.queue = [];
-        this.running = 0;
         this.size = size || 15;
     }
     /**
@@ -67,9 +72,7 @@ export class TaskPool {
  * If no task of that id is running a new task is created
  */
 export class InflightTasks {
-    constructor() {
-        this.tasks = new Map();
-    }
+    tasks = new Map();
     /**
      * Return a promise per id.  If one is already in flight return the promise.
      * If not use the constructor to create a new

package/package.json

@@ -4,7 +4,7 @@
     "publishConfig": {
         "access": "public"
     },
-    "version": "0.17.2-alpha.9",
+    "version": "0.18.0",
     "homepage": "https://developer.salesforce.com/docs/platform/lwr/overview",
     "repository": {
         "type": "git",
@@ -37,7 +37,7 @@
         "build/**/*.d.ts"
     ],
     "dependencies": {
-        "@lwrjs/diagnostics": "0.17.2-alpha.9",
+        "@lwrjs/diagnostics": "0.18.0",
         "es-module-lexer": "^1.5.4",
         "fast-json-stable-stringify": "^2.1.0",
         "magic-string": "^0.30.9",
@@ -50,13 +50,13 @@
         "slugify": "^1.4.5"
     },
     "devDependencies": {
-        "@lwrjs/types": "0.17.2-alpha.9",
+        "@lwrjs/types": "0.18.0",
         "@types/mime-types": "2.1.4",
         "@types/path-to-regexp": "^1.7.0",
         "memfs": "^4.13.0"
     },
     "engines": {
-        "node": ">=18.0.0"
+        "node": ">=20.0.0"
     },
-    "gitHead": "7ede5d04a97513b9869b13e66155bc4f3920bb99"
+    "gitHead": "763c7c558ea75fe34a91162c9793de63e55f1d2f"
 }