add Video.Assets.createTrack and Video.Assets.deleteTrack methods

Author: dylanjha

src/video/resources/assets.js

@@ -208,6 +208,61 @@ class Assets extends Base {
       `${buildBasePath(assetId)}/playback-ids/${playbackId}`
     );
   }
+
+  /**
+   * Create a subtitle text track
+   * @param {string} assetId - The ID for the asset
+   * @param {Object} params - subtitle text track JSON parameters
+   * @returns {Promise} - Returns a resolved Promise with a response from the Mux API
+   *
+   * @example
+   * const { Video } = new Mux(accessToken, secret);
+   *
+   * // Create an asset text track
+   * Video.Assets.createTrack(assetId, {
+   *   url: "https://example.com/myVIdeo_en.srt",
+   *   type: "text",
+   *   text_type: "subtitles",
+   *   language_code: "en-US",
+   * });
+   *
+   * @see https://docs.mux.com/reference#create-a-subtitle-text-track
+   */
+  createTrack(assetId, params) {
+    if (!assetId) {
+      return Promise.reject(new Error('An asset ID is required'));
+    }
+
+    if (!params) {
+      return Promise.reject(new Error('Text track params are required'));
+    }
+    return this.http.post(`${buildBasePath(assetId)}/tracks`, params);
+  }
+
+  /**
+   * Delete an asset text track
+   * @param {string} assetId - The ID for the asset
+   * @param {string} trackId - The ID for the asset text track to delete
+   * @returns {Promise} - Returns a resolved Promise with a response from the Mux API
+   *
+   * @example
+   * const { Video } = new Mux(accessToken, secret);
+   *
+   * // Delete an asset text track
+   * Video.Assets.deleteTrack(assetId, trackId);
+   *
+   * @see https://docs.mux.com/reference#delete-a-subtitle-text-track
+   */
+  deleteTrack(assetId, trackId) {
+    if (!assetId) {
+      return Promise.reject(new Error('An asset ID is required'));
+    }
+
+    if (!trackId) {
+      return Promise.reject(new Error('A track ID is required'));
+    }
+    return this.http.delete(`${buildBasePath(assetId)}/tracks/${trackId}`);
+  }
 }
 
 module.exports = Assets;

test/unit/video/resources/assets.spec.js

@@ -328,4 +328,93 @@ describe('Unit::Assets', () => {
         expect(err.message).to.equal('A playback ID is required');
       }));
   });
+
+  /** @test {Assets.createTrack} */
+  describe('Assets.createTrack', () => {
+    /** @test {Assets.createTrack} */
+    it('makes a POST request to create a text track for an asset', done => {
+      moxios.stubRequest(
+        'https://api.mux.com/video/v1/assets/testAsset/tracks',
+        {
+          status: 200,
+          responseText: '{"data": {"create": true}}',
+        }
+      );
+
+      const onFulfilled = sinon.spy();
+      testAssets
+        .createTrack('testAsset', {
+          url: 'https://example.com/myVIdeo_en.srt',
+          type: 'text',
+          text_type: 'subtitles',
+          language_code: 'en-US',
+        })
+        .then(onFulfilled);
+
+      return moxios.wait(() => {
+        expect(onFulfilled.getCall(0).args[0].create).to.be.true;
+        done();
+      });
+    });
+
+    /** @test {Assets.createTrack} */
+    it('throws an error if an asset id is not given', () =>
+      testAssets
+        .createTrack()
+        .then(res => {
+          expect(res).to.not.exist;
+        })
+        .catch(err => {
+          expect(err).to.exist;
+          expect(err.message).to.equal('An asset ID is required');
+        }));
+
+    /** @test {Assets.createTrack} */
+    it('throws an error if track params are not given', () =>
+      testAssets
+        .createTrack('assetid')
+        .then(res => {
+          expect(res).to.not.exist;
+        })
+        .catch(err => {
+          expect(err).to.exist;
+          expect(err.message).to.equal('Text track params are required');
+        }));
+  });
+
+  /** @test {Assets.deleteTrack} */
+  describe('Assets.deleteTrack', () => {
+    /** @test {Assets.deleteTrack} */
+    it('makes a DELETE request to delete a text track for an asset', done => {
+      moxios.stubRequest(
+        'https://api.mux.com/video/v1/assets/testAsset/tracks/testTrackId',
+        {
+          status: 200,
+          responseText: '{"data": {"delete": true}}',
+        }
+      );
+
+      const onFulfilled = sinon.spy();
+      testAssets.deleteTrack('testAsset', 'testTrackId').then(onFulfilled);
+
+      return moxios.wait(() => {
+        expect(onFulfilled.getCall(0).args[0].delete).to.be.true;
+        done();
+      });
+    });
+
+    /** @test {Assets.deleteTrack} */
+    it('throws an error if an asset id is not given', () =>
+      testAssets.deleteTrack().catch(err => {
+        expect(err).to.exist;
+        expect(err.message).to.equal('An asset ID is required');
+      }));
+
+    /** @test {Assets.deleteTrack} */
+    it('throws an error if text track ID is not given', () =>
+      testAssets.deleteTrack('assetid').catch(err => {
+        expect(err).to.exist;
+        expect(err.message).to.equal('A track ID is required');
+      }));
+  });
 });