twilio 3.74.0 → 3.76.0

package/lib/rest/insights/v1/annotation.d.ts

@@ -0,0 +1,188 @@
+/**
+ * This code was generated by
+ * \ / _    _  _|   _  _
+ *  | (_)\/(_)(_|\/| |(/_  v1.0.0
+ *       /       /
+ */
+
+import Page = require('../../../base/Page');
+import Response = require('../../../http/response');
+import V1 = require('../V1');
+import { SerializableClass } from '../../../interfaces';
+
+type AnnotationAnsweredBy = 'unknown_answered_by'|'human'|'machine';
+
+type AnnotationConnectivityIssue = 'unknown_connectivity_issue'|'no_connectivity_issue'|'invalid_number'|'caller_id'|'dropped_call'|'number_reachability';
+
+type AnnotationQualityIssues = 'unknown_quality_issue'|'no_quality_issue'|'low_volume'|'choppy_robotic'|'echo'|'dtmf'|'latency'|'owa'|'static_noise';
+
+/**
+ * Initialize the AnnotationList
+ *
+ * @param version - Version of the resource
+ */
+declare function AnnotationList(version: V1): AnnotationListInstance;
+
+/**
+ * Options to pass to update
+ *
+ * @property answeredBy - The answered_by
+ * @property callScore - The call_score
+ * @property comment - The comment
+ * @property connectivityIssue - The connectivity_issue
+ * @property incident - The incident
+ * @property qualityIssues - The quality_issues
+ * @property spam - The spam
+ */
+interface AnnotationInstanceUpdateOptions {
+  answeredBy?: AnnotationAnsweredBy;
+  callScore?: number;
+  comment?: string;
+  connectivityIssue?: AnnotationConnectivityIssue;
+  incident?: string;
+  qualityIssues?: string;
+  spam?: boolean;
+}
+
+interface AnnotationListInstance {
+  /**
+   * @param sid - sid of instance
+   */
+  (sid: string): AnnotationContext;
+  /**
+   * Constructs a annotation
+   *
+   * @param callSid - The call_sid
+   */
+  get(callSid: string): AnnotationContext;
+  /**
+   * Provide a user-friendly representation
+   */
+  toJSON(): any;
+}
+
+interface AnnotationPayload extends AnnotationResource, Page.TwilioResponsePayload {
+}
+
+interface AnnotationResource {
+  account_sid: string;
+  answered_by: AnnotationAnsweredBy;
+  call_score: number;
+  call_sid: string;
+  comment: string;
+  connectivity_issue: AnnotationConnectivityIssue;
+  incident: string;
+  quality_issues: string[];
+  spam: boolean;
+  url: string;
+}
+
+interface AnnotationSolution {
+}
+
+
+declare class AnnotationContext {
+  /**
+   * Initialize the AnnotationContext
+   *
+   * @param version - Version of the resource
+   * @param callSid - The call_sid
+   */
+  constructor(version: V1, callSid: string);
+
+  /**
+   * fetch a AnnotationInstance
+   *
+   * @param callback - Callback to handle processed record
+   */
+  fetch(callback?: (error: Error | null, items: AnnotationInstance) => any): Promise<AnnotationInstance>;
+  /**
+   * Provide a user-friendly representation
+   */
+  toJSON(): any;
+  /**
+   * update a AnnotationInstance
+   *
+   * @param callback - Callback to handle processed record
+   */
+  update(callback?: (error: Error | null, items: AnnotationInstance) => any): Promise<AnnotationInstance>;
+  /**
+   * update a AnnotationInstance
+   *
+   * @param opts - Options for request
+   * @param callback - Callback to handle processed record
+   */
+  update(opts?: AnnotationInstanceUpdateOptions, callback?: (error: Error | null, items: AnnotationInstance) => any): Promise<AnnotationInstance>;
+}
+
+
+declare class AnnotationInstance extends SerializableClass {
+  /**
+   * Initialize the AnnotationContext
+   *
+   * @param version - Version of the resource
+   * @param payload - The instance payload
+   * @param callSid - The call_sid
+   */
+  constructor(version: V1, payload: AnnotationPayload, callSid: string);
+
+  private _proxy: AnnotationContext;
+  accountSid: string;
+  answeredBy: AnnotationAnsweredBy;
+  callScore: number;
+  callSid: string;
+  comment: string;
+  connectivityIssue: AnnotationConnectivityIssue;
+  /**
+   * fetch a AnnotationInstance
+   *
+   * @param callback - Callback to handle processed record
+   */
+  fetch(callback?: (error: Error | null, items: AnnotationInstance) => any): Promise<AnnotationInstance>;
+  incident: string;
+  qualityIssues: string[];
+  spam: boolean;
+  /**
+   * Provide a user-friendly representation
+   */
+  toJSON(): any;
+  /**
+   * update a AnnotationInstance
+   *
+   * @param callback - Callback to handle processed record
+   */
+  update(callback?: (error: Error | null, items: AnnotationInstance) => any): Promise<AnnotationInstance>;
+  /**
+   * update a AnnotationInstance
+   *
+   * @param opts - Options for request
+   * @param callback - Callback to handle processed record
+   */
+  update(opts?: AnnotationInstanceUpdateOptions, callback?: (error: Error | null, items: AnnotationInstance) => any): Promise<AnnotationInstance>;
+  url: string;
+}
+
+
+declare class AnnotationPage extends Page<V1, AnnotationPayload, AnnotationResource, AnnotationInstance> {
+  /**
+   * Initialize the AnnotationPage
+   *
+   * @param version - Version of the resource
+   * @param response - Response from the API
+   * @param solution - Path solution
+   */
+  constructor(version: V1, response: Response<string>, solution: AnnotationSolution);
+
+  /**
+   * Build an instance of AnnotationInstance
+   *
+   * @param payload - Payload response from the API
+   */
+  getInstance(payload: AnnotationPayload): AnnotationInstance;
+  /**
+   * Provide a user-friendly representation
+   */
+  toJSON(): any;
+}
+
+export { AnnotationAnsweredBy, AnnotationConnectivityIssue, AnnotationContext, AnnotationInstance, AnnotationInstanceUpdateOptions, AnnotationList, AnnotationListInstance, AnnotationPage, AnnotationPayload, AnnotationQualityIssues, AnnotationResource, AnnotationSolution }

