@equinor/fusion-framework-vite-plugin-spa 1.1.4 → 1.2.1

package/CHANGELOG.md

@@ -1,5 +1,47 @@
 # @equinor/fusion-framework-vite-plugin-spa
 
+## 1.2.1
+
+### Patch Changes
+
+- [#3579](https://github.com/equinor/fusion-framework/pull/3579) [`b6a64d9`](https://github.com/equinor/fusion-framework/commit/b6a64d94bad7248c06b3aa7d65d7d698052437c7) Thanks [@Noggling](https://github.com/Noggling)! - Add peer dependencies to SPA Vite plugin
+
+  Added peer dependencies to ensure proper dependency resolution for the SPA Vite plugin. This change declares the Fusion Framework modules that the plugin expects to be available in the consuming application:
+
+  - `@equinor/fusion-framework-module`
+  - `@equinor/fusion-framework-module-http`
+  - `@equinor/fusion-framework-module-msal`
+  - `@equinor/fusion-framework-module-service-discovery`
+  - `@equinor/fusion-framework-module-telemetry`
+
+  This ensures that consumers are aware of the required dependencies and helps prevent runtime errors due to missing modules.
+
+## 1.2.0
+
+### Minor Changes
+
+- [#3547](https://github.com/equinor/fusion-framework/pull/3547) [`99a3c26`](https://github.com/equinor/fusion-framework/commit/99a3c26275c2089c3708124f5819ce383d8dc3dc) Thanks [@odinr](https://github.com/odinr)! - Enhanced SPA plugin with portal proxy support for testing apps in real portal environments ([Issue #3546](https://github.com/equinor/fusion-framework/issues/3546)).
+
+  - Added `proxy` option to portal configuration to enable `/portal-proxy` routing
+  - Added `FUSION_SPA_PORTAL_PROXY` environment variable support
+  - Updated TypeScript types to include portal proxy configuration
+  - Updated documentation with portal proxy usage examples
+
+  This feature enables developers to load real portal implementations instead of the default developer portal, supporting configuration of portal ID and version tags for targeted testing scenarios.
+
+  **Migration:**
+  No migration required - the `proxy` option defaults to `false`, maintaining existing behavior.
+
+  **Example usage:**
+
+  ```ts
+  portal: {
+    id: 'my-portal',
+    tag: 'latest',
+    proxy: true, // Routes through /portal-proxy/
+  }
+  ```
+
 ## 1.1.4
 
 ### Patch Changes

package/README.md

@@ -116,6 +116,7 @@ fusionSpaPlugin({
       //   2. An ID from the Fusion Portal Service
       //   3. Any other configured portal ID
       tag: 'latest', // (Optional) Version tag (defaults to 'latest')
+      proxy: false, // (Optional) Whether to proxy portal requests through /portal-proxy (defaults to false)
     },
 
     // Service Discovery configuration
@@ -145,6 +146,36 @@ fusionSpaPlugin({
   })
 });
 ```
+
+### Portal Proxy
+
+The portal proxy feature allows you to route portal entry point requests through a `/portal-proxy` path prefix. When enabled, the plugin will attempt to load portal code from URLs prefixed with `/portal-proxy/`, which can be useful when working with proxy servers or development environments that need to intercept and route portal requests.
+
+**Behavior:**
+
+- `proxy: true` → Portal loads from `/portal-proxy/{assetPath}/{templateEntry}` (allows proxy interception)
+- `proxy: false` → Portal loads from `{assetPath}/{templateEntry}` (direct loading)
+
+**Configuration Options:**
+
+- `proxy`: When set to `true`, portal entry points will be prefixed with `/portal-proxy`
+
+**When to Use Portal Proxy:**
+
+- Development environments where portal assets need to be served through a proxy
+- Deployment scenarios requiring portal routing through specific paths
+- When working with the API Service Plugin for advanced portal loading
+
+**Example:**
+
+```ts
+portal: {
+  id: 'my-portal',
+  tag: 'latest',
+  proxy: true, // Portal will be loaded from /portal-proxy/{assetPath}/{templateEntry}
+}
+```
+
 See [@equinor/fusion-framework-vite-plugin-api-service](https://github.com/equinor/fusion-framework/tree/main/packages/vite-plugins/api-service) for advanced API proxying.
 
 ### Service Discovery
@@ -330,6 +361,8 @@ import.meta.env.FUSION_SPA_SERVICE_WORKER_RESOURCES
 # Application basics
 FUSION_SPA_TITLE=My App
 FUSION_SPA_PORTAL_ID=my-portal  # Can be a package name, Fusion Portal Service ID, or any configured portal ID
+FUSION_SPA_PORTAL_TAG=latest    # (Optional) Version tag (defaults to 'latest')
+FUSION_SPA_PORTAL_PROXY=false   # (Optional) Whether to proxy portal requests through /portal-proxy (defaults to false)
 
 # Service Discovery configuration
 FUSION_SPA_SERVICE_DISCOVERY_URL=https://my-server.com/service-discovery

package/dist/esm/html/bootstrap.js

@@ -84,6 +84,7 @@ enableTelemetry(configurator, {
     // fetch the portal manifest - this is used to load the portal template
     const portalId = import.meta.env.FUSION_SPA_PORTAL_ID;
     const portalTag = import.meta.env.FUSION_SPA_PORTAL_TAG ?? 'latest';
+    const portalProxy = import.meta.env.FUSION_SPA_PORTAL_PROXY ?? false;
     const portal_manifest = await measurement
         .clone()
         .resolve(portalClient.json(`/portals/${portalId}@${portalTag}`), {
@@ -115,7 +116,11 @@ enableTelemetry(configurator, {
     const el = document.createElement('div');
     document.body.innerHTML = '';
     document.body.appendChild(el);
-    const portalEntryPoint = [portal_manifest.build.assetPath, portal_manifest.build.templateEntry]
+    const portalEntryPoint = [
+        portalProxy ? '/portal-proxy' : '',
+        portal_manifest.build.assetPath,
+        portal_manifest.build.templateEntry,
+    ]
         .filter(Boolean)
         .join('/');
     // @todo: should test if the entrypoint is external or internal

package/dist/esm/html/bootstrap.js.map

@@ -1 +1 @@
-{"version":3,"file":"bootstrap.js","sourceRoot":"","sources":["../../../src/html/bootstrap.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,kCAAkC,CAAC;AAEvE,OAAO,EAAE,mBAAmB,EAAmB,MAAM,uCAAuC,CAAC;AAC7F,OAAO,EAAE,UAAU,EAAmB,MAAM,uCAAuC,CAAC;AACpF,OAAO,EACL,sBAAsB,GAEvB,MAAM,oDAAoD,CAAC;AAE5D,OAAO,EACL,eAAe,EACf,cAAc,GAEf,MAAM,4CAA4C,CAAC;AACpD,OAAO,EAAE,cAAc,EAAE,MAAM,4DAA4D,CAAC;AAE5F,OAAO,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAC;AAErE,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAWxC,oCAAoC;AACpC,MAAM,iBAAiB,GAAG,CAAI,IAAY,EAAc,EAAE,CAAC,MAAM,CAAC,kBAAkB,CAAC,IAAI,CAAC,CAAC;AAE3F,uCAAuC;AACvC,MAAM,YAAY,GAAG,IAAI,mBAAmB,EAAE,CAAC;AAE/C,MAAM,mBAAmB,GAAG,IAAI,GAAG,CACjC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,gCAAgC,EAChD,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,gCAAgC,CAAC,UAAU,CAAC,MAAM,CAAC;IACjE,CAAC,CAAC,SAAS;IACX,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAC3B,CAAC;AAEF,iFAAiF;AACjF,YAAY,CAAC,SAAS,CACpB,mBAAmB,CAAC,mBAAmB,EAAE;IACvC,OAAO,EAAE,MAAM,CAAC,mBAAmB,CAAC;IACpC,aAAa,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,mCAAmC;CACnE,CAAC,CACH,CAAC;AAEF,uEAAuE;AACvE,sBAAsB,CAAC,YAAY,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE;IACrD,OAAO,CAAC,0CAA0C,CAAC,mBAAmB,CAAC,CAAC;AAC1E,CAAC,CAAC,CAAC;AAEH,uBAAuB;AACvB,UAAU,CAAC,YAAY,EAAE,CAAC,OAAO,EAAE,EAAE;IACnC,OAAO,CAAC,eAAe,CAAC;QACtB,QAAQ,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,yBAAyB;QACnD,QAAQ,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,yBAAyB;QACnD,WAAW,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,4BAA4B;KAC1D,CAAC,CAAC;IAEH,OAAO,CAAC,eAAe,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,6BAA6B,CAAC,CAAC,CAAC;AAClF,CAAC,CAAC,CAAC;AAEH,eAAe,CAAC,YAAY,EAAE;IAC5B,wBAAwB,EAAE,IAAI;IAC9B,SAAS,EAAE,CAAC,OAAO,EAAE,EAAE;QACrB,MAAM,YAAY,GAAG,MAAM,CACzB,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,kCAAkC,IAAI,cAAc,CAAC,WAAW,CACjF,CAAC;QAEF,IAAI,MAAM,CAAC,KAAK,CAAC,YAAY,CAAC,EAAE,CAAC;YAC/B,gEAAgE;YAChE,OAAO,CAAC,UAAU,CAAC,IAAI,cAAc,EAAE,CAAC,CAAC;QAC3C,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,UAAU,CAChB,IAAI,cAAc,CAAC;gBACjB,MAAM,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,IAAI,YAAY;aAC7C,CAAC,CACH,CAAC;QACJ,CAAC;QACD,OAAO,CAAC,WAAW,CAAC,CAAC,EAAE,OAAO,EAAE,EAAE,EAAE;YAClC,MAAM,QAAQ,GAAG;gBACf,MAAM,EAAE;oBACN,GAAG,EAAE;wBACH,OAAO;qBACR;iBACF;gBACD,kGAAkG;aAC5E,CAAC;YACzB,IAAI,OAAO,EAAE,IAAI,EAAE,CAAC;gBAClB,QAAQ,CAAC,MAAM,CAAC,IAAI,GAAG;oBACrB,EAAE,EAAE,OAAO,CAAC,IAAI,CAAC,cAAc,EAAE,aAAa;oBAC9C,IAAI,EAAE,OAAO,CAAC,IAAI,CAAC,cAAc,EAAE,IAAI;oBACvC,KAAK,EAAE,OAAO,CAAC,IAAI,CAAC,cAAc,EAAE,QAAQ;iBAC7C,CAAC;YACJ,CAAC;YACD,OAAO,QAAQ,CAAC;QAClB,CAAC,CAAC,CAAC;IACL,CAAC;CACF,CAAC,CAAC;AAEH,CAAC,KAAK,IAAI,EAAE;IACV,+FAA+F;IAC/F,MAAM,GAAG,GACP,MAAM,YAAY,CAAC,UAAU,EAE1B,CAAC;IAEN,MAAM,SAAS,GAAG,GAAG,CAAC,SAAS,CAAC;IAEhC,wFAAwF;IACxF,MAAM,WAAW,GAAG,SAAS,CAAC,OAAO,CAAC;QACpC,IAAI,EAAE,WAAW;QACjB,KAAK,EAAE,cAAc,CAAC,WAAW;KAClC,CAAC,CAAC;IAEH,MAAM,WAAW,CAAC,KAAK,EAAE,CAAC,OAAO,CAAC,qBAAqB,CAAC,GAAG,CAAC,EAAE;QAC5D,IAAI,EAAE;YACJ,KAAK,EAAE,cAAc,CAAC,KAAK;YAC3B,IAAI,EAAE,kCAAkC;SACzC;KACF,CAAC,CAAC;IAEH,qFAAqF;IACrF,MAAM,YAAY,GAAG,MAAM,GAAG,CAAC,gBAAgB,CAAC,YAAY,CAAC,eAAe,CAAC,CAAC;IAE9E,uEAAuE;IACvE,MAAM,QAAQ,GAAG,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,oBAAoB,CAAC;IACtD,MAAM,SAAS,GAAG,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,qBAAqB,IAAI,QAAQ,CAAC;IACpE,MAAM,eAAe,GAAG,MAAM,WAAW;SACtC,KAAK,EAAE;SACP,OAAO,CAAC,YAAY,CAAC,IAAI,CAAiB,YAAY,QAAQ,IAAI,SAAS,EAAE,CAAC,EAAE;QAC/E,IAAI,EAAE,CAAC,QAAwB,EAAE,EAAE,CAAC,CAAC;YACnC,IAAI,EAAE,+BAA+B;YACrC,KAAK,EAAE,cAAc,CAAC,KAAK;YAC3B,UAAU,EAAE;gBACV,QAAQ;gBACR,SAAS;gBACT,aAAa,EAAE,QAAQ,CAAC,KAAK,CAAC,aAAa;gBAC3C,eAAe,EAAE,QAAQ,CAAC,KAAK,CAAC,MAAM,EAAE,OAAO;gBAC/C,SAAS,EAAE,QAAQ,CAAC,KAAK,CAAC,SAAS;aACpC;SACF,CAAC;KACH,CAAC,CAAC;IAEL,MAAM,aAAa,GAAG,MAAM,WAAW;SACpC,KAAK,EAAE;SACP,OAAO,CAAC,YAAY,CAAC,IAAI,CAAC,YAAY,QAAQ,IAAI,SAAS,SAAS,CAAC,EAAE;QACtE,IAAI,EAAE;YACJ,IAAI,EAAE,6BAA6B;YACnC,KAAK,EAAE,cAAc,CAAC,KAAK;YAC3B,UAAU,EAAE;gBACV,QAAQ;gBACR,SAAS;aACV;SACF;KACF,CAAC,CAAC;IAEL,yEAAyE;IACzE,MAAM,EAAE,GAAG,QAAQ,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC;IACzC,QAAQ,CAAC,IAAI,CAAC,SAAS,GAAG,EAAE,CAAC;IAC7B,QAAQ,CAAC,IAAI,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC;IAE9B,MAAM,gBAAgB,GAAG,CAAC,eAAe,CAAC,KAAK,CAAC,SAAS,EAAE,eAAe,CAAC,KAAK,CAAC,aAAa,CAAC;SAC5F,MAAM,CAAC,OAAO,CAAC;SACf,IAAI,CAAC,GAAG,CAAC,CAAC;IAEb,+DAA+D;IAC/D,gCAAgC;IAChC,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,WAAW;SACjC,KAAK,EAAE;SACP,OAAO,CACN,iBAAiB,CAAoD,gBAAgB,CAAC,EACtF;QACE,IAAI,EAAE;YACJ,IAAI,EAAE,iCAAiC;YACvC,KAAK,EAAE,cAAc,CAAC,KAAK;YAC3B,UAAU,EAAE;gBACV,QAAQ;gBACR,SAAS;gBACT,UAAU,EAAE,gBAAgB;aAC7B;SACF;KACF,CACF,CAAC;IAEJ,uEAAuE;IACvE,MAAM,CAAC,EAAE,EAAE,EAAE,GAAG,EAAE,QAAQ,EAAE,eAAe,EAAE,MAAM,EAAE,aAAa,EAAE,CAAC,CAAC;AACxE,CAAC,CAAC,EAAE,CAAC"}
+{"version":3,"file":"bootstrap.js","sourceRoot":"","sources":["../../../src/html/bootstrap.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,kCAAkC,CAAC;AAEvE,OAAO,EAAE,mBAAmB,EAAmB,MAAM,uCAAuC,CAAC;AAC7F,OAAO,EAAE,UAAU,EAAmB,MAAM,uCAAuC,CAAC;AACpF,OAAO,EACL,sBAAsB,GAEvB,MAAM,oDAAoD,CAAC;AAE5D,OAAO,EACL,eAAe,EACf,cAAc,GAEf,MAAM,4CAA4C,CAAC;AACpD,OAAO,EAAE,cAAc,EAAE,MAAM,4DAA4D,CAAC;AAE5F,OAAO,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAC;AAErE,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAWxC,oCAAoC;AACpC,MAAM,iBAAiB,GAAG,CAAI,IAAY,EAAc,EAAE,CAAC,MAAM,CAAC,kBAAkB,CAAC,IAAI,CAAC,CAAC;AAE3F,uCAAuC;AACvC,MAAM,YAAY,GAAG,IAAI,mBAAmB,EAAE,CAAC;AAE/C,MAAM,mBAAmB,GAAG,IAAI,GAAG,CACjC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,gCAAgC,EAChD,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,gCAAgC,CAAC,UAAU,CAAC,MAAM,CAAC;IACjE,CAAC,CAAC,SAAS;IACX,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAC3B,CAAC;AAEF,iFAAiF;AACjF,YAAY,CAAC,SAAS,CACpB,mBAAmB,CAAC,mBAAmB,EAAE;IACvC,OAAO,EAAE,MAAM,CAAC,mBAAmB,CAAC;IACpC,aAAa,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,mCAAmC;CACnE,CAAC,CACH,CAAC;AAEF,uEAAuE;AACvE,sBAAsB,CAAC,YAAY,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE;IACrD,OAAO,CAAC,0CAA0C,CAAC,mBAAmB,CAAC,CAAC;AAC1E,CAAC,CAAC,CAAC;AAEH,uBAAuB;AACvB,UAAU,CAAC,YAAY,EAAE,CAAC,OAAO,EAAE,EAAE;IACnC,OAAO,CAAC,eAAe,CAAC;QACtB,QAAQ,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,yBAAyB;QACnD,QAAQ,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,yBAAyB;QACnD,WAAW,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,4BAA4B;KAC1D,CAAC,CAAC;IAEH,OAAO,CAAC,eAAe,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,6BAA6B,CAAC,CAAC,CAAC;AAClF,CAAC,CAAC,CAAC;AAEH,eAAe,CAAC,YAAY,EAAE;IAC5B,wBAAwB,EAAE,IAAI;IAC9B,SAAS,EAAE,CAAC,OAAO,EAAE,EAAE;QACrB,MAAM,YAAY,GAAG,MAAM,CACzB,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,kCAAkC,IAAI,cAAc,CAAC,WAAW,CACjF,CAAC;QAEF,IAAI,MAAM,CAAC,KAAK,CAAC,YAAY,CAAC,EAAE,CAAC;YAC/B,gEAAgE;YAChE,OAAO,CAAC,UAAU,CAAC,IAAI,cAAc,EAAE,CAAC,CAAC;QAC3C,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,UAAU,CAChB,IAAI,cAAc,CAAC;gBACjB,MAAM,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,IAAI,YAAY;aAC7C,CAAC,CACH,CAAC;QACJ,CAAC;QACD,OAAO,CAAC,WAAW,CAAC,CAAC,EAAE,OAAO,EAAE,EAAE,EAAE;YAClC,MAAM,QAAQ,GAAG;gBACf,MAAM,EAAE;oBACN,GAAG,EAAE;wBACH,OAAO;qBACR;iBACF;gBACD,kGAAkG;aAC5E,CAAC;YACzB,IAAI,OAAO,EAAE,IAAI,EAAE,CAAC;gBAClB,QAAQ,CAAC,MAAM,CAAC,IAAI,GAAG;oBACrB,EAAE,EAAE,OAAO,CAAC,IAAI,CAAC,cAAc,EAAE,aAAa;oBAC9C,IAAI,EAAE,OAAO,CAAC,IAAI,CAAC,cAAc,EAAE,IAAI;oBACvC,KAAK,EAAE,OAAO,CAAC,IAAI,CAAC,cAAc,EAAE,QAAQ;iBAC7C,CAAC;YACJ,CAAC;YACD,OAAO,QAAQ,CAAC;QAClB,CAAC,CAAC,CAAC;IACL,CAAC;CACF,CAAC,CAAC;AAEH,CAAC,KAAK,IAAI,EAAE;IACV,+FAA+F;IAC/F,MAAM,GAAG,GACP,MAAM,YAAY,CAAC,UAAU,EAE1B,CAAC;IAEN,MAAM,SAAS,GAAG,GAAG,CAAC,SAAS,CAAC;IAEhC,wFAAwF;IACxF,MAAM,WAAW,GAAG,SAAS,CAAC,OAAO,CAAC;QACpC,IAAI,EAAE,WAAW;QACjB,KAAK,EAAE,cAAc,CAAC,WAAW;KAClC,CAAC,CAAC;IAEH,MAAM,WAAW,CAAC,KAAK,EAAE,CAAC,OAAO,CAAC,qBAAqB,CAAC,GAAG,CAAC,EAAE;QAC5D,IAAI,EAAE;YACJ,KAAK,EAAE,cAAc,CAAC,KAAK;YAC3B,IAAI,EAAE,kCAAkC;SACzC;KACF,CAAC,CAAC;IAEH,qFAAqF;IACrF,MAAM,YAAY,GAAG,MAAM,GAAG,CAAC,gBAAgB,CAAC,YAAY,CAAC,eAAe,CAAC,CAAC;IAE9E,uEAAuE;IACvE,MAAM,QAAQ,GAAG,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,oBAAoB,CAAC;IACtD,MAAM,SAAS,GAAG,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,qBAAqB,IAAI,QAAQ,CAAC;IACpE,MAAM,WAAW,GAAG,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,uBAAuB,IAAI,KAAK,CAAC;IACrE,MAAM,eAAe,GAAG,MAAM,WAAW;SACtC,KAAK,EAAE;SACP,OAAO,CAAC,YAAY,CAAC,IAAI,CAAiB,YAAY,QAAQ,IAAI,SAAS,EAAE,CAAC,EAAE;QAC/E,IAAI,EAAE,CAAC,QAAwB,EAAE,EAAE,CAAC,CAAC;YACnC,IAAI,EAAE,+BAA+B;YACrC,KAAK,EAAE,cAAc,CAAC,KAAK;YAC3B,UAAU,EAAE;gBACV,QAAQ;gBACR,SAAS;gBACT,aAAa,EAAE,QAAQ,CAAC,KAAK,CAAC,aAAa;gBAC3C,eAAe,EAAE,QAAQ,CAAC,KAAK,CAAC,MAAM,EAAE,OAAO;gBAC/C,SAAS,EAAE,QAAQ,CAAC,KAAK,CAAC,SAAS;aACpC;SACF,CAAC;KACH,CAAC,CAAC;IAEL,MAAM,aAAa,GAAG,MAAM,WAAW;SACpC,KAAK,EAAE;SACP,OAAO,CAAC,YAAY,CAAC,IAAI,CAAC,YAAY,QAAQ,IAAI,SAAS,SAAS,CAAC,EAAE;QACtE,IAAI,EAAE;YACJ,IAAI,EAAE,6BAA6B;YACnC,KAAK,EAAE,cAAc,CAAC,KAAK;YAC3B,UAAU,EAAE;gBACV,QAAQ;gBACR,SAAS;aACV;SACF;KACF,CAAC,CAAC;IAEL,yEAAyE;IACzE,MAAM,EAAE,GAAG,QAAQ,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC;IACzC,QAAQ,CAAC,IAAI,CAAC,SAAS,GAAG,EAAE,CAAC;IAC7B,QAAQ,CAAC,IAAI,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC;IAE9B,MAAM,gBAAgB,GAAG;QACvB,WAAW,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,EAAE;QAClC,eAAe,CAAC,KAAK,CAAC,SAAS;QAC/B,eAAe,CAAC,KAAK,CAAC,aAAa;KACpC;SACE,MAAM,CAAC,OAAO,CAAC;SACf,IAAI,CAAC,GAAG,CAAC,CAAC;IAEb,+DAA+D;IAC/D,gCAAgC;IAChC,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,WAAW;SACjC,KAAK,EAAE;SACP,OAAO,CACN,iBAAiB,CAAoD,gBAAgB,CAAC,EACtF;QACE,IAAI,EAAE;YACJ,IAAI,EAAE,iCAAiC;YACvC,KAAK,EAAE,cAAc,CAAC,KAAK;YAC3B,UAAU,EAAE;gBACV,QAAQ;gBACR,SAAS;gBACT,UAAU,EAAE,gBAAgB;aAC7B;SACF;KACF,CACF,CAAC;IAEJ,uEAAuE;IACvE,MAAM,CAAC,EAAE,EAAE,EAAE,GAAG,EAAE,QAAQ,EAAE,eAAe,EAAE,MAAM,EAAE,aAAa,EAAE,CAAC,CAAC;AACxE,CAAC,CAAC,EAAE,CAAC"}

package/dist/esm/version.js

@@ -1,3 +1,3 @@
 // Generated by genversion.
-export const version = '1.1.4';
+export const version = '1.2.1';
 //# sourceMappingURL=version.js.map

package/dist/html/bootstrap.js

@@ -19962,7 +19962,7 @@ const configureHttpClient = (name, args) => ({
 var MsalModuleVersion;
 (function (MsalModuleVersion) {
     MsalModuleVersion["V2"] = "v2";
-    MsalModuleVersion["Latest"] = "5.0.1";
+    MsalModuleVersion["Latest"] = "5.1.0";
 })(MsalModuleVersion || (MsalModuleVersion = {}));
 
 const VersionSchema = z.string().transform((x) => String(semver.coerce(x)));
@@ -38198,84 +38198,6 @@ class ConsoleLogger extends Logger {
     };
 }
 
-var VersionMessageType;
-(function (VersionMessageType) {
-    VersionMessageType["MajorIncompatibility"] = "major-incompatibility";
-    VersionMessageType["MinorMismatch"] = "minor-mismatch";
-    VersionMessageType["PatchDifference"] = "patch-difference";
-    VersionMessageType["InvalidVersion"] = "invalid-version";
-    VersionMessageType["InvalidLatestVersion"] = "invalid-latest-version";
-    VersionMessageType["IncompatibleVersion"] = "incompatible-version";
-})(VersionMessageType || (VersionMessageType = {}));
-
-/**
- * Creates a human-readable version message based on the version message type.
- *
- * This function generates descriptive error messages for different version compatibility
- * scenarios, helping developers understand version-related issues.
- *
- * @param type - The type of version message to create
- * @param requestedVersion - The version that was requested by the user
- * @param latestVersion - The latest available version in the system
- * @returns A formatted, human-readable version message string
- *
- * @example
- * ```typescript
- * const message = createVersionMessage(
- *   VersionMessageType.MajorIncompatibility,
- *   '3.0.0',
- *   '2.1.0'
- * );
- * // Returns: "Requested major version 3.0.0 is greater than the latest major version 2.1.0"
- * ```
- *
- * @example
- * ```typescript
- * const message = createVersionMessage(
- *   VersionMessageType.MinorMismatch,
- *   '2.1.0',
- *   '2.2.0'
- * );
- * // Returns: "Minor version mismatch, requested 2.1.0, latest 2.2.0"
- * ```
- */
-const createVersionMessage = (type, requestedVersion, latestVersion) => {
-    // Convert versions to strings for consistent formatting
-    const requestedVersionString = String(requestedVersion);
-    const latestVersionString = String(latestVersion);
-    switch (type) {
-        case VersionMessageType.MajorIncompatibility:
-            return `Requested major version ${requestedVersionString} is greater than the latest major version ${latestVersionString}`;
-        case VersionMessageType.InvalidVersion:
-            return `Invalid version ${requestedVersionString}`;
-        case VersionMessageType.InvalidLatestVersion:
-            return `Failed to parse latest version "${latestVersionString}" - this indicates the version.ts file was not generated correctly. Check for import errors in the build process.`;
-        case VersionMessageType.MinorMismatch:
-            return `Minor version mismatch, requested ${requestedVersionString}, latest ${latestVersionString}`;
-        case VersionMessageType.PatchDifference:
-            return `Patch version difference, requested ${requestedVersionString}, latest ${latestVersionString}`;
-        case VersionMessageType.IncompatibleVersion:
-            return `Incompatible version, requested ${requestedVersionString}, latest ${latestVersionString}`;
-        default:
-            return createVersionMessage(VersionMessageType.IncompatibleVersion, requestedVersion, latestVersion);
-    }
-};
-
-/**
- * Creates a VersionError instance with a formatted message.
- *
- * This is a helper function that creates a VersionError with a human-readable
- * message based on the error type and version information.
- *
- * @param type - The type of version error
- * @param requestedVersion - The version that was requested
- * @param latestVersion - The latest available version
- * @param options - Additional error options including the error type
- * @returns A new VersionError instance with formatted message
- */
-const createVersionError = (type, requestedVersion, latestVersion, options) => {
-    return new VersionError(createVersionMessage(type, requestedVersion, latestVersion), requestedVersion, latestVersion, { ...options, type });
-};
 /**
  * Error class for version-related issues in the MSAL module.
  *
@@ -38311,14 +38233,8 @@ class VersionError extends Error {
     requestedVersion;
     /** The latest available version in the system */
     latestVersion;
-    /** The specific type of version error that occurred */
-    type;
     /** The error name for instanceof checks */
     static Name = 'VersionError';
-    /** Reference to the VersionMessageType enum for convenience */
-    static Type = VersionMessageType;
-    /** Factory method for creating VersionError instances with formatted messages */
-    static create = createVersionError;
     /**
      * Creates a new VersionError instance.
      *
@@ -38333,7 +38249,6 @@ class VersionError extends Error {
         // Store versions as strings
         this.requestedVersion = String(requestedVersion);
         this.latestVersion = String(latestVersion);
-        this.type = options?.type;
     }
 }
 
@@ -38382,35 +38297,41 @@ function resolveVersion(version) {
     // Parse the requested version, defaulting to latest if not provided
     const versionString = version || MsalModuleVersion.Latest;
     // Parse versions using coerce for backward compatibility
-    const wantedVersion = semver.coerce(versionString);
     const latestVersion = semver.coerce(MsalModuleVersion.Latest);
-    // Validate that the requested version is a valid semver
-    if (!wantedVersion) {
-        throw VersionError.create(VersionError.Type.InvalidVersion, versionString, MsalModuleVersion.Latest);
-    }
     // This should never happen! Indicates version.ts was not generated correctly
     // This is a critical build-time issue that needs immediate attention
     if (!latestVersion) {
-        throw VersionError.create(VersionError.Type.InvalidLatestVersion, versionString, MsalModuleVersion.Latest);
+        throw new VersionError(`Failed to parse latest version "${MsalModuleVersion.Latest}" - this indicates the version.ts file was not generated correctly. Check for import errors in the build process.`, versionString, MsalModuleVersion.Latest);
     }
-    // Major version incompatibility check - this is a hard error
-    // Users cannot request a major version that doesn't exist yet
-    if (wantedVersion.major > latestVersion.major) {
-        throw VersionError.create(VersionError.Type.MajorIncompatibility, String(wantedVersion), String(latestVersion));
+    let wantedVersion = semver.coerce(versionString);
+    // Validate that the requested version is a valid semver
+    if (!wantedVersion) {
+        const missingVersionWarning = new VersionError(`Failed to parse requested version "${versionString}"`, versionString, MsalModuleVersion.Latest);
+        warnings.push(missingVersionWarning.message);
+        wantedVersion = latestVersion;
+    }
+    if (wantedVersion.major < latestVersion.major) {
+        const majorBehindVersionWarning = new VersionError(`Requested major version ${wantedVersion.major} is behind the latest major version ${latestVersion.major}`, wantedVersion, latestVersion);
+        warnings.push(majorBehindVersionWarning.message);
     }
     // Minor version mismatch - add warning but don't throw
     // This helps developers stay aware of version differences without breaking functionality
     if (wantedVersion.major === latestVersion.major && wantedVersion.minor !== latestVersion.minor) {
-        const minorMismatchWarning = VersionError.create(VersionError.Type.MinorMismatch, String(wantedVersion), String(latestVersion));
+        const minorMismatchWarning = new VersionError(`Requested minor version ${wantedVersion.minor} is different from the latest minor version ${latestVersion.minor}`, wantedVersion, latestVersion);
         warnings.push(minorMismatchWarning.message);
     }
     // Find the corresponding enum version for the requested major version
     // This is used for module configuration and feature detection
-    const enumVersion = Object.values(MsalModuleVersion).find((x) => semver.coerce(x)?.major === wantedVersion.major);
-    // If no matching enum version is found, this indicates a major version
-    // that doesn't have a corresponding enum value defined
+    let enumVersion = Object.values(MsalModuleVersion).find((x) => semver.coerce(x)?.major === wantedVersion.major);
+    // If no matching enum version is found, fall back to the latest available
+    // This allows forward compatibility with future versions
     if (!enumVersion) {
-        throw VersionError.create(VersionError.Type.MajorIncompatibility, String(wantedVersion), String(latestVersion));
+        enumVersion = MsalModuleVersion.Latest;
+        // Only warn if this is a future version (higher than latest)
+        if (wantedVersion.major > latestVersion.major) {
+            const fallbackWarning = new VersionError(`Requested major version ${wantedVersion.major} is greater than the latest major version ${latestVersion.major}. Falling back to latest version.`, wantedVersion, latestVersion);
+            warnings.push(fallbackWarning.message);
+        }
     }
     // Return comprehensive version resolution result
     return {
@@ -38429,12 +38350,8 @@ class AuthProvider {
     get version() {
         return new SemanticVersion(MsalModuleVersion.Latest);
     }
-    /** @deprecated */
-    get defaultClient() {
-        return this.getClient();
-    }
     get defaultAccount() {
-        return this.defaultClient.account;
+        return this.client.account;
     }
     /** @deprecated */
     get defaultConfig() {
@@ -38444,8 +38361,7 @@ class AuthProvider {
         this._config = _config;
         this.#client = this.createClient();
     }
-    /** @deprecated */
-    getClient() {
+    get client() {
         return this.#client;
     }
     /** @deprecated */
@@ -38458,10 +38374,9 @@ class AuthProvider {
     async handleRedirect() {
         const { redirectUri } = this.defaultConfig || {};
         if (window.location.pathname === redirectUri) {
-            const client = this.defaultClient;
-            const logger = client.getLogger();
-            const { requestOrigin } = client;
-            await client.handleRedirectPromise();
+            const logger = this.client.getLogger();
+            const { requestOrigin } = this.client;
+            await this.client.handleRedirectPromise();
             if (requestOrigin === redirectUri) {
                 logger.warning(`detected callback loop from url ${redirectUri}, redirecting to root`);
                 window.location.replace('/');
@@ -38473,7 +38388,7 @@ class AuthProvider {
         return null;
     }
     acquireToken(req) {
-        return this.defaultClient.acquireToken(req);
+        return this.client.acquireToken(req);
     }
     async acquireAccessToken(req) {
         const token = await this.acquireToken(req);
@@ -38481,14 +38396,14 @@ class AuthProvider {
     }
     async login(options) {
         // skip login if already logged in and has valid claims
-        if (options?.onlyIfRequired && this.defaultClient.hasValidClaims) {
+        if (options?.onlyIfRequired && this.client.hasValidClaims) {
             return;
         }
-        await this.defaultClient.login();
+        await this.client.login();
     }
     async logout(options) {
         // TODO - might have an option for popup or redirect
-        await this.defaultClient.logoutRedirect({
+        await this.client.logoutRedirect({
             postLogoutRedirectUri: options?.redirectUri,
             account: this.defaultAccount,
         });
@@ -38510,6 +38425,12 @@ class AuthProvider {
                 switch (prop) {
                     case 'version':
                         return target.version;
+                    case 'client':
+                        return target.client;
+                    // @ts-expect-error - this is deprecated since version 5.0.1
+                    case 'defaultClient':
+                        console.warn('defaultClient is deprecated, use client instead');
+                        return target.client;
                     case 'defaultAccount':
                         return target.defaultAccount;
                     case 'defaultConfig':
@@ -45382,7 +45303,7 @@ async function registerServiceWorker(framework) {
 }
 
 // Generated by genversion.
-const version = '1.1.4';
+const version = '1.2.1';
 
 // Allow dynamic import without vite
 const importWithoutVite = (path) => import(/* @vite-ignore */ path);
@@ -45462,6 +45383,7 @@ enableTelemetry(configurator, {
     // fetch the portal manifest - this is used to load the portal template
     const portalId = import.meta.env.FUSION_SPA_PORTAL_ID;
     const portalTag = import.meta.env.FUSION_SPA_PORTAL_TAG ?? 'latest';
+    const portalProxy = import.meta.env.FUSION_SPA_PORTAL_PROXY ?? false;
     const portal_manifest = await measurement
         .clone()
         .resolve(portalClient.json(`/portals/${portalId}@${portalTag}`), {
@@ -45493,7 +45415,11 @@ enableTelemetry(configurator, {
     const el = document.createElement('div');
     document.body.innerHTML = '';
     document.body.appendChild(el);
-    const portalEntryPoint = [portal_manifest.build.assetPath, portal_manifest.build.templateEntry]
+    const portalEntryPoint = [
+        portalProxy ? '/portal-proxy' : '',
+        portal_manifest.build.assetPath,
+        portal_manifest.build.templateEntry,
+    ]
         .filter(Boolean)
         .join('/');
     // @todo: should test if the entrypoint is external or internal