@taphubhq/sdk-core 0.22.3 → 0.23.1

package/dist/index.cjs

@@ -863,7 +863,15 @@ function normaliseGameConfig(node) {
     constraints: normaliseConstraints(node.constraints),
     acceptableBids: node.acceptableBids,
     minBidAmount: node.minBidAmount,
-    maxBidAmount: node.maxBidAmount
+    maxBidAmount: node.maxBidAmount,
+    // Effective cancel policy. Distinguish three states so consumers can apply
+    // the right default:
+    //   undefined → server omitted the field (older server) → use platform default
+    //   0         → builder explicitly disabled cancel → keep 0 (cancel OFF)
+    //   > 0       → builder/effective threshold
+    // (null from the wire becomes undefined, NOT 0, so "not sent" ≠ "disabled".)
+    bidCancelRefundRate: node.bidCancelRefundRate ?? void 0,
+    bidCancelMinSeconds: node.bidCancelMinSeconds ?? void 0
   };
 }
 function normaliseGridConfig(node) {
@@ -925,6 +933,7 @@ var PAIR_QUERY = `query AgencyPair($pairId: ID!) {
       gridConfig { cellSizeTime cellSizeValue candleSize baseline baselineTime }
       constraints { minBetTime maxBetTime slippage priceMinRange priceMaxRange coefMults maxCoef }
       acceptableBids minBidAmount maxBidAmount
+      bidCancelRefundRate bidCancelMinSeconds
     }
   }
 }`;
@@ -1819,31 +1828,11 @@ function classifyBackendHealth(samples) {
   }
   return "ok";
 }
