thetadatadx 8.0.25 → 8.0.30

package/README.md

@@ -36,14 +36,19 @@ async function main() {
   // With timeout
   const snap = tdx.stockSnapshotQuote(['AAPL', 'MSFT'], null, null, 5000);
 
-  // Streaming — `nextEvent` is async; `await` it or you'll get a
-  // `Promise` object back and `event.kind` will be `undefined`.
-  tdx.startStreaming();
+  // Streaming — register a callback. napi-rs `ThreadsafeFunction`
+  // routes every event through libuv's `uv_async_t` queue onto the
+  // Node main thread; the callback runs there, decoupled from the
+  // FPSS reader thread. A slow callback fills the SSOT dispatcher's
+  // bounded queue and overflow events are dropped (observable via
+  // `tdx.droppedEventCount()`); the FPSS TLS reader is never blocked.
+  tdx.startStreaming((event) => {
+    if (event.kind === 'quote') {
+      console.log(event.quote.bid, event.quote.ask);
+    }
+  });
   tdx.subscribeQuotes('AAPL');
-  const event = await tdx.nextEvent(1000); // poll with 1s timeout
-  if (event && event.kind === 'quote') {
-    console.log(event.quote.bid, event.quote.ask);
-  }
+  // ...do other work; the callback fires on incoming events...
   tdx.stopStreaming();
 }
 
@@ -60,20 +65,21 @@ the Rust side, so the full typed surface lives in `index.d.ts`
 import type { OhlcTick, GreeksTick, Quote, Trade, FpssEvent } from 'thetadatadx';
 ```
 
-Historical endpoints return `Tick[]`; `nextEvent()` is async and resolves
-to a discriminated `FpssEvent | null` union, narrowed on `event.kind`:
+Historical endpoints return `Tick[]`. Streaming events arrive through the
+`startStreaming(callback)` registration; the callback receives a
+discriminated `FpssEvent`, narrowed on `event.kind`:
 
 ```ts
