@lwrjs/config 0.15.0-alpha.9 → 0.15.0

package/build/cjs/defaults.cjs

@@ -37,11 +37,15 @@ __export(exports, {
   DEFAULT_ROOT_DIR: () => DEFAULT_ROOT_DIR,
   DEFAULT_SERVICE_PACKAGE_NAME: () => DEFAULT_SERVICE_PACKAGE_NAME,
   LWR_INFO_ROUTE: () => LWR_INFO_ROUTE,
+  MIN_LWC_VERSION: () => MIN_LWC_VERSION,
+  MIN_LWR_VERSION: () => MIN_LWR_VERSION,
   getDefaultBundleConfig: () => getDefaultBundleConfig
 });
 var import_shared_utils = __toModule(require("@lwrjs/shared-utils"));
 var import_runtime_config = __toModule(require("./runtime-config.cjs"));
 var import_package = __toModule(require("@lwrjs/config/package"));
+var MIN_LWR_VERSION = "0.12.0";
+var MIN_LWC_VERSION = "6.1.0";
 var PORT = process.env.PORT ? parseInt(process.env.PORT, 10) : 3e3;
 var MODE = process.env.MODE || "prod";
 var DEFAULT_BASE_PATH = "";
@@ -156,6 +160,7 @@ var DEFAULT_LWR_CONFIG = {
   viewTransformers: DEFAULT_VIEW_TRANSFORM_PLUGINS,
   environment: {},
   lwc: {modules: []},
+  caseSensitiveRoutes: false,
   routes: [
     LWR_INFO_ROUTE
   ],
@@ -165,7 +170,10 @@ var DEFAULT_LWR_CONFIG = {
   serverType: DEFAULT_SERVER_TYPE,
   locker: import_shared_utils.DEFAULT_LWR_LOCKER_CONFIG,
   uriTransformers: DEFAULT_URI_TRANSFORM_PLUGINS,
-  i18n: import_runtime_config.DEFAULT_I18N_CONFIG
+  i18n: import_runtime_config.DEFAULT_I18N_CONFIG,
+  coreProxy: null,
+  unsafeEnableViewLinkCaching: false,
+  _isSsrCompilerEnabled: false
 };
 var DEFAULT_LWR_BOOTSTRAP_CONFIG = {
   autoBoot: true,
@@ -175,9 +183,14 @@ var DEFAULT_LWR_BOOTSTRAP_CONFIG = {
   configAsSrc: false,
   ssr: false,
   preloadData: false,
+  proxyForSSR: false,
+  includeCookiesForSSR: false,
   mixedMode: false,
   module: void 0,
   preloadModules: [],
   lwrVersion: import_package.lwrVersion,
-  lwcVersion: import_package.lwcVersion
+  lwcVersion: import_package.lwcVersion,
+  preloadResources: {
+    patterns: []
+  }
 };

package/build/cjs/global-config.cjs

@@ -170,6 +170,8 @@ function resolveGlobalConfig(configArg, options) {
   const span = (0, import_instrumentation.getTracer)().startSpan({name: import_instrumentation.ConfigSpan.ResolveConfig});
   const mergedConfig = mergeConfig(configArg);
   let normalizedConfig = normalizeConfig(mergedConfig);
+  if (normalizedConfig._isSsrCompilerEnabled)
+    process.env.SSR_COMPILER_ENABLED = "true";
   if (options?.useStaticProviders) {
     normalizedConfig = applyStaticProviderConfig(normalizedConfig);
   }

package/build/cjs/hooks.cjs

@@ -30,6 +30,7 @@ __export(exports, {
   executeStartHooks: () => executeStartHooks
 });
 var import_routes = __toModule(require("./utils/routes.cjs"));
+var import_assets = __toModule(require("./utils/assets.cjs"));
 var import_app_config = __toModule(require("./validation/app-config.cjs"));
 var import_instrumentation = __toModule(require("@lwrjs/instrumentation"));
 var import_defaults = __toModule(require("./defaults.cjs"));
@@ -89,14 +90,20 @@ function executeStartHooks(hooks, globalConfig, runtimeEnvironment, skipValidate
       continue;
     }
     const onStartConfig = {
+      _isSsrCompilerEnabled: globalConfig._isSsrCompilerEnabled,
       basePath: globalConfig.basePath,
+      coreProxy: globalConfig.coreProxy,
       i18n: globalConfig.i18n,
       routes: globalConfig.routes,
+      assets: globalConfig.assets,
       errorRoutes: globalConfig.errorRoutes
     };
     hook.onStart(onStartConfig);
     runtimeEnvironment.basePath = globalConfig.basePath = onStartConfig.basePath || "";
-    globalConfig.i18n = onStartConfig.i18n;
+    runtimeEnvironment.i18n = globalConfig.i18n = onStartConfig.i18n;
+    globalConfig.assets = (0, import_assets.normalizeAssetPaths)((0, import_assets.normalizeAssets)(onStartConfig.assets), globalConfig.rootDir);
+    globalConfig._isSsrCompilerEnabled = onStartConfig._isSsrCompilerEnabled;
+    globalConfig.coreProxy = onStartConfig.coreProxy;
     globalConfig.routes = onStartConfig.routes || [];
     globalConfig.errorRoutes = onStartConfig.errorRoutes || [];
   }
@@ -117,6 +124,8 @@ function executeStartHooks(hooks, globalConfig, runtimeEnvironment, skipValidate
   }
   globalConfig.routes = (0, import_routes.normalizeRoutes)(filteredRoutes, globalConfig.routeHandlers);
   globalConfig.errorRoutes = (0, import_routes.normalizeRoutes)(globalConfig.errorRoutes, globalConfig.routeHandlers);
+  if (globalConfig._isSsrCompilerEnabled)
+    process.env.SSR_COMPILER_ENABLED = "true";
   if (!skipValidate) {
     (0, import_app_config.validateLwrAppConfig)(globalConfig, "post");
   }

package/build/cjs/index.cjs

@@ -28,6 +28,8 @@ __export(exports, {
   DEFAULT_LWR_BOOTSTRAP_CONFIG: () => import_defaults.DEFAULT_LWR_BOOTSTRAP_CONFIG,
   LWC_VERSION: () => import_package.lwcVersion,
   LWR_VERSION: () => import_package.lwrVersion,
+  MIN_LWC_VERSION: () => import_defaults.MIN_LWC_VERSION,
+  MIN_LWR_VERSION: () => import_defaults.MIN_LWR_VERSION,
   NODE_VERSION: () => import_package.nodeVersion,
   PWA_KIT_RUNTIME_VERSION: () => import_package.pwaKitRuntimeVersion,
   getLwrConfigFromFile: () => import_global_config.getLwrConfigFromFile,

package/build/cjs/runtime-config.cjs

@@ -37,7 +37,8 @@ var DEFAULT_I18N_CONFIG = {
     {
       id: "en-US"
     }
-  ]
+  ],
+  defaultRedirectParams: {}
 };
 var RUNTIME_CONFIGS = {
   dev: {

package/build/cjs/validation/app-config-context.cjs

@@ -28,6 +28,7 @@ __export(exports, {
   ASSET_FILE_ATTRIBUTE_KEYS: () => ASSET_FILE_ATTRIBUTE_KEYS,
   BASE_PATH_REGEX: () => BASE_PATH_REGEX,
   BOOTSTRAP_ATTRIBUTE_KEYS: () => BOOTSTRAP_ATTRIBUTE_KEYS,
+  CORE_PROXY_ATTRIBUTE_KEYS: () => CORE_PROXY_ATTRIBUTE_KEYS,
   ERROR_ROUTE_ATTRIBUTE_KEYS: () => ERROR_ROUTE_ATTRIBUTE_KEYS,
   I18N_ATTRIBUTE_KEYS: () => I18N_ATTRIBUTE_KEYS,
   LOCKER_ATTRIBUTE_KEYS: () => LOCKER_ATTRIBUTE_KEYS,
@@ -52,7 +53,9 @@ var ROOT_ATTRIBUTE_KEYS = createKeys("root", [
   "bundleConfig",
   "bundleProviders",
   "cacheDir",
+  "caseSensitiveRoutes",
   "contentDir",
+  "coreProxy",
   "environment",
   "errorRoutes",
   "esmLoader",
@@ -62,6 +65,7 @@ var ROOT_ATTRIBUTE_KEYS = createKeys("root", [
   "hooks",
   "i18n",
   "ignoreLwrConfigFile",
+  "_isSsrCompilerEnabled",
   "lwrConfigFile",
   "layoutsDir",
   "locker",
@@ -79,12 +83,14 @@ var ROOT_ATTRIBUTE_KEYS = createKeys("root", [
   "serverType",
   "uriTransformers",
   "viewProviders",
-  "viewTransformers"
+  "viewTransformers",
+  "unsafeEnableViewLinkCaching"
 ]);
 var ASSET_DIR_ATTRIBUTE_KEYS = createKeys("assetDir", ["alias", "dir", "urlPath", "root"]);
 var ASSET_FILE_ATTRIBUTE_KEYS = createKeys("assetFile", ["alias", "file", "urlPath"]);
 var LOCKER_ATTRIBUTE_KEYS = createKeys("locker", ["enabled", "trustedComponents"]);
-var I18N_ATTRIBUTE_KEYS = createKeys("i18n", ["defaultLocale", "locales", "uriPattern"]);
+var I18N_ATTRIBUTE_KEYS = createKeys("i18n", ["defaultLocale", "locales", "uriPattern", "defaultRedirectParams"]);
+var CORE_PROXY_ATTRIBUTE_KEYS = createKeys("coreProxy", ["origin", "host", "servername"]);
 var STATIC_SITE_GENERATOR_ATTRIBUTE_KEYS = createKeys("staticSiteGenerator", [
   "outputDir",
   "skipBaseDocumentGeneration",
@@ -125,11 +131,14 @@ var BOOTSTRAP_ATTRIBUTE_KEYS = createKeys("bootstrap", [
   "configAsSrc",
   "ssr",
   "preloadData",
+  "proxyForSSR",
+  "includeCookiesForSSR",
   "mixedMode",
   "module",
   "preloadModules",
   "lwrVersion",
-  "lwcVersion"
+  "lwcVersion",
+  "preloadResources"
 ]);
 function isNotEmptyString(node) {
   return node.type === "string" && node.value.length > 0;
@@ -144,7 +153,7 @@ var ValidationContext = class {
     return (0, import_helpers.calculatePositionFromSource)(this.sourceText, node);
   }
   assertIsObject(node, property) {
-    if (node.type !== "object") {
+    if (node?.type !== "object" && node) {
       this.diagnostics.push({
         description: import_diagnostics.descriptions.CONFIG_PARSER.INCORRECT_NODE_TYPE(property, "object", node.type),
         location: this.getLocationFromNode(node)
@@ -175,6 +184,36 @@ var ValidationContext = class {
       });
     }
   }
+  assertIsFilePattern(node, property) {
+    if (node) {
+      const children = node.children || [];
+      for (const [index, child] of children.entries()) {
+        let matcher = (0, import_jsonc_parser.findNodeAtLocation)(child, ["match"])?.children?.map((val) => val.value) || (0, import_jsonc_parser.findNodeAtLocation)(child, ["match"])?.value;
+        if (!Array.isArray(matcher)) {
+          matcher = [matcher];
+        }
+        let misMatch = null;
+        for (let i = 0; i < matcher.length; i++) {
+          try {
+            if (matcher[i] === "")
+              throw new Error("Empty string is not a valid regex");
+            new RegExp(matcher[i]);
+          } catch (e) {
+            misMatch = matcher[i];
+            this.diagnostics.push({
+              description: import_diagnostics.descriptions.CONFIG_PARSER.INVALID_FILE_PATTERN(`${property}[${index}].match`, misMatch),
+              location: this.getLocationFromNode(node)
+            });
+          }
+          if (misMatch)
+            break;
+        }
+        if (misMatch !== null) {
+          break;
+        }
+      }
+    }
+  }
   assertIsPath(node, property) {
     if (node && (node.type !== "string" || node.value[0] !== "/")) {
       this.diagnostics.push({
@@ -183,6 +222,14 @@ var ValidationContext = class {
       });
     }
   }
+  assertIsOrigin(node, property) {
+    if (node && (node.type !== "string" || !/^https?:\/\//i.test(node.value))) {
+      this.diagnostics.push({
+        description: import_diagnostics.descriptions.CONFIG_PARSER.INVALID_ORIGIN(property, node.value),
+        location: this.getLocationFromNode(node)
+      });
+    }
+  }
   assertIsPort(node, property) {
     if (node && (node.type !== "number" || node.value < 0 || node.value > 65353)) {
       this.diagnostics.push({
@@ -248,7 +295,7 @@ var ValidationContext = class {
       });
     }
   }
-  assertIsBasePath(node, property) {
+  assertIsBasePath(node, property, allowSlash = false) {
     if (!node) {
       return;
     }
@@ -257,7 +304,7 @@ var ValidationContext = class {
         description: import_diagnostics.descriptions.CONFIG_PARSER.INCORRECT_NODE_TYPE(property, "string", node.type),
         location: this.getLocationFromNode(node)
       });
-    } else if (node.value === "") {
+    } else if (node.value === "" || allowSlash && node.value === "/") {
       return;
     } else if (node.value.match(BASE_PATH_REGEX) === null) {
       this.diagnostics.push({
@@ -515,4 +562,16 @@ var ValidationContext = class {
       });
     }
   }
+  assertIsCoreProxy(node, validationContext) {
+    if (node && node.type !== "null") {
+      validationContext.assertIsObject(node, "coreProxy");
+      validationContext.assertValidKeys(node, "coreProxy", CORE_PROXY_ATTRIBUTE_KEYS);
+      validationContext.assertRequiredKeys(node, "coreProxy", ["origin"]);
+      validationContext.assertNotEmptyString((0, import_jsonc_parser.findNodeAtLocation)(node, ["origin"]), "coreProxy.origin");
+      const host = (0, import_jsonc_parser.findNodeAtLocation)(node, ["host"]);
+      host && validationContext.assertNotEmptyString(host, "coreProxy.host");
+      const servername = (0, import_jsonc_parser.findNodeAtLocation)(node, ["servername"]);
+      servername && validationContext.assertNotEmptyString(servername, "coreProxy.servername");
+    }
+  }
 };

package/build/cjs/validation/app-config.cjs

@@ -48,6 +48,8 @@ function validateBootstrap(node, validationContext, propPrefix) {
     validationContext.assertIsBoolean((0, import_jsonc_parser.findNodeAtLocation)(node, ["autoBoot"]), `${propPrefix}.autoBoot`);
     validationContext.assertIsBoolean((0, import_jsonc_parser.findNodeAtLocation)(node, ["ssr"]), `${propPrefix}.ssr`);
     validationContext.assertIsBoolean((0, import_jsonc_parser.findNodeAtLocation)(node, ["preloadData"]), `${propPrefix}.preloadData`);
+    validationContext.assertIsBoolean((0, import_jsonc_parser.findNodeAtLocation)(node, ["proxyForSSR"]), `${propPrefix}.proxyForSSR`);
+    validationContext.assertIsBoolean((0, import_jsonc_parser.findNodeAtLocation)(node, ["includeCookiesForSSR"]), `${propPrefix}.includeCookiesForSSR`);
     validationContext.assertIsBoolean((0, import_jsonc_parser.findNodeAtLocation)(node, ["mixedMode"]), `${propPrefix}.mixedMode`);
     validationContext.assertIsBoolean((0, import_jsonc_parser.findNodeAtLocation)(node, ["configAsSrc"]), `${propPrefix}.configAsSrc`);
     validationContext.assertIsSpecifier((0, import_jsonc_parser.findNodeAtLocation)(node, ["module"]), `${propPrefix}.module`);
@@ -55,6 +57,7 @@ function validateBootstrap(node, validationContext, propPrefix) {
     validationContext.assertNotEmptyString((0, import_jsonc_parser.findNodeAtLocation)(node, ["lwrVersion"]), `${propPrefix}.lwrVersion`);
     validationContext.assertNotEmptyString((0, import_jsonc_parser.findNodeAtLocation)(node, ["lwcVersion"]), `${propPrefix}.lwcVersion`);
     validationContext.assertSsrPreloadData(node, propPrefix);
+    validationContext.assertIsFilePattern((0, import_jsonc_parser.findNodeAtLocation)(node, ["preloadResources", "patterns"]), `${propPrefix}.preloadResources.patterns`);
     const workers = (0, import_jsonc_parser.findNodeAtLocation)(node, ["workers"]);
     if (workers && workers.children) {
       workers.children.forEach((w, index) => {
@@ -114,6 +117,8 @@ function validateI18NConfig(node, validationContext, preMerge) {
     validationContext.assertNotEmptyString(defaultLocale, "i18n.defaultLocale");
     const localeIds = locales?.children?.map((n) => (0, import_jsonc_parser.findNodeAtLocation)(n, ["id"])?.value) || [];
     validationContext.assertDefaultInLocales(node, defaultLocale?.value, localeIds);
+    const defaultRedirectParams = (0, import_jsonc_parser.findNodeAtLocation)(node, ["defaultRedirectParams"]);
+    validationContext.assertIsObject(defaultRedirectParams, "i18n.defaultRedirectParams");
   }
 }
 function validateStaticSiteGeneratorConfig(node, validationContext) {
@@ -239,6 +244,7 @@ function validateRoot(node, validationContext, preMerge) {
   validationContext.assertUniqueIds([...routes?.children || [], ...errorRoutes?.children || []], "routes");
   const lockerNode = (0, import_jsonc_parser.findNodeAtLocation)(node, ["locker"]);
   const bundleConfigNode = (0, import_jsonc_parser.findNodeAtLocation)(node, ["bundleConfig"]);
+  validationContext.assertIsBoolean((0, import_jsonc_parser.findNodeAtLocation)(node, ["caseSensitiveRoutes"]), "caseSensitiveRoutes");
   validateRoutes(routes, validationContext, preMerge);
   validateErrorRoutes(errorRoutes, validationContext);
   validateRouteHandlers((0, import_jsonc_parser.findNodeAtLocation)(node, ["routeHandlers"]), validationContext);
@@ -268,6 +274,8 @@ function validateRoot(node, validationContext, preMerge) {
   validationContext.assertNotEmptyArray((0, import_jsonc_parser.findNodeAtLocation)(node, ["lwc", "modules"]), "lwc.modules");
   validationContext.assertIsEnvironment((0, import_jsonc_parser.findNodeAtLocation)(node, ["environment"]), "environment");
   validationContext.assertIsBasePath((0, import_jsonc_parser.findNodeAtLocation)(node, ["basePath"]), "basePath");
+  validationContext.assertIsCoreProxy((0, import_jsonc_parser.findNodeAtLocation)(node, ["coreProxy"]), validationContext);
+  validationContext.assertIsBoolean((0, import_jsonc_parser.findNodeAtLocation)(node, ["_isSsrCompilerEnabled"]), "_isSsrCompilerEnabled");
 }
 function validateLwrAppConfig(config, phase) {
   const span = (0, import_instrumentation.getTracer)().startSpan({name: import_instrumentation.ConfigSpan.ValidateConfig});

package/build/es/defaults.d.ts

@@ -1,4 +1,18 @@
 import type { BundleConfig, LwrGlobalConfig, LwrRoute, NormalizedLwrAppBootstrapConfig, StaticSiteGenerator } from '@lwrjs/types';
+/**
+ * MIN_LWR_VERSION
+ * Minimum LWR version required for the routes to function properly.
+ * Anytime we believe we are checking in a breaking change, the required version should be updated
+ * manually for all routes to continue functioning properly.
+ */
+export declare const MIN_LWR_VERSION = "0.12.0";
+/**
+ * MIN_LWC_VERSION
+ * Minimum LWC version required for the routes to function properly.
+ * Anytime we believe we are checking in a breaking change, the required version should be updated
+ * manually for all routes to continue functioning properly.
+ */
+export declare const MIN_LWC_VERSION = "6.1.0";
 export declare const DEFAULT_LWR_CONFIG_JSON = "$rootDir/lwr.config.json";
 export declare const DEFAULT_GENERATOR_CONFIG: StaticSiteGenerator;
 export declare const DEFAULT_ROOT_DIR: string;

package/build/es/defaults.js

@@ -1,6 +1,20 @@
 import { DEFAULT_LWR_LOCKER_CONFIG, getFeatureFlags } from '@lwrjs/shared-utils';
 import { DEFAULT_I18N_CONFIG, getServerModeConfig } from './runtime-config.js';
 import { lwrVersion as LWR_VERSION, lwcVersion as LWC_VERSION } from '@lwrjs/config/package';
+/**
+ * MIN_LWR_VERSION
+ * Minimum LWR version required for the routes to function properly.
+ * Anytime we believe we are checking in a breaking change, the required version should be updated
+ * manually for all routes to continue functioning properly.
+ */
+export const MIN_LWR_VERSION = '0.12.0';
+/**
+ * MIN_LWC_VERSION
+ * Minimum LWC version required for the routes to function properly.
+ * Anytime we believe we are checking in a breaking change, the required version should be updated
+ * manually for all routes to continue functioning properly.
+ */
+export const MIN_LWC_VERSION = '6.1.0';
 const PORT = process.env.PORT ? parseInt(process.env.PORT, 10) : 3000;
 const MODE = process.env.MODE || 'prod';
 const DEFAULT_BASE_PATH = '';
@@ -121,6 +135,7 @@ export const DEFAULT_LWR_CONFIG = {
     viewTransformers: DEFAULT_VIEW_TRANSFORM_PLUGINS,
     environment: {},
     lwc: { modules: [] },
+    caseSensitiveRoutes: false,
     routes: [
         LWR_INFO_ROUTE,
     ],
@@ -131,6 +146,9 @@ export const DEFAULT_LWR_CONFIG = {
     locker: DEFAULT_LWR_LOCKER_CONFIG,
     uriTransformers: DEFAULT_URI_TRANSFORM_PLUGINS,
     i18n: DEFAULT_I18N_CONFIG,
+    coreProxy: null,
+    unsafeEnableViewLinkCaching: false,
+    _isSsrCompilerEnabled: false,
 };
 export const DEFAULT_LWR_BOOTSTRAP_CONFIG = {
     autoBoot: true,
@@ -140,10 +158,15 @@ export const DEFAULT_LWR_BOOTSTRAP_CONFIG = {
     configAsSrc: false,
     ssr: false,
     preloadData: false,
+    proxyForSSR: false,
+    includeCookiesForSSR: false,
     mixedMode: false,
     module: undefined,
     preloadModules: [],
     lwrVersion: LWR_VERSION,
-    lwcVersion: LWC_VERSION
+    lwcVersion: LWC_VERSION,
+    preloadResources: {
+        patterns: []
+    },
 };
 //# sourceMappingURL=defaults.js.map

package/build/es/global-config.js

@@ -233,6 +233,11 @@ export function resolveGlobalConfig(configArg, options) {
     const span = getTracer().startSpan({ name: ConfigSpan.ResolveConfig });
     const mergedConfig = mergeConfig(configArg);
     let normalizedConfig = normalizeConfig(mergedConfig);
+    // TEMP: Add a feature flag to hold the app config value
+    // This is a temporary flag attached to a Core gate. Using an env var avoids the
+    // proliferation of function arguments to pass this flag around to dozens of places 
+    if (normalizedConfig._isSsrCompilerEnabled)
+        process.env.SSR_COMPILER_ENABLED = 'true';
     // Add static providers if applicable
     if (options?.useStaticProviders) {
         normalizedConfig = applyStaticProviderConfig(normalizedConfig);

package/build/es/hooks.d.ts

@@ -9,7 +9,8 @@ export declare function executeConfigHooks(hooks: HooksPlugin[], globalConfig: N
  * @privateRemarks
  * Changes to configurations are made by reference.
  *
- * These hooks can only modify the `routes` property in the global config.
+ * These hooks can modify the following global config properties:
+ *     routes, errorRoutes, assets, i18n, basePath, coreProxy, _isSsrCompilerEnabled
  *
  * @param hooks - hooks plugins
  * @param globalConfig - global configuration

package/build/es/hooks.js

@@ -1,4 +1,5 @@
 import { normalizeRoutes } from './utils/routes.js';
+import { normalizeAssets, normalizeAssetPaths } from './utils/assets.js';
 import { validateLwrAppConfig } from './validation/app-config.js';
 import { getTracer, ConfigSpan } from '@lwrjs/instrumentation';
 import { LWR_INFO_ROUTE } from './defaults.js';
@@ -74,7 +75,8 @@ export async function executeConfigHooks(hooks, globalConfig, runtimeEnvironment
  * @privateRemarks
  * Changes to configurations are made by reference.
  *
- * These hooks can only modify the `routes` property in the global config.
+ * These hooks can modify the following global config properties:
+ *     routes, errorRoutes, assets, i18n, basePath, coreProxy, _isSsrCompilerEnabled
  *
  * @param hooks - hooks plugins
  * @param globalConfig - global configuration
@@ -90,15 +92,21 @@ export function executeStartHooks(hooks, globalConfig, runtimeEnvironment, skipV
             continue;
         }
         const onStartConfig = {
+            _isSsrCompilerEnabled: globalConfig._isSsrCompilerEnabled,
             basePath: globalConfig.basePath,
+            coreProxy: globalConfig.coreProxy,
             i18n: globalConfig.i18n,
             routes: globalConfig.routes,
+            assets: globalConfig.assets,
             errorRoutes: globalConfig.errorRoutes,
         };
         hook.onStart(onStartConfig);
         // copy updated values back to the globalConfig
         runtimeEnvironment.basePath = globalConfig.basePath = onStartConfig.basePath || '';
-        globalConfig.i18n = onStartConfig.i18n;
+        runtimeEnvironment.i18n = globalConfig.i18n = onStartConfig.i18n;
+        globalConfig.assets = normalizeAssetPaths(normalizeAssets(onStartConfig.assets), globalConfig.rootDir);
+        globalConfig._isSsrCompilerEnabled = onStartConfig._isSsrCompilerEnabled;
+        globalConfig.coreProxy = onStartConfig.coreProxy;
         globalConfig.routes = (onStartConfig.routes || []);
         globalConfig.errorRoutes = (onStartConfig.errorRoutes || []);
     }
@@ -121,6 +129,11 @@ export function executeStartHooks(hooks, globalConfig, runtimeEnvironment, skipV
     }
     globalConfig.routes = normalizeRoutes(filteredRoutes, globalConfig.routeHandlers);
     globalConfig.errorRoutes = normalizeRoutes(globalConfig.errorRoutes, globalConfig.routeHandlers);
+    // TEMP: Add a feature flag to hold the app config value
+    // This is a temporary flag attached to a Core gate. Using an env var avoids the
+    // proliferation of function arguments to pass this flag around to dozens of places 
+    if (globalConfig._isSsrCompilerEnabled)
+        process.env.SSR_COMPILER_ENABLED = 'true';
     if (!skipValidate) {
         validateLwrAppConfig(globalConfig, 'post');
     }

package/build/es/index.d.ts

@@ -2,6 +2,6 @@ export { lwrVersion as LWR_VERSION, lwcVersion as LWC_VERSION, nodeVersion as NO
 export { loadConfig, resolveGlobalConfig as normalizeConfig, getLwrConfigFromFile } from './global-config.js';
 export { getRuntimeEnvironment, DEFAULT_I18N_CONFIG } from './runtime-config.js';
 export * from './hooks.js';
-export { DEFAULT_LWR_BOOTSTRAP_CONFIG } from './defaults.js';
+export { DEFAULT_LWR_BOOTSTRAP_CONFIG, MIN_LWR_VERSION, MIN_LWC_VERSION } from './defaults.js';
 export { validateLwrAppConfig } from './validation/app-config.js';
 //# sourceMappingURL=index.d.ts.map

package/build/es/index.js

@@ -2,6 +2,6 @@ export { lwrVersion as LWR_VERSION, lwcVersion as LWC_VERSION, nodeVersion as NO
 export { loadConfig, resolveGlobalConfig as normalizeConfig, getLwrConfigFromFile } from './global-config.js';
 export { getRuntimeEnvironment, DEFAULT_I18N_CONFIG } from './runtime-config.js';
 export * from './hooks.js';
-export { DEFAULT_LWR_BOOTSTRAP_CONFIG } from './defaults.js';
+export { DEFAULT_LWR_BOOTSTRAP_CONFIG, MIN_LWR_VERSION, MIN_LWC_VERSION } from './defaults.js';
 export { validateLwrAppConfig } from './validation/app-config.js';
 //# sourceMappingURL=index.js.map

package/build/es/runtime-config.js

@@ -7,6 +7,7 @@ export const DEFAULT_I18N_CONFIG = {
             id: 'en-US',
         },
     ],
+    defaultRedirectParams: {}
 };
 export const RUNTIME_CONFIGS = {
     dev: {

package/build/es/validation/app-config-context.d.ts

@@ -1,4 +1,4 @@
-import type { AssetDirConfig, AssetFileConfig, LwrErrorRoute, LwrRoute, NormalizedLwrGlobalConfig, NormalizedLwrAppBootstrapConfig, LwrLockerConfig, RouteHandlersConfig, BundleConfig, I18NConfig, Locale, StaticSiteGenerator } from '@lwrjs/types';
+import type { AssetDirConfig, AssetFileConfig, DirectToCoreProxy, LwrErrorRoute, LwrRoute, NormalizedLwrGlobalConfig, NormalizedLwrAppBootstrapConfig, LwrLockerConfig, RouteHandlersConfig, BundleConfig, I18NConfig, Locale, StaticSiteGenerator } from '@lwrjs/types';
 import { Node } from 'jsonc-parser';
 import { Diagnostic } from '@lwrjs/diagnostics';
 type RequiredAssetDirConfig = Required<AssetDirConfig>;
@@ -9,6 +9,7 @@ type RequiredLwrLockerConfig = Required<LwrLockerConfig>;
 type RequiredI18NConfig = Required<I18NConfig>;
 type RequiredLocalesConfig = Required<Locale>;
 type RequiredSSGConfig = Required<StaticSiteGenerator>;
+type RequiredDirectToCoreProxy = Required<DirectToCoreProxy>;
 interface ConfigMap {
     root: NormalizedLwrGlobalConfig;
     assetDir: RequiredAssetDirConfig;
@@ -24,34 +25,38 @@ interface ConfigMap {
     i18n: RequiredI18NConfig;
     'i18n.locales': RequiredLocalesConfig;
     staticSiteGenerator: RequiredSSGConfig;
+    coreProxy: RequiredDirectToCoreProxy;
 }
-export declare const ROOT_ATTRIBUTE_KEYS: ["amdLoader", "apiVersion", "assets", "assetProviders", "assetTransformers", "bundleConfig", "bundleProviders", "cacheDir", "contentDir", "environment", "errorRoutes", "esmLoader", "staticSiteGenerator", "globalData", "globalDataDir", "hooks", "i18n", "ignoreLwrConfigFile", "lwrConfigFile", "layoutsDir", "locker", "lwc", "lwrVersion", "moduleProviders", "port", "basePath", "resourceProviders", "rootDir", "routeHandlers", "routes", "serverMode", "minify", "serverType", "uriTransformers", "viewProviders", "viewTransformers"];
+export declare const ROOT_ATTRIBUTE_KEYS: ["amdLoader", "apiVersion", "assets", "assetProviders", "assetTransformers", "bundleConfig", "bundleProviders", "cacheDir", "caseSensitiveRoutes", "contentDir", "coreProxy", "environment", "errorRoutes", "esmLoader", "staticSiteGenerator", "globalData", "globalDataDir", "hooks", "i18n", "ignoreLwrConfigFile", "_isSsrCompilerEnabled", "lwrConfigFile", "layoutsDir", "locker", "lwc", "lwrVersion", "moduleProviders", "port", "basePath", "resourceProviders", "rootDir", "routeHandlers", "routes", "serverMode", "minify", "serverType", "uriTransformers", "viewProviders", "viewTransformers", "unsafeEnableViewLinkCaching"];
 export declare const ASSET_DIR_ATTRIBUTE_KEYS: ["alias", "dir", "urlPath", "root"];
 export declare const ASSET_FILE_ATTRIBUTE_KEYS: ["alias", "file", "urlPath"];
 export declare const LOCKER_ATTRIBUTE_KEYS: ["enabled", "trustedComponents"];
-export declare const I18N_ATTRIBUTE_KEYS: ["defaultLocale", "locales", "uriPattern"];
+export declare const I18N_ATTRIBUTE_KEYS: ["defaultLocale", "locales", "uriPattern", "defaultRedirectParams"];
+export declare const CORE_PROXY_ATTRIBUTE_KEYS: ["origin", "host", "servername"];
 export declare const STATIC_SITE_GENERATOR_ATTRIBUTE_KEYS: ["outputDir", "skipBaseDocumentGeneration", "skipCleanOutputDir", "_additionalModules", "_additionalRoutePaths"];
 export declare const ROUTE_ATTRIBUTE_KEYS: ["bootstrap", "subRoutes", "contentTemplate", "id", "cache", "layoutTemplate", "method", "path", "rootComponent", "routeHandler", "properties"];
 export declare const ERROR_ROUTE_ATTRIBUTE_KEYS: ["bootstrap", "subRoutes", "contentTemplate", "id", "layoutTemplate", "rootComponent", "routeHandler", "status", "properties", "cache"];
-export declare const BOOTSTRAP_ATTRIBUTE_KEYS: ["autoBoot", "syntheticShadow", "workers", "services", "configAsSrc", "ssr", "preloadData", "mixedMode", "module", "preloadModules", "lwrVersion", "lwcVersion"];
+export declare const BOOTSTRAP_ATTRIBUTE_KEYS: ["autoBoot", "syntheticShadow", "workers", "services", "configAsSrc", "ssr", "preloadData", "proxyForSSR", "includeCookiesForSSR", "mixedMode", "module", "preloadModules", "lwrVersion", "lwcVersion", "preloadResources"];
 export declare const BASE_PATH_REGEX: RegExp;
 export declare class ValidationContext {
     diagnostics: Diagnostic[];
     sourceText: string;
     constructor(sourceText: string);
     private getLocationFromNode;
-    assertIsObject<T extends keyof ConfigMap>(node: Node, property: T): void;
+    assertIsObject(node: Node | undefined, property: string): void;
     assertIsBoolean(node: Node | undefined, property: string): void;
     assertIsArray(node: Node | undefined, property: string): void;
     assertIsSpecifier(node: Node | undefined, property: string): void;
+    assertIsFilePattern(node: Node | undefined, property: string): void;
     assertIsPath(node: Node | undefined, property: string): void;
+    assertIsOrigin(node: Node | undefined, property: string): void;
     assertIsPort(node: Node | undefined, property: string): void;
     assertIsServerType(node: Node | undefined, property: string): void;
     assertIsStaticSiteGenerator(node: Node | undefined, property: string): void;
     assertIsMethod(node: Node | undefined, property: string): void;
     assertIsStatus(node: Node | undefined, property: string): void;
     assertIsEnvironment(node: Node | undefined, property: string): void;
-    assertIsBasePath(node: Node | undefined, property: string): void;
+    assertIsBasePath(node: Node | undefined, property: string, allowSlash?: boolean): void;
     assertNotEmptyString(node: Node | undefined, property: string): void;
     assertNotEmptyArray(node: Node | undefined, property: string): void;
     assertHasOneOrMore(node: Node, property: string, childProps: string[]): void;
@@ -69,6 +74,7 @@ export declare class ValidationContext {
     assertDefaultInLocales(node: Node, defaultLocale: string, localesIds: string[]): void;
     assertFallbackIds(nodes: Node[]): void;
     assertSsrPreloadData(node: Node, propPrefix: string): void;
+    assertIsCoreProxy(node: Node | undefined, validationContext: ValidationContext): void;
 }
 export {};
 //# sourceMappingURL=app-config-context.d.ts.map

package/build/es/validation/app-config-context.js

@@ -16,7 +16,9 @@ export const ROOT_ATTRIBUTE_KEYS = createKeys('root', [
     'bundleConfig',
     'bundleProviders',
     'cacheDir',
+    'caseSensitiveRoutes',
     'contentDir',
+    'coreProxy',
     'environment',
     'errorRoutes',
     'esmLoader',
@@ -26,6 +28,7 @@ export const ROOT_ATTRIBUTE_KEYS = createKeys('root', [
     'hooks',
     'i18n',
     'ignoreLwrConfigFile',
+    '_isSsrCompilerEnabled',
     'lwrConfigFile',
     'layoutsDir',
     'locker',
@@ -44,11 +47,13 @@ export const ROOT_ATTRIBUTE_KEYS = createKeys('root', [
     'uriTransformers',
     'viewProviders',
     'viewTransformers',
+    'unsafeEnableViewLinkCaching',
 ]);
 export const ASSET_DIR_ATTRIBUTE_KEYS = createKeys('assetDir', ['alias', 'dir', 'urlPath', 'root']);
 export const ASSET_FILE_ATTRIBUTE_KEYS = createKeys('assetFile', ['alias', 'file', 'urlPath']);
 export const LOCKER_ATTRIBUTE_KEYS = createKeys('locker', ['enabled', 'trustedComponents']);
-export const I18N_ATTRIBUTE_KEYS = createKeys('i18n', ['defaultLocale', 'locales', 'uriPattern']);
+export const I18N_ATTRIBUTE_KEYS = createKeys('i18n', ['defaultLocale', 'locales', 'uriPattern', 'defaultRedirectParams']);
+export const CORE_PROXY_ATTRIBUTE_KEYS = createKeys('coreProxy', ['origin', 'host', 'servername']);
 export const STATIC_SITE_GENERATOR_ATTRIBUTE_KEYS = createKeys('staticSiteGenerator', [
     'outputDir',
     'skipBaseDocumentGeneration',
@@ -89,11 +94,14 @@ export const BOOTSTRAP_ATTRIBUTE_KEYS = createKeys('bootstrap', [
     'configAsSrc',
     'ssr',
     'preloadData',
+    'proxyForSSR',
+    'includeCookiesForSSR',
     'mixedMode',
     'module',
     'preloadModules',
     'lwrVersion',
-    'lwcVersion'
+    'lwcVersion',
+    'preloadResources'
 ]);
 function isNotEmptyString(node) {
     return node.type === 'string' && node.value.length > 0;
@@ -108,7 +116,7 @@ export class ValidationContext {
         return calculatePositionFromSource(this.sourceText, node);
     }
     assertIsObject(node, property) {
-        if (node.type !== 'object') {
+        if (node?.type !== 'object' && node) {
             this.diagnostics.push({
                 description: descriptions.CONFIG_PARSER.INCORRECT_NODE_TYPE(property, 'object', node.type),
                 location: this.getLocationFromNode(node),
@@ -139,6 +147,39 @@ export class ValidationContext {
             });
         }
     }
+    assertIsFilePattern(node, property) {
+        if (node) {
+            const children = node.children || [];
+            for (const [index, child] of children.entries()) {
+                let matcher = findNodeAtLocation(child, ['match'])?.children?.map(val => val.value) || findNodeAtLocation(child, ['match'])?.value;
+                if (!Array.isArray(matcher)) {
+                    matcher = [matcher];
+                }
+                let misMatch = null;
+                for (let i = 0; i < matcher.length; i++) {
+                    try {
+                        if (matcher[i] === '')
+                            throw new Error('Empty string is not a valid regex');
+                        // match is a regex set as string, the below line would throw an error if the backslashes are not escaped
+                        // eg: Regex /^.*\.css(?:\?.*)?$/ should be "^.*\\.css(?:\\?.*)?$"
+                        new RegExp(matcher[i]);
+                    }
+                    catch (e) {
+                        misMatch = matcher[i];
+                        this.diagnostics.push({
+                            description: descriptions.CONFIG_PARSER.INVALID_FILE_PATTERN(`${property}[${index}].match`, misMatch),
+                            location: this.getLocationFromNode(node)
+                        });
+                    }
+                    if (misMatch)
+                        break;
+                }
+                if (misMatch !== null) {
+                    break;
+                }
+            }
+        }
+    }
     assertIsPath(node, property) {
         if (node && (node.type !== 'string' || node.value[0] !== '/')) {
             this.diagnostics.push({
@@ -147,6 +188,14 @@ export class ValidationContext {
             });
         }
     }
+    assertIsOrigin(node, property) {
+        if (node && (node.type !== 'string' || !/^https?:\/\//i.test(node.value))) {
+            this.diagnostics.push({
+                description: descriptions.CONFIG_PARSER.INVALID_ORIGIN(property, node.value),
+                location: this.getLocationFromNode(node),
+            });
+        }
+    }
     assertIsPort(node, property) {
         if (node && (node.type !== 'number' || node.value < 0 || node.value > 65353)) {
             this.diagnostics.push({
@@ -212,7 +261,7 @@ export class ValidationContext {
             });
         }
     }
-    assertIsBasePath(node, property) {
+    assertIsBasePath(node, property, allowSlash = false) {
         if (!node) {
             return;
         }
@@ -222,7 +271,7 @@ export class ValidationContext {
                 location: this.getLocationFromNode(node),
             });
         }
-        else if (node.value === '') {
+        else if (node.value === '' || allowSlash && node.value === '/') {
             return;
         }
         else if (node.value.match(BASE_PATH_REGEX) === null) {
@@ -502,5 +551,17 @@ export class ValidationContext {
             });
         }
     }
+    assertIsCoreProxy(node, validationContext) {
+        if (node && node.type !== 'null') {
+            validationContext.assertIsObject(node, 'coreProxy');
+            validationContext.assertValidKeys(node, 'coreProxy', CORE_PROXY_ATTRIBUTE_KEYS);
+            validationContext.assertRequiredKeys(node, 'coreProxy', ['origin']);
+            validationContext.assertNotEmptyString(findNodeAtLocation(node, ['origin']), 'coreProxy.origin');
+            const host = findNodeAtLocation(node, ['host']);
+            host && validationContext.assertNotEmptyString(host, 'coreProxy.host');
+            const servername = findNodeAtLocation(node, ['servername']);
+            servername && validationContext.assertNotEmptyString(servername, 'coreProxy.servername');
+        }
+    }
 }
 //# sourceMappingURL=app-config-context.js.map

package/build/es/validation/app-config.js

@@ -17,10 +17,12 @@ export const SOURCE_BY_PHASE = {
  *      - syntheticShadow: optional boolean
  *      - workers: optional map of string:specifier pairs
  *      - ssr: optional boolean
+ *      - proxyForSSR: optional boolean
  *      - configAsSrc: optional boolean to include the client bootstrap config as src via in-lined
  *      - module: optional string specifier
  *      - lwrVersion: optional string version
  *      - lwcVersion: optional string version
+ *      - preloadResources: optional object
  */
 function validateBootstrap(node, validationContext, propPrefix) {
     if (node) {
@@ -31,6 +33,8 @@ function validateBootstrap(node, validationContext, propPrefix) {
         validationContext.assertIsBoolean(findNode(node, ['autoBoot']), `${propPrefix}.autoBoot`);
         validationContext.assertIsBoolean(findNode(node, ['ssr']), `${propPrefix}.ssr`);
         validationContext.assertIsBoolean(findNode(node, ['preloadData']), `${propPrefix}.preloadData`);
+        validationContext.assertIsBoolean(findNode(node, ['proxyForSSR']), `${propPrefix}.proxyForSSR`);
+        validationContext.assertIsBoolean(findNode(node, ['includeCookiesForSSR']), `${propPrefix}.includeCookiesForSSR`);
         validationContext.assertIsBoolean(findNode(node, ['mixedMode']), `${propPrefix}.mixedMode`);
         validationContext.assertIsBoolean(findNode(node, ['configAsSrc']), `${propPrefix}.configAsSrc`);
         validationContext.assertIsSpecifier(findNode(node, ['module']), `${propPrefix}.module`);
@@ -38,6 +42,7 @@ function validateBootstrap(node, validationContext, propPrefix) {
         validationContext.assertNotEmptyString(findNode(node, ['lwrVersion']), `${propPrefix}.lwrVersion`);
         validationContext.assertNotEmptyString(findNode(node, ['lwcVersion']), `${propPrefix}.lwcVersion`);
         validationContext.assertSsrPreloadData(node, propPrefix);
+        validationContext.assertIsFilePattern(findNode(node, ['preloadResources', 'patterns']), `${propPrefix}.preloadResources.patterns`);
         // Each value in the worker map msut be a specifier
         const workers = findNode(node, ['workers']);
         if (workers && workers.children) {
@@ -126,6 +131,8 @@ function validateI18NConfig(node, validationContext, preMerge) {
         validationContext.assertNotEmptyString(defaultLocale, 'i18n.defaultLocale');
         const localeIds = locales?.children?.map((n) => findNode(n, ['id'])?.value) || [];
         validationContext.assertDefaultInLocales(node, defaultLocale?.value, localeIds);
+        const defaultRedirectParams = findNode(node, ['defaultRedirectParams']);
+        validationContext.assertIsObject(defaultRedirectParams, 'i18n.defaultRedirectParams');
     }
 }
 function validateStaticSiteGeneratorConfig(node, validationContext) {
@@ -306,6 +313,7 @@ function validateRoot(node, validationContext, preMerge) {
     validationContext.assertUniqueIds([...(routes?.children || []), ...(errorRoutes?.children || [])], 'routes');
     const lockerNode = findNode(node, ['locker']);
     const bundleConfigNode = findNode(node, ['bundleConfig']);
+    validationContext.assertIsBoolean(findNode(node, ['caseSensitiveRoutes']), 'caseSensitiveRoutes');
     validateRoutes(routes, validationContext, preMerge);
     validateErrorRoutes(errorRoutes, validationContext);
     validateRouteHandlers(findNode(node, ['routeHandlers']), validationContext);
@@ -335,6 +343,8 @@ function validateRoot(node, validationContext, preMerge) {
     validationContext.assertNotEmptyArray(findNode(node, ['lwc', 'modules']), 'lwc.modules');
     validationContext.assertIsEnvironment(findNode(node, ['environment']), 'environment');
     validationContext.assertIsBasePath(findNode(node, ['basePath']), 'basePath');
+    validationContext.assertIsCoreProxy(findNode(node, ['coreProxy']), validationContext);
+    validationContext.assertIsBoolean(findNode(node, ['_isSsrCompilerEnabled']), '_isSsrCompilerEnabled');
 }
 export function validateLwrAppConfig(config, phase) {
     const span = getTracer().startSpan({ name: ConfigSpan.ValidateConfig });

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",
@@ -42,22 +42,22 @@
         "test": "jest"
     },
     "dependencies": {
-        "@lwrjs/diagnostics": "0.15.0-alpha.9",
-        "@lwrjs/instrumentation": "0.15.0-alpha.9",
-        "@lwrjs/shared-utils": "0.15.0-alpha.9",
+        "@lwrjs/diagnostics": "0.15.0",
+        "@lwrjs/instrumentation": "0.15.0",
+        "@lwrjs/shared-utils": "0.15.0",
         "fs-extra": "^11.2.0",
         "jsonc-parser": "^3.3.1"
     },
     "devDependencies": {
-        "@lwrjs/types": "0.15.0-alpha.9",
+        "@lwrjs/types": "0.15.0",
         "jest": "^26.6.3",
-        "memfs": "^4.9.3",
+        "memfs": "^4.13.0",
         "ts-jest": "^26.5.6"
     },
     "peerDependencies": {
         "@lwc/engine-dom": ">= 2.x",
         "@lwc/synthetic-shadow": ">= 2.x",
-        "@lwrjs/esbuild": "0.13.x || >= 0.13.0-alpha",
+        "@lwrjs/esbuild": "0.15.x || >= 0.15.0-alpha",
         "lwc": ">= 2.x"
     },
     "peerDependenciesMeta": {
@@ -71,5 +71,5 @@
     "volta": {
         "extends": "../../../package.json"
     },
-    "gitHead": "9783b817b11c29ca385457683fcb87e8179f7902"
+    "gitHead": "ee374df435d5342f63e4da126a09461e761837f3"
 }