thetadatadx 7.3.0 → 7.3.1

package/README.md

@@ -1,31 +1,28 @@
 # thetadatadx (Node.js / TypeScript)
 
-Node.js SDK for ThetaData market data, powered by the `thetadatadx` Rust crate via napi-rs.
+Node.js SDK for ThetaData market data, powered by compiled Rust via napi-rs. Pre-built native binaries for Linux x64, macOS Apple Silicon, and Windows x64 — no Rust toolchain required.
 
-Every call goes through compiled Rust -- gRPC, protobuf, zstd, FIT decoding, and TCP streaming all happen at native speed. Node.js is just the interface.
+Every call goes through compiled Rust — gRPC, protobuf, zstd, FIT decoding, and TCP streaming all happen at native speed. Node.js is just the interface.
 
-## Prerequisites
-
-- Node.js >= 18
-- Rust stable toolchain (for building from source)
-- `protoc` (Protocol Buffers compiler)
-
-## Build from source
+## Install
 
 ```bash
-cd sdks/typescript
-npm install
-npm run build          # release build -> thetadatadx.node
+npm install thetadatadx
 ```
 
+Pre-built binaries are downloaded automatically for your platform. Supported:
+- Linux x64 (glibc)
+- macOS arm64 (Apple Silicon)
+- Windows x64 (MSVC)
+
 ## Usage
 
 ```js
 const { ThetaDataDx } = require('thetadatadx');
 
 // Connect (requires ThetaData credentials)
-const tdx = await ThetaDataDx.connect('user@example.com', 'password');
-// Or from file: const tdx = await ThetaDataDx.connectFromFile('creds.txt');
+const tdx = ThetaDataDx.connectFromFile('creds.txt');
+// Or: const tdx = ThetaDataDx.connect('user@example.com', 'password');
 
 // Historical: returns columnar object { close: number[], volume: number[], ... }
 const ohlc = tdx.stockHistoryOHLC('AAPL', '20240315', '60000');
@@ -49,11 +46,21 @@ Generated interfaces for every tick type live in `src/types.ts`:
 import type { OhlcTickColumnar, GreeksTickColumnar } from 'thetadatadx/src/types';
 ```
 
-Full type declarations for the `ThetaDataDx` class are in `index.d.ts` (auto-generated by napi-rs on build).
+Full type declarations for the `ThetaDataDx` class are in `index.d.ts` (auto-generated by napi-rs).
+
+## Building from source
+
+Only needed if your platform doesn't have a pre-built binary or you want to develop locally:
+
+```bash
+cd sdks/typescript
+npm install
+npm run build          # requires Rust stable + protoc
+```
 
 ## API reference
 
-All 61 endpoints from `endpoint_surface.toml` are exposed as camelCase methods on `ThetaDataDx`. See `index.d.ts` after building for the complete method list with JSDoc comments.
+All 61 endpoints from `endpoint_surface.toml` are exposed as camelCase methods on `ThetaDataDx`. See `index.d.ts` for the complete method list with JSDoc comments.
 
 ## Docs
 

package/index.d.ts

