@lwrjs/shared-utils 0.13.0-alpha.9 → 0.13.1

package/build/cjs/env.cjs

@@ -16,6 +16,9 @@ __export(exports, {
   isLocalDev: () => isLocalDev,
   parseRequestDepthHeader: () => parseRequestDepthHeader
 });
+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,
@@ -23,7 +26,11 @@ function getFeatureFlags() {
     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
+    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
   };
 }
 function isLambdaEnv() {

package/build/cjs/fs.cjs

@@ -28,6 +28,7 @@ __export(exports, {
   PROTOCOL_HTTP: () => PROTOCOL_HTTP,
   PROTOCOL_HTTPS: () => PROTOCOL_HTTPS,
   canResolveView: () => canResolveView,
+  createIntegrityHash: () => createIntegrityHash,
   filterProtocolEntries: () => filterProtocolEntries,
   getViewSourceFromFile: () => getViewSourceFromFile,
   hashContent: () => hashContent,
@@ -60,6 +61,10 @@ var PROTOCOL_FILE = "file://";
 function hashContent(source) {
   return import_crypto.default.createHash("md5").update(source).digest("hex");
 }
+function createIntegrityHash(source) {
+  const hash = import_crypto.default.createHash("sha256").update(source).digest("base64");
+  return `sha256-${hash}`;
+}
 function readFile(filePath) {
   logMetrics(filePath);
   return import_fs_extra.default.readFileSync(filePath, "utf8");

package/build/cjs/identity.cjs

@@ -27,7 +27,6 @@ __export(exports, {
   ASSETS_CACHE_DIR: () => ASSETS_CACHE_DIR,
   BUNDLE_SIGIL: () => BUNDLE_SIGIL,
   DEFAULT_LOCKER_TRUSTED_CMP: () => DEFAULT_LOCKER_TRUSTED_CMP,
-  DEFAULT_LWR_BOOTSTRAP_CONFIG: () => DEFAULT_LWR_BOOTSTRAP_CONFIG,
   DEFAULT_LWR_LOCKER_CONFIG: () => DEFAULT_LWR_LOCKER_CONFIG,
   DEFAULT_TITLE: () => DEFAULT_TITLE,
   ENVIRONMENT_SIGIL: () => ENVIRONMENT_SIGIL,
@@ -40,6 +39,7 @@ __export(exports, {
   explodeSpecifier: () => explodeSpecifier,
   explodeSpecifiers: () => explodeSpecifiers,
   getCacheKeyFromJson: () => import_fast_json_stable_stringify.default,
+  getLocalDevOverrideUrl: () => getLocalDevOverrideUrl,
   getMappingUriPrefix: () => getMappingUriPrefix,
   getModuleUriPrefix: () => getModuleUriPrefix,
   getPropFromAttrName: () => getPropFromAttrName,
@@ -58,6 +58,7 @@ __export(exports, {
   slugify: () => slugify,
   stringToVariableName: () => stringToVariableName
 });
+var import_path = __toModule(require("path"));
 var import_slugify = __toModule(require("slugify"));
 var import_fast_json_stable_stringify = __toModule(require("fast-json-stable-stringify"));
 var VERSION_SIGIL = "v";
@@ -75,18 +76,6 @@ var DEFAULT_LWR_LOCKER_CONFIG = {
   enabled: false,
   trustedComponents: DEFAULT_LOCKER_TRUSTED_CMP
 };
-var DEFAULT_LWR_BOOTSTRAP_CONFIG = {
-  autoBoot: true,
-  syntheticShadow: false,
-  workers: {},
-  services: [],
-  configAsSrc: false,
-  ssr: false,
-  preloadData: false,
-  mixedMode: false,
-  module: void 0,
-  preloadModules: []
-};
 function normalizeVersionToUri(version) {
   return version.replace(/\./g, "_");
 }
@@ -223,3 +212,10 @@ function stringToVariableName(inputString) {
   }
   return cleanedString;
 }
+function getLocalDevOverrideUrl(cacheDir, specifier, filepath) {
+  if (!specifier.startsWith("@view"))
+    return filepath;
+  const dirname = import_path.default.basename(import_path.default.dirname(filepath));
+  const fileName = specifier.split("@view/")[1] + "_view.js";
+  return import_path.default.join(cacheDir, "overrides", dirname, fileName);
+}

package/build/cjs/mappings.cjs

@@ -62,8 +62,8 @@ async function getImportMetadataMappings(moduleIds, runtimeEnvironment, runtimeP
 }
 async function toImportMetadata(moduleGraph, existingImportMetadata = {imports: {}, index: {}}, moduleRegistry, runtimeEnvironment, runtimeParams = {}) {
   const specifier = moduleGraph.graphs[0].specifier;
-  const uri = moduleGraph.uriMap[specifier];
-  const definition = moduleGraph.linkedDefinitions[specifier];
+  const uri = lookupValueIgnoringVersion(moduleGraph.uriMap, specifier);
+  const definition = lookupValueIgnoringVersion(moduleGraph.linkedDefinitions, specifier);
   if (!uri) {
     throw new Error("URI was not included in the graph: " + specifier);
   }
@@ -83,8 +83,8 @@ async function toImportMetadata(moduleGraph, existingImportMetadata = {imports:
     if (isExternalSpecifier(depSpecifier, moduleRegistry.getConfig().bundleConfig)) {
       continue;
     }
-    const depUri = moduleGraph.uriMap[depSpecifier];
-    const depDef = moduleGraph.linkedDefinitions[depSpecifier];
+    const depUri = lookupValueIgnoringVersion(moduleGraph.uriMap, depSpecifier);
+    const depDef = lookupValueIgnoringVersion(moduleGraph.linkedDefinitions, depSpecifier);
     const depMissing = !depUri || !depDef;
     if (depMissing && runtimeEnvironment.format !== "esm") {
       if (!depUri) {
@@ -106,6 +106,18 @@ async function toImportMetadata(moduleGraph, existingImportMetadata = {imports:
   }
   return importMetadata;
 }
+function lookupValueIgnoringVersion(map, specifier) {
+  const val = map[specifier];
+  if (val) {
+    return val;
+  }
+  const cleanedKey = (0, import_identity.explodeSpecifier)(specifier).specifier;
+  for (const mapKey of Object.keys(map)) {
+    if ((0, import_identity.explodeSpecifier)(mapKey).specifier === cleanedKey) {
+      return map[mapKey];
+    }
+  }
+}
 function mergeImportMetadata(existing, newMetadata) {
   return {
     imports: {

package/build/cjs/serialize.cjs

@@ -66,14 +66,21 @@ async function serializeModuleToJson(code = "", {
 function replaceStringFromLocation(src, {startOffset, endOffset}, replaceValue) {
   return src.substr(0, startOffset) + replaceValue + src.substr(endOffset, src.length);
 }
-function shortestTtl(newTtl, oldTtl) {
+function shortestTtl(newTtl, oldTtl, maxTtl) {
   if (newTtl === void 0 && oldTtl === void 0)
     return void 0;
   const newSeconds = typeof newTtl === "string" ? (0, import_ms.default)(newTtl) / 1e3 : newTtl;
   const oldSeconds = typeof oldTtl === "string" ? (0, import_ms.default)(oldTtl) / 1e3 : oldTtl;
-  if (newSeconds === void 0)
-    return oldSeconds;
-  if (oldSeconds === void 0)
-    return newSeconds;
-  return newSeconds < oldSeconds ? newSeconds : oldSeconds;
+  const maxSeconds = typeof maxTtl === "string" ? (0, import_ms.default)(maxTtl) / 1e3 : maxTtl;
+  let shortest = void 0;
+  if (newSeconds !== void 0 && (shortest === void 0 || newSeconds < shortest)) {
+    shortest = newSeconds;
+  }
+  if (oldSeconds !== void 0 && (shortest === void 0 || oldSeconds < shortest)) {
+    shortest = oldSeconds;
+  }
+  if (maxSeconds !== void 0 && (shortest === void 0 || maxSeconds < shortest)) {
+    shortest = maxSeconds;
+  }
+  return shortest;
 }

package/build/es/env.d.ts

@@ -13,7 +13,7 @@ export declare function isLambdaEnv(): boolean;
  */
 export declare function isLocalDev(): boolean;
 /**
- * Create a serializable context for the lwr/environment variable
+ * 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";

package/build/es/env.js

@@ -1,3 +1,6 @@
+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 {
@@ -28,6 +31,20 @@ export function getFeatureFlags() {
         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,
+        // 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,
     };
 }
 /**
@@ -48,7 +65,7 @@ export function isLocalDev() {
     return process.env.MRT_HMR === 'true';
 }
 /**
- * Create a serializable context for the lwr/environment variable
+ * Create a serializable context for user-land exposed environment variables
  */
 export function buildEnvironmentContext(runtimeParams) {
     // The baseBath from the config or set from the request (e.g. /shop)

package/build/es/fs.d.ts

@@ -11,6 +11,10 @@ export declare const PROTOCOL_FILE = "file://";
  * @param source
  */
 export declare function hashContent(source: string | Buffer): string;
+/**
+ * Create a Sub-resource Integrity Hash https://developer.mozilla.org/en-US/docs/Web/Security/Subresource_Integrity
+ */
+export declare function createIntegrityHash(source: string | Buffer): string;
 /**
  * Read in the contents of the file path
  * @param filePath

package/build/es/fs.js

@@ -20,6 +20,13 @@ export const PROTOCOL_FILE = 'file://';
 export function hashContent(source) {
     return crypto.createHash('md5').update(source).digest('hex');
 }
+/**
+ * Create a Sub-resource Integrity Hash https://developer.mozilla.org/en-US/docs/Web/Security/Subresource_Integrity
+ */
+export function createIntegrityHash(source) {
+    const hash = crypto.createHash('sha256').update(source).digest('base64');
+    return `sha256-${hash}`;
+}
 /**
  * Read in the contents of the file path
  * @param filePath

package/build/es/identity.d.ts

@@ -1,5 +1,5 @@
 import getCacheKeyFromJson from 'fast-json-stable-stringify';
-import type { AbstractModuleId, AssetSource, BundleDefinition, ModuleDefinition, NormalizedLwrAppBootstrapConfig, PublicModuleRegistry, RuntimeEnvironment, RuntimeParams } from '@lwrjs/types';
+import type { AbstractModuleId, AssetSource, BundleDefinition, ModuleDefinition, PublicModuleRegistry, RuntimeEnvironment, RuntimeParams } from '@lwrjs/types';
 export declare const VERSION_SIGIL = "v";
 export declare const VERSION_PREFIX: string;
 export declare const LOCALE_SIGIL = "l";
@@ -15,7 +15,6 @@ export declare const DEFAULT_LWR_LOCKER_CONFIG: {
     enabled: boolean;
     trustedComponents: string[];
 };
-export declare const DEFAULT_LWR_BOOTSTRAP_CONFIG: NormalizedLwrAppBootstrapConfig;
 type ModuleIdentifierPartial = Partial<AbstractModuleId>;
 /**
  * Turn the dots in a version into underscores
@@ -148,4 +147,5 @@ export declare function isBundleDefinition(definition: ModuleDefinition | Bundle
  * @param name - Proposed name
  */
 export declare function stringToVariableName(inputString: string): string;
+export declare function getLocalDevOverrideUrl(cacheDir: string, specifier: string, filepath: string): string;
 //# sourceMappingURL=identity.d.ts.map

package/build/es/identity.js

@@ -1,3 +1,4 @@
+import path from 'path';
 import slugifyText from 'slugify';
 import getCacheKeyFromJson from 'fast-json-stable-stringify';
 export const VERSION_SIGIL = 'v';
@@ -16,18 +17,6 @@ export const DEFAULT_LWR_LOCKER_CONFIG = {
     enabled: false,
     trustedComponents: DEFAULT_LOCKER_TRUSTED_CMP,
 };
-export const DEFAULT_LWR_BOOTSTRAP_CONFIG = {
-    autoBoot: true,
-    syntheticShadow: false,
-    workers: {},
-    services: [],
-    configAsSrc: false,
-    ssr: false,
-    preloadData: false,
-    mixedMode: false,
-    module: undefined,
-    preloadModules: [],
-};
 /**
  * Turn the dots in a version into underscores
  * @param version
@@ -281,4 +270,11 @@ export function stringToVariableName(inputString) {
     }
     return cleanedString;
 }
+export function getLocalDevOverrideUrl(cacheDir, specifier, filepath) {
+    if (!specifier.startsWith('@view'))
+        return filepath; // only @view modules get overridden
+    const dirname = path.basename(path.dirname(filepath));
+    const fileName = specifier.split('@view/')[1] + '_view.js';
+    return path.join(cacheDir, 'overrides', dirname, fileName);
+}
 //# sourceMappingURL=identity.js.map

package/build/es/mappings.js

@@ -57,8 +57,8 @@ export async function getImportMetadataMappings(moduleIds, runtimeEnvironment, r
 export async function toImportMetadata(moduleGraph, existingImportMetadata = { imports: {}, index: {} }, moduleRegistry, runtimeEnvironment, runtimeParams = {}) {
     // root module specifier
     const specifier = moduleGraph.graphs[0].specifier;
-    const uri = moduleGraph.uriMap[specifier];
-    const definition = moduleGraph.linkedDefinitions[specifier];
+    const uri = lookupValueIgnoringVersion(moduleGraph.uriMap, specifier);
+    const definition = lookupValueIgnoringVersion(moduleGraph.linkedDefinitions, specifier);
     if (!uri) {
         throw new Error('URI was not included in the graph: ' + specifier);
     }
@@ -86,8 +86,8 @@ export async function toImportMetadata(moduleGraph, existingImportMetadata = { i
             // Ignore Externals
             continue;
         }
-        const depUri = moduleGraph.uriMap[depSpecifier];
-        const depDef = moduleGraph.linkedDefinitions[depSpecifier];
+        const depUri = lookupValueIgnoringVersion(moduleGraph.uriMap, depSpecifier);
+        const depDef = lookupValueIgnoringVersion(moduleGraph.linkedDefinitions, depSpecifier);
         const depMissing = !depUri || !depDef;
         if (depMissing && runtimeEnvironment.format !== 'esm') {
             if (!depUri) {
@@ -112,6 +112,21 @@ export async function toImportMetadata(moduleGraph, existingImportMetadata = { i
     }
     return importMetadata;
 }
+// Function to look up values ignoring the version part
+function lookupValueIgnoringVersion(map, specifier) {
+    // early out on exact match
+    const val = map[specifier];
+    if (val) {
+        return val;
+    }
+    const cleanedKey = explodeSpecifier(specifier).specifier;
+    // Iterate over the map to find the first matching key without version
+    for (const mapKey of Object.keys(map)) {
+        if (explodeSpecifier(mapKey).specifier === cleanedKey) {
+            return map[mapKey];
+        }
+    }
+}
 function mergeImportMetadata(existing, newMetadata) {
     // TODO should there be an error if the metadata conflicts?
     return {

package/build/es/serialize.d.ts

@@ -25,5 +25,5 @@ export declare function replaceStringFromLocation(src: string, { startOffset, en
  * @param oldTtl - the current shortest TTL (if it exists)
  * @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): number | undefined;
+export declare function shortestTtl(newTtl?: string | number, oldTtl?: string | number, maxTtl?: string | number): number | undefined;
 //# sourceMappingURL=serialize.d.ts.map

package/build/es/serialize.js

@@ -49,15 +49,22 @@ export function replaceStringFromLocation(src, { startOffset, endOffset }, repla
  * @param oldTtl - the current shortest TTL (if it exists)
  * @returns - the shorter of the two TTLs IN SECONDS, undefined if both TTLs are missing
  */
-export function shortestTtl(newTtl, oldTtl) {
+export function shortestTtl(newTtl, oldTtl, maxTtl) {
     if (newTtl === undefined && oldTtl === undefined)
         return undefined;
     const newSeconds = typeof newTtl === 'string' ? ms(newTtl) / 1000 : newTtl;
     const oldSeconds = typeof oldTtl === 'string' ? ms(oldTtl) / 1000 : oldTtl;
-    if (newSeconds === undefined)
-        return oldSeconds;
-    if (oldSeconds === undefined)
-        return newSeconds;
-    return newSeconds < oldSeconds ? newSeconds : oldSeconds;
+    const maxSeconds = typeof maxTtl === 'string' ? ms(maxTtl) / 1000 : maxTtl;
+    let shortest = undefined;
+    if (newSeconds !== undefined && (shortest === undefined || newSeconds < shortest)) {
+        shortest = newSeconds;
+    }
+    if (oldSeconds !== undefined && (shortest === undefined || oldSeconds < shortest)) {
+        shortest = oldSeconds;
+    }
+    if (maxSeconds !== undefined && (shortest === undefined || maxSeconds < shortest)) {
+        shortest = maxSeconds;
+    }
+    return shortest;
 }
 //# sourceMappingURL=serialize.js.map

package/package.json

@@ -4,7 +4,7 @@
     "publishConfig": {
         "access": "public"
     },
-    "version": "0.13.0-alpha.9",
+    "version": "0.13.1",
     "homepage": "https://developer.salesforce.com/docs/platform/lwr/overview",
     "repository": {
         "type": "git",
@@ -37,25 +37,25 @@
         "build/**/*.d.ts"
     ],
     "dependencies": {
-        "@lwrjs/diagnostics": "0.13.0-alpha.9",
-        "es-module-lexer": "^1.5.2",
+        "@lwrjs/diagnostics": "0.13.1",
+        "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",
-        "path-to-regexp": "^6.2.0",
+        "path-to-regexp": "^6.2.2",
         "resolve": "^1.22.8",
         "rollup": "^2.78.0",
         "slugify": "^1.4.5"
     },
     "devDependencies": {
-        "@lwrjs/types": "0.13.0-alpha.9",
+        "@lwrjs/types": "0.13.1",
         "@types/mime-types": "2.1.4",
         "@types/path-to-regexp": "^1.7.0"
     },
     "engines": {
         "node": ">=18.0.0"
     },
-    "gitHead": "a2a9e1dbf39a7b04c7a43433e004895b6f4c51a3"
+    "gitHead": "548b27ed22f5bfba7031d6b356d64898e15bd609"
 }