package/lib/rest/insights/v1/annotation.js

@@ -0,0 +1,406 @@
+'use strict';
+
+/* jshint ignore:start */
+/**
+ * This code was generated by
+ * \ / _    _  _|   _  _
+ *  | (_)\/(_)(_|\/| |(/_  v1.0.0
+ *       /       /
+ */
+/* jshint ignore:end */
+
+var Q = require('q');  /* jshint ignore:line */
+var _ = require('lodash');  /* jshint ignore:line */
+var util = require('util');  /* jshint ignore:line */
+var Page = require('../../../base/Page');  /* jshint ignore:line */
+var deserialize = require(
+    '../../../base/deserialize');  /* jshint ignore:line */
+var serialize = require('../../../base/serialize');  /* jshint ignore:line */
+var values = require('../../../base/values');  /* jshint ignore:line */
+
+var AnnotationList;
+var AnnotationPage;
+var AnnotationInstance;
+var AnnotationContext;
+
+/* jshint ignore:start */
+/**
+ * Initialize the AnnotationList
+ *
+ * @constructor Twilio.Insights.V1.AnnotationList
+ *
+ * @param {Twilio.Insights.V1} version - Version of the resource
+ */
+/* jshint ignore:end */
+AnnotationList = function AnnotationList(version) {
+  /* jshint ignore:start */
+  /**
+   * @function annotation
+   * @memberof Twilio.Insights.V1#
+   *
+   * @param {string} sid - sid of instance
+   *
+   * @returns {Twilio.Insights.V1.AnnotationContext}
+   */
+  /* jshint ignore:end */
+  function AnnotationListInstance(sid) {
+    return AnnotationListInstance.get(sid);
+  }
+
+  AnnotationListInstance._version = version;
+  // Path Solution
+  AnnotationListInstance._solution = {};
+  /* jshint ignore:start */
+  /**
+   * Constructs a annotation
+   *
+   * @function get
+   * @memberof Twilio.Insights.V1.AnnotationList#
+   *
+   * @param {string} callSid - The call_sid
+   *
+   * @returns {Twilio.Insights.V1.AnnotationContext}
+   */
+  /* jshint ignore:end */
+  AnnotationListInstance.get = function get(callSid) {
+    return new AnnotationContext(this._version, callSid);
+  };
+
+  /* jshint ignore:start */
+  /**
+   * Provide a user-friendly representation
+   *
+   * @function toJSON
+   * @memberof Twilio.Insights.V1.AnnotationList#
+   *
+   * @returns Object
+   */
+  /* jshint ignore:end */
+  AnnotationListInstance.toJSON = function toJSON() {
+    return this._solution;
+  };
+
+  AnnotationListInstance[util.inspect.custom] = function inspect(depth, options) {
+    return util.inspect(this.toJSON(), options);
+  };
+
+  return AnnotationListInstance;
+};
+
+
+/* jshint ignore:start */
+/**
+ * Initialize the AnnotationPage
+ *
+ * @constructor Twilio.Insights.V1.AnnotationPage
+ *
+ * @param {V1} version - Version of the resource
+ * @param {Response<string>} response - Response from the API
+ * @param {AnnotationSolution} solution - Path solution
+ *
+ * @returns AnnotationPage
+ */
+/* jshint ignore:end */
+AnnotationPage = function AnnotationPage(version, response, solution) {
+  // Path Solution
+  this._solution = solution;
+
+  Page.prototype.constructor.call(this, version, response, this._solution);
+};
+
+_.extend(AnnotationPage.prototype, Page.prototype);
+AnnotationPage.prototype.constructor = AnnotationPage;
+
+/* jshint ignore:start */
+/**
+ * Build an instance of AnnotationInstance
+ *
+ * @function getInstance
+ * @memberof Twilio.Insights.V1.AnnotationPage#
+ *
+ * @param {AnnotationPayload} payload - Payload response from the API
+ *
+ * @returns AnnotationInstance
+ */
+/* jshint ignore:end */
+AnnotationPage.prototype.getInstance = function getInstance(payload) {
+  return new AnnotationInstance(this._version, payload);
+};
+
+/* jshint ignore:start */
+/**
+ * Provide a user-friendly representation
+ *
+ * @function toJSON
+ * @memberof Twilio.Insights.V1.AnnotationPage#
+ *
+ * @returns Object
+ */
+/* jshint ignore:end */
+AnnotationPage.prototype.toJSON = function toJSON() {
+  let clone = {};
+  _.forOwn(this, function(value, key) {
+    if (!_.startsWith(key, '_') && ! _.isFunction(value)) {
+      clone[key] = value;
+    }
+  });
+  return clone;
+};
+
+AnnotationPage.prototype[util.inspect.custom] = function inspect(depth, options)
+    {
+  return util.inspect(this.toJSON(), options);
+};
+
+
+/* jshint ignore:start */
+/**
+ * Initialize the AnnotationContext
+ *
+ * @constructor Twilio.Insights.V1.AnnotationInstance
+ *
+ * @property {string} callSid - The call_sid
+ * @property {string} accountSid - The account_sid
+ * @property {annotation.answered_by} answeredBy - The answered_by
+ * @property {annotation.connectivity_issue} connectivityIssue -
+ *          The connectivity_issue
+ * @property {string} qualityIssues - The quality_issues
+ * @property {boolean} spam - The spam
+ * @property {number} callScore - The call_score
+ * @property {string} comment - The comment
+ * @property {string} incident - The incident
+ * @property {string} url - The url
+ *
+ * @param {V1} version - Version of the resource
+ * @param {AnnotationPayload} payload - The instance payload
+ * @param {sid} callSid - The call_sid
+ */
+/* jshint ignore:end */
+AnnotationInstance = function AnnotationInstance(version, payload, callSid) {
+  this._version = version;
+
+  // Marshaled Properties
+  this.callSid = payload.call_sid; // jshint ignore:line
+  this.accountSid = payload.account_sid; // jshint ignore:line
+  this.answeredBy = payload.answered_by; // jshint ignore:line
+  this.connectivityIssue = payload.connectivity_issue; // jshint ignore:line
+  this.qualityIssues = payload.quality_issues; // jshint ignore:line
+  this.spam = payload.spam; // jshint ignore:line
+  this.callScore = deserialize.integer(payload.call_score); // jshint ignore:line
+  this.comment = payload.comment; // jshint ignore:line
+  this.incident = payload.incident; // jshint ignore:line
+  this.url = payload.url; // jshint ignore:line
+
+  // Context
+  this._context = undefined;
+  this._solution = {callSid: callSid || this.callSid, };
+};
+
+Object.defineProperty(AnnotationInstance.prototype,
+  '_proxy', {
+    get: function() {
+      if (!this._context) {
+        this._context = new AnnotationContext(this._version, this._solution.callSid);
+      }
+
+      return this._context;
+    }
+});
+
+/* jshint ignore:start */
+/**
+ * update a AnnotationInstance
+ *
+ * @function update
+ * @memberof Twilio.Insights.V1.AnnotationInstance#
+ *
+ * @param {object} [opts] - Options for request
+ * @param {annotation.answered_by} [opts.answeredBy] - The answered_by
+ * @param {annotation.connectivity_issue} [opts.connectivityIssue] -
+ *          The connectivity_issue
+ * @param {string} [opts.qualityIssues] - The quality_issues
+ * @param {boolean} [opts.spam] - The spam
+ * @param {number} [opts.callScore] - The call_score
+ * @param {string} [opts.comment] - The comment
+ * @param {string} [opts.incident] - The incident
+ * @param {function} [callback] - Callback to handle processed record
+ *
+ * @returns {Promise} Resolves to processed AnnotationInstance
+ */
+/* jshint ignore:end */
+AnnotationInstance.prototype.update = function update(opts, callback) {
+  return this._proxy.update(opts, callback);
+};
+
+/* jshint ignore:start */
+/**
+ * fetch a AnnotationInstance
+ *
+ * @function fetch
+ * @memberof Twilio.Insights.V1.AnnotationInstance#
+ *
+ * @param {function} [callback] - Callback to handle processed record
+ *
+ * @returns {Promise} Resolves to processed AnnotationInstance
+ */
+/* jshint ignore:end */
+AnnotationInstance.prototype.fetch = function fetch(callback) {
+  return this._proxy.fetch(callback);
+};
+
+/* jshint ignore:start */
+/**
+ * Provide a user-friendly representation
+ *
+ * @function toJSON
+ * @memberof Twilio.Insights.V1.AnnotationInstance#
+ *
+ * @returns Object
+ */
+/* jshint ignore:end */
+AnnotationInstance.prototype.toJSON = function toJSON() {
+  let clone = {};
+  _.forOwn(this, function(value, key) {
+    if (!_.startsWith(key, '_') && ! _.isFunction(value)) {
+      clone[key] = value;
+    }
+  });
+  return clone;
+};
+
+AnnotationInstance.prototype[util.inspect.custom] = function inspect(depth,
+    options) {
+  return util.inspect(this.toJSON(), options);
+};
+
+
+/* jshint ignore:start */
+/**
+ * Initialize the AnnotationContext
+ *
+ * @constructor Twilio.Insights.V1.AnnotationContext
+ *
+ * @param {V1} version - Version of the resource
+ * @param {sid} callSid - The call_sid
+ */
+/* jshint ignore:end */
+AnnotationContext = function AnnotationContext(version, callSid) {
+  this._version = version;
+
+  // Path Solution
+  this._solution = {callSid: callSid, };
+  this._uri = `/Voice/${callSid}/Annotation`;
+};
+
+/* jshint ignore:start */
+/**
+ * update a AnnotationInstance
+ *
+ * @function update
+ * @memberof Twilio.Insights.V1.AnnotationContext#
+ *
+ * @param {object} [opts] - Options for request
+ * @param {annotation.answered_by} [opts.answeredBy] - The answered_by
+ * @param {annotation.connectivity_issue} [opts.connectivityIssue] -
+ *          The connectivity_issue
+ * @param {string} [opts.qualityIssues] - The quality_issues
+ * @param {boolean} [opts.spam] - The spam
+ * @param {number} [opts.callScore] - The call_score
+ * @param {string} [opts.comment] - The comment
+ * @param {string} [opts.incident] - The incident
+ * @param {function} [callback] - Callback to handle processed record
+ *
+ * @returns {Promise} Resolves to processed AnnotationInstance
+ */
+/* jshint ignore:end */
+AnnotationContext.prototype.update = function update(opts, callback) {
+  if (_.isFunction(opts)) {
+    callback = opts;
+    opts = {};
+  }
+  opts = opts || {};
+
+  var deferred = Q.defer();
+  var data = values.of({
+    'AnsweredBy': _.get(opts, 'answeredBy'),
+    'ConnectivityIssue': _.get(opts, 'connectivityIssue'),
+    'QualityIssues': _.get(opts, 'qualityIssues'),
+    'Spam': serialize.bool(_.get(opts, 'spam')),
+    'CallScore': _.get(opts, 'callScore'),
+    'Comment': _.get(opts, 'comment'),
+    'Incident': _.get(opts, 'incident')
+  });
+
+  var promise = this._version.update({uri: this._uri, method: 'POST', data: data});
+
+  promise = promise.then(function(payload) {
+    deferred.resolve(new AnnotationInstance(this._version, payload, this._solution.callSid));
+  }.bind(this));
+
+  promise.catch(function(error) {
+    deferred.reject(error);
+  });
+
+  if (_.isFunction(callback)) {
+    deferred.promise.nodeify(callback);
+  }
+
+  return deferred.promise;
+};
+
+/* jshint ignore:start */
+/**
+ * fetch a AnnotationInstance
+ *
+ * @function fetch
+ * @memberof Twilio.Insights.V1.AnnotationContext#
+ *
+ * @param {function} [callback] - Callback to handle processed record
+ *
+ * @returns {Promise} Resolves to processed AnnotationInstance
+ */
+/* jshint ignore:end */
+AnnotationContext.prototype.fetch = function fetch(callback) {
+  var deferred = Q.defer();
+  var promise = this._version.fetch({uri: this._uri, method: 'GET'});
+
+  promise = promise.then(function(payload) {
+    deferred.resolve(new AnnotationInstance(this._version, payload, this._solution.callSid));
+  }.bind(this));
+
+  promise.catch(function(error) {
+    deferred.reject(error);
+  });
+
+  if (_.isFunction(callback)) {
+    deferred.promise.nodeify(callback);
+  }
+
+  return deferred.promise;
+};
+
+/* jshint ignore:start */
+/**
+ * Provide a user-friendly representation
+ *
+ * @function toJSON
+ * @memberof Twilio.Insights.V1.AnnotationContext#
+ *
+ * @returns Object
+ */
+/* jshint ignore:end */
+AnnotationContext.prototype.toJSON = function toJSON() {
+  return this._solution;
+};
+
+AnnotationContext.prototype[util.inspect.custom] = function inspect(depth,
+    options) {
+  return util.inspect(this.toJSON(), options);
+};
+
+module.exports = {
+  AnnotationList: AnnotationList,
+  AnnotationPage: AnnotationPage,
+  AnnotationInstance: AnnotationInstance,
+  AnnotationContext: AnnotationContext
+};

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

