@lifi/perps-sdk-provider-hyperliquid 15.0.0 → 17.0.0

package/src/utils/spotCollateral.ts

@@ -1,19 +1,6 @@
 import type { Balance } from '@lifi/perps-types'
 import { toWireBig } from './decimal.js'
 
-/**
- * Portfolio-margin collateral beyond the category quote assets, keyed by spot
- * display symbol with its loan-to-value weight. Hyperliquid credits these
- * toward buying power at the given fraction (0.5 for both today). Quote assets
- * (USDC/USDT) are already full-value collateral via the category model, so
- * they are not listed here.
- * https://hyperliquid.gitbook.io/hyperliquid-docs/trading/portfolio-margin
- */
-const PORTFOLIO_MARGIN_LTV: Readonly<Record<string, number>> = {
-  HYPE: 0.5,
-  UBTC: 0.5,
-}
-
 /**
  * Result of {@link partitionSpotBalances}: balances that count toward
  * collateral and balances treated as ordinary holdings.
@@ -25,15 +12,14 @@ export interface SpotPartition {
 }
 
 /**
- * Partition spot balances into collateral and ordinary holdings. Quote assets
- * are full-value collateral; portfolio-margin-supported assets retain their
- * LTV as `collateralWeight`.
+ * Partition spot balances into collateral and ordinary holdings. Category
+ * quote assets are collateral; every other token is an ordinary holding.
+ * Zero-unit rows are dropped from both lists.
  * @public
  */
 export const partitionSpotBalances = (
   spotBalances: readonly Balance[],
-  quoteAssetIds: ReadonlySet<string>,
-  portfolioMargin: boolean
+  quoteAssetIds: ReadonlySet<string>
 ): SpotPartition => {
   const collateralBalances: Balance[] = []
   const balances: Balance[] = []
@@ -43,13 +29,6 @@ export const partitionSpotBalances = (
     }
     if (quoteAssetIds.has(balance.asset.id)) {
       collateralBalances.push(balance)
-      continue
-    }
-    const ltv = portfolioMargin
-      ? PORTFOLIO_MARGIN_LTV[balance.asset.displaySymbol]
-      : undefined
-    if (ltv !== undefined) {
-      collateralBalances.push({ ...balance, collateralWeight: ltv })
     } else {
       balances.push(balance)
     }

package/src/utils/transferMargin.ts

@@ -2,24 +2,27 @@ import { PerpsError } from '@lifi/perps-sdk'
 import {
   PerpsErrorCode,
   type Position,
-  type PositionMarginConstraints,
   positionSupportsMarginAdjustment,
+  positionSupportsMarginRemoval,
 } from '@lifi/perps-types'
 import Big from 'big.js'
 
 const NOTIONAL_FLOOR_RATIO = '0.1'
-const AMOUNT_INCREMENT = '0.000001'
+const AMOUNT_DECIMALS = 6
 
-function positivePositionAmount(value: string, field: string): Big {
-  let amount: Big
+function positionAmount(value: string, field: string): Big {
   try {
-    amount = new Big(value)
+    return new Big(value)
   } catch {
     throw new PerpsError(
       PerpsErrorCode.ValidationError,
       `Invalid decimal string on Position.${field}: '${value}'`
     )
   }
+}
+
+function positivePositionAmount(value: string, field: string): Big {
+  const amount = positionAmount(value, field)
   if (amount.lte(0)) {
     throw new PerpsError(
       PerpsErrorCode.ValidationError,
@@ -30,36 +33,44 @@ function positivePositionAmount(value: string, field: string): Big {
 }
 
 /**
- * Hyperliquid's exact documented transfer-margin requirement:
- * `max(initial_margin_required, 0.1 * total_position_value)`.
- *
- * Strict-isolated markets still return constraints because margin can be
- * added; their market capability prevents removal. Cross positions and
- * markets without individual margin adjustment return `undefined`.
+ * Hyperliquid removable isolated margin:
+ * `marginUsed − max(initial_margin_required, 0.1 × total_position_value)`.
+ * Hyperliquid isolated `marginUsed` already includes the unrealized PnL of
+ * the position, so the PnL is not added again, and it can reach zero or less
+ * before liquidation.
  *
+ * @returns `undefined` for cross positions and markets without individual
+ *   margin adjustment; `'0'` for add-only strict-isolated markets and when
+ *   nothing is removable.
+ * @throws {PerpsError} `ValidationError` when a required `Position` decimal
+ *   is malformed, or when a size, price or requirement is not positive.
  * @see https://hyperliquid.gitbook.io/hyperliquid-docs/trading/margining
  * @public
  */
-export function positionMarginConstraints(
+export function positionRemovableMargin(
   position: Position
-): PositionMarginConstraints | undefined {
+): string | undefined {
   if (!positionSupportsMarginAdjustment(position)) {
     return undefined
   }
+  if (!positionSupportsMarginRemoval(position)) {
+    return '0'
+  }
+  const marginUsed = positionAmount(position.marginUsed, 'marginUsed')
   const initialMargin = positivePositionAmount(
     position.initialMarginRequirement,
     'initialMarginRequirement'
   )
-  const notional = positivePositionAmount(position.size, 'size').times(
-    positivePositionAmount(position.markPrice, 'markPrice')
-  )
-  const notionalFloor = notional.times(NOTIONAL_FLOOR_RATIO)
+  const notionalFloor = positivePositionAmount(position.size, 'size')
+    .times(positivePositionAmount(position.markPrice, 'markPrice'))
+    .times(NOTIONAL_FLOOR_RATIO)
   const minimumMargin = initialMargin.gt(notionalFloor)
     ? initialMargin
     : notionalFloor
 
-  return {
-    minimumMarginRequirement: minimumMargin.toFixed(),
-    amountIncrement: AMOUNT_INCREMENT,
+  const removable = marginUsed.minus(minimumMargin)
+  if (removable.lte(0)) {
+    return '0'
   }
+  return removable.round(AMOUNT_DECIMALS, Big.roundDown).toFixed()
 }

package/src/utils/venueTotals.ts

@@ -0,0 +1,48 @@
+import type { HyperliquidMarginSummary, Position } from '@lifi/perps-types'
+import Big from 'big.js'
+import { toWireBig } from './decimal.js'
+
+/**
+ * One perps sub-dex entry {@link perpsTotals} reads. The REST response always
+ * carries `marginSummary`; a WebSocket frame may omit it.
+ * @public
+ */
+export interface DexMarginSummary {
+  marginSummary?: HyperliquidMarginSummary
+}
+
+/**
+ * Sum the venue `marginSummary` totals over every perps sub-dex of an
+ * account. `accountValue` is total equity, so it already carries locked
+ * margin and unrealized PnL. An entry without a `marginSummary` adds nothing.
+ * @public
+ */
+export const perpsTotals = (
+  dexStates: readonly DexMarginSummary[]
+): { accountValue: Big; marginUsed: Big } => {
+  let accountValue = new Big(0)
+  let marginUsed = new Big(0)
+  for (const { marginSummary } of dexStates) {
+    if (marginSummary === undefined) {
+      continue
+    }
+    accountValue = accountValue.plus(
+      toWireBig(marginSummary.accountValue, 'marginSummary.accountValue')
+    )
+    marginUsed = marginUsed.plus(
+      toWireBig(marginSummary.totalMarginUsed, 'marginSummary.totalMarginUsed')
+    )
+  }
+  return { accountValue, marginUsed }
+}
+
+/**
+ * Sum the unrealized PnL of every position, in quote-asset units.
+ * @public
+ */
+export const sumUnrealizedPnl = (positions: readonly Position[]): Big =>
+  positions.reduce(
+    (sum, position) =>
+      sum.plus(toWireBig(position.unrealizedPnl, 'position.unrealizedPnl')),
+    new Big(0)
+  )

package/src/utils/withdrawableBalances.ts

@@ -0,0 +1,69 @@
+import type { ProviderWithdrawableBalance } from '@lifi/perps-sdk'
+import type {
+  HlAbstractionMode,
+  HlClearinghouseState,
+  HlSpotClearinghouseState,
+} from '../types/index.js'
+import { isUnifiedAbstraction } from './abstractionMode.js'
+import { assetIsOutcome } from './assetId.js'
+import { toWireBig } from './decimal.js'
+
+/**
+ * Split a Hyperliquid account's venue figures into the routes a withdrawal
+ * draws on. A unified or portfolio-margin account holds its collateral in spot,
+ * so each spot token adds the part of `total` that no order or margin holds. A
+ * route with nothing left to draw carries no row, and the caller applies the
+ * per-asset venue minimum.
+ *
+ * @param quoteAssetId - `Asset.id` the perps-route row is keyed by.
+ * @param withdrawalFee - Flat venue fee in quote-asset units, set on every
+ *   quote-asset row. Absent leaves every row without a fee.
+ * @public
+ */
+export const hyperliquidWithdrawableBalances = (
+  abstraction: HlAbstractionMode | null,
+  state: HlClearinghouseState,
+  spotState: HlSpotClearinghouseState,
+  quoteAssetId: string,
+  withdrawalFee?: string
+): ProviderWithdrawableBalance[] => {
+  const rows: ProviderWithdrawableBalance[] = []
+  const fee =
+    withdrawalFee === undefined
+      ? undefined
+      : toWireBig(withdrawalFee, 'providers.withdrawalFeeUsd').toFixed()
+  const feeFor = (assetId: string) =>
+    fee === undefined || assetId !== quoteAssetId ? {} : { withdrawalFee: fee }
+
+  if (isUnifiedAbstraction(abstraction)) {
+    for (const balance of spotState.balances) {
+      if (assetIsOutcome(balance.coin)) {
+        continue
+      }
+      const spot = toWireBig(balance.total, 'spotBalance.total').minus(
+        toWireBig(balance.hold, 'spotBalance.hold')
+      )
+      if (spot.gt(0)) {
+        const assetId = String(balance.token)
+        rows.push({
+          assetId,
+          route: 'spot',
+          available: spot.toFixed(),
+          ...feeFor(assetId),
+        })
+      }
+    }
+  }
+
+  const perps = toWireBig(state.withdrawable, 'clearinghouseState.withdrawable')
+  if (perps.gt(0)) {
+    rows.push({
+      assetId: quoteAssetId,
+      route: 'perps',
+      available: perps.toFixed(),
+      ...feeFor(quoteAssetId),
+    })
+  }
+
+  return rows
+}

package/src/websocket/HyperliquidWsProvider.ts

@@ -1,4 +1,5 @@
 import {
+  DecodeChain,
   getMarketRegistry,
   isActiveMarket,
   isActiveOrderStatus,
@@ -10,7 +11,7 @@ import {
   ReconnectingWebSocket,
   resolveSubscribeQuote,
   type SubscriptionListener,
-  summarizeAccount,
+  toAssetDisplay,
   toPerpsMarketDisplay,
   WsProviderBase,
   type WsProviderFactory,
@@ -19,7 +20,6 @@ import {
   wsLog,
 } from '@lifi/perps-sdk'
 import type {
-  AccountResponse,
   Balance,
   MarketContext,
   Order,
@@ -37,9 +37,11 @@ import {
   SPOT_MARKET_ID,
 } from '../constants.js'
 import type {
+  HlActiveAssetData,
   HlAssetPosition,
   HlOrderDetail,
   HlOrderStatusResponse,
+  HlSpotClearinghouseState,
   HlUserFill,
   HlWsActiveAssetCtxData,
   HlWsActiveSpotAssetCtxData,
@@ -75,12 +77,13 @@ import {
   mapOrder,
   mapPosition,
   partitionSpotBalances,
+  perpsTotals,
   priceStepToAggregation,
   spotAssetFromToken,
   spotBalance,
   spotPriceById,
+  sumUnrealizedPnl,
 } from '../utils/index.js'
-import { DecodeChain } from './decodeChain.js'
 
 /** HL's compact `l2` snapshot carries 20 levels per side. */
 const HL_L2_BOOK_MAX_LEVELS_PER_SIDE = 20
@@ -88,6 +91,15 @@ const HL_L2_BOOK_MAX_LEVELS_PER_SIDE = 20
 const normalizeHlAddress = (address: string): string =>
   isAddress(address, { strict: false }) ? address.toLowerCase() : address
 
+/** Venue buying power for the asset the main perps dex settles in. */
+const availableAfterMaintenance = (
+  spotState: { tokenToAvailableAfterMaintenance?: readonly [number, string][] },
+  quoteAssetId: string | undefined
+): string | undefined =>
+  spotState.tokenToAvailableAfterMaintenance?.find(
+    ([token]) => String(token) === quoteAssetId
+  )?.[1]
+
 /**
  * `WsProviderFactory` constructor for Hyperliquid — pass to
  * `new PerpsWsClient(client, { wsProviders: { hyperliquid: hyperliquidWsProvider() } })`.
@@ -147,11 +159,16 @@ export class HyperliquidWsProvider extends WsProviderBase<object> {
     {
       releaseSpot: Promise<() => void>
       spot?: { collateralBalances: Balance[]; balances: Balance[] }
+      availableMargin?: string
+      availableMarginPending?: boolean
     }
   >()
   // Kept outside the pipeline entry: the first clearinghouse frame lands
   // while the mode read is still pending, before the pipeline exists.
-  private readonly latestPositionsByUser = new Map<string, Position[]>()
+  private readonly latestPerpsByUser = new Map<
+    string,
+    { positions: Position[]; marginUsed: string }
+  >()
   private readonly heldSummaryByUser = new Map<
     string,
     {
@@ -273,7 +290,8 @@ export class HyperliquidWsProvider extends WsProviderBase<object> {
       (sub.channel === 'marketContext' ||
         sub.channel === 'orderbook' ||
         sub.channel === 'candle' ||
-        sub.channel === 'trades')
+        sub.channel === 'trades' ||
+        sub.channel === 'availableToTrade')
     ) {
       this.registry.requireActive(sub.marketId)
     }
@@ -331,7 +349,7 @@ export class HyperliquidWsProvider extends WsProviderBase<object> {
           // subscription so a resubscribe reflects an account-mode change.
           this.abstractionByUser.delete(user)
           this.heldSummaryByUser.delete(user)
-          this.latestPositionsByUser.delete(user)
+          this.latestPerpsByUser.delete(user)
           this.syncUnifiedPipeline(user, user, null)
           this.unregisterSub(wireKey)
           this.rws.send(
@@ -506,6 +524,8 @@ export class HyperliquidWsProvider extends WsProviderBase<object> {
         return `accountSummary:${sub.address.toLowerCase()}`
       case 'spotBalances':
         return `spotState:${sub.address.toLowerCase()}`
+      case 'availableToTrade':
+        return `activeAssetData:${sub.address.toLowerCase()}:${sub.marketId}`
     }
   }
 
@@ -581,6 +601,12 @@ export class HyperliquidWsProvider extends WsProviderBase<object> {
         }
       case 'spotBalances':
         return { type: 'spotState', user: normalizeHlAddress(sub.address) }
+      case 'availableToTrade':
+        return {
+          type: 'activeAssetData',
+          user: normalizeHlAddress(sub.address),
+          coin: sub.marketId,
+        }
     }
   }
 
@@ -656,6 +682,9 @@ export class HyperliquidWsProvider extends WsProviderBase<object> {
         case 'spotState':
           this.handleSpotState(msg.data as HlWsSpotStateData)
           break
+        case 'activeAssetData':
+          this.handleActiveAssetData(msg.data as HlActiveAssetData)
+          break
       }
     } catch (error) {
       wsLog.handlerFailure(this.providerKey, error)
@@ -1130,30 +1159,26 @@ export class HyperliquidWsProvider extends WsProviderBase<object> {
       data: positions,
     })
 
-    this.latestPositionsByUser.set(data.user.toLowerCase(), positions)
-    this.emitUnifiedSummary(data.user.toLowerCase())
-
-    let accountValue = 0
-    let marginUsed = 0
-    for (const [, state] of data.clearinghouseStates) {
-      accountValue +=
-        Number.parseFloat(state.marginSummary?.accountValue ?? '') || 0
-      marginUsed +=
-        Number.parseFloat(state.marginSummary?.totalMarginUsed ?? '') || 0
-    }
-    const unrealizedPnl = positions.reduce(
-      (sum, p) => sum + (Number.parseFloat(p.unrealizedPnl) || 0),
-      0
+    const { accountValue, marginUsed } = perpsTotals(
+      data.clearinghouseStates.map(([, state]) => state)
     )
+
+    const key = data.user.toLowerCase()
+    this.latestPerpsByUser.set(key, {
+      positions,
+      marginUsed: marginUsed.toFixed(),
+    })
+    this.emitUnifiedSummary(key)
+
     // Equity semantics, matching the REST summary: `accountValue` already
     // carries locked margin and unrealized PnL. Spot balances stream apart,
     // so this portfolio value covers perps equity only — which is why the
     // frame is gated on the abstraction mode below.
     this.emitSummaryIfModeAllows(data.user, {
-      portfolioValue: accountValue.toString(),
-      availableMargin: (accountValue - marginUsed).toString(),
-      marginUsed: marginUsed.toString(),
-      unrealizedPnl: unrealizedPnl.toString(),
+      portfolioValue: accountValue.toFixed(),
+      availableMargin: accountValue.minus(marginUsed).toFixed(),
+      marginUsed: marginUsed.toFixed(),
+      unrealizedPnl: sumUnrealizedPnl(positions).toFixed(),
     })
   }
 
@@ -1219,24 +1244,32 @@ export class HyperliquidWsProvider extends WsProviderBase<object> {
 
   private emitUnifiedSummary(key: string) {
     const pipeline = this.unifiedSummaryByUser.get(key)
-    const positions = this.latestPositionsByUser.get(key)
+    const perps = this.latestPerpsByUser.get(key)
     // Both envelopes must have arrived: a spot-only summary would report
     // zero margin used against real positions.
-    if (pipeline?.spot === undefined || positions === undefined) {
+    if (
+      pipeline?.spot === undefined ||
+      pipeline.availableMargin === undefined ||
+      perps === undefined
+    ) {
       return
     }
-    const summary = summarizeAccount(
-      // summarizeAccount reads only the two balance lists.
-      {
-        collateralBalances: pipeline.spot.collateralBalances,
-        balances: pipeline.spot.balances,
-      } as AccountResponse,
-      positions,
-      'gross'
+    const portfolioValue = [
+      ...pipeline.spot.collateralBalances,
+      ...pipeline.spot.balances,
+    ].reduce(
+      (sum, balance) =>
+        sum.plus(toWireBig(balance.valueUsd, 'spotBalance.valueUsd')),
+      new Big(0)
     )
     this.emit(`accountSummary:${key}`, {
       channel: 'accountSummary',
-      data: summary,
+      data: {
+        portfolioValue: portfolioValue.toFixed(),
+        availableMargin: pipeline.availableMargin,
+        marginUsed: perps.marginUsed,
+        unrealizedPnl: sumUnrealizedPnl(perps.positions).toFixed(),
+      },
     })
   }
 
@@ -1334,6 +1367,27 @@ export class HyperliquidWsProvider extends WsProviderBase<object> {
     )
   }
 
+  private handleActiveAssetData(data: HlActiveAssetData) {
+    const market = this.registry?.get(data.coin)
+    if (market === undefined) {
+      throw new PerpsError(
+        PerpsErrorCode.ValidationError,
+        `[${this.providerKey}] activeAssetData frame names unknown market '${data.coin}'.`
+      )
+    }
+    const [buy, sell] = data.availableToTrade
+    this.emit(`activeAssetData:${data.user.toLowerCase()}:${data.coin}`, {
+      channel: 'availableToTrade',
+      data: {
+        providerId: market.providerId,
+        marketId: market.id,
+        asset: toAssetDisplay(market.quoteAsset),
+        buy,
+        sell,
+      },
+    })
+  }
+
   private handleSpotState(data: HlWsSpotStateData) {
     const user = data.user.toLowerCase()
     const markets = this.registry?.activeMarkets ?? []
@@ -1360,20 +1414,66 @@ export class HyperliquidWsProvider extends WsProviderBase<object> {
     const pipeline = this.unifiedSummaryByUser.get(user)
     if (pipeline !== undefined) {
       const quoteAssetIds = new Set(markets.map((m) => m.quoteAsset.id))
-      const entry = this.abstractionByUser.get(user)
-      const portfolioMargin =
-        entry !== undefined &&
-        entry !== 'pending' &&
-        entry.mode === HlAbstractionMode.PORTFOLIO_MARGIN
       // Same partition as getAccount so REST and WS agree on collateral.
       pipeline.spot = partitionSpotBalances(
         rows.map(({ balance }) => balance),
-        quoteAssetIds,
-        portfolioMargin
+        quoteAssetIds
       )
+      const settlementAssetId = markets.find(
+        (m) => m.categoryId === this.providerKey
+      )?.quoteAsset.id
+      const available = availableAfterMaintenance(
+        data.spotState,
+        settlementAssetId
+      )
+      if (available === undefined) {
+        this.fetchAvailableAfterMaintenance(user, data.user, settlementAssetId)
+      } else {
+        pipeline.availableMargin = available
+      }
       this.emitUnifiedSummary(user)
     }
   }
+
+  /** Read the venue buying power over REST when the spot frame omits it. */
+  private fetchAvailableAfterMaintenance(
+    key: string,
+    user: string,
+    quoteAssetId: string | undefined
+  ) {
+    const client = this.client
+    const pipeline = this.unifiedSummaryByUser.get(key)
+    if (
+      client === undefined ||
+      pipeline === undefined ||
+      pipeline.availableMarginPending
+    ) {
+      return
+    }
+    pipeline.availableMarginPending = true
+    infoRequest<HlSpotClearinghouseState>(
+      DEFAULT_HYPERLIQUID_API_URL,
+      { type: 'spotClearinghouseState', user },
+      hlInfoOptions(client)
+    ).then(
+      (state) => {
+        const current = this.unifiedSummaryByUser.get(key)
+        if (current === undefined) {
+          return
+        }
+        current.availableMarginPending = false
+        current.availableMargin = availableAfterMaintenance(state, quoteAssetId)
+        this.emitUnifiedSummary(key)
+      },
+      (error) => {
+        const current = this.unifiedSummaryByUser.get(key)
+        if (current !== undefined) {
+          current.availableMarginPending = false
+        }
+        wsLog.handlerFailure(this.providerKey, error)
+      }
+    )
+  }
 }
 
 const isObject = (v: unknown): v is Record<string, unknown> =>
@@ -1599,6 +1699,13 @@ function isValidHlFrame(channel: string, data: unknown): boolean {
         isObject(data.spotState) &&
         Array.isArray(data.spotState.balances)
       )
+    case 'activeAssetData':
+      return (
+        typeof data.user === 'string' &&
+        typeof data.coin === 'string' &&
+        Array.isArray(data.availableToTrade) &&
+        data.availableToTrade.length === 2
+      )
     default:
       return true
   }

package/dist/cjs/websocket/decodeChain.d.ts

@@ -1,11 +0,0 @@
-export type DecodeChainMode = 'every' | 'latest';
-export declare class DecodeChain {
-    private readonly mode;
-    private readonly onError;
-    private tail;
-    private queued;
-    constructor(mode: DecodeChainMode, onError: (error: unknown) => void);
-    push(decode: () => Promise<void>): void;
-    reset(): void;
-}
-//# sourceMappingURL=decodeChain.d.ts.map

package/dist/cjs/websocket/decodeChain.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"decodeChain.d.ts","sourceRoot":"","sources":["../../../src/websocket/decodeChain.ts"],"names":[],"mappings":"AAQA,MAAM,MAAM,eAAe,GAAG,OAAO,GAAG,QAAQ,CAAA;AAQhD,qBAAa,WAAW;IAKpB,OAAO,CAAC,QAAQ,CAAC,IAAI;IACrB,OAAO,CAAC,QAAQ,CAAC,OAAO;IAL1B,OAAO,CAAC,IAAI,CAAmC;IAC/C,OAAO,CAAC,MAAM,CAAmC;gBAG9B,IAAI,EAAE,eAAe,EACrB,OAAO,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI;IAGpD,IAAI,CAAC,MAAM,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI;IAwBvC,KAAK,IAAI,IAAI;CAId"}

package/dist/cjs/websocket/decodeChain.js

@@ -1,37 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.DecodeChain = void 0;
-class DecodeChain {
-    mode;
-    onError;
-    tail = Promise.resolve();
-    queued;
-    constructor(mode, onError) {
-        this.mode = mode;
-        this.onError = onError;
-    }
-    push(decode) {
-        if (this.mode === 'every') {
-            this.tail = this.tail.then(decode).catch(this.onError);
-            return;
-        }
-        const drainScheduled = this.queued !== undefined;
-        this.queued = decode;
-        if (drainScheduled) {
-            return;
-        }
-        this.tail = this.tail
-            .then(() => {
-            const next = this.queued;
-            this.queued = undefined;
-            return next?.();
-        })
-            .catch(this.onError);
-    }
-    reset() {
-        this.tail = Promise.resolve();
-        this.queued = undefined;
-    }
-}
-exports.DecodeChain = DecodeChain;
-//# sourceMappingURL=decodeChain.js.map

package/dist/cjs/websocket/decodeChain.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"decodeChain.js","sourceRoot":"","sources":["../../../src/websocket/decodeChain.ts"],"names":[],"mappings":";;;AAgBA,MAAa,WAAW;IAKH;IACA;IALX,IAAI,GAAkB,OAAO,CAAC,OAAO,EAAE,CAAA;IACvC,MAAM,CAAmC;IAEjD,YACmB,IAAqB,EACrB,OAAiC;QADjC,SAAI,GAAJ,IAAI,CAAiB;QACrB,YAAO,GAAP,OAAO,CAA0B;IACjD,CAAC;IAEJ,IAAI,CAAC,MAA2B;QAC9B,IAAI,IAAI,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;YAC1B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;YACtD,OAAM;QACR,CAAC;QACD,MAAM,cAAc,GAAG,IAAI,CAAC,MAAM,KAAK,SAAS,CAAA;QAChD,IAAI,CAAC,MAAM,GAAG,MAAM,CAAA;QACpB,IAAI,cAAc,EAAE,CAAC;YACnB,OAAM;QACR,CAAC;QACD,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI;aAClB,IAAI,CAAC,GAAG,EAAE;YACT,MAAM,IAAI,GAAG,IAAI,CAAC,MAAM,CAAA;YACxB,IAAI,CAAC,MAAM,GAAG,SAAS,CAAA;YACvB,OAAO,IAAI,EAAE,EAAE,CAAA;QACjB,CAAC,CAAC;aACD,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;IACxB,CAAC;IAOD,KAAK;QACH,IAAI,CAAC,IAAI,GAAG,OAAO,CAAC,OAAO,EAAE,CAAA;QAC7B,IAAI,CAAC,MAAM,GAAG,SAAS,CAAA;IACzB,CAAC;CACF;AArCD,kCAqCC"}

package/dist/esm/websocket/decodeChain.d.ts

@@ -1,30 +0,0 @@
-/**
- * Frame semantics of a {@link DecodeChain}:
- * - `'every'`: every frame decodes and applies in arrival order — required for
- *   delta-carrying channels, where dropping a frame corrupts downstream state.
- * - `'latest'`: frames queued behind an in-flight decode coalesce to the
- *   newest — for snapshot-like channels, where a newer frame supersedes
- *   anything still waiting.
- */
-export type DecodeChainMode = 'every' | 'latest';
-/**
- * Serializes async WS frame decodes so results apply in arrival order.
- * In `'latest'` mode a backlog (e.g. queued behind a main-thread stall)
- * collapses to its newest frame instead of replaying every stale decode.
- * Decode failures are reported to `onError` and never break the chain.
- */
-export declare class DecodeChain {
-    private readonly mode;
-    private readonly onError;
-    private tail;
-    private queued;
-    constructor(mode: DecodeChainMode, onError: (error: unknown) => void);
-    push(decode: () => Promise<void>): void;
-    /**
-     * Detach on connection teardown: drops the queued latest-mode decode and
-     * starts subsequent pushes on a fresh chain. A decode already in flight
-     * still settles.
-     */
-    reset(): void;
-}
-//# sourceMappingURL=decodeChain.d.ts.map