Fix late subscription to an already broken stream (#912)

A late subscription was not receiving already cached `records` and `keys` from streams which already had received errors. This kind of behaviour makes it hard to debug issues and make tests like `stub.disconnects.test_disconnects.TestDisconnects.test_disconnect_session_on_tx_pull_after_record` flaky.

**More details**

When the you call `run` in the driver, internally the driver will send `RUN` and `PULL`, and put `ResultStreamObserver` in the `ResponseHandler` to get notified of the messages coming.
If there isn't any subscription to the `ResultStreamObserver` (i.e. `Result.then`, `Result.keys`, `Result.subscribe`, `for(const record of result)`, etc), the ResultStreamObserver will accumulate the events internally (and don't ask for more when the PULL is over).
So, when you interact with the `Result`, the subscription will be made and then the records, keys, summary and error accumulated will be informed to the observer created by the `Result`.
The problem was happening because if the error arrives while the `Result` was  not subscribed yet (for instance, the iterator was not created, which was the case in the test since I create the iterator in the first next call) the other events were not informed to the Result. This way in the case of the server disconnect after the first record be received, it could happen of you didn't get this first record if you iterate too late.

**Solution**

Moving the error notification to the end of the `ResultStreamObserver.subscribe` method solves this issue and it makes the events being informed in the correct order (in the subscribe method call).

Author: bigmontz

packages/bolt-connection/src/bolt/stream-observers.js

@@ -202,10 +202,6 @@ class ResultStreamObserver extends StreamObserver {
    * @param {function(error: Object)} observer.onError - Handle errors, should always be provided.
    */
   subscribe (observer) {
-    if (this._error) {
-      observer.onError(this._error)
-      return
-    }
     if (this._head && observer.onKeys) {
       observer.onKeys(this._head)
     }
@@ -223,6 +219,9 @@ class ResultStreamObserver extends StreamObserver {
     if (this._tail && observer.onCompleted) {
       observer.onCompleted(this._tail)
     }
+    if (this._error) {
+      observer.onError(this._error)
+    }
     this._observers.push(observer)
 
     if (this._state === _states.READY) {

packages/bolt-connection/test/bolt/stream-observer.test.js

@@ -199,6 +199,130 @@ describe('#unit ResultStreamObserver', () => {
     })
   })
 
+  it('should inform all the pre-existing events of a success stream to the subscriber', () => {
+    const streamObserver = new ResultStreamObserver()
+    const received = {
+      onCompleted: [],
+      onError: [],
+      onNext: [],
+      onKeys: []
+    }
+    const observer = {
+      onCompleted: metadata => received.onCompleted.push(metadata),
+      onError: error => received.onError.push(error),
+      onNext: record => received.onNext.push(record),
+      onKeys: keys => received.onKeys.push(keys)
+    }
+
+    streamObserver.onCompleted({ fields: ['A', 'B', 'C'] })
+
+    streamObserver.onNext([1, 2, 3])
+    streamObserver.onNext([11, 22, 33])
+    streamObserver.onNext([111, 222, 333])
+
+    streamObserver.onCompleted({ key: 42, has_more: false })
+
+    streamObserver.subscribe(observer)
+
+    expect(received.onNext.length).toEqual(3)
+    expect(received.onNext[0].toObject()).toEqual({ A: 1, B: 2, C: 3 })
+    expect(received.onNext[1].toObject()).toEqual({ A: 11, B: 22, C: 33 })
+    expect(received.onNext[2].toObject()).toEqual({ A: 111, B: 222, C: 333 })
+    expect(received.onKeys).toEqual([['A', 'B', 'C']])
+    expect(received.onCompleted).toEqual([{ key: 42, has_more: false }])
+    expect(received.onError).toEqual([])
+  })
+
+  it('should inform all the pre-existing events of a success stream to the subscriber in the correct order', () => {
+    const streamObserver = new ResultStreamObserver()
+    const received = []
+    const observer = {
+      onCompleted: metadata => received.push(metadata),
+      onError: error => received.push(error),
+      onNext: record => received.push(record),
+      onKeys: keys => received.push(keys)
+    }
+
+    streamObserver.onCompleted({ fields: ['A', 'B', 'C'] })
+
+    streamObserver.onNext([1, 2, 3])
+    streamObserver.onNext([11, 22, 33])
+    streamObserver.onNext([111, 222, 333])
+
+    streamObserver.onCompleted({ key: 42, has_more: false })
+
+    streamObserver.subscribe(observer)
+
+    expect(received.length).toEqual(5)
+    expect(received[0]).toEqual(['A', 'B', 'C'])
+    expect(received[1].toObject()).toEqual({ A: 1, B: 2, C: 3 })
+    expect(received[2].toObject()).toEqual({ A: 11, B: 22, C: 33 })
+    expect(received[3].toObject()).toEqual({ A: 111, B: 222, C: 333 })
+    expect(received[4]).toEqual({ key: 42, has_more: false })
+  })
+
+  it('should inform all the pre-existing events of an error stream to the subscriber', () => {
+    const streamObserver = new ResultStreamObserver()
+    const received = {
+      onCompleted: [],
+      onError: [],
+      onNext: [],
+      onKeys: []
+    }
+    const observer = {
+      onCompleted: metadata => received.onCompleted.push(metadata),
+      onError: error => received.onError.push(error),
+      onNext: record => received.onNext.push(record),
+      onKeys: keys => received.onKeys.push(keys)
+    }
+
+    streamObserver.onCompleted({ fields: ['A', 'B', 'C'] })
+
+    streamObserver.onNext([1, 2, 3])
+    streamObserver.onNext([11, 22, 33])
+    streamObserver.onNext([111, 222, 333])
+
+    streamObserver.onError(newError('something is on the way'))
+
+    streamObserver.subscribe(observer)
+
+    expect(received.onNext.length).toEqual(3)
+    expect(received.onNext[0].toObject()).toEqual({ A: 1, B: 2, C: 3 })
+    expect(received.onNext[1].toObject()).toEqual({ A: 11, B: 22, C: 33 })
+    expect(received.onNext[2].toObject()).toEqual({ A: 111, B: 222, C: 333 })
+    expect(received.onKeys).toEqual([['A', 'B', 'C']])
+    expect(received.onCompleted).toEqual([])
+    expect(received.onError).toEqual([newError('something is on the way')])
+  })
+
+  it('should inform all the pre-existing events of an error stream stream to the subscriber in the correct order', () => {
+    const streamObserver = new ResultStreamObserver()
+    const received = []
+    const observer = {
+      onCompleted: metadata => received.push(metadata),
+      onError: error => received.push(error),
+      onNext: record => received.push(record),
+      onKeys: keys => received.push(keys)
+    }
+
+    streamObserver.onCompleted({ fields: ['A', 'B', 'C'] })
+
+    streamObserver.onNext([1, 2, 3])
+    streamObserver.onNext([11, 22, 33])
+    streamObserver.onNext([111, 222, 333])
+
+    streamObserver.onError(newError('something is on the way'))
+
+    streamObserver.subscribe(observer)
+
+    expect(received.length).toEqual(5)
+    expect(received[0]).toEqual(['A', 'B', 'C'])
+    expect(received[1].toObject()).toEqual({ A: 1, B: 2, C: 3 })
+    expect(received[2].toObject()).toEqual({ A: 11, B: 22, C: 33 })
+    expect(received[3].toObject()).toEqual({ A: 111, B: 222, C: 333 })
+    expect(received[4]).toEqual(newError('something is on the way'))
+  })
+
   describe('when is not paused (default)', () => {
     it('should ask for more records when the stream is completed and has more', () => {
       // Setup