twilio 3.71.3 → 3.74.0

package/lib/rest/verify/v2/verificationAttempt.js

@@ -69,10 +69,20 @@ VerificationAttemptList = function VerificationAttemptList(version) {
    *
    * @param {object} [opts] - Options for request
    * @param {Date} [opts.dateCreatedAfter] -
-   *          Filter verification attempts after this date
+   *          Filter verification attempts after this date.
    * @param {Date} [opts.dateCreatedBefore] -
-   *          Filter verification attempts befor this date
-   * @param {string} [opts.channelData.to] - Destination of a verification
+   *          Filter verification attempts before this date.
+   * @param {string} [opts.channelData.to] -
+   *          Filters by destination of the verification attempt.
+   * @param {string} [opts.country] -
+   *          Filter verification attempts by destination country.
+   * @param {verification_attempt.channels} [opts.channel] -
+   *          Filter verification attempts by communication channel.
+   * @param {string} [opts.verifyServiceSid] -
+   *          Filter verification attempts by verify service.
+   * @param {string} [opts.verificationSid] - Filter attempts by verification.
+   * @param {verification_attempt.conversion_status} [opts.status] -
+   *          Filter verification attempts by conversion status.
    * @param {number} [opts.limit] -
    *         Upper limit for the number of records to return.
    *         each() guarantees never to return more than limit.
@@ -140,6 +150,8 @@ VerificationAttemptList = function VerificationAttemptList(version) {
         if (!done) {
           currentPage++;
           fetchNextPage(_.bind(page.nextPage, page));
+        } else {
+          onComplete();
         }
       });
 
