@fugle/trade-nest
A Nest module wrapper for @fugle/trade
Installation
To begin using it, we first install the required dependencies.
$ npm install --save @fugle/trade-nest @fugle/tradeGetting started
Once the installation is complete, import the FugleTradeModule into the root AppModule and run the forRoot() static method as shown below:
import { Module } from '@nestjs/common';
import { FugleTradeModule } from '@fugle/trade-nest';
@Module({
imports: [
FugleTradeModule.forRoot({
configPath: '/path/to/config.ini',
}),
],
})
export class IntradayModule {}The .forRoot() call initializes the FugleTrade client, then logs in to the remote server and connects to streamer when the onApplicationBootstrap lifecycle hook occurs.
Next, inject the FugleTrade instance using the @InjectFugleTrade() decorator.
constructor(@InjectFugleTrade() private readonly fugle: FugleTrade) {}Declarative streamer listeners
The @Streamer.On() decorator will handle any event emitted from the streamer. Additionally, we provide decorators to let you declare streamer listeners easily.
import { Injectable } from '@nestjs/common';
import { FugleTrade } from '@fugle/trade';
import { InjectFugleTrade, Streamer } from '@fugle/trade-nest';
@Injectable()
export class FugleTradeService {
constructor(@InjectFugleTrade() private readonly fugle: FugleTrade) {}
@Streamer.OnConnect()
async onConnect() {
// streamer connected
}
@Streamer.OnDisconnect()
async onDisconnect() {
// streamer disconnected
}
@Streamer.OnOrder()
async onOrder(data) {
// receive order confirmation
}
@Streamer.OnTrade()
async onTrade(data) {
// receive execution report
}
@Streamer.OnMessage()
async onMessage(data) {
// receive message from streamer
}
@Streamer.OnError()
async onError(err) {
// handle error
}
}Async configuration
When you need to pass module options asynchronously instead of statically, use the forRootAsync() method. As with most dynamic modules, Nest provides several techniques to deal with async configuration.
One technique is to use a factory function:
FugleTradeModule.forRootAsync({
useFactory: () => ({
configPath: '/path/to/config.ini',
}),
});Like other factory providers, our factory function can be async and can inject dependencies through inject.
FugleTradeModule.forRootAsync({
imports: [ConfigModule],
useFactory: async (configService: ConfigService) => ({
configPath: configService.get('FUGLE_TRADE_CONFIG_PATH'),
}),
inject: [ConfigService],
});Alternatively, you can configure the FugleTradeModule using a class instead of a factory, as shown below.
FugleTradeModule.forRootAsync({
useClass: FugleTradeConfigService,
});The construction above instantiates FugleTradeConfigService inside FugleTradeModule, using it to create an options object. Note that in this example, the FugleTradeConfigService has to implement FugleTradeModuleOptionsFactory interface as shown below. The FugleTradeModule will call the createFugleTradeOptions() method on the instantiated object of the supplied class.
@Injectable()
class FugleTradeConfigService implements FugleTradeModuleOptionsFactory {
createFugleTradeOptions(): FugleTradeModuleOptions {
return {
configPath: '/path/to/config.ini',
};
}
}If you want to reuse an existing options provider instead of creating a private copy inside the FugleTradeModule, use the useExisting syntax.
FugleTradeModule.forRootAsync({
imports: [ConfigModule],
useExisting: FugleTradeConfigService,
});