@taphubhq/sdk-core 0.22.0 → 0.22.2

package/dist/index.cjs

@@ -1047,7 +1047,7 @@ function createMqttTransport(endpoint, opts = {}) {
   const candleSubscriptions = /* @__PURE__ */ new Map();
   const statsSubscriptions = /* @__PURE__ */ new Map();
   const walletSubscriptions = /* @__PURE__ */ new Map();
-  const { onLifecycle } = opts;
+  const { onLifecycle, auth } = opts;
   let connectStartedAt = 0;
   function fireLifecycle(event) {
     if (!onLifecycle) return;
@@ -1063,7 +1063,12 @@ function createMqttTransport(endpoint, opts = {}) {
       clean: true,
       reconnectPeriod: 2e3,
       connectTimeout: 1e4,
-      keepalive: 6
+      keepalive: 6,
+      // Forwarded once at connect time (no refresh on reconnect). When `auth`
+      // is absent both are `undefined`, which mqtt.js omits from the CONNECT
+      // packet — i.e. an anonymous connection, identical to prior behaviour.
+      username: auth?.username,
+      password: auth?.password
     });
     let lastPingreqAt = 0;
     client.on("packetsend", (packet) => {
@@ -1422,7 +1427,8 @@ var RealtimeModule = class extends import_eventemitter33.default {
     } else {
       this.#agencyId = mqttEndpointOrOptions.agencyId;
       this.#transport = mqttEndpointOrOptions.transport ?? createMqttTransport(mqttEndpointOrOptions.mqttEndpoint, {
-        onLifecycle: mqttEndpointOrOptions.onMqttLifecycle
+        onLifecycle: mqttEndpointOrOptions.onMqttLifecycle,
+        auth: mqttEndpointOrOptions.mqttAuth
       });
     }
   }
@@ -1816,10 +1822,8 @@ var RTT_FAIR_TO_POOR = 450;
 var RTT_POOR_TO_FAIR = 350;
 var JITTER_POOR = 150;
 var JITTER_LEAVE_POOR = 120;
