Method save

lib/src/resource.ts:254–285

* Commits the changes and sends the Commit to the resource's `/commit` * endpoint. Returns the new Url if succesful, throws an error if things go * wrong. If you don't pass an Agent explicitly, the default Agent of the * Store is used.

(store: Store, agent?: Agent)

   * Store is used.
   */
  async save(store: Store, agent?: Agent): Promise<string> {
    if (!agent) {
      agent = store.getAgent();
    }
    if (!agent) {
      throw new Error('No agent has been set or passed, you cannot save.');
    }
    // Cloning the CommitBuilder to prevent race conditions, and keeping a back-up of current state for when things go wrong during posting.
    const oldCommitBuilder = this.commitBuilder.clone();
    this.commitBuilder = new CommitBuilder(this.getSubject());
    const commit = await oldCommitBuilder.sign(agent.privateKey, agent.subject);
    // Add the signature to the list of applied ones, to prevent applying it again when the server
    this.appliedCommitSignatures.add(commit.signature);
    this.loading = false;
    this.new = false;
    // Instantly (optimistically) save for local usage
    // Doing this early is essential for having a snappy UX in the document editor
    store.addResource(this);
    // TODO: Check if all required props are there
    const endpoint = new URL(this.getSubject()).origin + `/commit`;
    try {
      this.commitError = null;
      await postCommit(commit, endpoint);
      return this.getSubject();
    } catch (e) {
      // If it fails, revert to the old resource with the old CommitBuilder
      this.commitBuilder = oldCommitBuilder;
      this.commitError = e;
      store.addResource(this);
      throw e;
    }
  }

  /**
   * Set a Property, Value combination and perform a validation. Will throw if