@taphubhq/sdk-core 0.26.1 → 0.27.0

package/README.md

@@ -12,6 +12,18 @@ For React bindings (hooks, providers, i18n), use
 pnpm add @taphubhq/sdk-core
 ```
 
+### Server compatibility
+
+The SDK's queries select the fields they need unconditionally, so a release that
+adds a field also raises the minimum grid-api it runs against. Check this before
+upgrading in an environment you do not deploy the server to.
+
+| sdk-core | Needs grid-api serving | Or else |
+| --- | --- | --- |
+| 0.27.0+ | `Bid.cellCandle { o h l c final touchSec touchPrice }` | `myBids` fails GraphQL validation and returns **no bids** |
+
+Deploy grid-api before the client, on every environment.
+
 ## Minimum Integration
 
 ```ts

package/dist/index.cjs

@@ -661,7 +661,22 @@ function normaliseBid(node) {
     refundAmount: node.refund_amount ?? null,
     slippage: node.slippage,
     createdAt: node.created_at || null,
-    meta: parseMeta(node.meta)
+    meta: parseMeta(node.meta),
+    // Absent and explicit null both mean "no candle" — an older server, an unselected
+    // field, a pending bid and purged ticks must all read the same to a consumer.
+    // `final` null (nullable Boolean) collapses to absent = settled, so only a real
+    // `false` puts the row in the in-progress presentation.
+    cellCandle: node.cellCandle ? {
+      o: node.cellCandle.o,
+      h: node.cellCandle.h,
+      l: node.cellCandle.l,
+      c: node.cellCandle.c,
+      ...typeof node.cellCandle.final === "boolean" ? { final: node.cellCandle.final } : {},
+      // Both legs or neither — see BidCellCandle.touchSec. Nulls (a non-win,
+      // or an older server) collapse to absent so a consumer only has to
+      // check one of them.
+      ...typeof node.cellCandle.touchSec === "number" && typeof node.cellCandle.touchPrice === "string" ? { touchSec: node.cellCandle.touchSec, touchPrice: node.cellCandle.touchPrice } : {}
+    } : null
   };
 }
 function normaliseBids(list) {
@@ -682,6 +697,7 @@ var PLACE_BID_MUTATION = `mutation PlaceBid($input: PlaceBidInput!) {
 var MY_BIDS_QUERY = `query MyBids($statuses: [BidStatus!], $limit: Int, $offset: Int, $pairId: ID) {
   myBids(statuses: $statuses, limit: $limit, offset: $offset, pairId: $pairId) {
     id user_id pair_id currency amount coefficient time1 time2 price1 price2 status payout refund_rate refund_amount slippage created_at meta
+    cellCandle { o h l c final touchSec touchPrice }
   }
 }`;
 var CANCEL_BID_MUTATION = `mutation CancelBid($input: CancelBidInput!) {
@@ -1849,6 +1865,23 @@ function mapWireBidResult(raw, topicPairId) {
         userId: p.user_id
       };
       if (typeof p.balance === "string") data.balance = p.balance;
+      const candle = p.cellCandle;
+      if (candle && typeof candle.o === "string" && typeof candle.h === "string" && typeof candle.l === "string" && typeof candle.c === "string") {
+        data.cellCandle = {
+          o: candle.o,
+          h: candle.h,
+          l: candle.l,
+          c: candle.c,
+          final: candle.final !== "false"
+        };
+        if (typeof candle.touchSec === "string" && typeof candle.touchPrice === "string") {
+          const touchSec = Number.parseInt(candle.touchSec, 10);
+          if (Number.isFinite(touchSec)) {
+            data.cellCandle.touchSec = touchSec;
+            data.cellCandle.touchPrice = candle.touchPrice;
+          }
+        }
+      }
       if (topicPairId !== void 0) data.pairId = topicPairId;
       return { event: "bidWon", data };
     }
@@ -1857,6 +1890,32 @@ function mapWireBidResult(raw, topicPairId) {
       if (topicPairId !== void 0) data.pairId = topicPairId;
       return { event: "bidLost", data };
     }
+    case "cell_candle_final": {
+      const candle = p.cellCandle;
+      if (!candle || typeof candle.o !== "string" || typeof candle.h !== "string" || typeof candle.l !== "string" || typeof candle.c !== "string") {
+        return null;
+      }
+      const data = {
+        bidId: p.bidId,
+        userId: p.user_id,
+        cellCandle: {
+          o: candle.o,
+          h: candle.h,
+          l: candle.l,
+          c: candle.c,
+          final: candle.final !== "false"
+        }
+      };
+      if (typeof candle.touchSec === "string" && typeof candle.touchPrice === "string") {
+        const touchSec = Number.parseInt(candle.touchSec, 10);
+        if (Number.isFinite(touchSec)) {
+          data.cellCandle.touchSec = touchSec;
+          data.cellCandle.touchPrice = candle.touchPrice;
+        }
+      }
+      if (topicPairId !== void 0) data.pairId = topicPairId;
+      return { event: "cellCandleFinal", data };
+    }
     default:
       console.warn(`Unknown bid_result type "${String(p.type)}"`);
       return null;
@@ -1974,6 +2033,7 @@ var RealtimeModule = class extends import_eventemitter35.default {
         else if (mapped.event === "bidAccepted") channel.emit("bidAccepted", mapped.data);
         else if (mapped.event === "bidWon") channel.emit("bidWon", mapped.data);
         else if (mapped.event === "bidLost") channel.emit("bidLost", mapped.data);
+        else if (mapped.event === "cellCandleFinal") channel.emit("cellCandleFinal", mapped.data);
         else if (mapped.event === "balanceUpdate") channel.emit("balanceUpdate", mapped.data);
         else if (mapped.event === "configUpdate") channel.emit("configUpdate", mapped.data);
         else if (mapped.event === "idealConfigUpdate")
@@ -2106,6 +2166,7 @@ var RealtimeModule = class extends import_eventemitter35.default {
       if (!mapped) return;
       if (mapped.event === "bidWon") channel.emit("bidWon", mapped.data);
       else if (mapped.event === "bidLost") channel.emit("bidLost", mapped.data);
+      else if (mapped.event === "cellCandleFinal") channel.emit("cellCandleFinal", mapped.data);
     };
     const onError = (err) => {
       channel.emit("error", err);

package/dist/index.d.mts

@@ -326,6 +326,39 @@ interface BidMeta {
     /** Display pair, e.g. "ETH/USD". */
     pairName: string;
 }
+/**
+ * The OHLC of a bid's cell window — what price did inside [time1, time2] on the bid's
+ * own pair, reduced from every stored tick covering it.
+ *
+ * Values are Decimal strings, not numbers: the archive stores 8 decimal places and
+ * parsing to a JS number here would round them before the UI ever sees them.
+ */
+interface BidCellCandle {
+    o: string;
+    h: string;
+    l: string;
+    c: string;
+    /**
+     * Whether the candle had CLOSED when it settled the bid.
+     *
+     * `false` = the values can still move: a 1m/5m win settles the instant the
+     * band is touched (the verdict is permanent) but the candle's O/C and extremes
+     * keep moving until it closes — delivered live over MQTT, and by `myBids` when
+     * the touching candle has not closed at read time. The UI shows such a value
+     * in the same not-yet-settled language the pending row uses. Absent (a server
+     * that predates the flag) means settled.
+     */
+    final?: boolean;
+    /**
+     * The WINNING TICK (TH-146 "success ticker"): the unix SECOND at which price
+     * entered the bid's band, and the price inside the band it entered at — what
+     * the popover shows as "reached <price> at <time>". Both present or both
+     * absent: a bid that did not win has no single moment that won it, and a
+     * server predating the field sends neither.
+     */
+    touchSec?: number;
+    touchPrice?: string;
+}
 interface Bid {
     id: string;
     userId: string;
@@ -363,6 +396,16 @@ interface Bid {
      * display pair instead of mapping `pairId` yourself.
      */
     meta?: BidMeta | null;
+    /**
+     * What price did inside this bid's cell window, served with the bid itself so a
+     * consumer never has to fetch it separately (openspec ux-260819-bid-detail-popover).
+     *
+     * Null in three cases a consumer should treat alike: the bid is still pending, its
+     * ticks are no longer stored, or the caller's query did not select the field. A
+     * cancelled bid DOES carry one — its window still elapsed — and the server attaches
+     * no verdict about what the outcome would have been.
+     */
+    cellCandle?: BidCellCandle | null;
 }
 interface CancelBidResult {
     bid: Bid;
@@ -1166,6 +1209,37 @@ interface MqttBidWonEvent {
     payout: string;
     userId: string;
     balance?: string;
+    /**
+     * OHLC of the candle whose band touch declared this win — the bid's
+     * `cellCandle`, shipped with the result so the client never has to refetch the
+     * bid list to learn it (openspec ux-260819, revised D2e).
+     *
+     * Sent on live wins and on D10 recovery alike (recovery hands over the stored
+     * candle whose touch it found). Absent only on any grid-api older than that
+     * change.
+     */
+    cellCandle?: {
+        o: string;
+        h: string;
+        l: string;
+        c: string;
+        /**
+         * Whether that candle had CLOSED when it settled the bid. A 1m/5m win settles
+         * the instant the band is touched — safe, because a touch is permanent — but
+         * the candle's O/C and extremes can still move until it closes. `false` means
+         * the client must present the value as not-yet-settled rather than final.
+         */
+        final: boolean;
+        /**
+         * The WINNING TICK (TH-146 "success ticker"): the unix SECOND at which price
+         * entered the bid's band, and the price inside the band it entered at. The
+         * engine's predicate is a range overlap, so this is neither the candle's
+         * close nor a raw extreme. Both present or both absent — a server that
+         * predates the field sends neither.
+         */
+        touchSec?: number;
+        touchPrice?: string;
+    };
     /**
      * Pair the won bid belongs to, e.g. "grid-ETH-USD". Derived from the result
      * topic (`game/{agencyId}:{pairId}/user/.../bid_result`) since the won payload
@@ -1175,6 +1249,38 @@ interface MqttBidWonEvent {
      */
     pairId?: string;
 }
+/**
+ * Follow-up patch grid-api publishes when the window of a building-candle win
+ * closes (wire type `cell_candle_final`): the CLOSED o/h/l/c of the candle the
+ * bid settled on, replacing the in-progress values the `bidWon` event carried
+ * with `cellCandle.final: false` (openspec ux-260819, design D2g).
+ *
+ * A patch, not a result: consumers must only update the bid's stored candle —
+ * never replay win side effects (sound, payout, balance).
+ */
+interface MqttCellCandleFinalEvent {
+    bidId: string;
+    userId: string;
+    cellCandle: {
+        o: string;
+        h: string;
+        l: string;
+        c: string;
+        /** Always true — the whole point of the event is that the candle closed. */
+        final: boolean;
+        /**
+         * The WINNING TICK (TH-146 "success ticker"): the unix SECOND at which price
+         * entered the bid's band, and the price inside the band it entered at. The
+         * engine's predicate is a range overlap, so this is neither the candle's
+         * close nor a raw extreme. Both present or both absent — a server that
+         * predates the field sends neither.
+         */
+        touchSec?: number;
+        touchPrice?: string;
+    };
+    /** Pair the bid belongs to (see {@link MqttBidWonEvent.pairId}). */
+    pairId?: string;
+}
 interface MqttBidLostEvent {
     bidId: string;
     /** Pair the lost bid belongs to (see {@link MqttBidWonEvent.pairId}). */
@@ -1268,6 +1374,7 @@ interface GameChannelEvents {
     bidAccepted: [MqttBidAcceptedEvent];
     bidWon: [MqttBidWonEvent];
     bidLost: [MqttBidLostEvent];
+    cellCandleFinal: [MqttCellCandleFinalEvent];
     bidCancelled: [MqttBidCancelledEvent];
     balanceUpdate: [MqttBalanceEvent];
     configUpdate: [MqttConfigEvent];
@@ -1298,6 +1405,7 @@ declare class MigrationChannel extends EventEmitter<MigrationChannelEvents> {
 interface UserBidsChannelEvents {
     bidWon: [MqttBidWonEvent];
     bidLost: [MqttBidLostEvent];
+    cellCandleFinal: [MqttCellCandleFinalEvent];
     error: [Error];
 }
 /**
@@ -1848,4 +1956,4 @@ declare function computeBaseline(candleClose: number, candleTimeSec: number, cel
     baselineTime: number;
 };
 
-export { type AgencyPairFilter, AgencyPairModule, type AgencyPairStats, type AgencyPairStatus, AuthModule, type BackendHealth, type Bid, BidModule, type BidStatus, CANDLE_EVENT, type CancelBidResult, type Candle, type CandleEventType, type CoefficientInput, type Constraints, type Currency, DEFAULT_CHART_HISTORY_LIMIT, DEFAULT_PROBE_TTL_SECONDS, DEFAULT_REGION, type ErrorMessageCatalog, type ErrorMessageMeta, type ErrorMessagesResponse, GameChannel, type GameConfig, type GridConfig, KNOWN_REGIONS, type KnownRegion, type LeaderboardEntry, LeaderboardModule, type LeaderboardPeriod, type LeaderboardSortBy, LocaleModule, type LocaleRefreshResult, type LocaleResponse, type LocaleTranslations, type LoginResult, type Me, MigrationChannel, type MigrationChannelEvents, type MigrationCompletedEvent, type MqttAcceptedBid, type MqttAgencyPairStatsEvent, type MqttAuthConfig, type MqttBalanceEvent, type MqttBidAcceptedEvent, type MqttBidLostEvent, type MqttBidWonEvent, type MqttCandleEvent, type MqttConfigEvent, type MqttIdealConfigEvent, type MqttWalletBalanceEvent, type MyRank, type NetworkLevel, type NetworkQuality, NetworkQualityMonitor, type Pair, type PairInfo, PairModule, type PlaceBidInput, type ProbeNearestRegionOptions, REGION_PROBE_CACHE_KEY, type RankBoard, type RankEntry, type RankPeriod, type RankSort, RealtimeModule, type RefreshTokenResult, type RegionDomainMap, type Sample, type SampleReason, type SignalSource, type SortDir, TaphubAuthError, TaphubClient, type TaphubClientConfig, TaphubError, TaphubEventBus, type TaphubEventMap, TaphubNetworkError, TaphubServerError, TaphubSlippageError, TaphubStorage, type TaphubStorageAdapter, TaphubValidationError, type User, UserBidsChannel, type UserBidsChannelEvents, UserModule, type UserPnL, type UserPnLPeriod, type Wallet as UserWallet, type Wallet$1 as Wallet, type WalletBalanceReason, WalletChannel, adaptiveSimpson, autoDetectStorage, calculateCoefficientWrapper, calculateProbHit, calculateProbWin, calculateProbWin_v2, computeBaseline, errorFunction, isCancelled, isKnownRegion, isLoss, isPending, isTerminal, isWin, normalCDF, normalPDF, normaliseLang, pairIdFromBidResultTopic, probeNearestRegion, resolveRegionBaseUrl, roundCoefToSignificantDigits };
+export { type AgencyPairFilter, AgencyPairModule, type AgencyPairStats, type AgencyPairStatus, AuthModule, type BackendHealth, type Bid, type BidCellCandle, BidModule, type BidStatus, CANDLE_EVENT, type CancelBidResult, type Candle, type CandleEventType, type CoefficientInput, type Constraints, type Currency, DEFAULT_CHART_HISTORY_LIMIT, DEFAULT_PROBE_TTL_SECONDS, DEFAULT_REGION, type ErrorMessageCatalog, type ErrorMessageMeta, type ErrorMessagesResponse, GameChannel, type GameConfig, type GridConfig, KNOWN_REGIONS, type KnownRegion, type LeaderboardEntry, LeaderboardModule, type LeaderboardPeriod, type LeaderboardSortBy, LocaleModule, type LocaleRefreshResult, type LocaleResponse, type LocaleTranslations, type LoginResult, type Me, MigrationChannel, type MigrationChannelEvents, type MigrationCompletedEvent, type MqttAcceptedBid, type MqttAgencyPairStatsEvent, type MqttAuthConfig, type MqttBalanceEvent, type MqttBidAcceptedEvent, type MqttBidLostEvent, type MqttBidWonEvent, type MqttCandleEvent, type MqttCellCandleFinalEvent, type MqttConfigEvent, type MqttIdealConfigEvent, type MqttWalletBalanceEvent, type MyRank, type NetworkLevel, type NetworkQuality, NetworkQualityMonitor, type Pair, type PairInfo, PairModule, type PlaceBidInput, type ProbeNearestRegionOptions, REGION_PROBE_CACHE_KEY, type RankBoard, type RankEntry, type RankPeriod, type RankSort, RealtimeModule, type RefreshTokenResult, type RegionDomainMap, type Sample, type SampleReason, type SignalSource, type SortDir, TaphubAuthError, TaphubClient, type TaphubClientConfig, TaphubError, TaphubEventBus, type TaphubEventMap, TaphubNetworkError, TaphubServerError, TaphubSlippageError, TaphubStorage, type TaphubStorageAdapter, TaphubValidationError, type User, UserBidsChannel, type UserBidsChannelEvents, UserModule, type UserPnL, type UserPnLPeriod, type Wallet as UserWallet, type Wallet$1 as Wallet, type WalletBalanceReason, WalletChannel, adaptiveSimpson, autoDetectStorage, calculateCoefficientWrapper, calculateProbHit, calculateProbWin, calculateProbWin_v2, computeBaseline, errorFunction, isCancelled, isKnownRegion, isLoss, isPending, isTerminal, isWin, normalCDF, normalPDF, normaliseLang, pairIdFromBidResultTopic, probeNearestRegion, resolveRegionBaseUrl, roundCoefToSignificantDigits };

package/dist/index.d.ts

@@ -326,6 +326,39 @@ interface BidMeta {
     /** Display pair, e.g. "ETH/USD". */
     pairName: string;
 }
+/**
+ * The OHLC of a bid's cell window — what price did inside [time1, time2] on the bid's
+ * own pair, reduced from every stored tick covering it.
+ *
+ * Values are Decimal strings, not numbers: the archive stores 8 decimal places and
+ * parsing to a JS number here would round them before the UI ever sees them.
+ */
+interface BidCellCandle {
+    o: string;
+    h: string;
+    l: string;
+    c: string;
+    /**
+     * Whether the candle had CLOSED when it settled the bid.
+     *
+     * `false` = the values can still move: a 1m/5m win settles the instant the
+     * band is touched (the verdict is permanent) but the candle's O/C and extremes
+     * keep moving until it closes — delivered live over MQTT, and by `myBids` when
+     * the touching candle has not closed at read time. The UI shows such a value
+     * in the same not-yet-settled language the pending row uses. Absent (a server
+     * that predates the flag) means settled.
+     */
+    final?: boolean;
+    /**
+     * The WINNING TICK (TH-146 "success ticker"): the unix SECOND at which price
+     * entered the bid's band, and the price inside the band it entered at — what
+     * the popover shows as "reached <price> at <time>". Both present or both
+     * absent: a bid that did not win has no single moment that won it, and a
+     * server predating the field sends neither.
+     */
+    touchSec?: number;
+    touchPrice?: string;
+}
 interface Bid {
     id: string;
     userId: string;
@@ -363,6 +396,16 @@ interface Bid {
      * display pair instead of mapping `pairId` yourself.
      */
     meta?: BidMeta | null;
+    /**
+     * What price did inside this bid's cell window, served with the bid itself so a
+     * consumer never has to fetch it separately (openspec ux-260819-bid-detail-popover).
+     *
+     * Null in three cases a consumer should treat alike: the bid is still pending, its
+     * ticks are no longer stored, or the caller's query did not select the field. A
+     * cancelled bid DOES carry one — its window still elapsed — and the server attaches
+     * no verdict about what the outcome would have been.
+     */
+    cellCandle?: BidCellCandle | null;
 }
 interface CancelBidResult {
     bid: Bid;
@@ -1166,6 +1209,37 @@ interface MqttBidWonEvent {
     payout: string;
     userId: string;
     balance?: string;
+    /**
+     * OHLC of the candle whose band touch declared this win — the bid's
+     * `cellCandle`, shipped with the result so the client never has to refetch the
+     * bid list to learn it (openspec ux-260819, revised D2e).
+     *
+     * Sent on live wins and on D10 recovery alike (recovery hands over the stored
+     * candle whose touch it found). Absent only on any grid-api older than that
+     * change.
+     */
+    cellCandle?: {
+        o: string;
+        h: string;
+        l: string;
+        c: string;
+        /**
+         * Whether that candle had CLOSED when it settled the bid. A 1m/5m win settles
+         * the instant the band is touched — safe, because a touch is permanent — but
+         * the candle's O/C and extremes can still move until it closes. `false` means
+         * the client must present the value as not-yet-settled rather than final.
+         */
+        final: boolean;
+        /**
+         * The WINNING TICK (TH-146 "success ticker"): the unix SECOND at which price
+         * entered the bid's band, and the price inside the band it entered at. The
+         * engine's predicate is a range overlap, so this is neither the candle's
+         * close nor a raw extreme. Both present or both absent — a server that
+         * predates the field sends neither.
+         */
+        touchSec?: number;
+        touchPrice?: string;
+    };
     /**
      * Pair the won bid belongs to, e.g. "grid-ETH-USD". Derived from the result
      * topic (`game/{agencyId}:{pairId}/user/.../bid_result`) since the won payload
@@ -1175,6 +1249,38 @@ interface MqttBidWonEvent {
      */
     pairId?: string;
 }
+/**
+ * Follow-up patch grid-api publishes when the window of a building-candle win
+ * closes (wire type `cell_candle_final`): the CLOSED o/h/l/c of the candle the
+ * bid settled on, replacing the in-progress values the `bidWon` event carried
+ * with `cellCandle.final: false` (openspec ux-260819, design D2g).
+ *
+ * A patch, not a result: consumers must only update the bid's stored candle —
+ * never replay win side effects (sound, payout, balance).
+ */
+interface MqttCellCandleFinalEvent {
+    bidId: string;
+    userId: string;
+    cellCandle: {
+        o: string;
+        h: string;
+        l: string;
+        c: string;
+        /** Always true — the whole point of the event is that the candle closed. */
+        final: boolean;
+        /**
+         * The WINNING TICK (TH-146 "success ticker"): the unix SECOND at which price
+         * entered the bid's band, and the price inside the band it entered at. The
+         * engine's predicate is a range overlap, so this is neither the candle's
+         * close nor a raw extreme. Both present or both absent — a server that
+         * predates the field sends neither.
+         */
+        touchSec?: number;
+        touchPrice?: string;
+    };
+    /** Pair the bid belongs to (see {@link MqttBidWonEvent.pairId}). */
+    pairId?: string;
+}
 interface MqttBidLostEvent {
     bidId: string;
     /** Pair the lost bid belongs to (see {@link MqttBidWonEvent.pairId}). */
@@ -1268,6 +1374,7 @@ interface GameChannelEvents {
     bidAccepted: [MqttBidAcceptedEvent];
     bidWon: [MqttBidWonEvent];
     bidLost: [MqttBidLostEvent];
+    cellCandleFinal: [MqttCellCandleFinalEvent];
     bidCancelled: [MqttBidCancelledEvent];
     balanceUpdate: [MqttBalanceEvent];
     configUpdate: [MqttConfigEvent];
@@ -1298,6 +1405,7 @@ declare class MigrationChannel extends EventEmitter<MigrationChannelEvents> {
 interface UserBidsChannelEvents {
     bidWon: [MqttBidWonEvent];
     bidLost: [MqttBidLostEvent];
+    cellCandleFinal: [MqttCellCandleFinalEvent];
     error: [Error];
 }
 /**
@@ -1848,4 +1956,4 @@ declare function computeBaseline(candleClose: number, candleTimeSec: number, cel
     baselineTime: number;
 };
 
-export { type AgencyPairFilter, AgencyPairModule, type AgencyPairStats, type AgencyPairStatus, AuthModule, type BackendHealth, type Bid, BidModule, type BidStatus, CANDLE_EVENT, type CancelBidResult, type Candle, type CandleEventType, type CoefficientInput, type Constraints, type Currency, DEFAULT_CHART_HISTORY_LIMIT, DEFAULT_PROBE_TTL_SECONDS, DEFAULT_REGION, type ErrorMessageCatalog, type ErrorMessageMeta, type ErrorMessagesResponse, GameChannel, type GameConfig, type GridConfig, KNOWN_REGIONS, type KnownRegion, type LeaderboardEntry, LeaderboardModule, type LeaderboardPeriod, type LeaderboardSortBy, LocaleModule, type LocaleRefreshResult, type LocaleResponse, type LocaleTranslations, type LoginResult, type Me, MigrationChannel, type MigrationChannelEvents, type MigrationCompletedEvent, type MqttAcceptedBid, type MqttAgencyPairStatsEvent, type MqttAuthConfig, type MqttBalanceEvent, type MqttBidAcceptedEvent, type MqttBidLostEvent, type MqttBidWonEvent, type MqttCandleEvent, type MqttConfigEvent, type MqttIdealConfigEvent, type MqttWalletBalanceEvent, type MyRank, type NetworkLevel, type NetworkQuality, NetworkQualityMonitor, type Pair, type PairInfo, PairModule, type PlaceBidInput, type ProbeNearestRegionOptions, REGION_PROBE_CACHE_KEY, type RankBoard, type RankEntry, type RankPeriod, type RankSort, RealtimeModule, type RefreshTokenResult, type RegionDomainMap, type Sample, type SampleReason, type SignalSource, type SortDir, TaphubAuthError, TaphubClient, type TaphubClientConfig, TaphubError, TaphubEventBus, type TaphubEventMap, TaphubNetworkError, TaphubServerError, TaphubSlippageError, TaphubStorage, type TaphubStorageAdapter, TaphubValidationError, type User, UserBidsChannel, type UserBidsChannelEvents, UserModule, type UserPnL, type UserPnLPeriod, type Wallet as UserWallet, type Wallet$1 as Wallet, type WalletBalanceReason, WalletChannel, adaptiveSimpson, autoDetectStorage, calculateCoefficientWrapper, calculateProbHit, calculateProbWin, calculateProbWin_v2, computeBaseline, errorFunction, isCancelled, isKnownRegion, isLoss, isPending, isTerminal, isWin, normalCDF, normalPDF, normaliseLang, pairIdFromBidResultTopic, probeNearestRegion, resolveRegionBaseUrl, roundCoefToSignificantDigits };
+export { type AgencyPairFilter, AgencyPairModule, type AgencyPairStats, type AgencyPairStatus, AuthModule, type BackendHealth, type Bid, type BidCellCandle, BidModule, type BidStatus, CANDLE_EVENT, type CancelBidResult, type Candle, type CandleEventType, type CoefficientInput, type Constraints, type Currency, DEFAULT_CHART_HISTORY_LIMIT, DEFAULT_PROBE_TTL_SECONDS, DEFAULT_REGION, type ErrorMessageCatalog, type ErrorMessageMeta, type ErrorMessagesResponse, GameChannel, type GameConfig, type GridConfig, KNOWN_REGIONS, type KnownRegion, type LeaderboardEntry, LeaderboardModule, type LeaderboardPeriod, type LeaderboardSortBy, LocaleModule, type LocaleRefreshResult, type LocaleResponse, type LocaleTranslations, type LoginResult, type Me, MigrationChannel, type MigrationChannelEvents, type MigrationCompletedEvent, type MqttAcceptedBid, type MqttAgencyPairStatsEvent, type MqttAuthConfig, type MqttBalanceEvent, type MqttBidAcceptedEvent, type MqttBidLostEvent, type MqttBidWonEvent, type MqttCandleEvent, type MqttCellCandleFinalEvent, type MqttConfigEvent, type MqttIdealConfigEvent, type MqttWalletBalanceEvent, type MyRank, type NetworkLevel, type NetworkQuality, NetworkQualityMonitor, type Pair, type PairInfo, PairModule, type PlaceBidInput, type ProbeNearestRegionOptions, REGION_PROBE_CACHE_KEY, type RankBoard, type RankEntry, type RankPeriod, type RankSort, RealtimeModule, type RefreshTokenResult, type RegionDomainMap, type Sample, type SampleReason, type SignalSource, type SortDir, TaphubAuthError, TaphubClient, type TaphubClientConfig, TaphubError, TaphubEventBus, type TaphubEventMap, TaphubNetworkError, TaphubServerError, TaphubSlippageError, TaphubStorage, type TaphubStorageAdapter, TaphubValidationError, type User, UserBidsChannel, type UserBidsChannelEvents, UserModule, type UserPnL, type UserPnLPeriod, type Wallet as UserWallet, type Wallet$1 as Wallet, type WalletBalanceReason, WalletChannel, adaptiveSimpson, autoDetectStorage, calculateCoefficientWrapper, calculateProbHit, calculateProbWin, calculateProbWin_v2, computeBaseline, errorFunction, isCancelled, isKnownRegion, isLoss, isPending, isTerminal, isWin, normalCDF, normalPDF, normaliseLang, pairIdFromBidResultTopic, probeNearestRegion, resolveRegionBaseUrl, roundCoefToSignificantDigits };

package/dist/index.js

@@ -581,7 +581,22 @@ function normaliseBid(node) {
     refundAmount: node.refund_amount ?? null,
     slippage: node.slippage,
     createdAt: node.created_at || null,
-    meta: parseMeta(node.meta)
+    meta: parseMeta(node.meta),
+    // Absent and explicit null both mean "no candle" — an older server, an unselected
+    // field, a pending bid and purged ticks must all read the same to a consumer.
+    // `final` null (nullable Boolean) collapses to absent = settled, so only a real
+    // `false` puts the row in the in-progress presentation.
+    cellCandle: node.cellCandle ? {
+      o: node.cellCandle.o,
+      h: node.cellCandle.h,
+      l: node.cellCandle.l,
+      c: node.cellCandle.c,
+      ...typeof node.cellCandle.final === "boolean" ? { final: node.cellCandle.final } : {},
+      // Both legs or neither — see BidCellCandle.touchSec. Nulls (a non-win,
+      // or an older server) collapse to absent so a consumer only has to
+      // check one of them.
+      ...typeof node.cellCandle.touchSec === "number" && typeof node.cellCandle.touchPrice === "string" ? { touchSec: node.cellCandle.touchSec, touchPrice: node.cellCandle.touchPrice } : {}
+    } : null
   };
 }
 function normaliseBids(list) {
@@ -602,6 +617,7 @@ var PLACE_BID_MUTATION = `mutation PlaceBid($input: PlaceBidInput!) {
 var MY_BIDS_QUERY = `query MyBids($statuses: [BidStatus!], $limit: Int, $offset: Int, $pairId: ID) {
   myBids(statuses: $statuses, limit: $limit, offset: $offset, pairId: $pairId) {
     id user_id pair_id currency amount coefficient time1 time2 price1 price2 status payout refund_rate refund_amount slippage created_at meta
+    cellCandle { o h l c final touchSec touchPrice }
   }
 }`;
 var CANCEL_BID_MUTATION = `mutation CancelBid($input: CancelBidInput!) {
@@ -1769,6 +1785,23 @@ function mapWireBidResult(raw, topicPairId) {
         userId: p.user_id
       };
       if (typeof p.balance === "string") data.balance = p.balance;
+      const candle = p.cellCandle;
+      if (candle && typeof candle.o === "string" && typeof candle.h === "string" && typeof candle.l === "string" && typeof candle.c === "string") {
+        data.cellCandle = {
+          o: candle.o,
+          h: candle.h,
+          l: candle.l,
+          c: candle.c,
+          final: candle.final !== "false"
+        };
+        if (typeof candle.touchSec === "string" && typeof candle.touchPrice === "string") {
+          const touchSec = Number.parseInt(candle.touchSec, 10);
+          if (Number.isFinite(touchSec)) {
+            data.cellCandle.touchSec = touchSec;
+            data.cellCandle.touchPrice = candle.touchPrice;
+          }
+        }
+      }
       if (topicPairId !== void 0) data.pairId = topicPairId;
       return { event: "bidWon", data };
     }
@@ -1777,6 +1810,32 @@ function mapWireBidResult(raw, topicPairId) {
       if (topicPairId !== void 0) data.pairId = topicPairId;
       return { event: "bidLost", data };
     }
+    case "cell_candle_final": {
+      const candle = p.cellCandle;
+      if (!candle || typeof candle.o !== "string" || typeof candle.h !== "string" || typeof candle.l !== "string" || typeof candle.c !== "string") {
+        return null;
+      }
+      const data = {
+        bidId: p.bidId,
+        userId: p.user_id,
+        cellCandle: {
+          o: candle.o,
+          h: candle.h,
+          l: candle.l,
+          c: candle.c,
+          final: candle.final !== "false"
+        }
+      };
+      if (typeof candle.touchSec === "string" && typeof candle.touchPrice === "string") {
+        const touchSec = Number.parseInt(candle.touchSec, 10);
+        if (Number.isFinite(touchSec)) {
+          data.cellCandle.touchSec = touchSec;
+          data.cellCandle.touchPrice = candle.touchPrice;
+        }
+      }
+      if (topicPairId !== void 0) data.pairId = topicPairId;
+      return { event: "cellCandleFinal", data };
+    }
     default:
       console.warn(`Unknown bid_result type "${String(p.type)}"`);
       return null;
@@ -1894,6 +1953,7 @@ var RealtimeModule = class extends EventEmitter5 {
         else if (mapped.event === "bidAccepted") channel.emit("bidAccepted", mapped.data);
         else if (mapped.event === "bidWon") channel.emit("bidWon", mapped.data);
         else if (mapped.event === "bidLost") channel.emit("bidLost", mapped.data);
+        else if (mapped.event === "cellCandleFinal") channel.emit("cellCandleFinal", mapped.data);
         else if (mapped.event === "balanceUpdate") channel.emit("balanceUpdate", mapped.data);
         else if (mapped.event === "configUpdate") channel.emit("configUpdate", mapped.data);
         else if (mapped.event === "idealConfigUpdate")
@@ -2026,6 +2086,7 @@ var RealtimeModule = class extends EventEmitter5 {
       if (!mapped) return;
       if (mapped.event === "bidWon") channel.emit("bidWon", mapped.data);
       else if (mapped.event === "bidLost") channel.emit("bidLost", mapped.data);
+      else if (mapped.event === "cellCandleFinal") channel.emit("cellCandleFinal", mapped.data);
     };
     const onError = (err) => {
       channel.emit("error", err);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@taphubhq/sdk-core",
-  "version": "0.26.1",
+  "version": "0.27.0",
   "description": "Core SDK for building on the TabHub platform",
   "license": "MIT",
   "main": "./dist/index.cjs",