chore: sync with main

CHANGES.md

@@ -1,6 +1,38 @@
 twilio-node changelog
 =====================
 
+[2023-10-19] Version 4.19.0
+---------------------------
+**Library - Chore**
+- [PR #966](https://github.com/twilio/twilio-node/pull/966): upgraded semver versions. Thanks to [@sbansla](https://github.com/sbansla)!
+- [PR #964](https://github.com/twilio/twilio-node/pull/964): added feature request issue template. Thanks to [@sbansla](https://github.com/sbansla)!
+
+**Accounts**
+- Updated Safelist metadata to correct the docs.
+- Add Global SafeList API changes
+
+**Api**
+- Added optional parameter `CallToken` for create participant api
+
+**Flex**
+- Adding `offline_config` to Flex Configuration
+
+**Intelligence**
+- Deleted `redacted` parameter from fetching transcript in v2 **(breaking change)**
+
+**Lookups**
+- Add new `phone_number_quality_score` package to the lookup response
+- Remove `disposable_phone_number_risk` package **(breaking change)**
+
+**Messaging**
+- Update US App To Person documentation with current `message_samples` requirements
+
+**Taskrouter**
+- Remove beta_feature check on task_queue_bulk_real_time_statistics endpoint
+- Add `virtual_start_time` property to tasks
+- Updating `task_queue_data` format from `map` to `array` in the response of bulk get endpoint of TaskQueue Real Time Statistics API **(breaking change)**
+
+
 [2023-10-05] Version 4.18.1
 ---------------------------
 **Library - Fix**

package.json

@@ -1,7 +1,7 @@
 {
   "name": "twilio",
   "description": "A Twilio helper library",
-  "version": "4.18.1",
+  "version": "4.19.0",
   "author": "API Team <[email protected]>",
   "contributors": [
     {
@@ -30,23 +30,23 @@
     "xmlbuilder": "^13.0.2"
   },
   "devDependencies": {
-    "@babel/preset-env": "^7.20.2",
+    "@babel/preset-env": "^7.23.0",
     "@babel/preset-typescript": "^7.18.6",
-    "@types/jest": "^29.2.5",
+    "@types/jest": "^29.5.5",
     "@types/jsonwebtoken": "^9.0.0",
     "@types/node": "^18.11.18",
     "@types/qs": "^6.9.7",
     "@types/url-parse": "^1.4.8",
     "babel-plugin-replace-ts-export-assignment": "^0.0.2",
     "eslint": "^8.31.0",
     "express": "^4.17.1",
-    "jest": "^29.3.1",
+    "jest": "^29.5.5",
     "jshint": "^2.11.0",
     "mock-fs": "^5.2.0",
     "nock": "^13.2.9",
     "node-mocks-http": "^1.8.1",
     "prettier": "^2.7.1",
-    "ts-jest": "^29.0.5",
+    "ts-jest": "^29.1.1",
     "typescript": "^4.7.2",
     "typedoc": "^0.23.21"
   },

src/rest/accounts/V1.ts

@@ -16,6 +16,7 @@ import AccountsBase from "../AccountsBase";
 import Version from "../../base/Version";
 import { AuthTokenPromotionListInstance } from "./v1/authTokenPromotion";
 import { CredentialListInstance } from "./v1/credential";
+import { SafelistListInstance } from "./v1/safelist";
 import { SecondaryAuthTokenListInstance } from "./v1/secondaryAuthToken";
 
 export default class V1 extends Version {
@@ -32,6 +33,8 @@ export default class V1 extends Version {
   protected _authTokenPromotion?: AuthTokenPromotionListInstance;
   /** credentials - { Twilio.Accounts.V1.CredentialListInstance } resource */
   protected _credentials?: CredentialListInstance;
+  /** safelist - { Twilio.Accounts.V1.SafelistListInstance } resource */
+  protected _safelist?: SafelistListInstance;
   /** secondaryAuthToken - { Twilio.Accounts.V1.SecondaryAuthTokenListInstance } resource */
   protected _secondaryAuthToken?: SecondaryAuthTokenListInstance;
 
@@ -48,6 +51,12 @@ export default class V1 extends Version {
     return this._credentials;
   }
 
+  /** Getter for safelist resource */
+  get safelist(): SafelistListInstance {
+    this._safelist = this._safelist || SafelistListInstance(this);
+    return this._safelist;
+  }
+
   /** Getter for secondaryAuthToken resource */
   get secondaryAuthToken(): SecondaryAuthTokenListInstance {
     this._secondaryAuthToken =

src/rest/api/v2010/safelist.ts → src/rest/accounts/v1/safelist.ts

@@ -4,7 +4,7 @@
  *  |  | | | | |    | |  | __ |  | |__| | __ | __ |___ |\ | |___ |__/ |__|  | |  | |__/
  *  |  |_|_| | |___ | |__|    |__| |  | |    |__] |___ | \| |___ |  \ |  |  | |__| |  \
  *
- * Twilio - Api
+ * Twilio - Accounts
  * This is the public Twilio REST API.
  *
  * NOTE: This class is auto generated by OpenAPI Generator.
@@ -13,7 +13,7 @@
  */
 
 import { inspect, InspectOptions } from "util";
-import V2010 from "../V2010";
+import V1 from "../V1";
 const deserialize = require("../../../base/deserialize");
 const serialize = require("../../../base/serialize");
 import { isValidPathParam } from "../../../base/utility";
@@ -45,7 +45,7 @@ export interface SafelistListInstanceFetchOptions {
 export interface SafelistSolution {}
 
 export interface SafelistListInstance {
-  _version: V2010;
+  _version: V1;
   _solution: SafelistSolution;
   _uri: string;
 
@@ -115,12 +115,12 @@ export interface SafelistListInstance {
   [inspect.custom](_depth: any, options: InspectOptions): any;
 }
 
-export function SafelistListInstance(version: V2010): SafelistListInstance {
+export function SafelistListInstance(version: V1): SafelistListInstance {
   const instance = {} as SafelistListInstance;
 
   instance._version = version;
   instance._solution = {};
-  instance._uri = `/SafeList/Numbers.json`;
+  instance._uri = `/SafeList/Numbers`;
 
   instance.create = function create(
     params: SafelistListInstanceCreateOptions,
@@ -256,7 +256,7 @@ interface SafelistResource {
 }
 
 export class SafelistInstance {
-  constructor(protected _version: V2010, payload: SafelistResource) {
+  constructor(protected _version: V1, payload: SafelistResource) {
     this.sid = payload.sid;
     this.phoneNumber = payload.phone_number;
   }

src/rest/api/V2010.ts

@@ -15,7 +15,6 @@
 import ApiBase from "../ApiBase";
 import Version from "../../base/Version";
 import { AccountListInstance } from "./v2010/account";
-import { SafelistListInstance } from "./v2010/safelist";
 import { AccountContext } from "./v2010/account";
 
 export default class V2010 extends Version {
@@ -30,8 +29,6 @@ export default class V2010 extends Version {
 
   /** accounts - { Twilio.Api.V2010.AccountListInstance } resource */
   protected _accounts?: AccountListInstance;
-  /** safelist - { Twilio.Api.V2010.SafelistListInstance } resource */
-  protected _safelist?: SafelistListInstance;
   /** account - { Twilio.Api.V2010.AccountContext } resource */
   protected _account?: AccountContext;
 
@@ -41,12 +38,6 @@ export default class V2010 extends Version {
     return this._accounts;
   }
 
-  /** Getter for safelist resource */
-  get safelist(): SafelistListInstance {
-    this._safelist = this._safelist || SafelistListInstance(this);
-    return this._safelist;
-  }
-
   /** Getter for account resource */
   get account(): AccountContext {
     this._account =

src/rest/api/v2010/account/conference/participant.ts

@@ -156,6 +156,8 @@ export interface ParticipantListInstanceCreateOptions {
   amdStatusCallbackMethod?: string;
   /** Whether to trim any leading and trailing silence from the participant recording. Can be: `trim-silence` or `do-not-trim` and the default is `trim-silence`. */
   trim?: string;
+  /** A token string needed to invoke a forwarded call. A call_token is generated when an incoming call is received on a Twilio number. Pass an incoming call\\\'s call_token value to a forwarded call via the call_token parameter when creating a new call. A forwarded call should bear the same CallerID of the original incoming call. */
+  callToken?: string;
 }
 /**
  * Options to pass to each
@@ -887,6 +889,8 @@ export function ParticipantListInstance(
     if (params["amdStatusCallbackMethod"] !== undefined)
       data["AmdStatusCallbackMethod"] = params["amdStatusCallbackMethod"];
     if (params["trim"] !== undefined) data["Trim"] = params["trim"];
+    if (params["callToken"] !== undefined)
+      data["CallToken"] = params["callToken"];
 
     const headers: any = {};
     headers["Content-Type"] = "application/x-www-form-urlencoded";

src/rest/flexApi/v1/configuration.ts

@@ -174,6 +174,7 @@ interface ConfigurationResource {
   flex_ui_status_report: any;
   agent_conv_end_methods: any;
   citrix_voice_vdi: any;
+  offline_config: any;
 }
 
 export class ConfigurationInstance {
@@ -228,6 +229,7 @@ export class ConfigurationInstance {
     this.flexUiStatusReport = payload.flex_ui_status_report;
     this.agentConvEndMethods = payload.agent_conv_end_methods;
     this.citrixVoiceVdi = payload.citrix_voice_vdi;
+    this.offlineConfig = payload.offline_config;
 
     this._solution = {};
   }
@@ -417,6 +419,10 @@ export class ConfigurationInstance {
    * Citrix voice vdi configuration and settings.
    */
   citrixVoiceVdi: any;
+  /**
+   * Presence and presence ttl configuration
+   */
+  offlineConfig: any;
 
   private get _proxy(): ConfigurationContext {
     this._context =
@@ -508,6 +514,7 @@ export class ConfigurationInstance {
       flexUiStatusReport: this.flexUiStatusReport,
       agentConvEndMethods: this.agentConvEndMethods,
       citrixVoiceVdi: this.citrixVoiceVdi,
+      offlineConfig: this.offlineConfig,
     };
   }
 

src/rest/intelligence/v2/transcript.ts

@@ -30,14 +30,6 @@ export type TranscriptStatus =
   | "failed"
   | "canceled";
 
-/**
- * Options to pass to fetch a TranscriptInstance
- */
-export interface TranscriptContextFetchOptions {
-  /** Grant access to PII Redacted/Unredacted Transcript. The default is `true` to access redacted Transcript. */
-  redacted?: boolean;
-}
-
 /**
  * Options to pass to create a TranscriptInstance
  */
@@ -161,18 +153,6 @@ export interface TranscriptContext {
   fetch(
     callback?: (error: Error | null, item?: TranscriptInstance) => any
   ): Promise<TranscriptInstance>;
-  /**
-   * Fetch a TranscriptInstance
-   *
-   * @param params - Parameter for request
-   * @param callback - Callback to handle processed record
-   *
-   * @returns Resolves to processed TranscriptInstance
-   */
-  fetch(
-    params: TranscriptContextFetchOptions,
-    callback?: (error: Error | null, item?: TranscriptInstance) => any
-  ): Promise<TranscriptInstance>;
 
   /**
    * Provide a user-friendly representation
@@ -240,32 +220,13 @@ export class TranscriptContextImpl implements TranscriptContext {
   }
 
   fetch(
-    params?:
-      | TranscriptContextFetchOptions
-      | ((error: Error | null, item?: TranscriptInstance) => any),
     callback?: (error: Error | null, item?: TranscriptInstance) => any
   ): Promise<TranscriptInstance> {
-    if (params instanceof Function) {
-      callback = params;
-      params = {};
-    } else {
-      params = params || {};
-    }
-
-    let data: any = {};
-
-    if (params["redacted"] !== undefined)
-      data["Redacted"] = serialize.bool(params["redacted"]);
-
-    const headers: any = {};
-
     const instance = this;
     let operationVersion = instance._version,
       operationPromise = operationVersion.fetch({
         uri: instance._uri,
         method: "get",
-        params: data,
-        headers,
       });
 
     operationPromise = operationPromise.then(
@@ -429,25 +390,8 @@ export class TranscriptInstance {
    */
   fetch(
     callback?: (error: Error | null, item?: TranscriptInstance) => any
-  ): Promise<TranscriptInstance>;
-  /**
-   * Fetch a TranscriptInstance
-   *
-   * @param params - Parameter for request
-   * @param callback - Callback to handle processed record
-   *
-   * @returns Resolves to processed TranscriptInstance
-   */
-  fetch(
-    params: TranscriptContextFetchOptions,
-    callback?: (error: Error | null, item?: TranscriptInstance) => any
-  ): Promise<TranscriptInstance>;
-
-  fetch(
-    params?: any,
-    callback?: (error: Error | null, item?: TranscriptInstance) => any
   ): Promise<TranscriptInstance> {
-    return this._proxy.fetch(params, callback);
+    return this._proxy.fetch(callback);
   }
 
   /**

src/rest/intelligence/v2/transcript/media.ts

@@ -22,7 +22,7 @@ import { isValidPathParam } from "../../../../base/utility";
  * Options to pass to fetch a MediaInstance
  */
 export interface MediaContextFetchOptions {
-  /** Grant access to PII Redacted/Unredacted Media. The default is `true` to access redacted media. */
+  /** Grant access to PII Redacted/Unredacted Media. If redaction is enabled, the default is `true` to access redacted media. */
   redacted?: boolean;
 }
 

src/rest/intelligence/v2/transcript/operatorResult.ts

@@ -31,14 +31,14 @@ export type OperatorResultOperatorType =
  * Options to pass to fetch a OperatorResultInstance
  */
 export interface OperatorResultContextFetchOptions {
-  /** Grant access to PII redacted/unredacted Language Understanding operator. The default is True. */
+  /** Grant access to PII redacted/unredacted Language Understanding operator. If redaction is enabled, the default is True. */
   redacted?: boolean;
 }
 /**
  * Options to pass to each
  */
 export interface OperatorResultListInstanceEachOptions {
-  /** Grant access to PII redacted/unredacted Language Understanding operator. The default is True. */
+  /** Grant access to PII redacted/unredacted Language Understanding operator. If redaction is enabled, the default is True. */
   redacted?: boolean;
   /** How many resources to return in each list page. The default is 50, and the maximum is 1000. */
   pageSize?: number;
@@ -57,7 +57,7 @@ export interface OperatorResultListInstanceEachOptions {
  * Options to pass to list
  */
 export interface OperatorResultListInstanceOptions {
-  /** Grant access to PII redacted/unredacted Language Understanding operator. The default is True. */
+  /** Grant access to PII redacted/unredacted Language Understanding operator. If redaction is enabled, the default is True. */
   redacted?: boolean;
   /** How many resources to return in each list page. The default is 50, and the maximum is 1000. */
   pageSize?: number;
@@ -69,7 +69,7 @@ export interface OperatorResultListInstanceOptions {
  * Options to pass to page
  */
 export interface OperatorResultListInstancePageOptions {
-  /** Grant access to PII redacted/unredacted Language Understanding operator. The default is True. */
+  /** Grant access to PII redacted/unredacted Language Understanding operator. If redaction is enabled, the default is True. */
   redacted?: boolean;
   /** How many resources to return in each list page. The default is 50, and the maximum is 1000. */
   pageSize?: number;