@taphubhq/sdk-core 0.25.4 → 0.25.5

package/dist/index.cjs

@@ -33,6 +33,8 @@ __export(index_exports, {
   AgencyPairModule: () => AgencyPairModule,
   AuthModule: () => AuthModule,
   BidModule: () => BidModule,
+  CANDLE_EVENT: () => CANDLE_EVENT,
+  DEFAULT_CHART_HISTORY_LIMIT: () => DEFAULT_CHART_HISTORY_LIMIT,
   LeaderboardModule: () => LeaderboardModule,
   LocaleModule: () => LocaleModule,
   NetworkQualityMonitor: () => NetworkQualityMonitor,
@@ -1147,6 +1149,9 @@ var BUILDER_AVAILABLE_GAME_PAIRS_QUERY = `query BuilderAvailableGamePairs($gamep
   }
 }`;
 
+// src/modules/pair/types.ts
+var DEFAULT_CHART_HISTORY_LIMIT = 600;
+
 // src/modules/pair/index.ts
 var PairModule = class {
   #graphql;
@@ -1204,11 +1209,8 @@ var PairModule = class {
     return body.builderAvailableGamePairs.map(normalisePairInfo);
   }
   // REVIEW[bid-260602-v2]: chartHistory param/variable renamed pairId (was: agencyPairId/gameId)
-  async chartHistory(pairId, limit, opts) {
-    const variables = { pairId };
-    if (limit !== void 0) {
-      variables.limit = limit;
-    }
+  async chartHistory(pairId, limit = DEFAULT_CHART_HISTORY_LIMIT, opts) {
+    const variables = { pairId, limit };
     const body = await this.#graphql.request(
       CHART_HISTORY_QUERY,
       variables,
@@ -3159,6 +3161,12 @@ var TaphubClient = class {
   }
 };
 
+// src/modules/realtime/types.ts
+var CANDLE_EVENT = {
+  NEW: "new",
+  UPDATE: "update"
+};
+
 // src/utils/coefficient.ts
 function errorFunction(x) {
   const a1 = 0.254829592;
@@ -3248,6 +3256,8 @@ function calculateProbWin_v2(time1, time2, _price1, price2, creationTime, curren
   AgencyPairModule,
   AuthModule,
   BidModule,
+  CANDLE_EVENT,
+  DEFAULT_CHART_HISTORY_LIMIT,
   LeaderboardModule,
   LocaleModule,
   NetworkQualityMonitor,

package/dist/index.d.mts

@@ -709,6 +709,13 @@ interface PairInfo {
      */
     agencyPairId: string | null;
 }
+/**
+ * Default number of candles fetched on initial chart load when the caller does
+ * not pass an explicit limit. The server clamps any request to its cache size
+ * (grid-api services.ChartHistoryMaxLimit = 1500), so this is purely how much
+ * history the chart shows by default — kept lower than the cap for faster init.
+ */
+declare const DEFAULT_CHART_HISTORY_LIMIT = 600;
 interface Candle {
     /** Unix epoch SECONDS (not ms). Multiply by 1000 for JS Date. */
     time: number;
@@ -906,6 +913,16 @@ interface MqttTransport {
     close(): void;
 }
 
+/**
+ * Candle tick kind. `new` = a fresh bar opened; `update` = the current bar was
+ * revised. Exported as named constants so consumers compare against these
+ * instead of bare string literals (a typo on a literal fails silently).
+ */
+declare const CANDLE_EVENT: {
+    readonly NEW: "new";
+    readonly UPDATE: "update";
+};
+type CandleEventType = (typeof CANDLE_EVENT)[keyof typeof CANDLE_EVENT];
 /**
  * Candle tick from MQTT.
  * WARNING: `time` is Unix epoch MILLISECONDS.
@@ -913,7 +930,7 @@ interface MqttTransport {
  * Do NOT multiply MQTT candle time by 1000.
  */
 interface MqttCandleEvent {
-    type: 'new' | 'update';
+    type: CandleEventType;
     /** Unix epoch **milliseconds** — differs from GQL chartHistory (seconds) */
     time: number;
     o: number;
@@ -1415,4 +1432,4 @@ declare function adaptiveSimpson(f: (x: number) => number, a: number, b: number,
 declare function calculateProbWin(time1: number, time2: number, _price1: number, price2: number, creationTime: number, currentPrice: number, volatility: number): number;
 declare function calculateProbWin_v2(time1: number, time2: number, _price1: number, price2: number, creationTime: number, currentPrice: number, volatility: number): number;
 
-export { type AgencyPairFilter, AgencyPairModule, type AgencyPairStats, type AgencyPairStatus, AuthModule, type BackendHealth, type Bid, BidModule, type BidStatus, type CancelBidResult, type Candle, type Constraints, type Currency, type ErrorMessageCatalog, type ErrorMessageMeta, type ErrorMessagesResponse, GameChannel, type GameConfig, type GridConfig, type LeaderboardEntry, LeaderboardModule, type LeaderboardPeriod, type LeaderboardSortBy, LocaleModule, type LocaleRefreshResult, type LocaleResponse, type LocaleTranslations, type LoginResult, type Me, 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 RankBoard, type RankEntry, type RankPeriod, type RankSort, RealtimeModule, 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, calculateProbWin, calculateProbWin_v2, errorFunction, isCancelled, isLoss, isPending, isTerminal, isWin, normalCDF, normalPDF, normaliseLang, pairIdFromBidResultTopic };
+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 Constraints, type Currency, DEFAULT_CHART_HISTORY_LIMIT, type ErrorMessageCatalog, type ErrorMessageMeta, type ErrorMessagesResponse, GameChannel, type GameConfig, type GridConfig, type LeaderboardEntry, LeaderboardModule, type LeaderboardPeriod, type LeaderboardSortBy, LocaleModule, type LocaleRefreshResult, type LocaleResponse, type LocaleTranslations, type LoginResult, type Me, 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 RankBoard, type RankEntry, type RankPeriod, type RankSort, RealtimeModule, 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, calculateProbWin, calculateProbWin_v2, errorFunction, isCancelled, isLoss, isPending, isTerminal, isWin, normalCDF, normalPDF, normaliseLang, pairIdFromBidResultTopic };

package/dist/index.d.ts

@@ -709,6 +709,13 @@ interface PairInfo {
      */
     agencyPairId: string | null;
 }
+/**
+ * Default number of candles fetched on initial chart load when the caller does
+ * not pass an explicit limit. The server clamps any request to its cache size
+ * (grid-api services.ChartHistoryMaxLimit = 1500), so this is purely how much
+ * history the chart shows by default — kept lower than the cap for faster init.
+ */
+declare const DEFAULT_CHART_HISTORY_LIMIT = 600;
 interface Candle {
     /** Unix epoch SECONDS (not ms). Multiply by 1000 for JS Date. */
     time: number;
@@ -906,6 +913,16 @@ interface MqttTransport {
     close(): void;
 }
 
+/**
+ * Candle tick kind. `new` = a fresh bar opened; `update` = the current bar was
+ * revised. Exported as named constants so consumers compare against these
+ * instead of bare string literals (a typo on a literal fails silently).
+ */
+declare const CANDLE_EVENT: {
+    readonly NEW: "new";
+    readonly UPDATE: "update";
+};
+type CandleEventType = (typeof CANDLE_EVENT)[keyof typeof CANDLE_EVENT];
 /**
  * Candle tick from MQTT.
  * WARNING: `time` is Unix epoch MILLISECONDS.
@@ -913,7 +930,7 @@ interface MqttTransport {
  * Do NOT multiply MQTT candle time by 1000.
  */
 interface MqttCandleEvent {
-    type: 'new' | 'update';
+    type: CandleEventType;
     /** Unix epoch **milliseconds** — differs from GQL chartHistory (seconds) */
     time: number;
     o: number;
@@ -1415,4 +1432,4 @@ declare function adaptiveSimpson(f: (x: number) => number, a: number, b: number,
 declare function calculateProbWin(time1: number, time2: number, _price1: number, price2: number, creationTime: number, currentPrice: number, volatility: number): number;
 declare function calculateProbWin_v2(time1: number, time2: number, _price1: number, price2: number, creationTime: number, currentPrice: number, volatility: number): number;
 
-export { type AgencyPairFilter, AgencyPairModule, type AgencyPairStats, type AgencyPairStatus, AuthModule, type BackendHealth, type Bid, BidModule, type BidStatus, type CancelBidResult, type Candle, type Constraints, type Currency, type ErrorMessageCatalog, type ErrorMessageMeta, type ErrorMessagesResponse, GameChannel, type GameConfig, type GridConfig, type LeaderboardEntry, LeaderboardModule, type LeaderboardPeriod, type LeaderboardSortBy, LocaleModule, type LocaleRefreshResult, type LocaleResponse, type LocaleTranslations, type LoginResult, type Me, 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 RankBoard, type RankEntry, type RankPeriod, type RankSort, RealtimeModule, 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, calculateProbWin, calculateProbWin_v2, errorFunction, isCancelled, isLoss, isPending, isTerminal, isWin, normalCDF, normalPDF, normaliseLang, pairIdFromBidResultTopic };
+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 Constraints, type Currency, DEFAULT_CHART_HISTORY_LIMIT, type ErrorMessageCatalog, type ErrorMessageMeta, type ErrorMessagesResponse, GameChannel, type GameConfig, type GridConfig, type LeaderboardEntry, LeaderboardModule, type LeaderboardPeriod, type LeaderboardSortBy, LocaleModule, type LocaleRefreshResult, type LocaleResponse, type LocaleTranslations, type LoginResult, type Me, 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 RankBoard, type RankEntry, type RankPeriod, type RankSort, RealtimeModule, 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, calculateProbWin, calculateProbWin_v2, errorFunction, isCancelled, isLoss, isPending, isTerminal, isWin, normalCDF, normalPDF, normaliseLang, pairIdFromBidResultTopic };

package/dist/index.js

@@ -1080,6 +1080,9 @@ var BUILDER_AVAILABLE_GAME_PAIRS_QUERY = `query BuilderAvailableGamePairs($gamep
   }
 }`;
 
+// src/modules/pair/types.ts
+var DEFAULT_CHART_HISTORY_LIMIT = 600;
+
 // src/modules/pair/index.ts
 var PairModule = class {
   #graphql;
@@ -1137,11 +1140,8 @@ var PairModule = class {
     return body.builderAvailableGamePairs.map(normalisePairInfo);
   }
   // REVIEW[bid-260602-v2]: chartHistory param/variable renamed pairId (was: agencyPairId/gameId)
-  async chartHistory(pairId, limit, opts) {
-    const variables = { pairId };
-    if (limit !== void 0) {
-      variables.limit = limit;
-    }
+  async chartHistory(pairId, limit = DEFAULT_CHART_HISTORY_LIMIT, opts) {
+    const variables = { pairId, limit };
     const body = await this.#graphql.request(
       CHART_HISTORY_QUERY,
       variables,
@@ -3092,6 +3092,12 @@ var TaphubClient = class {
   }
 };
 
+// src/modules/realtime/types.ts
+var CANDLE_EVENT = {
+  NEW: "new",
+  UPDATE: "update"
+};
+
 // src/utils/coefficient.ts
 function errorFunction(x) {
   const a1 = 0.254829592;
@@ -3180,6 +3186,8 @@ export {
   AgencyPairModule,
   AuthModule,
   BidModule,
+  CANDLE_EVENT,
+  DEFAULT_CHART_HISTORY_LIMIT,
   LeaderboardModule,
   LocaleModule,
   NetworkQualityMonitor,

package/package.json

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