@atlaskit/collab-provider 8.4.0 → 8.5.0

package/dist/cjs/document/document-service.js

@@ -0,0 +1,617 @@
+"use strict";
+
+var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefault");
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.DocumentService = void 0;
+var _regenerator = _interopRequireDefault(require("@babel/runtime/regenerator"));
+var _asyncToGenerator2 = _interopRequireDefault(require("@babel/runtime/helpers/asyncToGenerator"));
+var _classCallCheck2 = _interopRequireDefault(require("@babel/runtime/helpers/classCallCheck"));
+var _createClass2 = _interopRequireDefault(require("@babel/runtime/helpers/createClass"));
+var _defineProperty2 = _interopRequireDefault(require("@babel/runtime/helpers/defineProperty"));
+var _const = require("../helpers/const");
+var _prosemirrorCollab = require("@atlaskit/prosemirror-collab");
+var _utils = require("../helpers/utils");
+var _throttle = _interopRequireDefault(require("lodash/throttle"));
+var _performance = require("../analytics/performance");
+var _editorJsonTransformer = require("@atlaskit/editor-json-transformer");
+var _provider = require("../provider");
+var _catchup = require("./catchup");
+var _isEqual = _interopRequireDefault(require("lodash/isEqual"));
+var _stepQueueState = require("./step-queue-state");
+var _errorTypes = require("../errors/error-types");
+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) { (0, _defineProperty2.default)(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; }
+var CATCHUP_THROTTLE = 1 * 1000; // 1 second
+
+var noop = function noop() {};
+var logger = (0, _utils.createLogger)('documentService', 'black');
+var DocumentService = /*#__PURE__*/function () {
+  // Fires analytics to editor when collab editor cannot sync up
+
+  /**
+   *
+   * @param participantsService - The participants service, used when users are detected active when making changes to the document
+   * and to emit their telepointers from steps they add
+   * @param analyticsHelper - Helper for analytics events
+   * @param fetchCatchup - Function to fetch "catchup" data, data required to rebase current steps to the latest version.
+   * @param providerEmitCallback - Callback for emitting events to listeners on the provider
+   * @param broadcastMetadata - Callback for broadcasting metadata changes to other clients
+   * @param broadcast - Callback for broadcasting events to other clients
+   * @param getUserId - Callback to fetch the current user's ID
+   * @param onErrorHandled - Callback to handle
+   */
+  function DocumentService(participantsService, analyticsHelper, fetchCatchup, providerEmitCallback, broadcastMetadata, broadcast, getUserId, onErrorHandled) {
+    var _this = this;
+    (0, _classCallCheck2.default)(this, DocumentService);
+    (0, _defineProperty2.default)(this, "stepRejectCounter", 0);
+    (0, _defineProperty2.default)(this, "metadata", {});
+    (0, _defineProperty2.default)(this, "onMetadataChanged", function (metadata) {
+      if (metadata !== undefined && !(0, _isEqual.default)(_this.metadata, metadata)) {
+        _this.metadata = metadata;
+        _this.providerEmitCallback('metadata:changed', metadata);
+      }
+    });
+    (0, _defineProperty2.default)(this, "getMetaData", function () {
+      return _this.metadata;
+    });
+    (0, _defineProperty2.default)(this, "throttledCatchup", (0, _throttle.default)(function () {
+      return _this.catchup();
+    }, CATCHUP_THROTTLE, {
+      leading: false,
+      // TODO: why shouldn't this be leading?
+      trailing: true
+    }));
+    (0, _defineProperty2.default)(this, "catchup", /*#__PURE__*/(0, _asyncToGenerator2.default)( /*#__PURE__*/_regenerator.default.mark(function _callee() {
+      var start, _this$analyticsHelper, latency, _this$analyticsHelper2, _this$analyticsHelper3, _latency;
+      return _regenerator.default.wrap(function _callee$(_context) {
+        while (1) {
+          switch (_context.prev = _context.next) {
+            case 0:
+              start = new Date().getTime(); // if the queue is already paused, we are busy with something else, so don't proceed.
+              if (!_this.stepQueue.isPaused()) {
+                _context.next = 4;
+                break;
+              }
+              logger("Queue is paused. Aborting.");
+              return _context.abrupt("return");
+            case 4:
+              _this.stepQueue.pauseQueue();
+              _context.prev = 5;
+              _context.next = 8;
+              return (0, _catchup.catchup)({
+                getCurrentPmVersion: _this.getCurrentPmVersion,
+                fetchCatchup: _this.fetchCatchup,
+                getUnconfirmedSteps: _this.getUnconfirmedSteps,
+                filterQueue: _this.stepQueue.filterQueue,
+                updateDocumentWithMetadata: _this.updateDocumentWithMetadata,
+                applyLocalSteps: _this.applyLocalSteps
+              });
+            case 8:
+              latency = new Date().getTime() - start;
+              (_this$analyticsHelper = _this.analyticsHelper) === null || _this$analyticsHelper === void 0 ? void 0 : _this$analyticsHelper.sendActionEvent(_const.EVENT_ACTION.CATCHUP, _const.EVENT_STATUS.SUCCESS, {
+                latency: latency
+              });
+              _context.next = 18;
+              break;
+            case 12:
+              _context.prev = 12;
+              _context.t0 = _context["catch"](5);
+              _latency = new Date().getTime() - start;
+              (_this$analyticsHelper2 = _this.analyticsHelper) === null || _this$analyticsHelper2 === void 0 ? void 0 : _this$analyticsHelper2.sendActionEvent(_const.EVENT_ACTION.CATCHUP, _const.EVENT_STATUS.FAILURE, {
+                latency: _latency
+              });
+              (_this$analyticsHelper3 = _this.analyticsHelper) === null || _this$analyticsHelper3 === void 0 ? void 0 : _this$analyticsHelper3.sendErrorEvent(_context.t0, 'Error while catching up');
+              logger("Catch-Up Failed:", _context.t0.message);
+            case 18:
+              _context.prev = 18;
+              _this.stepQueue.resumeQueue();
+              _this.processQueue();
+              _this.sendStepsFromCurrentState(); // this will eventually retry catchup as it calls commitStep which will either catchup on onStepsAdded or onErrorHandled
+              _this.stepRejectCounter = 0;
+              return _context.finish(18);
+            case 24:
+            case "end":
+              return _context.stop();
+          }
+        }
+      }, _callee, null, [[5, 12, 18, 24]]);
+    })));
+    (0, _defineProperty2.default)(this, "getCurrentPmVersion", function () {
+      var _this$getState;
+      var state = (_this$getState = _this.getState) === null || _this$getState === void 0 ? void 0 : _this$getState.call(_this);
+      if (!state) {
+        var _this$analyticsHelper4;
+        (_this$analyticsHelper4 = _this.analyticsHelper) === null || _this$analyticsHelper4 === void 0 ? void 0 : _this$analyticsHelper4.sendErrorEvent(new Error('No editor state when calling ProseMirror function'), 'getCurrentPmVersion called without state');
+        return 0;
+      }
+      return (0, _prosemirrorCollab.getVersion)(state);
+    });
+    (0, _defineProperty2.default)(this, "getCurrentState", /*#__PURE__*/(0, _asyncToGenerator2.default)( /*#__PURE__*/_regenerator.default.mark(function _callee2() {
+      var _this$metadata$title, _this$analyticsHelper5, state, adfDocument, currentState, measure, _this$analyticsHelper6, _this$analyticsHelper7, _measure;
+      return _regenerator.default.wrap(function _callee2$(_context2) {
+        while (1) {
+          switch (_context2.prev = _context2.next) {
+            case 0:
+              _context2.prev = 0;
+              (0, _performance.startMeasure)(_performance.MEASURE_NAME.GET_CURRENT_STATE, _this.analyticsHelper);
+
+              // Convert ProseMirror document in Editor state to ADF document
+              state = _this.getState();
+              adfDocument = new _editorJsonTransformer.JSONTransformer().encode(state.doc);
+              currentState = {
+                content: adfDocument,
+                title: (_this$metadata$title = _this.metadata.title) === null || _this$metadata$title === void 0 ? void 0 : _this$metadata$title.toString(),
+                stepVersion: (0, _prosemirrorCollab.getVersion)(state)
+              };
+              measure = (0, _performance.stopMeasure)(_performance.MEASURE_NAME.GET_CURRENT_STATE, _this.analyticsHelper);
+              (_this$analyticsHelper5 = _this.analyticsHelper) === null || _this$analyticsHelper5 === void 0 ? void 0 : _this$analyticsHelper5.sendActionEvent(_const.EVENT_ACTION.GET_CURRENT_STATE, _const.EVENT_STATUS.SUCCESS, {
+                latency: measure === null || measure === void 0 ? void 0 : measure.duration
+              });
+              return _context2.abrupt("return", currentState);
+            case 10:
+              _context2.prev = 10;
+              _context2.t0 = _context2["catch"](0);
+              _measure = (0, _performance.stopMeasure)(_performance.MEASURE_NAME.GET_CURRENT_STATE, _this.analyticsHelper);
+              (_this$analyticsHelper6 = _this.analyticsHelper) === null || _this$analyticsHelper6 === void 0 ? void 0 : _this$analyticsHelper6.sendActionEvent(_const.EVENT_ACTION.GET_CURRENT_STATE, _const.EVENT_STATUS.FAILURE, {
+                latency: _measure === null || _measure === void 0 ? void 0 : _measure.duration
+              });
+              (_this$analyticsHelper7 = _this.analyticsHelper) === null || _this$analyticsHelper7 === void 0 ? void 0 : _this$analyticsHelper7.sendErrorEvent(_context2.t0, 'Error while returning ADF version of current draft document');
+              throw _context2.t0;
+            case 16:
+            case "end":
+              return _context2.stop();
+          }
+        }
+      }, _callee2, null, [[0, 10]]);
+    })));
+    (0, _defineProperty2.default)(this, "getUnconfirmedStepsOrigins", function () {
+      var _this$getState2, _sendableSteps;
+      var state = (_this$getState2 = _this.getState) === null || _this$getState2 === void 0 ? void 0 : _this$getState2.call(_this);
+      if (!state) {
+        var _this$analyticsHelper8;
+        (_this$analyticsHelper8 = _this.analyticsHelper) === null || _this$analyticsHelper8 === void 0 ? void 0 : _this$analyticsHelper8.sendErrorEvent(new Error('No editor state when calling ProseMirror function'), 'getUnconfirmedStepsOrigins called without state');
+        return;
+      }
+      return (_sendableSteps = (0, _prosemirrorCollab.sendableSteps)(state)) === null || _sendableSteps === void 0 ? void 0 : _sendableSteps.origins;
+    });
+    (0, _defineProperty2.default)(this, "getUnconfirmedSteps", function () {
+      var _this$getState3, _sendableSteps2;
+      var state = (_this$getState3 = _this.getState) === null || _this$getState3 === void 0 ? void 0 : _this$getState3.call(_this);
+      if (!state) {
+        var _this$analyticsHelper9;
+        (_this$analyticsHelper9 = _this.analyticsHelper) === null || _this$analyticsHelper9 === void 0 ? void 0 : _this$analyticsHelper9.sendErrorEvent(new Error('No editor state when calling ProseMirror function'), 'getUnconfirmedSteps called without state');
+        return;
+      }
+      return (_sendableSteps2 = (0, _prosemirrorCollab.sendableSteps)(state)) === null || _sendableSteps2 === void 0 ? void 0 : _sendableSteps2.steps;
+    });
+    (0, _defineProperty2.default)(this, "applyLocalSteps", function (steps) {
+      // Re-apply local steps
+      _this.providerEmitCallback('local-steps', {
+        steps: steps
+      });
+    });
+    (0, _defineProperty2.default)(this, "updateDocumentWithMetadata", function (_ref3) {
+      var doc = _ref3.doc,
+        version = _ref3.version,
+        metadata = _ref3.metadata,
+        reserveCursor = _ref3.reserveCursor;
+      _this.providerEmitCallback('init', _objectSpread({
+        doc: doc,
+        version: version,
+        metadata: metadata
+      }, reserveCursor ? {
+        reserveCursor: reserveCursor
+      } : {}));
+      if (metadata && Object.keys(metadata).length > 0) {
+        _this.metadata = metadata;
+        _this.providerEmitCallback('metadata:changed', metadata);
+      }
+    });
+    (0, _defineProperty2.default)(this, "onStepsAdded", function (data) {
+      logger("Received steps", {
+        steps: data.steps,
+        version: data.version
+      });
+      if (!data.steps) {
+        logger("No steps.. waiting..");
+        return;
+      }
+      try {
+        var currentVersion = _this.getCurrentPmVersion();
+        var expectedVersion = currentVersion + data.steps.length;
+        if (data.version <= currentVersion) {
+          logger("Received steps we already have. Ignoring.");
+        } else if (data.version === expectedVersion) {
+          _this.processSteps(data);
+        } else if (data.version > expectedVersion) {
+          logger("Version too high. Expected \"".concat(expectedVersion, "\" but got \"").concat(data.version, ". Current local version is ").concat(currentVersion, "."));
+          _this.stepQueue.queueSteps(data);
+          _this.throttledCatchup();
+        }
+        _this.participantsService.updateLastActive(data.steps.map(function (_ref4) {
+          var userId = _ref4.userId;
+          return userId;
+        }));
+      } catch (stepsAddedError) {
+        var _this$analyticsHelper10;
+        (_this$analyticsHelper10 = _this.analyticsHelper) === null || _this$analyticsHelper10 === void 0 ? void 0 : _this$analyticsHelper10.sendErrorEvent(stepsAddedError, 'Error while adding steps in the provider');
+        _this.onErrorHandled({
+          message: 'Error while adding steps in the provider',
+          data: {
+            status: 500,
+            // Meaningless, remove when we review error structure
+            code: _errorTypes.INTERNAL_ERROR_CODE.ADD_STEPS_ERROR
+          }
+        });
+      }
+    });
+    (0, _defineProperty2.default)(this, "onRestore", function (_ref5) {
+      var doc = _ref5.doc,
+        version = _ref5.version,
+        metadata = _ref5.metadata;
+      // Preserve the unconfirmed steps to prevent data loss.
+      var unconfirmedSteps = _this.getUnconfirmedSteps();
+      try {
+        var _this$analyticsHelper11;
+        // Reset the editor,
+        //  - Replace the document, keep in sync with the server
+        //  - Replace the version number, so editor is in sync with NCS server and can commit new changes.
+        //  - Replace the metadata
+        //  - Reserve the cursor position, in case a cursor jump.
+        _this.updateDocumentWithMetadata({
+          doc: doc,
+          version: version,
+          metadata: metadata,
+          reserveCursor: true
+        });
+
+        // Re-apply the unconfirmed steps, not 100% of them can be applied, if document is changed significantly.
+        if (unconfirmedSteps !== null && unconfirmedSteps !== void 0 && unconfirmedSteps.length) {
+          _this.applyLocalSteps(unconfirmedSteps);
+        }
+        (_this$analyticsHelper11 = _this.analyticsHelper) === null || _this$analyticsHelper11 === void 0 ? void 0 : _this$analyticsHelper11.sendActionEvent(_const.EVENT_ACTION.REINITIALISE_DOCUMENT, _const.EVENT_STATUS.SUCCESS, {
+          numUnconfirmedSteps: unconfirmedSteps === null || unconfirmedSteps === void 0 ? void 0 : unconfirmedSteps.length
+        });
+      } catch (restoreError) {
+        var _this$analyticsHelper12, _this$analyticsHelper13;
+        (_this$analyticsHelper12 = _this.analyticsHelper) === null || _this$analyticsHelper12 === void 0 ? void 0 : _this$analyticsHelper12.sendActionEvent(_const.EVENT_ACTION.REINITIALISE_DOCUMENT, _const.EVENT_STATUS.FAILURE, {
+          numUnconfirmedSteps: unconfirmedSteps === null || unconfirmedSteps === void 0 ? void 0 : unconfirmedSteps.length
+        });
+        (_this$analyticsHelper13 = _this.analyticsHelper) === null || _this$analyticsHelper13 === void 0 ? void 0 : _this$analyticsHelper13.sendErrorEvent(restoreError, 'Error while reinitialising document');
+        _this.onErrorHandled({
+          message: 'Caught error while trying to recover the document',
+          data: {
+            status: 500,
+            // Meaningless, remove when we review error structure
+            code: _errorTypes.INTERNAL_ERROR_CODE.DOCUMENT_RESTORE_ERROR
+          }
+        });
+      }
+    });
+    (0, _defineProperty2.default)(this, "getFinalAcknowledgedState", /*#__PURE__*/(0, _asyncToGenerator2.default)( /*#__PURE__*/_regenerator.default.mark(function _callee3() {
+      var _this$analyticsHelper14, currentState, measure, _this$analyticsHelper15, _this$analyticsHelper16, _measure2;
+      return _regenerator.default.wrap(function _callee3$(_context3) {
+        while (1) {
+          switch (_context3.prev = _context3.next) {
+            case 0:
+              _context3.prev = 0;
+              (0, _performance.startMeasure)(_performance.MEASURE_NAME.PUBLISH_PAGE, _this.analyticsHelper);
+              _context3.next = 4;
+              return _this.commitUnconfirmedSteps();
+            case 4:
+              _context3.next = 6;
+              return _this.getCurrentState();
+            case 6:
+              currentState = _context3.sent;
+              measure = (0, _performance.stopMeasure)(_performance.MEASURE_NAME.PUBLISH_PAGE, _this.analyticsHelper);
+              (_this$analyticsHelper14 = _this.analyticsHelper) === null || _this$analyticsHelper14 === void 0 ? void 0 : _this$analyticsHelper14.sendActionEvent(_const.EVENT_ACTION.PUBLISH_PAGE, _const.EVENT_STATUS.SUCCESS, {
+                latency: measure === null || measure === void 0 ? void 0 : measure.duration
+              });
+              return _context3.abrupt("return", currentState);
+            case 12:
+              _context3.prev = 12;
+              _context3.t0 = _context3["catch"](0);
+              _measure2 = (0, _performance.stopMeasure)(_performance.MEASURE_NAME.PUBLISH_PAGE, _this.analyticsHelper);
+              (_this$analyticsHelper15 = _this.analyticsHelper) === null || _this$analyticsHelper15 === void 0 ? void 0 : _this$analyticsHelper15.sendActionEvent(_const.EVENT_ACTION.PUBLISH_PAGE, _const.EVENT_STATUS.FAILURE, {
+                latency: _measure2 === null || _measure2 === void 0 ? void 0 : _measure2.duration
+              });
+              (_this$analyticsHelper16 = _this.analyticsHelper) === null || _this$analyticsHelper16 === void 0 ? void 0 : _this$analyticsHelper16.sendErrorEvent(_context3.t0, 'Error while returning ADF version of the final draft document');
+              throw _context3.t0;
+            case 18:
+            case "end":
+              return _context3.stop();
+          }
+        }
+      }, _callee3, null, [[0, 12]]);
+    })));
+    (0, _defineProperty2.default)(this, "commitUnconfirmedSteps", /*#__PURE__*/(0, _asyncToGenerator2.default)( /*#__PURE__*/_regenerator.default.mark(function _callee5() {
+      var unconfirmedSteps, _this$analyticsHelper18, _this$analyticsHelper19, measure;
+      return _regenerator.default.wrap(function _callee5$(_context5) {
+        while (1) {
+          switch (_context5.prev = _context5.next) {
+            case 0:
+              unconfirmedSteps = _this.getUnconfirmedSteps();
+              _context5.prev = 1;
+              if (!(unconfirmedSteps !== null && unconfirmedSteps !== void 0 && unconfirmedSteps.length)) {
+                _context5.next = 4;
+                break;
+              }
+              return _context5.delegateYield( /*#__PURE__*/_regenerator.default.mark(function _callee4() {
+                var _this$analyticsHelper17;
+                var count, unconfirmedTrs, lastTr, isLastTrConfirmed, nextUnconfirmedSteps, nextUnconfirmedTrs, state, measure;
+                return _regenerator.default.wrap(function _callee4$(_context4) {
+                  while (1) {
+                    switch (_context4.prev = _context4.next) {
+                      case 0:
+                        (0, _performance.startMeasure)(_performance.MEASURE_NAME.COMMIT_UNCONFIRMED_STEPS, _this.analyticsHelper);
+                        count = 0; // We use origins here as steps can be rebased. When steps are rebased a new step is created.
+                        // This means that we can not track if it has been removed from the unconfirmed array or not.
+                        // Origins points to the original transaction that the step was created in. This is never changed
+                        // and gets passed down when a step is rebased.
+                        unconfirmedTrs = _this.getUnconfirmedStepsOrigins();
+                        lastTr = unconfirmedTrs === null || unconfirmedTrs === void 0 ? void 0 : unconfirmedTrs[unconfirmedTrs.length - 1];
+                        isLastTrConfirmed = false;
+                      case 5:
+                        if (isLastTrConfirmed) {
+                          _context4.next = 16;
+                          break;
+                        }
+                        _this.sendStepsFromCurrentState();
+                        _context4.next = 9;
+                        return (0, _utils.sleep)(1000);
+                      case 9:
+                        nextUnconfirmedSteps = _this.getUnconfirmedSteps();
+                        if (nextUnconfirmedSteps !== null && nextUnconfirmedSteps !== void 0 && nextUnconfirmedSteps.length) {
+                          nextUnconfirmedTrs = _this.getUnconfirmedStepsOrigins();
+                          isLastTrConfirmed = !(nextUnconfirmedTrs !== null && nextUnconfirmedTrs !== void 0 && nextUnconfirmedTrs.some(function (tr) {
+                            return tr === lastTr;
+                          }));
+                        } else {
+                          isLastTrConfirmed = true;
+                        }
+                        if (!(!isLastTrConfirmed && count++ >= _const.ACK_MAX_TRY)) {
+                          _context4.next = 14;
+                          break;
+                        }
+                        if (_this.onSyncUpError) {
+                          state = _this.getState();
+                          _this.onSyncUpError({
+                            lengthOfUnconfirmedSteps: nextUnconfirmedSteps === null || nextUnconfirmedSteps === void 0 ? void 0 : nextUnconfirmedSteps.length,
+                            tries: count,
+                            maxRetries: _const.ACK_MAX_TRY,
+                            clientId: _this.clientId,
+                            version: (0, _prosemirrorCollab.getVersion)(state)
+                          });
+                        }
+                        throw new Error("Can't sync up with Collab Service");
+                      case 14:
+                        _context4.next = 5;
+                        break;
+                      case 16:
+                        measure = (0, _performance.stopMeasure)(_performance.MEASURE_NAME.COMMIT_UNCONFIRMED_STEPS, _this.analyticsHelper);
+                        (_this$analyticsHelper17 = _this.analyticsHelper) === null || _this$analyticsHelper17 === void 0 ? void 0 : _this$analyticsHelper17.sendActionEvent(_const.EVENT_ACTION.COMMIT_UNCONFIRMED_STEPS, _const.EVENT_STATUS.SUCCESS, {
+                          latency: measure === null || measure === void 0 ? void 0 : measure.duration,
+                          // upon success, emit the total number of unconfirmed steps we synced
+                          numUnconfirmedSteps: unconfirmedSteps === null || unconfirmedSteps === void 0 ? void 0 : unconfirmedSteps.length
+                        });
+                      case 18:
+                      case "end":
+                        return _context4.stop();
+                    }
+                  }
+                }, _callee4);
+              })(), "t0", 4);
+            case 4:
+              _context5.next = 12;
+              break;
+            case 6:
+              _context5.prev = 6;
+              _context5.t1 = _context5["catch"](1);
+              measure = (0, _performance.stopMeasure)(_performance.MEASURE_NAME.COMMIT_UNCONFIRMED_STEPS, _this.analyticsHelper);
+              (_this$analyticsHelper18 = _this.analyticsHelper) === null || _this$analyticsHelper18 === void 0 ? void 0 : _this$analyticsHelper18.sendActionEvent(_const.EVENT_ACTION.COMMIT_UNCONFIRMED_STEPS, _const.EVENT_STATUS.FAILURE, {
+                latency: measure === null || measure === void 0 ? void 0 : measure.duration,
+                numUnconfirmedSteps: unconfirmedSteps === null || unconfirmedSteps === void 0 ? void 0 : unconfirmedSteps.length
+              });
+              (_this$analyticsHelper19 = _this.analyticsHelper) === null || _this$analyticsHelper19 === void 0 ? void 0 : _this$analyticsHelper19.sendErrorEvent(_context5.t1, 'Error while committing unconfirmed steps');
+              throw _context5.t1;
+            case 12:
+            case "end":
+              return _context5.stop();
+          }
+        }
+      }, _callee5, null, [[1, 6]]);
+    })));
+    (0, _defineProperty2.default)(this, "onStepRejectedError", function () {
+      _this.stepRejectCounter++;
+      logger("Steps rejected (tries=".concat(_this.stepRejectCounter, ")"));
+      if (_this.stepRejectCounter >= _provider.MAX_STEP_REJECTED_ERROR) {
+        logger("The steps were rejected too many times (tries=".concat(_this.stepRejectCounter, ", limit=").concat(_provider.MAX_STEP_REJECTED_ERROR, "). Trying to catch-up."));
+        _this.throttledCatchup();
+      } else {
+        // If committing steps failed try again automatically in 1s
+        // This makes it more likely that unconfirmed steps trigger a catch-up
+        // within 15s even if there is no one editing actively (or draft sync polling)
+        // reducing the risk of data loss at the expense of step commits
+        setTimeout(function () {
+          return _this.sendStepsFromCurrentState();
+        }, 1000);
+      }
+    });
+    this.participantsService = participantsService;
+    this.analyticsHelper = analyticsHelper;
+    this.fetchCatchup = fetchCatchup;
+    this.providerEmitCallback = providerEmitCallback;
+    this.broadcastMetadata = broadcastMetadata;
+    this.broadcast = broadcast;
+    this.getUserId = getUserId;
+    this.onErrorHandled = onErrorHandled;
+    this.stepQueue = new _stepQueueState.StepQueueState();
+  }
+
+  /**
+   * Called when a metadata is changed externally from other clients/backend.
+   */
+  (0, _createClass2.default)(DocumentService, [{
+    key: "setTitle",
+    value: function setTitle(title, broadcast) {
+      if (broadcast) {
+        this.broadcastMetadata({
+          title: title
+        });
+      }
+      Object.assign(this.metadata, {
+        title: title
+      });
+    }
+  }, {
+    key: "setEditorWidth",
+    value: function setEditorWidth(editorWidth, broadcast) {
+      if (broadcast) {
+        this.broadcastMetadata({
+          editorWidth: editorWidth
+        });
+      }
+      Object.assign(this.metadata, {
+        editorWidth: editorWidth
+      });
+    }
+
+    /**
+     * Updates the local metadata and broadcasts the metadata to other clients/backend.
+     * @param metadata
+     */
+  }, {
+    key: "setMetadata",
+    value: function setMetadata(metadata) {
+      this.broadcastMetadata(metadata);
+      Object.assign(this.metadata, metadata);
+    }
+
+    /**
+     * To prevent calling catchup to often, use lodash throttle to reduce the frequency
+     */
+  }, {
+    key: "processQueue",
+    value: function processQueue() {
+      if (this.stepQueue.isPaused()) {
+        logger("Queue is paused. Aborting.");
+        return;
+      }
+      logger("Looking for processable data.");
+      if (this.stepQueue.getQueue().length > 0) {
+        var firstItem = this.stepQueue.shift();
+        var currentVersion = this.getCurrentPmVersion();
+        var expectedVersion = currentVersion + firstItem.steps.length;
+        if (firstItem.version === expectedVersion) {
+          logger("Applying data from queue!");
+          this.processSteps(firstItem);
+          // recur
+          this.processQueue();
+        }
+      }
+    }
+  }, {
+    key: "processSteps",
+    value: function processSteps(data) {
+      var _this2 = this;
+      var version = data.version,
+        steps = data.steps;
+      logger("Processing data. Version \"".concat(version, "\"."));
+      if (steps !== null && steps !== void 0 && steps.length) {
+        try {
+          var clientIds = steps.map(function (_ref8) {
+            var clientId = _ref8.clientId;
+            return clientId;
+          });
+          this.providerEmitCallback('data', {
+            json: steps,
+            version: version,
+            userIds: clientIds
+          });
+          // If steps can apply to local editor successfully, no need to accumulate the error counter.
+          this.stepRejectCounter = 0;
+          this.participantsService.emitTelepointersFromSteps(steps, this.providerEmitCallback);
+
+          // Resend local steps if none of the received steps originated with us!
+          if (clientIds.indexOf(this.clientId) === -1) {
+            setTimeout(function () {
+              return _this2.sendStepsFromCurrentState();
+            }, 100);
+          }
+        } catch (error) {
+          var _this$analyticsHelper20;
+          logger("Processing steps failed with error: ".concat(error, ". Triggering catch up call."));
+          (_this$analyticsHelper20 = this.analyticsHelper) === null || _this$analyticsHelper20 === void 0 ? void 0 : _this$analyticsHelper20.sendErrorEvent(error, 'Error while processing steps');
+          this.throttledCatchup();
+        }
+      }
+    }
+  }, {
+    key: "setup",
+    value: function setup(_ref9) {
+      var getState = _ref9.getState,
+        onSyncUpError = _ref9.onSyncUpError,
+        clientId = _ref9.clientId;
+      this.getState = getState;
+      this.onSyncUpError = onSyncUpError || noop;
+      this.clientId = clientId;
+      return this;
+    }
+
+    /**
+     * We can use this function to throttle/delay
+     * Any send steps operation
+     *
+     * The getState function will return the current EditorState
+     * from the EditorView.
+     */
+  }, {
+    key: "sendStepsFromCurrentState",
+    value: function sendStepsFromCurrentState() {
+      var _this$getState4;
+      var state = (_this$getState4 = this.getState) === null || _this$getState4 === void 0 ? void 0 : _this$getState4.call(this);
+      if (!state) {
+        return;
+      }
+      this.send(null, null, state);
+    }
+  }, {
+    key: "send",
+    value:
+    /**
+     * Send steps from transaction to other participants
+     * It needs the superfluous arguments because we keep the interface of the send API the same as the Synchrony plugin
+     */
+    function send(_tr, _oldState, newState) {
+      var unconfirmedStepsData = (0, _prosemirrorCollab.sendableSteps)(newState);
+      var version = (0, _prosemirrorCollab.getVersion)(newState);
+
+      // Don't send any steps before we're ready.
+      if (!unconfirmedStepsData) {
+        return;
+      }
+      var unconfirmedSteps = unconfirmedStepsData.steps;
+      if (!(unconfirmedSteps !== null && unconfirmedSteps !== void 0 && unconfirmedSteps.length)) {
+        return;
+      }
+
+      // Avoid reference issues using a
+      // method outside of the provider
+      // scope
+      (0, _provider.throttledCommitStep)({
+        broadcast: this.broadcast,
+        userId: this.getUserId(),
+        clientId: this.clientId,
+        steps: unconfirmedSteps,
+        version: version,
+        onStepsAdded: this.onStepsAdded,
+        onErrorHandled: this.onErrorHandled,
+        analyticsHelper: this.analyticsHelper
+      });
+    }
+  }]);
+  return DocumentService;
+}();
+exports.DocumentService = DocumentService;

package/dist/cjs/document/step-queue-state.js

@@ -0,0 +1,51 @@
+"use strict";
+
+var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefault");
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.StepQueueState = void 0;
+var _toConsumableArray2 = _interopRequireDefault(require("@babel/runtime/helpers/toConsumableArray"));
+var _classCallCheck2 = _interopRequireDefault(require("@babel/runtime/helpers/classCallCheck"));
+var _createClass2 = _interopRequireDefault(require("@babel/runtime/helpers/createClass"));
+var _defineProperty2 = _interopRequireDefault(require("@babel/runtime/helpers/defineProperty"));
+var _utils = require("../helpers/utils");
+var logger = (0, _utils.createLogger)('documentService-queue', 'black');
+var StepQueueState = /*#__PURE__*/function () {
+  function StepQueueState() {
+    var _this = this;
+    (0, _classCallCheck2.default)(this, StepQueueState);
+    (0, _defineProperty2.default)(this, "queuePaused", false);
+    (0, _defineProperty2.default)(this, "queue", []);
+    (0, _defineProperty2.default)(this, "getQueue", function () {
+      return _this.queue;
+    });
+    (0, _defineProperty2.default)(this, "filterQueue", function (condition) {
+      _this.queue = _this.queue.filter(condition);
+    });
+    (0, _defineProperty2.default)(this, "isPaused", function () {
+      return _this.queuePaused;
+    });
+    (0, _defineProperty2.default)(this, "pauseQueue", function () {
+      _this.queuePaused = true;
+    });
+    (0, _defineProperty2.default)(this, "resumeQueue", function () {
+      _this.queuePaused = false;
+    });
+    (0, _defineProperty2.default)(this, "shift", function () {
+      return _this.queue.shift();
+    });
+  }
+  (0, _createClass2.default)(StepQueueState, [{
+    key: "queueSteps",
+    value: function queueSteps(data) {
+      logger("Queueing data for version \"".concat(data.version, "\"."));
+      var orderedQueue = [].concat((0, _toConsumableArray2.default)(this.queue), [data]).sort(function (a, b) {
+        return a.version > b.version ? 1 : -1;
+      });
+      this.queue = orderedQueue;
+    }
+  }]);
+  return StepQueueState;
+}();
+exports.StepQueueState = StepQueueState;