Skip to content

Commit c892e00

Browse files
authored
changed paths, graphclienterror, slicefile deprecation (#443)
1 parent 5dd013a commit c892e00

1 file changed

Lines changed: 30 additions & 6 deletions

File tree

changelogs/v3-upgrade-guide.md

Lines changed: 30 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -28,9 +28,28 @@
2828
}
2929
```
3030
## Removed the `graph-es-sdk.js`
31-
* `graph-es-sdk.js` - the bundled file in ES format will not be shipped anymore as the ES modules are being shipped.
32-
* `graph-js-sdk.js` will be shipped as is.
31+
- `graph-es-sdk.js` - the bundled file in ES format will not be shipped anymore as the ES modules are being shipped.
32+
- `graph-js-sdk.js` will be shipped as is.
3333

34+
## Changed folder paths
35+
- Files in `lib/es` have been moved to `lib/es/src`. The `lib` folder contains the transpiled `src` files.
36+
- The `lib` contains the ES and CJS modules as follows:
37+
```
38+
lib
39+
40+
└─── src (CJS modules)
41+
|
42+
43+
└─── es
44+
|___ src (ES modules)
45+
```
46+
- `Range`: `src/Range` changed to `src/tasks/FileUploadTask/Range`.
47+
- `ImplicitMSALAuthenticationProvider`:
48+
- `src/ImplicitMSALAuthenticationProvider` changed to `src/authentication/msal/ImplicitMSALAuthenticationProvider`.
49+
- Alternatively, `ImplicitMSALAuthenticationProvider` can be imported or required from `@microsoft/microsoft-graph-client/authProviders/msal`.
50+
- `MSALAuthenticationProviderOptions`:
51+
- `src/MSALAuthenticationProviderOptions` changed to `src/authentication/msal/MSALAuthenticationProviderOptions`.
52+
- Alternatively, `MSALAuthenticationProviderOptions` can be imported or required from `@microsoft/microsoft-graph-client/authProviders/msal`.
3453
## Enhancements
3554

3655
### Introducing support for `@azure/identity TokenCredentials`
@@ -47,11 +66,16 @@
4766
### Added `browser` field in package.json.
4867
- The `browser` field indicates the entry point for client applications using Microsoft Graph JS SDK library.
4968

69+
### Added `GraphClientError`
70+
- `GraphClientError` handles client-side errors encountered within the JavaScript Client SDK whereas, `GraphError` class should be used to handle errors in the response from the Graph API.
71+
5072
## Deprecation
5173

5274
### Deprecating `ImplicitMSALAuthenticationProvider`
53-
* Use of `ImplicitMSALAuthenticationProvider`, that is,using the implicit authorization flow is not recommended any more. [OAuth 2.0 Implicit Grant](https://oauth.net/2/grant-types/implicit/).
54-
* Alternatives to `ImplicitMSALAuthenticationProvider` -
55-
* TokenCredentialAuthenticationProvider with the `azure/identity` library. Learn more about [InteractiveBrowserCredential](https://github.com/Azure/azure-sdk-for-js/blob/master/sdk/identity/identity/interactive-browser-credential.md)
56-
* A CustomAuthenticationProvider with an auth library of your choice. [Choose a Microsoft Graph authentication provider based on scenario](https://docs.microsoft.com/en-us/graph/sdks/choose-authentication-providers?tabs=CS)
75+
- Use of `ImplicitMSALAuthenticationProvider`, that is,using the implicit authorization flow is not recommended any more. [OAuth 2.0 Implicit Grant](https://oauth.net/2/grant-types/implicit/).
76+
- Alternatives to `ImplicitMSALAuthenticationProvider` -
77+
- TokenCredentialAuthenticationProvider with the `azure/identity` library. Learn more about [InteractiveBrowserCredential](https://github.com/Azure/azure-sdk-for-js/blob/master/sdk/identity/identity/interactive-browser-credential.md)
78+
- A CustomAuthenticationProvider with an auth library of your choice. [Choose a Microsoft Graph authentication provider based on scenario](https://docs.microsoft.com/en-us/graph/sdks/choose-authentication-providers?tabs=CS)
5779

80+
### Deprecating the `sliceFile` function of the `LargeFileUploadTask` class.
81+
- The `sliceFile` function has been moved to the `FileObject` interface.

0 commit comments

Comments
 (0)