Communication phonenumbers siprouting (Azure#22248)

### Packages impacted by this PR
communication\communication-phone-numbers

### Issues associated with this PR
[User Story](https://skype.visualstudio.com/SPOOL/_workitems/edit/2532740)

### Describe the problem that is addressed by this PR
The PR adds the sipRoutingClient into the communication-phone-numbers SDK. 
The client enables the management of SIP routing configuration for direct routing numbers.

API supports GET and PATCH requests.
Each Azure Communication resource has exactly one SIP configuration.
The configuration contains of a dictionary of trunks and a list of routes.
The trunks allow for partial updates, the configuration is merged with the incoming trunk dictionary. 
The routes don’t allow for partial updates, the whole list is replaced by the incoming list (if it is present on PATCH request).

The sipRoutingClient provides more straightforward methods to retrieve and manage SIP trunks and routes.

[Swagger](https://raw.githubusercontent.com/Azure/azure-rest-api-specs/15d66311cc2b64f04692fdf021d1b235b538e1bc/specification/communication/data-plane/SipRouting/preview/2021-05-01-preview/communicationservicessiprouting.json)
[Examples](https://github.com/jannovak-msft/azure-sdk-for-js/tree/communication-phonenumbers-siprouting/sdk/communication/communication-phone-numbers/samples/v1/typescript/src/siprouting)

![image](https://user-images.githubusercontent.com/81623717/187804144-da7ef4f7-30e5-47af-8ea8-2848284f30a2.png)


### What are the possible designs available to address the problem? If there are more than one possible design, why was the one in this PR chosen?


### Are there test cases added in this PR? _(If not, why?)_


### Provide a list of related PRs _(if any)_


### Command used to generate this PR:**_(Applicable only to SDK release request PRs)_

### Checklists
- [x] Added impacted package name to the issue description
- [ ] Does this PR needs any fixes in the SDK Generator?** _(If so, create an Issue in the [Autorest/typescript](https://github.com/Azure/autorest.typescript) repository and link it here)_
- [ ] Added a changelog (if necessary)

Author: jannovak-msft

sdk/communication/communication-phone-numbers/README.md

@@ -25,24 +25,39 @@ To use this client library in the browser, first you need to use a bundler. For
 
 ## Key concepts
 
-The phone numbers package exposes the `PhoneNumbersClient` which provides methods to manage phone numbers.
+This SDK provides functionality to easily manage `direct offer` and `direct routing` numbers.
 
-### Phone number types
+The `direct offer` numbers come in two types: Geographic and Toll-Free. Geographic phone plans are phone plans associated with a location, whose phone numbers' area codes are associated with the area code of a geographic location. Toll-Free phone plans are phone plans not associated location. For example, in the US, toll-free numbers can come with area codes such as 800 or 888.
+They are managed using the `PhoneNumbersClient`
+
+The `direct routing` feature enables connecting your existing telephony infrastructure to ACS.
+The configuration is managed using the `SipRoutingClient`, which provides methods for setting up SIP trunks and voice routing rules, in order to properly handle calls for your telephony subnet.
+
+### Phone numbers client
+
+#### Phone number types
 
 Phone numbers come in two types; Geographic and Toll-Free. Geographic phone numbers are phone numbers associated with a location, whose area codes are associated with the area code of a geographic location. Toll-Free phone numbers are not associated with a location. For example, in the US, toll-free numbers can come with area codes such as 800 or 888.
 
 All geographic phone numbers within the same country are grouped into a phone plan group with a Geographic phone number type. All Toll-Free phone numbers within the same country are grouped into a phone plan group.
 
-### Searching and acquiring numbers
+#### Searching and acquiring numbers
 
 Phone numbers can be searched through the search creation API by providing a phone number type (geographic or toll-free), assignment type (person or application), calling and sms capabilities, an area code and quantity of phone numbers. The provided quantity of phone numbers will be reserved for 15 minutes. This search of phone numbers can either be cancelled or purchased. If the search is cancelled, then the phone numbers will become available to others. If the search is purchased, then the phone numbers are acquired for the Azure resource.
 
-### Configuring phone numbers
+#### Configuring phone numbers
 
 Phone numbers can have a combination of capabilities. They can be configured to support inbound and/or outbound calling, or neither if you won't use the phone number for calling. The same applies to sms capabilities.
 
 It is important to consider the assignment type of your phone number. Some capabilities are restricted to a particular assignment type.
 
+### SIP routing client
+
+Direct routing feature allows connecting customer-provided telephony infrastructure to Azure Communication Resources. In order to setup routing configuration properly, customer needs to supply the SIP trunk configuration and SIP routing rules for calls. SIP routing client provides the necessary interface for setting this configuration.
+
+When the call arrives, system tries to match the destination number with regex number patterns of defined routes. The first route to match the number will be selected. The order of regex matching is the same as the order of routes in configuration, therefore the order of routes matters.
+Once a route is matched, the call is routed to the first trunk in the route's trunks list. If the trunk is not available, next trunk in the list is selected.
+
 ## Examples
 
 ## Authentication
@@ -51,7 +66,7 @@ To create a client object to access the Communication Services API, you will nee
 
 You can get a key and/or connection string from your Communication Services resource in the [Azure Portal][azure_portal]. You can also find the endpoint for your Communication Services resource in the [Azure Portal][azure_portal].
 
-Once you have a key, you can authenticate the `PhoneNumbersClient` with any of the following methods:
+Once you have a key, you can authenticate the client with any of the following methods:
 
 ### Using a connection string
 
@@ -62,6 +77,13 @@ const connectionString = "endpoint=<endpoint>;accessKey=<accessKey>";
 const client = new PhoneNumbersClient(connectionString);
 ```
 
+```typescript
+import { SipRoutingClient } from "@azure/communication-phone-numbers";
+
+const connectionString = "endpoint=<endpoint>;accessKey=<accessKey>";
+const client = new SipRoutingClient(connectionString);
+```
+
 ### Using an access key with `AzureKeyCredential`
 
 If you use a key to initialize the client you will also need to provide the appropriate endpoint. You can get this endpoint from your Communication Services resource in [Azure Portal][azure_portal]. Once you have a key and endpoint, you can authenticate with the following code:
@@ -74,6 +96,14 @@ const credential = new AzureKeyCredential("<key-from-resource>");
 const client = new PhoneNumbersClient("<endpoint-from-resource>", credential);
 ```
 
+```typescript
+import { AzureKeyCredential } from "@azure/core-auth";
+import { SipRoutingClient } from "@azure/communication-phone-numbers";
+
+const credential = new AzureKeyCredential("<key-from-resource>");
+const client = new SipRoutingClient("<endpoint-from-resource>", credential);
+```
+
 ### Using an Azure Active Directory Credential
 
 Connection string authentication is used in most of the examples, but you can also authenticate with Azure Active Directory using the [Azure Identity library][azure_identity]. To use the [DefaultAzureCredential][defaultazurecredential] provider shown below, or other credential providers provided with the Azure SDK, please install the [`@azure/identity`][azure_identity] package:
@@ -92,18 +122,36 @@ let credential = new DefaultAzureCredential();
 const client = new PhoneNumbersClient("<endpoint-from-resource>", credential);
 ```
 
+```typescript
+import { DefaultAzureCredential } from "@azure/identity";
+import { SipRoutingClient } from "@azure/communication-phone-numbers";
+
+let credential = new DefaultAzureCredential();
+const client = new SipRoutingClient("<endpoint-from-resource>", credential);
+```
+
 ## Usage
 
 The following sections provide code snippets that cover some of the common tasks using the Azure Communication Services Phone Numbers client. The scenarios that are covered here consist of:
 
+PhoneNumbersClient
 - [Search for available phone numbers](#search-for-available-phone-numbers)
 - [Purchase phone numbers from a search](#purchase-phone-numbers-from-a-search)
 - [Release a purchased phone number](#release-a-purchased-phone-number)
 - [Update phone number capabilities](#update-phone-number-capabilities)
 - [Get a purchased phone number](#get-a-purchased-phone-number)
 - [List purchased phone numbers](#list-purchased-phone-numbers)
 
-### Search for available phone numbers
+SipRoutingClient
+- [Retrieve SIP trunks and routes](#retrieve-sip-trunks-and-routes)
+- [Replace SIP trunks and routes](#replace-sip-trunks-and-routes)
+- [Retrieve single trunk](#retrieve-single-trunk)
+- [Set single trunk](#set-single-trunk)
+- [Delete single trunk](#delete-single-trunk)
+
+### PhoneNumbersClient
+
+#### Search for available phone numbers
 
 Use the `beginSearchAvailablePhoneNumbers` method to search for phone numbers and reserve them. The phone numbers returned are reserved for 15 minutes and can be purchased during this period by providing the `searchId` to the `beginPurchasePhoneNumbers` method.
 
@@ -141,7 +189,7 @@ async function main() {
 main();
 ```
 
-### Purchase phone numbers from a search
+#### Purchase phone numbers from a search
 
 Use the `beginPurchasePhoneNumbers` method to purchase the phone numbers from your search. Purchased phone numbers will be assigned to the Communication Services resource used when initiating the client. The `searchId` returned from `beginSearchAvailablePhoneNumbers` is required.
 
@@ -180,7 +228,7 @@ async function main() {
 main();
 ```
 
-### Release a purchased phone number
+#### Release a purchased phone number
 
 Use the `beginReleasePhoneNumber` method to release a previously purchased phone number. Released phone numbers will no longer be associated with the Communication Services resource, and will not be available for use with other operations (eg. SMS) of the resource. The phone number being released is required.
 
@@ -205,7 +253,7 @@ async function main() {
 main();
 ```
 
-### Update phone number capabilities
+#### Update phone number capabilities
 
 Use the `beginUpdatePhoneNumberCapabilities` method to update the capabilities of a purchased phone number. Phone numbers can be configured to support inbound and/or outbound calling and sms, or neither.
 
@@ -242,7 +290,7 @@ async function main() {
 main();
 ```
 
-### Get a purchased phone number
+#### Get a purchased phone number
 
 Use the `getPurchasedPhoneNumber` method to get information about a purchased phone number. This information includes the phone number's type, capabilities, cost, and purchase date.
 
@@ -264,7 +312,7 @@ async main function() {
 main();
 ```
 
-### List purchased phone numbers
+#### List purchased phone numbers
 
 Use the `listPurchasedPhoneNumbers` method to page through all purchased phone numbers.
 
@@ -286,6 +334,126 @@ async main function() {
 main();
 ```
 
+### SipRoutingClient
+
+#### Retrieve SIP trunks and routes
+
+Get the list of currently configured trunks or routes.
+
+```typescript
+import { SipRoutingClient } from "@azure/communication-phone-numbers";
+
+const connectionString = "endpoint=<endpoint>;accessKey=<accessKey>";
+const client = new SipRoutingClient(connectionString);
+
+async function main() {
+  const trunks = await client.getTrunks();
+  const routes = await client.getRoutes();
+  for (const trunk of trunks) {
+    console.log(`Trunk ${trunk.fqdn}:${trunk.sipSignalingPort}`);
+  }
+  
+  for (const route of routes) {
+    console.log(`Route ${route.name} with pattern ${route.numberPattern}`);
+    console.log(`Route's trunks: ${route.trunks?.join()}`);
+  }
+}
+
+main();
+```
+
+#### Replace SIP trunks and routes
+
+Replace the list of currently configured trunks or routes with new values.
+
+```typescript
+import { SipRoutingClient } from "@azure/communication-phone-numbers";
+
+const connectionString = "endpoint=<endpoint>;accessKey=<accessKey>";
+const client = new SipRoutingClient(connectionString);
+
+async function main() {
+  await client.setTrunks([
+    {
+      fqdn: 'sbc.one.domain.com',
+      sipSignalingPort: 1234
+    },{
+      fqdn: 'sbc.two.domain.com',
+      sipSignalingPort: 1234
+    }
+  ]);
+
+  await client.setRoutes([
+    {
+      name: "First Route",
+      description: "route's description",
+      numberPattern: "^\+[1-9][0-9]{3,23}$",
+      trunks: [ 'sbc.one.domain.com' ]
+    },{
+      name: "Second Route",
+      description: "route's description",
+      numberPattern: "^.*$",
+      trunks: [ 'sbc.two.domain.com', 'sbc.one.domain.com' ]
+    }
+  ]);
+}
+
+main();
+```
+
+#### Retrieve single trunk
+
+```typescript
+import { SipRoutingClient } from "@azure/communication-phone-numbers";
+
+const connectionString = "endpoint=<endpoint>;accessKey=<accessKey>";
+const client = new SipRoutingClient(connectionString);
+
+async function main() {
+  const trunk = await client.getTrunk('sbc.one.domain.com');
+  if (trunk) {
+    console.log(`Trunk ${trunk.fqdn}:${trunk.sipSignalingPort}`);
+  } else {
+      console.log('Trunk not found')
+  }
+}
+
+main();
+```
+
+#### Set single trunk
+
+```typescript
+import { SipRoutingClient } from "@azure/communication-phone-numbers";
+
+const connectionString = "endpoint=<endpoint>;accessKey=<accessKey>";
+const client = new SipRoutingClient(connectionString);
+
+async function main() {
+  await client.setTrunk({
+    fqdn: 'sbc.one.domain.com',
+    sipSignalingPort: 4321
+  });
+}
+
+main();
+```
+
+#### Delete single trunk
+
+```typescript
+import { SipRoutingClient } from "@azure/communication-phone-numbers";
+
+const connectionString = "endpoint=<endpoint>;accessKey=<accessKey>";
+const client = new SipRoutingClient(connectionString);
+
+async function main() {
+  await client.deleteTrunk('sbc.one.domain.com');
+}
+
+main();
+```
+
 ## Troubleshooting
 
 ## Next steps

sdk/communication/communication-phone-numbers/karma.conf.js

@@ -1,12 +1,9 @@
 // https://github.com/karma-runner/karma-chrome-launcher
 process.env.CHROME_BIN = require("puppeteer").executablePath();
 require("dotenv").config();
-const {
-  jsonRecordingFilterFunction,
-  isPlaybackMode,
-  isSoftRecordMode,
-  isRecordMode,
-} = require("@azure-tools/test-recorder");
+const { relativeRecordingsPath } = require("@azure-tools/test-recorder");
+
+process.env.RECORDINGS_RELATIVE_PATH = relativeRecordingsPath();
 
 // Get all variables containing the available phone numbers per test agent.
 // E.g. -> AZURE_PHONE_NUMBER_windows_2019_node12
@@ -34,14 +31,10 @@ module.exports = function (config) {
       "karma-coverage",
       "karma-sourcemap-loader",
       "karma-junit-reporter",
-      "karma-json-to-file-reporter",
-      "karma-json-preprocessor",
     ],
 
     // list of files / patterns to load in the browser
-    files: ["dist-test/index.browser.js"].concat(
-      isPlaybackMode() || isSoftRecordMode() ? ["recordings/browsers/**/*.json"] : []
-    ),
+    files: ["dist-test/index.browser.js"],
 
     // list of files / patterns to exclude
     exclude: [],
@@ -50,7 +43,6 @@ module.exports = function (config) {
     // available preprocessors: https://npmjs.org/browse/keyword/karma-preprocessor
     preprocessors: {
       "**/*.js": ["sourcemap", "env"],
-      "recordings/browsers/**/*.json": ["json"],
       // IMPORTANT: COMMENT following line if you want to debug in your browsers!!
       // Preprocess source file to calculate code coverage, however this will make source file unreadable
       //"dist-test/index.browser.js": ["coverage"]
@@ -72,13 +64,14 @@ module.exports = function (config) {
       "SKIP_UPDATE_CAPABILITIES_LIVE_TESTS",
       "AZURE_TEST_AGENT",
       "AZURE_USERAGENT_OVERRIDE",
+      "RECORDINGS_RELATIVE_PATH",
       ...getPhoneNumberPoolEnvVars(),
     ],
 
     // test results reporter to use
     // possible values: 'dots', 'progress'
     // available reporters: https://npmjs.org/browse/keyword/karma-reporter
-    reporters: ["mocha", "coverage", "junit", "json-to-file"],
+    reporters: ["mocha", "coverage", "junit"],
 
     coverageReporter: {
       // specify a common output directory
@@ -101,11 +94,6 @@ module.exports = function (config) {
       properties: {}, // key value pair of properties to add to the <properties> section of the report
     },
 
-    jsonToFileReporter: {
-      filter: jsonRecordingFilterFunction,
-      outputPath: ".",
-    },
-
     // web server port
     port: 9876,
 
@@ -142,9 +130,6 @@ module.exports = function (config) {
     browserNoActivityTimeout: 600000,
     browserDisconnectTimeout: 10000,
     browserDisconnectTolerance: 3,
-    browserConsoleLogOptions: {
-      terminal: !isRecordMode(),
-    },
 
     client: {
       mocha: {