make recovery api public

Author: mafintosh

index.js

@@ -627,10 +627,19 @@ class Hypercore extends EventEmitter {
     return this.opened === false ? null : this.core.globalCache
   }
 
+  get recovering() {
+    return this.opened === false ? 0 : this.core.header.hints.recovering
+  }
+
   ready() {
     return this.opening
   }
 
+  async recover() {
+    if (this.opened === false) await this.opening
+    return this.state.waitForRecovery()
+  }
+
   async setUserData(key, value) {
     if (this.opened === false) await this.opening
     const existing = await this.getUserData(key)

lib/session-state.js

@@ -569,7 +569,7 @@ module.exports = class SessionState {
   }
 
   // simple tool to wait for other peers to catch us up
-  async _waitForRecovery() {
+  async waitForRecovery() {
     const length = this.length
     const replicator = this.core.replicator
 
@@ -607,7 +607,7 @@ module.exports = class SessionState {
   async append(values, { signature, keyPair, preappend, postappend, maxLength = -1 } = {}) {
     if (!keyPair && this.isDefault()) keyPair = this.core.header.keyPair
 
-    if (this.isDefault() && this.core.header.hints.recovering) await this._waitForRecovery()
+    if (this.isDefault() && this.core.header.hints.recovering) await this.waitForRecovery()
 
     await this.mutex.lock()
 
@@ -965,7 +965,7 @@ module.exports = class SessionState {
       throw ASSERTION('Cannot commit while repair mode is on')
     }
 
-    if (this.core.header.hints.recovering) await this._waitForRecovery()
+    if (this.core.header.hints.recovering) await this.waitForRecovery()
 
     let srcLocked = false
     await this.mutex.lock()