Azure Communication Common Java

import com.azure.communication.common.CommunicationTokenCredential;
// Simple static token - no refreshString userToken = "<user-access-token>";CommunicationTokenCredential credential = new CommunicationTokenCredential(userToken);
// Use with Chat, Calling, etc.ChatClient chatClient = new ChatClientBuilder()    .endpoint("https://<resource>.communication.azure.com")    .credential(credential)    .buildClient();

import com.azure.communication.common.CommunicationTokenRefreshOptions;import java.util.concurrent.Callable;
// Token refresher callback - called when token is about to expireCallable<String> tokenRefresher = () -> {    // Call your server to get a fresh token    return fetchNewTokenFromServer();};
// With proactive refreshCommunicationTokenRefreshOptions refreshOptions = new CommunicationTokenRefreshOptions(tokenRefresher)    .setRefreshProactively(true)      // Refresh before expiry    .setInitialToken(currentToken);    // Optional initial token
CommunicationTokenCredential credential = new CommunicationTokenCredential(refreshOptions);

import java.util.concurrent.CompletableFuture;
// Async token fetcherCallable<String> asyncRefresher = () -> {    CompletableFuture<String> future = fetchTokenAsync();    return future.get();  // Block until token is available};
CommunicationTokenRefreshOptions options = new CommunicationTokenRefreshOptions(asyncRefresher)    .setRefreshProactively(true);
CommunicationTokenCredential credential = new CommunicationTokenCredential(options);

import com.azure.identity.InteractiveBrowserCredentialBuilder;import com.azure.communication.common.EntraCommunicationTokenCredentialOptions;import java.util.Arrays;import java.util.List;
// For Teams Phone ExtensibilityInteractiveBrowserCredential entraCredential = new InteractiveBrowserCredentialBuilder()    .clientId("<your-client-id>")    .tenantId("<your-tenant-id>")    .redirectUrl("<your-redirect-uri>")    .build();
String resourceEndpoint = "https://<resource>.communication.azure.com";List<String> scopes = Arrays.asList(    "https://auth.msft.communication.azure.com/TeamsExtension.ManageCalls");
EntraCommunicationTokenCredentialOptions entraOptions =     new EntraCommunicationTokenCredentialOptions(entraCredential, resourceEndpoint)        .setScopes(scopes);
CommunicationTokenCredential credential = new CommunicationTokenCredential(entraOptions);

import com.azure.communication.common.CommunicationUserIdentifier;
// Create identifier for ACS userCommunicationUserIdentifier user = new CommunicationUserIdentifier("8:acs:resource-id_user-id");
// Get raw IDString rawId = user.getId();

import com.azure.communication.common.PhoneNumberIdentifier;
// E.164 format phone numberPhoneNumberIdentifier phone = new PhoneNumberIdentifier("+14255551234");
String phoneNumber = phone.getPhoneNumber();  // "+14255551234"String rawId = phone.getRawId();              // "4:+14255551234"

import com.azure.communication.common.MicrosoftTeamsUserIdentifier;
// Teams user identifierMicrosoftTeamsUserIdentifier teamsUser = new MicrosoftTeamsUserIdentifier("<teams-user-id>")    .setCloudEnvironment(CommunicationCloudEnvironment.PUBLIC);
// For anonymous Teams usersMicrosoftTeamsUserIdentifier anonymousTeamsUser = new MicrosoftTeamsUserIdentifier("<teams-user-id>")    .setAnonymous(true);

import com.azure.communication.common.UnknownIdentifier;
// For identifiers of unknown typeUnknownIdentifier unknown = new UnknownIdentifier("some-raw-id");

import com.azure.communication.common.CommunicationIdentifier;import com.azure.communication.common.CommunicationIdentifierModel;
// Parse raw ID to appropriate typepublic CommunicationIdentifier parseIdentifier(String rawId) {    if (rawId.startsWith("8:acs:")) {        return new CommunicationUserIdentifier(rawId);    } else if (rawId.startsWith("4:")) {        String phone = rawId.substring(2);        return new PhoneNumberIdentifier(phone);    } else if (rawId.startsWith("8:orgid:")) {        String teamsId = rawId.substring(8);        return new MicrosoftTeamsUserIdentifier(teamsId);    } else {        return new UnknownIdentifier(rawId);    }}

import com.azure.communication.common.CommunicationIdentifier;
public void processIdentifier(CommunicationIdentifier identifier) {    if (identifier instanceof CommunicationUserIdentifier) {        CommunicationUserIdentifier user = (CommunicationUserIdentifier) identifier;        System.out.println("ACS User: " + user.getId());            } else if (identifier instanceof PhoneNumberIdentifier) {        PhoneNumberIdentifier phone = (PhoneNumberIdentifier) identifier;        System.out.println("Phone: " + phone.getPhoneNumber());            } else if (identifier instanceof MicrosoftTeamsUserIdentifier) {        MicrosoftTeamsUserIdentifier teams = (MicrosoftTeamsUserIdentifier) identifier;        System.out.println("Teams User: " + teams.getUserId());        System.out.println("Anonymous: " + teams.isAnonymous());            } else if (identifier instanceof UnknownIdentifier) {        UnknownIdentifier unknown = (UnknownIdentifier) identifier;        System.out.println("Unknown: " + unknown.getId());    }}

import com.azure.core.credential.AccessToken;
// Get current token (for debugging/logging - don't expose!)CommunicationTokenCredential credential = new CommunicationTokenCredential(token);
// Sync accessAccessToken accessToken = credential.getToken();System.out.println("Token expires: " + accessToken.getExpiresAt());
// Async accesscredential.getTokenAsync()    .subscribe(token -> {        System.out.println("Token: " + token.getToken().substring(0, 20) + "...");        System.out.println("Expires: " + token.getExpiresAt());    });

// Clean up when donecredential.close();
// Or use try-with-resourcestry (CommunicationTokenCredential cred = new CommunicationTokenCredential(options)) {    // Use credential    chatClient.doSomething();}

import com.azure.communication.common.CommunicationCloudEnvironment;
// Available environmentsCommunicationCloudEnvironment publicCloud = CommunicationCloudEnvironment.PUBLIC;CommunicationCloudEnvironment govCloud = CommunicationCloudEnvironment.GCCH;CommunicationCloudEnvironment dodCloud = CommunicationCloudEnvironment.DOD;
// Set on Teams identifierMicrosoftTeamsUserIdentifier teamsUser = new MicrosoftTeamsUserIdentifier("<user-id>")    .setCloudEnvironment(CommunicationCloudEnvironment.GCCH);

// Pattern: Create credential for Chat/Calling clientpublic ChatClient createChatClient(String token, String endpoint) {    CommunicationTokenRefreshOptions refreshOptions =         new CommunicationTokenRefreshOptions(this::refreshToken)            .setRefreshProactively(true)            .setInitialToken(token);        CommunicationTokenCredential credential =         new CommunicationTokenCredential(refreshOptions);        return new ChatClientBuilder()        .endpoint(endpoint)        .credential(credential)        .buildClient();}
private String refreshToken() {    // Call your token endpoint    return tokenService.getNewToken();}