Add .browserslistrc and update docs around browser support

.browserslistrc

@@ -0,0 +1,3 @@
+last 2 versions
+not dead
+not ie 11 # Despite this, IE 11 is currently supported but we do not include Promise polyfills

build/postinstall.js

@@ -14,6 +14,17 @@ if (parseInt(process.env.BEACHBALL)) {
         }
     });
 } else {
+    // Update caniuse browser db to ensure we're using up to date browserlist
+    exec("lerna exec \"npx browserslist@latest --update-db\"", function (error, stdout, stderr) {
+        if (stdout) {
+            console.log('browserslist update stdout: ' + stdout);
+        }
+        console.error('browserslist update stderr: ' + stderr);
+        if (error !== null) {
+             console.log('browserslist update exec error: ' + error);
+        }
+    });
+
     console.log("Running full bootstrap");
     exec("lerna bootstrap", function (error, stdout, stderr) {
         if (stdout) {

change/@azure-msal-angular-2e12d930-c34b-4d2d-aa4c-39dd3b8bd911.json

@@ -0,0 +1,7 @@
+{
+  "type": "prerelease",
+  "comment": "Add .browserslistrc #3471",
+  "packageName": "@azure/msal-angular",
+  "email": "[email protected]",
+  "dependentChangeType": "patch"
+}

change/@azure-msal-browser-33fd34e0-87ff-4c9a-bd8b-d0448fdc3879.json

@@ -0,0 +1,7 @@
+{
+  "type": "patch",
+  "comment": "Add .browserslistrc #3471",
+  "packageName": "@azure/msal-browser",
+  "email": "[email protected]",
+  "dependentChangeType": "patch"
+}

change/@azure-msal-common-24da2d35-5703-44f7-b53b-e058f8f7bfcf.json

@@ -0,0 +1,7 @@
+{
+  "type": "patch",
+  "comment": "Add .browserslistrc #3471",
+  "packageName": "@azure/msal-common",
+  "email": "[email protected]",
+  "dependentChangeType": "patch"
+}

change/@azure-msal-node-ab2eb101-155f-4639-8692-1a46315cc992.json

@@ -0,0 +1,7 @@
+{
+  "type": "patch",
+  "comment": "Add .browserslistrc #3471",
+  "packageName": "@azure/msal-node",
+  "email": "[email protected]",
+  "dependentChangeType": "patch"
+}

change/@azure-msal-react-1a039856-c01a-48ea-9c6e-cdf92ce3d40e.json

@@ -0,0 +1,7 @@
+{
+  "type": "prerelease",
+  "comment": "Add .browserslistrc #3471",
+  "packageName": "@azure/msal-react",
+  "email": "[email protected]",
+  "dependentChangeType": "patch"
+}

change/msal-2a7f03ed-2068-4a29-ac78-e8da746418b2.json

@@ -0,0 +1,7 @@
+{
+  "type": "patch",
+  "comment": "Add .browserslistrc #3471",
+  "packageName": "msal",
+  "email": "[email protected]",
+  "dependentChangeType": "patch"
+}

lerna.json

@@ -15,10 +15,11 @@
     "exec": {
         "scope": [
             "msal",
-            "@azure/msal-angularjs",
             "@azure/msal-browser",
             "@azure/msal-common",
-            "@azure/msal-node"
+            "@azure/msal-node",
+            "@azure/msal-react",
+            "@azure/msal-angular"
         ],
         "stream": true
     }

lib/msal-angular/docs/FAQ.md

@@ -3,6 +3,7 @@
 ***
 **[Compatibility](#compatibility)**
 
+1. [What browsers are supported?](#what-browsers-are-supported)
 1. [What versions of Angular are supported?](#what-versions-of-angular-are-supported)
 1. [Does `@azure/msal-angular` support Server Side Rendering?](#does-azuremsal-angular-support-server-side-rendering)
 1. [Can `@azure/msal-angular` be used with Internet Explorer?](#can-azuremsal-angular-be-used-with-internet-explorer)
@@ -28,6 +29,10 @@
 
 ## Compatibility
 
+### What browsers are supported?
+
+Please see [here](https://github.com/AzureAD/microsoft-authentication-library-for-js/blob/dev/lib/msal-browser/FAQ.md#what-browsers-are-supported-by-msaljs) for supported browsers.
+
 ### What versions of Angular are supported?
 
 Msal Angular currently supports Angular 9, 10, and 11.

lib/msal-angular/package.json

@@ -63,5 +63,6 @@
   "resolutions": {
     "ini": "^1.3.6",
     "object-path": "0.11.5"
-  }
+  },
+  "dependencies": {}
 }

lib/msal-browser/FAQ.md

@@ -59,15 +59,34 @@
 
 ## What browsers are supported by MSAL.js?
 
-MSAL.js has been tested with the following browsers:
+MSAL.js has been tested and supports the last 2 stable and supported versions of the following browsers:
 
-IE 11, Edge, Chrome, Firefox and Safari
+- Chrome
+- Edge (Chromium)
+- Firefox
+- Safari
+- Opera
 
-Keep these steps in mind when [using MSAL.js with IE](https://github.com/AzureAD/microsoft-authentication-library-for-js/wiki/Using-msal.js-with-Internet-Explorer).
+MSAL.js has also been tested and supports the following browsers with Promise polyfills (not included):
 
-There are certain known issues and mitigations documented for Safari, IE and Edge. Please check out:
-* [Known issues on IE and Edge](https://github.com/AzureAD/microsoft-authentication-library-for-js/wiki/Known-issues-on-IE-and-Edge-Browser)
-* [Known issue on Safari](https://github.com/AzureAD/microsoft-authentication-library-for-js/wiki/Known-issue-on-Safari)
+- IE 11
+- Edge (Legacy)
+
+Keep [these steps](./docs/internet-explorer.md) in mind when using MSAL.js with IE or Edge Legacy. Support for these browsers will be dropped in the next major version of `@azure/msal-browser` (v3).
+
+MSAL.js also supports the following environments:
+
+- WebViews
+- Chromium Extensions
+- Office Add-ins
+- Teams Applications
+
+### Known Issues with Certain Browsers
+
+There are certain known issues and mitigations documented for the following browsers:
+
+- [Browsers that block 3rd Party Cookies (i.e. Safari, Chrome Incognito, Firefox Private)](https://docs.microsoft.com/azure/active-directory/develop/reference-third-party-cookies-spas)
+- [IE 11 and Edge Legacy](./docs/internet-explorer.md)
 
 ## I am moving from MSAL.js 1.x to MSAL.js to 2.x. What should I know?