@@ -161,10 +173,20 @@ VerificationAttemptList = function VerificationAttemptList(version) {
    *
    * @param {object} [opts] - Options for request
    * @param {Date} [opts.dateCreatedAfter] -
-   *          Filter verification attempts after this date
+   *          Filter verification attempts after this date.
    * @param {Date} [opts.dateCreatedBefore] -
-   *          Filter verification attempts befor this date
-   * @param {string} [opts.channelData.to] - Destination of a verification
+   *          Filter verification attempts before this date.
+   * @param {string} [opts.channelData.to] -
+   *          Filters by destination of the verification attempt.
+   * @param {string} [opts.country] -
+   *          Filter verification attempts by destination country.
+   * @param {verification_attempt.channels} [opts.channel] -
+   *          Filter verification attempts by communication channel.
+   * @param {string} [opts.verifyServiceSid] -
+   *          Filter verification attempts by verify service.
+   * @param {string} [opts.verificationSid] - Filter attempts by verification.
+   * @param {verification_attempt.conversion_status} [opts.status] -
+   *          Filter verification attempts by conversion status.
    * @param {number} [opts.limit] -
    *         Upper limit for the number of records to return.
    *         list() guarantees never to return more than limit.
@@ -226,10 +248,20 @@ VerificationAttemptList = function VerificationAttemptList(version) {
    *
    * @param {object} [opts] - Options for request
    * @param {Date} [opts.dateCreatedAfter] -
-   *          Filter verification attempts after this date
+   *          Filter verification attempts after this date.
    * @param {Date} [opts.dateCreatedBefore] -
-   *          Filter verification attempts befor this date
-   * @param {string} [opts.channelData.to] - Destination of a verification
+   *          Filter verification attempts before this date.
+   * @param {string} [opts.channelData.to] -
+   *          Filters by destination of the verification attempt.
+   * @param {string} [opts.country] -
+   *          Filter verification attempts by destination country.
+   * @param {verification_attempt.channels} [opts.channel] -
+   *          Filter verification attempts by communication channel.
+   * @param {string} [opts.verifyServiceSid] -
+   *          Filter verification attempts by verify service.
+   * @param {string} [opts.verificationSid] - Filter attempts by verification.
+   * @param {verification_attempt.conversion_status} [opts.status] -
+   *          Filter verification attempts by conversion status.
    * @param {string} [opts.pageToken] - PageToken provided by the API
    * @param {number} [opts.pageNumber] -
    *          Page Number, this value is simply for client state
@@ -251,6 +283,11 @@ VerificationAttemptList = function VerificationAttemptList(version) {
       'DateCreatedAfter': serialize.iso8601DateTime(_.get(opts, 'dateCreatedAfter')),
       'DateCreatedBefore': serialize.iso8601DateTime(_.get(opts, 'dateCreatedBefore')),
       'ChannelData.To': _.get(opts, 'channelData.to'),
+      'Country': _.get(opts, 'country'),
+      'Channel': _.get(opts, 'channel'),
+      'VerifyServiceSid': _.get(opts, 'verifyServiceSid'),
+      'VerificationSid': _.get(opts, 'verificationSid'),
+      'Status': _.get(opts, 'status'),
       'PageToken': opts.pageToken,
       'Page': opts.pageNumber,
       'PageSize': opts.pageSize
@@ -425,16 +462,23 @@ VerificationAttemptPage.prototype[util.inspect.custom] = function inspect(depth,
  * @constructor Twilio.Verify.V2.VerificationAttemptInstance
  *
  * @property {string} sid -
- *          A string that uniquely identifies this Verification Attempt
- * @property {string} accountSid - Account Sid
- * @property {string} serviceSid - The service_sid
+ *          The SID that uniquely identifies the verification attempt.
+ * @property {string} accountSid -
+ *          The SID of the Account that created the verification.
+ * @property {string} serviceSid -
+ *          The SID of the verify service that generated this attempt.
+ * @property {string} verificationSid -
+ *          The SID of the verification that generated this attempt.
  * @property {Date} dateCreated - The date this Attempt was created
  * @property {Date} dateUpdated - The date this Attempt was updated
  * @property {verification_attempt.conversion_status} conversionStatus -
- *          Status of a conversion
- * @property {verification_attempt.channels} channel - Channel used for the attempt
+ *          Status of the conversion for the verification.
+ * @property {verification_attempt.channels} channel -
+ *          Communication channel used for the attempt.
+ * @property {object} price -
+ *          An object containing the charge for this verification attempt.
  * @property {object} channelData -
- *          Object with the channel information for an attempt
+ *          An object containing the channel specific information for an attempt.
  * @property {string} url - The url
  *
  * @param {V2} version - Version of the resource
@@ -450,10 +494,12 @@ VerificationAttemptInstance = function VerificationAttemptInstance(version,
   this.sid = payload.sid; // jshint ignore:line
   this.accountSid = payload.account_sid; // jshint ignore:line
   this.serviceSid = payload.service_sid; // jshint ignore:line
+  this.verificationSid = payload.verification_sid; // jshint ignore:line
   this.dateCreated = deserialize.iso8601DateTime(payload.date_created); // jshint ignore:line
   this.dateUpdated = deserialize.iso8601DateTime(payload.date_updated); // jshint ignore:line
   this.conversionStatus = payload.conversion_status; // jshint ignore:line
   this.channel = payload.channel; // jshint ignore:line
+  this.price = payload.price; // jshint ignore:line
   this.channelData = payload.channel_data; // jshint ignore:line
   this.url = payload.url; // jshint ignore:line
 

package/lib/rest/video/v1/composition.d.ts

@@ -261,6 +261,7 @@ interface CompositionResource {
   duration: number;
   format: CompositionFormat;
   links: string;
+  media_external_location: string;
   resolution: string;
   room_sid: string;
   sid: string;
@@ -330,6 +331,7 @@ declare class CompositionInstance extends SerializableClass {
   fetch(callback?: (error: Error | null, items: CompositionInstance) => any): Promise<CompositionInstance>;
   format: CompositionFormat;
   links: string;
+  mediaExternalLocation: string;
   /**
    * remove a CompositionInstance
    *

package/lib/rest/video/v1/composition.js

@@ -143,6 +143,8 @@ CompositionList = function CompositionList(version) {
         if (!done) {
           currentPage++;
           fetchNextPage(_.bind(page.nextPage, page));
+        } else {
+          onComplete();
         }
       });
 
@@ -356,8 +358,8 @@ CompositionList = function CompositionList(version) {
     if (_.isUndefined(opts)) {
       throw new Error('Required parameter "opts" missing.');
     }
-    if (_.isUndefined(opts.roomSid)) {
-      throw new Error('Required parameter "opts.roomSid" missing.');
+    if (_.isUndefined(opts['roomSid'])) {
+      throw new Error('Required parameter "opts[\'roomSid\']" missing.');
     }
 
     var deferred = Q.defer();
@@ -525,6 +527,8 @@ CompositionPage.prototype[util.inspect.custom] = function inspect(depth,
  * @property {number} size - The size of the composed media file in bytes
  * @property {number} duration -
  *          The duration of the composition's media file in seconds
+ * @property {string} mediaExternalLocation -
+ *          The URL of the media file associated with the composition when stored externally
  * @property {string} url - The absolute URL of the resource
  * @property {string} links -
  *          The URL of the media file associated with the composition
@@ -554,6 +558,7 @@ CompositionInstance = function CompositionInstance(version, payload, sid) {
   this.bitrate = deserialize.integer(payload.bitrate); // jshint ignore:line
   this.size = deserialize.integer(payload.size); // jshint ignore:line
   this.duration = deserialize.integer(payload.duration); // jshint ignore:line
+  this.mediaExternalLocation = payload.media_external_location; // jshint ignore:line
   this.url = payload.url; // jshint ignore:line
   this.links = payload.links; // jshint ignore:line
 

package/lib/rest/video/v1/compositionHook.js

@@ -143,6 +143,8 @@ CompositionHookList = function CompositionHookList(version) {
         if (!done) {
           currentPage++;
           fetchNextPage(_.bind(page.nextPage, page));
+        } else {
+          onComplete();
         }
       });
 
@@ -356,8 +358,8 @@ CompositionHookList = function CompositionHookList(version) {
     if (_.isUndefined(opts)) {
       throw new Error('Required parameter "opts" missing.');
     }
-    if (_.isUndefined(opts.friendlyName)) {
-      throw new Error('Required parameter "opts.friendlyName" missing.');
+    if (_.isUndefined(opts['friendlyName'])) {
+      throw new Error('Required parameter "opts[\'friendlyName\']" missing.');
     }
 
     var deferred = Q.defer();
@@ -778,8 +780,8 @@ CompositionHookContext.prototype.update = function update(opts, callback) {
   if (_.isUndefined(opts)) {
     throw new Error('Required parameter "opts" missing.');
   }
-  if (_.isUndefined(opts.friendlyName)) {
-    throw new Error('Required parameter "opts.friendlyName" missing.');
+  if (_.isUndefined(opts['friendlyName'])) {
+    throw new Error('Required parameter "opts[\'friendlyName\']" missing.');
   }
 
   var deferred = Q.defer();

package/lib/rest/video/v1/compositionSettings.js

@@ -353,8 +353,8 @@ CompositionSettingsContext.prototype.create = function create(opts, callback) {
   if (_.isUndefined(opts)) {
     throw new Error('Required parameter "opts" missing.');
   }
-  if (_.isUndefined(opts.friendlyName)) {
-    throw new Error('Required parameter "opts.friendlyName" missing.');
+  if (_.isUndefined(opts['friendlyName'])) {
+    throw new Error('Required parameter "opts[\'friendlyName\']" missing.');
   }
 
   var deferred = Q.defer();

package/lib/rest/video/v1/recording.d.ts

@@ -242,6 +242,7 @@ interface RecordingResource {
   duration: number;
   grouping_sids: object;
   links: string;
+  media_external_location: string;
   offset: number;
   sid: string;
   size: number;
@@ -308,6 +309,7 @@ declare class RecordingInstance extends SerializableClass {
   fetch(callback?: (error: Error | null, items: RecordingInstance) => any): Promise<RecordingInstance>;
   groupingSids: any;
   links: string;
+  mediaExternalLocation: string;
   offset: number;
   /**
    * remove a RecordingInstance

package/lib/rest/video/v1/recording.js

@@ -147,6 +147,8 @@ RecordingList = function RecordingList(version) {
         if (!done) {
           currentPage++;
           fetchNextPage(_.bind(page.nextPage, page));
+        } else {
+          onComplete();
         }
       });
 
@@ -461,6 +463,8 @@ RecordingPage.prototype[util.inspect.custom] = function inspect(depth, options)
  *          The name that was given to the source track of the recording
  * @property {number} offset -
  *          The number of milliseconds between a point in time that is common to all rooms in a group and when the source room of the recording started
+ * @property {string} mediaExternalLocation -
+ *          The URL of the media file associated with the recording when stored externally
  * @property {string} links - The URLs of related resources
  *
  * @param {V1} version - Version of the resource
@@ -486,6 +490,7 @@ RecordingInstance = function RecordingInstance(version, payload, sid) {
   this.groupingSids = payload.grouping_sids; // jshint ignore:line
   this.trackName = payload.track_name; // jshint ignore:line
   this.offset = deserialize.integer(payload.offset); // jshint ignore:line
+  this.mediaExternalLocation = payload.media_external_location; // jshint ignore:line
   this.links = payload.links; // jshint ignore:line
 
   // Context

package/lib/rest/video/v1/recordingSettings.js

@@ -351,8 +351,8 @@ RecordingSettingsContext.prototype.create = function create(opts, callback) {
   if (_.isUndefined(opts)) {
     throw new Error('Required parameter "opts" missing.');
   }
-  if (_.isUndefined(opts.friendlyName)) {
-    throw new Error('Required parameter "opts.friendlyName" missing.');
+  if (_.isUndefined(opts['friendlyName'])) {
+    throw new Error('Required parameter "opts[\'friendlyName\']" missing.');
   }
 
   var deferred = Q.defer();

package/lib/rest/video/v1/room/recording.d.ts

@@ -231,6 +231,7 @@ interface RoomRecordingResource {
   duration: number;
   grouping_sids: object;
   links: string;
+  media_external_location: string;
   offset: number;
   room_sid: string;
   sid: string;
@@ -301,6 +302,7 @@ declare class RoomRecordingInstance extends SerializableClass {
   fetch(callback?: (error: Error | null, items: RoomRecordingInstance) => any): Promise<RoomRecordingInstance>;
   groupingSids: any;
   links: string;
+  mediaExternalLocation: string;
   offset: number;
   /**
    * remove a RoomRecordingInstance

package/lib/rest/video/v1/room/recording.js

@@ -145,6 +145,8 @@ RoomRecordingList = function RoomRecordingList(version, roomSid) {
         if (!done) {
           currentPage++;
           fetchNextPage(_.bind(page.nextPage, page));
+        } else {
+          onComplete();
         }
       });
 
@@ -451,6 +453,8 @@ RoomRecordingPage.prototype[util.inspect.custom] = function inspect(depth,
  *          The name that was given to the source track of the recording
  * @property {number} offset -
  *          The number of milliseconds between a point in time that is common to all rooms in a group and when the source room of the recording started
+ * @property {string} mediaExternalLocation -
+ *          The URL of the media file associated with the recording when stored externally
  * @property {string} roomSid -
  *          The SID of the Room resource the recording is associated with
  * @property {string} links - The URLs of related resources
@@ -481,6 +485,7 @@ RoomRecordingInstance = function RoomRecordingInstance(version, payload,
   this.groupingSids = payload.grouping_sids; // jshint ignore:line
   this.trackName = payload.track_name; // jshint ignore:line
   this.offset = deserialize.integer(payload.offset); // jshint ignore:line
+  this.mediaExternalLocation = payload.media_external_location; // jshint ignore:line
   this.roomSid = payload.room_sid; // jshint ignore:line
   this.links = payload.links; // jshint ignore:line
 

package/lib/rest/video/v1/room/roomParticipant/roomParticipantPublishedTrack.js

@@ -139,6 +139,8 @@ PublishedTrackList = function PublishedTrackList(version, roomSid,
         if (!done) {
           currentPage++;
           fetchNextPage(_.bind(page.nextPage, page));
+        } else {
+          onComplete();
         }
       });
 

package/lib/rest/video/v1/room/roomParticipant/roomParticipantSubscribedTrack.js

@@ -138,6 +138,8 @@ SubscribedTrackList = function SubscribedTrackList(version, roomSid,
         if (!done) {
           currentPage++;
           fetchNextPage(_.bind(page.nextPage, page));
+        } else {
+          onComplete();
         }
       });
 

package/lib/rest/video/v1/room/roomParticipant.js

@@ -150,6 +150,8 @@ ParticipantList = function ParticipantList(version, roomSid) {
         if (!done) {
           currentPage++;
           fetchNextPage(_.bind(page.nextPage, page));
+        } else {
+          onComplete();
         }
       });
 

package/lib/rest/video/v1/room.d.ts

@@ -168,6 +168,7 @@ interface RoomListInstance {
  * Options to pass to create
  *
  * @property audioOnly - Indicates whether the room will only contain audio track participants for group rooms.
+ * @property emptyRoomTimeout - Configures the time a room will remain active after last participant leaves.
  * @property enableTurn - Enable Twilio's Network Traversal TURN service
  * @property maxParticipantDuration - The maximum number of seconds a Participant can be connected to the room
  * @property maxParticipants - The maximum number of concurrent Participants allowed in the room
@@ -178,10 +179,12 @@ interface RoomListInstance {
  * @property statusCallbackMethod - The HTTP method we should use to call status_callback
  * @property type - The type of room
  * @property uniqueName - An application-defined string that uniquely identifies the resource
+ * @property unusedRoomTimeout - Configures the time a room will remain active when no one joins.
  * @property videoCodecs - An array of the video codecs that are supported when publishing a track in the room
  */
 interface RoomListInstanceCreateOptions {
   audioOnly?: boolean;
+  emptyRoomTimeout?: number;
   enableTurn?: boolean;
   maxParticipantDuration?: number;
   maxParticipants?: number;
@@ -192,6 +195,7 @@ interface RoomListInstanceCreateOptions {
   statusCallbackMethod?: string;
   type?: RoomRoomType;
   uniqueName?: string;
+  unusedRoomTimeout?: number;
   videoCodecs?: RoomVideoCodec | RoomVideoCodec[];
 }
 
@@ -285,6 +289,7 @@ interface RoomResource {
   date_created: Date;
   date_updated: Date;
   duration: number;
+  empty_room_timeout: number;
   enable_turn: boolean;
   end_time: Date;
   links: string;
@@ -299,6 +304,7 @@ interface RoomResource {
   status_callback_method: string;
   type: RoomRoomType;
   unique_name: string;
+  unused_room_timeout: number;
   url: string;
   video_codecs: RoomVideoCodec[];
 }
@@ -355,6 +361,7 @@ declare class RoomInstance extends SerializableClass {
   dateCreated: Date;
   dateUpdated: Date;
   duration: number;
+  emptyRoomTimeout: number;
   enableTurn: boolean;
   endTime: Date;
   /**
@@ -391,6 +398,7 @@ declare class RoomInstance extends SerializableClass {
   toJSON(): any;
   type: RoomRoomType;
   uniqueName: string;
+  unusedRoomTimeout: number;
   /**
    * update a RoomInstance
    *

package/lib/rest/video/v1/room.js

@@ -84,6 +84,10 @@ RoomList = function RoomList(version) {
    *          Indicates whether the room will only contain audio track participants for group rooms.
    * @param {number} [opts.maxParticipantDuration] -
    *          The maximum number of seconds a Participant can be connected to the room
+   * @param {number} [opts.emptyRoomTimeout] -
+   *          Configures the time a room will remain active after last participant leaves.
+   * @param {number} [opts.unusedRoomTimeout] -
+   *          Configures the time a room will remain active when no one joins.
    * @param {function} [callback] - Callback to handle processed record
    *
    * @returns {Promise} Resolves to processed RoomInstance
@@ -109,7 +113,9 @@ RoomList = function RoomList(version) {
       'MediaRegion': _.get(opts, 'mediaRegion'),
       'RecordingRules': serialize.object(_.get(opts, 'recordingRules')),
       'AudioOnly': serialize.bool(_.get(opts, 'audioOnly')),
-      'MaxParticipantDuration': _.get(opts, 'maxParticipantDuration')
+      'MaxParticipantDuration': _.get(opts, 'maxParticipantDuration'),
+      'EmptyRoomTimeout': _.get(opts, 'emptyRoomTimeout'),
+      'UnusedRoomTimeout': _.get(opts, 'unusedRoomTimeout')
     });
 
     var promise = this._version.create({uri: this._uri, method: 'POST', data: data});
@@ -219,6 +225,8 @@ RoomList = function RoomList(version) {
         if (!done) {
           currentPage++;
           fetchNextPage(_.bind(page.nextPage, page));
+        } else {
+          onComplete();
         }
       });
 
@@ -531,6 +539,10 @@ RoomPage.prototype[util.inspect.custom] = function inspect(depth, options) {
  * @property {string} mediaRegion - The region for the media server in Group Rooms
  * @property {boolean} audioOnly -
  *          Indicates whether the room will only contain audio track participants for group rooms.
+ * @property {number} emptyRoomTimeout -
+ *          The time a room will remain active after last participant leaves.
+ * @property {number} unusedRoomTimeout -
+ *          The time a room will remain active when no one joins.
  * @property {string} url - The absolute URL of the resource
  * @property {string} links - The URLs of related resources
  *
@@ -562,6 +574,8 @@ RoomInstance = function RoomInstance(version, payload, sid) {
   this.videoCodecs = payload.video_codecs; // jshint ignore:line
   this.mediaRegion = payload.media_region; // jshint ignore:line
   this.audioOnly = payload.audio_only; // jshint ignore:line
+  this.emptyRoomTimeout = deserialize.integer(payload.empty_room_timeout); // jshint ignore:line
+  this.unusedRoomTimeout = deserialize.integer(payload.unused_room_timeout); // jshint ignore:line
   this.url = payload.url; // jshint ignore:line
   this.links = payload.links; // jshint ignore:line
 
@@ -761,8 +775,8 @@ RoomContext.prototype.update = function update(opts, callback) {
   if (_.isUndefined(opts)) {
     throw new Error('Required parameter "opts" missing.');
   }
-  if (_.isUndefined(opts.status)) {
-    throw new Error('Required parameter "opts.status" missing.');
+  if (_.isUndefined(opts['status'])) {
+    throw new Error('Required parameter "opts[\'status\']" missing.');
   }
 
   var deferred = Q.defer();

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

@@ -7,6 +7,8 @@
 
 import Version = require('../../base/Version');
 import Voice = require('../Voice');
+import { ArchivedCallList } from './v1/archivedCall';
+import { ArchivedCallListInstance } from './v1/archivedCall';
 import { ByocTrunkList } from './v1/byocTrunk';
 import { ByocTrunkListInstance } from './v1/byocTrunk';
 import { ConnectionPolicyList } from './v1/connectionPolicy';
@@ -27,6 +29,7 @@ declare class V1 extends Version {
    */
   constructor(domain: Voice);
 
+  readonly archivedCalls: ArchivedCallListInstance;
   readonly byocTrunks: ByocTrunkListInstance;
   readonly connectionPolicies: ConnectionPolicyListInstance;
   readonly dialingPermissions: DialingPermissionsListInstance;

package/lib/rest/voice/V1.js

@@ -10,6 +10,7 @@
 /* jshint ignore:end */
 
 var _ = require('lodash');  /* jshint ignore:line */
+var ArchivedCallList = require('./v1/archivedCall').ArchivedCallList;
 var ByocTrunkList = require('./v1/byocTrunk').ByocTrunkList;
 var ConnectionPolicyList = require(
     './v1/connectionPolicy').ConnectionPolicyList;
@@ -26,6 +27,8 @@ var Version = require('../../base/Version');  /* jshint ignore:line */
  *
  * @constructor Twilio.Voice.V1
  *
+ * @property {Twilio.Voice.V1.ArchivedCallList} archivedCalls -
+ *          archivedCalls resource
  * @property {Twilio.Voice.V1.ByocTrunkList} byocTrunks - byocTrunks resource
  * @property {Twilio.Voice.V1.ConnectionPolicyList} connectionPolicies -
  *          connectionPolicies resource
@@ -42,6 +45,7 @@ function V1(domain) {
   Version.prototype.constructor.call(this, domain, 'v1');
 
   // Resources
+  this._archivedCalls = undefined;
   this._byocTrunks = undefined;
   this._connectionPolicies = undefined;
   this._dialingPermissions = undefined;
@@ -52,6 +56,14 @@ function V1(domain) {
 _.extend(V1.prototype, Version.prototype);
 V1.prototype.constructor = V1;
 
+Object.defineProperty(V1.prototype,
+  'archivedCalls', {
+    get: function() {
+      this._archivedCalls = this._archivedCalls || new ArchivedCallList(this);
+      return this._archivedCalls;
+    }
+});
+
 Object.defineProperty(V1.prototype,
   'byocTrunks', {
     get: function() {