Pre-Release (next) - MSAL v4 Upgrade

[odinr]

🎯 Overview

This pre-release introduces a major upgrade from MSAL v2 to MSAL v4 with full backward compatibility. The upgrade addresses security improvements, performance enhancements, and provides access to the latest Microsoft authentication features.

🚀 Getting Started with the Pre-Release

To upgrade to the MSAL v4 pre-release, run:

pnpm upgrade "@equinor/fusion-framework*@next"

This will upgrade all Fusion Framework packages to their pre-release versions tagged with next.

🔥 Key Highlights

• MSAL v4 Upgrade: Major version bump to @equinor/[email protected]
• Backward Compatible: All existing MSAL v2 API calls continue to work unchanged
• Enhanced Security: Latest MSAL v4 security improvements and vulnerability fixes
• Improved Performance: Faster token acquisition and caching
• Telemetry Integration: Optional provider-level telemetry for MSAL flows
• 21 Packages Updated: Comprehensive framework-wide compatibility updates

📦 What's Changed

• Major: @equinor/[email protected] - MSAL v4 upgrade
• Minor: @equinor/[email protected] - API format updates
• Minor: @equinor/[email protected] - Measurement exports
• Patch: 21 packages updated with compatibility fixes

📋 All Pre-Release Packages

The following 21 packages are available in this pre-release:

Core Framework

• @equinor/[email protected]
• @equinor/[email protected]
• @equinor/[email protected]
• @equinor/[email protected]
• @equinor/[email protected]
• @equinor/[email protected]

Framework Modules

• @equinor/[email protected]
• @equinor/[email protected] ⭐ (Major upgrade)
• @equinor/[email protected] ⭐
• @equinor/[email protected]
• @equinor/[email protected]
• @equinor/[email protected] ⭐
• @equinor/[email protected]

React Packages

• @equinor/[email protected]
• @equinor/[email protected]
• @equinor/[email protected]
• @equinor/[email protected]
• @equinor/[email protected]
• @equinor/[email protected]
• @equinor/[email protected]

Vite Plugins

• @equinor/[email protected]

---

Note: Packages marked with ⭐ have notable version changes in this pre-release.

⚠️ Breaking Changes

For Internal API (not consumer-facing):

• acquireAccessToken(options) → acquireAccessToken(options: AcquireTokenOptionsLegacy)
• acquireToken(options) → acquireToken(options: AcquireTokenOptionsLegacy)
• logout(options?) → logout(options?): Promise<boolean> (now returns boolean)
• handleRedirect() → handleRedirect(): Promise<AuthenticationResult | null> (now returns result)
• Added initialize(): Promise<void> method

No breaking changes for existing consumer code - All current MSAL v2 API calls continue to work exactly as before.

🚀 Migration Guide

Current code works unchanged:

// Framework configuration still works exactly the same
const framework = await createFramework({
  modules: [enableMSAL()],
});

// Provider usage remains unchanged
const token = await framework.modules.auth.acquireToken({
  scopes: [\"User.Read\"],
});

New v4 features available:

// Enhanced configuration with new options
const framework = await createFramework({
  modules: [enableMSAL()],
});

// Improved token acquisition with MSAL v4 request structure
const token = await framework.modules.auth.acquireToken({
  request: { scopes: [\"User.Read\"] },
  behavior: \"popup\",
  silent: true,
});

🐛 Bug Fixes & Improvements

• Fixed MSAL v4 compatibility issues in React app hooks
• Updated HTTP module to use new MSAL token acquisition API format
• Fixed SignalR module compatibility with MSAL v4
• Updated CLI auth commands to use new MSAL Node API format
• Fixed legacy interopt compatibility with MSAL v4

📚 Documentation Updates

• Improved all cookbook README documentation for better developer experience
• Reorganized MSAL v4 authentication documentation structure
• Added cookbook examples for MSAL authentication
• Updated navigation sidebar to reflect new documentation structure

🔗 Related Links

• Full Changelog
• Issue #3621 - MSAL v4 Upgrade
• Issue #3634 - Telemetry Integration

🙏 Acknowledgments

Thanks to all contributors for this major release!

---

🤖 Beep Bopp – Release notes created by Fusion Assistant!