[ACS Rooms] Public preview DotNet SDK changes. (Azure#30323)

* rooms .net sdk with newest library

Revise rooms .net sdk with newest flatten interface and dedpenecies.
Live tests succeed.

* Change update room method

remove the update of participants in updateRoom method.

* Make rooms model internal

* Add CommunicationUser Creation

Create communication user through CommunicationIdentityClient instead of
hard code.

* Initial rbac based on new version api

The rbac feature support SDK based on new version api

* Version 2021-04-07 validation

* Adding idempotency changes for the dotnet SDK for Rooms.

* Adding recordings and making sure tests work with idempotency.

* ACS Rooms Public preview changes.

* Latest test run recording.

* Fixing issue with no sample for GetParticipants being found.

* Fixing recordings with new sample.

* Removing version from install command.

* Adding email project back to sln

* Adjusting samples.

* Exporting the Rooms API.

* Addressed board review comment. Removing standard package
import from readme.

* Adjusting throwing argument exception when communication identifier is null.

* Fixing snippets.

* Fixing spelling mistakes.

* Added Rooms overview

* Removing system imports from snippets.

* Addressed review comments

* Added note for future to remove this file and refer to shared when rooms support all
identifiers.

* Updated method to get connectionString.

* Added error message.

* Using Azure.Core assertion for null check.

* Simplify foreach loop.

Co-authored-by: Rui Wang <[email protected]>
Co-authored-by: Ramneet Tung <[email protected]>

Author: 3 people

sdk/communication/Azure.Communication.Rooms/CHANGELOG.md

@@ -0,0 +1,4 @@
+# Release History
+
+## 1.0.0-beta.1 (Unreleased)
+- Initial Version of Rooms .net SDK.

sdk/communication/Azure.Communication.Rooms/README.md

@@ -0,0 +1,104 @@
+# Azure Communication Rooms client library for .NET
+
+This package contains a C# SDK for the Rooms Service of Azure Communication Services.
+
+Rooms overview
+    Azure Communication Services (ACS) Rooms is a set of APIs, used by Contoso server applications to create a server-managed conversation space with fixed set of lifetime and participants, pre-defining rules from server-tier both who and when can communicate (like scheduled meeting creation).
+
+With the Public Preview release of ACS Rooms, Contoso will be able to:
+    create a meeting space with known time coordinates (start/end time),
+    join voice/video calls within that meeting space using the ACS web calling SDK or native mobile calling SDKs,
+    add participants to a room,
+    assign pre-defined roles to room participants,
+    set rooms call join policies (e.g., open or closed room), and
+    consume Event Grid notifications for calling events.
+    The server-side functionalities can be accessed via a refreshed API and a full set of SDKs (.NET, Java, Python, JavaScript/TypeScript).
+
+The main scenarios where Rooms can best be used:
+    Virtual Visits (e.g., telemedicine, remote financial advisor, virtual classroom, etc...)
+    Virtual Events (e.g., live event, company all-hands, live concert, etc...)
+    Champion scenarios
+
+
+[Source code][source] | [Package (NuGet)][package] | [Product documentation][product_docs]
+## Getting started
+
+### Install the package
+Install the Azure Communication Rooms client library for .NET with [NuGet][nuget]:
+
+```PowerShell
+dotnet add package Azure.Communication.Rooms
+``` 
+
+### Prerequisites
+You need an [Azure subscription][azure_sub] and a [Communication Service Resource][communication_resource_docs] to use this package.
+
+To create a new Communication Service, you can use the [Azure Portal][communication_resource_create_portal], the [Azure PowerShell][communication_resource_create_power_shell], or the [.NET management client library][communication_resource_create_net].
+
+### Key concepts
+`RoomsClient` provides the functionality to create room, update room, get room, delete room, add participants, remove participant, update participant and get participants.
+
+### Using statements
+```C# Snippet:Azure_Communication_Rooms_Tests_UsingStatements
+using Azure.Communication.Rooms
+```
+
+### Authenticate the client
+Rooms clients can be authenticated using the connection string acquired from an Azure Communication Resource in the [Azure Portal][azure_portal].
+
+```C# Snippet:Azure_Communication_Rooms_Tests_Samples_CreateRoomsClient
+var connectionString = Environment.GetEnvironmentVariable("connection_string") // Find your Communication Services resource in the Azure portal
+RoomsClient client = new RoomsClient(connectionString);
+```
+
+## Examples
+
+The following sections provide several code snippets covering some of the most common tasks, which is available at Sample1_RoomsRequests.md
+
+## Troubleshooting
+### Service Responses
+A `RequestFailedException` is thrown as a service response for any unsuccessful requests. The exception contains information about what response code was returned from the service.
+```C# Snippet:Azure_Communication_RoomsClient_Tests_Troubleshooting
+try
+{
+    CommunicationIdentityClient communicationIdentityClient = CreateInstrumentedCommunicationIdentityClient();
+    var communicationUser1 = communicationIdentityClient.CreateUserAsync().Result.Value.Id;
+    var communicationUser2 = communicationIdentityClient.CreateUserAsync().Result.Value.Id;
+    var validFrom = DateTime.UtcNow;
+    var validUntil = validFrom.AddDays(1);
+    List<RoomParticipant> createRoomParticipants = new List<RoomParticipant>();
+    RoomParticipant participant1 = new RoomParticipant(new CommunicationUserIdentifier(communicationUser1), RoleType.Presenter);
+    RoomParticipant participant2 = new RoomParticipant(new CommunicationUserIdentifier(communicationUser2), RoleType.Attendee);
+    Response<CommunicationRoom> createRoomResponse = await roomsClient.CreateRoomAsync(validFrom, validUntil, RoomJoinPolicy.InviteOnly, createRoomParticipants);
+    CommunicationRoom createRoomResult = createRoomResponse.Value;
+}
+catch (RequestFailedException ex)
+{
+    Console.WriteLine(ex.Message);
+}
+```
+
+## Next steps
+- [Read more about Rooms in Azure Communication Services][nextsteps]
+
+## Contributing
+This project welcomes contributions and suggestions. Most contributions require you to agree to a Contributor License Agreement (CLA) declaring that you have the right to, and actually do, grant us the rights to use your contribution. For details, visit [cla.microsoft.com][cla].
+
+This project has adopted the [Microsoft Open Source Code of Conduct][coc]. For more information see the [Code of Conduct FAQ][coc_faq] or contact [[email protected]][coc_contact] with any additional questions or comments.
+
+<!-- LINKS -->
+[azure_sub]: https://azure.microsoft.com/free/dotnet/
+[azure_portal]: https://portal.azure.com
+[cla]: https://cla.microsoft.com
+[coc]: https://opensource.microsoft.com/codeofconduct/
+[coc_faq]: https://opensource.microsoft.com/codeofconduct/faq/
+[coc_contact]: mailto:[email protected]
+[communication_resource_docs]: https://docs.microsoft.com/azure/communication-services/quickstarts/create-communication-resource?tabs=windows&pivots=platform-azp
+[communication_resource_create_portal]:  https://docs.microsoft.com/azure/communication-services/quickstarts/create-communication-resource?tabs=windows&pivots=platform-azp
+[communication_resource_create_power_shell]: https://docs.microsoft.com/powershell/module/az.communication/new-azcommunicationservice
+[communication_resource_create_net]: https://docs.microsoft.com/azure/communication-services/quickstarts/create-communication-resource?tabs=windows&pivots=platform-net
+[product_docs]: https://docs.microsoft.com/azure/communication-services/overview
+[nuget]: https://www.nuget.org/
+
+<!-- TODO -->
+Update the sample code links once the sdk is published

sdk/communication/Azure.Communication.Rooms/api/Azure.Communication.Rooms.netstandard2.0.cs

@@ -0,0 +1,95 @@
+namespace Azure.Communication.Rooms
+{
+    public partial class CommunicationRoom
+    {
+        internal CommunicationRoom() { }
+        public System.DateTimeOffset? CreatedOn { get { throw null; } }
+        public string Id { get { throw null; } }
+        public System.Collections.Generic.IReadOnlyList<Azure.Communication.Rooms.RoomParticipant> Participants { get { throw null; } }
+        public Azure.Communication.Rooms.RoomJoinPolicy? RoomJoinPolicy { get { throw null; } }
+        public System.DateTimeOffset? ValidFrom { get { throw null; } }
+        public System.DateTimeOffset? ValidUntil { get { throw null; } }
+    }
+    public partial class ParticipantsCollection
+    {
+        internal ParticipantsCollection() { }
+        public System.Collections.Generic.IReadOnlyList<Azure.Communication.Rooms.RoomParticipant> Participants { get { throw null; } }
+    }
+    [System.Runtime.InteropServices.StructLayoutAttribute(System.Runtime.InteropServices.LayoutKind.Sequential)]
+    public readonly partial struct RoleType : System.IEquatable<Azure.Communication.Rooms.RoleType>
+    {
+        private readonly object _dummy;
+        private readonly int _dummyPrimitive;
+        public RoleType(string value) { throw null; }
+        public static Azure.Communication.Rooms.RoleType Attendee { get { throw null; } }
+        public static Azure.Communication.Rooms.RoleType Consumer { get { throw null; } }
+        public static Azure.Communication.Rooms.RoleType Presenter { get { throw null; } }
+        public bool Equals(Azure.Communication.Rooms.RoleType other) { throw null; }
+        [System.ComponentModel.EditorBrowsableAttribute(System.ComponentModel.EditorBrowsableState.Never)]
+        public override bool Equals(object obj) { throw null; }
+        [System.ComponentModel.EditorBrowsableAttribute(System.ComponentModel.EditorBrowsableState.Never)]
+        public override int GetHashCode() { throw null; }
+        public static bool operator ==(Azure.Communication.Rooms.RoleType left, Azure.Communication.Rooms.RoleType right) { throw null; }
+        public static implicit operator Azure.Communication.Rooms.RoleType (string value) { throw null; }
+        public static bool operator !=(Azure.Communication.Rooms.RoleType left, Azure.Communication.Rooms.RoleType right) { throw null; }
+        public override string ToString() { throw null; }
+    }
+    [System.Runtime.InteropServices.StructLayoutAttribute(System.Runtime.InteropServices.LayoutKind.Sequential)]
+    public readonly partial struct RoomJoinPolicy : System.IEquatable<Azure.Communication.Rooms.RoomJoinPolicy>
+    {
+        private readonly object _dummy;
+        private readonly int _dummyPrimitive;
+        public RoomJoinPolicy(string value) { throw null; }
+        public static Azure.Communication.Rooms.RoomJoinPolicy CommunicationServiceUsers { get { throw null; } }
+        public static Azure.Communication.Rooms.RoomJoinPolicy InviteOnly { get { throw null; } }
+        public bool Equals(Azure.Communication.Rooms.RoomJoinPolicy other) { throw null; }
+        [System.ComponentModel.EditorBrowsableAttribute(System.ComponentModel.EditorBrowsableState.Never)]
+        public override bool Equals(object obj) { throw null; }
+        [System.ComponentModel.EditorBrowsableAttribute(System.ComponentModel.EditorBrowsableState.Never)]
+        public override int GetHashCode() { throw null; }
+        public static bool operator ==(Azure.Communication.Rooms.RoomJoinPolicy left, Azure.Communication.Rooms.RoomJoinPolicy right) { throw null; }
+        public static implicit operator Azure.Communication.Rooms.RoomJoinPolicy (string value) { throw null; }
+        public static bool operator !=(Azure.Communication.Rooms.RoomJoinPolicy left, Azure.Communication.Rooms.RoomJoinPolicy right) { throw null; }
+        public override string ToString() { throw null; }
+    }
+    public partial class RoomParticipant
+    {
+        public RoomParticipant(Azure.Communication.CommunicationIdentifier communicationIdentifier) { }
+        public RoomParticipant(Azure.Communication.CommunicationIdentifier communicationIdentifier, Azure.Communication.Rooms.RoleType role) { }
+        public Azure.Communication.CommunicationIdentifier CommunicationIdentifier { get { throw null; } }
+        public Azure.Communication.Rooms.RoleType? Role { get { throw null; } set { } }
+    }
+    public partial class RoomsClient
+    {
+        protected RoomsClient() { }
+        public RoomsClient(string connectionString) { }
+        public RoomsClient(string connectionString, Azure.Communication.Rooms.RoomsClientOptions options) { }
+        public RoomsClient(System.Uri endpoint, Azure.AzureKeyCredential keyCredential, Azure.Communication.Rooms.RoomsClientOptions options = null) { }
+        public RoomsClient(System.Uri endpoint, Azure.Core.TokenCredential tokenCredential, Azure.Communication.Rooms.RoomsClientOptions options = null) { }
+        public virtual Azure.Response AddParticipants(string roomId, System.Collections.Generic.IEnumerable<Azure.Communication.Rooms.RoomParticipant> participants = null, System.Threading.CancellationToken cancellationToken = default(System.Threading.CancellationToken)) { throw null; }
+        public virtual System.Threading.Tasks.Task<Azure.Response> AddParticipantsAsync(string roomId, System.Collections.Generic.IEnumerable<Azure.Communication.Rooms.RoomParticipant> participants = null, System.Threading.CancellationToken cancellationToken = default(System.Threading.CancellationToken)) { throw null; }
+        public virtual Azure.Response<Azure.Communication.Rooms.CommunicationRoom> CreateRoom(System.DateTimeOffset? validFrom = default(System.DateTimeOffset?), System.DateTimeOffset? validUntil = default(System.DateTimeOffset?), Azure.Communication.Rooms.RoomJoinPolicy? roomJoinPolicy = default(Azure.Communication.Rooms.RoomJoinPolicy?), System.Collections.Generic.IEnumerable<Azure.Communication.Rooms.RoomParticipant> participants = null, System.Threading.CancellationToken cancellationToken = default(System.Threading.CancellationToken)) { throw null; }
+        public virtual System.Threading.Tasks.Task<Azure.Response<Azure.Communication.Rooms.CommunicationRoom>> CreateRoomAsync(System.DateTimeOffset? validFrom = default(System.DateTimeOffset?), System.DateTimeOffset? validUntil = default(System.DateTimeOffset?), Azure.Communication.Rooms.RoomJoinPolicy? roomJoinPolicy = default(Azure.Communication.Rooms.RoomJoinPolicy?), System.Collections.Generic.IEnumerable<Azure.Communication.Rooms.RoomParticipant> participants = null, System.Threading.CancellationToken cancellationToken = default(System.Threading.CancellationToken)) { throw null; }
+        public virtual Azure.Response DeleteRoom(string roomId, System.Threading.CancellationToken cancellationToken = default(System.Threading.CancellationToken)) { throw null; }
+        public virtual System.Threading.Tasks.Task<Azure.Response> DeleteRoomAsync(string roomId, System.Threading.CancellationToken cancellationToken = default(System.Threading.CancellationToken)) { throw null; }
+        public virtual Azure.Response<Azure.Communication.Rooms.ParticipantsCollection> GetParticipants(string roomId, System.Threading.CancellationToken cancellationToken = default(System.Threading.CancellationToken)) { throw null; }
+        public virtual System.Threading.Tasks.Task<Azure.Response<Azure.Communication.Rooms.ParticipantsCollection>> GetParticipantsAsync(string roomId, System.Threading.CancellationToken cancellationToken = default(System.Threading.CancellationToken)) { throw null; }
+        public virtual Azure.Response<Azure.Communication.Rooms.CommunicationRoom> GetRoom(string roomId, System.Threading.CancellationToken cancellationToken = default(System.Threading.CancellationToken)) { throw null; }
+        public virtual System.Threading.Tasks.Task<Azure.Response<Azure.Communication.Rooms.CommunicationRoom>> GetRoomAsync(string roomId, System.Threading.CancellationToken cancellationToken = default(System.Threading.CancellationToken)) { throw null; }
+        public virtual Azure.Response RemoveParticipants(string roomId, System.Collections.Generic.IEnumerable<Azure.Communication.CommunicationIdentifier> communicationIdentifiers, System.Threading.CancellationToken cancellationToken = default(System.Threading.CancellationToken)) { throw null; }
+        public virtual System.Threading.Tasks.Task<Azure.Response> RemoveParticipantsAsync(string roomId, System.Collections.Generic.IEnumerable<Azure.Communication.CommunicationIdentifier> communicationIdentifiers, System.Threading.CancellationToken cancellationToken = default(System.Threading.CancellationToken)) { throw null; }
+        public virtual Azure.Response UpdateParticipants(string roomId, System.Collections.Generic.IEnumerable<Azure.Communication.Rooms.RoomParticipant> participants = null, System.Threading.CancellationToken cancellationToken = default(System.Threading.CancellationToken)) { throw null; }
+        public virtual System.Threading.Tasks.Task<Azure.Response> UpdateParticipantsAsync(string roomId, System.Collections.Generic.IEnumerable<Azure.Communication.Rooms.RoomParticipant> participants = null, System.Threading.CancellationToken cancellationToken = default(System.Threading.CancellationToken)) { throw null; }
+        public virtual Azure.Response<Azure.Communication.Rooms.CommunicationRoom> UpdateRoom(string roomId, System.DateTimeOffset? validFrom = default(System.DateTimeOffset?), System.DateTimeOffset? validUntil = default(System.DateTimeOffset?), Azure.Communication.Rooms.RoomJoinPolicy? roomJoinPolicy = default(Azure.Communication.Rooms.RoomJoinPolicy?), System.Collections.Generic.IEnumerable<Azure.Communication.Rooms.RoomParticipant> participants = null, System.Threading.CancellationToken cancellationToken = default(System.Threading.CancellationToken)) { throw null; }
+        public virtual System.Threading.Tasks.Task<Azure.Response<Azure.Communication.Rooms.CommunicationRoom>> UpdateRoomAsync(string roomId, System.DateTimeOffset? validFrom = default(System.DateTimeOffset?), System.DateTimeOffset? validUntil = default(System.DateTimeOffset?), Azure.Communication.Rooms.RoomJoinPolicy? roomJoinPolicy = default(Azure.Communication.Rooms.RoomJoinPolicy?), System.Collections.Generic.IEnumerable<Azure.Communication.Rooms.RoomParticipant> participants = null, System.Threading.CancellationToken cancellationToken = default(System.Threading.CancellationToken)) { throw null; }
+    }
+    public partial class RoomsClientOptions : Azure.Core.ClientOptions
+    {
+        public RoomsClientOptions(Azure.Communication.Rooms.RoomsClientOptions.ServiceVersion version = Azure.Communication.Rooms.RoomsClientOptions.ServiceVersion.V2022_02_01_Preview) { }
+        public enum ServiceVersion
+        {
+            V2021_04_07_Preview = 1,
+            V2022_02_01_Preview = 2,
+        }
+    }
+}

sdk/communication/Azure.Communication.Rooms/src/Azure.Communication.Rooms.csproj

@@ -0,0 +1,34 @@
+<Project Sdk="Microsoft.NET.Sdk">
+  <PropertyGroup>
+    <Description>
+      This Client library enables working with the Microsoft Azure Communication Rooms Service.
+    </Description>
+    <AssemblyTitle>Azure Communication Rooms Service</AssemblyTitle>
+    <Version>1.0.0-beta.1</Version>
+    <PackageTags>Microsoft Azure Communication Rooms Service;Microsoft;Azure;Azure Communication Service;Azure Communication Rooms Service;Rooms;Communication;$(PackageCommonTags)</PackageTags>
+    <TargetFrameworks>$(RequiredTargetFrameworks)</TargetFrameworks>
+    <IncludeOperationsSharedSource>true</IncludeOperationsSharedSource>
+  </PropertyGroup>
+
+  <ItemGroup>
+    <None Include="..\README.md" Link="README.md" />
+  </ItemGroup>
+
+  <ItemGroup>
+    <PackageReference Include="Azure.Core" />
+    <PackageReference Include="System.Text.Json" />
+  </ItemGroup>
+
+  <!-- Shared source from Azure.Core -->
+  <ItemGroup>
+    <Compile Include="..\..\Shared\src\ClientOptionsExtensions.cs" LinkBase="Shared\Communication" />
+    <Compile Include="..\..\Shared\src\HMACAuthenticationPolicy.cs" LinkBase="Shared\Communication" />
+    <Compile Include="$(AzureCoreSharedSources)ArrayBufferWriter.cs" LinkBase="Shared" />
+    <Compile Include="$(AzureCoreSharedSources)AzureResourceProviderNamespaceAttribute.cs" LinkBase="Shared" />
+    <Compile Include="$(AzureCoreSharedSources)ConnectionString.cs" LinkBase="Shared" />
+  </ItemGroup>
+  
+  <ItemGroup>
+    <PackageReference Include="Azure.Communication.Common" />
+  </ItemGroup>
+</Project>