@signalwire/compatibility-api/lib/twiml/TwiML.js

SignalWire Compatibility API

'use strict';

var builder = require('xmlbuilder');  /* jshint ignore:line */

/* jshint ignore:start */
/**
 * Parent TwiML object
 */
/* jshint ignore:end */
function TwiML() {
  this.response = builder.create('Response', {
    stringify: {
      attValue: function (value) {
        if (Array.isArray(value)) {
          value = value.join(' ');
        }
        return this.attEscape('' + value || '');
      }
    }
  }).dec('1.0', 'UTF-8');
}

/* jshint ignore:start */
/**
 * Because child elements have properties named after their class names, we need
 * to translate that when we want to access that at the parent prototype level.
 * So this will translate something like Say to 'say' and VoiceResponse to
 * 'response'.
 */
/* jshint ignore:end */
TwiML.prototype._getXml = function _getPropertyName() {
  return this[this._propertyName];
}

/* jshint ignore:start */
/**
 * Convert to TwiML
 *
 * @returns TwiML XML
 */
/* jshint ignore:end */
TwiML.prototype.toString = function toString() {
  return this._getXml().end();
}

/* jshint ignore:start */
/**
 * Add text under the TwiML node
 *
 * @param {string} content
 */
/* jshint ignore:end */
TwiML.prototype.addText = function addText(content) {
  this._getXml().txt(content);
}

/* jshint ignore:start */
/**
 * Add an arbitrary tag as a child.
 *
 * @param {string} content
 */
/* jshint ignore:end */
TwiML.prototype.addChild = function addChild(tagName, attributes) {
  return new GenericNode(this._getXml().ele(tagName, attributes));
}

/* jshint ignore:start */
/**
 * Generic node
 */
/* jshint ignore:end */
function GenericNode(node) {
  // must match variable name for _getPropertyName
  this.node = node;
  this._propertyName = 'node';
}

// "Inherit" from TwiML
GenericNode.prototype = Object.create(TwiML.prototype);
GenericNode.prototype.constructor = GenericNode;

module.exports = TwiML;