tardis-dev 16.5.1 → 16.6.0

package/src/mappers/ascendex.ts

@@ -1,8 +1,18 @@
 import { upperCaseSymbols } from '../handy.ts'
 import { BookChange, BookTicker, DerivativeTicker, Trade } from '../types.ts'
 import { Mapper, PendingTickerInfoHelper } from './mapper.ts'
+import { exchangeMappers } from './registry.ts'
+
+export const ascendexMappers = exchangeMappers({
+  ascendex: {
+    trades: () => new AscendexTradesMapper(),
+    bookChanges: () => new AscendexBookChangeMapper(),
+    derivativeTickers: () => new AscendexDerivativeTickerMapper(),
+    bookTickers: () => new AscendexBookTickerMapper()
+  }
+})
 
-export class AscendexTradesMapper implements Mapper<'ascendex', Trade> {
+class AscendexTradesMapper implements Mapper<'ascendex', Trade> {
   canHandle(message: AscendexTrade) {
     return message.m === 'trades'
   }
@@ -34,7 +44,7 @@ export class AscendexTradesMapper implements Mapper<'ascendex', Trade> {
   }
 }
 
-export class AscendexBookChangeMapper implements Mapper<'ascendex', BookChange> {
+class AscendexBookChangeMapper implements Mapper<'ascendex', BookChange> {
   canHandle(message: AscendexDepthRealTime | AscendexDepthRealTimeSnapshot) {
     return message.m === 'depth-realtime' || message.m === 'depth-snapshot-realtime'
   }
@@ -77,7 +87,7 @@ export class AscendexBookChangeMapper implements Mapper<'ascendex', BookChange>
   }
 }
 
-export class AscendexDerivativeTickerMapper implements Mapper<'ascendex', DerivativeTicker> {
+class AscendexDerivativeTickerMapper implements Mapper<'ascendex', DerivativeTicker> {
   private readonly pendingTickerInfoHelper = new PendingTickerInfoHelper()
 
   canHandle(message: AscendexFuturesData | AscendexTrade) {
@@ -122,7 +132,7 @@ export class AscendexDerivativeTickerMapper implements Mapper<'ascendex', Deriva
   }
 }
 
-export class AscendexBookTickerMapper implements Mapper<'ascendex', BookTicker> {
+class AscendexBookTickerMapper implements Mapper<'ascendex', BookTicker> {
   canHandle(message: AscendexTicker) {
     return message.m === 'bbo'
   }

package/src/mappers/binance.ts

@@ -2,13 +2,59 @@ import { debug } from '../debug.ts'
 import { CircularBuffer, fromMicroSecondsToDate, lowerCaseSymbols } from '../handy.ts'
 import { BookChange, BookTicker, DerivativeTicker, Exchange, FilterForExchange, Liquidation, Trade } from '../types.ts'
 import { Mapper, PendingTickerInfoHelper } from './mapper.ts'
+import { exchangeMappers, isRealTime } from './registry.ts'
 
 // https://github.com/binance-exchange/binance-official-api-docs/blob/master/web-socket-streams.md
 
-export class BinanceTradesMapper implements Mapper<
-  'binance' | 'binance-jersey' | 'binance-us' | 'binance-futures' | 'binance-delivery',
-  Trade
-> {
+export const binanceMappers = exchangeMappers({
+  binance: {
+    trades: () => new BinanceTradesMapper('binance'),
+    bookChanges: (localTimestamp) =>
+      new BinanceBookChangeMapper('binance', { ignoreBookSnapshotOverlapError: shouldIgnoreBookSnapshotOverlap(localTimestamp) }),
+    bookTickers: () => new BinanceBookTickerMapper('binance')
+  },
+  'binance-us': {
+    trades: () => new BinanceTradesMapper('binance-us'),
+    bookChanges: (localTimestamp) =>
+      new BinanceBookChangeMapper('binance-us', { ignoreBookSnapshotOverlapError: shouldIgnoreBookSnapshotOverlap(localTimestamp) }),
+    bookTickers: () => new BinanceBookTickerMapper('binance-us')
+  },
+  'binance-jersey': {
+    trades: () => new BinanceTradesMapper('binance-jersey'),
+    bookChanges: (localTimestamp) =>
+      new BinanceBookChangeMapper('binance-jersey', { ignoreBookSnapshotOverlapError: shouldIgnoreBookSnapshotOverlap(localTimestamp) })
+  },
+  'binance-futures': {
+    trades: () => new BinanceTradesMapper('binance-futures'),
+    bookChanges: (localTimestamp) =>
+      new BinanceFuturesBookChangeMapper('binance-futures', {
+        ignoreBookSnapshotOverlapError: shouldIgnoreBookSnapshotOverlap(localTimestamp)
+      }),
+    derivativeTickers: () => new BinanceFuturesDerivativeTickerMapper('binance-futures'),
+    liquidations: () => new BinanceLiquidationsMapper('binance-futures'),
+    bookTickers: () => new BinanceBookTickerMapper('binance-futures')
+  },
+  'binance-delivery': {
+    trades: () => new BinanceTradesMapper('binance-delivery'),
+    bookChanges: (localTimestamp) =>
+      new BinanceFuturesBookChangeMapper('binance-delivery', {
+        ignoreBookSnapshotOverlapError: shouldIgnoreBookSnapshotOverlap(localTimestamp)
+      }),
+    derivativeTickers: () => new BinanceFuturesDerivativeTickerMapper('binance-delivery'),
+    liquidations: () => new BinanceLiquidationsMapper('binance-delivery'),
+    bookTickers: () => new BinanceBookTickerMapper('binance-delivery')
+  }
+})
+
+function shouldIgnoreBookSnapshotOverlap(date?: Date) {
+  if (process.env.IGNORE_BOOK_SNAPSHOT_OVERLAP_ERROR) {
+    return true
+  }
+
+  return isRealTime(date) === false
+}
+
+class BinanceTradesMapper implements Mapper<'binance' | 'binance-jersey' | 'binance-us' | 'binance-futures' | 'binance-delivery', Trade> {
   constructor(private readonly _exchange: Exchange) {}
 
   canHandle(message: BinanceResponse<any>) {
@@ -54,7 +100,7 @@ export class BinanceTradesMapper implements Mapper<
   }
 }
 
-export class BinanceBookChangeMapper implements Mapper<
+class BinanceBookChangeMapper implements Mapper<
   'binance' | 'binance-jersey' | 'binance-us' | 'binance-futures' | 'binance-delivery',
   BookChange
 > {
@@ -64,8 +110,12 @@ export class BinanceBookChangeMapper implements Mapper<
 
   constructor(
     protected readonly exchange: Exchange,
-    protected readonly ignoreBookSnapshotOverlapError: boolean
-  ) {}
+    { ignoreBookSnapshotOverlapError }: { ignoreBookSnapshotOverlapError: boolean }
+  ) {
+    this.ignoreBookSnapshotOverlapError = ignoreBookSnapshotOverlapError
+  }
+
+  protected readonly ignoreBookSnapshotOverlapError: boolean
 
   canHandle(message: BinanceResponse<any>) {
     if (message.stream === undefined) {
@@ -218,17 +268,7 @@ export class BinanceBookChangeMapper implements Mapper<
   }
 }
 
-export class BinanceFuturesBookChangeMapper
-  extends BinanceBookChangeMapper
-  implements Mapper<'binance-futures' | 'binance-delivery', BookChange>
-{
-  constructor(
-    protected readonly exchange: Exchange,
-    protected readonly ignoreBookSnapshotOverlapError: boolean
-  ) {
-    super(exchange, ignoreBookSnapshotOverlapError)
-  }
-
+class BinanceFuturesBookChangeMapper extends BinanceBookChangeMapper implements Mapper<'binance-futures' | 'binance-delivery', BookChange> {
   protected mapBookDepthUpdate(binanceDepthUpdateData: BinanceFuturesDepthData, localTimestamp: Date): BookChange | undefined {
     // we can safely assume here that depthContext and lastUpdateId aren't null here as this is method only works
     // when we've already processed the snapshot
@@ -273,7 +313,7 @@ export class BinanceFuturesBookChangeMapper
   }
 }
 
-export class BinanceFuturesDerivativeTickerMapper implements Mapper<'binance-futures' | 'binance-delivery', DerivativeTicker> {
+class BinanceFuturesDerivativeTickerMapper implements Mapper<'binance-futures' | 'binance-delivery', DerivativeTicker> {
   private readonly pendingTickerInfoHelper = new PendingTickerInfoHelper()
   private readonly _indexPrices = new Map<string, number>()
 
@@ -369,7 +409,7 @@ export class BinanceFuturesDerivativeTickerMapper implements Mapper<'binance-fut
   }
 }
 
-export class BinanceLiquidationsMapper implements Mapper<'binance-futures' | 'binance-delivery', Liquidation> {
+class BinanceLiquidationsMapper implements Mapper<'binance-futures' | 'binance-delivery', Liquidation> {
   constructor(private readonly _exchange: Exchange) {}
 
   canHandle(message: BinanceResponse<any>) {
@@ -414,7 +454,7 @@ export class BinanceLiquidationsMapper implements Mapper<'binance-futures' | 'bi
   }
 }
 
-export class BinanceBookTickerMapper implements Mapper<'binance-futures' | 'binance-delivery' | 'binance', BookTicker> {
+class BinanceBookTickerMapper implements Mapper<'binance-futures' | 'binance-delivery' | 'binance', BookTicker> {
   constructor(private readonly _exchange: Exchange) {}
 
   canHandle(message: BinanceResponse<any>) {

package/src/mappers/binancedex.ts

@@ -1,10 +1,19 @@
 import { upperCaseSymbols } from '../handy.ts'
 import { BookChange, BookTicker, Trade } from '../types.ts'
 import { Mapper } from './mapper.ts'
+import { exchangeMappers } from './registry.ts'
 
 // https://docs.binance.org/api-reference/dex-api/ws-streams.html
 
-export const binanceDexTradesMapper: Mapper<'binance-dex', Trade> = {
+export const binanceDexMappers = exchangeMappers({
+  'binance-dex': {
+    trades: () => binanceDexTradesMapper,
+    bookChanges: () => binanceDexBookChangeMapper,
+    bookTickers: () => binanceDexBookTickerMapper
+  }
+})
+
+const binanceDexTradesMapper: Mapper<'binance-dex', Trade> = {
   canHandle(message: BinanceDexResponse<any>) {
     return message.stream === 'trades'
   },
@@ -43,7 +52,7 @@ const mapBookLevel = (level: BinanceDexBookLevel) => {
   return { price, amount }
 }
 
-export const binanceDexBookChangeMapper: Mapper<'binance-dex', BookChange> = {
+const binanceDexBookChangeMapper: Mapper<'binance-dex', BookChange> = {
   canHandle(message: BinanceDexResponse<any>) {
     return message.stream === 'marketDiff' || message.stream === 'depthSnapshot'
   },
@@ -94,7 +103,7 @@ export const binanceDexBookChangeMapper: Mapper<'binance-dex', BookChange> = {
   }
 }
 
-export const binanceDexBookTickerMapper: Mapper<'binance-dex', BookTicker> = {
+const binanceDexBookTickerMapper: Mapper<'binance-dex', BookTicker> = {
   canHandle(message: BinanceDexResponse<any>) {
     return message.stream === 'ticker'
   },

package/src/mappers/binanceeuropeanoptions.ts

@@ -1,10 +1,31 @@
 import { asNonZeroNumberOrUndefined, lowerCaseSymbols, upperCaseSymbols } from '../handy.ts'
 import { BookChange, BookTicker, OptionSummary, Trade } from '../types.ts'
 import { Mapper } from './mapper.ts'
+import { exchangeMappers, mapper } from './registry.ts'
+
+const BINANCE_EUROPEAN_OPTIONS_V2_API_SWITCH_DATE = new Date('2025-12-17T00:00:00.000Z')
 
 // https://binance-docs.github.io/apidocs/voptions/en/#websocket-market-streams
 
-export class BinanceEuropeanOptionsTradesMapper implements Mapper<'binance-european-options', Trade> {
+export const binanceEuropeanOptionsMappers = exchangeMappers({
+  'binance-european-options': {
+    trades: mapper([
+      { until: BINANCE_EUROPEAN_OPTIONS_V2_API_SWITCH_DATE, use: () => new BinanceEuropeanOptionsTradesMapper() },
+      { use: () => new BinanceEuropeanOptionsTradesMapperV2() }
+    ]),
+    bookChanges: mapper([
+      { until: BINANCE_EUROPEAN_OPTIONS_V2_API_SWITCH_DATE, use: () => new BinanceEuropeanOptionsBookChangeMapper() },
+      { use: () => new BinanceEuropeanOptionsBookChangeMapperV2() }
+    ]),
+    optionsSummary: mapper([
+      { until: BINANCE_EUROPEAN_OPTIONS_V2_API_SWITCH_DATE, use: () => new BinanceEuropeanOptionSummaryMapper() },
+      { use: () => new BinanceEuropeanOptionSummaryMapperV2() }
+    ]),
+    bookTickers: () => new BinanceEuropeanOptionsBookTickerMapper()
+  }
+})
+
+class BinanceEuropeanOptionsTradesMapper implements Mapper<'binance-european-options', Trade> {
   canHandle(message: BinanceResponse<any>) {
     if (message.stream === undefined) {
       return false
@@ -41,7 +62,7 @@ export class BinanceEuropeanOptionsTradesMapper implements Mapper<'binance-europ
   }
 }
 
-export class BinanceEuropeanOptionsTradesMapperV2 implements Mapper<'binance-european-options', Trade> {
+class BinanceEuropeanOptionsTradesMapperV2 implements Mapper<'binance-european-options', Trade> {
   canHandle(message: BinanceResponse<any>) {
     if (message.stream === undefined) {
       return false
@@ -78,7 +99,7 @@ export class BinanceEuropeanOptionsTradesMapperV2 implements Mapper<'binance-eur
   }
 }
 
-export class BinanceEuropeanOptionsBookChangeMapper implements Mapper<'binance-european-options', BookChange> {
+class BinanceEuropeanOptionsBookChangeMapper implements Mapper<'binance-european-options', BookChange> {
   canHandle(message: BinanceResponse<any>) {
     if (message.stream === undefined) {
       return false
@@ -120,7 +141,7 @@ export class BinanceEuropeanOptionsBookChangeMapper implements Mapper<'binance-e
   }
 }
 
-export class BinanceEuropeanOptionsBookChangeMapperV2 implements Mapper<'binance-european-options', BookChange> {
+class BinanceEuropeanOptionsBookChangeMapperV2 implements Mapper<'binance-european-options', BookChange> {
   canHandle(message: BinanceResponse<any>) {
     if (message.stream === undefined) {
       return false
@@ -162,7 +183,7 @@ export class BinanceEuropeanOptionsBookChangeMapperV2 implements Mapper<'binance
   }
 }
 
-export class BinanceEuropeanOptionsBookTickerMapper implements Mapper<'binance-european-options', BookTicker> {
+class BinanceEuropeanOptionsBookTickerMapper implements Mapper<'binance-european-options', BookTicker> {
   canHandle(message: BinanceResponse<any>) {
     if (message.stream === undefined) {
       return false
@@ -204,7 +225,7 @@ export class BinanceEuropeanOptionsBookTickerMapper implements Mapper<'binance-e
   }
 }
 
-export class BinanceEuropeanOptionSummaryMapper implements Mapper<'binance-european-options', OptionSummary> {
+class BinanceEuropeanOptionSummaryMapper implements Mapper<'binance-european-options', OptionSummary> {
   private readonly _indexPrices = new Map<string, number>()
   private readonly _openInterests = new Map<string, number>()
 
@@ -330,7 +351,7 @@ export class BinanceEuropeanOptionSummaryMapper implements Mapper<'binance-europ
   }
 }
 
-export class BinanceEuropeanOptionSummaryMapperV2 implements Mapper<'binance-european-options', OptionSummary> {
+class BinanceEuropeanOptionSummaryMapperV2 implements Mapper<'binance-european-options', OptionSummary> {
   private readonly _lastPrices = new Map<string, number>()
   private readonly _openInterests = new Map<string, number>()
 

package/src/mappers/bitfinex.ts

@@ -1,10 +1,26 @@
 import { upperCaseSymbols } from '../handy.ts'
 import { BookChange, BookTicker, DerivativeTicker, Exchange, FilterForExchange, Liquidation, Trade } from '../types.ts'
 import { Mapper, PendingTickerInfoHelper } from './mapper.ts'
+import { exchangeMappers } from './registry.ts'
 
 // https://docs.bitfinex.com/v2/docs/ws-general
 
-export class BitfinexTradesMapper implements Mapper<'bitfinex' | 'bitfinex-derivatives', Trade> {
+export const bitfinexMappers = exchangeMappers({
+  bitfinex: {
+    trades: () => new BitfinexTradesMapper('bitfinex'),
+    bookChanges: () => new BitfinexBookChangeMapper('bitfinex'),
+    bookTickers: () => new BitfinexBookTickerMapper('bitfinex')
+  },
+  'bitfinex-derivatives': {
+    trades: () => new BitfinexTradesMapper('bitfinex-derivatives'),
+    bookChanges: () => new BitfinexBookChangeMapper('bitfinex-derivatives'),
+    derivativeTickers: () => new BitfinexDerivativeTickerMapper(),
+    liquidations: () => new BitfinexLiquidationsMapper('bitfinex-derivatives'),
+    bookTickers: () => new BitfinexBookTickerMapper('bitfinex-derivatives')
+  }
+})
+
+class BitfinexTradesMapper implements Mapper<'bitfinex' | 'bitfinex-derivatives', Trade> {
   private readonly _channelIdToSymbolMap: Map<number, string> = new Map()
 
   constructor(private readonly _exchange: Exchange) {}
@@ -80,7 +96,7 @@ export class BitfinexTradesMapper implements Mapper<'bitfinex' | 'bitfinex-deriv
   }
 }
 
-export class BitfinexBookChangeMapper implements Mapper<'bitfinex' | 'bitfinex-derivatives', BookChange> {
+class BitfinexBookChangeMapper implements Mapper<'bitfinex' | 'bitfinex-derivatives', BookChange> {
   private readonly _channelIdToSymbolMap: Map<number, string> = new Map()
 
   constructor(private readonly _exchange: Exchange) {}
@@ -162,7 +178,7 @@ export class BitfinexBookChangeMapper implements Mapper<'bitfinex' | 'bitfinex-d
   }
 }
 
-export class BitfinexDerivativeTickerMapper implements Mapper<'bitfinex-derivatives', DerivativeTicker> {
+class BitfinexDerivativeTickerMapper implements Mapper<'bitfinex-derivatives', DerivativeTicker> {
   private readonly _channelIdToSymbolMap: Map<number, string> = new Map()
   private readonly pendingTickerInfoHelper = new PendingTickerInfoHelper()
 
@@ -245,7 +261,7 @@ export class BitfinexDerivativeTickerMapper implements Mapper<'bitfinex-derivati
   }
 }
 
-export class BitfinexLiquidationsMapper implements Mapper<'bitfinex-derivatives', Liquidation> {
+class BitfinexLiquidationsMapper implements Mapper<'bitfinex-derivatives', Liquidation> {
   private _liquidationsChannelId: number | undefined = undefined
 
   constructor(private readonly _exchange: Exchange) {}
@@ -322,7 +338,7 @@ export class BitfinexLiquidationsMapper implements Mapper<'bitfinex-derivatives'
   }
 }
 
-export class BitfinexBookTickerMapper implements Mapper<'bitfinex' | 'bitfinex-derivatives', BookTicker> {
+class BitfinexBookTickerMapper implements Mapper<'bitfinex' | 'bitfinex-derivatives', BookTicker> {
   private readonly _channelIdToSymbolMap: Map<number, string> = new Map()
 
   constructor(private readonly _exchange: Exchange) {}

package/src/mappers/bitflyer.ts

@@ -1,8 +1,17 @@
 import { parseμs, upperCaseSymbols } from '../handy.ts'
 import { BookChange, BookTicker, Trade } from '../types.ts'
 import { Mapper } from './mapper.ts'
+import { exchangeMappers } from './registry.ts'
 
-export const bitflyerTradesMapper: Mapper<'bitflyer', Trade> = {
+export const bitflyerMappers = exchangeMappers({
+  bitflyer: {
+    trades: () => bitflyerTradesMapper,
+    bookChanges: () => new BitflyerBookChangeMapper(),
+    bookTickers: () => bitflyerBookTickerMapper
+  }
+})
+
+const bitflyerTradesMapper: Mapper<'bitflyer', Trade> = {
   canHandle(message: BitflyerExecutions | BitflyerBoard) {
     return message.params.channel.startsWith('lightning_executions')
   },
@@ -46,7 +55,7 @@ const mapBookLevel = ({ price, size }: BitflyerBookLevel) => {
   return { price, amount: size }
 }
 
-export class BitflyerBookChangeMapper implements Mapper<'bitflyer', BookChange> {
+class BitflyerBookChangeMapper implements Mapper<'bitflyer', BookChange> {
   private readonly _snapshotsInfo: Map<string, boolean> = new Map()
 
   canHandle(message: BitflyerExecutions | BitflyerBoard) {
@@ -95,7 +104,7 @@ export class BitflyerBookChangeMapper implements Mapper<'bitflyer', BookChange>
   }
 }
 
-export const bitflyerBookTickerMapper: Mapper<'bitflyer', BookTicker> = {
+const bitflyerBookTickerMapper: Mapper<'bitflyer', BookTicker> = {
   canHandle(message: BitflyerTicker) {
     return message.params.channel.startsWith('lightning_ticker')
   },

package/src/mappers/bitget.ts

@@ -1,8 +1,47 @@
 import { asNonZeroNumberOrUndefined, upperCaseSymbols } from '../handy.ts'
 import { BookChange, BookTicker, DerivativeTicker, Exchange, Liquidation, Trade } from '../types.ts'
 import { Mapper, PendingTickerInfoHelper } from './mapper.ts'
+import { exchangeMappers, mapper } from './registry.ts'
+
+const BITGET_V3_API_SWITCH_DATE = new Date('2026-04-28T00:00:00.000Z')
+
+export const bitgetMappers = exchangeMappers({
+  bitget: {
+    trades: mapper([
+      { until: BITGET_V3_API_SWITCH_DATE, use: () => new BitgetTradesMapper('bitget') },
+      { use: () => new BitgetV3TradesMapper('bitget') }
+    ]),
+    bookChanges: mapper([
+      { until: BITGET_V3_API_SWITCH_DATE, use: () => new BitgetBookChangeMapper('bitget') },
+      { use: () => new BitgetV3BookChangeMapper('bitget') }
+    ]),
+    bookTickers: mapper([
+      { until: BITGET_V3_API_SWITCH_DATE, use: () => new BitgetBookTickerMapper('bitget') },
+      { use: () => new BitgetV3BookTickerMapper('bitget') }
+    ])
+  },
+  'bitget-futures': {
+    trades: mapper([
+      { until: BITGET_V3_API_SWITCH_DATE, use: () => new BitgetTradesMapper('bitget-futures') },
+      { use: () => new BitgetV3TradesMapper('bitget-futures') }
+    ]),
+    bookChanges: mapper([
+      { until: BITGET_V3_API_SWITCH_DATE, use: () => new BitgetBookChangeMapper('bitget-futures') },
+      { use: () => new BitgetV3BookChangeMapper('bitget-futures') }
+    ]),
+    derivativeTickers: mapper([
+      { until: BITGET_V3_API_SWITCH_DATE, use: () => new BitgetDerivativeTickerMapper() },
+      { use: () => new BitgetV3DerivativeTickerMapper() }
+    ]),
+    liquidations: () => new BitgetV3LiquidationsMapper(),
+    bookTickers: mapper([
+      { until: BITGET_V3_API_SWITCH_DATE, use: () => new BitgetBookTickerMapper('bitget-futures') },
+      { use: () => new BitgetV3BookTickerMapper('bitget-futures') }
+    ])
+  }
+})
 
-export class BitgetTradesMapper implements Mapper<'bitget' | 'bitget-futures', Trade> {
+class BitgetTradesMapper implements Mapper<'bitget' | 'bitget-futures', Trade> {
   constructor(private readonly _exchange: Exchange) {}
 
   canHandle(message: BitgetTradeMessage) {
@@ -43,7 +82,7 @@ function mapPriceLevel(level: [string, string]) {
     amount: Number(level[1])
   }
 }
-export class BitgetBookChangeMapper implements Mapper<'bitget' | 'bitget-futures', BookChange> {
+class BitgetBookChangeMapper implements Mapper<'bitget' | 'bitget-futures', BookChange> {
   constructor(private readonly _exchange: Exchange) {}
 
   canHandle(message: BitgetOrderbookMessage) {
@@ -77,7 +116,7 @@ export class BitgetBookChangeMapper implements Mapper<'bitget' | 'bitget-futures
   }
 }
 
-export class BitgetBookTickerMapper implements Mapper<'bitget' | 'bitget-futures', BookTicker> {
+class BitgetBookTickerMapper implements Mapper<'bitget' | 'bitget-futures', BookTicker> {
   constructor(private readonly _exchange: Exchange) {}
 
   canHandle(message: BitgetBBoMessage) {
@@ -116,7 +155,7 @@ export class BitgetBookTickerMapper implements Mapper<'bitget' | 'bitget-futures
   }
 }
 
-export class BitgetDerivativeTickerMapper implements Mapper<'bitget-futures', DerivativeTicker> {
+class BitgetDerivativeTickerMapper implements Mapper<'bitget-futures', DerivativeTicker> {
   private readonly pendingTickerInfoHelper = new PendingTickerInfoHelper()
 
   canHandle(message: BitgetTickerMessage) {
@@ -155,7 +194,7 @@ export class BitgetDerivativeTickerMapper implements Mapper<'bitget-futures', De
   }
 }
 
-export class BitgetV3TradesMapper implements Mapper<'bitget' | 'bitget-futures', Trade> {
+class BitgetV3TradesMapper implements Mapper<'bitget' | 'bitget-futures', Trade> {
   constructor(private readonly _exchange: Exchange) {}
 
   canHandle(message: BitgetV3TradeMessage) {
@@ -190,7 +229,7 @@ export class BitgetV3TradesMapper implements Mapper<'bitget' | 'bitget-futures',
   }
 }
 
-export class BitgetV3BookChangeMapper implements Mapper<'bitget' | 'bitget-futures', BookChange> {
+class BitgetV3BookChangeMapper implements Mapper<'bitget' | 'bitget-futures', BookChange> {
   constructor(private readonly _exchange: Exchange) {}
 
   canHandle(message: BitgetV3OrderbookMessage) {
@@ -224,7 +263,7 @@ export class BitgetV3BookChangeMapper implements Mapper<'bitget' | 'bitget-futur
   }
 }
 
-export class BitgetV3BookTickerMapper implements Mapper<'bitget' | 'bitget-futures', BookTicker> {
+class BitgetV3BookTickerMapper implements Mapper<'bitget' | 'bitget-futures', BookTicker> {
   constructor(private readonly _exchange: Exchange) {}
 
   canHandle(message: BitgetV3BBoMessage) {
@@ -259,7 +298,7 @@ export class BitgetV3BookTickerMapper implements Mapper<'bitget' | 'bitget-futur
   }
 }
 
-export class BitgetV3DerivativeTickerMapper implements Mapper<'bitget-futures', DerivativeTicker> {
+class BitgetV3DerivativeTickerMapper implements Mapper<'bitget-futures', DerivativeTicker> {
   private readonly pendingTickerInfoHelper = new PendingTickerInfoHelper()
 
   canHandle(message: BitgetV3TickerMessage) {
@@ -299,7 +338,7 @@ export class BitgetV3DerivativeTickerMapper implements Mapper<'bitget-futures',
   }
 }
 
-export class BitgetV3LiquidationsMapper implements Mapper<'bitget-futures', Liquidation> {
+class BitgetV3LiquidationsMapper implements Mapper<'bitget-futures', Liquidation> {
   canHandle(message: BitgetV3LiquidationMessage) {
     return message.arg.topic === 'liquidation' && message.action === 'update'
   }

package/src/mappers/bitmex.ts

@@ -1,10 +1,21 @@
 import { asNonZeroNumberOrUndefined, upperCaseSymbols } from '../handy.ts'
 import { BookChange, BookPriceLevel, BookTicker, DerivativeTicker, FilterForExchange, Liquidation, Trade } from '../types.ts'
 import { Mapper, PendingTickerInfoHelper } from './mapper.ts'
+import { exchangeMappers } from './registry.ts'
 
 // https://www.bitmex.com/app/wsAPI
 
-export const bitmexTradesMapper: Mapper<'bitmex', Trade> = {
+export const bitmexMappers = exchangeMappers({
+  bitmex: {
+    trades: () => bitmexTradesMapper,
+    bookChanges: () => new BitmexBookChangeMapper(),
+    derivativeTickers: () => new BitmexDerivativeTickerMapper(),
+    liquidations: () => bitmexLiquidationsMapper,
+    bookTickers: () => bitmexBookTickerMapper
+  }
+})
+
+const bitmexTradesMapper: Mapper<'bitmex', Trade> = {
   canHandle(message: BitmexDataMessage) {
     return message.table === 'trade' && message.action === 'insert'
   },
@@ -39,7 +50,7 @@ export const bitmexTradesMapper: Mapper<'bitmex', Trade> = {
   }
 }
 
-export class BitmexBookChangeMapper implements Mapper<'bitmex', BookChange> {
+class BitmexBookChangeMapper implements Mapper<'bitmex', BookChange> {
   private readonly _idToPriceLevelMap: Map<number, number> = new Map()
 
   canHandle(message: BitmexDataMessage) {
@@ -158,7 +169,7 @@ export class BitmexBookChangeMapper implements Mapper<'bitmex', BookChange> {
   }
 }
 
-export class BitmexDerivativeTickerMapper implements Mapper<'bitmex', DerivativeTicker> {
+class BitmexDerivativeTickerMapper implements Mapper<'bitmex', DerivativeTicker> {
   private readonly pendingTickerInfoHelper = new PendingTickerInfoHelper()
 
   canHandle(message: BitmexDataMessage) {
@@ -210,7 +221,7 @@ export class BitmexDerivativeTickerMapper implements Mapper<'bitmex', Derivative
   }
 }
 
-export const bitmexLiquidationsMapper: Mapper<'bitmex', Liquidation> = {
+const bitmexLiquidationsMapper: Mapper<'bitmex', Liquidation> = {
   canHandle(message: BitmexDataMessage) {
     return message.table === 'liquidation' && message.action === 'insert'
   },
@@ -245,7 +256,7 @@ export const bitmexLiquidationsMapper: Mapper<'bitmex', Liquidation> = {
   }
 }
 
-export const bitmexBookTickerMapper: Mapper<'bitmex', BookTicker> = {
+const bitmexBookTickerMapper: Mapper<'bitmex', BookTicker> = {
   canHandle(message: BitmexDataMessage) {
     return message.table === 'quote' && message.action === 'insert'
   },

package/src/mappers/bitnomial.ts

@@ -1,8 +1,16 @@
 import { parseμs, upperCaseSymbols } from '../handy.ts'
 import { BookChange, Trade } from '../types.ts'
 import { Mapper } from './mapper.ts'
+import { exchangeMappers } from './registry.ts'
 
-export const bitnomialTradesMapper: Mapper<'bitnomial', Trade> = {
+export const bitnomialMappers = exchangeMappers({
+  bitnomial: {
+    trades: () => bitnomialTradesMapper,
+    bookChanges: () => new BitnomialBookChangMapper()
+  }
+})
+
+const bitnomialTradesMapper: Mapper<'bitnomial', Trade> = {
   canHandle(message: BitnomialTrade) {
     return message.type === 'trade'
   },
@@ -40,7 +48,7 @@ const mapBookLevel = (level: BookLevel) => {
   return { price: level[0], amount: level[1] }
 }
 
-export class BitnomialBookChangMapper implements Mapper<'bitnomial', BookChange> {
+class BitnomialBookChangMapper implements Mapper<'bitnomial', BookChange> {
   canHandle(message: BitnomialBookMessage) {
     return message.type === 'book' || message.type === 'level'
   }

package/src/mappers/bitstamp.ts

@@ -1,10 +1,18 @@
 import { lowerCaseSymbols } from '../handy.ts'
 import { BookChange, Trade } from '../types.ts'
 import { Mapper } from './mapper.ts'
+import { exchangeMappers } from './registry.ts'
 
 // https://www.bitstamp.net/websocket/v2/
 
-export const bitstampTradesMapper: Mapper<'bitstamp', Trade> = {
+export const bitstampMappers = exchangeMappers({
+  bitstamp: {
+    trades: () => bitstampTradesMapper,
+    bookChanges: () => new BitstampBookChangeMapper()
+  }
+})
+
+const bitstampTradesMapper: Mapper<'bitstamp', Trade> = {
   canHandle(message: BitstampTrade | BitstampDiffOrderBook | BitstampDiffOrderBookSnapshot) {
     if (message.data === undefined) {
       return false
@@ -45,7 +53,7 @@ export const bitstampTradesMapper: Mapper<'bitstamp', Trade> = {
   }
 }
 
-export class BitstampBookChangeMapper implements Mapper<'bitstamp', BookChange> {
+class BitstampBookChangeMapper implements Mapper<'bitstamp', BookChange> {
   private readonly _symbolToDepthInfoMapping: { [key: string]: LocalDepthInfo } = {}
 
   canHandle(message: BitstampTrade | BitstampDiffOrderBook | BitstampDiffOrderBookSnapshot) {

package/src/mappers/blockchaincom.ts

@@ -1,8 +1,16 @@
 import { upperCaseSymbols } from '../handy.ts'
 import { BookChange, Trade } from '../types.ts'
 import { Mapper } from './mapper.ts'
+import { exchangeMappers } from './registry.ts'
 
-export class BlockchainComTradesMapper implements Mapper<'blockchain-com', Trade> {
+export const blockchainComMappers = exchangeMappers({
+  'blockchain-com': {
+    trades: () => new BlockchainComTradesMapper(),
+    bookChanges: () => new BlockchainComBookChangeMapper()
+  }
+})
+
+class BlockchainComTradesMapper implements Mapper<'blockchain-com', Trade> {
   canHandle(message: BlockchainComTradeMessage) {
     return message.channel === 'trades' && message.event === 'updated'
   }
@@ -32,7 +40,7 @@ export class BlockchainComTradesMapper implements Mapper<'blockchain-com', Trade
   }
 }
 
-export class BlockchainComBookChangeMapper implements Mapper<'blockchain-com', BookChange> {
+class BlockchainComBookChangeMapper implements Mapper<'blockchain-com', BookChange> {
   canHandle(message: BlockchainComL2Message) {
     return message.channel == 'l2' && (message.event === 'snapshot' || message.event === 'updated')
   }