@lwrjs/shared-utils 0.15.0-alpha.9 → 0.15.0

package/build/cjs/cookie.cjs

@@ -0,0 +1,21 @@
+var __defProp = Object.defineProperty;
+var __markAsModule = (target) => __defProp(target, "__esModule", {value: true});
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, {get: all[name], enumerable: true});
+};
+
+// packages/@lwrjs/shared-utils/src/cookie.ts
+__markAsModule(exports);
+__export(exports, {
+  cookieStringToObject: () => cookieStringToObject
+});
+function cookieStringToObject(cookieString) {
+  return cookieString.split(";").reduce((cookies, cookie) => {
+    const [name, value] = cookie.trim().split("=");
+    if (name && value) {
+      cookies[name] = decodeURIComponent(value);
+    }
+    return cookies;
+  }, {});
+}

package/build/cjs/env.cjs

@@ -14,25 +14,39 @@ __export(exports, {
   getFeatureFlags: () => getFeatureFlags,
   isLambdaEnv: () => isLambdaEnv,
   isLocalDev: () => isLocalDev,
-  parseRequestDepthHeader: () => parseRequestDepthHeader
+  parseRequestDepth: () => parseRequestDepth
 });
 if (getFeatureFlags().REEVALUATE_MODULES && !getFeatureFlags().LEGACY_LOADER) {
   throw new Error("REEVALUATE_MODULES is only supported with LEGACY_LOADER");
 }
 function getFeatureFlags() {
   return {
-    ASSETS_ON_LAMBDA: process.env.ASSETS_ON_LAMBDA !== void 0 && process.env.ASSETS_ON_LAMBDA.toLowerCase() === "true" ? true : false,
-    LEGACY_LOADER: process.env.LEGACY_LOADER !== void 0 && process.env.LEGACY_LOADER.toLowerCase() === "true" ? true : false,
-    SSR_STATIC_BUNDLES: process.env.SSR_STATIC_BUNDLES !== void 0 && process.env.SSR_STATIC_BUNDLES.toLowerCase() === "true" ? true : false,
-    SSR_WITH_CSR_FALLBACK: process.env.SSR_WITH_CSR_FALLBACK !== void 0 && process.env.SSR_WITH_CSR_FALLBACK.toLowerCase() === "true" ? true : false,
-    EXPERIMENTAL_UNVERSIONED_ALIASES: process.env.EXPERIMENTAL_UNVERSIONED_ALIASES !== void 0 && process.env.EXPERIMENTAL_UNVERSIONED_ALIASES.toLowerCase() === "true" ? true : false,
-    LWR_TRACING: process.env.LWR_TRACING !== void 0 && process.env.LWR_TRACING.toLowerCase() !== "off" ? process.env.LWR_TRACING : false,
-    ENABLE_NONCE: process.env.ENABLE_NONCE !== void 0 && process.env.ENABLE_NONCE.toLowerCase() === "true" ? true : false,
-    SINGLE_RENDER_MODE: process.env.SINGLE_RENDER_MODE !== void 0 && process.env.SINGLE_RENDER_MODE.toLowerCase() === "true" ? true : false,
-    REEVALUATE_MODULES: process.env.REEVALUATE_MODULES !== void 0 && process.env.REEVALUATE_MODULES.toLowerCase() === "true" ? true : false,
-    MAX_VIEW_CACHE_TTL: process.env.MAX_VIEW_CACHE_TTL
+    ASSETS_ON_LAMBDA: parseBooleanFlag("ASSETS_ON_LAMBDA"),
+    BUNDLE_CACHE_SIZE: parseStringFlag("BUNDLE_CACHE_SIZE"),
+    ENABLE_NONCE: parseBooleanFlag("ENABLE_NONCE"),
+    EXPERIMENTAL_UNVERSIONED_ALIASES: parseBooleanFlag("EXPERIMENTAL_UNVERSIONED_ALIASES"),
+    LEGACY_LOADER: parseBooleanFlag("LEGACY_LOADER"),
+    LWR_TRACING: parseTracingFlag(),
+    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"),
+    SSR_WITH_CSR_FALLBACK: parseBooleanFlag("SSR_WITH_CSR_FALLBACK"),
+    VIEW_CACHE_SIZE: parseStringFlag("VIEW_CACHE_SIZE"),
+    EXPERIMENTAL_ASSET_HEADERS: parseStringFlag("EXPERIMENTAL_ASSET_HEADERS")
   };
 }
+function parseBooleanFlag(flag) {
+  return process.env[flag]?.toLowerCase() === "true" || false;
+}
+function parseStringFlag(flag) {
+  const value = process.env[flag]?.trim();
+  return value || void 0;
+}
+function parseTracingFlag() {
+  const tracingValue = process.env.LWR_TRACING?.toLowerCase();
+  return tracingValue && tracingValue !== "off" ? process.env.LWR_TRACING : void 0;
+}
 function isLambdaEnv() {
   return process.env.AWS_LAMBDA_FUNCTION_NAME !== void 0;
 }