@@ -0,0 +1,183 @@
+/* auto-generated by NAPI-RS */
+/* eslint-disable */
+export declare class ThetaDataDx {
+  /**
+   * Connect to ThetaData. Historical (MDDS/gRPC) only; call startStreaming()
+   * to begin FPSS real-time data.
+   */
+  static connect(email: string, password: string): ThetaDataDx
+  /** Connect with a credentials file (line 1 = email, line 2 = password). */
+  static connectFromFile(path: string): ThetaDataDx
+  /** List all available stock ticker symbols. */
+  stockListSymbols(timeoutMs?: number | undefined | null): Array<string>
+  /** List available dates for a stock by request type (EOD, TRADE, QUOTE, etc.). */
+  stockListDates(requestType: string, symbol: string, timeoutMs?: number | undefined | null): Array<string>
+  /** Get the latest OHLC snapshot for one or more stocks. */
+  stockSnapshotOHLC(symbols: Array<string>, venue?: string | undefined | null, minTime?: string | undefined | null, timeoutMs?: number | undefined | null): any
+  /** Get the latest trade snapshot for one or more stocks. */
+  stockSnapshotTrade(symbols: Array<string>, venue?: string | undefined | null, minTime?: string | undefined | null, timeoutMs?: number | undefined | null): any
+  /** Get the latest NBBO quote snapshot for one or more stocks. */
+  stockSnapshotQuote(symbols: Array<string>, venue?: string | undefined | null, minTime?: string | undefined | null, timeoutMs?: number | undefined | null): any
+  /** Get the latest market value snapshot for one or more stocks. */
+  stockSnapshotMarketValue(symbols: Array<string>, venue?: string | undefined | null, minTime?: string | undefined | null, timeoutMs?: number | undefined | null): any
+  /** Fetch end-of-day stock data for a date range. Returns OHLCV + bid/ask per trading day. */
+  stockHistoryEOD(symbol: string, startDate: string, endDate: string, timeoutMs?: number | undefined | null): any
+  /** Fetch intraday OHLC bars for a stock on a single date. */
+  stockHistoryOHLC(symbol: string, date: string, interval: string, startTime?: string | undefined | null, endTime?: string | undefined | null, venue?: string | undefined | null, startDate?: string | undefined | null, endDate?: string | undefined | null, timeoutMs?: number | undefined | null): any
+  /** Fetch all trades for a stock on a given date. */
+  stockHistoryTrade(symbol: string, date: string, startTime?: string | undefined | null, endTime?: string | undefined | null, venue?: string | undefined | null, startDate?: string | undefined | null, endDate?: string | undefined | null, timeoutMs?: number | undefined | null): any
+  /** Fetch NBBO quotes for a stock on a given date at a given interval. */
+  stockHistoryQuote(symbol: string, date: string, interval: string, startTime?: string | undefined | null, endTime?: string | undefined | null, venue?: string | undefined | null, startDate?: string | undefined | null, endDate?: string | undefined | null, timeoutMs?: number | undefined | null): any
+  /** Fetch combined trade + quote ticks for a stock on a given date. Returns raw DataTable. */
+  stockHistoryTradeQuote(symbol: string, date: string, startTime?: string | undefined | null, endTime?: string | undefined | null, exclusive?: boolean | undefined | null, venue?: string | undefined | null, startDate?: string | undefined | null, endDate?: string | undefined | null, timeoutMs?: number | undefined | null): any
+  /** Fetch the trade at a specific time of day across a date range. */
+  stockAtTimeTrade(symbol: string, startDate: string, endDate: string, timeOfDay: string, venue?: string | undefined | null, timeoutMs?: number | undefined | null): any
+  /** Fetch the quote at a specific time of day across a date range. */
+  stockAtTimeQuote(symbol: string, startDate: string, endDate: string, timeOfDay: string, venue?: string | undefined | null, timeoutMs?: number | undefined | null): any
+  /** List all available option underlying symbols. */
+  optionListSymbols(timeoutMs?: number | undefined | null): Array<string>
+  /** List available dates for an option contract by request type. */
+  optionListDates(requestType: string, symbol: string, expiration: string, strike: string, right: string, timeoutMs?: number | undefined | null): Array<string>
+  /** List available expiration dates for an option underlying. */
+  optionListExpirations(symbol: string, timeoutMs?: number | undefined | null): Array<string>
+  /** List available strike prices for an option at a given expiration. */
+  optionListStrikes(symbol: string, expiration: string, timeoutMs?: number | undefined | null): Array<string>
+  /** List all option contracts for a symbol on a given date. */
+  optionListContracts(requestType: string, symbol: string, date: string, maxDte?: number | undefined | null, timeoutMs?: number | undefined | null): any
+  /** Get the latest OHLC snapshot for an option contract. */
+  optionSnapshotOHLC(symbol: string, expiration: string, strike: string, right: string, maxDte?: number | undefined | null, strikeRange?: number | undefined | null, minTime?: string | undefined | null, timeoutMs?: number | undefined | null): any
+  /** Get the latest trade snapshot for an option contract. */
+  optionSnapshotTrade(symbol: string, expiration: string, strike: string, right: string, strikeRange?: number | undefined | null, minTime?: string | undefined | null, timeoutMs?: number | undefined | null): any
+  /** Get the latest NBBO quote snapshot for an option contract. */
+  optionSnapshotQuote(symbol: string, expiration: string, strike: string, right: string, maxDte?: number | undefined | null, strikeRange?: number | undefined | null, minTime?: string | undefined | null, timeoutMs?: number | undefined | null): any
+  /** Get the latest open interest snapshot for an option contract. */
+  optionSnapshotOpenInterest(symbol: string, expiration: string, strike: string, right: string, maxDte?: number | undefined | null, strikeRange?: number | undefined | null, minTime?: string | undefined | null, timeoutMs?: number | undefined | null): any
+  /** Get the latest market value snapshot for an option contract. */
+  optionSnapshotMarketValue(symbol: string, expiration: string, strike: string, right: string, maxDte?: number | undefined | null, strikeRange?: number | undefined | null, minTime?: string | undefined | null, timeoutMs?: number | undefined | null): any
+  /** Get implied volatility snapshot for an option contract (from ThetaData server). */
+  optionSnapshotGreeksImpliedVolatility(symbol: string, expiration: string, strike: string, right: string, annualDividend?: number | undefined | null, rateType?: string | undefined | null, rateValue?: number | undefined | null, stockPrice?: number | undefined | null, version?: string | undefined | null, maxDte?: number | undefined | null, strikeRange?: number | undefined | null, minTime?: string | undefined | null, useMarketValue?: boolean | undefined | null, timeoutMs?: number | undefined | null): any
+  /** Get all Greeks snapshot for an option contract (from ThetaData server). */
+  optionSnapshotGreeksAll(symbol: string, expiration: string, strike: string, right: string, annualDividend?: number | undefined | null, rateType?: string | undefined | null, rateValue?: number | undefined | null, stockPrice?: number | undefined | null, version?: string | undefined | null, maxDte?: number | undefined | null, strikeRange?: number | undefined | null, minTime?: string | undefined | null, useMarketValue?: boolean | undefined | null, timeoutMs?: number | undefined | null): any
+  /** Get first-order Greeks snapshot (delta, theta, rho) for an option contract. */
+  optionSnapshotGreeksFirstOrder(symbol: string, expiration: string, strike: string, right: string, annualDividend?: number | undefined | null, rateType?: string | undefined | null, rateValue?: number | undefined | null, stockPrice?: number | undefined | null, version?: string | undefined | null, maxDte?: number | undefined | null, strikeRange?: number | undefined | null, minTime?: string | undefined | null, useMarketValue?: boolean | undefined | null, timeoutMs?: number | undefined | null): any
+  /** Get second-order Greeks snapshot (gamma, vanna, charm) for an option contract. */
+  optionSnapshotGreeksSecondOrder(symbol: string, expiration: string, strike: string, right: string, annualDividend?: number | undefined | null, rateType?: string | undefined | null, rateValue?: number | undefined | null, stockPrice?: number | undefined | null, version?: string | undefined | null, maxDte?: number | undefined | null, strikeRange?: number | undefined | null, minTime?: string | undefined | null, useMarketValue?: boolean | undefined | null, timeoutMs?: number | undefined | null): any
+  /** Get third-order Greeks snapshot (speed, color, ultima) for an option contract. */
+  optionSnapshotGreeksThirdOrder(symbol: string, expiration: string, strike: string, right: string, annualDividend?: number | undefined | null, rateType?: string | undefined | null, rateValue?: number | undefined | null, stockPrice?: number | undefined | null, version?: string | undefined | null, maxDte?: number | undefined | null, strikeRange?: number | undefined | null, minTime?: string | undefined | null, useMarketValue?: boolean | undefined | null, timeoutMs?: number | undefined | null): any
+  /** Fetch end-of-day option data for a contract over a date range. */
+  optionHistoryEOD(symbol: string, expiration: string, strike: string, right: string, startDate: string, endDate: string, maxDte?: number | undefined | null, strikeRange?: number | undefined | null, timeoutMs?: number | undefined | null): any
+  /** Fetch intraday OHLC bars for an option contract. */
+  optionHistoryOHLC(symbol: string, expiration: string, strike: string, right: string, date: string, interval: string, startTime?: string | undefined | null, endTime?: string | undefined | null, strikeRange?: number | undefined | null, startDate?: string | undefined | null, endDate?: string | undefined | null, timeoutMs?: number | undefined | null): any
+  /** Fetch all trades for an option contract on a given date. */
+  optionHistoryTrade(symbol: string, expiration: string, strike: string, right: string, date: string, startTime?: string | undefined | null, endTime?: string | undefined | null, maxDte?: number | undefined | null, strikeRange?: number | undefined | null, startDate?: string | undefined | null, endDate?: string | undefined | null, timeoutMs?: number | undefined | null): any
+  /** Fetch NBBO quotes for an option contract on a given date. */
+  optionHistoryQuote(symbol: string, expiration: string, strike: string, right: string, date: string, interval: string, startTime?: string | undefined | null, endTime?: string | undefined | null, maxDte?: number | undefined | null, strikeRange?: number | undefined | null, startDate?: string | undefined | null, endDate?: string | undefined | null, timeoutMs?: number | undefined | null): any
+  /** Fetch combined trade + quote ticks for an option contract. */
+  optionHistoryTradeQuote(symbol: string, expiration: string, strike: string, right: string, date: string, startTime?: string | undefined | null, endTime?: string | undefined | null, exclusive?: boolean | undefined | null, maxDte?: number | undefined | null, strikeRange?: number | undefined | null, startDate?: string | undefined | null, endDate?: string | undefined | null, timeoutMs?: number | undefined | null): any
+  /** Fetch open interest history for an option contract. */
+  optionHistoryOpenInterest(symbol: string, expiration: string, strike: string, right: string, date: string, maxDte?: number | undefined | null, strikeRange?: number | undefined | null, startDate?: string | undefined | null, endDate?: string | undefined | null, timeoutMs?: number | undefined | null): any
+  /** Fetch end-of-day Greeks history for an option contract. */
+  optionHistoryGreeksEOD(symbol: string, expiration: string, strike: string, right: string, startDate: string, endDate: string, annualDividend?: number | undefined | null, rateType?: string | undefined | null, rateValue?: number | undefined | null, version?: string | undefined | null, underlyerUseNbbo?: boolean | undefined | null, maxDte?: number | undefined | null, strikeRange?: number | undefined | null, timeoutMs?: number | undefined | null): any
+  /** Fetch all Greeks history for an option contract (intraday, sampled by interval). */
+  optionHistoryGreeksAll(symbol: string, expiration: string, strike: string, right: string, date: string, interval: string, startTime?: string | undefined | null, endTime?: string | undefined | null, annualDividend?: number | undefined | null, rateType?: string | undefined | null, rateValue?: number | undefined | null, version?: string | undefined | null, strikeRange?: number | undefined | null, startDate?: string | undefined | null, endDate?: string | undefined | null, timeoutMs?: number | undefined | null): any
+  /** Fetch all Greeks on each trade for an option contract. */
+  optionHistoryTradeGreeksAll(symbol: string, expiration: string, strike: string, right: string, date: string, startTime?: string | undefined | null, endTime?: string | undefined | null, annualDividend?: number | undefined | null, rateType?: string | undefined | null, rateValue?: number | undefined | null, version?: string | undefined | null, maxDte?: number | undefined | null, strikeRange?: number | undefined | null, startDate?: string | undefined | null, endDate?: string | undefined | null, timeoutMs?: number | undefined | null): any
+  /** Fetch first-order Greeks history (intraday, sampled by interval). */
+  optionHistoryGreeksFirstOrder(symbol: string, expiration: string, strike: string, right: string, date: string, interval: string, startTime?: string | undefined | null, endTime?: string | undefined | null, annualDividend?: number | undefined | null, rateType?: string | undefined | null, rateValue?: number | undefined | null, version?: string | undefined | null, strikeRange?: number | undefined | null, startDate?: string | undefined | null, endDate?: string | undefined | null, timeoutMs?: number | undefined | null): any
+  /** Fetch first-order Greeks on each trade for an option contract. */
+  optionHistoryTradeGreeksFirstOrder(symbol: string, expiration: string, strike: string, right: string, date: string, startTime?: string | undefined | null, endTime?: string | undefined | null, annualDividend?: number | undefined | null, rateType?: string | undefined | null, rateValue?: number | undefined | null, version?: string | undefined | null, maxDte?: number | undefined | null, strikeRange?: number | undefined | null, startDate?: string | undefined | null, endDate?: string | undefined | null, timeoutMs?: number | undefined | null): any
+  /** Fetch second-order Greeks history (intraday, sampled by interval). */
+  optionHistoryGreeksSecondOrder(symbol: string, expiration: string, strike: string, right: string, date: string, interval: string, startTime?: string | undefined | null, endTime?: string | undefined | null, annualDividend?: number | undefined | null, rateType?: string | undefined | null, rateValue?: number | undefined | null, version?: string | undefined | null, strikeRange?: number | undefined | null, startDate?: string | undefined | null, endDate?: string | undefined | null, timeoutMs?: number | undefined | null): any
+  /** Fetch second-order Greeks on each trade for an option contract. */
+  optionHistoryTradeGreeksSecondOrder(symbol: string, expiration: string, strike: string, right: string, date: string, startTime?: string | undefined | null, endTime?: string | undefined | null, annualDividend?: number | undefined | null, rateType?: string | undefined | null, rateValue?: number | undefined | null, version?: string | undefined | null, maxDte?: number | undefined | null, strikeRange?: number | undefined | null, startDate?: string | undefined | null, endDate?: string | undefined | null, timeoutMs?: number | undefined | null): any
+  /** Fetch third-order Greeks history (intraday, sampled by interval). */
+  optionHistoryGreeksThirdOrder(symbol: string, expiration: string, strike: string, right: string, date: string, interval: string, startTime?: string | undefined | null, endTime?: string | undefined | null, annualDividend?: number | undefined | null, rateType?: string | undefined | null, rateValue?: number | undefined | null, version?: string | undefined | null, strikeRange?: number | undefined | null, startDate?: string | undefined | null, endDate?: string | undefined | null, timeoutMs?: number | undefined | null): any
+  /** Fetch third-order Greeks on each trade for an option contract. */
+  optionHistoryTradeGreeksThirdOrder(symbol: string, expiration: string, strike: string, right: string, date: string, startTime?: string | undefined | null, endTime?: string | undefined | null, annualDividend?: number | undefined | null, rateType?: string | undefined | null, rateValue?: number | undefined | null, version?: string | undefined | null, maxDte?: number | undefined | null, strikeRange?: number | undefined | null, startDate?: string | undefined | null, endDate?: string | undefined | null, timeoutMs?: number | undefined | null): any
+  /** Fetch implied volatility history (intraday, sampled by interval). */
+  optionHistoryGreeksImpliedVolatility(symbol: string, expiration: string, strike: string, right: string, date: string, interval: string, startTime?: string | undefined | null, endTime?: string | undefined | null, annualDividend?: number | undefined | null, rateType?: string | undefined | null, rateValue?: number | undefined | null, version?: string | undefined | null, strikeRange?: number | undefined | null, startDate?: string | undefined | null, endDate?: string | undefined | null, timeoutMs?: number | undefined | null): any
+  /** Fetch implied volatility on each trade for an option contract. */
+  optionHistoryTradeGreeksImpliedVolatility(symbol: string, expiration: string, strike: string, right: string, date: string, startTime?: string | undefined | null, endTime?: string | undefined | null, annualDividend?: number | undefined | null, rateType?: string | undefined | null, rateValue?: number | undefined | null, version?: string | undefined | null, maxDte?: number | undefined | null, strikeRange?: number | undefined | null, startDate?: string | undefined | null, endDate?: string | undefined | null, timeoutMs?: number | undefined | null): any
+  /** Fetch the trade at a specific time of day across a date range for an option. */
+  optionAtTimeTrade(symbol: string, expiration: string, strike: string, right: string, startDate: string, endDate: string, timeOfDay: string, maxDte?: number | undefined | null, strikeRange?: number | undefined | null, timeoutMs?: number | undefined | null): any
+  /** Fetch the quote at a specific time of day across a date range for an option. */
+  optionAtTimeQuote(symbol: string, expiration: string, strike: string, right: string, startDate: string, endDate: string, timeOfDay: string, maxDte?: number | undefined | null, strikeRange?: number | undefined | null, timeoutMs?: number | undefined | null): any
+  /** List all available index symbols. */
+  indexListSymbols(timeoutMs?: number | undefined | null): Array<string>
+  /** List available dates for an index symbol. */
+  indexListDates(symbol: string, timeoutMs?: number | undefined | null): Array<string>
+  /** Get the latest OHLC snapshot for one or more indices. */
+  indexSnapshotOHLC(symbols: Array<string>, minTime?: string | undefined | null, timeoutMs?: number | undefined | null): any
+  /** Get the latest price snapshot for one or more indices. */
+  indexSnapshotPrice(symbols: Array<string>, minTime?: string | undefined | null, timeoutMs?: number | undefined | null): any
+  /** Get the latest market value snapshot for one or more indices. */
+  indexSnapshotMarketValue(symbols: Array<string>, minTime?: string | undefined | null, timeoutMs?: number | undefined | null): any
+  /** Fetch end-of-day index data for a date range. */
+  indexHistoryEOD(symbol: string, startDate: string, endDate: string, timeoutMs?: number | undefined | null): any
+  /** Fetch intraday OHLC bars for an index. */
+  indexHistoryOHLC(symbol: string, startDate: string, endDate: string, interval: string, startTime?: string | undefined | null, endTime?: string | undefined | null, timeoutMs?: number | undefined | null): any
+  /** Fetch intraday price history for an index. */
+  indexHistoryPrice(symbol: string, date: string, interval: string, startTime?: string | undefined | null, endTime?: string | undefined | null, startDate?: string | undefined | null, endDate?: string | undefined | null, timeoutMs?: number | undefined | null): any
+  /** Fetch the index price at a specific time of day across a date range. */
+  indexAtTimePrice(symbol: string, startDate: string, endDate: string, timeOfDay: string, timeoutMs?: number | undefined | null): any
+  /** Check whether the market is open today. */
+  calendarOpenToday(timeoutMs?: number | undefined | null): any
+  /** Get calendar information for a specific date. */
+  calendarOnDate(date: string, timeoutMs?: number | undefined | null): any
+  /** Get calendar information for an entire year. */
+  calendarYear(year: string, timeoutMs?: number | undefined | null): any
+  /** Fetch end-of-day interest rate history. */
+  interestRateHistoryEOD(symbol: string, startDate: string, endDate: string, timeoutMs?: number | undefined | null): any
+  /** Fetch intraday OHLC bars across a date range. */
+  stockHistoryOHLCRange(symbol: string, startDate: string, endDate: string, interval: string, startTime?: string | undefined | null, endTime?: string | undefined | null, venue?: string | undefined | null, timeoutMs?: number | undefined | null): any
+  /** Start FPSS streaming. Events are buffered; poll with next_event(). */
+  startStreaming(): void
+  /** Whether the streaming connection is active. */
+  isStreaming(): boolean
+  /** Subscribe to real-time quote data for a stock symbol. */
+  subscribeQuotes(symbol: string): void
+  /** Subscribe to real-time trade data for a stock symbol. */
+  subscribeTrades(symbol: string): void
+  /** Subscribe to open interest data for a stock symbol. */
+  subscribeOpenInterest(symbol: string): void
+  /** Subscribe to quote data for an option contract. */
+  subscribeOptionQuotes(symbol: string, expiration: string, strike: string, right: string): void
+  /** Subscribe to trade data for an option contract. */
+  subscribeOptionTrades(symbol: string, expiration: string, strike: string, right: string): void
+  /** Subscribe to open interest data for an option contract. */
+  subscribeOptionOpenInterest(symbol: string, expiration: string, strike: string, right: string): void
+  /** Subscribe to all trades for a security type. */
+  subscribeFullTrades(secType: string): void
+  /** Subscribe to all open interest for a security type. */
+  subscribeFullOpenInterest(secType: string): void
+  /** Unsubscribe from quote data for a stock symbol. */
+  unsubscribeQuotes(symbol: string): void
+  /** Unsubscribe from trade data for a stock symbol. */
+  unsubscribeTrades(symbol: string): void
+  /** Unsubscribe from open interest data for a stock symbol. */
+  unsubscribeOpenInterest(symbol: string): void
+  /** Unsubscribe from quote data for an option contract. */
+  unsubscribeOptionQuotes(symbol: string, expiration: string, strike: string, right: string): void
+  /** Unsubscribe from trade data for an option contract. */
+  unsubscribeOptionTrades(symbol: string, expiration: string, strike: string, right: string): void
+  /** Unsubscribe from open interest data for an option contract. */
+  unsubscribeOptionOpenInterest(symbol: string, expiration: string, strike: string, right: string): void
+  /** Unsubscribe from all trades for a security type. */
+  unsubscribeFullTrades(secType: string): void
+  /** Unsubscribe from all open interest for a security type. */
+  unsubscribeFullOpenInterest(secType: string): void
+  /** Get the current contract map keyed by server-assigned contract ID. */
+  contractMap(): Record<string, string>
+  /** Look up a single contract by its server-assigned ID. */
+  contractLookup(id: number): string | null
+  /** Get a snapshot of currently active subscriptions. */
+  activeSubscriptions(): any
+  /** Poll for the next FPSS event. */
+  nextEvent(timeoutMs: number): any | null
+  /** Reconnect streaming and re-subscribe all previous subscriptions. */
+  reconnect(): void
+  /** Stop streaming while keeping the historical client usable. */
+  stopStreaming(): void
+  /** Shut down the FPSS streaming connection. */
+  shutdown(): void
+}

