Merge pull request #20 from wajiw/feature-playEarlyMedia

Adding new PlayEarlyMedia PERCL command to the SDK

Author: Deseao

docs/source/percl/percl.rst

@@ -160,6 +160,15 @@ play(file, options)
 
     :returns: {{Play}} An object representing a Play command.
 
+playEarlyMedia(file)
+--------------------
+
+    Build a PlayEarlyMedia PerCL command.
+
+    :file: {string} The URL of the audio file to be played to the caller.
+
+    :returns: {{PlayEarlyMedia}} An object representing a PlayEarlyMedia command.
+
 say(text, options)
 --------------------
 
@@ -213,4 +222,4 @@ build(scripts)
 
     :scripts: ...{object} One or more PerCL commands.
 
-    :returns: {[script]} Returns all the provided PerCL commands wrapped in an array.
+    :returns: {[script]} Returns all the provided PerCL commands wrapped in an array.

package.json

@@ -1,6 +1,6 @@
 {
   "name": "@persephony/sdk",
-  "version": "0.0.2",
+  "version": "0.1.0",
   "description": "The SDK for the Persephony API",
   "homepage":"https://www.persephony.com",
   "bugs":{

src/percl/percl.js

@@ -188,6 +188,16 @@ function play (file, options) {
   return {Play: assign({file: file}, options)}
 }
 
+/**
+ * Build a PlayEarlyMedia PerCL command.
+ *
+ * @param {string} file - The URL of the audio file to be played to the caller.
+ * @returns {{PlayEarlyMedia}} - An object representing a PlayEarlyMedia command.
+ */
+function playEarlyMedia (file) {
+  return {PlayEarlyMedia: {file: file}}
+}
+
 /**
  * Build a Say PerCL command.
  *
@@ -263,6 +273,7 @@ module.exports = {
   recordUtterance: recordUtterance,
   startRecordCall: startRecordCall,
   play: play,
+  playEarlyMedia: playEarlyMedia,
   say: say,
   getDigits: getDigits,
   getSpeech: getSpeech,

src/percl/percl.test.js

@@ -164,6 +164,12 @@ describe('percl', function () {
       expect(percl.play(file, {loop: loop, conferenceId: conferenceId})).toEqual({Play: {file: file, loop: loop, conferenceId: conferenceId}})
     })
   })
+  describe('playEarlyMedia', function () {
+    var file = 'http://file.url'
+    it('should create a playEarlyMedia command', function () {
+      expect(percl.playEarlyMedia(file)).toEqual({PlayEarlyMedia: {file: file}})
+    })
+  })
   describe('say', function () {
     it('should return a Say command with the text set to the parameter value', function () {
       var expectedText = 'Hello World'