Feature/callautomation/callinvite

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

@@ -113,41 +113,6 @@ Your app will receive mid-connection call back events via the callbackEndpoint y
         return Ok();
     }
 ```
-### Idempotent Requests
-An operation is idempotent if it can be performed multiple times and have the same result as a single execution.
-
-The following operations are idempotent:
-- `AnswerCall`
-- `RedirectCall`
-- `RejectCall`
-- `CreateCall`
-- `HangUp` when terminating the call for everyone, ie. `forEveryone` parameter is set to `true`.
-- `TransferCallToParticipant`
-- `AddParticipants`
-- `RemoveParticipants`
-- `StartRecording`
-
-By default, SDK generates a new `RepeatabilityHeaders` object every time the above operation is called. If you would
-like to provide your own `RepeatabilityHeaders` for your application (eg. for your own retry mechanism), you can do so by specifying
-the `RepeatabilityHeaders` in the operation's `Options` object. If this is not set by user, then the SDK will generate
-it. You can also disable this by setting `RepeatabilityHeaders` to NULL in the option.
-
-The parameters for the `RepeatabilityHeaders` class are `repeatabilityRequestId` and `repeatabilityFirstSent`. Two or
-more requests are considered the same request **if and only if** both repeatability parameters are the same.
-- `repeatabilityRequestId`: an opaque string representing a client-generated unique identifier for the request.
-It is a version 4 (random) UUID.
-- `repeatabilityFirstSent`: The value should be the date and time at which the request was **first** created.
-
-To set repeatability parameters, see below C# code snippet as an example:
-```C#
-var createCallOptions = new CreateCallOptions(callSource, new CommunicationIdentifier[] { target }, new Uri("https://exmaple.com/callback")) {
-    RepeatabilityHeaders = new RepeatabilityHeaders(Guid.NewGuid(), DateTimeOffset.UtcNow);
-};
-CreateCallResult response1 = await callAutomationClient.CreateCallAsync(createCallOptions).ConfigureAwait(false);
-await Task.Delay(5000);
-CreateCallResult response2 = await callAutomationClient.CreateCallAsync(createCallOptions).ConfigureAwait(false);
-// response1 and response2 will have the same CallConnectionId as they have the same reapeatability parameters which means that the CreateCall operation was only executed once.
-```
 
 ## Troubleshooting
 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.
@@ -188,4 +153,4 @@ This project has adopted the [Microsoft Open Source Code of Conduct][coc]. For m
 [build3]: https://learn.microsoft.com/azure/communication-services/quickstarts/voice-video-calling/play-action?pivots=programming-language-csharp
 [build4]: https://learn.microsoft.com/azure/communication-services/quickstarts/voice-video-calling/recognize-action?pivots=programming-language-csharp
 [recording1]: https://learn.microsoft.com/azure/communication-services/concepts/voice-video-calling/call-recording
-[recording2]: https://learn.microsoft.com/azure/communication-services/quickstarts/voice-video-calling/get-started-call-recording?pivots=programming-language-csharp
+[recording2]: https://learn.microsoft.com/azure/communication-services/quickstarts/voice-video-calling/get-started-call-recording?pivots=programming-language-csharp

sdk/communication/Azure.Communication.CallAutomation/src/CallAutomationClientOptions.cs

@@ -20,16 +20,19 @@ public class CallAutomationClientOptions : ClientOptions
 
         internal string ApiVersion { get; }
 
+        internal CommunicationUserIdentifier Source { get; }
+
         /// <summary>
         /// Initializes a new instance of the <see cref="CallAutomationClientOptions"/>.
         /// </summary>
-        public CallAutomationClientOptions(ServiceVersion version = LatestVersion)
+        public CallAutomationClientOptions(ServiceVersion version = LatestVersion, CommunicationUserIdentifier source = null)
         {
             ApiVersion = version switch
             {
                 ServiceVersion.V2023_01_15_Preview => "2023-01-15-preview",
                 _ => throw new ArgumentOutOfRangeException(nameof(version)),
             };
+            Source = source;
         }
 
         /// <summary>

sdk/communication/Azure.Communication.CallAutomation/src/CallRecording.cs

@@ -74,10 +74,10 @@ public virtual Response<RecordingStateResult> StartRecording(StartRecordingOptio
                     }
                 };
 
-                options.RepeatabilityHeaders?.GenerateIfRepeatabilityHeadersNotProvided();
+                var repeatabilityHeaders = new RepeatabilityHeaders();
                 return _callRecordingRestClient.StartRecording(request,
-                    options.RepeatabilityHeaders?.RepeatabilityRequestId,
-                    options.RepeatabilityHeaders?.GetRepeatabilityFirstSentString(),
+                    repeatabilityHeaders.RepeatabilityRequestId,
+                    repeatabilityHeaders.GetRepeatabilityFirstSentString(),
                     cancellationToken: cancellationToken);
             }
             catch (Exception ex)
@@ -119,10 +119,10 @@ public virtual async Task<Response<RecordingStateResult>> StartRecordingAsync(St
                     }
                 };
 
-                options.RepeatabilityHeaders?.GenerateIfRepeatabilityHeadersNotProvided();
+                var repeatabilityHeaders = new RepeatabilityHeaders();
                 return await _callRecordingRestClient.StartRecordingAsync(request,
-                    options.RepeatabilityHeaders?.RepeatabilityRequestId,
-                    options.RepeatabilityHeaders?.GetRepeatabilityFirstSentString(),
+                    repeatabilityHeaders.RepeatabilityRequestId,
+                    repeatabilityHeaders.GetRepeatabilityFirstSentString(),
                     cancellationToken: cancellationToken).ConfigureAwait(false);
             }
             catch (Exception ex)

sdk/communication/Azure.Communication.CallAutomation/src/EventProcessor/EventResult/AddParticipantsEventResult.cs

@@ -3,20 +3,20 @@
 
 namespace Azure.Communication.CallAutomation
 {
-    /// <summary><see cref="AddParticipantsEventResult"/> is returned from WaitForEvent of <see cref="AddParticipantsResult"/>.</summary>
+    /// <summary><see cref="AddParticipantsEventResult"/> is returned from WaitForEvent of <see cref="AddParticipantResult"/>.</summary>
     public class AddParticipantsEventResult : EventResultBase
     {
         /// <summary>
-        /// <see cref="AddParticipantsSucceeded"/> event will be returned when the participant joined the call successfully.
+        /// <see cref="AddParticipantSucceeded"/> event will be returned when the participant joined the call successfully.
         /// </summary>
-        public AddParticipantsSucceeded SuccessEvent { get; }
+        public AddParticipantSucceeded SuccessEvent { get; }
 
         /// <summary>
-        /// <see cref="AddParticipantsFailed"/> event will be returned when the participant did not join the call.
+        /// <see cref="AddParticipantFailed"/> event will be returned when the participant did not join the call.
         /// </summary>
-        public AddParticipantsFailed FailureEvent { get; }
+        public AddParticipantFailed FailureEvent { get; }
 
-        internal AddParticipantsEventResult(bool isSuccessEvent, AddParticipantsSucceeded successEvent, AddParticipantsFailed failureEvent)
+        internal AddParticipantsEventResult(bool isSuccessEvent, AddParticipantSucceeded successEvent, AddParticipantFailed failureEvent)
         {
             IsSuccessEvent = isSuccessEvent;
             SuccessEvent = successEvent;