diff --git a/releases/2021-03/android.md b/releases/2021-03/android.md index 17c4fbb87f8a..0b52fbd2b489 100644 --- a/releases/2021-03/android.md +++ b/releases/2021-03/android.md @@ -18,7 +18,8 @@ The Azure SDK team is pleased to announce our March 2021 client library releases #### Beta -- _Add packages_ +- Azure Communication Services Chat +- Azure Communication Services Common ## Installation Instructions @@ -27,20 +28,71 @@ To use the latest GA and beta libraries, refer to the dependency information bel ### Gradle #### Java + ```gradle -// Insert dependencies +allprojects { + repositories { + ... + maven { + url 'https://trouterpublicpackages.z13.web.core.windows.net' + } + } + +dependencies { + ... + implementation 'com.azure.android:azure-communication-chat:1.0.0-beta.7' + implementation 'com.azure.android:azure-communication-common:1.0.0-beta.7' + implementation 'com.microsoft.trouter:client-android:0.0.1-beta.1' +} ``` #### Kotlin ```gradle -// Insert dependencies +allprojects { + repositories { + ... + maven { + url 'https://trouterpublicpackages.z13.web.core.windows.net' + } + } +dependencies { + ... + implementation("com.azure.android:azure-communication-chat:1.0.0-beta.7") + implementation("com.azure.android:azure-communication-common:1.0.0-beta.7") + implementation("com.microsoft.trouter:client-android:0.0.1-beta.1") +} ``` ### Maven ```xml - + + ... + + troutersource + https://trouterpublicpackages.z13.web.core.windows.net + + +... + + com.azure.android + azure-communication-chat + 1.0.0-beta.7 + aar + + + com.azure.android + azure-communication-common + 1.0.0-beta.7 + aar + + + com.microsoft.trouter + client-android + 0.0.1-beta.1 + aar + ``` ## Feedback @@ -49,9 +101,53 @@ If you have a bug or feature request for one of the libraries, please post an is ## Release highlights -### _Package name_ +### Azure Communication Services Common + +#### 1.0.0-beta.7 ([Changelog](https://github.com/Azure/azure-sdk-for-android/blob/master/sdk/communication/azure-communication-common/CHANGELOG.md#100-beta7-2021-03-09)) + +##### Breaking Changes + +- Credential `getToken` now returns the newly added `CommunicationAccessToken` object instead of `AccessToken`. +- Renamed `getRefreshProactively` to `isRefreshProactively` in 'CommunicationTokenRefreshOptions'. +- Removed constructor `MicrosoftTeamsUserIdentifier(String userId, boolean isAnonymous, CommunicationCloudEnvironment cloudEnvironment)` in `MicrosoftTeamsUserIdentifier`. +- Made the following classes final: + - `CommunicationAccessToken` + - `CommunicationTokenCredential` + - `CommunicationTokenRefreshOptions` + - `CommunicationUserIdentifier` + - `MicrosoftTeamsUserIdentifier` + - `PhoneNumberIdentifier` + - `UnknownIdentifier` + +##### New Features + +- Introduced a new class: `CommunicationAccessToken`. + +### Azure Communication Services Chat + +#### 1.0.0-beta.7 ([Changelog](https://github.com/Azure/azure-sdk-for-android/blob/master/sdk/communication/azure-communication-chat/CHANGELOG.md#100-beta7-2021-03-09)) + +##### New Features + +- Added support for real time notifications with new methods in `ChatClient` /`ChatAsyncClient`: + - `startRealtimeNotifications` + - stopRealtimeNotifications` + - `on(chatEventId, listenerId, listener)` + - `off(chatEventId, listenerId)` +- Added a sample chat app under the folder `samples` with the purpose of testing and playing around with the chat functionality. + +##### Breaking Changes -- Major changes only! +- Changed `userId` from the type `CommunicationUserIdentifier` to `CommunicationIdentifierModel` in the following classes: + - `ChatMessage` + - `ChatMessageContent` + - `ChatMessageReadReceipt` + - `ChatParticipant` + - `ChatThread` +- Renamed property `initiator` to `initiatorCommunicationIdentifier` in `ChatMessageContent`. +- Renamed `senderId` to `senderCommunicationIdentifier` in `ChatMessage` and `ChatMessageReadReceipt`. +- Renamed `identifier` to `communicationIdentifier` in `ChatParticipant`. +- Renamed `createdBy` to `createdByCommunicationIdentifier` in `ChatThread`. ## Need help diff --git a/releases/2021-03/dotnet.md b/releases/2021-03/dotnet.md index 9baef1e4752b..412f460114f2 100644 --- a/releases/2021-03/dotnet.md +++ b/releases/2021-03/dotnet.md @@ -24,12 +24,22 @@ The Azure SDK team is pleased to announce our March 2021 client library releases [pattern.beta]: # (- ${PackageFriendlyName}) +- Communication Chat +- Communication Common +- Communication Identity +- Communication Phone Numbers +- Communication SMS + ## Installation Instructions To install any of our packages, please search for them via `Manage NuGet Packages...` in Visual Studio (with `Include prerelease` checked) or copy these commands into your terminal: ```bash - +$> dotnet add package Azure.Communication.Chat --version 1.0.0-beta.5 +$> dotnet add package Azure.Communication.Common --version 1.0.0-beta.5 +$> dotnet add package Azure.Communication.Identity --version 1.0.0-beta.5 +$> dotnet add package Azure.Communication.PhoneNumbers --version 1.0.0-beta.5 +$> dotnet add package Azure.Communication.SMS --version 1.0.0-beta.5 ``` [pattern]: # ($> dotnet install ${PackageName} --version ${PackageVersion}) @@ -42,6 +52,59 @@ If you have a bug or feature request for one of the libraries, please [file an i [pattern]: # (### ${PackageFriendlyName} ${PackageVersion} [Changelog]${ChangelogUrl}`n${HighlightsBody}`n) + +### Azure Communication Administration is deprecated + +- `PhoneNumberAdministrationClient` is moved into the new package `Azure.Communication.PhoneNumbers` and replaced by `PhoneNumberClient`. + +### Azure Communication Phone Numbers 1.0.0-beta.5 [Changelog](https://github.com/Azure/azure-sdk-for-net/blob/master/sdk/communication/Azure.Communication.PhoneNumbers/CHANGELOG.md#100-beta5-2021-03-09) + +#### New Features + +- Added `PhoneNumbersClient` (originally was part of the `Azure.Communication.Administration` package). +- Added support for Azure Active Directory Authentication. + +#### Breaking Changes + +- `PhoneNumberAdministrationClient` has been replaced with `PhoneNumbersClient`, which has the same functionality but different APIs. To learn more about how PhoneNumbersClient works, refer to the [README.md](https://github.com/Azure/azure-sdk-for-net/blob/master/sdk/communication/Azure.Communication.PhoneNumbers/README.md) + +### Azure Communication Chat 1.0.0-beta.5 [Changelog](https://github.com/Azure/azure-sdk-for-net/blob/master/sdk/communication/Azure.Communication.Chat/CHANGELOG.md#100-beta5-2021-03-09) + +#### Breaking Changes + +- Added support for communication identifiers instead of raw strings. +- Removed support for nullable reference types. + +### Azure Communication Common 1.0.0-beta.5 [Changelog](https://github.com/Azure/azure-sdk-for-net/blob/master/sdk/communication/Azure.Communication.Common/CHANGELOG.md#100-beta5-2021-03-09) + +#### Breaking Changes + +- Updated `CommunicationTokenRefreshOptions(bool refreshProactively, Func tokenRefresher, Func> asyncTokenRefresher = null, string initialToken = null)` +to `CommunicationTokenRefreshOptions(bool refreshProactively, Func tokenRefresher)`. `asyncTokenRefresher` and `initialToken` are updated to become public properties. + +### Azure Communication Identity 1.0.0-beta.5 [Changelog](https://github.com/Azure/azure-sdk-for-net/blob/master/sdk/communication/Azure.Communication.Identity/CHANGELOG.md#100-beta5-2021-03-09) + +#### Breaking Changes + +- `CommunicationIdentityClient.IssueToken` and `CommunicationIdentityClient.IssueTokenAsync` are renamed to `GetToken` and `GetTokenAsync`, respectively +- `CommunicationIdentityClient.CreateUserWithToken` and `CommunicationIdentityClient.CreateUserWithTokenAsync` are renamed to `CreateUserAndToken` and `CreateUserAndTokenAsync`, respectively. Their return value is also changed from `Tuple` to `CommunicationUserIdentifierAndToken`. + +### Azure Communication SMS 1.0.0-beta.4 [Changelog](https://github.com/Azure/azure-sdk-for-net/blob/master/sdk/communication/Azure.Communication.Sms/CHANGELOG.md#100-beta4-2021-03-09) + +#### New Features + +- Added support to create SmsClient with AzureKeyCredential. +- Support for creating SmsClient with TokenCredential. +- Added support for 1:N SMS messaging. +- Added support for tagging SMS messages. +- Send method series in SmsClient are idempotent under retry policy. + +#### Breaking Changes + +- Updated `Task> SendAsync(PhoneNumberIdentifier from, PhoneNumberIdentifier to, string message, SendSmsOptions sendSmsOptions = null, CancellationToken cancellationToken = default)` +to `Task> SendAsync(string from, string to, string message, SmsSendOptions options = default)` +- Replaced `SendSmsResponse` with `SmsSendResult` + ## Latest Releases View all the latest versions of .NET packages [here][dotnet-latest-releases]. diff --git a/releases/2021-03/java.md b/releases/2021-03/java.md index 0586faa7053e..bcc830f7e1bf 100644 --- a/releases/2021-03/java.md +++ b/releases/2021-03/java.md @@ -22,13 +22,47 @@ The Azure SDK team is pleased to announce our March 2021 client library releases #### Beta -[pattern.beta]: # (- ${PackageFriendlyName}) +- Azure Communication Common +- Azure Communication Identity +- Azure Communication Chat +- Azure Communication Phone Numbers +- Azure Communication SMS ## Installation Instructions To use the GA and beta libraries, refer to the Maven dependency information below, which may be copied into your projects Maven `pom.xml` file as appropriate. If you are using a different build tool, refer to its documentation on how to specify dependencies. ```xml + + com.azure + azure-communication-chat + 1.0.0-beta.6 + + + + com.azure + azure-communication-common + 1.0.0-beta.6 + + + + com.azure + azure-communication-identity + 1.0.0-beta.6 + + + + com.azure + azure-communication-phonenumbers + 1.0.0-beta.6 + + + + com.azure + azure-communication-sms + 1.0.0-beta.4 + + ``` @@ -40,7 +74,75 @@ If you have a bug or feature request for one of the libraries, please post an is ## Release highlights -[pattern]: # (### ${PackageFriendlyName} ${PackageVersion} [Changelog]${ChangelogUrl}`n${HighlightsBody}`n) +### Azure Communication Administration is deprecated + +- Phone number administration will be moved into a new package Azure Communication Phone Numbers. + +### Azure Communication Phone Numbers 1.0.0-beta.6 [Changelog](https://github.com/Azure/azure-sdk-for-java/blob/master/sdk/communication/azure-communication-phonenumbers/CHANGELOG.md#100-beta6-2021-03-09) + +#### New Features + +- Added `PhoneNumbersClient` and `PhoneNumbersAsyncClient` (originally was part of the `azure.communication.administration` package). +- Added support for Azure Active Directory Authentication. + +#### Breaking Changes + +- `PhoneNumberAsyncClient` has been replaced with `PhoneNumbersAsyncClient`, which has the same functionality but different APIs. To learn more about how PhoneNumbersAsyncClient works, refer to the [README.md](https://github.com/Azure/azure-sdk-for-java/blob/master/sdk/communication/azure-communication-phonenumbers/README.md). +- `PhoneNumberClient` has been replaced with `PhoneNumbersClient`, which has the same functionality but different APIs. To learn more about how PhoneNumbersClient works, refer to the [README.md](https://github.com/Azure/azure-sdk-for-java/blob/master/sdk/communication/azure-communication-phonenumbers/README.md). + + + + + +### Azure Communication Common 1.0.0-beta.6 [Changelog](https://github.com/Azure/azure-sdk-for-java/blob/master/sdk/communication/azure-communication-common/CHANGELOG.md#100-beta6-2021-03-09) + +#### Breaking Changes + +- Renamed `CommunicationTokenRefreshOptions.getRefreshProactively()` to `CommunicationTokenRefreshOptions.isRefreshProactively()` +- Constructor for `CommunicationCloudEnvironment` has been removed and now to set an environment value, the `fromString()` method must be called +- `CommunicationCloudEnvironment`, `CommunicationTokenRefreshOptions `, `CommunicationUserIdentifier`, `MicrosoftTeamsUserIdentifier`, +`PhoneNumberIdentifier`, `UnknownIdentifier`, are all final classes now. + +### Azure Communication Chat 1.0.0-beta.6 [Changelog](https://github.com/Azure/azure-sdk-for-java/blob/master/sdk/communication/azure-communication-chat/CHANGELOG.md#100-beta6-2021-03-09) + +#### New Features + +- Updated azure-communication-chat version + + +### Azure Communication Identity 1.0.0-beta.6 [Changelog](https://github.com/Azure/azure-sdk-for-java/blob/master/sdk/communication/azure-communication-identity/CHANGELOG.md#100-beta6-2021-03-09) + +#### New Features + +- Added a retryPolicy() chain method to the `CommunicationIdentityClientBuilder`. + +#### Breaking Changes + +- `CommunicationIdentityClient.createUserWithToken` and `CommunicationIdentityAsyncClient.createUserWithToken` have been renamed to +`CommunicationIdentityClient.createUserAndToken` and `CommunicationIdentityAsyncClient.createUserAndToken`. +- `CommunicationIdentityClient.createUserWithTokenWithResponse` and `CommunicationIdentityAsyncClient.createUserWithTokenWithResponse` have been renamed to +`CommunicationIdentityClient.createUserAndTokenWithResponse` and `CommunicationIdentityAsyncClient.createUserAndTokenWithResponse`. +- `CommunicationUserIdentifierWithTokenResult` class has been renamed to `CommunicationUserIdentifierAndToken`. + + +### Azure Communication SMS 1.0.0-beta.4 [Changelog](https://github.com/Azure/azure-sdk-for-java/blob/master/sdk/communication/azure-communication-sms/CHANGELOG.md#100-beta4-2021-03-09) + +#### New Features + +- Added Azure Active Directory authentication support +- Support for creating SmsClient with TokenCredential. +- Added support for 1:N SMS messaging. +- Added support for tagging SMS messages. +- Send method series in SmsClient are idempotent under retry policy. +- Added `SmsOptions` + +#### Breaking Changes + +- Updated `public Mono sendMessage(PhoneNumberIdentifier from, PhoneNumberIdentifier to, String message)` to `public Mono send(String from, String to, String message)`. +- Updated `public Mono> sendMessageWithResponse(PhoneNumberIdentifier from,List to, String message, SendSmsOptions smsOptions, Context context)` to `Mono> sendWithResponse(String from, String to, String message, SmsSendOptions options, Context context)`. +- Replaced `SendSmsResponse` with `SmsSendResult`. + + ## Need help diff --git a/releases/2021-03/js.md b/releases/2021-03/js.md index aa1c228e42c2..f7bd5229028c 100644 --- a/releases/2021-03/js.md +++ b/releases/2021-03/js.md @@ -22,14 +22,22 @@ The Azure SDK team is pleased to make available the March 2021 client library re #### Beta -[pattern.beta]: # (- ${PackageFriendlyName}) +- Azure Communication Common +- Azure Communication Identity +- Azure Communication Chat +- Azure Communication Phone Numbers +- Azure Communication SMS ## Installation Instructions To install the packages, copy and paste the below into a terminal. ```bash - +$> npm install @azure/communication-common@next +$> npm install @azure/communication-identity@next +$> npm install @azure/communication-chat@next +$> npm install @azure/communication-phone-numbers@next +$> npm install @azure/communication-sms@next ``` [pattern]: # ($> npm install ${PackageName}@${PackageVersion}) @@ -40,7 +48,56 @@ If you have a bug or feature request for one of the libraries, please post an is ## Release highlights -[pattern]: # (### ${PackageFriendlyName} ${PackageVersion} [Changelog]${ChangelogUrl}`n${HighlightsBody}`n) +### Azure Communication Administration is deprecated + +- Phone number administration will be moved into a new package Azure Communication Phone Numbers. + +### Azure Communication Phone Numbers 1.0.0-beta.4 [Changelog](https://github.com/Azure/azure-sdk-for-js/blob/master/sdk/communication/communication-phone-numbers/CHANGELOG.md#100-beta4-2021-03-09) + +#### Breaking Changes + +- Removed `dist-browser` from the output folders. To bundle the Azure SDK libraries, please read our bundling guide: [link](https://github.com/Azure/azure-sdk-for-js/blob/master/documentation/Bundling.md) + +### Azure Communication Chat 1.0.0-beta.5 [Changelog](https://github.com/Azure/azure-sdk-for-js/blob/master/sdk/communication/communication-chat/CHANGELOG.md#100-beta5-2021-03-09) + +#### Breaking Changes + +- Removed `_response` from returned models. +- Updated to @azure/communication-common@1.0.0-beta.6. Now uses `CommunicationIdentifier` in place of `CommunicationUserIdentifier`. +- Swap the parameter order in `ChatThreadClient` constructor. +- Generates `repeatabilityRequestId` if not populated in `createChatThread` operation. + +### Azure Communication Common 1.0.0-beta.6 [Changelog](https://github.com/Azure/azure-sdk-for-js/blob/master/sdk/communication/communication-common/CHANGELOG.md#100-beta6-2021-03-09) + +##### New Features + +- Updated @azure/communication-common version. + +### Azure Communication Identity 1.0.0-beta.5 [Changelog](https://github.com/Azure/azure-sdk-for-js/blob/master/sdk/communication/communication-identity/CHANGELOG.md#100-beta5-2021-03-09) + +#### Breaking Changes + +- `CommunicationIdentityClient` method `issueToken` renamed to `getToken`. +- `CommunicationIdentityClient` method `createUserWithToken` renamed to `createUserAndToken`. +- Renamed `CommunicationIdentityOptions` to `CommunicationIdentityClientOptions`. +- Removed `_response` from returned models. +- Removed `dist-browser` from the output folders. To bundle the Azure SDK libraries, please read our bundling guide: [link](https://github.com/Azure/azure-sdk-for-js/blob/master/documentation/Bundling.md). + +### Azure Communication SMS 1.0.0-beta.4 [Changelog](https://github.com/Azure/azure-sdk-for-js/blob/master/sdk/communication/communication-sms/CHANGELOG.md#100-beta4-2021-03-09) + +##### New Features + +- `SmsClient` added a constructor that supports `TokenCredential`. +- Added support for 1:N SMS messaging. +- Added support for tagging SMS messages. +- `send` method in `SmsClient` is idempotent under retry policy. +- +#### Breaking Changes + +- `SendRequest` renamed to `SmsSendRequest`. +- `SendOptions` renamed to `SmsSendOptions` and now has an additional field `tag` to add a custom tag to delivery reports (when enabled). +- `send` no longer returns `RestResponse`, now returns an array of `SmsSendResults`. This contains fields to validate success/failure of each sent message. + ## Latest Releases diff --git a/releases/2021-03/python.md b/releases/2021-03/python.md index 67f3d7b88154..3ba24c02860a 100644 --- a/releases/2021-03/python.md +++ b/releases/2021-03/python.md @@ -22,14 +22,20 @@ The Azure SDK team is pleased to make available the March 2021 client library re #### Beta -[pattern.beta]: # (- ${PackageFriendlyName}) +- Azure Communication Identity +- Azure Communication Chat +- Azure Communication Phone Numbers +- Azure Communication SMS ## Installation Instructions To install the latest beta version of the packages, copy and paste the following commands into a terminal: ```bash - +pip install azure-communication-identity +pip install azure-communication-chat +pip install azure-communication-sms +pip install azure-communication-phonenumbers ``` [pattern]: # ($> pip install ${PackageName}==${PackageVersion}) @@ -40,7 +46,53 @@ If you have a bug or feature request for one of the libraries, please post an is ## Release highlights -[pattern]: # (### ${PackageFriendlyName} ${PackageVersion} [Changelog]${ChangelogUrl}`n${HighlightsBody}`n) +### Azure Communication Administration is deprecated +- Phone number administration will be moved into a new package Azure Communication Phone Numbers. + +### Azure Communication Phone Numbers 1.0.0-beta.4 [Changelog](https://github.com/Azure/azure-sdk-for-python/blob/master/sdk/communication/azure-communication-phonenumbers/CHANGELOG.md#100b4-2021-03-09) + +##### New Features + +- Added `PhoneNumbersAdministrationClient` (originally was part of the `azure.communication.administration` package). + +### Azure Communication Chat 1.0.0-beta.5 [Changelog](https://github.com/Azure/azure-sdk-for-python/blob/master/sdk/communication/azure-communication-chat/CHANGELOG.md#100b5-2021-03-09) + +##### New Features + +- Removed nullable references from method signatures. + +#### Breaking Changes + +- Added support for communication identifiers instead of raw strings. +- Changed return type of `create_chat_thread`: `ChatThreadClient -> CreateChatThreadResult` +- Changed return types `add_participants`: `None -> list[(ChatThreadParticipant, CommunicationError)]` +- Added check for failure in `add_participant` + +### Azure Communication Identity 1.0.0-beta.5 [Changelog](https://github.com/Azure/azure-sdk-for-python/blob/master/sdk/communication/azure-communication-identity/CHANGELOG.md#100b5-2021-03-09) + +#### Breaking Changes + +- CommunicationIdentityClient's (synchronous and asynchronous) `issue_token` function is now renamed to `get_token`. +- The CommunicationIdentityClient constructor uses type `TokenCredential` and `AsyncTokenCredential` for the credential parameter. + +### Azure Communication SMS 1.0.0-beta.6 [Changelog](https://github.com/Azure/azure-sdk-for-python/blob/master/sdk/communication/azure-communication-sms/CHANGELOG.md#100b5-2021-03-09) + +### New Features + +- Added support for Azure Active Directory authentication. +- Added support for 1:N SMS messaging. +- Added support for SMS idempotency. +- Send method series in SmsClient are idempotent under retry policy. +- Added support for tagging SMS messages. +- The SmsClient constructor uses type `TokenCredential` and `AsyncTokenCredential` for the credential parameter. + +#### Breaking Changes + +- Send method takes in strings for phone numbers instead of `PhoneNumberIdentifier`. +- Send method returns a list of `SmsSendResult`s instead of a `SendSmsResponse`. + + + ## Latest Releases