[ACS][CallAutomation] Update common version and TeamsAppIdentifier (Azure#29563)

Adding Teams App Identifier to JS library

Co-authored-by: Min Woo Lee 🧊 <[email protected]>

Author: minwoolee-msft

sdk/communication/communication-call-automation/package.json

@@ -75,7 +75,7 @@
   },
   "dependencies": {
     "@azure/abort-controller": "^1.0.0",
-    "@azure/communication-common": "^2.2.0",
+    "@azure/communication-common": "^2.3.1",
     "@azure/core-auth": "^1.3.0",
     "@azure/core-client": "^1.3.0",
     "@azure/core-paging": "^1.1.1",

sdk/communication/communication-call-automation/review/communication-call-automation.api.md

@@ -12,6 +12,7 @@ import { CommunicationIdentifier } from '@azure/communication-common';
 import { CommunicationUserIdentifier } from '@azure/communication-common';
 import * as coreClient from '@azure/core-client';
 import { KeyCredential } from '@azure/core-auth';
+import { MicrosoftTeamsAppIdentifier } from '@azure/communication-common';
 import { MicrosoftTeamsUserIdentifier } from '@azure/communication-common';
 import { OperationOptions } from '@azure/core-client';
 import { PhoneNumberIdentifier } from '@azure/communication-common';
@@ -193,7 +194,7 @@ export interface CallInvite {
     readonly sourceCallIdNumber?: PhoneNumberIdentifier;
     // (undocumented)
     sourceDisplayName?: string;
-    readonly targetParticipant: PhoneNumberIdentifier | CommunicationUserIdentifier | MicrosoftTeamsUserIdentifier;
+    readonly targetParticipant: PhoneNumberIdentifier | CommunicationUserIdentifier | MicrosoftTeamsUserIdentifier | MicrosoftTeamsAppIdentifier;
 }
 
 // @public

sdk/communication/communication-call-automation/src/models/models.ts

@@ -5,6 +5,7 @@ import {
   CommunicationIdentifier,
   CommunicationUserIdentifier,
   MicrosoftTeamsUserIdentifier,
+  MicrosoftTeamsAppIdentifier,
   PhoneNumberIdentifier,
 } from "@azure/communication-common";
 import { CallConnectionStateModel } from "../generated/src";
@@ -169,11 +170,12 @@ export enum RecognizeInputType {
 
 /** Call invitee details. */
 export interface CallInvite {
-  /** The Target's PhoneNumberIdentifier, CommunicationUserIdentifier or MicrosoftTeamsUserIdentifier. */
+  /** The Target's PhoneNumberIdentifier, CommunicationUserIdentifier, MicrosoftTeamsUserIdentifier or MicrosoftTeamsAppIdentifier. */
   readonly targetParticipant:
     | PhoneNumberIdentifier
     | CommunicationUserIdentifier
-    | MicrosoftTeamsUserIdentifier;
+    | MicrosoftTeamsUserIdentifier
+    | MicrosoftTeamsAppIdentifier;
   /** Caller's phone number identifier. */
   readonly sourceCallIdNumber?: PhoneNumberIdentifier;
   sourceDisplayName?: string;

sdk/communication/communication-call-automation/src/utli/converters.ts

@@ -14,6 +14,8 @@ import {
   SerializedCommunicationIdentifier,
   isMicrosoftTeamsUserIdentifier,
   MicrosoftTeamsUserIdentifier,
+  isMicrosoftTeamsAppIdentifier,
+  MicrosoftTeamsAppIdentifier,
 } from "@azure/communication-common";
 import {
   CallParticipantInternal,
@@ -113,6 +115,18 @@ export function communicationIdentifierConverter(
     return microsoftTeamsUserIdentifier;
   }
 
+  if (
+    kind === KnownCommunicationIdentifierModelKind.MicrosoftTeamsApp &&
+    identifierModel.microsoftTeamsApp !== undefined
+  ) {
+    const microsoftTeamsAppIdentifier: MicrosoftTeamsAppIdentifier = {
+      rawId: rawId,
+      teamsAppId: identifierModel.microsoftTeamsApp.appId,
+      cloud: identifierModel.microsoftTeamsApp.cloud as KnownCommunicationCloudEnvironmentModel,
+    };
+    return microsoftTeamsAppIdentifier;
+  }
+
   const unknownIdentifier: UnknownIdentifier = {
     id: rawId ? rawId : "",
   };
@@ -149,6 +163,14 @@ export function communicationIdentifierModelConverter(
     return microsoftTeamsUserIdentifierModel;
   }
 
+  if (isMicrosoftTeamsAppIdentifier(identifier)) {
+    const microsoftTeamsAppIdentifierModel: CommunicationIdentifierModel = {
+      kind: KnownCommunicationIdentifierModelKind.MicrosoftTeamsApp,
+      ...serializedIdentifier,
+    };
+    return microsoftTeamsAppIdentifierModel;
+  }
+
   if (isUnknownIdentifier(identifier)) {
     const unknownIdentifierModel: CommunicationIdentifierModel = {
       kind: KnownCommunicationIdentifierModelKind.Unknown,