@difizen/libro-kernel 0.0.2-alpha.0

package/es/kernel/restapi.js

@@ -0,0 +1,367 @@
+function _typeof(obj) { "@babel/helpers - typeof"; return _typeof = "function" == typeof Symbol && "symbol" == typeof Symbol.iterator ? function (obj) { return typeof obj; } : function (obj) { return obj && "function" == typeof Symbol && obj.constructor === Symbol && obj !== Symbol.prototype ? "symbol" : typeof obj; }, _typeof(obj); }
+var _dec, _dec2, _class, _class2, _descriptor;
+function _regeneratorRuntime() { "use strict"; /*! regenerator-runtime -- Copyright (c) 2014-present, Facebook, Inc. -- license (MIT): https://github.com/facebook/regenerator/blob/main/LICENSE */ _regeneratorRuntime = function _regeneratorRuntime() { return exports; }; var exports = {}, Op = Object.prototype, hasOwn = Op.hasOwnProperty, defineProperty = Object.defineProperty || function (obj, key, desc) { obj[key] = desc.value; }, $Symbol = "function" == typeof Symbol ? Symbol : {}, iteratorSymbol = $Symbol.iterator || "@@iterator", asyncIteratorSymbol = $Symbol.asyncIterator || "@@asyncIterator", toStringTagSymbol = $Symbol.toStringTag || "@@toStringTag"; function define(obj, key, value) { return Object.defineProperty(obj, key, { value: value, enumerable: !0, configurable: !0, writable: !0 }), obj[key]; } try { define({}, ""); } catch (err) { define = function define(obj, key, value) { return obj[key] = value; }; } function wrap(innerFn, outerFn, self, tryLocsList) { var protoGenerator = outerFn && outerFn.prototype instanceof Generator ? outerFn : Generator, generator = Object.create(protoGenerator.prototype), context = new Context(tryLocsList || []); return defineProperty(generator, "_invoke", { value: makeInvokeMethod(innerFn, self, context) }), generator; } function tryCatch(fn, obj, arg) { try { return { type: "normal", arg: fn.call(obj, arg) }; } catch (err) { return { type: "throw", arg: err }; } } exports.wrap = wrap; var ContinueSentinel = {}; function Generator() {} function GeneratorFunction() {} function GeneratorFunctionPrototype() {} var IteratorPrototype = {}; define(IteratorPrototype, iteratorSymbol, function () { return this; }); var getProto = Object.getPrototypeOf, NativeIteratorPrototype = getProto && getProto(getProto(values([]))); NativeIteratorPrototype && NativeIteratorPrototype !== Op && hasOwn.call(NativeIteratorPrototype, iteratorSymbol) && (IteratorPrototype = NativeIteratorPrototype); var Gp = GeneratorFunctionPrototype.prototype = Generator.prototype = Object.create(IteratorPrototype); function defineIteratorMethods(prototype) { ["next", "throw", "return"].forEach(function (method) { define(prototype, method, function (arg) { return this._invoke(method, arg); }); }); } function AsyncIterator(generator, PromiseImpl) { function invoke(method, arg, resolve, reject) { var record = tryCatch(generator[method], generator, arg); if ("throw" !== record.type) { var result = record.arg, value = result.value; return value && "object" == _typeof(value) && hasOwn.call(value, "__await") ? PromiseImpl.resolve(value.__await).then(function (value) { invoke("next", value, resolve, reject); }, function (err) { invoke("throw", err, resolve, reject); }) : PromiseImpl.resolve(value).then(function (unwrapped) { result.value = unwrapped, resolve(result); }, function (error) { return invoke("throw", error, resolve, reject); }); } reject(record.arg); } var previousPromise; defineProperty(this, "_invoke", { value: function value(method, arg) { function callInvokeWithMethodAndArg() { return new PromiseImpl(function (resolve, reject) { invoke(method, arg, resolve, reject); }); } return previousPromise = previousPromise ? previousPromise.then(callInvokeWithMethodAndArg, callInvokeWithMethodAndArg) : callInvokeWithMethodAndArg(); } }); } function makeInvokeMethod(innerFn, self, context) { var state = "suspendedStart"; return function (method, arg) { if ("executing" === state) throw new Error("Generator is already running"); if ("completed" === state) { if ("throw" === method) throw arg; return doneResult(); } for (context.method = method, context.arg = arg;;) { var delegate = context.delegate; if (delegate) { var delegateResult = maybeInvokeDelegate(delegate, context); if (delegateResult) { if (delegateResult === ContinueSentinel) continue; return delegateResult; } } if ("next" === context.method) context.sent = context._sent = context.arg;else if ("throw" === context.method) { if ("suspendedStart" === state) throw state = "completed", context.arg; context.dispatchException(context.arg); } else "return" === context.method && context.abrupt("return", context.arg); state = "executing"; var record = tryCatch(innerFn, self, context); if ("normal" === record.type) { if (state = context.done ? "completed" : "suspendedYield", record.arg === ContinueSentinel) continue; return { value: record.arg, done: context.done }; } "throw" === record.type && (state = "completed", context.method = "throw", context.arg = record.arg); } }; } function maybeInvokeDelegate(delegate, context) { var methodName = context.method, method = delegate.iterator[methodName]; if (undefined === method) return context.delegate = null, "throw" === methodName && delegate.iterator.return && (context.method = "return", context.arg = undefined, maybeInvokeDelegate(delegate, context), "throw" === context.method) || "return" !== methodName && (context.method = "throw", context.arg = new TypeError("The iterator does not provide a '" + methodName + "' method")), ContinueSentinel; var record = tryCatch(method, delegate.iterator, context.arg); if ("throw" === record.type) return context.method = "throw", context.arg = record.arg, context.delegate = null, ContinueSentinel; var info = record.arg; return info ? info.done ? (context[delegate.resultName] = info.value, context.next = delegate.nextLoc, "return" !== context.method && (context.method = "next", context.arg = undefined), context.delegate = null, ContinueSentinel) : info : (context.method = "throw", context.arg = new TypeError("iterator result is not an object"), context.delegate = null, ContinueSentinel); } function pushTryEntry(locs) { var entry = { tryLoc: locs[0] }; 1 in locs && (entry.catchLoc = locs[1]), 2 in locs && (entry.finallyLoc = locs[2], entry.afterLoc = locs[3]), this.tryEntries.push(entry); } function resetTryEntry(entry) { var record = entry.completion || {}; record.type = "normal", delete record.arg, entry.completion = record; } function Context(tryLocsList) { this.tryEntries = [{ tryLoc: "root" }], tryLocsList.forEach(pushTryEntry, this), this.reset(!0); } function values(iterable) { if (iterable) { var iteratorMethod = iterable[iteratorSymbol]; if (iteratorMethod) return iteratorMethod.call(iterable); if ("function" == typeof iterable.next) return iterable; if (!isNaN(iterable.length)) { var i = -1, next = function next() { for (; ++i < iterable.length;) if (hasOwn.call(iterable, i)) return next.value = iterable[i], next.done = !1, next; return next.value = undefined, next.done = !0, next; }; return next.next = next; } } return { next: doneResult }; } function doneResult() { return { value: undefined, done: !0 }; } return GeneratorFunction.prototype = GeneratorFunctionPrototype, defineProperty(Gp, "constructor", { value: GeneratorFunctionPrototype, configurable: !0 }), defineProperty(GeneratorFunctionPrototype, "constructor", { value: GeneratorFunction, configurable: !0 }), GeneratorFunction.displayName = define(GeneratorFunctionPrototype, toStringTagSymbol, "GeneratorFunction"), exports.isGeneratorFunction = function (genFun) { var ctor = "function" == typeof genFun && genFun.constructor; return !!ctor && (ctor === GeneratorFunction || "GeneratorFunction" === (ctor.displayName || ctor.name)); }, exports.mark = function (genFun) { return Object.setPrototypeOf ? Object.setPrototypeOf(genFun, GeneratorFunctionPrototype) : (genFun.__proto__ = GeneratorFunctionPrototype, define(genFun, toStringTagSymbol, "GeneratorFunction")), genFun.prototype = Object.create(Gp), genFun; }, exports.awrap = function (arg) { return { __await: arg }; }, defineIteratorMethods(AsyncIterator.prototype), define(AsyncIterator.prototype, asyncIteratorSymbol, function () { return this; }), exports.AsyncIterator = AsyncIterator, exports.async = function (innerFn, outerFn, self, tryLocsList, PromiseImpl) { void 0 === PromiseImpl && (PromiseImpl = Promise); var iter = new AsyncIterator(wrap(innerFn, outerFn, self, tryLocsList), PromiseImpl); return exports.isGeneratorFunction(outerFn) ? iter : iter.next().then(function (result) { return result.done ? result.value : iter.next(); }); }, defineIteratorMethods(Gp), define(Gp, toStringTagSymbol, "Generator"), define(Gp, iteratorSymbol, function () { return this; }), define(Gp, "toString", function () { return "[object Generator]"; }), exports.keys = function (val) { var object = Object(val), keys = []; for (var key in object) keys.push(key); return keys.reverse(), function next() { for (; keys.length;) { var key = keys.pop(); if (key in object) return next.value = key, next.done = !1, next; } return next.done = !0, next; }; }, exports.values = values, Context.prototype = { constructor: Context, reset: function reset(skipTempReset) { if (this.prev = 0, this.next = 0, this.sent = this._sent = undefined, this.done = !1, this.delegate = null, this.method = "next", this.arg = undefined, this.tryEntries.forEach(resetTryEntry), !skipTempReset) for (var name in this) "t" === name.charAt(0) && hasOwn.call(this, name) && !isNaN(+name.slice(1)) && (this[name] = undefined); }, stop: function stop() { this.done = !0; var rootRecord = this.tryEntries[0].completion; if ("throw" === rootRecord.type) throw rootRecord.arg; return this.rval; }, dispatchException: function dispatchException(exception) { if (this.done) throw exception; var context = this; function handle(loc, caught) { return record.type = "throw", record.arg = exception, context.next = loc, caught && (context.method = "next", context.arg = undefined), !!caught; } for (var i = this.tryEntries.length - 1; i >= 0; --i) { var entry = this.tryEntries[i], record = entry.completion; if ("root" === entry.tryLoc) return handle("end"); if (entry.tryLoc <= this.prev) { var hasCatch = hasOwn.call(entry, "catchLoc"), hasFinally = hasOwn.call(entry, "finallyLoc"); if (hasCatch && hasFinally) { if (this.prev < entry.catchLoc) return handle(entry.catchLoc, !0); if (this.prev < entry.finallyLoc) return handle(entry.finallyLoc); } else if (hasCatch) { if (this.prev < entry.catchLoc) return handle(entry.catchLoc, !0); } else { if (!hasFinally) throw new Error("try statement without catch or finally"); if (this.prev < entry.finallyLoc) return handle(entry.finallyLoc); } } } }, abrupt: function abrupt(type, arg) { for (var i = this.tryEntries.length - 1; i >= 0; --i) { var entry = this.tryEntries[i]; if (entry.tryLoc <= this.prev && hasOwn.call(entry, "finallyLoc") && this.prev < entry.finallyLoc) { var finallyEntry = entry; break; } } finallyEntry && ("break" === type || "continue" === type) && finallyEntry.tryLoc <= arg && arg <= finallyEntry.finallyLoc && (finallyEntry = null); var record = finallyEntry ? finallyEntry.completion : {}; return record.type = type, record.arg = arg, finallyEntry ? (this.method = "next", this.next = finallyEntry.finallyLoc, ContinueSentinel) : this.complete(record); }, complete: function complete(record, afterLoc) { if ("throw" === record.type) throw record.arg; return "break" === record.type || "continue" === record.type ? this.next = record.arg : "return" === record.type ? (this.rval = this.arg = record.arg, this.method = "return", this.next = "end") : "normal" === record.type && afterLoc && (this.next = afterLoc), ContinueSentinel; }, finish: function finish(finallyLoc) { for (var i = this.tryEntries.length - 1; i >= 0; --i) { var entry = this.tryEntries[i]; if (entry.finallyLoc === finallyLoc) return this.complete(entry.completion, entry.afterLoc), resetTryEntry(entry), ContinueSentinel; } }, catch: function _catch(tryLoc) { for (var i = this.tryEntries.length - 1; i >= 0; --i) { var entry = this.tryEntries[i]; if (entry.tryLoc === tryLoc) { var record = entry.completion; if ("throw" === record.type) { var thrown = record.arg; resetTryEntry(entry); } return thrown; } } throw new Error("illegal catch attempt"); }, delegateYield: function delegateYield(iterable, resultName, nextLoc) { return this.delegate = { iterator: values(iterable), resultName: resultName, nextLoc: nextLoc }, "next" === this.method && (this.arg = undefined), ContinueSentinel; } }, exports; }
+function ownKeys(object, enumerableOnly) { var keys = Object.keys(object); if (Object.getOwnPropertySymbols) { var symbols = Object.getOwnPropertySymbols(object); enumerableOnly && (symbols = symbols.filter(function (sym) { return Object.getOwnPropertyDescriptor(object, sym).enumerable; })), keys.push.apply(keys, symbols); } return keys; }
+function _objectSpread(target) { for (var i = 1; i < arguments.length; i++) { var source = null != arguments[i] ? arguments[i] : {}; i % 2 ? ownKeys(Object(source), !0).forEach(function (key) { _defineProperty(target, key, source[key]); }) : Object.getOwnPropertyDescriptors ? Object.defineProperties(target, Object.getOwnPropertyDescriptors(source)) : ownKeys(Object(source)).forEach(function (key) { Object.defineProperty(target, key, Object.getOwnPropertyDescriptor(source, key)); }); } return target; }
+function _defineProperty(obj, key, value) { key = _toPropertyKey(key); if (key in obj) { Object.defineProperty(obj, key, { value: value, enumerable: true, configurable: true, writable: true }); } else { obj[key] = value; } return obj; }
+function asyncGeneratorStep(gen, resolve, reject, _next, _throw, key, arg) { try { var info = gen[key](arg); var value = info.value; } catch (error) { reject(error); return; } if (info.done) { resolve(value); } else { Promise.resolve(value).then(_next, _throw); } }
+function _asyncToGenerator(fn) { return function () { var self = this, args = arguments; return new Promise(function (resolve, reject) { var gen = fn.apply(self, args); function _next(value) { asyncGeneratorStep(gen, resolve, reject, _next, _throw, "next", value); } function _throw(err) { asyncGeneratorStep(gen, resolve, reject, _next, _throw, "throw", err); } _next(undefined); }); }; }
+function _initializerDefineProperty(target, property, descriptor, context) { if (!descriptor) return; Object.defineProperty(target, property, { enumerable: descriptor.enumerable, configurable: descriptor.configurable, writable: descriptor.writable, value: descriptor.initializer ? descriptor.initializer.call(context) : void 0 }); }
+function _classCallCheck(instance, Constructor) { if (!(instance instanceof Constructor)) { throw new TypeError("Cannot call a class as a function"); } }
+function _defineProperties(target, props) { for (var i = 0; i < props.length; i++) { var descriptor = props[i]; descriptor.enumerable = descriptor.enumerable || false; descriptor.configurable = true; if ("value" in descriptor) descriptor.writable = true; Object.defineProperty(target, _toPropertyKey(descriptor.key), descriptor); } }
+function _createClass(Constructor, protoProps, staticProps) { if (protoProps) _defineProperties(Constructor.prototype, protoProps); if (staticProps) _defineProperties(Constructor, staticProps); Object.defineProperty(Constructor, "prototype", { writable: false }); return Constructor; }
+function _toPropertyKey(arg) { var key = _toPrimitive(arg, "string"); return _typeof(key) === "symbol" ? key : String(key); }
+function _toPrimitive(input, hint) { if (_typeof(input) !== "object" || input === null) return input; var prim = input[Symbol.toPrimitive]; if (prim !== undefined) { var res = prim.call(input, hint || "default"); if (_typeof(res) !== "object") return res; throw new TypeError("@@toPrimitive must return a primitive value."); } return (hint === "string" ? String : Number)(input); }
+function _applyDecoratedDescriptor(target, property, decorators, descriptor, context) { var desc = {}; Object.keys(descriptor).forEach(function (key) { desc[key] = descriptor[key]; }); desc.enumerable = !!desc.enumerable; desc.configurable = !!desc.configurable; if ('value' in desc || desc.initializer) { desc.writable = true; } desc = decorators.slice().reverse().reduce(function (desc, decorator) { return decorator(target, property, desc) || desc; }, desc); if (context && desc.initializer !== void 0) { desc.value = desc.initializer ? desc.initializer.call(context) : void 0; desc.initializer = undefined; } if (desc.initializer === void 0) { Object.defineProperty(target, property, desc); desc = null; } return desc; }
+function _initializerWarningHelper(descriptor, context) { throw new Error('Decorating class property failed. Please ensure that ' + 'transform-class-properties is enabled and runs after the decorators transform.'); }
+import { URL } from '@difizen/libro-common';
+import { inject, singleton } from '@difizen/mana-app';
+import { createResponseError, ServerConnection } from "../server/index.js";
+import { validateModel, validateModels } from "./validate.js";
+export var KERNEL_SERVICE_URL = 'api/kernels';
+export var KernelRestAPI = (_dec = singleton(), _dec2 = inject(ServerConnection), _dec(_class = (_class2 = /*#__PURE__*/function () {
+  function KernelRestAPI() {
+    _classCallCheck(this, KernelRestAPI);
+    _initializerDefineProperty(this, "serverConnection", _descriptor, this);
+  }
+  _createClass(KernelRestAPI, [{
+    key: "getKernelModel",
+    value:
+    /**
+     * Get a full kernel model from the server by kernel id string.
+     *
+     * #### Notes
+     * Uses the [Jupyter Notebook API](http://petstore.swagger.io/?url=https://raw.githubusercontent.com/jupyter/notebook/master/notebook/services/api/api.yaml#!/kernels) and validates the response model.
+     *
+     * The promise is fulfilled on a valid response and rejected otherwise.
+     */
+    function () {
+      var _getKernelModel = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee(id, serverSettings) {
+        var settings, url, response, err, data;
+        return _regeneratorRuntime().wrap(function _callee$(_context) {
+          while (1) switch (_context.prev = _context.next) {
+            case 0:
+              settings = _objectSpread(_objectSpread({}, this.serverConnection.settings), serverSettings);
+              url = URL.join(settings.baseUrl, KERNEL_SERVICE_URL, encodeURIComponent(id));
+              _context.next = 4;
+              return this.serverConnection.makeRequest(url, {}, settings);
+            case 4:
+              response = _context.sent;
+              if (!(response.status === 404)) {
+                _context.next = 9;
+                break;
+              }
+              return _context.abrupt("return", undefined);
+            case 9:
+              if (!(response.status !== 200)) {
+                _context.next = 14;
+                break;
+              }
+              _context.next = 12;
+              return createResponseError(response);
+            case 12:
+              err = _context.sent;
+              throw err;
+            case 14:
+              _context.next = 16;
+              return response.json();
+            case 16:
+              data = _context.sent;
+              validateModel(data);
+              return _context.abrupt("return", data);
+            case 19:
+            case "end":
+              return _context.stop();
+          }
+        }, _callee, this);
+      }));
+      function getKernelModel(_x, _x2) {
+        return _getKernelModel.apply(this, arguments);
+      }
+      return getKernelModel;
+    }()
+    /**
+     * Start a new kernel.
+     *
+     * @param options - The options used to create the kernel.
+     *
+     * @returns A promise that resolves with a kernel connection object.
+     *
+     * #### Notes
+     * Uses the [Jupyter Notebook API](http://petstore.swagger.io/?url=https://raw.githubusercontent.com/jupyter/notebook/master/notebook/services/api/api.yaml#!/kernels) and validates the response model.
+     *
+     * The promise is fulfilled on a valid response and rejected otherwise.
+     */
+  }, {
+    key: "startNew",
+    value: function () {
+      var _startNew = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee2() {
+        var options,
+          serverSettings,
+          settings,
+          url,
+          init,
+          response,
+          err,
+          data,
+          _args2 = arguments;
+        return _regeneratorRuntime().wrap(function _callee2$(_context2) {
+          while (1) switch (_context2.prev = _context2.next) {
+            case 0:
+              options = _args2.length > 0 && _args2[0] !== undefined ? _args2[0] : {};
+              serverSettings = _args2.length > 1 ? _args2[1] : undefined;
+              settings = _objectSpread(_objectSpread({}, this.serverConnection.settings), serverSettings);
+              url = URL.join(settings.baseUrl, KERNEL_SERVICE_URL);
+              init = {
+                method: 'POST',
+                body: JSON.stringify(options)
+              };
+              _context2.next = 7;
+              return this.serverConnection.makeRequest(url, init, settings);
+            case 7:
+              response = _context2.sent;
+              if (!(response.status !== 201)) {
+                _context2.next = 13;
+                break;
+              }
+              _context2.next = 11;
+              return createResponseError(response);
+            case 11:
+              err = _context2.sent;
+              throw err;
+            case 13:
+              _context2.next = 15;
+              return response.json();
+            case 15:
+              data = _context2.sent;
+              validateModel(data);
+              return _context2.abrupt("return", data);
+            case 18:
+            case "end":
+              return _context2.stop();
+          }
+        }, _callee2, this);
+      }));
+      function startNew() {
+        return _startNew.apply(this, arguments);
+      }
+      return startNew;
+    }()
+    /**
+     * Fetch the running kernels.
+     *
+     * @param settings - The optional server settings.
+     *
+     * @returns A promise that resolves with the list of running kernels.
+     *
+     * #### Notes
+     * Uses the [Jupyter Notebook API](http://petstore.swagger.io/?url=https://raw.githubusercontent.com/jupyter/notebook/master/notebook/services/api/api.yaml#!/kernels) and validates the response model.
+     *
+     * The promise is fulfilled on a valid response and rejected otherwise.
+     */
+  }, {
+    key: "listRunning",
+    value: function () {
+      var _listRunning = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee3(serverSettings) {
+        var settings, url, response, err, data;
+        return _regeneratorRuntime().wrap(function _callee3$(_context3) {
+          while (1) switch (_context3.prev = _context3.next) {
+            case 0:
+              settings = _objectSpread(_objectSpread({}, this.serverConnection.settings), serverSettings);
+              url = URL.join(settings.baseUrl, KERNEL_SERVICE_URL);
+              _context3.next = 4;
+              return this.serverConnection.makeRequest(url, {}, settings);
+            case 4:
+              response = _context3.sent;
+              if (!(response.status !== 200)) {
+                _context3.next = 10;
+                break;
+              }
+              _context3.next = 8;
+              return createResponseError(response);
+            case 8:
+              err = _context3.sent;
+              throw err;
+            case 10:
+              _context3.next = 12;
+              return response.json();
+            case 12:
+              data = _context3.sent;
+              validateModels(data);
+              return _context3.abrupt("return", data);
+            case 15:
+            case "end":
+              return _context3.stop();
+          }
+        }, _callee3, this);
+      }));
+      function listRunning(_x3) {
+        return _listRunning.apply(this, arguments);
+      }
+      return listRunning;
+    }()
+    /**
+     * Shut down a kernel.
+     *
+     * @param id - The id of the running kernel.
+     *
+     * @param settings - The server settings for the request.
+     *
+     * @returns A promise that resolves when the kernel is shut down.
+     *
+     *
+     * #### Notes
+     * Uses the [Jupyter Notebook API](http://petstore.swagger.io/?url=https://raw.githubusercontent.com/jupyter/notebook/master/notebook/services/api/api.yaml#!/kernels) and validates the response model.
+     *
+     * The promise is fulfilled on a valid response and rejected otherwise.
+     */
+  }, {
+    key: "shutdownKernel",
+    value: function () {
+      var _shutdownKernel = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee4(id, serverSettings) {
+        var settings, url, init, response, msg, err;
+        return _regeneratorRuntime().wrap(function _callee4$(_context4) {
+          while (1) switch (_context4.prev = _context4.next) {
+            case 0:
+              settings = _objectSpread(_objectSpread({}, this.serverConnection.settings), serverSettings);
+              url = URL.join(settings.baseUrl, KERNEL_SERVICE_URL, encodeURIComponent(id));
+              init = {
+                method: 'DELETE'
+              };
+              _context4.next = 5;
+              return this.serverConnection.makeRequest(url, init, settings);
+            case 5:
+              response = _context4.sent;
+              if (!(response.status === 404)) {
+                _context4.next = 11;
+                break;
+              }
+              msg = "The kernel \"".concat(id, "\" does not exist on the server");
+              console.warn(msg);
+              _context4.next = 16;
+              break;
+            case 11:
+              if (!(response.status !== 204)) {
+                _context4.next = 16;
+                break;
+              }
+              _context4.next = 14;
+              return createResponseError(response);
+            case 14:
+              err = _context4.sent;
+              throw err;
+            case 16:
+            case "end":
+              return _context4.stop();
+          }
+        }, _callee4, this);
+      }));
+      function shutdownKernel(_x4, _x5) {
+        return _shutdownKernel.apply(this, arguments);
+      }
+      return shutdownKernel;
+    }()
+    /**
+     * Restart a kernel.
+     *
+     * #### Notes
+     * Uses the [Jupyter Notebook API](http://petstore.swagger.io/?url=https://raw.githubusercontent.com/jupyter/notebook/master/notebook/services/api/api.yaml#!/kernels) and validates the response model.
+     *
+     * The promise is fulfilled on a valid response (and thus after a restart) and rejected otherwise.
+     */
+  }, {
+    key: "restartKernel",
+    value: function () {
+      var _restartKernel = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee5(id, serverSettings) {
+        var settings, url, init, response, err, data;
+        return _regeneratorRuntime().wrap(function _callee5$(_context5) {
+          while (1) switch (_context5.prev = _context5.next) {
+            case 0:
+              settings = _objectSpread(_objectSpread({}, this.serverConnection.settings), serverSettings);
+              url = URL.join(settings.baseUrl, KERNEL_SERVICE_URL, encodeURIComponent(id), 'restart');
+              init = {
+                method: 'POST'
+              };
+              _context5.next = 5;
+              return this.serverConnection.makeRequest(url, init, settings);
+            case 5:
+              response = _context5.sent;
+              if (!(response.status !== 200)) {
+                _context5.next = 11;
+                break;
+              }
+              _context5.next = 9;
+              return createResponseError(response);
+            case 9:
+              err = _context5.sent;
+              throw err;
+            case 11:
+              _context5.next = 13;
+              return response.json();
+            case 13:
+              data = _context5.sent;
+              validateModel(data);
+            case 15:
+            case "end":
+              return _context5.stop();
+          }
+        }, _callee5, this);
+      }));
+      function restartKernel(_x6, _x7) {
+        return _restartKernel.apply(this, arguments);
+      }
+      return restartKernel;
+    }()
+    /**
+     * Interrupt a kernel.
+     *
+     * #### Notes
+     * Uses the [Jupyter Notebook API](http://petstore.swagger.io/?url=https://raw.githubusercontent.com/jupyter/notebook/master/notebook/services/api/api.yaml#!/kernels) and validates the response model.
+     *
+     * The promise is fulfilled on a valid response and rejected otherwise.
+     */
+  }, {
+    key: "interruptKernel",
+    value: function () {
+      var _interruptKernel = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee6(id, serverSettings) {
+        var settings, url, init, response, err;
+        return _regeneratorRuntime().wrap(function _callee6$(_context6) {
+          while (1) switch (_context6.prev = _context6.next) {
+            case 0:
+              settings = _objectSpread(_objectSpread({}, this.serverConnection.settings), serverSettings);
+              url = URL.join(settings.baseUrl, KERNEL_SERVICE_URL, encodeURIComponent(id), 'interrupt');
+              init = {
+                method: 'POST'
+              };
+              _context6.next = 5;
+              return this.serverConnection.makeRequest(url, init, settings);
+            case 5:
+              response = _context6.sent;
+              if (!(response.status !== 204)) {
+                _context6.next = 11;
+                break;
+              }
+              _context6.next = 9;
+              return createResponseError(response);
+            case 9:
+              err = _context6.sent;
+              throw err;
+            case 11:
+            case "end":
+              return _context6.stop();
+          }
+        }, _callee6, this);
+      }));
+      function interruptKernel(_x8, _x9) {
+        return _interruptKernel.apply(this, arguments);
+      }
+      return interruptKernel;
+    }()
+  }]);
+  return KernelRestAPI;
+}(), (_descriptor = _applyDecoratedDescriptor(_class2.prototype, "serverConnection", [_dec2], {
+  configurable: true,
+  enumerable: true,
+  writable: true,
+  initializer: null
+})), _class2)) || _class);

