@quantform/core 0.3.267 → 0.4.5

package/src/adapter/paper/paper-adapter.spec.ts

@@ -1,12 +1,10 @@
 import { PaperSpotSimulator } from '.';
 import { AdapterContext } from '..';
-import { Store } from '../../store';
+import { InstrumentPatchEvent, Store } from '../../store';
 import { Adapter } from '../adapter';
-import { PaperSimulator } from './simulator/paper-simulator';
+import { Asset, Commission, instrumentOf, Order } from './../../domain';
 import { PaperAdapter } from './paper-adapter';
-import { Order, Asset, Commission, assetOf } from './../../domain';
-import { instrumentOf } from './../../domain/instrument';
-import { BalancePatchEvent, InstrumentPatchEvent } from '../../store/event';
+import { PaperSimulator } from './simulator/paper-simulator';
 
 class DefaultAdapter extends Adapter {
   name = 'default';

package/src/adapter/paper/paper-adapter.ts

@@ -1,12 +1,10 @@
 import { Adapter, AdapterContext } from '..';
-import { Store } from '../../store';
-import { PaperSimulator } from './simulator/paper-simulator';
 import { assetOf, Candle, InstrumentSelector, Order } from '../../domain';
-import { BalancePatchEvent } from '../../store/event';
-import { Feed } from 'src/storage';
+import { BalancePatchEvent, Store } from '../../store';
 import { FeedQuery, HistoryQuery } from '../adapter';
+import { PaperSimulator } from './simulator/paper-simulator';
 
-export class PaperOptions {
+export interface PaperOptions {
   balance: { [key: string]: number };
 }
 

package/src/adapter/paper/simulator/paper-margin-simulator.ts

@@ -1,5 +1,6 @@
-import { pnl, weightedMean } from '../../../shared';
+import { PaperAdapter } from '..';
 import { Order } from '../../../domain';
+import { pnl, weightedMean } from '../../../shared';
 import {
   BalanceTransactEvent,
   OrderCanceledEvent,
@@ -8,8 +9,7 @@ import {
   OrderNewEvent,
   OrderPendingEvent,
   PositionPatchEvent
-} from '../../../store/event';
-import { PaperAdapter } from '..';
+} from '../../../store';
 import { PaperSimulator } from './paper-simulator';
 
 export class PaperMarginSimulator extends PaperSimulator {

package/src/adapter/paper/simulator/paper-simulator.ts

@@ -1,7 +1,7 @@
-import { tap } from 'rxjs/operators';
-import { Component, InstrumentSelector, Order, Orderbook, Trade } from '../../../domain';
-import { PaperAdapter } from '..';
+import { tap } from 'rxjs';
 import { Set } from 'typescript-collections';
+import { PaperAdapter } from '..';
+import { Component, InstrumentSelector, Order, Orderbook, Trade } from '../../../domain';
 
 export abstract class PaperSimulator {
   private readonly pending: Record<string, Set<Order>> = {};

package/src/adapter/paper/simulator/paper-spot-simulator.spec.ts

@@ -1,23 +1,22 @@
-import { Adapter, AdapterContext } from './../../adapter';
+import { PaperAdapter } from '../paper-adapter';
+import {
+  Asset,
+  assetOf,
+  Commission,
+  commissionPercentOf,
+  instrumentOf,
+  Order
+} from './../../../domain';
 import {
   BalancePatchEvent,
   InstrumentPatchEvent,
   InstrumentSubscriptionEvent,
-  OrderbookPatchEvent,
+  Store,
   TradePatchEvent
-} from './../../../store/event';
-import { Store } from './../../../store';
+} from './../../../store';
+import { Adapter, AdapterContext } from './../../adapter';
 import { PaperSimulator } from './paper-simulator';
-import { PaperAdapter } from '../paper-adapter';
 import { PaperSpotSimulator } from './paper-spot-simulator';
-import {
-  Asset,
-  Commission,
-  Order,
-  instrumentOf,
-  assetOf,
-  commissionPercentOf
-} from './../../../domain';
 
 class DefaultAdapter extends Adapter {
   name = 'default';

package/src/adapter/paper/simulator/paper-spot-simulator.ts

@@ -1,4 +1,6 @@
-import { Order, Orderbook } from '../../../domain';
+import { PaperAdapter } from '..';
+import { Order } from '../../../domain';
+import { timestamp } from '../../../shared';
 import {
   BalanceFreezEvent,
   BalanceTransactEvent,
@@ -8,10 +10,8 @@ import {
   OrderFilledEvent,
   OrderNewEvent,
   OrderPendingEvent
-} from '../../../store/event';
-import { PaperAdapter } from '..';
+} from '../../../store';
 import { PaperSimulator } from './paper-simulator';
-import { timestamp } from '../../../shared';
 
 export class PaperSpotSimulator extends PaperSimulator {
   constructor(readonly adapter: PaperAdapter) {

package/src/bootstrap.ts

@@ -1,10 +1,10 @@
 import {
+  AdapterAggregate,
   BacktesterAdapter,
   BacktesterListener,
-  BacktesterStreamer
-} from './adapter/backtester';
-import { AdapterAggregate } from './adapter';
-import { PaperAdapter } from './adapter/paper';
+  BacktesterStreamer,
+  PaperAdapter
+} from './adapter';
 import { Session, SessionDescriptor } from './domain';
 import { Store } from './store';
 

package/src/domain/balance.ts

@@ -1,7 +1,7 @@
 import { timestamp } from '../shared';
 import { Asset } from './';
-import { Position, PositionMode } from './position';
 import { Component } from './component';
+import { Position, PositionMode } from './position';
 
 /**
  * Represents single asset balance in your wallet.

package/src/domain/candle.spec.ts

@@ -1,9 +1,7 @@
-import { from } from 'rxjs';
-import { map } from 'rxjs/operators';
-import { TradePatchEvent } from '../store/event';
+import { from, map } from 'rxjs';
 import { now } from '../shared';
-import { Candle } from './candle';
-import { mergeCandle } from './candle-builder';
+import { TradePatchEvent } from '../store';
+import { Candle, mergeCandle } from './candle';
 import { instrumentOf } from './instrument';
 import { Timeframe } from './timeframe';
 

package/src/domain/candle.ts

@@ -1,4 +1,16 @@
+import {
+  concat,
+  filter,
+  last,
+  map,
+  mergeMap,
+  Observable,
+  share,
+  skipLast,
+  withLatestFrom
+} from 'rxjs';
 import { timestamp } from '../shared';
+import { tf } from './timeframe';
 
 export class Candle {
   constructor(
@@ -15,3 +27,94 @@ export class Candle {
     this.close = value;
   }
 }
+
+export class CandleBuilder {
+  private _candle: Candle;
+
+  get candle(): Candle {
+    return this._candle;
+  }
+
+  constructor(readonly timeframe: number) {}
+
+  append(value: number, timestamp: timestamp): Candle {
+    const frame = tf(timestamp, this.timeframe);
+
+    if (!this._candle) {
+      this._candle = new Candle(frame, value, value, value, value);
+
+      return null;
+    }
+
+    if (this.candle.timestamp == frame) {
+      this.candle.apply(value);
+
+      return null;
+    }
+
+    const previous = this._candle;
+
+    this._candle = new Candle(frame, value, value, value, value);
+    return previous;
+  }
+}
+
+export function candle<T extends { timestamp: number }>(
+  timeframe: number,
+  fn: (x: T) => number
+) {
+  return function (source: Observable<T>): Observable<Candle> {
+    const builder = new CandleBuilder(timeframe);
+    let candle: Candle;
+
+    return source.pipe(
+      filter(it => {
+        return (candle = builder.append(fn(it), it.timestamp)) != null;
+      }),
+      map(_ => candle),
+      share()
+    );
+  };
+}
+
+export function mergeCandle<T extends { timestamp: number }>(
+  timeframe: number,
+  fn: (x: T) => number,
+  history$: Observable<Candle>
+) {
+  return function (source$: Observable<T>): Observable<Candle> {
+    const builder = new CandleBuilder(timeframe);
+    let hasMergedHistory = false;
+
+    return concat(
+      history$.pipe(skipLast(1)),
+      source$.pipe(
+        withLatestFrom(history$.pipe(last())),
+        mergeMap(([it, history]) => {
+          const completed = builder.append(fn(it), it.timestamp);
+
+          if (completed) {
+            if (completed.timestamp == history.timestamp) {
+              completed.open = history.open;
+              completed.high = Math.max(completed.high, history.high);
+              completed.low = Math.min(completed.low, history.low);
+
+              hasMergedHistory = true;
+            } else if (completed.timestamp > history.timestamp) {
+              if (!hasMergedHistory) {
+                hasMergedHistory = true;
+                return [history, completed];
+              }
+            } else if (completed.timestamp < history.timestamp) {
+              throw new Error('invalid candle sequence, input data is to old.');
+            }
+
+            return [completed];
+          }
+
+          return [];
+        })
+      )
+    );
+  };
+}

package/src/domain/index.ts

@@ -1,15 +1,13 @@
 export * from './asset';
-export * from './instrument';
 export * from './balance';
-export * from './order';
-export * from './orderbook';
+export * from './candle';
 export * from './commission';
 export * from './component';
-export * from './candle';
-export * from './candle-builder';
-export * from './timeframe';
+export * from './instrument';
+export * from './order';
+export * from './orderbook';
 export * from './position';
-export * from './trade';
 export * from './session';
-export * from './session-descriptor';
 export * from './statement';
+export * from './timeframe';
+export * from './trade';

package/src/domain/order.ts

@@ -1,7 +1,7 @@
-import { Component } from './component';
 import { v4 } from 'uuid';
-import { InstrumentSelector } from './instrument';
 import { timestamp } from '../shared';
+import { Component } from './component';
+import { InstrumentSelector } from './instrument';
 
 export type OrderSide = 'SELL' | 'BUY';
 export type OrderType = 'MARKET' | 'LIMIT' | 'STOP-MARKET' | 'STOP-LIMIT';

package/src/domain/orderbook.ts

@@ -1,5 +1,5 @@
-import { timestamp } from '../shared';
 import { Instrument } from '../domain';
+import { timestamp } from '../shared';
 import { Component } from './component';
 
 /**

package/src/domain/position.ts

@@ -1,8 +1,7 @@
+import { map, Observable, share } from 'rxjs';
 import { Instrument } from '../domain';
-import { Component } from './component';
 import { pnl, timestamp, weightedMean } from '../shared';
-import { Observable } from 'rxjs';
-import { map, share } from 'rxjs/operators';
+import { Component } from './component';
 
 export type PositionMode = 'CROSS' | 'ISOLATED';
 

package/src/domain/session.spec.ts

@@ -1,8 +1,8 @@
-import { InstrumentPatchEvent } from '../store/event';
+import { Bootstrap } from '../bootstrap';
 import { Asset, Commission } from '../domain';
 import { now } from '../shared';
-import { SessionDescriptor } from './session-descriptor';
-import { Bootstrap } from '../bootstrap';
+import { InstrumentPatchEvent } from '../store';
+import { SessionDescriptor } from './session';
 
 describe('session tests', () => {
   const descriptor: SessionDescriptor = {

package/src/domain/session.ts

@@ -1,14 +1,21 @@
 import {
+  concat,
   distinctUntilChanged,
   filter,
+  from,
   map,
   mergeMap,
+  Observable,
   share,
   shareReplay,
   startWith,
+  Subject,
+  Subscription,
   switchMap,
   take
-} from 'rxjs/operators';
+} from 'rxjs';
+import { Adapter, BacktesterOptions, PaperOptions } from '../adapter';
+import { AdapterAggregate } from '../adapter/adapter-aggregate';
 import {
   AssetSelector,
   Balance,
@@ -16,19 +23,65 @@ import {
   Instrument,
   InstrumentSelector,
   Order,
-  Position,
   Orderbook,
-  OrderState
+  OrderState,
+  Position
 } from '../domain';
-import { Store } from '../store';
-import { concat, from, Observable, Subject, Subscription } from 'rxjs';
-import { AdapterAggregate } from '../adapter/adapter-aggregate';
-import { Worker, now } from '../shared';
 import { Trade } from '../domain/trade';
-import { SessionDescriptor } from './session-descriptor';
+import { now, Worker } from '../shared';
+import { Feed, Measurement } from '../storage';
+import { Store } from '../store';
 
 type Optional<T, K extends keyof T> = Omit<T, K> & Partial<T>;
 
+/**
+ * Describes a single session.
+ * You can use @run function to start a new session managed by CLI.
+ * To start managed session you should install @quantform/cli package and run
+ * specific command:
+ *  - qf paper (to paper trade strategy)
+ *  - qf backtest (to backtest strategy based on provided feed)
+ *  - qf live (to live trade strategy)
+ * or run on your own in code:
+ *  - paper(descriptor, options)
+ *  - backtest(descriptor, options)
+ *  - live(descriptor)
+ */
+export interface SessionDescriptor {
+  /**
+   * Unique session identifier, used to identify session in the storage.
+   * You can generate new id every time you start the new session or provide
+   * session id explicitly to resume previous session (in code or via CLI).
+   * If you don't provide session id, it will generate new one based on time.
+   */
+  id?: number;
+
+  /**
+   * Collection of adapters used to connect to the exchanges.
+   */
+  adapter: Adapter[];
+
+  /**
+   * Provides historical data for backtest, it's not required for live and paper
+   * sessions.
+   */
+  feed?: Feed;
+
+  /**
+   * Stores session variables i.e. indicators, orders, or any other type of time
+   * series data. You can install @quantform/editor to render this data in your browser.
+   */
+  measurement?: Measurement;
+
+  /**
+   * Session additional options.
+   */
+  options?: {
+    backtester?: BacktesterOptions;
+    paper?: PaperOptions;
+  };
+}
+
 export class Session {
   private initialized = false;
   private subscription: Subscription;

package/src/domain/statement.ts

@@ -1,6 +1,5 @@
-import { Session } from '.';
-import { InstrumentSelector } from '.';
 import { combineLatest, finalize, map, take, tap } from 'rxjs';
+import { InstrumentSelector, Session } from '.';
 import { drawdown } from '../indicator';
 import { floor, precision } from '../shared';
 

package/src/domain/trade.ts

@@ -1,5 +1,5 @@
-import { timestamp } from '../shared';
 import { Instrument } from '.';
+import { timestamp } from '../shared';
 import { Component } from './component';
 
 /**

package/src/index.ts

@@ -1,11 +1,8 @@
-export * from './shared';
-export * from './domain';
 export * from './adapter';
-export * from './adapter/backtester';
-export * from './adapter/paper';
+export * from './bootstrap';
+export * from './domain';
 export * from './indicator';
+export * from './ipc';
+export * from './shared';
 export * from './storage';
 export * from './store';
-export * from './store/event';
-export * from './bootstrap';
-export * from './ipc';

package/src/indicator/atr.ts

@@ -1,5 +1,4 @@
-import { Observable } from 'rxjs';
-import { share, map } from 'rxjs/operators';
+import { map, Observable, share } from 'rxjs';
 import { Candle } from '../domain';
 import { rma } from './rma';
 import { truerange } from './truerange';

package/src/indicator/cross.ts

@@ -1,8 +1,7 @@
-import { Observable } from 'rxjs';
-import { filter } from 'rxjs/operators';
+import { filter, Observable } from 'rxjs';
 
 export function crossunder<T>(limitFn: (it: T) => number, currentFn: (it: T) => number) {
-  return function(source: Observable<T>): Observable<T> {
+  return function (source: Observable<T>): Observable<T> {
     let triggered = false;
 
     return source.pipe(
@@ -27,7 +26,7 @@ export function crossunder<T>(limitFn: (it: T) => number, currentFn: (it: T) =>
 }
 
 export function crossover<T>(limitFn: (it: T) => number, currentFn: (it: T) => number) {
-  return function(source: Observable<T>): Observable<T> {
+  return function (source: Observable<T>): Observable<T> {
     let triggered = false;
 
     return source.pipe(

package/src/indicator/donchian.ts

@@ -1,7 +1,6 @@
-import { Observable, withLatestFrom } from 'rxjs';
-import { map, share } from 'rxjs/operators';
-import { minMax } from './min-max';
+import { map, Observable, share, withLatestFrom } from 'rxjs';
 import { Candle } from '../domain';
+import { minMax } from './min-max';
 
 export function donchian<T>(length: number, fn: (it: T) => Candle) {
   return function (source: Observable<T>): Observable<

package/src/indicator/drawdown.ts

@@ -1,8 +1,7 @@
-import { Observable } from 'rxjs';
-import { map, share } from 'rxjs/operators';
+import { map, Observable, share } from 'rxjs';
 
 export function drawdown<T>(fn: (it: T) => number) {
-  return function(source: Observable<T>): Observable<number> {
+  return function (source: Observable<T>): Observable<number> {
     let rate;
     let max = 0;
 

package/src/indicator/ema.ts

@@ -1,5 +1,4 @@
-import { Observable } from 'rxjs';
-import { map, share } from 'rxjs/operators';
+import { map, Observable, share } from 'rxjs';
 import { sma } from './sma';
 
 export function ema<T>(length: number, fn: (it: T) => number) {

package/src/indicator/envelope.ts

@@ -1,5 +1,4 @@
-import { Observable } from 'rxjs';
-import { map, share } from 'rxjs/operators';
+import { map, Observable, share } from 'rxjs';
 import { sma } from './sma';
 
 export function envelope<T>(length: number, percent: number, valueFn: (it: T) => number) {

package/src/indicator/index.ts

@@ -1,4 +1,7 @@
+export * from './atr';
 export * from './cross';
+export * from './donchian';
+export * from './drawdown';
 export * from './ema';
 export * from './envelope';
 export * from './macd';
@@ -12,6 +15,3 @@ export * from './trailing';
 export * from './truerange';
 export * from './window';
 export * from './wma';
-export * from './donchian';
-export * from './atr';
-export * from './drawdown';

package/src/indicator/macd.ts

@@ -1,5 +1,4 @@
-import { Observable, withLatestFrom } from 'rxjs';
-import { map, share } from 'rxjs/operators';
+import { map, Observable, share, withLatestFrom } from 'rxjs';
 import { ema } from './ema';
 
 export function macd<T>(

package/src/indicator/min-max.ts

@@ -1,5 +1,4 @@
-import { Observable } from 'rxjs';
-import { filter, map, share } from 'rxjs/operators';
+import { filter, map, Observable, share } from 'rxjs';
 import { window } from './window';
 
 export function minMax<T>(length: number, fn: (it: T) => number) {

package/src/indicator/rma.ts

@@ -1,5 +1,4 @@
-import { Observable } from 'rxjs';
-import { map, share } from 'rxjs/operators';
+import { map, Observable, share } from 'rxjs';
 import { sma } from '.';
 
 export function rma<T>(length: number, fn: (it: T) => number) {

package/src/indicator/sma.ts

@@ -1,5 +1,4 @@
-import { Observable, tap } from 'rxjs';
-import { filter, map, share } from 'rxjs/operators';
+import { filter, map, Observable, share, tap } from 'rxjs';
 import { window } from './window';
 
 export function sma<T>(length: number, fn: (it: T) => number) {

package/src/indicator/swma.ts

@@ -1,5 +1,4 @@
-import { Observable } from 'rxjs';
-import { filter, map, share } from 'rxjs/operators';
+import { filter, map, Observable, share } from 'rxjs';
 import { window } from './window';
 
 export function swma<T>(fn: (it: T) => number) {

package/src/indicator/tma.ts

@@ -1,5 +1,4 @@
-import { Observable } from 'rxjs';
-import { share, map } from 'rxjs/operators';
+import { map, Observable, share } from 'rxjs';
 import { swma } from './swma';
 import { wma } from './wma';
 

package/src/indicator/trailing.ts

@@ -1,5 +1,4 @@
-import { Observable } from 'rxjs';
-import { filter } from 'rxjs/operators';
+import { filter, Observable } from 'rxjs';
 
 export class Trailing {
   private triggered = false;
@@ -56,7 +55,7 @@ export class Trailing {
 }
 
 export function trailingup<T>(trigger: number, buffer: number, value: (it: T) => number) {
-  return function(source: Observable<T>): Observable<T> {
+  return function (source: Observable<T>): Observable<T> {
     const trailing = new Trailing(trigger, buffer);
 
     return source.pipe(filter(it => trailing.up(value(it))));
@@ -68,7 +67,7 @@ export function trailingdown<T>(
   buffer: number,
   value: (it: T) => number
 ) {
-  return function(source: Observable<T>): Observable<T> {
+  return function (source: Observable<T>): Observable<T> {
     const trailing = new Trailing(trigger, buffer);
 
     return source.pipe(filter(it => trailing.down(value(it))));

package/src/indicator/truerange.spec.ts

@@ -1,8 +1,8 @@
 import { from } from 'rxjs';
 import { Candle } from '../domain';
-import { truerange } from './truerange';
-import { sma } from './sma';
 import { now } from '../shared';
+import { sma } from './sma';
+import { truerange } from './truerange';
 
 describe('truerange atr tests', () => {
   test('should return expected value', done => {

package/src/indicator/truerange.ts

@@ -1,5 +1,4 @@
-import { Observable } from 'rxjs';
-import { map, share } from 'rxjs/operators';
+import { map, Observable, share } from 'rxjs';
 import { Candle } from '../domain';
 
 export function truerange<T>(fn: (it: T) => Candle) {

package/src/indicator/window.ts

@@ -1,4 +1,4 @@
-import { Observable, share, map } from 'rxjs';
+import { map, Observable, share } from 'rxjs';
 import { RingBuffer } from './ring-buffer';
 
 export function window<T, Y>(length: number, fn: (value: T) => Y) {