package/index.js

@@ -1,5 +1,579 @@
-// Local-build loader for the napi native addon.
-// After `npm run build`, the compiled .node binary lives next to this file.
-const { ThetaDataDx } = require('./thetadatadx.node');
-module.exports = { ThetaDataDx };
-module.exports.ThetaDataDx = ThetaDataDx;
+// prettier-ignore
+/* eslint-disable */
+// @ts-nocheck
+/* auto-generated by NAPI-RS */
+
+const { readFileSync } = require('node:fs')
+let nativeBinding = null
+const loadErrors = []
+
+const isMusl = () => {
+  let musl = false
+  if (process.platform === 'linux') {
+    musl = isMuslFromFilesystem()
+    if (musl === null) {
+      musl = isMuslFromReport()
+    }
+    if (musl === null) {
+      musl = isMuslFromChildProcess()
+    }
+  }
+  return musl
+}
+
+const isFileMusl = (f) => f.includes('libc.musl-') || f.includes('ld-musl-')
+
+const isMuslFromFilesystem = () => {
+  try {
+    return readFileSync('/usr/bin/ldd', 'utf-8').includes('musl')
+  } catch {
+    return null
+  }
+}
+
+const isMuslFromReport = () => {
+  let report = null
+  if (typeof process.report?.getReport === 'function') {
+    process.report.excludeNetwork = true
+    report = process.report.getReport()
+  }
+  if (!report) {
+    return null
+  }
+  if (report.header && report.header.glibcVersionRuntime) {
+    return false
+  }
+  if (Array.isArray(report.sharedObjects)) {
+    if (report.sharedObjects.some(isFileMusl)) {
+      return true
+    }
+  }
+  return false
+}
+
+const isMuslFromChildProcess = () => {
+  try {
+    return require('child_process').execSync('ldd --version', { encoding: 'utf8' }).includes('musl')
+  } catch (e) {
+    // If we reach this case, we don't know if the system is musl or not, so is better to just fallback to false
+    return false
+  }
+}
+
+function requireNative() {
+  if (process.env.NAPI_RS_NATIVE_LIBRARY_PATH) {
+    try {
+      return require(process.env.NAPI_RS_NATIVE_LIBRARY_PATH);
+    } catch (err) {
+      loadErrors.push(err)
+    }
+  } else if (process.platform === 'android') {
+    if (process.arch === 'arm64') {
+      try {
+        return require('./thetadatadx.android-arm64.node')
+      } catch (e) {
+        loadErrors.push(e)
+      }
+      try {
+        const binding = require('thetadatadx-android-arm64')
+        const bindingPackageVersion = require('thetadatadx-android-arm64/package.json').version
+        if (bindingPackageVersion !== '7.3.1' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 7.3.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        }
+        return binding
+      } catch (e) {
+        loadErrors.push(e)
+      }
+    } else if (process.arch === 'arm') {
+      try {
+        return require('./thetadatadx.android-arm-eabi.node')
+      } catch (e) {
+        loadErrors.push(e)
+      }
+      try {
+        const binding = require('thetadatadx-android-arm-eabi')
+        const bindingPackageVersion = require('thetadatadx-android-arm-eabi/package.json').version
+        if (bindingPackageVersion !== '7.3.1' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 7.3.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        }
+        return binding
+      } catch (e) {
+        loadErrors.push(e)
+      }
+    } else {
+      loadErrors.push(new Error(`Unsupported architecture on Android ${process.arch}`))
+    }
+  } else if (process.platform === 'win32') {
+    if (process.arch === 'x64') {
+      if (process.config?.variables?.shlib_suffix === 'dll.a' || process.config?.variables?.node_target_type === 'shared_library') {
+        try {
+        return require('./thetadatadx.win32-x64-gnu.node')
+      } catch (e) {
+        loadErrors.push(e)
+      }
+      try {
+        const binding = require('thetadatadx-win32-x64-gnu')
+        const bindingPackageVersion = require('thetadatadx-win32-x64-gnu/package.json').version
+        if (bindingPackageVersion !== '7.3.1' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 7.3.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        }
+        return binding
+      } catch (e) {
+        loadErrors.push(e)
+      }
+      } else {
+        try {
+        return require('./thetadatadx.win32-x64-msvc.node')
+      } catch (e) {
+        loadErrors.push(e)
+      }
+      try {
+        const binding = require('thetadatadx-win32-x64-msvc')
+        const bindingPackageVersion = require('thetadatadx-win32-x64-msvc/package.json').version
+        if (bindingPackageVersion !== '7.3.1' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 7.3.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        }
+        return binding
+      } catch (e) {
+        loadErrors.push(e)
+      }
+      }
+    } else if (process.arch === 'ia32') {
+      try {
+        return require('./thetadatadx.win32-ia32-msvc.node')
+      } catch (e) {
+        loadErrors.push(e)
+      }
+      try {
+        const binding = require('thetadatadx-win32-ia32-msvc')
+        const bindingPackageVersion = require('thetadatadx-win32-ia32-msvc/package.json').version
+        if (bindingPackageVersion !== '7.3.1' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 7.3.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        }
+        return binding
+      } catch (e) {
+        loadErrors.push(e)
+      }
+    } else if (process.arch === 'arm64') {
+      try {
+        return require('./thetadatadx.win32-arm64-msvc.node')
+      } catch (e) {
+        loadErrors.push(e)
+      }
+      try {
+        const binding = require('thetadatadx-win32-arm64-msvc')
+        const bindingPackageVersion = require('thetadatadx-win32-arm64-msvc/package.json').version
+        if (bindingPackageVersion !== '7.3.1' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 7.3.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        }
+        return binding
+      } catch (e) {
+        loadErrors.push(e)
+      }
+    } else {
+      loadErrors.push(new Error(`Unsupported architecture on Windows: ${process.arch}`))
+    }
+  } else if (process.platform === 'darwin') {
+    try {
+      return require('./thetadatadx.darwin-universal.node')
+    } catch (e) {
+      loadErrors.push(e)
+    }
+    try {
+      const binding = require('thetadatadx-darwin-universal')
+      const bindingPackageVersion = require('thetadatadx-darwin-universal/package.json').version
+      if (bindingPackageVersion !== '7.3.1' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+        throw new Error(`Native binding package version mismatch, expected 7.3.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+      }
+      return binding
+    } catch (e) {
+      loadErrors.push(e)
+    }
+    if (process.arch === 'x64') {
+      try {
+        return require('./thetadatadx.darwin-x64.node')
+      } catch (e) {
+        loadErrors.push(e)
+      }
+      try {
+        const binding = require('thetadatadx-darwin-x64')
+        const bindingPackageVersion = require('thetadatadx-darwin-x64/package.json').version
+        if (bindingPackageVersion !== '7.3.1' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 7.3.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        }
+        return binding
+      } catch (e) {
+        loadErrors.push(e)
+      }
+    } else if (process.arch === 'arm64') {
+      try {
+        return require('./thetadatadx.darwin-arm64.node')
+      } catch (e) {
+        loadErrors.push(e)
+      }
+      try {
+        const binding = require('thetadatadx-darwin-arm64')
+        const bindingPackageVersion = require('thetadatadx-darwin-arm64/package.json').version
+        if (bindingPackageVersion !== '7.3.1' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 7.3.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        }
+        return binding
+      } catch (e) {
+        loadErrors.push(e)
+      }
+    } else {
+      loadErrors.push(new Error(`Unsupported architecture on macOS: ${process.arch}`))
+    }
+  } else if (process.platform === 'freebsd') {
+    if (process.arch === 'x64') {
+      try {
+        return require('./thetadatadx.freebsd-x64.node')
+      } catch (e) {
+        loadErrors.push(e)
+      }
+      try {
+        const binding = require('thetadatadx-freebsd-x64')
+        const bindingPackageVersion = require('thetadatadx-freebsd-x64/package.json').version
+        if (bindingPackageVersion !== '7.3.1' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 7.3.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        }
+        return binding
+      } catch (e) {
+        loadErrors.push(e)
+      }
+    } else if (process.arch === 'arm64') {
+      try {
+        return require('./thetadatadx.freebsd-arm64.node')
+      } catch (e) {
+        loadErrors.push(e)
+      }
+      try {
+        const binding = require('thetadatadx-freebsd-arm64')
+        const bindingPackageVersion = require('thetadatadx-freebsd-arm64/package.json').version
+        if (bindingPackageVersion !== '7.3.1' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 7.3.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        }
+        return binding
+      } catch (e) {
+        loadErrors.push(e)
+      }
+    } else {
+      loadErrors.push(new Error(`Unsupported architecture on FreeBSD: ${process.arch}`))
+    }
+  } else if (process.platform === 'linux') {
+    if (process.arch === 'x64') {
+      if (isMusl()) {
+        try {
+          return require('./thetadatadx.linux-x64-musl.node')
+        } catch (e) {
+          loadErrors.push(e)
+        }
+        try {
+          const binding = require('thetadatadx-linux-x64-musl')
+          const bindingPackageVersion = require('thetadatadx-linux-x64-musl/package.json').version
+          if (bindingPackageVersion !== '7.3.1' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 7.3.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          }
+          return binding
+        } catch (e) {
+          loadErrors.push(e)
+        }
+      } else {
+        try {
+          return require('./thetadatadx.linux-x64-gnu.node')
+        } catch (e) {
+          loadErrors.push(e)
+        }
+        try {
+          const binding = require('thetadatadx-linux-x64-gnu')
+          const bindingPackageVersion = require('thetadatadx-linux-x64-gnu/package.json').version
+          if (bindingPackageVersion !== '7.3.1' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 7.3.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          }
+          return binding
+        } catch (e) {
+          loadErrors.push(e)
+        }
+      }
+    } else if (process.arch === 'arm64') {
+      if (isMusl()) {
+        try {
+          return require('./thetadatadx.linux-arm64-musl.node')
+        } catch (e) {
+          loadErrors.push(e)
+        }
+        try {
+          const binding = require('thetadatadx-linux-arm64-musl')
+          const bindingPackageVersion = require('thetadatadx-linux-arm64-musl/package.json').version
+          if (bindingPackageVersion !== '7.3.1' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 7.3.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          }
+          return binding
+        } catch (e) {
+          loadErrors.push(e)
+        }
+      } else {
+        try {
+          return require('./thetadatadx.linux-arm64-gnu.node')
+        } catch (e) {
+          loadErrors.push(e)
+        }
+        try {
+          const binding = require('thetadatadx-linux-arm64-gnu')
+          const bindingPackageVersion = require('thetadatadx-linux-arm64-gnu/package.json').version
+          if (bindingPackageVersion !== '7.3.1' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 7.3.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          }
+          return binding
+        } catch (e) {
+          loadErrors.push(e)
+        }
+      }
+    } else if (process.arch === 'arm') {
+      if (isMusl()) {
+        try {
+          return require('./thetadatadx.linux-arm-musleabihf.node')
+        } catch (e) {
+          loadErrors.push(e)
+        }
+        try {
+          const binding = require('thetadatadx-linux-arm-musleabihf')
+          const bindingPackageVersion = require('thetadatadx-linux-arm-musleabihf/package.json').version
+          if (bindingPackageVersion !== '7.3.1' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 7.3.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          }
+          return binding
+        } catch (e) {
+          loadErrors.push(e)
+        }
+      } else {
+        try {
+          return require('./thetadatadx.linux-arm-gnueabihf.node')
+        } catch (e) {
+          loadErrors.push(e)
+        }
+        try {
+          const binding = require('thetadatadx-linux-arm-gnueabihf')
+          const bindingPackageVersion = require('thetadatadx-linux-arm-gnueabihf/package.json').version
+          if (bindingPackageVersion !== '7.3.1' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 7.3.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          }
+          return binding
+        } catch (e) {
+          loadErrors.push(e)
+        }
+      }
+    } else if (process.arch === 'loong64') {
+      if (isMusl()) {
+        try {
+          return require('./thetadatadx.linux-loong64-musl.node')
+        } catch (e) {
+          loadErrors.push(e)
+        }
+        try {
+          const binding = require('thetadatadx-linux-loong64-musl')
+          const bindingPackageVersion = require('thetadatadx-linux-loong64-musl/package.json').version
+          if (bindingPackageVersion !== '7.3.1' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 7.3.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          }
+          return binding
+        } catch (e) {
+          loadErrors.push(e)
+        }
+      } else {
+        try {
+          return require('./thetadatadx.linux-loong64-gnu.node')
+        } catch (e) {
+          loadErrors.push(e)
+        }
+        try {
+          const binding = require('thetadatadx-linux-loong64-gnu')
+          const bindingPackageVersion = require('thetadatadx-linux-loong64-gnu/package.json').version
+          if (bindingPackageVersion !== '7.3.1' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 7.3.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          }
+          return binding
+        } catch (e) {
+          loadErrors.push(e)
+        }
+      }
+    } else if (process.arch === 'riscv64') {
+      if (isMusl()) {
+        try {
+          return require('./thetadatadx.linux-riscv64-musl.node')
+        } catch (e) {
+          loadErrors.push(e)
+        }
+        try {
+          const binding = require('thetadatadx-linux-riscv64-musl')
+          const bindingPackageVersion = require('thetadatadx-linux-riscv64-musl/package.json').version
+          if (bindingPackageVersion !== '7.3.1' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 7.3.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          }
+          return binding
+        } catch (e) {
+          loadErrors.push(e)
+        }
+      } else {
+        try {
+          return require('./thetadatadx.linux-riscv64-gnu.node')
+        } catch (e) {
+          loadErrors.push(e)
+        }
+        try {
+          const binding = require('thetadatadx-linux-riscv64-gnu')
+          const bindingPackageVersion = require('thetadatadx-linux-riscv64-gnu/package.json').version
+          if (bindingPackageVersion !== '7.3.1' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 7.3.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          }
+          return binding
+        } catch (e) {
+          loadErrors.push(e)
+        }
+      }
+    } else if (process.arch === 'ppc64') {
+      try {
+        return require('./thetadatadx.linux-ppc64-gnu.node')
+      } catch (e) {
+        loadErrors.push(e)
+      }
+      try {
+        const binding = require('thetadatadx-linux-ppc64-gnu')
+        const bindingPackageVersion = require('thetadatadx-linux-ppc64-gnu/package.json').version
+        if (bindingPackageVersion !== '7.3.1' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 7.3.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        }
+        return binding
+      } catch (e) {
+        loadErrors.push(e)
+      }
+    } else if (process.arch === 's390x') {
+      try {
+        return require('./thetadatadx.linux-s390x-gnu.node')
+      } catch (e) {
+        loadErrors.push(e)
+      }
+      try {
+        const binding = require('thetadatadx-linux-s390x-gnu')
+        const bindingPackageVersion = require('thetadatadx-linux-s390x-gnu/package.json').version
+        if (bindingPackageVersion !== '7.3.1' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 7.3.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        }
+        return binding
+      } catch (e) {
+        loadErrors.push(e)
+      }
+    } else {
+      loadErrors.push(new Error(`Unsupported architecture on Linux: ${process.arch}`))
+    }
+  } else if (process.platform === 'openharmony') {
+    if (process.arch === 'arm64') {
+      try {
+        return require('./thetadatadx.openharmony-arm64.node')
+      } catch (e) {
+        loadErrors.push(e)
+      }
+      try {
+        const binding = require('thetadatadx-openharmony-arm64')
+        const bindingPackageVersion = require('thetadatadx-openharmony-arm64/package.json').version
+        if (bindingPackageVersion !== '7.3.1' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 7.3.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        }
+        return binding
+      } catch (e) {
+        loadErrors.push(e)
+      }
+    } else if (process.arch === 'x64') {
+      try {
+        return require('./thetadatadx.openharmony-x64.node')
+      } catch (e) {
+        loadErrors.push(e)
+      }
+      try {
+        const binding = require('thetadatadx-openharmony-x64')
+        const bindingPackageVersion = require('thetadatadx-openharmony-x64/package.json').version
+        if (bindingPackageVersion !== '7.3.1' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 7.3.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        }
+        return binding
+      } catch (e) {
+        loadErrors.push(e)
+      }
+    } else if (process.arch === 'arm') {
+      try {
+        return require('./thetadatadx.openharmony-arm.node')
+      } catch (e) {
+        loadErrors.push(e)
+      }
+      try {
+        const binding = require('thetadatadx-openharmony-arm')
+        const bindingPackageVersion = require('thetadatadx-openharmony-arm/package.json').version
+        if (bindingPackageVersion !== '7.3.1' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 7.3.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        }
+        return binding
+      } catch (e) {
+        loadErrors.push(e)
+      }
+    } else {
+      loadErrors.push(new Error(`Unsupported architecture on OpenHarmony: ${process.arch}`))
+    }
+  } else {
+    loadErrors.push(new Error(`Unsupported OS: ${process.platform}, architecture: ${process.arch}`))
+  }
+}
+
+nativeBinding = requireNative()
+
+if (!nativeBinding || process.env.NAPI_RS_FORCE_WASI) {
+  let wasiBinding = null
+  let wasiBindingError = null
+  try {
+    wasiBinding = require('./thetadatadx.wasi.cjs')
+    nativeBinding = wasiBinding
+  } catch (err) {
+    if (process.env.NAPI_RS_FORCE_WASI) {
+      wasiBindingError = err
+    }
+  }
+  if (!nativeBinding || process.env.NAPI_RS_FORCE_WASI) {
+    try {
+      wasiBinding = require('thetadatadx-wasm32-wasi')
+      nativeBinding = wasiBinding
+    } catch (err) {
+      if (process.env.NAPI_RS_FORCE_WASI) {
+        if (!wasiBindingError) {
+          wasiBindingError = err
+        } else {
+          wasiBindingError.cause = err
+        }
+        loadErrors.push(err)
+      }
+    }
+  }
+  if (process.env.NAPI_RS_FORCE_WASI === 'error' && !wasiBinding) {
+    const error = new Error('WASI binding not found and NAPI_RS_FORCE_WASI is set to error')
+    error.cause = wasiBindingError
+    throw error
+  }
+}
+
+if (!nativeBinding) {
+  if (loadErrors.length > 0) {
+    throw new Error(
+      `Cannot find native binding. ` +
+        `npm has a bug related to optional dependencies (https://github.com/npm/cli/issues/4828). ` +
+        'Please try `npm i` again after removing both package-lock.json and node_modules directory.',
+      {
+        cause: loadErrors.reduce((err, cur) => {
+          cur.cause = err
+          return cur
+        }),
+      },
+    )
+  }
+  throw new Error(`Failed to load native binding`)
+}
+
+module.exports = nativeBinding
+module.exports.ThetaDataDx = nativeBinding.ThetaDataDx

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "thetadatadx",
-  "version": "7.3.0",
+  "version": "7.3.1",
   "description": "Native ThetaData SDK for Node.js — powered by Rust via napi-rs",
   "license": "GPL-3.0-or-later",
   "repository": {
@@ -11,15 +11,28 @@
   "types": "index.d.ts",
   "napi": {
     "name": "thetadatadx",
-    "triples": {}
+    "triples": {
+      "defaults": false,
+      "additional": [
+        "x86_64-unknown-linux-gnu",
+        "aarch64-apple-darwin",
+        "x86_64-pc-windows-msvc"
+      ]
+    }
   },
   "scripts": {
-    "build": "napi build --release",
-    "build:debug": "napi build",
-    "test": "node --test __tests__/basic.test.mjs"
+    "build": "napi build --platform --release",
+    "build:debug": "napi build --platform",
+    "test": "node --test __tests__/basic.test.mjs",
+    "version": "napi version"
   },
   "devDependencies": {
-    "@napi-rs/cli": "^2.18.0"
+    "@napi-rs/cli": "^3.6.2"
+  },
+  "optionalDependencies": {
+    "thetadatadx-linux-x64-gnu": "7.3.1",
+    "thetadatadx-darwin-arm64": "7.3.1",
+    "thetadatadx-win32-x64-msvc": "7.3.1"
   },
   "engines": {
     "node": ">= 18"