twilio 5.8.2 → 5.10.0

package/README.md

@@ -38,6 +38,7 @@ TypeScript is supported for TypeScript version 2.9 and above.
 
 To make sure the installation was successful, try sending yourself an SMS message, like this:
 
+**CommonJS:**
 ```js
 // Your AccountSID and Auth Token from console.twilio.com
 const accountSid = 'ACXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX';
@@ -54,6 +55,25 @@ client.messages
   .then((message) => console.log(message.sid));
 ```
 
+**ESM/ES6 Modules:**
+```js
+// Your AccountSID and Auth Token from console.twilio.com
+import twilio from 'twilio';
+
+const accountSid = 'ACXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX';
+const authToken = 'your_auth_token';
+
+const client = twilio(accountSid, authToken);
+
+client.messages
+  .create({
+    body: 'Hello from twilio-node',
+    to: '+12345678901', // Text your number
+    from: '+12345678901', // From a valid Twilio number
+  })
+  .then((message) => console.log(message.sid));
+```
+
 After a brief delay, you will receive the text message on your phone.
 
 > **Warning**
@@ -80,6 +100,7 @@ If your environment requires SSL decryption, you can set the path to CA bundle i
 
 If you invoke any V2010 operations without specifying an account SID, `twilio-node` will automatically use the `TWILIO_ACCOUNT_SID` value that the client was initialized with. This is useful for when you'd like to, for example, fetch resources for your main account but also your subaccount. See below:
 
+**CommonJS:**
 ```javascript
 // Your Account SID, Subaccount SID Auth Token from console.twilio.com
 const accountSid = process.env.TWILIO_ACCOUNT_SID;
@@ -91,10 +112,25 @@ const mainAccountCalls = client.api.v2010.account.calls.list; // SID not specifi
 const subaccountCalls = client.api.v2010.account(subaccountSid).calls.list; // SID specified as subaccountSid
 ```
 
+**ESM/ES6 Modules:**
+```javascript
+// Your Account SID, Subaccount SID Auth Token from console.twilio.com
+import twilio from 'twilio';
+
+const accountSid = process.env.TWILIO_ACCOUNT_SID;
+const authToken = process.env.TWILIO_AUTH_TOKEN;
+const subaccountSid = process.env.TWILIO_ACCOUNT_SUBACCOUNT_SID;
+
+const client = twilio(accountSid, authToken);
+const mainAccountCalls = client.api.v2010.account.calls.list; // SID not specified, so defaults to accountSid
+const subaccountCalls = client.api.v2010.account(subaccountSid).calls.list; // SID specified as subaccountSid
+```
+
 ### Lazy Loading
 
 `twilio-node` supports lazy loading required modules for faster loading time. Lazy loading is enabled by default. To disable lazy loading, simply instantiate the Twilio client with the `lazyLoading` flag set to `false`:
 
+**CommonJS:**
 ```javascript
 // Your Account SID and Auth Token from console.twilio.com
 const accountSid = process.env.TWILIO_ACCOUNT_SID;
@@ -105,6 +141,19 @@ const client = require('twilio')(accountSid, authToken, {
 });
 ```
 
