twilio 3.69.0 → 3.70.0

package/CHANGES.md

@@ -1,6 +1,27 @@
 twilio-node changelog
 =====================
 
+[2021-10-18] Version 3.70.0
+---------------------------
+**Library - Feature**
+- [PR #700](https://github.com/twilio/twilio-node/pull/700): Add PlaybackGrant. Thanks to [@sarahcstringer](https://github.com/sarahcstringer)!
+
+**Library - Fix**
+- [PR #695](https://github.com/twilio/twilio-node/pull/695): Update Axios package. Thanks to [@houmark](https://github.com/houmark)!
+
+**Api**
+- Corrected enum values for `emergency_address_status` values in `/IncomingPhoneNumbers` response. **(breaking change)**
+- Clarify `emergency_address_status` values in `/IncomingPhoneNumbers` response.
+
+**Messaging**
+- Add PUT and List brand vettings api
+- Removes beta feature flag based visibility for us_app_to_person_registered and usecase field.Updates test cases to add POLITICAL usecase. **(breaking change)**
+- Add brand_feedback as optional field to BrandRegistrations
+
+**Video**
+- Add `AudioOnly` to create room
+
+
 [2021-10-06] Version 3.69.0
 ---------------------------
 **Api**

package/lib/jwt/AccessToken.d.ts

@@ -177,6 +177,22 @@ declare namespace AccessToken {
     endpointId?: string;
   }
 
+  export interface PlaybackGrantOptions {
+    grant?: object;
+  }
+
+  export interface PlaybackGrantPayload {
+    grant?: object;
+  }
+
+  export class PlaybackGrant extends Grant<
+    PlaybackGrantOptions,
+    PlaybackGrantPayload,
+    'player'
+  > implements PlaybackGrantOptions {
+    grant?: object
+  }
+
   export interface AccessTokenOptions {
     /**
      * Time to live in seconds

package/lib/jwt/AccessToken.js

@@ -199,6 +199,25 @@ _.extend(VoiceGrant.prototype, {
   }
 });
 
+/**
+ * @constructor
+ * @param {object} options - ...
+ * @param {string} options.grant - The PlaybackGrant retrieved from Twilio's API
+ */
+function PlaybackGrant(options) {
+  options = options || {};
+  this.grant = options.grant;
+}
+
+_.extend(PlaybackGrant.prototype, {
+  key: 'player',
+  toPayload: function() {
+    var grant = {};
+    if (this.grant) { grant = this.grant; }
+    return grant;
+  }
+});
+
 /**
  * @constructor
  * @param {string} accountSid - The account's unique ID to which access is scoped
@@ -234,6 +253,7 @@ AccessToken.SyncGrant = SyncGrant;
 AccessToken.VideoGrant = VideoGrant;
 AccessToken.ConversationsGrant = util.deprecate(ConversationsGrant, 'ConversationsGrant is deprecated, use VideoGrant instead.');
 AccessToken.TaskRouterGrant = TaskRouterGrant;
+AccessToken.PlaybackGrant = PlaybackGrant;
 AccessToken.DEFAULT_ALGORITHM = 'HS256';
 AccessToken.ALGORITHMS = [
   'HS256',

package/lib/rest/Media.d.ts

@@ -0,0 +1,28 @@
+/**
+ * This code was generated by
+ * \ / _    _  _|   _  _
+ *  | (_)\/(_)(_|\/| |(/_  v1.0.0
+ *       /       /
+ */
+
+import Domain = require('../base/Domain');
+import Twilio = require('./Twilio');
+import V1 = require('./media/V1');
+import { MediaProcessorListInstance } from './media/v1/mediaProcessor';
+import { PlayerStreamerListInstance } from './media/v1/playerStreamer';
+
+
+declare class Media extends Domain {
+  /**
+   * Initialize media domain
+   *
+   * @param twilio - The twilio client
+   */
+  constructor(twilio: Twilio);
+
+  readonly mediaProcessor: MediaProcessorListInstance;
+  readonly playerStreamer: PlayerStreamerListInstance;
+  readonly v1: V1;
+}
+
+export = Media;

package/lib/rest/Media.js

@@ -0,0 +1,64 @@
+'use strict';
+
+/* jshint ignore:start */
+/**
+ * This code was generated by
+ * \ / _    _  _|   _  _
+ *  | (_)\/(_)(_|\/| |(/_  v1.0.0
+ *       /       /
+ */
+/* jshint ignore:end */
+
+var _ = require('lodash');  /* jshint ignore:line */
+var Domain = require('../base/Domain');  /* jshint ignore:line */
+var V1 = require('./media/V1');  /* jshint ignore:line */
+
+
+/* jshint ignore:start */
+/**
+ * Initialize media domain
+ *
+ * @constructor Twilio.Media
+ *
+ * @property {Twilio.Media.V1} v1 - v1 version
+ * @property {Twilio.Media.V1.MediaProcessorList} mediaProcessor -
+ *          mediaProcessor resource
+ * @property {Twilio.Media.V1.PlayerStreamerList} playerStreamer -
+ *          playerStreamer resource
+ *
+ * @param {Twilio} twilio - The twilio client
+ */
+/* jshint ignore:end */
+function Media(twilio) {
+  Domain.prototype.constructor.call(this, twilio, 'https://media.twilio.com');
+
+  // Versions
+  this._v1 = undefined;
+}
+
+_.extend(Media.prototype, Domain.prototype);
+Media.prototype.constructor = Media;
+
+Object.defineProperty(Media.prototype,
+  'v1', {
+    get: function() {
+      this._v1 = this._v1 || new V1(this);
+      return this._v1;
+    }
+});
+
+Object.defineProperty(Media.prototype,
+  'mediaProcessor', {
+    get: function() {
+      return this.v1.mediaProcessor;
+    }
+});
+
+Object.defineProperty(Media.prototype,
+  'playerStreamer', {
+    get: function() {
+      return this.v1.playerStreamer;
+    }
+});
+
+module.exports = Media;

package/lib/rest/Twilio.d.ts

@@ -18,6 +18,7 @@ import FrontlineApi = require('./FrontlineApi');
 import Insights = require('./Insights');
 import IpMessaging = require('./IpMessaging');
 import Lookups = require('./Lookups');
+import Media = require('./Media');
 import Messaging = require('./Messaging');
 import Monitor = require('./Monitor');
 import Notify = require('./Notify');
@@ -72,6 +73,7 @@ declare class Twilio {
   ipMessaging: IpMessaging;
   keys: (typeof Api.prototype.account.keys);
   lookups: Lookups;
+  media: Media;
   messages: (typeof Api.prototype.account.messages);
   messaging: Messaging;
   monitor: Monitor;

package/lib/rest/Twilio.js

@@ -34,6 +34,7 @@ var RestException = require('../base/RestException');  /* jshint ignore:line */
  * @property {Twilio.Insights} insights - insights domain
  * @property {Twilio.IpMessaging} ipMessaging - ip_messaging domain
  * @property {Twilio.Lookups} lookups - lookups domain
+ * @property {Twilio.Media} media - media domain
  * @property {Twilio.Messaging} messaging - messaging domain
  * @property {Twilio.Monitor} monitor - monitor domain
  * @property {Twilio.Notify} notify - notify domain
@@ -159,6 +160,7 @@ function Twilio(username, password, opts) {
   this._insights = undefined;
   this._ipMessaging = undefined;
   this._lookups = undefined;
+  this._media = undefined;
   this._messaging = undefined;
   this._monitor = undefined;
   this._notify = undefined;
@@ -192,6 +194,7 @@ function Twilio(username, password, opts) {
     this.insights;
     this.ipMessaging;
     this.lookups;
+    this.media;
     this.messaging;
     this.monitor;
     this.notify;
@@ -491,6 +494,17 @@ Object.defineProperty(Twilio.prototype,
     }
 });
 
+Object.defineProperty(Twilio.prototype,
+  'media', {
+    get: function() {
+      if (!this._media) {
+        var Media = require('./Media');  /* jshint ignore:line */
+        this._media = new Media(this);
+      }
+      return this._media;
+    }
+});
+
 Object.defineProperty(Twilio.prototype,
   'messaging', {
     get: function() {

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

@@ -13,6 +13,8 @@ import { SerializableClass } from '../../../../../interfaces';
 
 type LocalAddressRequirement = 'none'|'any'|'local'|'foreign';
 
+type LocalEmergencyAddressStatus = 'registered'|'unregistered'|'pending-registration'|'registration-failure'|'pending-unregistration'|'unregistration-failure';
+
 type LocalEmergencyStatus = 'Active'|'Inactive';
 
 type LocalVoiceReceiveMode = 'voice'|'fax';
@@ -283,6 +285,7 @@ interface LocalResource {
   date_created: Date;
   date_updated: Date;
   emergency_address_sid: string;
+  emergency_address_status: LocalEmergencyAddressStatus;
   emergency_status: LocalEmergencyStatus;
   friendly_name: string;
   identity_sid: string;
@@ -333,6 +336,7 @@ declare class LocalInstance extends SerializableClass {
   dateCreated: Date;
   dateUpdated: Date;
   emergencyAddressSid: string;
+  emergencyAddressStatus: LocalEmergencyAddressStatus;
   emergencyStatus: LocalEmergencyStatus;
   friendlyName: string;
   identitySid: string;
@@ -385,4 +389,4 @@ declare class LocalPage extends Page<V2010, LocalPayload, LocalResource, LocalIn
   toJSON(): any;
 }
 
-export { LocalAddressRequirement, LocalEmergencyStatus, LocalInstance, LocalList, LocalListInstance, LocalListInstanceCreateOptions, LocalListInstanceEachOptions, LocalListInstanceOptions, LocalListInstancePageOptions, LocalPage, LocalPayload, LocalResource, LocalSolution, LocalVoiceReceiveMode }
+export { LocalAddressRequirement, LocalEmergencyAddressStatus, LocalEmergencyStatus, LocalInstance, LocalList, LocalListInstance, LocalListInstanceCreateOptions, LocalListInstanceEachOptions, LocalListInstanceOptions, LocalListInstancePageOptions, LocalPage, LocalPayload, LocalResource, LocalSolution, LocalVoiceReceiveMode }

package/lib/rest/api/v2010/account/incomingPhoneNumber/local.js

@@ -569,6 +569,8 @@ LocalPage.prototype[util.inspect.custom] = function inspect(depth, options) {
  *          Displays if emergency calling is enabled for this number.
  * @property {string} emergencyAddressSid -
  *          The emergency address configuration to use for emergency calling
+ * @property {local.emergency_address_status} emergencyAddressStatus -
+ *          State of the emergency address configuration for the phone number
  * @property {string} bundleSid -
  *          The SID of the Bundle resource associated with number
  * @property {string} status - The status
@@ -613,6 +615,7 @@ LocalInstance = function LocalInstance(version, payload, accountSid) {
   this.voiceUrl = payload.voice_url; // jshint ignore:line
   this.emergencyStatus = payload.emergency_status; // jshint ignore:line
   this.emergencyAddressSid = payload.emergency_address_sid; // jshint ignore:line
+  this.emergencyAddressStatus = payload.emergency_address_status; // jshint ignore:line
   this.bundleSid = payload.bundle_sid; // jshint ignore:line
   this.status = payload.status; // jshint ignore:line
 

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

@@ -13,6 +13,8 @@ import { SerializableClass } from '../../../../../interfaces';
 
 type MobileAddressRequirement = 'none'|'any'|'local'|'foreign';
 
+type MobileEmergencyAddressStatus = 'registered'|'unregistered'|'pending-registration'|'registration-failure'|'pending-unregistration'|'unregistration-failure';
+
 type MobileEmergencyStatus = 'Active'|'Inactive';
 
 type MobileVoiceReceiveMode = 'voice'|'fax';
@@ -283,6 +285,7 @@ interface MobileResource {
   date_created: Date;
   date_updated: Date;
   emergency_address_sid: string;
+  emergency_address_status: MobileEmergencyAddressStatus;
   emergency_status: MobileEmergencyStatus;
   friendly_name: string;
   identity_sid: string;
@@ -333,6 +336,7 @@ declare class MobileInstance extends SerializableClass {
   dateCreated: Date;
   dateUpdated: Date;
   emergencyAddressSid: string;
+  emergencyAddressStatus: MobileEmergencyAddressStatus;
   emergencyStatus: MobileEmergencyStatus;
   friendlyName: string;
   identitySid: string;
@@ -385,4 +389,4 @@ declare class MobilePage extends Page<V2010, MobilePayload, MobileResource, Mobi
   toJSON(): any;
 }
 
-export { MobileAddressRequirement, MobileEmergencyStatus, MobileInstance, MobileList, MobileListInstance, MobileListInstanceCreateOptions, MobileListInstanceEachOptions, MobileListInstanceOptions, MobileListInstancePageOptions, MobilePage, MobilePayload, MobileResource, MobileSolution, MobileVoiceReceiveMode }
+export { MobileAddressRequirement, MobileEmergencyAddressStatus, MobileEmergencyStatus, MobileInstance, MobileList, MobileListInstance, MobileListInstanceCreateOptions, MobileListInstanceEachOptions, MobileListInstanceOptions, MobileListInstancePageOptions, MobilePage, MobilePayload, MobileResource, MobileSolution, MobileVoiceReceiveMode }

package/lib/rest/api/v2010/account/incomingPhoneNumber/mobile.js

@@ -569,6 +569,8 @@ MobilePage.prototype[util.inspect.custom] = function inspect(depth, options) {
  *          Displays if emergency calling is enabled for this number.
  * @property {string} emergencyAddressSid -
  *          The emergency address configuration to use for emergency calling
+ * @property {mobile.emergency_address_status} emergencyAddressStatus -
+ *          State of the emergency address configuration for the phone number
  * @property {string} bundleSid -
  *          The SID of the Bundle resource associated with number
  * @property {string} status - The status
@@ -613,6 +615,7 @@ MobileInstance = function MobileInstance(version, payload, accountSid) {
   this.voiceUrl = payload.voice_url; // jshint ignore:line
   this.emergencyStatus = payload.emergency_status; // jshint ignore:line
   this.emergencyAddressSid = payload.emergency_address_sid; // jshint ignore:line
+  this.emergencyAddressStatus = payload.emergency_address_status; // jshint ignore:line
   this.bundleSid = payload.bundle_sid; // jshint ignore:line
   this.status = payload.status; // jshint ignore:line
 

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

@@ -13,6 +13,8 @@ import { SerializableClass } from '../../../../../interfaces';
 
 type TollFreeAddressRequirement = 'none'|'any'|'local'|'foreign';
 
+type TollFreeEmergencyAddressStatus = 'registered'|'unregistered'|'pending-registration'|'registration-failure'|'pending-unregistration'|'unregistration-failure';
+
 type TollFreeEmergencyStatus = 'Active'|'Inactive';
 
 type TollFreeVoiceReceiveMode = 'voice'|'fax';
@@ -283,6 +285,7 @@ interface TollFreeResource {
   date_created: Date;
   date_updated: Date;
   emergency_address_sid: string;
+  emergency_address_status: TollFreeEmergencyAddressStatus;
   emergency_status: TollFreeEmergencyStatus;
   friendly_name: string;
   identity_sid: string;
@@ -333,6 +336,7 @@ declare class TollFreeInstance extends SerializableClass {
   dateCreated: Date;
   dateUpdated: Date;
   emergencyAddressSid: string;
+  emergencyAddressStatus: TollFreeEmergencyAddressStatus;
   emergencyStatus: TollFreeEmergencyStatus;
   friendlyName: string;
   identitySid: string;
@@ -385,4 +389,4 @@ declare class TollFreePage extends Page<V2010, TollFreePayload, TollFreeResource
   toJSON(): any;
 }
 
-export { TollFreeAddressRequirement, TollFreeEmergencyStatus, TollFreeInstance, TollFreeList, TollFreeListInstance, TollFreeListInstanceCreateOptions, TollFreeListInstanceEachOptions, TollFreeListInstanceOptions, TollFreeListInstancePageOptions, TollFreePage, TollFreePayload, TollFreeResource, TollFreeSolution, TollFreeVoiceReceiveMode }
+export { TollFreeAddressRequirement, TollFreeEmergencyAddressStatus, TollFreeEmergencyStatus, TollFreeInstance, TollFreeList, TollFreeListInstance, TollFreeListInstanceCreateOptions, TollFreeListInstanceEachOptions, TollFreeListInstanceOptions, TollFreeListInstancePageOptions, TollFreePage, TollFreePayload, TollFreeResource, TollFreeSolution, TollFreeVoiceReceiveMode }

package/lib/rest/api/v2010/account/incomingPhoneNumber/tollFree.js

@@ -570,6 +570,8 @@ TollFreePage.prototype[util.inspect.custom] = function inspect(depth, options) {
  *          Displays if emergency calling is enabled for this number.
  * @property {string} emergencyAddressSid -
  *          The emergency address configuration to use for emergency calling
+ * @property {toll_free.emergency_address_status} emergencyAddressStatus -
+ *          State of the emergency address configuration for the phone number
  * @property {string} bundleSid -
  *          The SID of the Bundle resource associated with number
  * @property {string} status - The status
@@ -614,6 +616,7 @@ TollFreeInstance = function TollFreeInstance(version, payload, accountSid) {
   this.voiceUrl = payload.voice_url; // jshint ignore:line
   this.emergencyStatus = payload.emergency_status; // jshint ignore:line
   this.emergencyAddressSid = payload.emergency_address_sid; // jshint ignore:line
+  this.emergencyAddressStatus = payload.emergency_address_status; // jshint ignore:line
   this.bundleSid = payload.bundle_sid; // jshint ignore:line
   this.status = payload.status; // jshint ignore:line
 

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

@@ -18,6 +18,8 @@ import { TollFreeListInstance } from './incomingPhoneNumber/tollFree';
 
 type IncomingPhoneNumberAddressRequirement = 'none'|'any'|'local'|'foreign';
 
+type IncomingPhoneNumberEmergencyAddressStatus = 'registered'|'unregistered'|'pending-registration'|'registration-failure'|'pending-unregistration'|'unregistration-failure';
+
 type IncomingPhoneNumberEmergencyStatus = 'Active'|'Inactive';
 
 type IncomingPhoneNumberVoiceReceiveMode = 'voice'|'fax';
@@ -364,6 +366,7 @@ interface IncomingPhoneNumberResource {
   date_created: Date;
   date_updated: Date;
   emergency_address_sid: string;
+  emergency_address_status: IncomingPhoneNumberEmergencyAddressStatus;
   emergency_status: IncomingPhoneNumberEmergencyStatus;
   friendly_name: string;
   identity_sid: string;
@@ -463,6 +466,7 @@ declare class IncomingPhoneNumberInstance extends SerializableClass {
   dateCreated: Date;
   dateUpdated: Date;
   emergencyAddressSid: string;
+  emergencyAddressStatus: IncomingPhoneNumberEmergencyAddressStatus;
   emergencyStatus: IncomingPhoneNumberEmergencyStatus;
   /**
    * fetch a IncomingPhoneNumberInstance
@@ -540,4 +544,4 @@ declare class IncomingPhoneNumberPage extends Page<V2010, IncomingPhoneNumberPay
   toJSON(): any;
 }
 
-export { IncomingPhoneNumberAddressRequirement, IncomingPhoneNumberContext, IncomingPhoneNumberEmergencyStatus, IncomingPhoneNumberInstance, IncomingPhoneNumberInstanceUpdateOptions, IncomingPhoneNumberList, IncomingPhoneNumberListInstance, IncomingPhoneNumberListInstanceCreateOptions, IncomingPhoneNumberListInstanceEachOptions, IncomingPhoneNumberListInstanceOptions, IncomingPhoneNumberListInstancePageOptions, IncomingPhoneNumberPage, IncomingPhoneNumberPayload, IncomingPhoneNumberResource, IncomingPhoneNumberSolution, IncomingPhoneNumberVoiceReceiveMode }
+export { IncomingPhoneNumberAddressRequirement, IncomingPhoneNumberContext, IncomingPhoneNumberEmergencyAddressStatus, IncomingPhoneNumberEmergencyStatus, IncomingPhoneNumberInstance, IncomingPhoneNumberInstanceUpdateOptions, IncomingPhoneNumberList, IncomingPhoneNumberListInstance, IncomingPhoneNumberListInstanceCreateOptions, IncomingPhoneNumberListInstanceEachOptions, IncomingPhoneNumberListInstanceOptions, IncomingPhoneNumberListInstancePageOptions, IncomingPhoneNumberPage, IncomingPhoneNumberPayload, IncomingPhoneNumberResource, IncomingPhoneNumberSolution, IncomingPhoneNumberVoiceReceiveMode }

package/lib/rest/api/v2010/account/incomingPhoneNumber.js

@@ -646,6 +646,8 @@ IncomingPhoneNumberPage.prototype[util.inspect.custom] = function inspect(depth,
  *          Displays if emergency calling is enabled for this number.
  * @property {string} emergencyAddressSid -
  *          The emergency address configuration to use for emergency calling
+ * @property {incoming_phone_number.emergency_address_status} emergencyAddressStatus -
+ *          State of the emergency address configuration for the phone number
  * @property {string} bundleSid -
  *          The SID of the Bundle resource associated with number
  * @property {string} status - The status
@@ -692,6 +694,7 @@ IncomingPhoneNumberInstance = function IncomingPhoneNumberInstance(version,
   this.voiceUrl = payload.voice_url; // jshint ignore:line
   this.emergencyStatus = payload.emergency_status; // jshint ignore:line
   this.emergencyAddressSid = payload.emergency_address_sid; // jshint ignore:line
+  this.emergencyAddressStatus = payload.emergency_address_status; // jshint ignore:line
   this.bundleSid = payload.bundle_sid; // jshint ignore:line
   this.status = payload.status; // jshint ignore:line
 

package/lib/rest/media/V1.d.ts

@@ -0,0 +1,28 @@
+/**
+ * This code was generated by
+ * \ / _    _  _|   _  _
+ *  | (_)\/(_)(_|\/| |(/_  v1.0.0
+ *       /       /
+ */
+
+import Media = require('../Media');
+import Version = require('../../base/Version');
+import { MediaProcessorList } from './v1/mediaProcessor';
+import { MediaProcessorListInstance } from './v1/mediaProcessor';
+import { PlayerStreamerList } from './v1/playerStreamer';
+import { PlayerStreamerListInstance } from './v1/playerStreamer';
+
+
+declare class V1 extends Version {
+  /**
+   * Initialize the V1 version of Media
+   *
+   * @param domain - The twilio domain
+   */
+  constructor(domain: Media);
+
+  readonly mediaProcessor: MediaProcessorListInstance;
+  readonly playerStreamer: PlayerStreamerListInstance;
+}
+
+export = V1;

package/lib/rest/media/V1.js

@@ -0,0 +1,59 @@
+'use strict';
+
+/* jshint ignore:start */
+/**
+ * This code was generated by
+ * \ / _    _  _|   _  _
+ *  | (_)\/(_)(_|\/| |(/_  v1.0.0
+ *       /       /
+ */
+/* jshint ignore:end */
+
+var _ = require('lodash');  /* jshint ignore:line */
+var MediaProcessorList = require('./v1/mediaProcessor').MediaProcessorList;
+var PlayerStreamerList = require('./v1/playerStreamer').PlayerStreamerList;
+var Version = require('../../base/Version');  /* jshint ignore:line */
+
+
+/* jshint ignore:start */
+/**
+ * Initialize the V1 version of Media
+ *
+ * @constructor Twilio.Media.V1
+ *
+ * @property {Twilio.Media.V1.MediaProcessorList} mediaProcessor -
+ *          mediaProcessor resource
+ * @property {Twilio.Media.V1.PlayerStreamerList} playerStreamer -
+ *          playerStreamer resource
+ *
+ * @param {Twilio.Media} domain - The twilio domain
+ */
+/* jshint ignore:end */
+function V1(domain) {
+  Version.prototype.constructor.call(this, domain, 'v1');
+
+  // Resources
+  this._mediaProcessor = undefined;
+  this._playerStreamer = undefined;
+}
+
+_.extend(V1.prototype, Version.prototype);
+V1.prototype.constructor = V1;
+
+Object.defineProperty(V1.prototype,
+  'mediaProcessor', {
+    get: function() {
+      this._mediaProcessor = this._mediaProcessor || new MediaProcessorList(this);
+      return this._mediaProcessor;
+    }
+});
+
+Object.defineProperty(V1.prototype,
+  'playerStreamer', {
+    get: function() {
+      this._playerStreamer = this._playerStreamer || new PlayerStreamerList(this);
+      return this._playerStreamer;
+    }
+});
+
+module.exports = V1;