-var RTT_GOOD_TO_FAIR = 180;
-var RTT_FAIR_TO_GOOD = 120;
-var RTT_FAIR_TO_POOR = 450;
-var RTT_POOR_TO_FAIR = 350;
-var JITTER_POOR = 150;
-var JITTER_LEAVE_POOR = 120;
-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) {
-  if (current === "offline") {
-    return isPoor(metrics) ? "poor" : "fair";
-  }
-  if (current === "good") {
-    if (isPoor(metrics)) return "fair";
-    if (isFairUpper(metrics.rtt)) return "fair";
-    return "good";
-  }
-  if (current === "fair") {
-    if (isPoor(metrics)) return "poor";
-    if (canReachGood(metrics.rtt)) return "good";
-    return "fair";
-  }
-  if (canLeavePoor(metrics)) return "fair";
+var GOOD_MAX_MS = 150;
+var FAIR_MAX_MS = 400;
+function classifyNetworkLevel(rtt) {
+  if (rtt <= GOOD_MAX_MS) return "good";
+  if (rtt <= FAIR_MAX_MS) return "fair";
   return "poor";
 }
 
@@ -1866,24 +1855,30 @@ var RttSmoother = class {
   candidateCount = 0;
   overrideOffline = false;
   consecutiveOutliers = 0;
-  add(rtt, metrics) {
+  add(rtt) {
     if (this.ema > 0 && rtt > OUTLIER_MULTIPLIER * this.ema) {
       this.consecutiveOutliers += 1;
       if (this.consecutiveOutliers < 2) return;
     } else {
       this.consecutiveOutliers = 0;
     }
-    this.ema = this.ema === 0 ? rtt : EMA_ALPHA * rtt + (1 - EMA_ALPHA) * this.ema;
-    const next = classifyNetworkLevel({ rtt, jitter: metrics.jitter }, this.committed);
-    if (next === this.candidate) {
-      this.candidateCount += 1;
-    } else {
+    const coldStart = this.ema === 0;
+    this.ema = coldStart ? rtt : EMA_ALPHA * rtt + (1 - EMA_ALPHA) * this.ema;
+    const next = classifyNetworkLevel(this.ema);
+    if (coldStart) {
+      this.committed = next;
       this.candidate = next;
       this.candidateCount = 1;
-    }
-    const required = this.requiredSamplesFor(next);
-    if (this.candidateCount >= required) {
-      this.committed = next;
+    } else {
+      if (next === this.candidate) {
+        this.candidateCount += 1;
+      } else {
+        this.candidate = next;
+        this.candidateCount = 1;
+      }
+      if (this.candidateCount >= this.requiredSamplesFor(next)) {
+        this.committed = next;
+      }
     }
     this.level = this.overrideOffline ? "offline" : this.committed;
   }
@@ -1951,9 +1946,6 @@ var NetworkQualityMonitor = class {
     if (bucket.length > WINDOW_MAX_SAMPLES_PER_SOURCE) {
       bucket.shift();
     }
-    if (sample.source === "mqtt" && sample.reason === "ok") {
-      this.smoother.add(sample.rtt, this.deriveMetrics());
-    }
     this.recompute(prevMqttConnectedOverride);
   }
   seedFromConnection(seed) {
@@ -1987,6 +1979,7 @@ var NetworkQualityMonitor = class {
     this.recompute(prevMqttConnected);
   }
   notifyMqttPing(rttMs) {
+    this.smoother.add(rttMs);
     this.addSample({
       ts: this.now(),
       rtt: rttMs,
@@ -2084,10 +2077,7 @@ var NetworkQualityMonitor = class {
     const httpSamples = effectiveSamples.filter((s) => isHttpSource(s.source));
     const backend = classifyBackendHealth(httpSamples);
     const metrics = this.deriveMetricsFrom(effectiveSamples);
-    const candidate = classifyNetworkLevel(
-      { rtt: metrics.emaForLevel, jitter: metrics.jitter },
-      this.committedNetwork
-    );
+    const candidate = classifyNetworkLevel(metrics.emaForLevel);
     let nextNetwork = this.smoother.level;
     if (effectiveSamples.length === 0) {
       nextNetwork = this.committedNetwork;
@@ -2112,9 +2102,6 @@ var NetworkQualityMonitor = class {
       this.bus.emit("network:change", { previous: prev, current });
     }
   }
-  deriveMetrics() {
-    return this.deriveMetricsFrom(this.allHttpAndMqttSamples());
-  }
   deriveMetricsFrom(samples) {
     const httpSamples = samples.filter((s) => isHttpSource(s.source));
     const total = httpSamples.length;

package/dist/index.d.mts

@@ -500,6 +500,19 @@ interface GameConfig {
     acceptableBids: number[];
     minBidAmount: number;
     maxBidAmount: number;
+    /**
+     * Effective cancel policy — the values the server's cancel engine actually
+     * enforces (per-game config, falling back to platform defaults). Use these
+     * to drive the Cancel button: a bid is cancellable while
+     * `time2 - now > bidCancelMinSeconds`; on cancel the player is refunded
+     * `amount * bidCancelRefundRate`.
+     *
+     * Optional for backward compatibility: a server (or a manually-constructed
+     * config) that predates this field omits it. normalisePair fills 0 from the
+     * wire; consumers should treat `undefined`/`0` as "use the platform default".
+     */
+    bidCancelRefundRate?: number;
+    bidCancelMinSeconds?: number;
 }
 interface GridConfig {
     cellSizeTime: number;
@@ -1039,7 +1052,6 @@ declare class NetworkQualityMonitor {
     private detachBrowserListeners;
     private pruneWindow;
     private recompute;
-    private deriveMetrics;
     private deriveMetricsFrom;
     private isHardOffline;
     private allHttpAndMqttSamples;

package/dist/index.d.ts

@@ -500,6 +500,19 @@ interface GameConfig {
     acceptableBids: number[];
     minBidAmount: number;
     maxBidAmount: number;
+    /**
+     * Effective cancel policy — the values the server's cancel engine actually
+     * enforces (per-game config, falling back to platform defaults). Use these
+     * to drive the Cancel button: a bid is cancellable while
+     * `time2 - now > bidCancelMinSeconds`; on cancel the player is refunded
+     * `amount * bidCancelRefundRate`.
+     *
+     * Optional for backward compatibility: a server (or a manually-constructed
+     * config) that predates this field omits it. normalisePair fills 0 from the
+     * wire; consumers should treat `undefined`/`0` as "use the platform default".
+     */
+    bidCancelRefundRate?: number;
+    bidCancelMinSeconds?: number;
 }
 interface GridConfig {
     cellSizeTime: number;
@@ -1039,7 +1052,6 @@ declare class NetworkQualityMonitor {
     private detachBrowserListeners;
     private pruneWindow;
     private recompute;
-    private deriveMetrics;
     private deriveMetricsFrom;
     private isHardOffline;
     private allHttpAndMqttSamples;

package/dist/index.js

@@ -798,7 +798,15 @@ function normaliseGameConfig(node) {
     constraints: normaliseConstraints(node.constraints),
     acceptableBids: node.acceptableBids,
     minBidAmount: node.minBidAmount,
-    maxBidAmount: node.maxBidAmount
+    maxBidAmount: node.maxBidAmount,
+    // Effective cancel policy. Distinguish three states so consumers can apply
+    // the right default:
+    //   undefined → server omitted the field (older server) → use platform default
+    //   0         → builder explicitly disabled cancel → keep 0 (cancel OFF)
+    //   > 0       → builder/effective threshold
+    // (null from the wire becomes undefined, NOT 0, so "not sent" ≠ "disabled".)
+    bidCancelRefundRate: node.bidCancelRefundRate ?? void 0,
+    bidCancelMinSeconds: node.bidCancelMinSeconds ?? void 0
   };
 }
 function normaliseGridConfig(node) {
@@ -860,6 +868,7 @@ var PAIR_QUERY = `query AgencyPair($pairId: ID!) {
       gridConfig { cellSizeTime cellSizeValue candleSize baseline baselineTime }
       constraints { minBetTime maxBetTime slippage priceMinRange priceMaxRange coefMults maxCoef }
       acceptableBids minBidAmount maxBidAmount
+      bidCancelRefundRate bidCancelMinSeconds
     }
   }
 }`;
@@ -1754,31 +1763,11 @@ function classifyBackendHealth(samples) {
   }
   return "ok";
 }
-var RTT_GOOD_TO_FAIR = 180;
-var RTT_FAIR_TO_GOOD = 120;
-var RTT_FAIR_TO_POOR = 450;
-var RTT_POOR_TO_FAIR = 350;
-var JITTER_POOR = 150;
-var JITTER_LEAVE_POOR = 120;
-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) {
-  if (current === "offline") {
-    return isPoor(metrics) ? "poor" : "fair";
-  }
-  if (current === "good") {
-    if (isPoor(metrics)) return "fair";
-    if (isFairUpper(metrics.rtt)) return "fair";
-    return "good";
-  }
-  if (current === "fair") {
-    if (isPoor(metrics)) return "poor";
-    if (canReachGood(metrics.rtt)) return "good";
-    return "fair";
-  }
-  if (canLeavePoor(metrics)) return "fair";
+var GOOD_MAX_MS = 150;
+var FAIR_MAX_MS = 400;
+function classifyNetworkLevel(rtt) {
+  if (rtt <= GOOD_MAX_MS) return "good";
+  if (rtt <= FAIR_MAX_MS) return "fair";
   return "poor";
 }
 
@@ -1801,24 +1790,30 @@ var RttSmoother = class {
   candidateCount = 0;
   overrideOffline = false;
   consecutiveOutliers = 0;
-  add(rtt, metrics) {
+  add(rtt) {
     if (this.ema > 0 && rtt > OUTLIER_MULTIPLIER * this.ema) {
       this.consecutiveOutliers += 1;
       if (this.consecutiveOutliers < 2) return;
     } else {
       this.consecutiveOutliers = 0;
     }
-    this.ema = this.ema === 0 ? rtt : EMA_ALPHA * rtt + (1 - EMA_ALPHA) * this.ema;
-    const next = classifyNetworkLevel({ rtt, jitter: metrics.jitter }, this.committed);
-    if (next === this.candidate) {
-      this.candidateCount += 1;
-    } else {
+    const coldStart = this.ema === 0;
+    this.ema = coldStart ? rtt : EMA_ALPHA * rtt + (1 - EMA_ALPHA) * this.ema;
+    const next = classifyNetworkLevel(this.ema);
+    if (coldStart) {
+      this.committed = next;
       this.candidate = next;
       this.candidateCount = 1;
-    }
-    const required = this.requiredSamplesFor(next);
-    if (this.candidateCount >= required) {
-      this.committed = next;
+    } else {
+      if (next === this.candidate) {
+        this.candidateCount += 1;
+      } else {
+        this.candidate = next;
+        this.candidateCount = 1;
+      }
+      if (this.candidateCount >= this.requiredSamplesFor(next)) {
+        this.committed = next;
+      }
     }
     this.level = this.overrideOffline ? "offline" : this.committed;
   }
@@ -1886,9 +1881,6 @@ var NetworkQualityMonitor = class {
     if (bucket.length > WINDOW_MAX_SAMPLES_PER_SOURCE) {
       bucket.shift();
     }
-    if (sample.source === "mqtt" && sample.reason === "ok") {
-      this.smoother.add(sample.rtt, this.deriveMetrics());
-    }
     this.recompute(prevMqttConnectedOverride);
   }
   seedFromConnection(seed) {
@@ -1922,6 +1914,7 @@ var NetworkQualityMonitor = class {
     this.recompute(prevMqttConnected);
   }
   notifyMqttPing(rttMs) {
+    this.smoother.add(rttMs);
     this.addSample({
       ts: this.now(),
       rtt: rttMs,
@@ -2019,10 +2012,7 @@ var NetworkQualityMonitor = class {
     const httpSamples = effectiveSamples.filter((s) => isHttpSource(s.source));
     const backend = classifyBackendHealth(httpSamples);
     const metrics = this.deriveMetricsFrom(effectiveSamples);
-    const candidate = classifyNetworkLevel(
-      { rtt: metrics.emaForLevel, jitter: metrics.jitter },
-      this.committedNetwork
-    );
+    const candidate = classifyNetworkLevel(metrics.emaForLevel);
     let nextNetwork = this.smoother.level;
     if (effectiveSamples.length === 0) {
       nextNetwork = this.committedNetwork;
@@ -2047,9 +2037,6 @@ var NetworkQualityMonitor = class {
       this.bus.emit("network:change", { previous: prev, current });
     }
   }
-  deriveMetrics() {
-    return this.deriveMetricsFrom(this.allHttpAndMqttSamples());
-  }
   deriveMetricsFrom(samples) {
     const httpSamples = samples.filter((s) => isHttpSource(s.source));
     const total = httpSamples.length;

package/package.json

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