feat: add getMIDI

Author: gierschv

README.md

@@ -88,6 +88,7 @@ When instantiating `Flat.Embed`, you can pass options in the second parameter. I
   * [`getMusicXML`](#getmusicxmloptions-object-promisestringuint8array-error): Get the score in MusicXML (compressed or not)
   * [`getJSON`](#getjson-object): Get the score data in Flat JSON format
   * [`getPNG`](#getpngoptions-object-promisestringuint8array-error): Get the score as a PNG file
+  * [`getMIDI`](#getmidi-promiseuint8array-error): Get the score as a MIDI file
   * [`getScoreMeta`](#getscoremeta-object): Get the metadata from the current score (for hosted scores)
   * [`fullscreen`](#fullscreenstate-bool-promisevoid-error): Toggle fullscreen mode
   * [`play`](#play-promisevoid-error): Start playback
@@ -295,6 +296,25 @@ embed.getPNG({result: 'dataURL'}).then(function (png) {
 });
 ```
 
+### `getMIDI(): Promise<Uint8Array, Error>`
+
+Get the current displayed score as a MIDI file
+
+```js
+embed.getMIDI().then(function (midi) {
+  // MIDI file as a Uint8Array
+  console.log(midi);
+});
+```
+
+```js
+// PNG
+embed.getPNG({result: 'dataURL'}).then(function (png) {
+  // PNG file as a DataURL
+  console.log(png);
+});
+```
+
 ### `getScoreMeta(): object`
 
 Get the score metadata of the hosted score. The object will have the same format that the one returned [by our API `GET /v2/scores/{score}`](https://flat.io/developers/api/reference/#operation/getScore).

dist/embed.js

@@ -204,6 +204,17 @@ class Embed {
      });
    }
 
+  /**
+   * Convert the displayed score in MIDI
+   *
+   * @return {Promise}
+   * @fullfill {Uint8Array} MIDI File
+   * @reject {Error} Conversion error
+   */
+  getMIDI() {
+    return this.call('getMIDI').then(data => new Uint8Array(data));
+  }
+
   /**
    * Get the metadata of the score (for scores hosted on Flat)
    *

dist/embed.js.map

@@ -434,6 +434,30 @@ describe('Integration - Embed', () => {
     });
   });
 
+  describe('MIDI export', () => {
+    it('should export in MIDI', (done) => {
+      var container = document.createElement('div');
+      document.body.appendChild(container);
+
+      var embed = new Flat.Embed(container, {
+        score: PUBLIC_SCORE,
+        baseUrl: BASE_URL,
+        embedParams: {
+          appId: APP_ID,
+          layout: 'page'
+        }
+      });
+
+      embed.getMIDI()
+      .then((midi) => {
+        assert.ok(midi instanceof Uint8Array);
+        assert.ok(midi.length > 0);
+        container.parentNode.removeChild(container);
+        done();
+      });
+    });
+  });
+
   describe('Cursor position', () => {
     it('should get the cursor position (default: 0)', (done) => {
       var container = document.createElement('div');