package/es/kernel/serialize.d.ts

@@ -0,0 +1,10 @@
+import * as KernelMessage from './messages.js';
+/**
+ * Serialize a kernel message for transport.
+ */
+export declare function serialize(msg: KernelMessage.IMessage, protocol?: string): string | ArrayBuffer;
+/**
+ * Deserialize and return the unpacked message.
+ */
+export declare function deserialize(data: ArrayBuffer, protocol?: string): KernelMessage.IMessage;
+//# sourceMappingURL=serialize.d.ts.map

package/es/kernel/serialize.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"serialize.d.ts","sourceRoot":"","sources":["../../src/kernel/serialize.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,aAAa,MAAM,eAAe,CAAC;AAsK/C;;GAEG;AACH,wBAAgB,SAAS,CACvB,GAAG,EAAE,aAAa,CAAC,QAAQ,EAC3B,QAAQ,SAAK,GACZ,MAAM,GAAG,WAAW,CAOtB;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,WAAW,EAAE,QAAQ,SAAK,GAAG,aAAa,CAAC,QAAQ,CAOpF"}

package/es/kernel/serialize.js

@@ -0,0 +1,214 @@
+function _createForOfIteratorHelper(o, allowArrayLike) { var it = typeof Symbol !== "undefined" && o[Symbol.iterator] || o["@@iterator"]; if (!it) { if (Array.isArray(o) || (it = _unsupportedIterableToArray(o)) || allowArrayLike && o && typeof o.length === "number") { if (it) o = it; var i = 0; var F = function F() {}; return { s: F, n: function n() { if (i >= o.length) return { done: true }; return { done: false, value: o[i++] }; }, e: function e(_e) { throw _e; }, f: F }; } throw new TypeError("Invalid attempt to iterate non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); } var normalCompletion = true, didErr = false, err; return { s: function s() { it = it.call(o); }, n: function n() { var step = it.next(); normalCompletion = step.done; return step; }, e: function e(_e2) { didErr = true; err = _e2; }, f: function f() { try { if (!normalCompletion && it.return != null) it.return(); } finally { if (didErr) throw err; } } }; }
+function _unsupportedIterableToArray(o, minLen) { if (!o) return; if (typeof o === "string") return _arrayLikeToArray(o, minLen); var n = Object.prototype.toString.call(o).slice(8, -1); if (n === "Object" && o.constructor) n = o.constructor.name; if (n === "Map" || n === "Set") return Array.from(o); if (n === "Arguments" || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n)) return _arrayLikeToArray(o, minLen); }
+function _arrayLikeToArray(arr, len) { if (len == null || len > arr.length) len = arr.length; for (var i = 0, arr2 = new Array(len); i < len; i++) arr2[i] = arr[i]; return arr2; }
+import * as KernelMessage from "./messages.js";
+var Private;
+(function (_Private) {
+  function deserializeV1KernelWebsocketJupyterOrg(binMsg) {
+    var data = new DataView(binMsg);
+    var offsetNumber = Number(data.getBigUint64(0, true /* littleEndian */));
+    var offsets = [];
+    for (var i = 0; i < offsetNumber; i++) {
+      // WARNING: we cast our 64-bit unsigned int to a number!
+      // so offsets cannot index up to 2**64 bytes
+      offsets.push(Number(data.getBigUint64(8 * (i + 1), true /* littleEndian */)));
+    }
+
+    var decoder = new TextDecoder('utf8');
+    var channel = decoder.decode(binMsg.slice(offsets[0], offsets[1]));
+    var header = JSON.parse(decoder.decode(binMsg.slice(offsets[1], offsets[2])));
+    var parent_header = JSON.parse(decoder.decode(binMsg.slice(offsets[2], offsets[3])));
+    var metadata = JSON.parse(decoder.decode(binMsg.slice(offsets[3], offsets[4])));
+    var content = JSON.parse(decoder.decode(binMsg.slice(offsets[4], offsets[5])));
+    var buffers = [];
+    for (var _i5 = 5; _i5 < offsets.length; _i5++) {
+      if (_i5 === offsets.length - 1) {
+        buffers.push(binMsg.slice(offsets[_i5]));
+      } else {
+        buffers.push(binMsg.slice(offsets[_i5], offsets[_i5 + 1]));
+      }
+    }
+    var msg = {
+      channel: channel,
+      header: header,
+      parent_header: parent_header,
+      metadata: metadata,
+      content: content,
+      buffers: buffers
+    };
+    return msg;
+  }
+  _Private.deserializeV1KernelWebsocketJupyterOrg = deserializeV1KernelWebsocketJupyterOrg;
+  function serializeV1KernelWebsocketJupyterOrg(msg) {
+    var header = JSON.stringify(msg.header);
+    var parentHeader = msg.parent_header === null ? '{}' : JSON.stringify(msg.parent_header);
+    var metadata = JSON.stringify(msg.metadata);
+    var content = JSON.stringify(msg.content);
+    var buffers = msg.buffers !== undefined ? msg.buffers : [];
+    var offsetNumber = 1 + 4 + buffers.length + 1;
+    var offsets = [];
+    offsets.push(8 * (1 + offsetNumber));
+    offsets.push(msg.channel.length + offsets[offsets.length - 1]);
+    var encoder = new TextEncoder();
+    var channelEncoded = encoder.encode(msg.channel);
+    var headerEncoded = encoder.encode(header);
+    var parentHeaderEncoded = encoder.encode(parentHeader);
+    var metadataEncoded = encoder.encode(metadata);
+    var contentEncoded = encoder.encode(content);
+    var binMsgNoBuff = new Uint8Array(channelEncoded.length + headerEncoded.length + parentHeaderEncoded.length + metadataEncoded.length + contentEncoded.length);
+    binMsgNoBuff.set(channelEncoded);
+    binMsgNoBuff.set(headerEncoded, channelEncoded.length);
+    binMsgNoBuff.set(parentHeaderEncoded, channelEncoded.length + headerEncoded.length);
+    binMsgNoBuff.set(metadataEncoded, channelEncoded.length + headerEncoded.length + parentHeaderEncoded.length);
+    binMsgNoBuff.set(contentEncoded, channelEncoded.length + headerEncoded.length + parentHeaderEncoded.length + metadataEncoded.length);
+    for (var _i6 = 0, _arr = [headerEncoded.length, parentHeaderEncoded.length, metadataEncoded.length, contentEncoded.length]; _i6 < _arr.length; _i6++) {
+      var length = _arr[_i6];
+      offsets.push(length + offsets[offsets.length - 1]);
+    }
+    var buffersByteLength = 0;
+    var _iterator = _createForOfIteratorHelper(buffers),
+      _step;
+    try {
+      for (_iterator.s(); !(_step = _iterator.n()).done;) {
+        var _buffer = _step.value;
+        var _length = _buffer.byteLength;
+        offsets.push(_length + offsets[offsets.length - 1]);
+        buffersByteLength += _length;
+      }
+    } catch (err) {
+      _iterator.e(err);
+    } finally {
+      _iterator.f();
+    }
+    var binMsg = new Uint8Array(8 * (1 + offsetNumber) + binMsgNoBuff.byteLength + buffersByteLength);
+    var word = new ArrayBuffer(8);
+    var data = new DataView(word);
+    data.setBigUint64(0, BigInt(offsetNumber), true /* littleEndian */);
+    binMsg.set(new Uint8Array(word), 0);
+    for (var i = 0; i < offsets.length; i++) {
+      data.setBigUint64(0, BigInt(offsets[i]), true /* littleEndian */);
+      binMsg.set(new Uint8Array(word), 8 * (i + 1));
+    }
+    binMsg.set(binMsgNoBuff, offsets[0]);
+    for (var _i7 = 0; _i7 < buffers.length; _i7++) {
+      var buffer = buffers[_i7];
+      binMsg.set(new Uint8Array(ArrayBuffer.isView(buffer) ? buffer.buffer : buffer), offsets[5 + _i7]);
+    }
+    return binMsg.buffer;
+  }
+  _Private.serializeV1KernelWebsocketJupyterOrg = serializeV1KernelWebsocketJupyterOrg;
+  function deserializeDefault(data) {
+    var value;
+    if (typeof data === 'string') {
+      value = JSON.parse(data);
+    } else {
+      value = deserializeBinary(data);
+    }
+    return value;
+  }
+  _Private.deserializeDefault = deserializeDefault;
+  function serializeDefault(msg) {
+    var _msg$buffers;
+    var value;
+    if ((_msg$buffers = msg.buffers) !== null && _msg$buffers !== void 0 && _msg$buffers.length) {
+      value = serializeBinary(msg);
+    } else {
+      value = JSON.stringify(msg);
+    }
+    return value;
+  }
+  _Private.serializeDefault = serializeDefault;
+})(Private || (Private = {}));
+/**
+ * Serialize a kernel message for transport.
+ */
+export function serialize(msg) {
+  var protocol = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : '';
+  switch (protocol) {
+    case KernelMessage.supportedKernelWebSocketProtocols.v1KernelWebsocketJupyterOrg:
+      return Private.serializeV1KernelWebsocketJupyterOrg(msg);
+    default:
+      return Private.serializeDefault(msg);
+  }
+}
+
+/**
+ * Deserialize and return the unpacked message.
+ */
+export function deserialize(data) {
+  var protocol = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : '';
+  switch (protocol) {
+    case KernelMessage.supportedKernelWebSocketProtocols.v1KernelWebsocketJupyterOrg:
+      return Private.deserializeV1KernelWebsocketJupyterOrg(data);
+    default:
+      return Private.deserializeDefault(data);
+  }
+}
+/**
+ * Deserialize a binary message to a Kernel Message.
+ */
+function deserializeBinary(buf) {
+  var data = new DataView(buf);
+  // read the header: 1 + nbufs 32b integers
+  var nbufs = data.getUint32(0);
+  var offsets = [];
+  if (nbufs < 2) {
+    throw new Error('Invalid incoming Kernel Message');
+  }
+  for (var i = 1; i <= nbufs; i++) {
+    offsets.push(data.getUint32(i * 4));
+  }
+  var jsonBytes = new Uint8Array(buf.slice(offsets[0], offsets[1]));
+  var msg = JSON.parse(new TextDecoder('utf8').decode(jsonBytes));
+  // the remaining chunks are stored as DataViews in msg.buffers
+  msg.buffers = [];
+  for (var _i = 1; _i < nbufs; _i++) {
+    var start = offsets[_i];
+    var stop = offsets[_i + 1] || buf.byteLength;
+    msg.buffers.push(new DataView(buf.slice(start, stop)));
+  }
+  return msg;
+}
+
+/**
+ * Implement the binary serialization protocol.
+ *
+ * Serialize Kernel message to ArrayBuffer.
+ */
+function serializeBinary(msg) {
+  var offsets = [];
+  var buffers = [];
+  var encoder = new TextEncoder();
+  var origBuffers = [];
+  if (msg.buffers !== undefined) {
+    origBuffers = msg.buffers;
+    delete msg.buffers;
+  }
+  var jsonUtf8 = encoder.encode(JSON.stringify(msg));
+  buffers.push(jsonUtf8.buffer);
+  for (var i = 0; i < origBuffers.length; i++) {
+    // msg.buffers elements could be either views or ArrayBuffers
+    // buffers elements are ArrayBuffers
+    var b = origBuffers[i];
+    buffers.push(ArrayBuffer.isView(b) ? b.buffer : b);
+  }
+  var nbufs = buffers.length;
+  offsets.push(4 * (nbufs + 1));
+  for (var _i2 = 0; _i2 + 1 < buffers.length; _i2++) {
+    offsets.push(offsets[offsets.length - 1] + buffers[_i2].byteLength);
+  }
+  var msgBuf = new Uint8Array(offsets[offsets.length - 1] + buffers[buffers.length - 1].byteLength);
+  // use DataView.setUint32 for network byte-order
+  var view = new DataView(msgBuf.buffer);
+  // write nbufs to first 4 bytes
+  view.setUint32(0, nbufs);
+  // write offsets to next 4 * nbufs bytes
+  for (var _i3 = 0; _i3 < offsets.length; _i3++) {
+    view.setUint32(4 * (_i3 + 1), offsets[_i3]);
+  }
+  // write all the buffers at their respective offsets
+  for (var _i4 = 0; _i4 < buffers.length; _i4++) {
+    msgBuf.set(new Uint8Array(buffers[_i4]), offsets[_i4]);
+  }
+  return msgBuf.buffer;
+}

package/es/kernel/validate.d.ts

@@ -0,0 +1,15 @@
+import type { KernelMeta } from './libro-kernel-protocol.js';
+import type * as KernelMessage from './messages.js';
+/**
+ * Validate a kernel message object.
+ */
+export declare function validateMessage(msg: KernelMessage.IMessage): asserts msg is KernelMessage.IMessage;
+/**
+ * Validate a `Kernel.KernelMeta` object.
+ */
+export declare function validateModel(model: KernelMeta): asserts model is KernelMeta;
+/**
+ * Validate an array of `KernelMeta` objects.
+ */
+export declare function validateModels(models: KernelMeta[]): asserts models is KernelMeta[];
+//# sourceMappingURL=validate.d.ts.map

package/es/kernel/validate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate.d.ts","sourceRoot":"","sources":["../../src/kernel/validate.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAC;AAC7D,OAAO,KAAK,KAAK,aAAa,MAAM,eAAe,CAAC;AA0CpD;;GAEG;AACH,wBAAgB,eAAe,CAC7B,GAAG,EAAE,aAAa,CAAC,QAAQ,GAC1B,OAAO,CAAC,GAAG,IAAI,aAAa,CAAC,QAAQ,CAQvC;AA0BD;;GAEG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC,KAAK,IAAI,UAAU,CAG5E;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,UAAU,EAAE,GAAG,OAAO,CAAC,MAAM,IAAI,UAAU,EAAE,CAKnF"}