@@ -9,6 +9,8 @@ import Media = require('../Media');
 import Version = require('../../base/Version');
 import { MediaProcessorList } from './v1/mediaProcessor';
 import { MediaProcessorListInstance } from './v1/mediaProcessor';
+import { MediaRecordingList } from './v1/mediaRecording';
+import { MediaRecordingListInstance } from './v1/mediaRecording';
 import { PlayerStreamerList } from './v1/playerStreamer';
 import { PlayerStreamerListInstance } from './v1/playerStreamer';
 
@@ -22,6 +24,7 @@ declare class V1 extends Version {
   constructor(domain: Media);
 
   readonly mediaProcessor: MediaProcessorListInstance;
+  readonly mediaRecording: MediaRecordingListInstance;
   readonly playerStreamer: PlayerStreamerListInstance;
 }
 

package/lib/rest/media/V1.js

@@ -11,6 +11,7 @@
 
 var _ = require('lodash');  /* jshint ignore:line */
 var MediaProcessorList = require('./v1/mediaProcessor').MediaProcessorList;
+var MediaRecordingList = require('./v1/mediaRecording').MediaRecordingList;
 var PlayerStreamerList = require('./v1/playerStreamer').PlayerStreamerList;
 var Version = require('../../base/Version');  /* jshint ignore:line */
 