-const event = await tdx.nextEvent(1000);
-if (!event) return; // timeout
-switch (event.kind) {
-  case 'quote':    /* event.quote is Quote */    break;
-  case 'trade':    /* event.trade is Trade */    break;
-  case 'ohlcvc':   /* event.ohlcvc is Ohlcvc */  break;
-  case 'open_interest': /* event.openInterest is OpenInterest */ break;
-  case 'simple':   /* event.simple is FpssSimplePayload */ break;
-  case 'raw_data': /* event.rawData is FpssRawDataPayload */ break;
-}
+tdx.startStreaming((event: FpssEvent) => {
+  switch (event.kind) {
+    case 'quote':    /* event.quote is Quote */    break;
+    case 'trade':    /* event.trade is Trade */    break;
+    case 'ohlcvc':   /* event.ohlcvc is Ohlcvc */  break;
+    case 'open_interest': /* event.openInterest is OpenInterest */ break;
+    case 'simple':   /* event.simple is FpssSimplePayload */ break;
+    case 'raw_data': /* event.rawData is FpssRawDataPayload */ break;
+  }
+});
 ```
 
 The `kind` field is typed as the string-literal union
@@ -87,7 +93,7 @@ including Vite, esbuild, ts-jest, and Next.js.
 
 Anywhere a Rust `u64` or `i64` crosses the napi boundary it surfaces as
 JavaScript `bigint` (not `number`): `volume` and `count` on every
-OHLC / EOD tick, `droppedEvents()` on the streaming client, and
+OHLC / EOD tick, `droppedEventCount()` on the streaming client, and
 `received_at_ns` on every FPSS event. Use `bigint` literal syntax
 (`42n`) for comparisons or widen to `Number(x)` at the point of
 display (watch for loss of precision beyond 2^53).

package/index.d.ts

@@ -9,18 +9,19 @@ export declare class ThetaDataDx {
   /** Connect with a credentials file (line 1 = email, line 2 = password). */
   static connectFromFile(path: string): ThetaDataDx
   /**
-   * Cumulative count of FPSS events dropped because the JS polling
-   * side disconnected before the FPSS callback could hand them off.
+   * Cumulative count of FPSS events dropped because the SSOT
+   * `StreamingDispatcher`'s bounded queue overflowed before the
+   * drain thread could hand the event off to the JS callback.
    *
-   * Counter lives on the client instance (not inside the
-   * `start_streaming` / `reconnect` closures), so the value survives
-   * reconnect and is observable at any point — before streaming,
-   * during, or after `shutdown()`.
+   * Forwards to `thetadatadx::ThetaDataDx::dropped_event_count` so
+   * the value matches every other binding (C ABI, Python, future
+   * C++) and survives reconnect — the dispatcher carries the count
+   * across `start_streaming` / `reconnect` cycles.
    *
    * Returned as `bigint` so it can represent the full `u64` range
    * (Number would top out at 2^53).
    */
-  droppedEvents(): bigint
+  droppedEventCount(): bigint
   /**
    * List all available stock ticker symbols.
    *
@@ -298,7 +299,7 @@ export declare class ThetaDataDx {
    * - `version`: `"latest"`
    * - `use_market_value`: `false`
    */
-  optionSnapshotGreeksAll(symbol: string, expiration: string | Date, strike?: string | undefined | null, right?: string | undefined | null, 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 | Date | undefined | null, useMarketValue?: boolean | undefined | null, timeoutMs?: number | undefined | null): Array<GreeksTick>
+  optionSnapshotGreeksAll(symbol: string, expiration: string | Date, strike?: string | undefined | null, right?: string | undefined | null, 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 | Date | undefined | null, useMarketValue?: boolean | undefined | null, timeoutMs?: number | undefined | null): Array<GreeksAllTick>
   /**
    * Get first-order Greeks snapshot (delta, theta, rho) for an option contract.
    *
@@ -314,7 +315,7 @@ export declare class ThetaDataDx {
    * - `version`: `"latest"`
    * - `use_market_value`: `false`
    */
-  optionSnapshotGreeksFirstOrder(symbol: string, expiration: string | Date, strike?: string | undefined | null, right?: string | undefined | null, 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 | Date | undefined | null, useMarketValue?: boolean | undefined | null, timeoutMs?: number | undefined | null): Array<GreeksTick>
+  optionSnapshotGreeksFirstOrder(symbol: string, expiration: string | Date, strike?: string | undefined | null, right?: string | undefined | null, 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 | Date | undefined | null, useMarketValue?: boolean | undefined | null, timeoutMs?: number | undefined | null): Array<GreeksFirstOrderTick>
   /**
    * Get second-order Greeks snapshot (gamma, vanna, charm) for an option contract.
    *
@@ -330,7 +331,7 @@ export declare class ThetaDataDx {
    * - `version`: `"latest"`
    * - `use_market_value`: `false`
    */
-  optionSnapshotGreeksSecondOrder(symbol: string, expiration: string | Date, strike?: string | undefined | null, right?: string | undefined | null, 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 | Date | undefined | null, useMarketValue?: boolean | undefined | null, timeoutMs?: number | undefined | null): Array<GreeksTick>
+  optionSnapshotGreeksSecondOrder(symbol: string, expiration: string | Date, strike?: string | undefined | null, right?: string | undefined | null, 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 | Date | undefined | null, useMarketValue?: boolean | undefined | null, timeoutMs?: number | undefined | null): Array<GreeksSecondOrderTick>
   /**
    * Get third-order Greeks snapshot (speed, color, ultima) for an option contract.
    *
@@ -346,7 +347,7 @@ export declare class ThetaDataDx {
    * - `version`: `"latest"`
    * - `use_market_value`: `false`
    */
-  optionSnapshotGreeksThirdOrder(symbol: string, expiration: string | Date, strike?: string | undefined | null, right?: string | undefined | null, 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 | Date | undefined | null, useMarketValue?: boolean | undefined | null, timeoutMs?: number | undefined | null): Array<GreeksTick>
+  optionSnapshotGreeksThirdOrder(symbol: string, expiration: string | Date, strike?: string | undefined | null, right?: string | undefined | null, 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 | Date | undefined | null, useMarketValue?: boolean | undefined | null, timeoutMs?: number | undefined | null): Array<GreeksThirdOrderTick>
   /**
    * Fetch end-of-day option data for a contract over a date range.
    *
@@ -447,7 +448,7 @@ export declare class ThetaDataDx {
    * - `version`: `"latest"`
    * - `underlyer_use_nbbo`: `false`
    */
-  optionHistoryGreeksEOD(symbol: string, expiration: string | Date, startDate: string | Date, endDate: string | Date, strike?: string | undefined | null, right?: string | undefined | null, 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): Array<GreeksTick>
+  optionHistoryGreeksEOD(symbol: string, expiration: string | Date, startDate: string | Date, endDate: string | Date, strike?: string | undefined | null, right?: string | undefined | null, 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): Array<GreeksAllTick>
   /**
    * Fetch all Greeks history for an option contract (intraday, sampled by interval).
    *
@@ -465,7 +466,7 @@ export declare class ThetaDataDx {
    * - `rate_type`: `"sofr"`
    * - `version`: `"latest"`
    */
-  optionHistoryGreeksAll(symbol: string, expiration: string | Date, date: string | Date, strike?: string | undefined | null, right?: string | undefined | null, interval?: string | undefined | null, startTime?: string | Date | undefined | null, endTime?: string | Date | undefined | null, annualDividend?: number | undefined | null, rateType?: string | undefined | null, rateValue?: number | undefined | null, version?: string | undefined | null, strikeRange?: number | undefined | null, startDate?: string | Date | undefined | null, endDate?: string | Date | undefined | null, timeoutMs?: number | undefined | null): Array<GreeksTick>
+  optionHistoryGreeksAll(symbol: string, expiration: string | Date, date: string | Date, strike?: string | undefined | null, right?: string | undefined | null, interval?: string | undefined | null, startTime?: string | Date | undefined | null, endTime?: string | Date | undefined | null, annualDividend?: number | undefined | null, rateType?: string | undefined | null, rateValue?: number | undefined | null, version?: string | undefined | null, strikeRange?: number | undefined | null, startDate?: string | Date | undefined | null, endDate?: string | Date | undefined | null, timeoutMs?: number | undefined | null): Array<GreeksAllTick>
   /**
    * Fetch all Greeks on each trade for an option contract.
    *
@@ -482,7 +483,7 @@ export declare class ThetaDataDx {
    * - `rate_type`: `"sofr"`
    * - `version`: `"latest"`
    */
-  optionHistoryTradeGreeksAll(symbol: string, expiration: string | Date, date: string | Date, strike?: string | undefined | null, right?: string | undefined | null, startTime?: string | Date | undefined | null, endTime?: string | Date | 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 | Date | undefined | null, endDate?: string | Date | undefined | null, timeoutMs?: number | undefined | null): Array<GreeksTick>
+  optionHistoryTradeGreeksAll(symbol: string, expiration: string | Date, date: string | Date, strike?: string | undefined | null, right?: string | undefined | null, startTime?: string | Date | undefined | null, endTime?: string | Date | 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 | Date | undefined | null, endDate?: string | Date | undefined | null, timeoutMs?: number | undefined | null): Array<GreeksAllTick>
   /**
    * Fetch first-order Greeks history (intraday, sampled by interval).
    *
@@ -500,7 +501,7 @@ export declare class ThetaDataDx {
    * - `rate_type`: `"sofr"`
    * - `version`: `"latest"`
    */
-  optionHistoryGreeksFirstOrder(symbol: string, expiration: string | Date, date: string | Date, strike?: string | undefined | null, right?: string | undefined | null, interval?: string | undefined | null, startTime?: string | Date | undefined | null, endTime?: string | Date | undefined | null, annualDividend?: number | undefined | null, rateType?: string | undefined | null, rateValue?: number | undefined | null, version?: string | undefined | null, strikeRange?: number | undefined | null, startDate?: string | Date | undefined | null, endDate?: string | Date | undefined | null, timeoutMs?: number | undefined | null): Array<GreeksTick>
+  optionHistoryGreeksFirstOrder(symbol: string, expiration: string | Date, date: string | Date, strike?: string | undefined | null, right?: string | undefined | null, interval?: string | undefined | null, startTime?: string | Date | undefined | null, endTime?: string | Date | undefined | null, annualDividend?: number | undefined | null, rateType?: string | undefined | null, rateValue?: number | undefined | null, version?: string | undefined | null, strikeRange?: number | undefined | null, startDate?: string | Date | undefined | null, endDate?: string | Date | undefined | null, timeoutMs?: number | undefined | null): Array<GreeksFirstOrderTick>
   /**
    * Fetch first-order Greeks on each trade for an option contract.
    *
@@ -517,7 +518,7 @@ export declare class ThetaDataDx {
    * - `rate_type`: `"sofr"`
    * - `version`: `"latest"`
    */
-  optionHistoryTradeGreeksFirstOrder(symbol: string, expiration: string | Date, date: string | Date, strike?: string | undefined | null, right?: string | undefined | null, startTime?: string | Date | undefined | null, endTime?: string | Date | 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 | Date | undefined | null, endDate?: string | Date | undefined | null, timeoutMs?: number | undefined | null): Array<GreeksTick>
+  optionHistoryTradeGreeksFirstOrder(symbol: string, expiration: string | Date, date: string | Date, strike?: string | undefined | null, right?: string | undefined | null, startTime?: string | Date | undefined | null, endTime?: string | Date | 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 | Date | undefined | null, endDate?: string | Date | undefined | null, timeoutMs?: number | undefined | null): Array<GreeksFirstOrderTick>
   /**
    * Fetch second-order Greeks history (intraday, sampled by interval).
    *
@@ -535,7 +536,7 @@ export declare class ThetaDataDx {
    * - `rate_type`: `"sofr"`
    * - `version`: `"latest"`
    */
-  optionHistoryGreeksSecondOrder(symbol: string, expiration: string | Date, date: string | Date, strike?: string | undefined | null, right?: string | undefined | null, interval?: string | undefined | null, startTime?: string | Date | undefined | null, endTime?: string | Date | undefined | null, annualDividend?: number | undefined | null, rateType?: string | undefined | null, rateValue?: number | undefined | null, version?: string | undefined | null, strikeRange?: number | undefined | null, startDate?: string | Date | undefined | null, endDate?: string | Date | undefined | null, timeoutMs?: number | undefined | null): Array<GreeksTick>
+  optionHistoryGreeksSecondOrder(symbol: string, expiration: string | Date, date: string | Date, strike?: string | undefined | null, right?: string | undefined | null, interval?: string | undefined | null, startTime?: string | Date | undefined | null, endTime?: string | Date | undefined | null, annualDividend?: number | undefined | null, rateType?: string | undefined | null, rateValue?: number | undefined | null, version?: string | undefined | null, strikeRange?: number | undefined | null, startDate?: string | Date | undefined | null, endDate?: string | Date | undefined | null, timeoutMs?: number | undefined | null): Array<GreeksSecondOrderTick>
   /**
    * Fetch second-order Greeks on each trade for an option contract.
    *
@@ -552,7 +553,7 @@ export declare class ThetaDataDx {
    * - `rate_type`: `"sofr"`
    * - `version`: `"latest"`
    */
-  optionHistoryTradeGreeksSecondOrder(symbol: string, expiration: string | Date, date: string | Date, strike?: string | undefined | null, right?: string | undefined | null, startTime?: string | Date | undefined | null, endTime?: string | Date | 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 | Date | undefined | null, endDate?: string | Date | undefined | null, timeoutMs?: number | undefined | null): Array<GreeksTick>
+  optionHistoryTradeGreeksSecondOrder(symbol: string, expiration: string | Date, date: string | Date, strike?: string | undefined | null, right?: string | undefined | null, startTime?: string | Date | undefined | null, endTime?: string | Date | 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 | Date | undefined | null, endDate?: string | Date | undefined | null, timeoutMs?: number | undefined | null): Array<GreeksSecondOrderTick>
   /**
    * Fetch third-order Greeks history (intraday, sampled by interval).
    *
@@ -570,7 +571,7 @@ export declare class ThetaDataDx {
    * - `rate_type`: `"sofr"`
    * - `version`: `"latest"`
    */
-  optionHistoryGreeksThirdOrder(symbol: string, expiration: string | Date, date: string | Date, strike?: string | undefined | null, right?: string | undefined | null, interval?: string | undefined | null, startTime?: string | Date | undefined | null, endTime?: string | Date | undefined | null, annualDividend?: number | undefined | null, rateType?: string | undefined | null, rateValue?: number | undefined | null, version?: string | undefined | null, strikeRange?: number | undefined | null, startDate?: string | Date | undefined | null, endDate?: string | Date | undefined | null, timeoutMs?: number | undefined | null): Array<GreeksTick>
+  optionHistoryGreeksThirdOrder(symbol: string, expiration: string | Date, date: string | Date, strike?: string | undefined | null, right?: string | undefined | null, interval?: string | undefined | null, startTime?: string | Date | undefined | null, endTime?: string | Date | undefined | null, annualDividend?: number | undefined | null, rateType?: string | undefined | null, rateValue?: number | undefined | null, version?: string | undefined | null, strikeRange?: number | undefined | null, startDate?: string | Date | undefined | null, endDate?: string | Date | undefined | null, timeoutMs?: number | undefined | null): Array<GreeksThirdOrderTick>
   /**
    * Fetch third-order Greeks on each trade for an option contract.
    *
@@ -587,7 +588,7 @@ export declare class ThetaDataDx {
    * - `rate_type`: `"sofr"`
    * - `version`: `"latest"`
    */
-  optionHistoryTradeGreeksThirdOrder(symbol: string, expiration: string | Date, date: string | Date, strike?: string | undefined | null, right?: string | undefined | null, startTime?: string | Date | undefined | null, endTime?: string | Date | 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 | Date | undefined | null, endDate?: string | Date | undefined | null, timeoutMs?: number | undefined | null): Array<GreeksTick>
+  optionHistoryTradeGreeksThirdOrder(symbol: string, expiration: string | Date, date: string | Date, strike?: string | undefined | null, right?: string | undefined | null, startTime?: string | Date | undefined | null, endTime?: string | Date | 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 | Date | undefined | null, endDate?: string | Date | undefined | null, timeoutMs?: number | undefined | null): Array<GreeksThirdOrderTick>
   /**
    * Fetch implied volatility history (intraday, sampled by interval).
    *
@@ -760,8 +761,27 @@ export declare class ThetaDataDx {
    * - `venue`: `"nqb"`
    */
   stockHistoryOHLCRange(symbol: string, startDate: string | Date, endDate: string | Date, interval?: string | undefined | null, startTime?: string | Date | undefined | null, endTime?: string | Date | undefined | null, venue?: string | undefined | null, timeoutMs?: number | undefined | null): Array<OhlcTick>
-  /** Start FPSS streaming. Events are buffered; poll with next_event(). */
-  startStreaming(): void
+  /**
+   * Start FPSS streaming and register a JS callback for incoming events.
+   *
+   * The dispatcher's drain thread routes every typed FPSS event through
+   * napi-rs `ThreadsafeFunction` to the Node main thread, where the user's
+   * `callback(event)` runs. The FPSS reader thread itself never touches V8:
+   * events cross the bounded `crossbeam_channel(8192)` queue inside the
+   * SSOT `StreamingDispatcher` first.
+   *
+   * Node's libuv requires JS callbacks on the main thread, so
+   * `ThreadsafeFunction` (with its internal `uv_async_t` queue) is the only
+   * safe path. This binding deliberately does NOT expose a
+   * `start_streaming_inline` opt-in: calling into V8 from any thread other
+   * than the main loop is undefined behavior.
+   *
+   * Backpressure: a slow callback fills the dispatcher queue and overflow
+   * events are dropped, observable via `droppedEventCount()`. The FPSS TLS
+   * reader is never blocked — vendor disconnects on slow consumers cannot
+   * happen on this path.
+   */
+  startStreaming(callback: (event: FpssEvent) => void): void
   /** Whether the streaming connection is active. */
   isStreaming(): boolean
   /** Subscribe to real-time quote data for a stock symbol. */
@@ -802,9 +822,14 @@ export declare class ThetaDataDx {
   contractLookup(id: number): string | null
   /** Get a snapshot of currently active subscriptions. */
   activeSubscriptions(): any
-  /** Poll for the next FPSS event. */
-  nextEvent(timeoutMs: number): Promise<({ kind: 'ohlcvc'; ohlcvc: Ohlcvc } | { kind: 'open_interest'; openInterest: OpenInterest } | { kind: 'quote'; quote: Quote } | { kind: 'trade'; trade: Trade } | { kind: 'simple'; simple: FpssSimplePayload } | { kind: 'raw_data'; rawData: FpssRawDataPayload }) | null>
-  /** Reconnect streaming and re-subscribe all previous subscriptions. */
+  /**
+   * Reconnect FPSS streaming and re-register the previously installed callback.
+   *
+   * Requires a prior `startStreaming(callback)`; throws if no callback is
+   * registered. All active subscriptions are restored on the new connection
+   * — see `thetadatadx::ThetaDataDx::reconnect_streaming` for partial-failure
+   * semantics.
+   */
   reconnect(): void
   /** Stop streaming while keeping the historical client usable. */
   stopStreaming(): void
@@ -826,9 +851,9 @@ export interface CalendarDay {
  * event as `event.quote.contract` / `event.trade.contract` / etc.
  */
 export interface Contract {
-  root: string
+  symbol: string
   secType: number
-  expDate?: number
+  expiration?: number
   isCall?: boolean
   strike?: number
 }
@@ -901,9 +926,11 @@ export interface FpssSimplePayload {
   id?: number
 }
 
-/** Greeks tick. Full set of option greeks. */
-export interface GreeksTick {
+/** Full-union Greeks tick (option_*_greeks_all, option_*_greeks_eod). */
+export interface GreeksAllTick {
   msOfDay: number
+  bid: number
+  ask: number
   impliedVolatility: number
   delta: number
   gamma: number
@@ -926,6 +953,68 @@ export interface GreeksTick {
   epsilon: number
   lambda: number
   vera: number
+  underlyingMsOfDay: number
+  underlyingPrice: number
+  date: number
+  expiration: number
+  strike: number
+  right: string
+}
+
+/** First-order Greeks subset tick (option_*_greeks_first_order). */
+export interface GreeksFirstOrderTick {
+  msOfDay: number
+  bid: number
+  ask: number
+  delta: number
+  theta: number
+  vega: number
+  rho: number
+  epsilon: number
+  lambda: number
+  impliedVolatility: number
+  ivError: number
+  underlyingMsOfDay: number
+  underlyingPrice: number
+  date: number
+  expiration: number
+  strike: number
+  right: string
+}
+
+/** Second-order Greeks subset tick (option_*_greeks_second_order). */
+export interface GreeksSecondOrderTick {
+  msOfDay: number
+  bid: number
+  ask: number
+  gamma: number
+  vanna: number
+  charm: number
+  vomma: number
+  veta: number
+  impliedVolatility: number
+  ivError: number
+  underlyingMsOfDay: number
+  underlyingPrice: number
+  date: number
+  expiration: number
+  strike: number
+  right: string
+}
+
+/** Third-order Greeks subset tick (option_*_greeks_third_order). */
+export interface GreeksThirdOrderTick {
+  msOfDay: number
+  bid: number
+  ask: number
+  speed: number
+  zomma: number
+  color: number
+  ultima: number
+  impliedVolatility: number
+  ivError: number
+  underlyingMsOfDay: number
+  underlyingPrice: number
   date: number
   expiration: number
   strike: number
@@ -1032,7 +1121,7 @@ export interface OpenInterestTick {
 
 /** Option contract. Contract specification. */
 export interface OptionContract {
-  root: string
+  symbol: string
   expiration: number
   strike: number
   right: string

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "thetadatadx",
-  "version": "8.0.25",
+  "version": "8.0.30",
   "description": "Native ThetaData SDK for Node.js — powered by Rust via napi-rs",
   "license": "Apache-2.0",
   "repository": {
@@ -30,9 +30,9 @@
     "@napi-rs/cli": "^3.6.2"
   },
   "optionalDependencies": {
-    "thetadatadx-linux-x64-gnu": "8.0.25",
-    "thetadatadx-darwin-arm64": "8.0.25",
-    "thetadatadx-win32-x64-msvc": "8.0.25"
+    "thetadatadx-linux-x64-gnu": "8.0.30",
+    "thetadatadx-darwin-arm64": "8.0.30",
+    "thetadatadx-win32-x64-msvc": "8.0.30"
   },
   "engines": {
     "node": ">= 20"