jspurefix 1.4.1 → 2.0.0

package/src/transport/fix-initiator.ts

@@ -1,5 +1,5 @@
-import { IMsgApplication } from './session-description'
-import { MsgTransport } from './msg-transport'
+import { MsgTransport } from './factory'
+import { IMsgApplication } from './msg-application'
 
 export abstract class FixInitiator {
   protected constructor (public readonly application: IMsgApplication) {

package/src/transport/fixml/fixml-msg-transmitter.ts

@@ -1,14 +1,18 @@
-import { FixmlEncoder } from '../../buffer'
+import { FixmlEncoder } from '../../buffer/fixml'
 import { IJsFixConfig } from '../../config'
 import { MsgTransmitter } from '../msg-transmitter'
 import { ILooseObject } from '../../collections/collection'
+import { inject, injectable } from 'tsyringe'
+import { DITokens } from '../../runtime/di-tokens'
+import { ElasticBuffer } from '../../buffer'
 
+@injectable()
 export class FixmlMsgTransmitter extends MsgTransmitter {
   public time: Date
 
-  constructor (public readonly config: IJsFixConfig) {
-    super(config.definitions, config.description)
-    this.encoder = new FixmlEncoder(this.buffer, config.definitions)
+  constructor (@inject(DITokens.IJsFixConfig) public readonly config: IJsFixConfig) {
+    super(config.sessionContainer.resolve<ElasticBuffer>(DITokens.TransmitBuffer), config.definitions, config.description)
+    this.encoder = config.sessionContainer.resolve<FixmlEncoder>(DITokens.MsgEncoder)
   }
 
   public encodeMessage (msgType: string, obj: ILooseObject): void {

package/src/transport/fixml/fixml-session-msg-factory.ts

@@ -1,7 +1,7 @@
-import { ISessionDescription } from './../session-description'
+import { ISessionDescription } from '../session/session-description'
 import { ILooseObject } from '../../collections/collection'
 import { MsgType } from '../../types'
-import { ASessionMsgFactory, ObjectMutator } from '../a-session-msg-factory'
+import { ASessionMsgFactory, ObjectMutator } from '../session/a-session-msg-factory'
 
 import {
   IStandardHeader,

package/src/transport/fixml/fixml-session.ts

@@ -1,9 +1,9 @@
 import { MsgView } from '../../buffer'
-import { SessionState } from '../fix-session-state'
 import { IJsFixConfig } from '../../config'
 import { UserRequestType, UserStatus } from '../../types/FIXML50SP2'
 import { MsgTag } from '../../types'
-import { FixSession } from '../fix-session'
+import { FixSession } from '../session/fix-session'
+import { SessionState } from '../session/session-state'
 
 export abstract class FixmlSession extends FixSession {
 

package/src/transport/fixml/index.ts

@@ -1,5 +1,3 @@
-export * from './acceptor'
 export * from './fixml-request'
 export * from './fixml-session'
-export * from './fixml-msg-transmitter'
 export * from './fixml-session-msg-factory'

package/src/transport/http/html-options.ts

@@ -0,0 +1,8 @@
+export interface IHtmlOptions {
+  method: string,
+  uri: string,
+  json: boolean,
+  body: any,
+  headers: any,
+  resolveWithFullResponse: boolean
+}

package/src/transport/http/html-route.ts

@@ -0,0 +1,6 @@
+import { IHtmlOptions } from './html-options'
+
+export interface IHtmlRoute {
+  name: string,
+  value: IHtmlOptions
+}

package/src/transport/http/http-acceptor-listener.ts

@@ -0,0 +1,42 @@
+import { IJsFixConfig } from '../../config'
+import { FixAcceptor } from '../fix-acceptor'
+import { HttpAcceptor } from './http-acceptor'
+import { MsgTransport } from '../factory'
+import { inject, injectable } from 'tsyringe'
+import { DITokens } from '../../runtime/di-tokens'
+import { FixSession } from '../session/fix-session'
+import { FixEntity } from '../fix-entity'
+
+@injectable()
+export class HttpAcceptorListener extends FixEntity {
+  constructor (@inject(DITokens.IJsFixConfig) public readonly config: IJsFixConfig) {
+    super(config)
+  }
+  start (): Promise<any> {
+    return new Promise<any>(async (accept, reject) => {
+      const logger = this.config.logFactory.logger('acceptor')
+      const sessionContainer = this.config.sessionContainer
+      if (!sessionContainer.isRegistered(DITokens.FixSession)) {
+        reject(new Error(`application must register a DI token '${DITokens.FixSession}' - see src/sample`))
+      }
+      logger.info('starting.')
+      const acceptor: FixAcceptor = new HttpAcceptor(this.config)
+      acceptor.on('transport', (t: MsgTransport) => {
+        logger.info(`creates new transport using DI token ${DITokens.FixSession}.`)
+        const acceptorSession = sessionContainer.resolve<FixSession>(DITokens.FixSession)
+        acceptorSession.run(t).then(() => {
+          logger.info('ends')
+          acceptor.close(() => {
+            logger.info('acceptor closed.')
+            accept(true)
+          })
+        }).catch((e: Error) => {
+          logger.error(e)
+          logger.info(e.stack)
+          reject(e)
+        })
+      })
+      acceptor.listen()
+    })
+  }
+}

package/src/transport/http/http-acceptor.ts

@@ -1,4 +1,4 @@
-import { MsgTransport } from '../msg-transport'
+import { MsgTransport } from '../factory'
 import { FixAcceptor } from '../fix-acceptor'
 import { IJsFixConfig, IJsFixLogger } from '../../config'
 import { IFixmlRequest } from '../fixml'
@@ -9,7 +9,10 @@ import * as express from 'express'
 import * as bodyParser from 'body-parser'
 import * as http from 'http'
 import { v4 as uuidv4 } from 'uuid'
+import { inject, injectable } from 'tsyringe'
+import { DITokens } from '../../runtime/di-tokens'
 
+@injectable()
 export class HttpAcceptor extends FixAcceptor {
   private app: express.Express = express()
   private server: http.Server
@@ -18,7 +21,7 @@ export class HttpAcceptor extends FixAcceptor {
   private nextId: number = 0
   private keys: Dictionary<MsgTransport> = new Dictionary()
 
-  constructor (public readonly config: IJsFixConfig) {
+  constructor (@inject(DITokens.IJsFixConfig) public readonly config: IJsFixConfig) {
     super(config.description.application)
     this.logger = config.logFactory.logger(`${config.description.application.name}:HttpAcceptor`)
     this.logger.info('creating http server')

package/src/transport/http/http-adapter.ts

@@ -0,0 +1,7 @@
+import { IHtmlOptions } from './html-options'
+
+export interface IHttpAdapter {
+  getOptions (data: Buffer): IHtmlOptions
+  beginMessage (msgType: string): void
+  endMessage (m: any): Buffer
+}

package/src/transport/http/http-initiator.ts

@@ -1,31 +1,46 @@
-import { IJsFixConfig } from '../../config'
-import { MsgTransport } from '../msg-transport'
+import { IJsFixConfig, IJsFixLogger } from '../../config'
+import { MsgTransport } from '../factory'
 import { HttpDuplex } from '../duplex'
-import { MakeFixSession } from '../make-fixl-session'
-import { FixSession } from '../fix-session'
+import { FixSession } from '../session/fix-session'
+import { inject, injectable } from 'tsyringe'
+import { DITokens } from '../../runtime/di-tokens'
+import { FixEntity } from '../fix-entity'
 
-export function httpInitiator (config: IJsFixConfig, sessionFactory: MakeFixSession): Promise<any> {
-  const initiatorSession = sessionFactory(config)
-  return once(config, initiatorSession)
-}
+@injectable()
+export class HttpInitiator extends FixEntity {
+  logger: IJsFixLogger
+  constructor (@inject(DITokens.IJsFixConfig) public readonly config: IJsFixConfig) {
+    super(config)
+    this.logger = config.logFactory.logger('initiator')
+  }
+
+  start (): Promise<any> {
+    return this.connect(this.config)
+  }
 
 // the adapter will be provided on config
-function once (config: IJsFixConfig, initiatorSession: FixSession): Promise<any> {
-  return new Promise<any>(async (accept, reject) => {
-    const logger = config.logFactory.logger('initiator')
-    const adapter = config.description.application.http.adapter
-    if (!adapter) {
-      reject('http initiator needs config.description.application.http.adapter')
-    }
-    logger.info('connecting ...')
-    const initiatorTransport: MsgTransport = new MsgTransport(0, config, new HttpDuplex(adapter))
-    logger.info('... connected, run session')
-    initiatorSession.run(initiatorTransport).then(() => {
-      logger.info('ends')
-      accept(true)
-    }).catch((e: Error) => {
-      logger.error(e)
-      reject(e)
+  connect (config: IJsFixConfig): Promise<any> {
+    return new Promise<any>(async (accept, reject) => {
+      const adapter = config.description.application.http.adapter
+      if (!adapter) {
+        reject('http initiator needs config.description.application.http.adapter')
+      }
+      const sessionContainer = this.config.sessionContainer
+      if (!sessionContainer.isRegistered(DITokens.FixSession)) {
+        reject(new Error(`application must register a DI token '${DITokens.FixSession}' - see src/sample`))
+      }
+      this.logger.info(`create session with DI Token ${DITokens.FixSession}`)
+      const initiatorSession = sessionContainer.resolve<FixSession>(DITokens.FixSession)
+      this.logger.info('connecting ...')
+      const initiatorTransport: MsgTransport = new MsgTransport(0, config, new HttpDuplex(adapter))
+      this.logger.info('... connected, run session')
+      initiatorSession.run(initiatorTransport).then(() => {
+        this.logger.info('ends')
+        accept(true)
+      }).catch((e: Error) => {
+        this.logger.error(e)
+        reject(e)
+      })
     })
-  })
+  }
 }

package/src/transport/http/http-json-sample-adapter.ts

@@ -1,14 +1,19 @@
 import { IJsFixConfig, IJsFixLogger } from '../../config'
-import { IHtmlOptions, IHtmlRoute, IHttpAdapter } from '../session-description'
 import { HttpTransaction } from './http-transaction'
 import { Dictionary } from '../../collections'
+import { IHttpAdapter } from './http-adapter'
+import { IHtmlRoute } from './html-route'
+import { IHtmlOptions } from './html-options'
+import { inject, injectable } from 'tsyringe'
+import { DITokens } from '../../runtime/di-tokens'
 
+@injectable()
 export class HttpJsonSampleAdapter implements IHttpAdapter {
   private logger: IJsFixLogger
   private queue: HttpTransaction[] = []
   private token: string = null
   private routes: Dictionary<IHtmlRoute> = new Dictionary()
-  constructor (public readonly config: IJsFixConfig) {
+  constructor (@inject(DITokens.IJsFixConfig) public readonly config: IJsFixConfig) {
     this.logger = config.logFactory.logger('http.adapter')
     const routes = this.routes
     const options = config.description.application.http.options

package/src/transport/http/http-transaction.ts

@@ -1,4 +1,4 @@
-import { IHtmlOptions } from '../session-description'
+import { IHtmlOptions } from './html-options'
 
 export class HttpTransaction {
   constructor (public readonly msgType: string,

package/src/transport/http/http-transport-description.ts

@@ -0,0 +1,9 @@
+import { IHtmlRoute } from './html-route'
+import { IHttpAdapter } from './http-adapter'
+
+export interface IHttpTransportDescription {
+  readonly port: number
+  readonly uri: string,
+  readonly options: IHtmlRoute[]
+  adapter: IHttpAdapter
+}

package/src/transport/http/index.ts

@@ -2,3 +2,4 @@ export * from './http-acceptor'
 export * from './http-initiator'
 export * from './http-json-sample-adapter'
 export * from './http-transaction'
+export * from './http-acceptor-listener'

package/src/transport/index.ts

@@ -1,15 +1,16 @@
-export * from './tcp'
-export * from './http'
-export * from './ascii'
 export * from './duplex'
-export * from './a-session-msg-factory'
-export * from './make-config'
+export * from './fix-entity'
+export * from './session/a-session-msg-factory'
 export * from './fix-acceptor'
 export * from './fix-initiator'
-export * from './fix-msg-factory'
-export * from './fix-session'
-export * from './fix-session-state'
+export * from './session/session-msg-factory'
+export * from './session/fix-session'
+export * from './session/session-state'
+export * from './session/fix-session-state'
 export * from './msg-transmitter'
-export * from './msg-transport'
 export * from './msg-payload'
-export * from './session-description'
+export * from './session/session-description'
+export * from './tick-action'
+export * from './session/make-fix-session'
+export * from './msg-application'
+export * from './ascii/ascii-session'

package/src/transport/msg-application.ts

@@ -0,0 +1,13 @@
+import { ITcpTransportDescription } from './tcp/tcp-transport-description'
+import { IHttpTransportDescription } from './http/http-transport-description'
+
+export interface IMsgApplication {
+  readonly name: string
+  readonly type: string,
+  readonly resilient: boolean
+  readonly reconnectSeconds: number
+  readonly tcp?: ITcpTransportDescription,
+  readonly http?: IHttpTransportDescription,
+  readonly protocol: string,
+  readonly dictionary: string
+}

package/src/transport/msg-transmitter.ts

@@ -1,17 +1,17 @@
 import { MsgEncoder, ElasticBuffer } from '../buffer'
-import { FixDefinitions } from '../dictionary'
+import { FixDefinitions } from '../dictionary/definition'
 import { Transform } from 'stream'
 import { MsgPayload } from './msg-payload'
 import { ILooseObject } from '../collections/collection'
-import { ISessionDescription } from './session-description'
+import { ISessionDescription } from './session/session-description'
 import * as events from 'events'
 
 export abstract class MsgTransmitter extends events.EventEmitter {
   public readonly encodeStream: Transform
-  public readonly buffer: ElasticBuffer = new ElasticBuffer(10 * 1024)
-  protected encoder: MsgEncoder
+  public encoder: MsgEncoder
 
-  protected constructor (public readonly definitions: FixDefinitions,
+  protected constructor (public readonly buffer: ElasticBuffer,
+                         public readonly definitions: FixDefinitions,
                          public readonly session: ISessionDescription) {
     super()
     this.encodeStream = this.encoderStream()

package/src/transport/{a-session-msg-factory.ts → session/a-session-msg-factory.ts}

@@ -1,7 +1,7 @@
-import { ISessionMsgFactory } from './fix-msg-factory'
+import { ISessionMsgFactory } from './session-msg-factory'
 import { ISessionDescription } from './session-description'
-import { ILooseObject } from '../collections/collection'
-import { MsgType } from '../types'
+import { ILooseObject } from '../../collections/collection'
+import { MsgType } from '../../types'
 
 import {
   IHeartbeat,
@@ -11,7 +11,7 @@ import {
   IStandardHeader,
   IStandardTrailer,
   ITestRequest
-} from '../types/FIX4.4/repo'
+} from '../../types/FIX4.4/repo'
 
 export interface ObjectMutator { (description: ISessionDescription, type: string, o: ILooseObject): ILooseObject
 }

package/src/transport/session/fix-session-state-args.ts

@@ -0,0 +1,9 @@
+import { SessionState } from './session-state'
+
+export interface IFixSessionStateArgs {
+  heartBeat: number
+  state?: SessionState
+  waitLogoutConfirmSeconds?: number
+  stopSeconds?: number
+  lastPeerMsgSeqNum?: number
+}

package/src/transport/{fix-session-state.ts → session/fix-session-state.ts}

@@ -1,48 +1,8 @@
-import { ElasticBuffer } from '../buffer'
+import { ElasticBuffer } from '../../buffer'
 import moment = require('moment')
-
-export enum SessionState {
-  DisconnectedNoConnectionToday = 1,
-  DisconnectedConnectionToday = 2,
-  DetectBrokenNetworkConnection = 3,
-  AwaitingConnection = 4,
-  InitiateConnection = 5,
-  NetworkConnectionEstablished = 6,
-  InitiationLogonSent = 7,
-  InitiationLogonReceived = 8,
-  InitiationLogonResponse = 9,
-  HandleResendRequest = 10,
-  ReceiveMsgSeqNumTooHigh = 11,
-  AwaitingProcessingResponseToResendRequest = 12,
-  NoMessagesReceivedInInterval = 13,
-  AwaitingProcessingResponseToTestRequest = 14,
-  ReceiveLogout = 15,
-  InitiateLogout = 16,
-  ActiveNormalSession = 17,
-  WaitingForALogon = 18,
-  PeerLogonRejected = 20,
-  WaitingLogoutConfirm = 21,
-  ConfirmingLogout = 22,
-  Stopped = 23,
-  Idle = 24
-}
-
-export enum TickAction {
-  Nothing = 1,
-  Heartbeat = 2,
-  TestRequest = 3,
-  TerminateOnError = 4,
-  WaitLogoutConfirmExpired = 5,
-  Stop = 6
-}
-
-interface IFixSessionStateArgs {
-  heartBeat: number
-  state?: SessionState
-  waitLogoutConfirmSeconds?: number
-  stopSeconds?: number
-  lastPeerMsgSeqNum?: number
-}
+import { TickAction } from '../tick-action'
+import { IFixSessionStateArgs } from './fix-session-state-args'
+import { SessionState } from './session-state'
 
 export class FixSessionState {
   public nextTickAction: TickAction = TickAction.Nothing

package/src/transport/{fix-session.ts → session/fix-session.ts}

@@ -1,11 +1,13 @@
-import { ElasticBuffer, MsgView, SegmentType } from '../buffer'
-import { IJsFixConfig, IJsFixLogger } from '../config'
-import { FixSessionState, SessionState } from './fix-session-state'
-import { MsgTransport } from './msg-transport'
-import { MsgTag } from '../types'
-import { ILooseObject } from '../collections/collection'
+import { ElasticBuffer, MsgView } from '../../buffer'
+import { IJsFixConfig, IJsFixLogger } from '../../config'
+import { FixSessionState } from './fix-session-state'
+import { MsgTransport } from '../factory'
+import { MsgTag } from '../../types'
+import { ILooseObject } from '../../collections/collection'
 
 import * as events from 'events'
+import { SessionState } from './session-state'
+import { SegmentType } from '../../buffer/segment/segment-type'
 
 export abstract class FixSession extends events.EventEmitter {
   public logReceivedMsgs: boolean = false
@@ -305,7 +307,8 @@ export abstract class FixSession extends events.EventEmitter {
       clearInterval(this.timer)
     }
     this.transport = null
-    this.sessionState.reset(true) // from header def ... eventually
+    const resetSeqNum = this.config.description.ResetSeqNumFlag || true
+    this.sessionState.reset(resetSeqNum) // from header def ... eventually
     this.setState(SessionState.NetworkConnectionEstablished)
   }
 

package/src/transport/{make-fixl-session.ts → session/make-fix-session.ts}

@@ -1,4 +1,4 @@
-import { IJsFixConfig } from '../config'
+import { IJsFixConfig } from '../../config'
 import { FixSession } from './fix-session'
 
 export interface MakeFixSession { (config: IJsFixConfig): FixSession

package/src/transport/session/session-description.ts

@@ -0,0 +1,18 @@
+import { IMsgApplication } from '../msg-application'
+
+export interface ISessionDescription {
+  readonly application?: IMsgApplication
+  readonly Name: string
+  readonly Username: string
+  readonly Password: string
+  HeartBtInt: number
+  readonly SenderCompId: string
+  readonly TargetCompID: string
+  readonly ResetSeqNumFlag: boolean
+  readonly LastSentSeqNum?: number
+  readonly LastReceivedSeqNum?: number
+  readonly SenderSubID: string
+  readonly TargetSubID: string
+  readonly BeginString: string
+  readonly BodyLengthChars?: number,
+}

package/src/transport/{fix-msg-factory.ts → session/session-msg-factory.ts}

@@ -1,5 +1,5 @@
-import { ILooseObject } from '../collections/collection'
-import { IStandardHeader } from '../types/FIX4.4/repo'
+import { ILooseObject } from '../../collections/collection'
+import { IStandardHeader } from '../../types/FIX4.4/repo'
 import { ISessionDescription } from './session-description'
 
 export interface ISessionMsgFactory {

package/src/transport/session/session-state.ts

@@ -0,0 +1,25 @@
+export enum SessionState {
+  DisconnectedNoConnectionToday = 1,
+  DisconnectedConnectionToday = 2,
+  DetectBrokenNetworkConnection = 3,
+  AwaitingConnection = 4,
+  InitiateConnection = 5,
+  NetworkConnectionEstablished = 6,
+  InitiationLogonSent = 7,
+  InitiationLogonReceived = 8,
+  InitiationLogonResponse = 9,
+  HandleResendRequest = 10,
+  ReceiveMsgSeqNumTooHigh = 11,
+  AwaitingProcessingResponseToResendRequest = 12,
+  NoMessagesReceivedInInterval = 13,
+  AwaitingProcessingResponseToTestRequest = 14,
+  ReceiveLogout = 15,
+  InitiateLogout = 16,
+  ActiveNormalSession = 17,
+  WaitingForALogon = 18,
+  PeerLogonRejected = 20,
+  WaitingLogoutConfirm = 21,
+  ConfirmingLogout = 22,
+  Stopped = 23,
+  Idle = 24
+}

package/src/transport/tcp/index.ts

@@ -1,5 +1,6 @@
 export * from './recovering-tcp-initiator'
 export * from './tcp-initiator'
 export * from './tcp-acceptor'
-export * from './initiator'
-export * from './acceptor'
+export * from './tcp-initiator-connector'
+export * from './tcp-acceptor-listener'
+export * from '../session/session-state'

package/src/transport/tcp/recovering-tcp-initiator.ts

@@ -1,12 +1,14 @@
-import { IMsgApplication, ITcpTransportDescription } from '../session-description'
 import { IJsFixConfig, IJsFixLogger } from '../../config'
-import { MakeFixSession } from '../make-fixl-session'
-import { FixSession } from '../fix-session'
-import { SessionState } from '../fix-session-state'
+import { FixSession } from '../session/fix-session'
 import { TcpInitiator } from './tcp-initiator'
-import { MsgTransport } from '../msg-transport'
-import * as events from 'events'
+import { MsgTransport } from '../factory'
 import Timeout = NodeJS.Timeout
+import { SessionState } from '../session/session-state'
+import { inject, injectable } from 'tsyringe'
+import { DITokens } from '../../runtime/di-tokens'
+import { ITcpTransportDescription } from './tcp-transport-description'
+import { IMsgApplication } from '../msg-application'
+import { FixEntity } from '../fix-entity'
 
 /*
    create one application session instance - and recover a lost transport.  Hence the application
@@ -14,7 +16,8 @@ import Timeout = NodeJS.Timeout
    last known sequence number or sequence reset.
  */
 
-export class RecoveringTcpInitiator extends events.EventEmitter {
+@injectable()
+export class RecoveringTcpInitiator extends FixEntity {
   public tcp: ITcpTransportDescription
   public session: FixSession
   private readonly logger: IJsFixLogger
@@ -25,8 +28,8 @@ export class RecoveringTcpInitiator extends events.EventEmitter {
   public recoveryAttemptSecs: number = 5
   public backoffFailConnectSecs: number = 30
 
-  constructor (public readonly jsFixConfig: IJsFixConfig, public readonly sessionFactory: MakeFixSession) {
-    super()
+  constructor (@inject(DITokens.IJsFixConfig) public readonly jsFixConfig: IJsFixConfig) {
+    super(jsFixConfig)
     this.application = this.jsFixConfig.description.application
     this.logger = jsFixConfig.logFactory.logger(`${this.application.name}:RecoveringTcpInitiator`)
     if (!this.application) {
@@ -40,12 +43,12 @@ export class RecoveringTcpInitiator extends events.EventEmitter {
       this.logger.error(e)
       throw e
     }
-    this.createSession(jsFixConfig, sessionFactory)
+    this.createSession(jsFixConfig)
   }
 
-  private createSession (jsFixConfig: IJsFixConfig, sessionFactory: MakeFixSession) {
-    this.logger.info('creating an application session')
-    this.session = sessionFactory(jsFixConfig)
+  private createSession (jsFixConfig: IJsFixConfig) {
+    this.logger.info(`creating an application session with DI token ${DITokens.FixSession}.`)
+    this.session = jsFixConfig.sessionContainer.resolve<FixSession>(DITokens.FixSession)
     this.session.on('done', () => {
       this.logger.info('session has permanently ended')
       this.emit('end', this)
@@ -66,6 +69,10 @@ export class RecoveringTcpInitiator extends events.EventEmitter {
     this.emit('transport', transport)
     this.logger.info(`initiator connects id ${(transport.id)}`)
     const session = this.session
+    if (this.jsFixConfig.description.ResetSeqNumFlag) {
+      this.logger.info('reset sequence numbers')
+      session.reset()
+    }
     session.setState(SessionState.NetworkConnectionEstablished)
     session.run(transport).then((id: number) => {
       if (!transport || id === transport.id) {
@@ -108,6 +115,10 @@ export class RecoveringTcpInitiator extends events.EventEmitter {
     },this.recoveryAttemptSecs * 1000)
   }
 
+  public start (): Promise<any> {
+    return this.run()
+  }
+
   // for first connection - reject if no initial connection established within timeout
   // once connection established, will not resolve until session is ended - i.e. lost
   // connections are re-established using the same session instance.