@lwrjs/shared-utils 0.13.0-alpha.2 → 0.13.0-alpha.20

package/build/cjs/env.cjs

@@ -12,6 +12,8 @@ __export(exports, {
   REQUEST_DEPTH_KEY: () => REQUEST_DEPTH_KEY,
   buildEnvironmentContext: () => buildEnvironmentContext,
   getFeatureFlags: () => getFeatureFlags,
+  isLambdaEnv: () => isLambdaEnv,
+  isLocalDev: () => isLocalDev,
   parseRequestDepthHeader: () => parseRequestDepthHeader
 });
 function getFeatureFlags() {
@@ -21,9 +23,16 @@ 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
   };
 }
+function isLambdaEnv() {
+  return process.env.AWS_LAMBDA_FUNCTION_NAME !== void 0;
+}
+function isLocalDev() {
+  return process.env.MRT_HMR === "true";
+}
 function buildEnvironmentContext(runtimeParams) {
   const basePath = runtimeParams.basePath;
   const locale = runtimeParams.locale;

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,
@@ -35,6 +34,7 @@ __export(exports, {
   LATEST_SIGNATURE: () => LATEST_SIGNATURE,
   LOCALE_SIGIL: () => LOCALE_SIGIL,
   VERSION_NOT_PROVIDED: () => VERSION_NOT_PROVIDED,
+  VERSION_PREFIX: () => VERSION_PREFIX,
   VERSION_SIGIL: () => VERSION_SIGIL,
   explodeSpecifier: () => explodeSpecifier,
   explodeSpecifiers: () => explodeSpecifiers,
@@ -59,7 +59,8 @@ __export(exports, {
 });
 var import_slugify = __toModule(require("slugify"));
 var import_fast_json_stable_stringify = __toModule(require("fast-json-stable-stringify"));
-var VERSION_SIGIL = "/v/";
+var VERSION_SIGIL = "v";
+var VERSION_PREFIX = `/${VERSION_SIGIL}/`;
 var LOCALE_SIGIL = "l";
 var ENVIRONMENT_SIGIL = "e";
 var BUNDLE_SIGIL = "bi";
@@ -73,18 +74,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, "_");
 }
@@ -122,10 +111,10 @@ function getSpecifier({specifier, namespace, name = "", version}) {
   if (specifier) {
     const versionMatch = specifier.match(/(.+)\/v\/[a-zA-Z0-9-_.]+$/);
     specifier = versionMatch ? versionMatch[1] : specifier;
-    return version && version !== VERSION_NOT_PROVIDED ? `${specifier}${VERSION_SIGIL}${normalizeVersionToUri(version)}` : specifier;
+    return version && version !== VERSION_NOT_PROVIDED ? `${specifier}${VERSION_PREFIX}${normalizeVersionToUri(version)}` : specifier;
   }
   const bareSpecifier = namespace ? `${namespace}/${name}` : name;
-  return version && version !== VERSION_NOT_PROVIDED ? `${bareSpecifier}${VERSION_SIGIL}${normalizeVersionToUri(version)}` : bareSpecifier;
+  return version && version !== VERSION_NOT_PROVIDED ? `${bareSpecifier}${VERSION_PREFIX}${normalizeVersionToUri(version)}` : bareSpecifier;
 }
 async function getVersionedModuleId(rawSpecifier, moduleRegistry, runtimeParams) {
   const moduleId = explodeSpecifier(rawSpecifier);

package/build/cjs/index.cjs

@@ -35,3 +35,4 @@ __exportStar(exports, __toModule(require("./env.cjs")));
 __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")));

package/build/cjs/launch.cjs

@@ -0,0 +1,43 @@
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+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});
+};
+var __exportStar = (target, module2, desc) => {
+  if (module2 && typeof module2 === "object" || typeof module2 === "function") {
+    for (let key of __getOwnPropNames(module2))
+      if (!__hasOwnProp.call(target, key) && key !== "default")
+        __defProp(target, key, {get: () => module2[key], enumerable: !(desc = __getOwnPropDesc(module2, key)) || desc.enumerable});
+  }
+  return target;
+};
+var __toModule = (module2) => {
+  return __exportStar(__markAsModule(__defProp(module2 != null ? __create(__getProtoOf(module2)) : {}, "default", module2 && module2.__esModule && "default" in module2 ? {get: () => module2.default, enumerable: true} : {value: module2, enumerable: true})), module2);
+};
+
+// packages/@lwrjs/shared-utils/src/launch.ts
+__markAsModule(exports);
+__export(exports, {
+  launch: () => launch
+});
+var import_os = __toModule(require("os"));
+async function launch(port, https) {
+  const {exec} = await Promise.resolve().then(() => __toModule(require("child_process")));
+  let cmd = "open";
+  if (process.platform == "win32") {
+    cmd = "start";
+  } else if (process.platform == "linux") {
+    if (/microsoft/i.test((0, import_os.release)())) {
+      cmd = "cmd.exe /c start";
+    } else {
+      cmd = "xdg-open";
+    }
+  }
+  exec(`${cmd} ${https ? "https" : "http"}://localhost:${port}`);
+}

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/es/env.d.ts

@@ -1,7 +1,19 @@
 import type { EnvironmentContext, FeatureFlags, Headers, RuntimeParams } from '@lwrjs/types';
 export declare function getFeatureFlags(): FeatureFlags;
 /**
- * Create a serializable context for the lwr/environment variable
+ * This function is used to determine if the current environment is a lambda.
+ *
+ * @returns true if process is running in lambda environment
+ */
+export declare function isLambdaEnv(): boolean;
+/**
+ * This function is used to determine if lwr is running in the context of local development.
+ *
+ * @returns true if running in localdev mode
+ */
+export declare function isLocalDev(): 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";