+**ESM/ES6 Modules:**
+```javascript
+// Your Account SID and Auth Token from console.twilio.com
+import twilio from 'twilio';
+
+const accountSid = process.env.TWILIO_ACCOUNT_SID;
+const authToken = process.env.TWILIO_AUTH_TOKEN;
+
+const client = twilio(accountSid, authToken, {
+  lazyLoading: false,
+});
+```
+
 ### Enable Auto-Retry with Exponential Backoff
 
 `twilio-node` supports automatic retry with exponential backoff when API requests receive an [Error 429 response](https://support.twilio.com/hc/en-us/articles/360044308153-Twilio-API-response-Error-429-Too-Many-Requests-). This retry with exponential backoff feature is disabled by default. To enable this feature, instantiate the Twilio client with the `autoRetry` flag set to `true`.
@@ -270,6 +319,60 @@ try {
 }
 ```
 
+#### Using RestException for Better Error Handling
+
+For more specific error handling, you can import and use `RestException` directly:
+
+**ESM/ES6 Modules:**
+```js
+import twilio from 'twilio';
+const { RestException } = twilio;
+
+const client = twilio(accountSid, authToken);
+
+try {
+  const message = await client.messages.create({
+    body: 'Hello from Node',
+    to: '+12345678901',
+    from: '+12345678901',
+  });
+  console.log(message);
+} catch (error) {
+  if (error instanceof RestException) {
+    console.log(`Twilio Error ${error.code}: ${error.message}`);
+    console.log(`Status: ${error.status}`);
+    console.log(`More info: ${error.moreInfo}`);
+  } else {
+    console.error('Other error:', error);
+  }
+}
+```
+
+**CommonJS:**
+```js
+const twilio = require('twilio');
+const { RestException } = require('twilio');
+
+const client = twilio(accountSid, authToken);
+
+client.messages
+  .create({
+    body: 'Hello from Node',
+    to: '+12345678901',
+    from: '+12345678901',
+  })
+  .then((message) => console.log(message))
+  .catch((error) => {
+    if (error instanceof RestException) {
+      console.log(`Twilio Error ${error.code}: ${error.message}`);
+      console.log(`Status: ${error.status}`);
+      console.log(`More info: ${error.moreInfo}`);
+    } else {
+      console.error('Other error:', error);
+    }
+  });
+```
+
 If you are using callbacks, error information will be included in the `error` parameter of the callback.
 
 400-level errors are [normal during API operation](https://www.twilio.com/docs/api/rest/request#get-responses) ("Invalid number", "Cannot deliver SMS to that number", for example) and should be handled appropriately.

package/lib/index.d.ts

@@ -2,6 +2,7 @@ import ITwilio from "./rest/Twilio";
 import * as webhooks from "./webhooks/webhooks";
 import IRequestClient from "./base/RequestClient";
 import type { ClientOpts as IClientOpts } from "./base/BaseTwilio";
+import IRestException from "./base/RestException";
 import IAccessToken from "./jwt/AccessToken";
 import IValidationToken from "./jwt/validation/ValidationToken";
 import IClientCapability from "./jwt/ClientCapability";
@@ -40,6 +41,8 @@ declare namespace TwilioSDK {
     }
     type RequestClient = IRequestClient;
     const RequestClient: typeof IRequestClient;
+    type RestException = IRestException;
+    const RestException: typeof IRestException;
     type ClientCredentialProviderBuilder = IClientCredentialProvider.ClientCredentialProviderBuilder;
     const ClientCredentialProviderBuilder: typeof IClientCredentialProvider.ClientCredentialProviderBuilder;
     type OrgsCredentialProviderBuilder = IOrgsCredentialProvider.OrgsCredentialProviderBuilder;

package/lib/index.js

@@ -38,6 +38,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 const Twilio_1 = __importDefault(require("./rest/Twilio"));
 const webhooks = __importStar(require("./webhooks/webhooks"));
 const RequestClient_1 = __importDefault(require("./base/RequestClient"));
+const RestException_1 = __importDefault(require("./base/RestException"));
 const AccessToken_1 = __importDefault(require("./jwt/AccessToken"));
 const ValidationToken_1 = __importDefault(require("./jwt/validation/ValidationToken"));
 const ClientCapability_1 = __importDefault(require("./jwt/ClientCapability"));
@@ -73,6 +74,7 @@ function TwilioSDK(accountSid, authToken, opts) {
         twiml.FaxResponse = FaxResponse_1.default;
     })(twiml = TwilioSDK.twiml || (TwilioSDK.twiml = {}));
     TwilioSDK.RequestClient = RequestClient_1.default;
+    TwilioSDK.RestException = RestException_1.default;
     TwilioSDK.ClientCredentialProviderBuilder = ClientCredentialProvider_1.default.ClientCredentialProviderBuilder;
     TwilioSDK.OrgsCredentialProviderBuilder = OrgsCredentialProvider_1.default.OrgsCredentialProviderBuilder;
     TwilioSDK.NoAuthCredentialProvider = NoAuthCredentialProvider_1.default.NoAuthCredentialProvider;

package/lib/rest/NumbersBase.d.ts

@@ -1,9 +1,11 @@
 import Domain from "../base/Domain";
 import V1 from "./numbers/V1";
 import V2 from "./numbers/V2";
+import V3 from "./numbers/V3";
 declare class NumbersBase extends Domain {
     _v1?: V1;
     _v2?: V2;
+    _v3?: V3;
     /**
      * Initialize numbers domain
      *
@@ -12,5 +14,6 @@ declare class NumbersBase extends Domain {
     constructor(twilio: any);
     get v1(): V1;
     get v2(): V2;
+    get v3(): V3;
 }
 export = NumbersBase;

package/lib/rest/NumbersBase.js

@@ -15,6 +15,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 const Domain_1 = __importDefault(require("../base/Domain"));
 const V1_1 = __importDefault(require("./numbers/V1"));
 const V2_1 = __importDefault(require("./numbers/V2"));
+const V3_1 = __importDefault(require("./numbers/V3"));
 class NumbersBase extends Domain_1.default {
     /**
      * Initialize numbers domain
@@ -32,5 +33,9 @@ class NumbersBase extends Domain_1.default {
         this._v2 = this._v2 || new V2_1.default(this);
         return this._v2;
     }
+    get v3() {
+        this._v3 = this._v3 || new V3_1.default(this);
+        return this._v3;
+    }
 }
 module.exports = NumbersBase;

package/lib/rest/OauthBase.d.ts

@@ -1,7 +1,9 @@
 import Domain from "../base/Domain";
 import V1 from "./oauth/V1";
+import V2 from "./oauth/V2";
 declare class OauthBase extends Domain {
     _v1?: V1;
+    _v2?: V2;
     /**
      * Initialize oauth domain
      *
@@ -9,5 +11,6 @@ declare class OauthBase extends Domain {
      */
     constructor(twilio: any);
     get v1(): V1;
+    get v2(): V2;
 }
 export = OauthBase;

package/lib/rest/OauthBase.js

@@ -14,6 +14,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 };
 const Domain_1 = __importDefault(require("../base/Domain"));
 const V1_1 = __importDefault(require("./oauth/V1"));
+const V2_1 = __importDefault(require("./oauth/V2"));
 class OauthBase extends Domain_1.default {
     /**
      * Initialize oauth domain
@@ -27,5 +28,9 @@ class OauthBase extends Domain_1.default {
         this._v1 = this._v1 || new V1_1.default(this);
         return this._v1;
     }
+    get v2() {
+        this._v2 = this._v2 || new V2_1.default(this);
+        return this._v2;
+    }
 }
 module.exports = OauthBase;

package/lib/rest/api/v2010/account/availablePhoneNumberCountry/local.d.ts

@@ -9,7 +9,7 @@ import { PhoneNumberCapabilities } from "../../../../../interfaces";
 export interface LocalListInstanceEachOptions {
     /** The area code of the phone numbers to read. Applies to only phone numbers in the US and Canada. */
     areaCode?: number;
-    /** The pattern on which to match phone numbers. Valid characters are `*`, `0-9`, `a-z`, and `A-Z`. The `*` character matches any single digit. For examples, see [Example 2](https://www.twilio.com/docs/phone-numbers/api/availablephonenumberlocal-resource?code-sample=code-find-phone-numbers-by-number-pattern) and [Example 3](https://www.twilio.com/docs/phone-numbers/api/availablephonenumberlocal-resource?code-sample=code-find-phone-numbers-by-character-pattern). If specified, this value must have at least two characters. */
+    /** Matching pattern to identify phone numbers. This pattern can be between 2 and 16 characters long and allows all digits (0-9) and all non-diacritic latin alphabet letters (a-z, A-Z). It accepts four meta-characters: `*`, `%`, `+`, `$`. The `*` and `%` meta-characters can appear multiple times in the pattern. To match wildcards at the beginning or end of the pattern, use `*` to match any single character or `%` to match a sequence of characters. If you use the wildcard patterns, it must include at least two non-meta-characters. To match the beginning of a pattern, start the pattern with `+`. To match the end of the pattern, append the pattern with `$`. These meta-characters can\'t be adjacent to each other. */
     contains?: string;
     /** Whether the phone numbers can receive text messages. Can be: `true` or `false`. */
     smsEnabled?: boolean;
@@ -58,7 +58,7 @@ export interface LocalListInstanceEachOptions {
 export interface LocalListInstanceOptions {
     /** The area code of the phone numbers to read. Applies to only phone numbers in the US and Canada. */
     areaCode?: number;
-    /** The pattern on which to match phone numbers. Valid characters are `*`, `0-9`, `a-z`, and `A-Z`. The `*` character matches any single digit. For examples, see [Example 2](https://www.twilio.com/docs/phone-numbers/api/availablephonenumberlocal-resource?code-sample=code-find-phone-numbers-by-number-pattern) and [Example 3](https://www.twilio.com/docs/phone-numbers/api/availablephonenumberlocal-resource?code-sample=code-find-phone-numbers-by-character-pattern). If specified, this value must have at least two characters. */
+    /** Matching pattern to identify phone numbers. This pattern can be between 2 and 16 characters long and allows all digits (0-9) and all non-diacritic latin alphabet letters (a-z, A-Z). It accepts four meta-characters: `*`, `%`, `+`, `$`. The `*` and `%` meta-characters can appear multiple times in the pattern. To match wildcards at the beginning or end of the pattern, use `*` to match any single character or `%` to match a sequence of characters. If you use the wildcard patterns, it must include at least two non-meta-characters. To match the beginning of a pattern, start the pattern with `+`. To match the end of the pattern, append the pattern with `$`. These meta-characters can\'t be adjacent to each other. */
     contains?: string;
     /** Whether the phone numbers can receive text messages. Can be: `true` or `false`. */
     smsEnabled?: boolean;
@@ -103,7 +103,7 @@ export interface LocalListInstanceOptions {
 export interface LocalListInstancePageOptions {
     /** The area code of the phone numbers to read. Applies to only phone numbers in the US and Canada. */
     areaCode?: number;
-    /** The pattern on which to match phone numbers. Valid characters are `*`, `0-9`, `a-z`, and `A-Z`. The `*` character matches any single digit. For examples, see [Example 2](https://www.twilio.com/docs/phone-numbers/api/availablephonenumberlocal-resource?code-sample=code-find-phone-numbers-by-number-pattern) and [Example 3](https://www.twilio.com/docs/phone-numbers/api/availablephonenumberlocal-resource?code-sample=code-find-phone-numbers-by-character-pattern). If specified, this value must have at least two characters. */
+    /** Matching pattern to identify phone numbers. This pattern can be between 2 and 16 characters long and allows all digits (0-9) and all non-diacritic latin alphabet letters (a-z, A-Z). It accepts four meta-characters: `*`, `%`, `+`, `$`. The `*` and `%` meta-characters can appear multiple times in the pattern. To match wildcards at the beginning or end of the pattern, use `*` to match any single character or `%` to match a sequence of characters. If you use the wildcard patterns, it must include at least two non-meta-characters. To match the beginning of a pattern, start the pattern with `+`. To match the end of the pattern, append the pattern with `$`. These meta-characters can\'t be adjacent to each other. */
     contains?: string;
     /** Whether the phone numbers can receive text messages. Can be: `true` or `false`. */
     smsEnabled?: boolean;

package/lib/rest/api/v2010/account/availablePhoneNumberCountry/machineToMachine.d.ts

@@ -9,7 +9,7 @@ import { PhoneNumberCapabilities } from "../../../../../interfaces";
 export interface MachineToMachineListInstanceEachOptions {
     /** The area code of the phone numbers to read. Applies to only phone numbers in the US and Canada. */
     areaCode?: number;
-    /** The pattern on which to match phone numbers. Valid characters are `*`, `0-9`, `a-z`, and `A-Z`. The `*` character matches any single digit. For examples, see [Example 2](https://www.twilio.com/docs/phone-numbers/api/availablephonenumber-resource#local-get-basic-example-2) and [Example 3](https://www.twilio.com/docs/phone-numbers/api/availablephonenumber-resource#local-get-basic-example-3). If specified, this value must have at least two characters. */
+    /** Matching pattern to identify phone numbers. This pattern can be between 2 and 16 characters long and allows all digits (0-9) and all non-diacritic latin alphabet letters (a-z, A-Z). It accepts four meta-characters: `*`, `%`, `+`, `$`. The `*` and `%` meta-characters can appear multiple times in the pattern. To match wildcards at the beginning or end of the pattern, use `*` to match any single character or `%` to match a sequence of characters. If you use the wildcard patterns, it must include at least two non-meta-characters. To match the beginning of a pattern, start the pattern with `+`. To match the end of the pattern, append the pattern with `$`. These meta-characters can\'t be adjacent to each other. */
     contains?: string;
     /** Whether the phone numbers can receive text messages. Can be: `true` or `false`. */
     smsEnabled?: boolean;
@@ -58,7 +58,7 @@ export interface MachineToMachineListInstanceEachOptions {
 export interface MachineToMachineListInstanceOptions {
     /** The area code of the phone numbers to read. Applies to only phone numbers in the US and Canada. */
     areaCode?: number;
-    /** The pattern on which to match phone numbers. Valid characters are `*`, `0-9`, `a-z`, and `A-Z`. The `*` character matches any single digit. For examples, see [Example 2](https://www.twilio.com/docs/phone-numbers/api/availablephonenumber-resource#local-get-basic-example-2) and [Example 3](https://www.twilio.com/docs/phone-numbers/api/availablephonenumber-resource#local-get-basic-example-3). If specified, this value must have at least two characters. */
+    /** Matching pattern to identify phone numbers. This pattern can be between 2 and 16 characters long and allows all digits (0-9) and all non-diacritic latin alphabet letters (a-z, A-Z). It accepts four meta-characters: `*`, `%`, `+`, `$`. The `*` and `%` meta-characters can appear multiple times in the pattern. To match wildcards at the beginning or end of the pattern, use `*` to match any single character or `%` to match a sequence of characters. If you use the wildcard patterns, it must include at least two non-meta-characters. To match the beginning of a pattern, start the pattern with `+`. To match the end of the pattern, append the pattern with `$`. These meta-characters can\'t be adjacent to each other. */
     contains?: string;
     /** Whether the phone numbers can receive text messages. Can be: `true` or `false`. */
     smsEnabled?: boolean;
@@ -103,7 +103,7 @@ export interface MachineToMachineListInstanceOptions {
 export interface MachineToMachineListInstancePageOptions {
     /** The area code of the phone numbers to read. Applies to only phone numbers in the US and Canada. */
     areaCode?: number;
-    /** The pattern on which to match phone numbers. Valid characters are `*`, `0-9`, `a-z`, and `A-Z`. The `*` character matches any single digit. For examples, see [Example 2](https://www.twilio.com/docs/phone-numbers/api/availablephonenumber-resource#local-get-basic-example-2) and [Example 3](https://www.twilio.com/docs/phone-numbers/api/availablephonenumber-resource#local-get-basic-example-3). If specified, this value must have at least two characters. */
+    /** Matching pattern to identify phone numbers. This pattern can be between 2 and 16 characters long and allows all digits (0-9) and all non-diacritic latin alphabet letters (a-z, A-Z). It accepts four meta-characters: `*`, `%`, `+`, `$`. The `*` and `%` meta-characters can appear multiple times in the pattern. To match wildcards at the beginning or end of the pattern, use `*` to match any single character or `%` to match a sequence of characters. If you use the wildcard patterns, it must include at least two non-meta-characters. To match the beginning of a pattern, start the pattern with `+`. To match the end of the pattern, append the pattern with `$`. These meta-characters can\'t be adjacent to each other. */
     contains?: string;
     /** Whether the phone numbers can receive text messages. Can be: `true` or `false`. */
     smsEnabled?: boolean;

package/lib/rest/api/v2010/account/availablePhoneNumberCountry/mobile.d.ts

@@ -9,7 +9,7 @@ import { PhoneNumberCapabilities } from "../../../../../interfaces";
 export interface MobileListInstanceEachOptions {
     /** The area code of the phone numbers to read. Applies to only phone numbers in the US and Canada. */
     areaCode?: number;
-    /** The pattern on which to match phone numbers. Valid characters are `*`, `0-9`, `a-z`, and `A-Z`. The `*` character matches any single digit. For examples, see [Example 2](https://www.twilio.com/docs/phone-numbers/api/availablephonenumber-resource#local-get-basic-example-2) and [Example 3](https://www.twilio.com/docs/phone-numbers/api/availablephonenumber-resource#local-get-basic-example-3). If specified, this value must have at least two characters. */
+    /** Matching pattern to identify phone numbers. This pattern can be between 2 and 16 characters long and allows all digits (0-9) and all non-diacritic latin alphabet letters (a-z, A-Z). It accepts four meta-characters: `*`, `%`, `+`, `$`. The `*` and `%` meta-characters can appear multiple times in the pattern. To match wildcards at the beginning or end of the pattern, use `*` to match any single character or `%` to match a sequence of characters. If you use the wildcard patterns, it must include at least two non-meta-characters. To match the beginning of a pattern, start the pattern with `+`. To match the end of the pattern, append the pattern with `$`. These meta-characters can\'t be adjacent to each other. */
     contains?: string;
     /** Whether the phone numbers can receive text messages. Can be: `true` or `false`. */
     smsEnabled?: boolean;
@@ -58,7 +58,7 @@ export interface MobileListInstanceEachOptions {
 export interface MobileListInstanceOptions {
     /** The area code of the phone numbers to read. Applies to only phone numbers in the US and Canada. */
     areaCode?: number;
-    /** The pattern on which to match phone numbers. Valid characters are `*`, `0-9`, `a-z`, and `A-Z`. The `*` character matches any single digit. For examples, see [Example 2](https://www.twilio.com/docs/phone-numbers/api/availablephonenumber-resource#local-get-basic-example-2) and [Example 3](https://www.twilio.com/docs/phone-numbers/api/availablephonenumber-resource#local-get-basic-example-3). If specified, this value must have at least two characters. */
+    /** Matching pattern to identify phone numbers. This pattern can be between 2 and 16 characters long and allows all digits (0-9) and all non-diacritic latin alphabet letters (a-z, A-Z). It accepts four meta-characters: `*`, `%`, `+`, `$`. The `*` and `%` meta-characters can appear multiple times in the pattern. To match wildcards at the beginning or end of the pattern, use `*` to match any single character or `%` to match a sequence of characters. If you use the wildcard patterns, it must include at least two non-meta-characters. To match the beginning of a pattern, start the pattern with `+`. To match the end of the pattern, append the pattern with `$`. These meta-characters can\'t be adjacent to each other. */
     contains?: string;
     /** Whether the phone numbers can receive text messages. Can be: `true` or `false`. */
     smsEnabled?: boolean;
@@ -103,7 +103,7 @@ export interface MobileListInstanceOptions {
 export interface MobileListInstancePageOptions {
     /** The area code of the phone numbers to read. Applies to only phone numbers in the US and Canada. */
     areaCode?: number;
-    /** The pattern on which to match phone numbers. Valid characters are `*`, `0-9`, `a-z`, and `A-Z`. The `*` character matches any single digit. For examples, see [Example 2](https://www.twilio.com/docs/phone-numbers/api/availablephonenumber-resource#local-get-basic-example-2) and [Example 3](https://www.twilio.com/docs/phone-numbers/api/availablephonenumber-resource#local-get-basic-example-3). If specified, this value must have at least two characters. */
+    /** Matching pattern to identify phone numbers. This pattern can be between 2 and 16 characters long and allows all digits (0-9) and all non-diacritic latin alphabet letters (a-z, A-Z). It accepts four meta-characters: `*`, `%`, `+`, `$`. The `*` and `%` meta-characters can appear multiple times in the pattern. To match wildcards at the beginning or end of the pattern, use `*` to match any single character or `%` to match a sequence of characters. If you use the wildcard patterns, it must include at least two non-meta-characters. To match the beginning of a pattern, start the pattern with `+`. To match the end of the pattern, append the pattern with `$`. These meta-characters can\'t be adjacent to each other. */
     contains?: string;
     /** Whether the phone numbers can receive text messages. Can be: `true` or `false`. */
     smsEnabled?: boolean;

package/lib/rest/api/v2010/account/availablePhoneNumberCountry/national.d.ts

@@ -9,7 +9,7 @@ import { PhoneNumberCapabilities } from "../../../../../interfaces";
 export interface NationalListInstanceEachOptions {
     /** The area code of the phone numbers to read. Applies to only phone numbers in the US and Canada. */
     areaCode?: number;
-    /** The pattern on which to match phone numbers. Valid characters are `*`, `0-9`, `a-z`, and `A-Z`. The `*` character matches any single digit. For examples, see [Example 2](https://www.twilio.com/docs/phone-numbers/api/availablephonenumber-resource#local-get-basic-example-2) and [Example 3](https://www.twilio.com/docs/phone-numbers/api/availablephonenumber-resource#local-get-basic-example-3). If specified, this value must have at least two characters. */
+    /** Matching pattern to identify phone numbers. This pattern can be between 2 and 16 characters long and allows all digits (0-9) and all non-diacritic latin alphabet letters (a-z, A-Z). It accepts four meta-characters: `*`, `%`, `+`, `$`. The `*` and `%` meta-characters can appear multiple times in the pattern. To match wildcards at the beginning or end of the pattern, use `*` to match any single character or `%` to match a sequence of characters. If you use the wildcard patterns, it must include at least two non-meta-characters. To match the beginning of a pattern, start the pattern with `+`. To match the end of the pattern, append the pattern with `$`. These meta-characters can\'t be adjacent to each other. */
     contains?: string;
     /** Whether the phone numbers can receive text messages. Can be: `true` or `false`. */
     smsEnabled?: boolean;
@@ -58,7 +58,7 @@ export interface NationalListInstanceEachOptions {
 export interface NationalListInstanceOptions {
     /** The area code of the phone numbers to read. Applies to only phone numbers in the US and Canada. */
     areaCode?: number;
-    /** The pattern on which to match phone numbers. Valid characters are `*`, `0-9`, `a-z`, and `A-Z`. The `*` character matches any single digit. For examples, see [Example 2](https://www.twilio.com/docs/phone-numbers/api/availablephonenumber-resource#local-get-basic-example-2) and [Example 3](https://www.twilio.com/docs/phone-numbers/api/availablephonenumber-resource#local-get-basic-example-3). If specified, this value must have at least two characters. */
+    /** Matching pattern to identify phone numbers. This pattern can be between 2 and 16 characters long and allows all digits (0-9) and all non-diacritic latin alphabet letters (a-z, A-Z). It accepts four meta-characters: `*`, `%`, `+`, `$`. The `*` and `%` meta-characters can appear multiple times in the pattern. To match wildcards at the beginning or end of the pattern, use `*` to match any single character or `%` to match a sequence of characters. If you use the wildcard patterns, it must include at least two non-meta-characters. To match the beginning of a pattern, start the pattern with `+`. To match the end of the pattern, append the pattern with `$`. These meta-characters can\'t be adjacent to each other. */
     contains?: string;
     /** Whether the phone numbers can receive text messages. Can be: `true` or `false`. */
     smsEnabled?: boolean;
@@ -103,7 +103,7 @@ export interface NationalListInstanceOptions {
 export interface NationalListInstancePageOptions {
     /** The area code of the phone numbers to read. Applies to only phone numbers in the US and Canada. */
     areaCode?: number;
-    /** The pattern on which to match phone numbers. Valid characters are `*`, `0-9`, `a-z`, and `A-Z`. The `*` character matches any single digit. For examples, see [Example 2](https://www.twilio.com/docs/phone-numbers/api/availablephonenumber-resource#local-get-basic-example-2) and [Example 3](https://www.twilio.com/docs/phone-numbers/api/availablephonenumber-resource#local-get-basic-example-3). If specified, this value must have at least two characters. */
+    /** Matching pattern to identify phone numbers. This pattern can be between 2 and 16 characters long and allows all digits (0-9) and all non-diacritic latin alphabet letters (a-z, A-Z). It accepts four meta-characters: `*`, `%`, `+`, `$`. The `*` and `%` meta-characters can appear multiple times in the pattern. To match wildcards at the beginning or end of the pattern, use `*` to match any single character or `%` to match a sequence of characters. If you use the wildcard patterns, it must include at least two non-meta-characters. To match the beginning of a pattern, start the pattern with `+`. To match the end of the pattern, append the pattern with `$`. These meta-characters can\'t be adjacent to each other. */
     contains?: string;
     /** Whether the phone numbers can receive text messages. Can be: `true` or `false`. */
     smsEnabled?: boolean;

package/lib/rest/api/v2010/account/availablePhoneNumberCountry/sharedCost.d.ts

@@ -9,7 +9,7 @@ import { PhoneNumberCapabilities } from "../../../../../interfaces";
 export interface SharedCostListInstanceEachOptions {
     /** The area code of the phone numbers to read. Applies to only phone numbers in the US and Canada. */
     areaCode?: number;
-    /** The pattern on which to match phone numbers. Valid characters are `*`, `0-9`, `a-z`, and `A-Z`. The `*` character matches any single digit. For examples, see [Example 2](https://www.twilio.com/docs/phone-numbers/api/availablephonenumber-resource#local-get-basic-example-2) and [Example 3](https://www.twilio.com/docs/phone-numbers/api/availablephonenumber-resource#local-get-basic-example-3). If specified, this value must have at least two characters. */
+    /** Matching pattern to identify phone numbers. This pattern can be between 2 and 16 characters long and allows all digits (0-9) and all non-diacritic latin alphabet letters (a-z, A-Z). It accepts four meta-characters: `*`, `%`, `+`, `$`. The `*` and `%` meta-characters can appear multiple times in the pattern. To match wildcards at the beginning or end of the pattern, use `*` to match any single character or `%` to match a sequence of characters. If you use the wildcard patterns, it must include at least two non-meta-characters. To match the beginning of a pattern, start the pattern with `+`. To match the end of the pattern, append the pattern with `$`. These meta-characters can\'t be adjacent to each other. */
     contains?: string;
     /** Whether the phone numbers can receive text messages. Can be: `true` or `false`. */
     smsEnabled?: boolean;
@@ -58,7 +58,7 @@ export interface SharedCostListInstanceEachOptions {
 export interface SharedCostListInstanceOptions {
     /** The area code of the phone numbers to read. Applies to only phone numbers in the US and Canada. */
     areaCode?: number;
-    /** The pattern on which to match phone numbers. Valid characters are `*`, `0-9`, `a-z`, and `A-Z`. The `*` character matches any single digit. For examples, see [Example 2](https://www.twilio.com/docs/phone-numbers/api/availablephonenumber-resource#local-get-basic-example-2) and [Example 3](https://www.twilio.com/docs/phone-numbers/api/availablephonenumber-resource#local-get-basic-example-3). If specified, this value must have at least two characters. */
+    /** Matching pattern to identify phone numbers. This pattern can be between 2 and 16 characters long and allows all digits (0-9) and all non-diacritic latin alphabet letters (a-z, A-Z). It accepts four meta-characters: `*`, `%`, `+`, `$`. The `*` and `%` meta-characters can appear multiple times in the pattern. To match wildcards at the beginning or end of the pattern, use `*` to match any single character or `%` to match a sequence of characters. If you use the wildcard patterns, it must include at least two non-meta-characters. To match the beginning of a pattern, start the pattern with `+`. To match the end of the pattern, append the pattern with `$`. These meta-characters can\'t be adjacent to each other. */
     contains?: string;
     /** Whether the phone numbers can receive text messages. Can be: `true` or `false`. */
     smsEnabled?: boolean;
@@ -103,7 +103,7 @@ export interface SharedCostListInstanceOptions {
 export interface SharedCostListInstancePageOptions {
     /** The area code of the phone numbers to read. Applies to only phone numbers in the US and Canada. */
     areaCode?: number;
-    /** The pattern on which to match phone numbers. Valid characters are `*`, `0-9`, `a-z`, and `A-Z`. The `*` character matches any single digit. For examples, see [Example 2](https://www.twilio.com/docs/phone-numbers/api/availablephonenumber-resource#local-get-basic-example-2) and [Example 3](https://www.twilio.com/docs/phone-numbers/api/availablephonenumber-resource#local-get-basic-example-3). If specified, this value must have at least two characters. */
+    /** Matching pattern to identify phone numbers. This pattern can be between 2 and 16 characters long and allows all digits (0-9) and all non-diacritic latin alphabet letters (a-z, A-Z). It accepts four meta-characters: `*`, `%`, `+`, `$`. The `*` and `%` meta-characters can appear multiple times in the pattern. To match wildcards at the beginning or end of the pattern, use `*` to match any single character or `%` to match a sequence of characters. If you use the wildcard patterns, it must include at least two non-meta-characters. To match the beginning of a pattern, start the pattern with `+`. To match the end of the pattern, append the pattern with `$`. These meta-characters can\'t be adjacent to each other. */
     contains?: string;
     /** Whether the phone numbers can receive text messages. Can be: `true` or `false`. */
     smsEnabled?: boolean;

package/lib/rest/api/v2010/account/availablePhoneNumberCountry/tollFree.d.ts

@@ -9,7 +9,7 @@ import { PhoneNumberCapabilities } from "../../../../../interfaces";
 export interface TollFreeListInstanceEachOptions {
     /** The area code of the phone numbers to read. Applies to only phone numbers in the US and Canada. */
     areaCode?: number;
-    /** The pattern on which to match phone numbers. Valid characters are `*`, `0-9`, `a-z`, and `A-Z`. The `*` character matches any single digit. For examples, see [Example 2](https://www.twilio.com/docs/phone-numbers/api/availablephonenumber-resource#local-get-basic-example-2) and [Example 3](https://www.twilio.com/docs/phone-numbers/api/availablephonenumber-resource#local-get-basic-example-3). If specified, this value must have at least two characters. */
+    /** Matching pattern to identify phone numbers. This pattern can be between 2 and 16 characters long and allows all digits (0-9) and all non-diacritic latin alphabet letters (a-z, A-Z). It accepts four meta-characters: `*`, `%`, `+`, `$`. The `*` and `%` meta-characters can appear multiple times in the pattern. To match wildcards at the beginning or end of the pattern, use `*` to match any single character or `%` to match a sequence of characters. If you use the wildcard patterns, it must include at least two non-meta-characters. To match the beginning of a pattern, start the pattern with `+`. To match the end of the pattern, append the pattern with `$`. These meta-characters can\'t be adjacent to each other. */
     contains?: string;
     /** Whether the phone numbers can receive text messages. Can be: `true` or `false`. */
     smsEnabled?: boolean;
@@ -58,7 +58,7 @@ export interface TollFreeListInstanceEachOptions {
 export interface TollFreeListInstanceOptions {
     /** The area code of the phone numbers to read. Applies to only phone numbers in the US and Canada. */
     areaCode?: number;
-    /** The pattern on which to match phone numbers. Valid characters are `*`, `0-9`, `a-z`, and `A-Z`. The `*` character matches any single digit. For examples, see [Example 2](https://www.twilio.com/docs/phone-numbers/api/availablephonenumber-resource#local-get-basic-example-2) and [Example 3](https://www.twilio.com/docs/phone-numbers/api/availablephonenumber-resource#local-get-basic-example-3). If specified, this value must have at least two characters. */
+    /** Matching pattern to identify phone numbers. This pattern can be between 2 and 16 characters long and allows all digits (0-9) and all non-diacritic latin alphabet letters (a-z, A-Z). It accepts four meta-characters: `*`, `%`, `+`, `$`. The `*` and `%` meta-characters can appear multiple times in the pattern. To match wildcards at the beginning or end of the pattern, use `*` to match any single character or `%` to match a sequence of characters. If you use the wildcard patterns, it must include at least two non-meta-characters. To match the beginning of a pattern, start the pattern with `+`. To match the end of the pattern, append the pattern with `$`. These meta-characters can\'t be adjacent to each other. */
     contains?: string;
     /** Whether the phone numbers can receive text messages. Can be: `true` or `false`. */
     smsEnabled?: boolean;
@@ -103,7 +103,7 @@ export interface TollFreeListInstanceOptions {
 export interface TollFreeListInstancePageOptions {
     /** The area code of the phone numbers to read. Applies to only phone numbers in the US and Canada. */
     areaCode?: number;
-    /** The pattern on which to match phone numbers. Valid characters are `*`, `0-9`, `a-z`, and `A-Z`. The `*` character matches any single digit. For examples, see [Example 2](https://www.twilio.com/docs/phone-numbers/api/availablephonenumber-resource#local-get-basic-example-2) and [Example 3](https://www.twilio.com/docs/phone-numbers/api/availablephonenumber-resource#local-get-basic-example-3). If specified, this value must have at least two characters. */
+    /** Matching pattern to identify phone numbers. This pattern can be between 2 and 16 characters long and allows all digits (0-9) and all non-diacritic latin alphabet letters (a-z, A-Z). It accepts four meta-characters: `*`, `%`, `+`, `$`. The `*` and `%` meta-characters can appear multiple times in the pattern. To match wildcards at the beginning or end of the pattern, use `*` to match any single character or `%` to match a sequence of characters. If you use the wildcard patterns, it must include at least two non-meta-characters. To match the beginning of a pattern, start the pattern with `+`. To match the end of the pattern, append the pattern with `$`. These meta-characters can\'t be adjacent to each other. */
     contains?: string;
     /** Whether the phone numbers can receive text messages. Can be: `true` or `false`. */
     smsEnabled?: boolean;

package/lib/rest/api/v2010/account/availablePhoneNumberCountry/voip.d.ts

@@ -9,7 +9,7 @@ import { PhoneNumberCapabilities } from "../../../../../interfaces";
 export interface VoipListInstanceEachOptions {
     /** The area code of the phone numbers to read. Applies to only phone numbers in the US and Canada. */
     areaCode?: number;
-    /** The pattern on which to match phone numbers. Valid characters are `*`, `0-9`, `a-z`, and `A-Z`. The `*` character matches any single digit. For examples, see [Example 2](https://www.twilio.com/docs/phone-numbers/api/availablephonenumber-resource#local-get-basic-example-2) and [Example 3](https://www.twilio.com/docs/phone-numbers/api/availablephonenumber-resource#local-get-basic-example-3). If specified, this value must have at least two characters. */
+    /** Matching pattern to identify phone numbers. This pattern can be between 2 and 16 characters long and allows all digits (0-9) and all non-diacritic latin alphabet letters (a-z, A-Z). It accepts four meta-characters: `*`, `%`, `+`, `$`. The `*` and `%` meta-characters can appear multiple times in the pattern. To match wildcards at the beginning or end of the pattern, use `*` to match any single character or `%` to match a sequence of characters. If you use the wildcard patterns, it must include at least two non-meta-characters. To match the beginning of a pattern, start the pattern with `+`. To match the end of the pattern, append the pattern with `$`. These meta-characters can\'t be adjacent to each other. */
     contains?: string;
     /** Whether the phone numbers can receive text messages. Can be: `true` or `false`. */
     smsEnabled?: boolean;
@@ -58,7 +58,7 @@ export interface VoipListInstanceEachOptions {
 export interface VoipListInstanceOptions {
     /** The area code of the phone numbers to read. Applies to only phone numbers in the US and Canada. */
     areaCode?: number;
-    /** The pattern on which to match phone numbers. Valid characters are `*`, `0-9`, `a-z`, and `A-Z`. The `*` character matches any single digit. For examples, see [Example 2](https://www.twilio.com/docs/phone-numbers/api/availablephonenumber-resource#local-get-basic-example-2) and [Example 3](https://www.twilio.com/docs/phone-numbers/api/availablephonenumber-resource#local-get-basic-example-3). If specified, this value must have at least two characters. */
+    /** Matching pattern to identify phone numbers. This pattern can be between 2 and 16 characters long and allows all digits (0-9) and all non-diacritic latin alphabet letters (a-z, A-Z). It accepts four meta-characters: `*`, `%`, `+`, `$`. The `*` and `%` meta-characters can appear multiple times in the pattern. To match wildcards at the beginning or end of the pattern, use `*` to match any single character or `%` to match a sequence of characters. If you use the wildcard patterns, it must include at least two non-meta-characters. To match the beginning of a pattern, start the pattern with `+`. To match the end of the pattern, append the pattern with `$`. These meta-characters can\'t be adjacent to each other. */
     contains?: string;
     /** Whether the phone numbers can receive text messages. Can be: `true` or `false`. */
     smsEnabled?: boolean;
@@ -103,7 +103,7 @@ export interface VoipListInstanceOptions {
 export interface VoipListInstancePageOptions {
     /** The area code of the phone numbers to read. Applies to only phone numbers in the US and Canada. */
     areaCode?: number;
-    /** The pattern on which to match phone numbers. Valid characters are `*`, `0-9`, `a-z`, and `A-Z`. The `*` character matches any single digit. For examples, see [Example 2](https://www.twilio.com/docs/phone-numbers/api/availablephonenumber-resource#local-get-basic-example-2) and [Example 3](https://www.twilio.com/docs/phone-numbers/api/availablephonenumber-resource#local-get-basic-example-3). If specified, this value must have at least two characters. */
+    /** Matching pattern to identify phone numbers. This pattern can be between 2 and 16 characters long and allows all digits (0-9) and all non-diacritic latin alphabet letters (a-z, A-Z). It accepts four meta-characters: `*`, `%`, `+`, `$`. The `*` and `%` meta-characters can appear multiple times in the pattern. To match wildcards at the beginning or end of the pattern, use `*` to match any single character or `%` to match a sequence of characters. If you use the wildcard patterns, it must include at least two non-meta-characters. To match the beginning of a pattern, start the pattern with `+`. To match the end of the pattern, append the pattern with `$`. These meta-characters can\'t be adjacent to each other. */
     contains?: string;
     /** Whether the phone numbers can receive text messages. Can be: `true` or `false`. */
     smsEnabled?: boolean;

package/lib/rest/api/v2010/account/recording.d.ts

@@ -220,7 +220,7 @@ export declare class RecordingInstance {
     priceUnit: string;
     status: RecordingStatus;
     /**
-     * The number of channels in the final recording file. Can be: `1` or `2`. Default: `1`.
+     * The number of channels in the recording resource. For information on specifying the number of channels in the downloaded recording file, check out [Fetch a Recording’s media file](https://www.twilio.com/docs/voice/api/recording#download-dual-channel-media-file).
      */
     channels: number;
     source: RecordingSource;