@dolbyio/dolbyio-rest-apis-client
Version:
Node.JS wrapper for the Dolby OptiView REST APIs
488 lines (477 loc) • 23.6 kB
JavaScript
;
function _typeof(o) { "@babel/helpers - typeof"; return _typeof = "function" == typeof Symbol && "symbol" == typeof Symbol.iterator ? function (o) { return typeof o; } : function (o) { return o && "function" == typeof Symbol && o.constructor === Symbol && o !== Symbol.prototype ? "symbol" : typeof o; }, _typeof(o); }
Object.defineProperty(exports, "__esModule", {
value: true
});
exports.updateTranscoder = exports.stopTranscoder = exports.startTranscoder = exports.scheduler = exports.listTranscoders = exports.listTranscoderProfiles = exports.listTranscoderInstances = exports.getTranscoderInstance = exports.getTranscoder = exports.deleteTranscoder = exports.createTranscoder = void 0;
var _httpHelpers = require("./internal/httpHelpers");
var Urls = _interopRequireWildcard(require("../urls"));
var _scheduler = _interopRequireWildcard(require("./transcodersSchedules"));
exports.scheduler = _scheduler;
function _interopRequireWildcard(e, t) { if ("function" == typeof WeakMap) var r = new WeakMap(), n = new WeakMap(); return (_interopRequireWildcard = function _interopRequireWildcard(e, t) { if (!t && e && e.__esModule) return e; var o, i, f = { __proto__: null, "default": e }; if (null === e || "object" != _typeof(e) && "function" != typeof e) return f; if (o = t ? n : r) { if (o.has(e)) return o.get(e); o.set(e, f); } for (var _t in e) "default" !== _t && {}.hasOwnProperty.call(e, _t) && ((i = (o = Object.defineProperty) && Object.getOwnPropertyDescriptor(e, _t)) && (i.get || i.set) ? o(f, _t, i) : f[_t] = e[_t]); return f; })(e, t); }
function _regenerator() { /*! regenerator-runtime -- Copyright (c) 2014-present, Facebook, Inc. -- license (MIT): https://github.com/babel/babel/blob/main/packages/babel-helpers/LICENSE */ var e, t, r = "function" == typeof Symbol ? Symbol : {}, n = r.iterator || "@@iterator", o = r.toStringTag || "@@toStringTag"; function i(r, n, o, i) { var c = n && n.prototype instanceof Generator ? n : Generator, u = Object.create(c.prototype); return _regeneratorDefine2(u, "_invoke", function (r, n, o) { var i, c, u, f = 0, p = o || [], y = !1, G = { p: 0, n: 0, v: e, a: d, f: d.bind(e, 4), d: function d(t, r) { return i = t, c = 0, u = e, G.n = r, a; } }; function d(r, n) { for (c = r, u = n, t = 0; !y && f && !o && t < p.length; t++) { var o, i = p[t], d = G.p, l = i[2]; r > 3 ? (o = l === n) && (u = i[(c = i[4]) ? 5 : (c = 3, 3)], i[4] = i[5] = e) : i[0] <= d && ((o = r < 2 && d < i[1]) ? (c = 0, G.v = n, G.n = i[1]) : d < l && (o = r < 3 || i[0] > n || n > l) && (i[4] = r, i[5] = n, G.n = l, c = 0)); } if (o || r > 1) return a; throw y = !0, n; } return function (o, p, l) { if (f > 1) throw TypeError("Generator is already running"); for (y && 1 === p && d(p, l), c = p, u = l; (t = c < 2 ? e : u) || !y;) { i || (c ? c < 3 ? (c > 1 && (G.n = -1), d(c, u)) : G.n = u : G.v = u); try { if (f = 2, i) { if (c || (o = "next"), t = i[o]) { if (!(t = t.call(i, u))) throw TypeError("iterator result is not an object"); if (!t.done) return t; u = t.value, c < 2 && (c = 0); } else 1 === c && (t = i["return"]) && t.call(i), c < 2 && (u = TypeError("The iterator does not provide a '" + o + "' method"), c = 1); i = e; } else if ((t = (y = G.n < 0) ? u : r.call(n, G)) !== a) break; } catch (t) { i = e, c = 1, u = t; } finally { f = 1; } } return { value: t, done: y }; }; }(r, o, i), !0), u; } var a = {}; function Generator() {} function GeneratorFunction() {} function GeneratorFunctionPrototype() {} t = Object.getPrototypeOf; var c = [][n] ? t(t([][n]())) : (_regeneratorDefine2(t = {}, n, function () { return this; }), t), u = GeneratorFunctionPrototype.prototype = Generator.prototype = Object.create(c); function f(e) { return Object.setPrototypeOf ? Object.setPrototypeOf(e, GeneratorFunctionPrototype) : (e.__proto__ = GeneratorFunctionPrototype, _regeneratorDefine2(e, o, "GeneratorFunction")), e.prototype = Object.create(u), e; } return GeneratorFunction.prototype = GeneratorFunctionPrototype, _regeneratorDefine2(u, "constructor", GeneratorFunctionPrototype), _regeneratorDefine2(GeneratorFunctionPrototype, "constructor", GeneratorFunction), GeneratorFunction.displayName = "GeneratorFunction", _regeneratorDefine2(GeneratorFunctionPrototype, o, "GeneratorFunction"), _regeneratorDefine2(u), _regeneratorDefine2(u, o, "Generator"), _regeneratorDefine2(u, n, function () { return this; }), _regeneratorDefine2(u, "toString", function () { return "[object Generator]"; }), (_regenerator = function _regenerator() { return { w: i, m: f }; })(); }
function _regeneratorDefine2(e, r, n, t) { var i = Object.defineProperty; try { i({}, "", {}); } catch (e) { i = 0; } _regeneratorDefine2 = function _regeneratorDefine(e, r, n, t) { function o(r, n) { _regeneratorDefine2(e, r, function (e) { return this._invoke(r, n, e); }); } r ? i ? i(e, r, { value: n, enumerable: !t, configurable: !t, writable: !t }) : e[r] = n : (o("next", 0), o("throw", 1), o("return", 2)); }, _regeneratorDefine2(e, r, n, t); }
function asyncGeneratorStep(n, t, e, r, o, a, c) { try { var i = n[a](c), u = i.value; } catch (n) { return void e(n); } i.done ? t(u) : Promise.resolve(u).then(r, o); }
function _asyncToGenerator(n) { return function () { var t = this, e = arguments; return new Promise(function (r, o) { var a = n.apply(t, e); function _next(n) { asyncGeneratorStep(a, r, o, _next, _throw, "next", n); } function _throw(n) { asyncGeneratorStep(a, r, o, _next, _throw, "throw", n); } _next(void 0); }); }; }
/**
* Lists all transcoders.
*
* @see {@link https://optiview.dolby.com/docs/millicast/api/transcoder-list-transcoders/}
*
* @remarks Cloud transcoder is not currently available for general usage.
* If you would like to opt in, please contact our Sales team.
*
* @param apiSecret The API Secret used to authenticate this request.
* @param options Options to sort the response.
*
* @returns A {@link !Promise Promise} whose fulfillment handler receives an array of {@link Transcoder} objects.
*/
var listTranscoders = exports.listTranscoders = /*#__PURE__*/function () {
var _ref = _asyncToGenerator(/*#__PURE__*/_regenerator().m(function _callee(apiSecret, options) {
var _options$isDescending;
var params, queryOptions;
return _regenerator().w(function (_context) {
while (1) switch (_context.n) {
case 0:
params = {
sortBy: options.sortBy,
page: options.page.toString(),
itemsOnPage: options.itemsOnPage.toString(),
isDescending: ((_options$isDescending = options.isDescending) !== null && _options$isDescending !== void 0 ? _options$isDescending : false).toString()
};
if (options.status) {
params['status'] = options.status;
}
if (options.cluster) {
params['cluster'] = options.cluster;
}
if (options.transcoderName) {
params['transcoderName'] = options.transcoderName;
}
queryOptions = {
hostname: Urls.getRtsHostname(),
path: '/api/transcoders',
params: params,
headers: {
Accept: 'application/json',
Authorization: "Bearer ".concat(apiSecret)
}
};
_context.n = 1;
return (0, _httpHelpers.sendGet)(queryOptions);
case 1:
return _context.a(2, _context.v);
}
}, _callee);
}));
return function listTranscoders(_x, _x2) {
return _ref.apply(this, arguments);
};
}();
/**
* Gets the specified cloud transcoder.
*
* @see {@link https://optiview.dolby.com/docs/millicast/api/transcoder-get-transcoder/}
*
* @remarks Cloud transcoder is not currently available for general usage.
* If you would like to opt in, please contact our Sales team.
*
* @param apiSecret The API Secret used to authenticate this request.
* @param transcoderId Identifier of the cloud transcoder to retrieve.
*
* @returns A {@link !Promise Promise} whose fulfillment handler receives a {@link Transcoder} object.
*/
var getTranscoder = exports.getTranscoder = /*#__PURE__*/function () {
var _ref2 = _asyncToGenerator(/*#__PURE__*/_regenerator().m(function _callee2(apiSecret, transcoderId) {
var options;
return _regenerator().w(function (_context2) {
while (1) switch (_context2.n) {
case 0:
options = {
hostname: Urls.getRtsHostname(),
path: "/api/transcoders/".concat(transcoderId),
headers: {
Accept: 'application/json',
Authorization: "Bearer ".concat(apiSecret)
}
};
_context2.n = 1;
return (0, _httpHelpers.sendGet)(options);
case 1:
return _context2.a(2, _context2.v);
}
}, _callee2);
}));
return function getTranscoder(_x3, _x4) {
return _ref2.apply(this, arguments);
};
}();
/**
* Deletes the specified cloud transcoder.
*
* @see {@link https://optiview.dolby.com/docs/millicast/api/transcoder-delete-transcoder/}
*
* @remarks Cloud transcoder is not currently available for general usage.
* If you would like to opt in, please contact our Sales team.
*
* @param apiSecret The API Secret used to authenticate this request.
* @param transcoderId Identifier of the cloud transcoder to delete.
*
* @returns A {@link !Promise Promise} whose fulfillment handler receives a flag to indicate if the operation succeeded or not.
*/
var deleteTranscoder = exports.deleteTranscoder = /*#__PURE__*/function () {
var _ref3 = _asyncToGenerator(/*#__PURE__*/_regenerator().m(function _callee3(apiSecret, transcoderId) {
var options;
return _regenerator().w(function (_context3) {
while (1) switch (_context3.n) {
case 0:
options = {
hostname: Urls.getRtsHostname(),
path: "/api/transcoders/".concat(transcoderId),
headers: {
Accept: 'application/json',
Authorization: "Bearer ".concat(apiSecret)
}
};
_context3.n = 1;
return (0, _httpHelpers.sendDelete)(options);
case 1:
return _context3.a(2, _context3.v);
}
}, _callee3);
}));
return function deleteTranscoder(_x5, _x6) {
return _ref3.apply(this, arguments);
};
}();
/**
* ## Creates a cloud transcoder.
*
* Create a Cloud Transcoder to enable Adaptive Bitrate (ABR) Simulcast streams without requiring multiple broadcast contribution sources.
*
* A Transcoder represents the configuration of your bitrate ladder from a pre-defined profile or by setting the maximum height and frameRate you'd like to target.
* See the 'List Transcoder Profiles' endpoint to find available Transcoder profiles. If you specify both a profile id and height/frameRate settings only the profile will be used.
*
* You should update any broadcast encoders to use this new origin server as configured by the DNS of the Transcoder which can be found in the response data.
*
* @remarks There are additional charges for a Transcoder so you should use
* the {@link stopTranscoder | Stop Transcoder} and {@link startTranscoder | Start Transcoder} capabilities
* to enable cloud transcoding only when you need to broadcast.
*
* Cloud transcoder is not currently available for general usage.
* If you would like to opt in, please contact our Sales team.
*
* @see {@link https://optiview.dolby.com/docs/millicast/api/transcoder-create-transcoder/}
*
* @param apiSecret The API Secret used to authenticate this request.
* @param transcoder Information about the new cloud transcoder.
*
* @returns A {@link !Promise Promise} whose fulfillment handler receives a {@link Transcoder} object.
*/
var createTranscoder = exports.createTranscoder = /*#__PURE__*/function () {
var _ref4 = _asyncToGenerator(/*#__PURE__*/_regenerator().m(function _callee4(apiSecret, transcoder) {
var options;
return _regenerator().w(function (_context4) {
while (1) switch (_context4.n) {
case 0:
if (transcoder.startNow == null) {
transcoder.startNow = false;
}
if (transcoder.passThrough == null) {
transcoder.passThrough = false;
}
options = {
hostname: Urls.getRtsHostname(),
path: '/api/transcoders/',
headers: {
Accept: 'application/json',
'Content-Type': 'application/json',
Authorization: "Bearer ".concat(apiSecret)
},
body: JSON.stringify(transcoder)
};
_context4.n = 1;
return (0, _httpHelpers.sendPost)(options);
case 1:
return _context4.a(2, _context4.v);
}
}, _callee4);
}));
return function createTranscoder(_x7, _x8) {
return _ref4.apply(this, arguments);
};
}();
/**
* ## Configures an existing Transcoder.
*
* Make changes to the configuration of an existing Transcoder.
* Changes should take effect without requiring a server restart except for DNS prefix and cluster,
* which can only be updated when the transcoder is in a shutdown state.
*
* Changing the profile will require either a profile id or the height, frameRate, and passThrough.
* If you specify both, only the profile will be used.
* See the {@link listTranscoders | List Transcoder Profiles} to find available Transcoder profiles.
*
* @see {@link https://optiview.dolby.com/docs/millicast/api/transcoder-update-transcoder/}
*
* @remarks Cloud transcoder is not currently available for general usage.
* If you would like to opt in, please contact our Sales team.
*
* @param apiSecret The API Secret used to authenticate this request.
* @param transcoderId Identifier of the cloud transcoder to update.
* @param transcoder Settings of the cloud transcoder to update.
*
* @returns A {@link !Promise Promise} whose fulfillment handler receives a {@link Transcoder} object.
*/
var updateTranscoder = exports.updateTranscoder = /*#__PURE__*/function () {
var _ref5 = _asyncToGenerator(/*#__PURE__*/_regenerator().m(function _callee5(apiSecret, transcoderId, transcoder) {
var options;
return _regenerator().w(function (_context5) {
while (1) switch (_context5.n) {
case 0:
options = {
hostname: Urls.getRtsHostname(),
path: "/api/transcoders/".concat(transcoderId),
headers: {
Accept: 'application/json',
'Content-Type': 'application/json',
Authorization: "Bearer ".concat(apiSecret)
},
body: JSON.stringify(transcoder)
};
_context5.n = 1;
return (0, _httpHelpers.sendPut)(options);
case 1:
return _context5.a(2, _context5.v);
}
}, _callee5);
}));
return function updateTranscoder(_x9, _x0, _x1) {
return _ref5.apply(this, arguments);
};
}();
/**
* ## Starts the cloud transcoder.
*
* Enable a Transcoder by ID to accept incoming broadcast sources.
*
* @see {@link https://optiview.dolby.com/docs/millicast/api/transcoder-start-transcoder/}
*
* @remarks Cloud transcoder is not currently available for general usage.
* If you would like to opt in, please contact our Sales team.
*
* @param apiSecret The API Secret used to authenticate this request.
* @param transcoderId Identifier of the cloud transcoder to start.
*
* @returns A {@link !Promise Promise} whose fulfillment handler receives a flag to indicate if the operation succeeded or not.
*/
var startTranscoder = exports.startTranscoder = /*#__PURE__*/function () {
var _ref6 = _asyncToGenerator(/*#__PURE__*/_regenerator().m(function _callee6(apiSecret, transcoderId) {
var options;
return _regenerator().w(function (_context6) {
while (1) switch (_context6.n) {
case 0:
options = {
hostname: Urls.getRtsHostname(),
path: "/api/transcoders/start/".concat(transcoderId),
headers: {
Accept: 'application/json',
Authorization: "Bearer ".concat(apiSecret)
}
};
_context6.n = 1;
return (0, _httpHelpers.sendPut)(options);
case 1:
return _context6.a(2, _context6.v);
}
}, _callee6);
}));
return function startTranscoder(_x10, _x11) {
return _ref6.apply(this, arguments);
};
}();
/**
* ## Stops the cloud transcoder.
*
* Disable a Transcoder by ID so that it will shutdown and no longer accept incoming broadcast sources.
*
* @see {@link https://optiview.dolby.com/docs/millicast/api/transcoder-stop-transcoder/}
*
* @remarks Cloud transcoder is not currently available for general usage.
* If you would like to opt in, please contact our Sales team.
*
* @param apiSecret The API Secret used to authenticate this request.
* @param transcoderId Identifier of the cloud transcoder to stop.
*
* @returns A {@link !Promise Promise} whose fulfillment handler receives a flag to indicate if the operation succeeded or not.
*/
var stopTranscoder = exports.stopTranscoder = /*#__PURE__*/function () {
var _ref7 = _asyncToGenerator(/*#__PURE__*/_regenerator().m(function _callee7(apiSecret, transcoderId) {
var options;
return _regenerator().w(function (_context7) {
while (1) switch (_context7.n) {
case 0:
options = {
hostname: Urls.getRtsHostname(),
path: "/api/transcoders/stop/".concat(transcoderId),
headers: {
Accept: 'application/json',
Authorization: "Bearer ".concat(apiSecret)
}
};
_context7.n = 1;
return (0, _httpHelpers.sendPut)(options);
case 1:
return _context7.a(2, _context7.v);
}
}, _callee7);
}));
return function stopTranscoder(_x12, _x13) {
return _ref7.apply(this, arguments);
};
}();
/**
* Lists all transcoder instances.
*
* Information on each instance is available for up to 90 days from its end date.
*
* @see {@link https://optiview.dolby.com/docs/millicast/api/transcoder-list-transcoder-instances/}
*
* @remarks Cloud transcoder is not currently available for general usage.
* If you would like to opt in, please contact our Sales team
*
* @param apiSecret The API Secret used to authenticate this request.
* @param options Options to sort the response.
*
* @returns A {@link !Promise Promise} whose fulfillment handler receives an array of {@link TranscoderInstance} objects.
*/
var listTranscoderInstances = exports.listTranscoderInstances = /*#__PURE__*/function () {
var _ref8 = _asyncToGenerator(/*#__PURE__*/_regenerator().m(function _callee8(apiSecret, options) {
var _options$isDescending2;
var params, queryOptions;
return _regenerator().w(function (_context8) {
while (1) switch (_context8.n) {
case 0:
params = {
sortBy: options.sortBy,
page: options.page.toString(),
itemsOnPage: options.itemsOnPage.toString(),
isDescending: ((_options$isDescending2 = options.isDescending) !== null && _options$isDescending2 !== void 0 ? _options$isDescending2 : false).toString()
};
if (options.status) {
params['status'] = options.status;
}
if (options.transcoderId) {
params['transcoderId'] = options.transcoderId;
}
if (options.startDate) {
params['startDate'] = options.startDate;
}
if (options.endDate) {
params['endDate'] = options.endDate;
}
queryOptions = {
hostname: Urls.getRtsHostname(),
path: '/api/transcoders/instances',
params: params,
headers: {
Accept: 'application/json',
Authorization: "Bearer ".concat(apiSecret)
}
};
_context8.n = 1;
return (0, _httpHelpers.sendGet)(queryOptions);
case 1:
return _context8.a(2, _context8.v);
}
}, _callee8);
}));
return function listTranscoderInstances(_x14, _x15) {
return _ref8.apply(this, arguments);
};
}();
/**
* Gets the specified cloud transcoder instance.
*
* @see {@link https://optiview.dolby.com/docs/millicast/api/transcoder-get-transcoder-instance/}
*
* @remarks Cloud transcoder is not currently available for general usage.
* If you would like to opt in, please contact our Sales team.
*
* @param apiSecret The API Secret used to authenticate this request.
* @param transcoderInstanceId Identifier of the cloud transcoder instance to retrieve.
*
* @returns A {@link !Promise Promise} whose fulfillment handler receives a {@link TranscoderInstance} object.
*/
var getTranscoderInstance = exports.getTranscoderInstance = /*#__PURE__*/function () {
var _ref9 = _asyncToGenerator(/*#__PURE__*/_regenerator().m(function _callee9(apiSecret, transcoderInstanceId) {
var options;
return _regenerator().w(function (_context9) {
while (1) switch (_context9.n) {
case 0:
options = {
hostname: Urls.getRtsHostname(),
path: "/api/transcoders/instances/".concat(transcoderInstanceId),
headers: {
Accept: 'application/json',
Authorization: "Bearer ".concat(apiSecret)
}
};
_context9.n = 1;
return (0, _httpHelpers.sendGet)(options);
case 1:
return _context9.a(2, _context9.v);
}
}, _callee9);
}));
return function getTranscoderInstance(_x16, _x17) {
return _ref9.apply(this, arguments);
};
}();
/**
* Lists all transcoder profiles.
*
* @see {@link https://optiview.dolby.com/docs/millicast/api/transcoder-list-transcoder-profiles/}
*
* @remarks Cloud transcoder is not currently available for general usage.
* If you would like to opt in, please contact our Sales team.
*
* @param apiSecret The API Secret used to authenticate this request.
* @param options Options to sort the response.
*
* @returns A {@link !Promise Promise} whose fulfillment handler receives an array of {@link TranscoderProfile} objects.
*/
var listTranscoderProfiles = exports.listTranscoderProfiles = /*#__PURE__*/function () {
var _ref0 = _asyncToGenerator(/*#__PURE__*/_regenerator().m(function _callee0(apiSecret, options) {
var _options$isDescending3;
var params, queryOptions;
return _regenerator().w(function (_context0) {
while (1) switch (_context0.n) {
case 0:
params = {
sortBy: options.sortBy,
page: options.page.toString(),
itemsOnPage: options.itemsOnPage.toString(),
isDescending: ((_options$isDescending3 = options.isDescending) !== null && _options$isDescending3 !== void 0 ? _options$isDescending3 : false).toString()
};
queryOptions = {
hostname: Urls.getRtsHostname(),
path: '/api/transcoders/profiles',
params: params,
headers: {
Accept: 'application/json',
Authorization: "Bearer ".concat(apiSecret)
}
};
_context0.n = 1;
return (0, _httpHelpers.sendGet)(queryOptions);
case 1:
return _context0.a(2, _context0.v);
}
}, _callee0);
}));
return function listTranscoderProfiles(_x18, _x19) {
return _ref0.apply(this, arguments);
};
}();
/** APIs related to the transcoder schedulers. */