package/build/es/env.js

@@ -28,10 +28,30 @@ 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,
     };
 }
 /**
- * Create a serializable context for the lwr/environment variable
+ * This function is used to determine if the current environment is a lambda.
+ *
+ * @returns true if process is running in lambda environment
+ */
+export function isLambdaEnv() {
+    return process.env.AWS_LAMBDA_FUNCTION_NAME !== undefined;
+}
+/**
+ * This function is used to determine if lwr is running in the context of local development.
+ *
+ * @returns true if running in localdev mode
+ */
+export function isLocalDev() {
+    // TODO still need to formalize environment variable names
+    return process.env.MRT_HMR === 'true';
+}
+/**
+ * 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,6 +1,7 @@
 import getCacheKeyFromJson from 'fast-json-stable-stringify';
-import type { AbstractModuleId, AssetSource, BundleDefinition, ModuleDefinition, NormalizedLwrAppBootstrapConfig, PublicModuleRegistry, RuntimeEnvironment, RuntimeParams } from '@lwrjs/types';
-export declare const VERSION_SIGIL = "/v/";
+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";
 export declare const ENVIRONMENT_SIGIL = "e";
 export declare const BUNDLE_SIGIL = "bi";
@@ -14,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

package/build/es/identity.js

@@ -1,6 +1,7 @@
 import slugifyText from 'slugify';
 import getCacheKeyFromJson from 'fast-json-stable-stringify';
-export const VERSION_SIGIL = '/v/';
+export const VERSION_SIGIL = 'v';
+export const VERSION_PREFIX = `/${VERSION_SIGIL}/`;
 export const LOCALE_SIGIL = 'l';
 export const ENVIRONMENT_SIGIL = 'e';
 export const BUNDLE_SIGIL = 'bi';
@@ -15,18 +16,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
@@ -99,13 +88,13 @@ export function getSpecifier({ specifier, namespace, name = '', version }) {
         specifier = versionMatch ? versionMatch[1] : specifier;
         // If a module has an explicit 'version-not-provided' version this will not be reflected in the specifier
         return version && version !== VERSION_NOT_PROVIDED
-            ? `${specifier}${VERSION_SIGIL}${normalizeVersionToUri(version)}`
+            ? `${specifier}${VERSION_PREFIX}${normalizeVersionToUri(version)}`
             : specifier;
     }
     const bareSpecifier = namespace ? `${namespace}/${name}` : name;
     // If a module has an explicit 'version-not-provided' version this will not be reflected in the specifier
     return version && version !== VERSION_NOT_PROVIDED
-        ? `${bareSpecifier}${VERSION_SIGIL}${normalizeVersionToUri(version)}`
+        ? `${bareSpecifier}${VERSION_PREFIX}${normalizeVersionToUri(version)}`
         : bareSpecifier;
 }
 /**

package/build/es/index.d.ts

@@ -14,4 +14,5 @@ export * from './env.js';
 export * from './lwr-app-observer.js';
 export * from './bundle.js';
 export * from './localization.js';
+export * from './launch.js';
 //# sourceMappingURL=index.d.ts.map

package/build/es/index.js

@@ -14,4 +14,5 @@ export * from './env.js';
 export * from './lwr-app-observer.js';
 export * from './bundle.js';
 export * from './localization.js';
+export * from './launch.js';
 //# sourceMappingURL=index.js.map

package/build/es/launch.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Shared utility for launching a localhost browser window at a given port.
+ *
+ * @param port - the port number
+ * @param https - if true, use https
+ */
+export declare function launch(port: number, https?: boolean): Promise<void>;
+//# sourceMappingURL=launch.d.ts.map

package/build/es/launch.js

@@ -0,0 +1,24 @@
+import { release } from 'os';
+/**
+ * Shared utility for launching a localhost browser window at a given port.
+ *
+ * @param port - the port number
+ * @param https - if true, use https
+ */
+export async function launch(port, https) {
+    const { exec } = await import('child_process');
+    let cmd = 'open';
+    if (process.platform == 'win32') {
+        cmd = 'start';
+    }
+    else if (process.platform == 'linux') {
+        if (/microsoft/i.test(release())) {
+            cmd = 'cmd.exe /c start';
+        }
+        else {
+            cmd = 'xdg-open';
+        }
+    }
+    exec(`${cmd} ${https ? 'https' : 'http'}://localhost:${port}`);
+}
+//# sourceMappingURL=launch.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/package.json

@@ -4,7 +4,7 @@
     "publishConfig": {
         "access": "public"
     },
-    "version": "0.13.0-alpha.2",
+    "version": "0.13.0-alpha.20",
     "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.2",
-        "es-module-lexer": "^1.3.0",
+        "@lwrjs/diagnostics": "0.13.0-alpha.20",
+        "es-module-lexer": "^1.5.3",
         "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.2",
+        "@lwrjs/types": "0.13.0-alpha.20",
         "@types/mime-types": "2.1.4",
         "@types/path-to-regexp": "^1.7.0"
     },
     "engines": {
         "node": ">=18.0.0"
     },
-    "gitHead": "3ae1051ef1eb282f9c1fb54f6aab44ab5ba48480"
+    "gitHead": "2165594f2871f4f20a4083394e4372e67d1fa1b5"
 }