@@ -23,6 +24,8 @@ var Version = require('../../base/Version');  /* jshint ignore:line */
  *
  * @property {Twilio.Media.V1.MediaProcessorList} mediaProcessor -
  *          mediaProcessor resource
+ * @property {Twilio.Media.V1.MediaRecordingList} mediaRecording -
+ *          mediaRecording resource
  * @property {Twilio.Media.V1.PlayerStreamerList} playerStreamer -
  *          playerStreamer resource
  *
@@ -34,6 +37,7 @@ function V1(domain) {
 
   // Resources
   this._mediaProcessor = undefined;
+  this._mediaRecording = undefined;
   this._playerStreamer = undefined;
 }
 
@@ -48,6 +52,14 @@ Object.defineProperty(V1.prototype,
     }
 });
 
+Object.defineProperty(V1.prototype,
+  'mediaRecording', {
+    get: function() {
+      this._mediaRecording = this._mediaRecording || new MediaRecordingList(this);
+      return this._mediaRecording;
+    }
+});
+
 Object.defineProperty(V1.prototype,
   'playerStreamer', {
     get: function() {

package/lib/rest/media/v1/mediaProcessor.js

@@ -487,7 +487,7 @@ MediaProcessorPage.prototype[util.inspect.custom] = function inspect(depth,
  *          The URL to which Twilio will send MediaProcessor event updates
  * @property {string} statusCallbackMethod -
  *          The HTTP method Twilio should use to call the `status_callback` URL
- * @property {number} maxDuration - Maximum MediaProcessor duration in minutes
+ * @property {number} maxDuration - Maximum MediaProcessor duration in seconds
  *
  * @param {V1} version - Version of the resource
  * @param {MediaProcessorPayload} payload - The instance payload