-var LOSS_POOR = 0.05;
-var LOSS_LEAVE_POOR = 0.03;
-var isPoor = (m) => m.rtt > RTT_FAIR_TO_POOR || m.jitter > JITTER_POOR || m.lossRate > LOSS_POOR;
-var canLeavePoor = (m) => m.rtt < RTT_POOR_TO_FAIR && m.jitter < JITTER_LEAVE_POOR && m.lossRate < LOSS_LEAVE_POOR;
+var isPoor = (m) => m.rtt > RTT_FAIR_TO_POOR || m.jitter > JITTER_POOR;
+var canLeavePoor = (m) => m.rtt < RTT_POOR_TO_FAIR && m.jitter < JITTER_LEAVE_POOR;
 var isFairUpper = (rtt) => rtt > RTT_GOOD_TO_FAIR;
 var canReachGood = (rtt) => rtt < RTT_FAIR_TO_GOOD;
 function classifyNetworkLevel(metrics, current) {
@@ -1867,10 +1871,7 @@ var RttSmoother = class {
       this.consecutiveOutliers = 0;
     }
     this.ema = this.ema === 0 ? rtt : EMA_ALPHA * rtt + (1 - EMA_ALPHA) * this.ema;
-    const next = classifyNetworkLevel(
-      { rtt, jitter: metrics.jitter, lossRate: metrics.lossRate },
-      this.committed
-    );
+    const next = classifyNetworkLevel({ rtt, jitter: metrics.jitter }, this.committed);
     if (next === this.candidate) {
       this.candidateCount += 1;
     } else {
@@ -1929,7 +1930,6 @@ var NetworkQualityMonitor = class {
   smoother = new RttSmoother();
   mqttConnected = false;
   mqttDisconnectedAt = null;
-  lastSuccessfulHttpAt = null;
   committedNetwork = "good";
   committedBackend = "ok";
   tickHandle = null;
@@ -1948,9 +1948,6 @@ var NetworkQualityMonitor = class {
     if (bucket.length > WINDOW_MAX_SAMPLES_PER_SOURCE) {
       bucket.shift();
     }
-    if (sample.reason === "ok" && sample.source !== "connection" && sample.source !== "browser") {
-      this.lastSuccessfulHttpAt = sample.ts;
-    }
     if (sample.source === "mqtt" && sample.reason === "ok") {
       this.smoother.add(sample.rtt, this.deriveMetrics());
     }
@@ -2014,7 +2011,6 @@ var NetworkQualityMonitor = class {
     this.smoother.reset();
     this.mqttConnected = false;
     this.mqttDisconnectedAt = null;
-    this.lastSuccessfulHttpAt = null;
     this.committedNetwork = "good";
     this.committedBackend = "ok";
     const current = this.snapshot();
@@ -2086,7 +2082,7 @@ var NetworkQualityMonitor = class {
     const backend = classifyBackendHealth(httpSamples);
     const metrics = this.deriveMetricsFrom(effectiveSamples);
     const candidate = classifyNetworkLevel(
-      { rtt: metrics.emaForLevel, jitter: metrics.jitter, lossRate: metrics.lossRate },
+      { rtt: metrics.emaForLevel, jitter: metrics.jitter },
       this.committedNetwork
     );
     let nextNetwork = this.smoother.level;
@@ -2139,15 +2135,7 @@ var NetworkQualityMonitor = class {
       return true;
     }
     const now = this.now();
-    const recent = this.allHttpAndMqttSamples().filter(
-      (s) => s.ts >= now - OFFLINE_HOLD_MS && (s.source === "graphql" || s.source === "rest")
-    );
-    if (recent.length >= 3 && recent.every(
-      (s) => s.reason === "network" || s.reason === "timeout" || s.reason === "offline"
-    )) {
-      return true;
-    }
-    if (this.mqttDisconnectedAt !== null && now - this.mqttDisconnectedAt > OFFLINE_HOLD_MS && (this.lastSuccessfulHttpAt === null || now - this.lastSuccessfulHttpAt > OFFLINE_HOLD_MS)) {
+    if (this.mqttDisconnectedAt !== null && now - this.mqttDisconnectedAt > OFFLINE_HOLD_MS) {
       return true;
     }
     return false;
@@ -2783,6 +2771,7 @@ var TaphubClient = class {
     this.realtime = config.mqttEndpoint ? new RealtimeModule({
       mqttEndpoint: config.mqttEndpoint,
       agencyId: this.agencyId,
+      mqttAuth: config.mqttAuth,
       onMqttLifecycle: createMqttProbe(this.network)
     }) : void 0;
     attachConnectionProbe(this.network);

package/dist/index.d.mts

@@ -12,10 +12,24 @@ declare const TaphubStorage: {
     sessionStorage(): TaphubStorageAdapter;
 };
 
+/**
+ * MQTT broker credentials. Forwarded verbatim to the MQTT connection when
+ * `mqttEndpoint` is set, and ignored otherwise. Read once when the connection
+ * first opens (no refresh on reconnect).
+ *
+ * For brokers using JWT-in-username auth (the TapHub/EMQX default), pass the
+ * session token as `username` and leave `password` empty (`''`).
+ */
+interface MqttAuthConfig {
+    username?: string;
+    password?: string;
+}
 interface TaphubClientConfig {
     agencyId: string;
     endpoint: string;
     mqttEndpoint?: string;
+    /** Optional MQTT broker credentials. Ignored when `mqttEndpoint` is absent. */
+    mqttAuth?: MqttAuthConfig;
     storage?: TaphubStorageAdapter;
     fetch?: typeof globalThis.fetch;
 }
@@ -850,6 +864,15 @@ interface RealtimeModuleOptions {
      * the caller (tenant-scoping mirror of the GQL resolver).
      */
     agencyId?: string;
+    /**
+     * Optional MQTT broker credentials, forwarded to the transport connection
+     * (read once at connect time, no refresh). Ignored when an explicit
+     * `transport` override is supplied.
+     */
+    mqttAuth?: {
+        username?: string;
+        password?: string;
+    };
     /** @internal For testing only */
     transport?: MqttTransport;
     /**
@@ -984,7 +1007,6 @@ declare class NetworkQualityMonitor {
     private readonly smoother;
     private mqttConnected;
     private mqttDisconnectedAt;
-    private lastSuccessfulHttpAt;
     private committedNetwork;
     private committedBackend;
     private tickHandle;
@@ -1124,4 +1146,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, 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 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, 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 };
+export { type AgencyPairFilter, AgencyPairModule, type AgencyPairStats, type AgencyPairStatus, AuthModule, type BackendHealth, type Bid, BidModule, type BidStatus, type CancelBidResult, type Candle, type Constraints, type Currency, 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, 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 };

package/dist/index.d.ts

@@ -12,10 +12,24 @@ declare const TaphubStorage: {
     sessionStorage(): TaphubStorageAdapter;
 };
 
+/**
+ * MQTT broker credentials. Forwarded verbatim to the MQTT connection when
+ * `mqttEndpoint` is set, and ignored otherwise. Read once when the connection
+ * first opens (no refresh on reconnect).
+ *
+ * For brokers using JWT-in-username auth (the TapHub/EMQX default), pass the
+ * session token as `username` and leave `password` empty (`''`).
+ */
+interface MqttAuthConfig {
+    username?: string;
+    password?: string;
+}
 interface TaphubClientConfig {
     agencyId: string;
     endpoint: string;
     mqttEndpoint?: string;
+    /** Optional MQTT broker credentials. Ignored when `mqttEndpoint` is absent. */
+    mqttAuth?: MqttAuthConfig;
     storage?: TaphubStorageAdapter;
     fetch?: typeof globalThis.fetch;
 }
@@ -850,6 +864,15 @@ interface RealtimeModuleOptions {
      * the caller (tenant-scoping mirror of the GQL resolver).
      */
     agencyId?: string;
+    /**
+     * Optional MQTT broker credentials, forwarded to the transport connection
+     * (read once at connect time, no refresh). Ignored when an explicit
+     * `transport` override is supplied.
+     */
+    mqttAuth?: {
+        username?: string;
+        password?: string;
+    };
     /** @internal For testing only */
     transport?: MqttTransport;
     /**
@@ -984,7 +1007,6 @@ declare class NetworkQualityMonitor {
     private readonly smoother;
     private mqttConnected;
     private mqttDisconnectedAt;
-    private lastSuccessfulHttpAt;
     private committedNetwork;
     private committedBackend;
     private tickHandle;
@@ -1124,4 +1146,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, 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 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, 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 };
+export { type AgencyPairFilter, AgencyPairModule, type AgencyPairStats, type AgencyPairStatus, AuthModule, type BackendHealth, type Bid, BidModule, type BidStatus, type CancelBidResult, type Candle, type Constraints, type Currency, 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, 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 };

package/dist/index.js

@@ -982,7 +982,7 @@ function createMqttTransport(endpoint, opts = {}) {
   const candleSubscriptions = /* @__PURE__ */ new Map();
   const statsSubscriptions = /* @__PURE__ */ new Map();
   const walletSubscriptions = /* @__PURE__ */ new Map();
-  const { onLifecycle } = opts;
+  const { onLifecycle, auth } = opts;
   let connectStartedAt = 0;
   function fireLifecycle(event) {
     if (!onLifecycle) return;
@@ -998,7 +998,12 @@ function createMqttTransport(endpoint, opts = {}) {
       clean: true,
       reconnectPeriod: 2e3,
       connectTimeout: 1e4,
-      keepalive: 6
+      keepalive: 6,
+      // Forwarded once at connect time (no refresh on reconnect). When `auth`
+      // is absent both are `undefined`, which mqtt.js omits from the CONNECT
+      // packet — i.e. an anonymous connection, identical to prior behaviour.
+      username: auth?.username,
+      password: auth?.password
     });
     let lastPingreqAt = 0;
     client.on("packetsend", (packet) => {
@@ -1357,7 +1362,8 @@ var RealtimeModule = class extends EventEmitter3 {
     } else {
       this.#agencyId = mqttEndpointOrOptions.agencyId;
       this.#transport = mqttEndpointOrOptions.transport ?? createMqttTransport(mqttEndpointOrOptions.mqttEndpoint, {
-        onLifecycle: mqttEndpointOrOptions.onMqttLifecycle
+        onLifecycle: mqttEndpointOrOptions.onMqttLifecycle,
+        auth: mqttEndpointOrOptions.mqttAuth
       });
     }
   }
@@ -1751,10 +1757,8 @@ var RTT_FAIR_TO_POOR = 450;
 var RTT_POOR_TO_FAIR = 350;
 var JITTER_POOR = 150;
 var JITTER_LEAVE_POOR = 120;
-var LOSS_POOR = 0.05;
-var LOSS_LEAVE_POOR = 0.03;
-var isPoor = (m) => m.rtt > RTT_FAIR_TO_POOR || m.jitter > JITTER_POOR || m.lossRate > LOSS_POOR;
-var canLeavePoor = (m) => m.rtt < RTT_POOR_TO_FAIR && m.jitter < JITTER_LEAVE_POOR && m.lossRate < LOSS_LEAVE_POOR;
+var isPoor = (m) => m.rtt > RTT_FAIR_TO_POOR || m.jitter > JITTER_POOR;
+var canLeavePoor = (m) => m.rtt < RTT_POOR_TO_FAIR && m.jitter < JITTER_LEAVE_POOR;
 var isFairUpper = (rtt) => rtt > RTT_GOOD_TO_FAIR;
 var canReachGood = (rtt) => rtt < RTT_FAIR_TO_GOOD;
 function classifyNetworkLevel(metrics, current) {
@@ -1802,10 +1806,7 @@ var RttSmoother = class {
       this.consecutiveOutliers = 0;
     }
     this.ema = this.ema === 0 ? rtt : EMA_ALPHA * rtt + (1 - EMA_ALPHA) * this.ema;
-    const next = classifyNetworkLevel(
-      { rtt, jitter: metrics.jitter, lossRate: metrics.lossRate },
-      this.committed
-    );
+    const next = classifyNetworkLevel({ rtt, jitter: metrics.jitter }, this.committed);
     if (next === this.candidate) {
       this.candidateCount += 1;
     } else {
@@ -1864,7 +1865,6 @@ var NetworkQualityMonitor = class {
   smoother = new RttSmoother();
   mqttConnected = false;
   mqttDisconnectedAt = null;
-  lastSuccessfulHttpAt = null;
   committedNetwork = "good";
   committedBackend = "ok";
   tickHandle = null;
@@ -1883,9 +1883,6 @@ var NetworkQualityMonitor = class {
     if (bucket.length > WINDOW_MAX_SAMPLES_PER_SOURCE) {
       bucket.shift();
     }
-    if (sample.reason === "ok" && sample.source !== "connection" && sample.source !== "browser") {
-      this.lastSuccessfulHttpAt = sample.ts;
-    }
     if (sample.source === "mqtt" && sample.reason === "ok") {
       this.smoother.add(sample.rtt, this.deriveMetrics());
     }
@@ -1949,7 +1946,6 @@ var NetworkQualityMonitor = class {
     this.smoother.reset();
     this.mqttConnected = false;
     this.mqttDisconnectedAt = null;
-    this.lastSuccessfulHttpAt = null;
     this.committedNetwork = "good";
     this.committedBackend = "ok";
     const current = this.snapshot();
@@ -2021,7 +2017,7 @@ var NetworkQualityMonitor = class {
     const backend = classifyBackendHealth(httpSamples);
     const metrics = this.deriveMetricsFrom(effectiveSamples);
     const candidate = classifyNetworkLevel(
-      { rtt: metrics.emaForLevel, jitter: metrics.jitter, lossRate: metrics.lossRate },
+      { rtt: metrics.emaForLevel, jitter: metrics.jitter },
       this.committedNetwork
     );
     let nextNetwork = this.smoother.level;
@@ -2074,15 +2070,7 @@ var NetworkQualityMonitor = class {
       return true;
     }
     const now = this.now();
-    const recent = this.allHttpAndMqttSamples().filter(
-      (s) => s.ts >= now - OFFLINE_HOLD_MS && (s.source === "graphql" || s.source === "rest")
-    );
-    if (recent.length >= 3 && recent.every(
-      (s) => s.reason === "network" || s.reason === "timeout" || s.reason === "offline"
-    )) {
-      return true;
-    }
-    if (this.mqttDisconnectedAt !== null && now - this.mqttDisconnectedAt > OFFLINE_HOLD_MS && (this.lastSuccessfulHttpAt === null || now - this.lastSuccessfulHttpAt > OFFLINE_HOLD_MS)) {
+    if (this.mqttDisconnectedAt !== null && now - this.mqttDisconnectedAt > OFFLINE_HOLD_MS) {
       return true;
     }
     return false;
@@ -2718,6 +2706,7 @@ var TaphubClient = class {
     this.realtime = config.mqttEndpoint ? new RealtimeModule({
       mqttEndpoint: config.mqttEndpoint,
       agencyId: this.agencyId,
+      mqttAuth: config.mqttAuth,
       onMqttLifecycle: createMqttProbe(this.network)
     }) : void 0;
     attachConnectionProbe(this.network);

package/package.json

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