@difizen/libro-kernel 0.0.2-alpha.0

package/es/kernel/future.js

@@ -0,0 +1,587 @@
+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); }
+function _inherits(subClass, superClass) { if (typeof superClass !== "function" && superClass !== null) { throw new TypeError("Super expression must either be null or a function"); } subClass.prototype = Object.create(superClass && superClass.prototype, { constructor: { value: subClass, writable: true, configurable: true } }); Object.defineProperty(subClass, "prototype", { writable: false }); if (superClass) _setPrototypeOf(subClass, superClass); }
+function _setPrototypeOf(o, p) { _setPrototypeOf = Object.setPrototypeOf ? Object.setPrototypeOf.bind() : function _setPrototypeOf(o, p) { o.__proto__ = p; return o; }; return _setPrototypeOf(o, p); }
+function _createSuper(Derived) { var hasNativeReflectConstruct = _isNativeReflectConstruct(); return function _createSuperInternal() { var Super = _getPrototypeOf(Derived), result; if (hasNativeReflectConstruct) { var NewTarget = _getPrototypeOf(this).constructor; result = Reflect.construct(Super, arguments, NewTarget); } else { result = Super.apply(this, arguments); } return _possibleConstructorReturn(this, result); }; }
+function _possibleConstructorReturn(self, call) { if (call && (_typeof(call) === "object" || typeof call === "function")) { return call; } else if (call !== void 0) { throw new TypeError("Derived constructors may only return object or undefined"); } return _assertThisInitialized(self); }
+function _assertThisInitialized(self) { if (self === void 0) { throw new ReferenceError("this hasn't been initialised - super() hasn't been called"); } return self; }
+function _isNativeReflectConstruct() { if (typeof Reflect === "undefined" || !Reflect.construct) return false; if (Reflect.construct.sham) return false; if (typeof Proxy === "function") return true; try { Boolean.prototype.valueOf.call(Reflect.construct(Boolean, [], function () {})); return true; } catch (e) { return false; } }
+function _getPrototypeOf(o) { _getPrototypeOf = Object.setPrototypeOf ? Object.getPrototypeOf.bind() : function _getPrototypeOf(o) { return o.__proto__ || Object.getPrototypeOf(o); }; return _getPrototypeOf(o); }
+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 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 _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); }
+import { Deferred } from '@difizen/mana-app';
+import { isStatusMsg } from "./libro-kernel-utils.js";
+var Private;
+(function (_Private) {
+  var noOp = _Private.noOp = function () {
+    /* no-op */
+  };
+  /**
+   * Defer a computation.
+   *
+   * #### NOTES
+   * We can't just use requestAnimationFrame since it is not available in node.
+   * This implementation is from Phosphor:
+   * https://github.com/phosphorjs/phosphor/blob/e88e4321289bb1198f3098e7bda40736501f2ed8/tests/test-messaging/src/index.spec.ts#L63
+   */
+  var defer = function () {
+    var ok = typeof requestAnimationFrame === 'function';
+    return ok ? requestAnimationFrame : setImmediate;
+  }();
+  var HookList = /*#__PURE__*/function () {
+    function HookList() {
+      _classCallCheck(this, HookList);
+      this._hooks = [];
+    }
+    _createClass(HookList, [{
+      key: "add",
+      value:
+      /**
+       * Register a hook.
+       *
+       * @param hook - The callback to register.
+       */
+      function add(hook) {
+        this.remove(hook);
+        this._hooks.push(hook);
+      }
+
+      /**
+       * Remove a hook, if it exists in the hook list.
+       *
+       * @param hook - The callback to remove.
+       */
+    }, {
+      key: "remove",
+      value: function remove(hook) {
+        var index = this._hooks.indexOf(hook);
+        if (index >= 0) {
+          this._hooks[index] = null;
+          this._scheduleCompact();
+        }
+      }
+
+      /**
+       * Process a message through the hooks.
+       *
+       * @returns a promise resolving to false if any hook resolved as false,
+       * otherwise true
+       *
+       * #### Notes
+       * The most recently registered hook is run first. A hook can return a
+       * boolean or a promise to a boolean, in which case processing pauses until
+       * the promise is fulfilled. If a hook return value resolves to false, any
+       * later hooks will not run and the function will return a promise resolving
+       * to false. If a hook throws an error, the error is logged to the console
+       * and the next hook is run. If a hook is registered during the hook
+       * processing, it will not run until the next message. If a hook is removed
+       * during the hook processing, it will be deactivated immediately.
+       */
+    }, {
+      key: "process",
+      value: function () {
+        var _process = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee5(msg) {
+          var processing, continueHandling, i, hook;
+          return _regeneratorRuntime().wrap(function _callee5$(_context5) {
+            while (1) switch (_context5.prev = _context5.next) {
+              case 0:
+                _context5.next = 2;
+                return this._processing;
+              case 2:
+                // Start the next process run.
+                processing = new Deferred();
+                this._processing = processing.promise;
+                i = this._hooks.length - 1;
+              case 5:
+                if (!(i >= 0)) {
+                  _context5.next = 25;
+                  break;
+                }
+                hook = this._hooks[i]; // If the hook has been removed, continue to the next one.
+                if (!(hook === null)) {
+                  _context5.next = 9;
+                  break;
+                }
+                return _context5.abrupt("continue", 22);
+              case 9:
+                _context5.prev = 9;
+                _context5.next = 12;
+                return hook(msg);
+              case 12:
+                continueHandling = _context5.sent;
+                _context5.next = 19;
+                break;
+              case 15:
+                _context5.prev = 15;
+                _context5.t0 = _context5["catch"](9);
+                continueHandling = true;
+                console.error(_context5.t0);
+              case 19:
+                if (!(continueHandling === false)) {
+                  _context5.next = 22;
+                  break;
+                }
+                processing.resolve(undefined);
+                return _context5.abrupt("return", false);
+              case 22:
+                i--;
+                _context5.next = 5;
+                break;
+              case 25:
+                // All hooks returned true (or errored out), so return true.
+                processing.resolve(undefined);
+                return _context5.abrupt("return", true);
+              case 27:
+              case "end":
+                return _context5.stop();
+            }
+          }, _callee5, this, [[9, 15]]);
+        }));
+        function process(_x5) {
+          return _process.apply(this, arguments);
+        }
+        return process;
+      }()
+      /**
+       * Schedule a cleanup of the list, removing any hooks that have been nulled out.
+       */
+    }, {
+      key: "_scheduleCompact",
+      value: function _scheduleCompact() {
+        var _this = this;
+        if (!this._compactScheduled) {
+          this._compactScheduled = true;
+
+          // Schedule a compaction in between processing runs. We do the
+          // scheduling in an animation frame to rate-limit our compactions. If we
+          // need to compact more frequently, we can change this to directly
+          // schedule the compaction.
+          defer(function () {
+            _this._processing = _this._processing.then(function () {
+              _this._compactScheduled = false;
+              _this._compact();
+              return;
+            });
+          });
+        }
+      }
+
+      /**
+       * Compact the list, removing any nulls.
+       */
+    }, {
+      key: "_compact",
+      value: function _compact() {
+        var numNulls = 0;
+        for (var i = 0, len = this._hooks.length; i < len; i++) {
+          var hook = this._hooks[i];
+          if (this._hooks[i] === null) {
+            numNulls++;
+          } else {
+            this._hooks[i - numNulls] = hook;
+          }
+        }
+        this._hooks.length -= numNulls;
+      }
+    }]);
+    return HookList;
+  }();
+  _Private.HookList = HookList;
+  var KernelFutureFlag = /*#__PURE__*/function (KernelFutureFlag) {
+    KernelFutureFlag[KernelFutureFlag["GotReply"] = 1] = "GotReply";
+    KernelFutureFlag[KernelFutureFlag["GotIdle"] = 2] = "GotIdle";
+    KernelFutureFlag[KernelFutureFlag["IsDone"] = 4] = "IsDone";
+    KernelFutureFlag[KernelFutureFlag["DisposeOnDone"] = 8] = "DisposeOnDone";
+    return KernelFutureFlag;
+  }({});
+  _Private.KernelFutureFlag = KernelFutureFlag;
+})(Private || (Private = {}));
+/**
+ * Implementation of a kernel future.
+ *
+ * If a reply is expected, the Future is considered done when both a `reply`
+ * message and an `idle` iopub status message have been received.  Otherwise, it
+ * is considered done when the `idle` status is received.
+ *
+ */
+export var KernelFutureHandler = /*#__PURE__*/function () {
+  /**
+   * Construct a new KernelFutureHandler.
+   */
+  function KernelFutureHandler(cb, msg, expectReply, disposeOnDone, kernel) {
+    _classCallCheck(this, KernelFutureHandler);
+    this.disposed = false;
+    this._status = 0;
+    this._stdin = Private.noOp;
+    this._iopub = Private.noOp;
+    this._reply = Private.noOp;
+    this._done = new Deferred();
+    this._hooks = new Private.HookList();
+    this._disposeOnDone = true;
+    this.disposeCb = cb;
+    this._msg = msg;
+    if (!expectReply) {
+      this._setFlag(Private.KernelFutureFlag.GotReply);
+    }
+    this._disposeOnDone = disposeOnDone;
+    this._kernel = kernel;
+  }
+
+  /**
+   * Get the original outgoing message.
+   */
+  _createClass(KernelFutureHandler, [{
+    key: "msg",
+    get: function get() {
+      return this._msg;
+    }
+
+    /**
+     * A promise that resolves when the future is done.
+     */
+  }, {
+    key: "done",
+    get: function get() {
+      return this._done.promise;
+    }
+
+    /**
+     * Get the reply handler.
+     */
+  }, {
+    key: "onReply",
+    get: function get() {
+      return this._reply;
+    }
+
+    /**
+     * Set the reply handler.
+     */,
+    set: function set(cb) {
+      this._reply = cb;
+    }
+
+    /**
+     * Get the iopub handler.
+     */
+  }, {
+    key: "onIOPub",
+    get: function get() {
+      return this._iopub;
+    }
+
+    /**
+     * Set the iopub handler.
+     */,
+    set: function set(cb) {
+      this._iopub = cb;
+    }
+
+    /**
+     * Get the stdin handler.
+     */
+  }, {
+    key: "onStdin",
+    get: function get() {
+      return this._stdin;
+    }
+
+    /**
+     * Set the stdin handler.
+     */,
+    set: function set(cb) {
+      this._stdin = cb;
+    }
+
+    /**
+     * Register hook for IOPub messages.
+     *
+     * @param hook - The callback invoked for an IOPub message.
+     *
+     * #### Notes
+     * The IOPub hook system allows you to preempt the handlers for IOPub
+     * messages handled by the future.
+     *
+     * The most recently registered hook is run first. A hook can return a
+     * boolean or a promise to a boolean, in which case all kernel message
+     * processing pauses until the promise is fulfilled. If a hook return value
+     * resolves to false, any later hooks will not run and the function will
+     * return a promise resolving to false. If a hook throws an error, the error
+     * is logged to the console and the next hook is run. If a hook is
+     * registered during the hook processing, it will not run until the next
+     * message. If a hook is removed during the hook processing, it will be
+     * deactivated immediately.
+     */
+  }, {
+    key: "registerMessageHook",
+    value: function registerMessageHook(hook) {
+      if (this.disposed) {
+        throw new Error('Kernel future is disposed');
+      }
+      this._hooks.add(hook);
+    }
+
+    /**
+     * Remove a hook for IOPub messages.
+     *
+     * @param hook - The hook to remove.
+     *
+     * #### Notes
+     * If a hook is removed during the hook processing, it will be deactivated immediately.
+     */
+  }, {
+    key: "removeMessageHook",
+    value: function removeMessageHook(hook) {
+      if (this.disposed) {
+        return;
+      }
+      this._hooks.remove(hook);
+    }
+
+    /**
+     * Send an `input_reply` message.
+     */
+  }, {
+    key: "sendInputReply",
+    value: function sendInputReply(content, parent_header) {
+      this._kernel.sendInputReply(content, parent_header);
+    }
+
+    /**
+     * Dispose and unregister the future.
+     */
+  }, {
+    key: "dispose",
+    value: function dispose() {
+      this._stdin = Private.noOp;
+      this._iopub = Private.noOp;
+      this._reply = Private.noOp;
+      this._hooks = null;
+      if (!this._testFlag(Private.KernelFutureFlag.IsDone)) {
+        // TODO: Uncomment the following logging code, and check for any tests that trigger it.
+        // let status = [];
+        // if (!this._testFlag(Private.KernelFutureFlag.GotIdle)) {
+        //   status.push('idle');
+        // }
+        // if (!this._testFlag(Private.KernelFutureFlag.GotReply)) {
+        //   status.push('reply');
+        // }
+        // console.warn(
+        //   `*************** DISPOSED BEFORE DONE: K${this._kernel.id.slice(
+        //     0,
+        //     6
+        //   )} M${this._msg.header.msg_id.slice(0, 6)} missing ${status.join(' ')}`
+        // );
+
+        // Reject the `done` promise, but catch its error here in case no one else
+        // is waiting for the promise to resolve. This prevents the error from
+        // being displayed in the console, but does not prevent it from being
+        // caught by a client who is waiting for it.
+        this._done.promise.catch(function () {
+          /* no-op */
+        });
+        this._done.reject(new Error("Canceled future for ".concat(this.msg.header.msg_type, " message before replies were done")));
+      }
+      this.disposeCb();
+      this.disposed = true;
+    }
+
+    /**
+     * Handle an incoming kernel message.
+     */
+  }, {
+    key: "handleMsg",
+    value: function () {
+      var _handleMsg = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee(msg) {
+        return _regeneratorRuntime().wrap(function _callee$(_context) {
+          while (1) switch (_context.prev = _context.next) {
+            case 0:
+              _context.t0 = msg.channel;
+              _context.next = _context.t0 === 'control' ? 3 : _context.t0 === 'shell' ? 3 : _context.t0 === 'stdin' ? 7 : _context.t0 === 'iopub' ? 10 : 13;
+              break;
+            case 3:
+              if (!(msg.channel === this.msg.channel && msg.parent_header.msg_id === this.msg.header.msg_id)) {
+                _context.next = 6;
+                break;
+              }
+              _context.next = 6;
+              return this._handleReply(msg);
+            case 6:
+              return _context.abrupt("break", 14);
+            case 7:
+              _context.next = 9;
+              return this._handleStdin(msg);
+            case 9:
+              return _context.abrupt("break", 14);
+            case 10:
+              _context.next = 12;
+              return this._handleIOPub(msg);
+            case 12:
+              return _context.abrupt("break", 14);
+            case 13:
+              return _context.abrupt("break", 14);
+            case 14:
+            case "end":
+              return _context.stop();
+          }
+        }, _callee, this);
+      }));
+      function handleMsg(_x) {
+        return _handleMsg.apply(this, arguments);
+      }
+      return handleMsg;
+    }()
+  }, {
+    key: "_handleReply",
+    value: function () {
+      var _handleReply2 = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee2(msg) {
+        var reply;
+        return _regeneratorRuntime().wrap(function _callee2$(_context2) {
+          while (1) switch (_context2.prev = _context2.next) {
+            case 0:
+              reply = this._reply;
+              if (!reply) {
+                _context2.next = 4;
+                break;
+              }
+              _context2.next = 4;
+              return reply(msg);
+            case 4:
+              this._replyMsg = msg;
+              this._setFlag(Private.KernelFutureFlag.GotReply);
+              if (this._testFlag(Private.KernelFutureFlag.GotIdle)) {
+                this._handleDone();
+              }
+            case 7:
+            case "end":
+              return _context2.stop();
+          }
+        }, _callee2, this);
+      }));
+      function _handleReply(_x2) {
+        return _handleReply2.apply(this, arguments);
+      }
+      return _handleReply;
+    }()
+  }, {
+    key: "_handleStdin",
+    value: function () {
+      var _handleStdin2 = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee3(msg) {
+        var stdin;
+        return _regeneratorRuntime().wrap(function _callee3$(_context3) {
+          while (1) switch (_context3.prev = _context3.next) {
+            case 0:
+              this._kernel.hasPendingInput = true;
+              stdin = this._stdin;
+              if (!stdin) {
+                _context3.next = 5;
+                break;
+              }
+              _context3.next = 5;
+              return stdin(msg);
+            case 5:
+            case "end":
+              return _context3.stop();
+          }
+        }, _callee3, this);
+      }));
+      function _handleStdin(_x3) {
+        return _handleStdin2.apply(this, arguments);
+      }
+      return _handleStdin;
+    }()
+  }, {
+    key: "_handleIOPub",
+    value: function () {
+      var _handleIOPub2 = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee4(msg) {
+        var process, iopub;
+        return _regeneratorRuntime().wrap(function _callee4$(_context4) {
+          while (1) switch (_context4.prev = _context4.next) {
+            case 0:
+              _context4.next = 2;
+              return this._hooks.process(msg);
+            case 2:
+              process = _context4.sent;
+              iopub = this._iopub;
+              if (!(process && iopub)) {
+                _context4.next = 7;
+                break;
+              }
+              _context4.next = 7;
+              return iopub(msg);
+            case 7:
+              if (isStatusMsg(msg) && msg.content.execution_state === 'idle') {
+                this._setFlag(Private.KernelFutureFlag.GotIdle);
+                if (this._testFlag(Private.KernelFutureFlag.GotReply)) {
+                  this._handleDone();
+                }
+              }
+            case 8:
+            case "end":
+              return _context4.stop();
+          }
+        }, _callee4, this);
+      }));
+      function _handleIOPub(_x4) {
+        return _handleIOPub2.apply(this, arguments);
+      }
+      return _handleIOPub;
+    }()
+  }, {
+    key: "_handleDone",
+    value: function _handleDone() {
+      if (this._testFlag(Private.KernelFutureFlag.IsDone)) {
+        return;
+      }
+      this._setFlag(Private.KernelFutureFlag.IsDone);
+      this._done.resolve(this._replyMsg);
+      if (this._disposeOnDone) {
+        this.dispose();
+      }
+    }
+
+    /**
+     * Test whether the given future flag is set.
+     */
+  }, {
+    key: "_testFlag",
+    value: function _testFlag(flag) {
+      // tslint:disable-next-line
+      return (this._status & flag) !== 0;
+    }
+
+    /**
+     * Set the given future flag.
+     */
+  }, {
+    key: "_setFlag",
+    value: function _setFlag(flag) {
+      // tslint:disable-next-line
+      this._status |= flag;
+    }
+  }]);
+  return KernelFutureHandler;
+}();
+export var KernelControlFutureHandler = /*#__PURE__*/function (_ref) {
+  _inherits(KernelControlFutureHandler, _ref);
+  var _super = _createSuper(KernelControlFutureHandler);
+  function KernelControlFutureHandler() {
+    _classCallCheck(this, KernelControlFutureHandler);
+    return _super.apply(this, arguments);
+  }
+  return _createClass(KernelControlFutureHandler);
+}(KernelFutureHandler);
+export var KernelShellFutureHandler = /*#__PURE__*/function (_ref2) {
+  _inherits(KernelShellFutureHandler, _ref2);
+  var _super2 = _createSuper(KernelShellFutureHandler);
+  function KernelShellFutureHandler() {
+    _classCallCheck(this, KernelShellFutureHandler);
+    return _super2.apply(this, arguments);
+  }
+  return _createClass(KernelShellFutureHandler);
+}(KernelFutureHandler);

package/es/kernel/index.d.ts

@@ -0,0 +1,8 @@
+export * from './kernel-connection.js';
+export * from './kernel-module.js';
+export * as KernelMessage from './messages.js';
+export * from './libro-kernel-manager.js';
+export * from './libro-kernel-protocol.js';
+export * from './libro-kernel-utils.js';
+export * from './restapi.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/kernel/index.ts"],"names":[],"mappings":"AAAA,cAAc,wBAAwB,CAAC;AACvC,cAAc,oBAAoB,CAAC;AACnC,OAAO,KAAK,aAAa,MAAM,eAAe,CAAC;AAC/C,cAAc,2BAA2B,CAAC;AAC1C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,yBAAyB,CAAC;AACxC,cAAc,cAAc,CAAC"}

package/es/kernel/index.js

@@ -0,0 +1,8 @@
+export * from "./kernel-connection.js";
+export * from "./kernel-module.js";
+import * as _KernelMessage from "./messages.js";
+export { _KernelMessage as KernelMessage };
+export * from "./libro-kernel-manager.js";
+export * from "./libro-kernel-protocol.js";
+export * from "./libro-kernel-utils.js";
+export * from "./restapi.js";