Method appendRevision

src/node/db/Pad.ts:280–335

* Appends a new revision * @param {Object} aChangeset The changeset to append to the pad * @param {String} authorId The id of the author * @return {Promise }

(aChangeset:string, authorId = '')

   * @return {Promise<number|string>}
   */
  async appendRevision(aChangeset:string, authorId = '') {
    // Centralised "every insert op carries an author attribute"
    // invariant. The socket handler enforces the same rule at the wire
    // boundary; checking here covers the non-wire callers (HTTP API
    // setHTML/setText/restoreRevision, plugin paths that call
    // appendRevision directly).
    Pad._assertInsertOpsCarryAuthor(aChangeset, this.pool);

    const newAText = applyToAText(aChangeset, this.atext, this.pool);
    if (newAText.text === this.atext.text && newAText.attribs === this.atext.attribs &&
        this.head !== -1) {
      return this.head;
    }
    copyAText(newAText, this.atext);

    const newRev = ++this.head;

    // ex. getNumForAuthor
    if (authorId !== '') this.pool.putAttrib(['author', authorId]);

    const hook = this.head === 0 ? 'padCreate' : 'padUpdate';
    await Promise.all([
      // @ts-ignore
      this.db.set(`pad:${this.id}:revs:${newRev}`, {
        changeset: aChangeset,
        meta: {
          author: authorId,
          timestamp: Date.now(),
          ...newRev === this.getKeyRevisionNumber(newRev) ? {
            pool: this.pool,
            atext: this.atext,
          } : {},
        },
      }),
      this.saveToDatabase(),
      authorId && authorManager.addPad(authorId, this.id),
      hooks.aCallAll(hook, {
        pad: this,
        padId: this.id,
        authorId,
        get author() {
          pad_utils.warnDeprecated(`${hook} hook author context is deprecated; use authorId instead`);
          return this.authorId;
        },
        set author(authorId) {
          pad_utils.warnDeprecated(`${hook} hook author context is deprecated; use authorId instead`);
          this.authorId = authorId;
        },
        ...this.head === 0 ? {} : {
          revs: newRev,
          changeset: aChangeset,
        },
      }),
    ]);
    return newRev;
  }

  toJSON() {