@@ -53,7 +67,7 @@ function buildEnvironmentContext(runtimeParams) {
 }
 var REQUEST_DEPTH_HEADER = "X-SFDC-Request-Depth";
 var REQUEST_DEPTH_KEY = REQUEST_DEPTH_HEADER.toLowerCase();
-function parseRequestDepthHeader(headers = {}) {
+function parseRequestDepth(headers = {}, query = {}) {
   let maxDepth = 0;
   const value = headers && headers[REQUEST_DEPTH_KEY];
   if (value) {
@@ -73,5 +87,11 @@ function parseRequestDepthHeader(headers = {}) {
       }
     }
   }
+  if (query[REQUEST_DEPTH_KEY]) {
+    const queryValue = parseInt(query[REQUEST_DEPTH_KEY], 10);
+    if (!isNaN(queryValue) && queryValue > maxDepth) {
+      maxDepth = queryValue;
+    }
+  }
   return maxDepth;
 }

package/build/cjs/graph.cjs

@@ -118,9 +118,17 @@ async function getModuleGraphs(specifier, options, moduleRegistry, defRegistry,
   }
   const flattened = [];
   await traverse(moduleDef, depth, flattened, 0, acc, defRegistry, runtimeEnvironment, runtimeParams);
+  let extraFlat = new Set();
+  if (options.includeUris || options.includeLinkedDefinitions) {
+    const allDeps = flattened.reduce((all, node) => {
+      all.push(node.specifier, ...node.static, ...node.dynamicRefs);
+      return all;
+    }, []).filter((dep) => acc.has(dep));
+    extraFlat = new Set(allDeps);
+  }
   const uriMap = {};
   if (options.includeUris) {
-    for (const visitedSpecifier of acc.keys()) {
+    for (const visitedSpecifier of extraFlat.keys()) {
       const moduleId = await (0, import_identity.getVersionedModuleId)(visitedSpecifier, moduleRegistry, runtimeParams);
       const uri = await defRegistry.resolveModuleUri(moduleId, runtimeEnvironment, runtimeParams);
       uriMap[visitedSpecifier] = uri;
@@ -128,7 +136,7 @@ async function getModuleGraphs(specifier, options, moduleRegistry, defRegistry,
   }
   const linkedDefinitions = {};
   if (options.includeLinkedDefinitions) {
-    for (const visitedSpecifier of acc.keys()) {
+    for (const visitedSpecifier of extraFlat.keys()) {
       const versionedModuleId2 = await (0, import_identity.getVersionedModuleId)(visitedSpecifier, moduleRegistry, runtimeParams);
       const module2 = isBundler(defRegistry) ? await defRegistry.getModuleBundle(versionedModuleId2, runtimeEnvironment, runtimeParams) : await defRegistry.getLinkedModule(versionedModuleId2, runtimeEnvironment, runtimeParams);
       linkedDefinitions[visitedSpecifier] = module2;

package/build/cjs/headers.cjs

@@ -0,0 +1,15 @@
+var __defProp = Object.defineProperty;
+var __markAsModule = (target) => __defProp(target, "__esModule", {value: true});
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, {get: all[name], enumerable: true});
+};
+
+// packages/@lwrjs/shared-utils/src/headers.ts
+__markAsModule(exports);
+__export(exports, {
+  normalizeHeaders: () => normalizeHeaders
+});
+function normalizeHeaders(headers = {}) {
+  return Object.fromEntries(Object.entries(headers).map(([key, value]) => [key.toLowerCase(), value]));
+}

package/build/cjs/html-meta.cjs

@@ -34,9 +34,8 @@ __export(exports, {
   isRelative: () => isRelative,
   isSelfUrl: () => isSelfUrl
 });
+var parse5 = __toModule(require("parse5"));
 var import_identity = __toModule(require("./identity.cjs"));
-var import_parse5_sax_parser = __toModule(require("parse5-sax-parser"));
-var import_stream = __toModule(require("stream"));
 function parseAssetLocation(htmlSource, tagName, attrLocation) {
   const {startOffset, endOffset} = attrLocation;
   const srcAttr = htmlSource.substring(startOffset, endOffset);
@@ -53,6 +52,30 @@ function parseAssetLocation(htmlSource, tagName, attrLocation) {
     }
   };
 }
+function parseInlineStyleImages(htmlSource, tagName, attrLocation) {
+  const imageAssets = [], urlPattern = /url\((.*?)\)/g, {startOffset, endOffset} = attrLocation, srcAttr = htmlSource.substring(startOffset, endOffset);
+  let srcAttrStart = 0, match;
+  while ((match = urlPattern.exec(srcAttr)) !== null) {
+    const currentStr = srcAttr.substring(srcAttrStart);
+    imageAssets.push({
+      url: match[1].trim().replace(/^['"]|['"]$/g, ""),
+      startOffset: startOffset + currentStr.indexOf(match[1]) + srcAttrStart,
+      endOffset: startOffset + currentStr.indexOf(match[1]) + match[1].length + srcAttrStart
+    });
+    srcAttrStart = currentStr.indexOf(match[1]) + match[1].length + srcAttrStart;
+  }
+  return imageAssets.map((asset) => {
+    return {
+      url: asset.url,
+      tagName,
+      relative: isRelative(asset.url),
+      location: {
+        startOffset: asset.startOffset,
+        endOffset: asset.endOffset
+      }
+    };
+  });
+}
 function isRelative(url) {
   return !url?.match(isNotRelativeRegex);
 }
@@ -64,23 +87,33 @@ var isSelfUrlRegex = /^\s*(data:|#)/i;
 function hasHydrationDirective(attrs = {}) {
   return Object.keys(attrs).some((attr) => attr === HYDRATE_DIRECTIVE);
 }
-async function extractMetadataFromHtml(htmlSource, viewMetadata, appConfig) {
+function traverseHtmlTree(node, visitor) {
+  for (const child of parse5.defaultTreeAdapter.getChildNodes(node)) {
+    if (parse5.defaultTreeAdapter.isElementNode(child)) {
+      visitor.enter?.(child);
+      traverseHtmlTree(child, visitor);
+      visitor.exit?.(child);
+    }
+  }
+}
+function extractMetadataFromHtml(htmlSource, viewMetadata, appConfig) {
   const {customElements, assetReferences} = viewMetadata;
   const {
     bundleConfig: {external = {}}
   } = appConfig;
   const externals = Object.keys(external);
-  return new Promise((resolve, reject) => {
-    const openElements = new Set();
-    const parser = new import_parse5_sax_parser.default({sourceCodeLocationInfo: true});
-    const ceRefStack = [];
-    let nestedIslands = false;
-    parser.on("startTag", ({
-      tagName,
-      attrs,
-      sourceCodeLocation
-    }) => {
-      if (tagName.includes("-") && !openElements.has(tagName) && !externals.includes((0, import_identity.kebabCaseToModuleSpecifier)(tagName))) {
+  const root = parse5.parse(htmlSource, {
+    sourceCodeLocationInfo: true,
+    treeAdapter: parse5.defaultTreeAdapter
+  });
+  let nestedIslands = false;
+  let styleStartOffset;
+  const openElements = new Set();
+  const ceRefStack = [];
+  traverseHtmlTree(root, {
+    enter(node) {
+      const {nodeName: tagName, attrs, sourceCodeLocation} = node;
+      if (sourceCodeLocation && tagName.includes("-") && !openElements.has(tagName) && !externals.includes((0, import_identity.kebabCaseToModuleSpecifier)(tagName))) {
         const {startOffset, endOffset} = sourceCodeLocation;
         const props = attrs.length ? attrs.reduce((obj, {name, value}) => {
           obj[(0, import_identity.getPropFromAttrName)(name)] = value === "" ? "true" : value;
@@ -100,21 +133,21 @@ async function extractMetadataFromHtml(htmlSource, viewMetadata, appConfig) {
         }
         ceRefStack.push(ceRef);
       }
-      if ((tagName === "img" || tagName === "script") && sourceCodeLocation.attrs) {
-        if (sourceCodeLocation.attrs.src) {
-          assetReferences.push(parseAssetLocation(htmlSource, tagName, sourceCodeLocation.attrs.src));
-        }
+      if ((tagName === "img" || tagName === "script") && sourceCodeLocation?.attrs?.src) {
+        assetReferences.push(parseAssetLocation(htmlSource, tagName, sourceCodeLocation.attrs.src));
       }
-      if (tagName === "link" && sourceCodeLocation.attrs) {
-        if (sourceCodeLocation.attrs.href) {
-          assetReferences.push(parseAssetLocation(htmlSource, tagName, sourceCodeLocation.attrs.href));
-        }
+      if (tagName === "link" && sourceCodeLocation?.attrs?.href) {
+        assetReferences.push(parseAssetLocation(htmlSource, tagName, sourceCodeLocation.attrs.href));
       }
-    });
-    parser.on("endTag", ({
-      tagName,
-      sourceCodeLocation
-    }) => {
+      if (tagName === "style") {
+        styleStartOffset = sourceCodeLocation?.startOffset;
+      }
+      if (sourceCodeLocation?.attrs?.style) {
+        assetReferences.push(...parseInlineStyleImages(htmlSource, tagName, sourceCodeLocation.attrs.style));
+      }
+    },
+    exit(node) {
+      const {nodeName: tagName, sourceCodeLocation} = node;
       if (openElements.has(tagName)) {
         const ceRef = ceRefStack.pop();
         openElements.delete(tagName);
@@ -123,16 +156,20 @@ async function extractMetadataFromHtml(htmlSource, viewMetadata, appConfig) {
         }
         ceRef.location.endOffset = sourceCodeLocation.endOffset;
       }
-    });
-    const inputStream = import_stream.Readable.from(htmlSource);
-    inputStream.on("end", () => resolve({
-      ...viewMetadata,
-      customElements: customElements.filter((ce) => !nestedIslands || hasHydrationDirective(ce.props)),
-      assetReferences
-    }));
-    inputStream.on("error", (error) => reject(error));
-    inputStream.pipe(parser);
+      if (tagName === "style" && styleStartOffset && sourceCodeLocation?.endOffset) {
+        assetReferences.push(...parseInlineStyleImages(htmlSource, "style", {
+          startOffset: styleStartOffset,
+          endOffset: sourceCodeLocation.endOffset
+        }));
+        styleStartOffset = void 0;
+      }
+    }
   });
+  return {
+    ...viewMetadata,
+    customElements: customElements.filter((ce) => !nestedIslands || hasHydrationDirective(ce.props)),
+    assetReferences
+  };
 }
 var HYDRATE_DIRECTIVE = "lwr:hydrate";
 var HYDRATE_LOAD_VALUE = "load";

package/build/cjs/identity.cjs

@@ -33,6 +33,7 @@ __export(exports, {
   IMMUTABLE_ASSET_PREFIX: () => IMMUTABLE_ASSET_PREFIX,
   LATEST_SIGNATURE: () => LATEST_SIGNATURE,
   LOCALE_SIGIL: () => LOCALE_SIGIL,
+  SSR_SIGIL: () => SSR_SIGIL,
   VERSION_NOT_PROVIDED: () => VERSION_NOT_PROVIDED,
   VERSION_PREFIX: () => VERSION_PREFIX,
   VERSION_SIGIL: () => VERSION_SIGIL,
@@ -69,6 +70,7 @@ var DEFAULT_TITLE = "LWR App";
 var IMMUTABLE_ASSET_PREFIX = "/_immutable/";
 var ASSETS_CACHE_DIR = "assetsCache";
 var VERSION_NOT_PROVIDED = "version-not-provided";
+var SSR_SIGIL = "ssr";
 var DEFAULT_LOCKER_TRUSTED_CMP = ["@locker/*", "lwr/*", "@lwrjs/*", "lwc", "@lwc/*"];
 var DEFAULT_LWR_LOCKER_CONFIG = {
   enabled: false,

package/build/cjs/index.cjs

@@ -36,3 +36,5 @@ __exportStar(exports, __toModule(require("./lwr-app-observer.cjs")));
 __exportStar(exports, __toModule(require("./bundle.cjs")));
 __exportStar(exports, __toModule(require("./localization.cjs")));
 __exportStar(exports, __toModule(require("./launch.cjs")));
+__exportStar(exports, __toModule(require("./cookie.cjs")));
+__exportStar(exports, __toModule(require("./headers.cjs")));

package/build/es/cookie.d.ts

@@ -0,0 +1,2 @@
+export declare function cookieStringToObject(cookieString: string): Record<string, string>;
+//# sourceMappingURL=cookie.d.ts.map

package/build/es/cookie.js

@@ -0,0 +1,10 @@
+export function cookieStringToObject(cookieString) {
+    return cookieString.split(';').reduce((cookies, cookie) => {
+        const [name, value] = cookie.trim().split('=');
+        if (name && value) {
+            cookies[name] = decodeURIComponent(value);
+        }
+        return cookies;
+    }, {});
+}
+//# sourceMappingURL=cookie.js.map

package/build/es/env.d.ts

@@ -18,5 +18,5 @@ export declare function isLocalDev(): boolean;
 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 function parseRequestDepthHeader(headers?: Headers): number;
+export declare function parseRequestDepth(headers?: Headers, query?: Record<string, string>): number;
 //# sourceMappingURL=env.d.ts.map

package/build/es/env.js

@@ -2,51 +2,59 @@ if (getFeatureFlags().REEVALUATE_MODULES && !getFeatureFlags().LEGACY_LOADER) {
     throw new Error('REEVALUATE_MODULES is only supported with LEGACY_LOADER');
 }
 export function getFeatureFlags() {
-    // Add any new feature flags here to parse from environment variables
     return {
         // Should we load load the assets from the lambda on MRT
-        ASSETS_ON_LAMBDA: process.env.ASSETS_ON_LAMBDA !== undefined &&
-            process.env.ASSETS_ON_LAMBDA.toLowerCase() === 'true'
-            ? true
-            : false,
-        // DEFAULT LEGACY_LOADER = false;
-        LEGACY_LOADER: process.env.LEGACY_LOADER !== undefined && process.env.LEGACY_LOADER.toLowerCase() === 'true'
-            ? true
-            : false,
-        // SSR should concatenate bundles, default = false
-        SSR_STATIC_BUNDLES: process.env.SSR_STATIC_BUNDLES !== undefined &&
-            process.env.SSR_STATIC_BUNDLES.toLowerCase() === 'true'
-            ? true
-            : false,
-        // Islands fallback to CSR if SSR fails
-        SSR_WITH_CSR_FALLBACK: process.env.SSR_WITH_CSR_FALLBACK !== undefined &&
-            process.env.SSR_WITH_CSR_FALLBACK.toLowerCase() === 'true'
-            ? true
-            : false,
+        ASSETS_ON_LAMBDA: parseBooleanFlag('ASSETS_ON_LAMBDA'),
+        // Number of BundleDefinition and BundleCode instances held in memory
+        BUNDLE_CACHE_SIZE: parseStringFlag('BUNDLE_CACHE_SIZE'),
+        ENABLE_NONCE: parseBooleanFlag('ENABLE_NONCE'),
         // AMD Module Bundles include un-versioned aliases
-        EXPERIMENTAL_UNVERSIONED_ALIASES: process.env.EXPERIMENTAL_UNVERSIONED_ALIASES !== undefined &&
-            process.env.EXPERIMENTAL_UNVERSIONED_ALIASES.toLowerCase() === 'true'
-            ? true
-            : false,
-        LWR_TRACING: process.env.LWR_TRACING !== undefined && process.env.LWR_TRACING.toLowerCase() !== 'off'
-            ? process.env.LWR_TRACING
-            : false,
-        ENABLE_NONCE: process.env.ENABLE_NONCE !== undefined && process.env.ENABLE_NONCE.toLowerCase() === 'true'
-            ? true
-            : false,
-        // Forces SSR rendering to render only one page at a time
-        SINGLE_RENDER_MODE: process.env.SINGLE_RENDER_MODE !== undefined &&
-            process.env.SINGLE_RENDER_MODE.toLowerCase() === 'true'
-            ? true
-            : false,
+        EXPERIMENTAL_UNVERSIONED_ALIASES: parseBooleanFlag('EXPERIMENTAL_UNVERSIONED_ALIASES'),
+        // DEFAULT LEGACY_LOADER = false;
+        LEGACY_LOADER: parseBooleanFlag('LEGACY_LOADER'),
+        // Enable metrics log level 'off', 'default' or 'verbose'
+        LWR_TRACING: parseTracingFlag(),
+        // 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.
-        REEVALUATE_MODULES: process.env.REEVALUATE_MODULES !== undefined &&
-            process.env.REEVALUATE_MODULES.toLowerCase() === 'true'
-            ? true
-            : false,
-        MAX_VIEW_CACHE_TTL: process.env.MAX_VIEW_CACHE_TTL,
+        REEVALUATE_MODULES: parseBooleanFlag('REEVALUATE_MODULES'),
+        // Use the LWC SSR compiler and v2 SSR API
+        SSR_COMPILER_ENABLED: parseBooleanFlag('SSR_COMPILER_ENABLED'),
+        // Create a new SSR Loader on every request
+        SSR_LOADER_PER_REQUEST: parseBooleanFlag('SSR_LOADER_PER_REQUEST'),
+        // Islands fallback to CSR if SSR fails
+        SSR_WITH_CSR_FALLBACK: parseBooleanFlag('SSR_WITH_CSR_FALLBACK'),
+        // Max number of ViewDefinitions help in memory
+        VIEW_CACHE_SIZE: parseStringFlag('VIEW_CACHE_SIZE'),
+        // Allows setting/overriding headers for non-immutable assets.
+        // 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'),
     };
 }
+/**
+ * Helper function to parse boolean environment variables.
+ * Returns true if the variable is set to 'true', false otherwise.
+ */
+function parseBooleanFlag(flag) {
+    return process.env[flag]?.toLowerCase() === 'true' || false;
+}
+/**
+ * Helper function to parse string environment variables.
+ * Returns the trimmed string if the variable is defined, otherwise returns undefined.
+ */
+function parseStringFlag(flag) {
+    const value = process.env[flag]?.trim();
+    return value || undefined;
+}
+/**
+ * Helper function to parse the LWR_TRACING flag.
+ * Returns the value if it's not 'off' and is defined, otherwise returns false.
+ */
+function parseTracingFlag() {
+    const tracingValue = process.env.LWR_TRACING?.toLowerCase();
+    return tracingValue && tracingValue !== 'off' ? process.env.LWR_TRACING : undefined;
+}
 /**
  * This function is used to determine if the current environment is a lambda.
  *
@@ -85,7 +93,7 @@ export function buildEnvironmentContext(runtimeParams) {
 }
 export const REQUEST_DEPTH_HEADER = 'X-SFDC-Request-Depth';
 export const REQUEST_DEPTH_KEY = REQUEST_DEPTH_HEADER.toLowerCase();
-export function parseRequestDepthHeader(headers = {}) {
+export function parseRequestDepth(headers = {}, query = {}) {
     let maxDepth = 0;
     const value = headers && headers[REQUEST_DEPTH_KEY];
     if (value) {
@@ -106,6 +114,12 @@ export function parseRequestDepthHeader(headers = {}) {
             }
         }
     }
+    if (query[REQUEST_DEPTH_KEY]) {
+        const queryValue = parseInt(query[REQUEST_DEPTH_KEY], 10);
+        if (!isNaN(queryValue) && queryValue > maxDepth) {
+            maxDepth = queryValue;
+        }
+    }
     return maxDepth;
 }
 //# sourceMappingURL=env.js.map

package/build/es/graph.js

@@ -123,9 +123,22 @@ options, moduleRegistry, defRegistry, runtimeEnvironment, runtimeParams, visited
     }
     const flattened = [];
     await traverse(moduleDef, depth, flattened, 0, acc, defRegistry, runtimeEnvironment, runtimeParams);
+    let extraFlat = new Set();
+    if (options.includeUris || options.includeLinkedDefinitions) {
+        // Get a set of the root specifier and all dependencies
+        // DO NOT use the visited map for including URIs and linked defs because it includes
+        // entries from previous runs of getModuleGraphs() which belong to OTHER root specifiers
+        const allDeps = flattened
+            .reduce((all, node) => {
+            all.push(node.specifier, ...node.static, ...node.dynamicRefs);
+            return all;
+        }, [])
+            .filter((dep) => acc.has(dep));
+        extraFlat = new Set(allDeps);
+    }
     const uriMap = {};
     if (options.includeUris) {
-        for (const visitedSpecifier of acc.keys()) {
+        for (const visitedSpecifier of extraFlat.keys()) {
             // eslint-disable-next-line no-await-in-loop
             const moduleId = await getVersionedModuleId(visitedSpecifier, moduleRegistry, runtimeParams);
             // eslint-disable-next-line no-await-in-loop
@@ -135,7 +148,7 @@ options, moduleRegistry, defRegistry, runtimeEnvironment, runtimeParams, visited
     }
     const linkedDefinitions = {};
     if (options.includeLinkedDefinitions) {
-        for (const visitedSpecifier of acc.keys()) {
+        for (const visitedSpecifier of extraFlat.keys()) {
             // eslint-disable-next-line no-await-in-loop
             const versionedModuleId = await getVersionedModuleId(visitedSpecifier, moduleRegistry, runtimeParams);
             const module = isBundler(defRegistry)

package/build/es/headers.d.ts

@@ -0,0 +1,2 @@
+export declare function normalizeHeaders(headers?: Record<string, string>): Record<string, string>;
+//# sourceMappingURL=headers.d.ts.map

package/build/es/headers.js

@@ -0,0 +1,4 @@
+export function normalizeHeaders(headers = {}) {
+    return Object.fromEntries(Object.entries(headers).map(([key, value]) => [key.toLowerCase(), value]));
+}
+//# sourceMappingURL=headers.js.map

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

@@ -5,7 +5,7 @@ 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): Promise<RenderedViewMetadata>;
+export declare function extractMetadataFromHtml(htmlSource: string, viewMetadata: RenderedViewMetadata, appConfig: NormalizedLwrGlobalConfig): RenderedViewMetadata;
 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

@@ -1,6 +1,5 @@
+import * as parse5 from 'parse5';
 import { getPropFromAttrName, kebabCaseToModuleSpecifier } from './identity.js';
-import SAXParser from 'parse5-sax-parser';
-import { Readable } from 'stream';
 function parseAssetLocation(htmlSource, tagName, attrLocation) {
     const { startOffset, endOffset } = attrLocation;
     const srcAttr = htmlSource.substring(startOffset, endOffset);
@@ -19,6 +18,41 @@ function parseAssetLocation(htmlSource, tagName, attrLocation) {
         },
     };
 }
+function parseInlineStyleImages(htmlSource, tagName, attrLocation) {
+    const imageAssets = [], 
+    // Define a regex pattern to match the 'url()' part of inline styles
+    urlPattern = /url\((.*?)\)/g, { startOffset, endOffset } = attrLocation, 
+    // Extract the substring that contains the attribute (e.g., a 'style' attribute with inline CSS or <style></style> content)
+    srcAttr = htmlSource.substring(startOffset, endOffset);
+    // Initialize a variable to track the current parsing position
+    let srcAttrStart = 0, match;
+    // Loop through all matches of 'url(...)' in the inline style attribute
+    while ((match = urlPattern.exec(srcAttr)) !== null) {
+        // Extract the substring starting from the current position in srcAttr
+        const currentStr = srcAttr.substring(srcAttrStart);
+        imageAssets.push({
+            // Clean up the URL by trimming quotes and spaces
+            url: match[1].trim().replace(/^['"]|['"]$/g, ''),
+            // Calculate the starting offset of the matched URL relative to the entire HTML source
+            startOffset: startOffset + currentStr.indexOf(match[1]) + srcAttrStart,
+            // Calculate the ending offset of the matched URL
+            endOffset: startOffset + currentStr.indexOf(match[1]) + match[1].length + srcAttrStart,
+        });
+        // Move the srcAttrStart to the end of the currently matched URL to avoid picking up the already matched url
+        srcAttrStart = currentStr.indexOf(match[1]) + match[1].length + srcAttrStart;
+    }
+    return imageAssets.map((asset) => {
+        return {
+            url: asset.url,
+            tagName,
+            relative: isRelative(asset.url),
+            location: {
+                startOffset: asset.startOffset,
+                endOffset: asset.endOffset,
+            },
+        };
+    });
+}
 // Detect if this is a relative URL
 export function isRelative(url) {
     return !url?.match(isNotRelativeRegex);
@@ -32,23 +66,38 @@ const isSelfUrlRegex = /^\s*(data:|#)/i;
 function hasHydrationDirective(attrs = {}) {
     return Object.keys(attrs).some((attr) => attr === HYDRATE_DIRECTIVE);
 }
+function traverseHtmlTree(node, visitor) {
+    for (const child of parse5.defaultTreeAdapter.getChildNodes(node)) {
+        if (parse5.defaultTreeAdapter.isElementNode(child)) {
+            visitor.enter?.(child);
+            traverseHtmlTree(child, visitor);
+            visitor.exit?.(child);
+        }
+    }
+}
 /**
  * Pull the custom elements and img tags out of an HTML string, to use as metadata
  * @param htmlSource - An HTML string to parse
  */
-export async function extractMetadataFromHtml(htmlSource, viewMetadata, appConfig) {
+export function extractMetadataFromHtml(htmlSource, viewMetadata, appConfig) {
     const { customElements, assetReferences } = viewMetadata;
     const { bundleConfig: { external = {} }, } = appConfig;
     const externals = Object.keys(external);
-    return new Promise((resolve, reject) => {
-        const openElements = new Set();
-        const parser = new SAXParser({ sourceCodeLocationInfo: true }); // TODO: Would we need this in the future?
-        const ceRefStack = [];
-        let nestedIslands = false;
-        parser.on('startTag', ({ tagName, attrs, // attributes are passed into SSR
-        sourceCodeLocation, }) => {
-            // custom elements
-            if (tagName.includes('-') &&
+    const root = parse5.parse(htmlSource, {
+        sourceCodeLocationInfo: true,
+        treeAdapter: parse5.defaultTreeAdapter,
+    });
+    let nestedIslands = false;
+    let styleStartOffset;
+    const openElements = new Set();
+    const ceRefStack = [];
+    traverseHtmlTree(root, {
+        enter(node) {
+            // Source code location is only available if the parser is configured with preserve
+            // source location info.
+            const { nodeName: tagName, attrs, sourceCodeLocation } = node;
+            if (sourceCodeLocation &&
+                tagName.includes('-') &&
                 !openElements.has(tagName) &&
                 !externals.includes(kebabCaseToModuleSpecifier(tagName))) {
                 const { startOffset, endOffset } = sourceCodeLocation;
@@ -81,22 +130,22 @@ export async function extractMetadataFromHtml(htmlSource, viewMetadata, appConfi
             }
             // <img src="asset-url"/>
             // <script type="text/javascript" src="asset-url"></script>
-            if ((tagName === 'img' || tagName === 'script') && sourceCodeLocation.attrs) {
-                if (sourceCodeLocation.attrs.src) {
-                    assetReferences.push(parseAssetLocation(htmlSource, tagName, sourceCodeLocation.attrs.src));
-                }
-                // if (sourceCodeLocation.attrs.srcset) {
-                // TODO: WIP
-                // }
+            if ((tagName === 'img' || tagName === 'script') && sourceCodeLocation?.attrs?.src) {
+                assetReferences.push(parseAssetLocation(htmlSource, tagName, sourceCodeLocation.attrs.src));
             }
             // <link rel="stylesheet" href="asset-url">
-            if (tagName === 'link' && sourceCodeLocation.attrs) {
-                if (sourceCodeLocation.attrs.href) {
-                    assetReferences.push(parseAssetLocation(htmlSource, tagName, sourceCodeLocation.attrs.href));
-                }
+            if (tagName === 'link' && sourceCodeLocation?.attrs?.href) {
+                assetReferences.push(parseAssetLocation(htmlSource, tagName, sourceCodeLocation.attrs.href));
             }
-        });
-        parser.on('endTag', ({ tagName, sourceCodeLocation, }) => {
+            if (tagName === 'style') {
+                styleStartOffset = sourceCodeLocation?.startOffset;
+            }
+            if (sourceCodeLocation?.attrs?.style) {
+                assetReferences.push(...parseInlineStyleImages(htmlSource, tagName, sourceCodeLocation.attrs.style));
+            }
+        },
+        exit(node) {
+            const { nodeName: tagName, sourceCodeLocation } = node;
             if (openElements.has(tagName)) {
                 const ceRef = ceRefStack.pop();
                 openElements.delete(tagName);
@@ -106,18 +155,20 @@ export async function extractMetadataFromHtml(htmlSource, viewMetadata, appConfi
                 // eslint-disable-next-line @typescript-eslint/no-non-null-assertion
                 ceRef.location.endOffset = sourceCodeLocation.endOffset;
             }
-        });
-        const inputStream = Readable.from(htmlSource);
-        // If nested islands are found, ONLY collect custom elements with the hydration directive
-        // Otherwise, just collect top-level custom elements (ie: root components) as usual
-        inputStream.on('end', () => resolve({
-            ...viewMetadata,
-            customElements: customElements.filter((ce) => !nestedIslands || hasHydrationDirective(ce.props)),
-            assetReferences,
-        }));
-        inputStream.on('error', (error) => reject(error));
-        inputStream.pipe(parser);
+            if (tagName === 'style' && styleStartOffset && sourceCodeLocation?.endOffset) {
+                assetReferences.push(...parseInlineStyleImages(htmlSource, 'style', {
+                    startOffset: styleStartOffset,
+                    endOffset: sourceCodeLocation.endOffset,
+                }));
+                styleStartOffset = undefined;
+            }
+        },
     });
+    return {
+        ...viewMetadata,
+        customElements: customElements.filter((ce) => !nestedIslands || hasHydrationDirective(ce.props)),
+        assetReferences,
+    };
 }
 export const HYDRATE_DIRECTIVE = 'lwr:hydrate';
 export const HYDRATE_LOAD_VALUE = 'load';

package/build/es/identity.d.ts

@@ -10,6 +10,7 @@ export declare const DEFAULT_TITLE = "LWR App";
 export declare const IMMUTABLE_ASSET_PREFIX = "/_immutable/";
 export declare const ASSETS_CACHE_DIR = "assetsCache";
 export declare const VERSION_NOT_PROVIDED = "version-not-provided";
+export declare const SSR_SIGIL = "ssr";
 export declare const DEFAULT_LOCKER_TRUSTED_CMP: string[];
 export declare const DEFAULT_LWR_LOCKER_CONFIG: {
     enabled: boolean;

package/build/es/identity.js

@@ -10,6 +10,7 @@ export const DEFAULT_TITLE = 'LWR App';
 export const IMMUTABLE_ASSET_PREFIX = '/_immutable/';
 export const ASSETS_CACHE_DIR = 'assetsCache';
 export const VERSION_NOT_PROVIDED = 'version-not-provided';
+export const SSR_SIGIL = 'ssr';
 // Locker trusted components
 export const DEFAULT_LOCKER_TRUSTED_CMP = ['@locker/*', 'lwr/*', '@lwrjs/*', 'lwc', '@lwc/*'];
 export const DEFAULT_LWR_LOCKER_CONFIG = {

package/build/es/index.d.ts

@@ -15,4 +15,6 @@ export * from './lwr-app-observer.js';
 export * from './bundle.js';
 export * from './localization.js';
 export * from './launch.js';
+export * from './cookie.js';
+export * from './headers.js';
 //# sourceMappingURL=index.d.ts.map

package/build/es/index.js

@@ -15,4 +15,6 @@ export * from './lwr-app-observer.js';
 export * from './bundle.js';
 export * from './localization.js';
 export * from './launch.js';
+export * from './cookie.js';
+export * from './headers.js';
 //# sourceMappingURL=index.js.map

package/package.json

@@ -4,7 +4,7 @@
     "publishConfig": {
         "access": "public"
     },
-    "version": "0.15.0-alpha.9",
+    "version": "0.15.0",
     "homepage": "https://developer.salesforce.com/docs/platform/lwr/overview",
     "repository": {
         "type": "git",
@@ -37,26 +37,26 @@
         "build/**/*.d.ts"
     ],
     "dependencies": {
-        "@lwrjs/diagnostics": "0.15.0-alpha.9",
+        "@lwrjs/diagnostics": "0.15.0",
         "es-module-lexer": "^1.5.4",
         "fast-json-stable-stringify": "^2.1.0",
         "magic-string": "^0.30.9",
         "mime-types": "^2.1.33",
         "ms": "^2.1.3",
-        "parse5-sax-parser": "^6.0.1",
+        "parse5": "^7.2.1",
         "path-to-regexp": "^6.2.2",
         "resolve": "^1.22.8",
-        "rollup": "^2.78.0",
+        "rollup": "^2.79.2",
         "slugify": "^1.4.5"
     },
     "devDependencies": {
-        "@lwrjs/types": "0.15.0-alpha.9",
+        "@lwrjs/types": "0.15.0",
         "@types/mime-types": "2.1.4",
         "@types/path-to-regexp": "^1.7.0",
-        "memfs": "^4.9.3"
+        "memfs": "^4.13.0"
     },
     "engines": {
         "node": ">=18.0.0"
     },
-    "gitHead": "9783b817b11c29ca385457683fcb87e8179f7902"
+    "gitHead": "ee374df435d5342f63e4da126a09461e761837f3"
 }