@agg-build/sdk 4.25.0 → 4.26.0

package/dist/market-data.js

@@ -488,6 +488,10 @@ var RECONNECT_BASE_MS = 1e3;
 var RECONNECT_MAX_MS = 3e4;
 var STALE_TIMEOUT_MS = 45e3;
 var ORDERBOOK_DEBUG_TOP_LEVELS = 5;
+var WATCHDOG_SILENCE_MS = 5 * 6e4;
+var WATCHDOG_CHECK_INTERVAL_MS = 6e4;
+var WATCHDOG_BATCH_MAX = 100;
+var WATCHDOG_REQUEST_TIMEOUT_MS = 15e3;
 var AggWebSocket = class {
   constructor(options) {
     this.ws = null;
@@ -513,6 +517,18 @@ var AggWebSocket = class {
     this.books = /* @__PURE__ */ new Map();
     /** Markets currently resyncing (awaiting snapshot after seq gap / checksum mismatch). */
     this.resyncing = /* @__PURE__ */ new Set();
+    /**
+     * Per subscribed orderbook outcome: last time it made progress (subscribe,
+     * snapshot, applied delta) or was checked against REST (ms). Tracked from
+     * subscribe, not from the first snapshot, so a book that never arrives or
+     * is stuck resyncing is still found by the watchdog.
+     */
+    this.bookCheckedAt = /* @__PURE__ */ new Map();
+    /** Outcomes the watchdog already resnapshotted; a repeat mismatch resubscribes. */
+    this.watchdogResnapshotted = /* @__PURE__ */ new Set();
+    this.watchdogTimer = null;
+    this.watchdogAbort = null;
+    this.watchdogPausedUntil = 0;
     // ── Connection state ──
     this.connecting = false;
     this._connected = false;
@@ -528,6 +544,7 @@ var AggWebSocket = class {
     this.callbacks = (_b = options.callbacks) != null ? _b : {};
     this.initialToken = options.initialToken;
     this.enableLogs = (_c = options.enableLogs) != null ? _c : false;
+    this.bookWatchdog = options.bookWatchdog;
   }
   // ── Public API ──
   get connected() {
@@ -673,6 +690,7 @@ var AggWebSocket = class {
       this.subs.set(outcomeId, sub);
     }
     if (sub.refCount === 0) {
+      this.bookCheckedAt.set(outcomeId, Date.now());
       this.pendingSubs.add(outcomeId);
       this.ensureConnected();
       if (this._connected) {
@@ -697,6 +715,8 @@ var AggWebSocket = class {
           this.books.delete(outcomeId);
         }
         this.resyncing.delete(outcomeId);
+        this.bookCheckedAt.delete(outcomeId);
+        this.watchdogResnapshotted.delete(outcomeId);
         if (this._connected) {
           if (this.pendingFlushSubs.has(outcomeId)) {
             this.pendingFlushSubs.delete(outcomeId);
@@ -764,6 +784,7 @@ var AggWebSocket = class {
   }
   /** Send a JWT to authenticate (or re-authenticate) the connection. */
   authenticate(token) {
+    this.initialToken = token;
     if (this._connected) {
       this.send({ action: "authenticate", token });
     }
@@ -795,6 +816,7 @@ var AggWebSocket = class {
   }
   /** Permanently destroy. Cannot reconnect after this. */
   destroy() {
+    var _a;
     this.destroyed = true;
     for (const controller of this.historyControllers)
       controller.abort(new Error("Market-data client disposed"));
@@ -805,6 +827,12 @@ var AggWebSocket = class {
     this.subs.clear();
     this.books.clear();
     this.resyncing.clear();
+    if (this.watchdogTimer) clearInterval(this.watchdogTimer);
+    this.watchdogTimer = null;
+    (_a = this.watchdogAbort) == null ? void 0 : _a.abort();
+    this.watchdogAbort = null;
+    this.bookCheckedAt.clear();
+    this.watchdogResnapshotted.clear();
     this.pendingSubs.clear();
     this.pendingTradeSubs.clear();
     this.pendingResnapshots.clear();
@@ -988,11 +1016,21 @@ var AggWebSocket = class {
    * ready to accept subscriptions. Now flush all pending subs.
    */
   handleConnected(msg) {
-    var _a, _b, _c, _d;
+    var _a, _b, _c, _d, _e;
     this._connected = true;
-    (_b = (_a = this.callbacks).onConnectionStateChange) == null ? void 0 : _b.call(_a, true);
-    (_d = (_c = this.callbacks).onConnected) == null ? void 0 : _d.call(_c, msg);
+    if (this.bookWatchdog && !this.watchdogTimer && !this.destroyed) {
+      this.watchdogTimer = setInterval(
+        () => void this.checkSilentBooks(),
+        (_a = this.bookWatchdog.checkIntervalMs) != null ? _a : WATCHDOG_CHECK_INTERVAL_MS
+      );
+    }
+    (_c = (_b = this.callbacks).onConnectionStateChange) == null ? void 0 : _c.call(_b, true);
+    (_e = (_d = this.callbacks).onConnected) == null ? void 0 : _e.call(_d, msg);
     const orderbookSet = new Set(this.activeOrderbookMarkets());
+    const reconnectedAt = Date.now();
+    for (const id of orderbookSet) {
+      if (this.bookCheckedAt.has(id)) this.bookCheckedAt.set(id, reconnectedAt);
+    }
     this.pendingSubs.forEach((id) => orderbookSet.add(id));
     this.pendingFlushSubs.forEach((id) => orderbookSet.add(id));
     const orderbookIds = Array.from(orderbookSet);
@@ -1035,6 +1073,7 @@ var AggWebSocket = class {
     const msg = __spreadProps(__spreadValues({}, raw), { timestamp: raw.timestamp / 1e3 });
     const book = snapshotToOrderbook(msg);
     this.books.set(msg.outcomeId, new IndexedOrderbook(book));
+    this.bookCheckedAt.set(msg.outcomeId, Date.now());
     this.resyncing.delete(msg.outcomeId);
     this.pendingResnapshots.delete(msg.outcomeId);
     this.debugOrderbook("snapshot_applied", {
@@ -1104,6 +1143,8 @@ var AggWebSocket = class {
       this.requestResnapshot(outcomeId);
       return;
     }
+    this.bookCheckedAt.set(outcomeId, Date.now());
+    this.watchdogResnapshotted.delete(outcomeId);
     (_b = (_a = this.callbacks).onBookTick) == null ? void 0 : _b.call(_a, outcomeId, {
       midpoint: msg.midpoint,
       timestamp: msg.timestamp,
@@ -1126,6 +1167,8 @@ var AggWebSocket = class {
     var _a, _b;
     const msg = __spreadProps(__spreadValues({}, raw), { timestamp: raw.timestamp / 1e3 });
     this.books.delete(msg.outcomeId);
+    this.bookCheckedAt.delete(msg.outcomeId);
+    this.watchdogResnapshotted.delete(msg.outcomeId);
     this.pendingResnapshots.delete(msg.outcomeId);
     this.resyncing.delete(msg.outcomeId);
     (_b = (_a = this.callbacks).onMarketResolved) == null ? void 0 : _b.call(_a, msg);
@@ -1145,6 +1188,89 @@ var AggWebSocket = class {
     const msg = __spreadProps(__spreadValues({}, raw), { timestamp: raw.timestamp / 1e3 });
     (_b = (_a = this.callbacks).onRedeemEvent) == null ? void 0 : _b.call(_a, msg);
   }
+  // ── Book watchdog ──
+  /**
+   * Heartbeats prove the socket, not each stream. Every subscribed outcome
+   * with no progress for `silenceMs` is checked against the REST `seq`:
+   *
+   * - book present, not resyncing, same `seq` → the market is just quiet;
+   * - different `seq`, no book (snapshot never arrived, or a resubscribe's
+   *   snapshot was lost), or stuck resyncing (any recovery whose snapshot
+   *   was lost) → resnapshot, then resubscribe on the next overdue check;
+   * - REST can't serve it (`null`) → counted as an attempt, so the next
+   *   batch moves on to other outcomes instead of retrying the same 100.
+   */
+  checkSilentBooks() {
+    return __async(this, null, function* () {
+      var _a;
+      const opts = this.bookWatchdog;
+      if (!opts || !this._connected || this.watchdogAbort) return;
+      const now = Date.now();
+      if (now < this.watchdogPausedUntil) return;
+      const silenceMs = (_a = opts.silenceMs) != null ? _a : WATCHDOG_SILENCE_MS;
+      const silent = this.activeOrderbookMarkets().filter((id) => this.bookCheckedAt.has(id)).filter((id) => now - this.bookCheckedAt.get(id) >= silenceMs).sort((a, b) => this.bookCheckedAt.get(a) - this.bookCheckedAt.get(b)).slice(0, WATCHDOG_BATCH_MAX);
+      if (silent.length === 0) return;
+      const checkedAt = new Map(silent.map((id) => [id, this.bookCheckedAt.get(id)]));
+      const abort = new AbortController();
+      this.watchdogAbort = abort;
+      const timeout = setTimeout(() => abort.abort(), WATCHDOG_REQUEST_TIMEOUT_MS);
+      try {
+        const url = new URL(`${opts.baseUrl.replace(/\/$/, "")}/orderbooks/outcomes`);
+        url.searchParams.set("venueMarketOutcomeIds", silent.join(","));
+        url.searchParams.set("depth", "1");
+        const response = yield fetch(url, { headers: opts.headers, signal: abort.signal });
+        if (!response.ok) {
+          const retryAfterS = Number(response.headers.get("retry-after"));
+          if (response.status === 429 && retryAfterS > 0) {
+            this.watchdogPausedUntil = Date.now() + retryAfterS * 1e3;
+          }
+          this.emitDiagnostic({ type: "book_watchdog_error", status: response.status });
+          return;
+        }
+        const body = yield response.json();
+        if (this.destroyed) return;
+        silent.forEach((outcomeId, i) => {
+          var _a2, _b;
+          if (this.bookCheckedAt.get(outcomeId) !== checkedAt.get(outcomeId)) return;
+          const server = (_a2 = body.data) == null ? void 0 : _a2[i];
+          if (!server) {
+            this.bookCheckedAt.set(outcomeId, Date.now());
+            return;
+          }
+          const book = this.books.get(outcomeId);
+          if (book && !this.resyncing.has(outcomeId) && server.seq === book.seq) {
+            this.bookCheckedAt.set(outcomeId, Date.now());
+            this.watchdogResnapshotted.delete(outcomeId);
+            return;
+          }
+          const action = this.watchdogResnapshotted.has(outcomeId) ? "resubscribe" : "resnapshot";
+          this.emitDiagnostic({
+            type: "book_watchdog_resync",
+            outcomeId,
+            localSeq: (_b = book == null ? void 0 : book.seq) != null ? _b : null,
+            serverSeq: server.seq,
+            action
+          });
+          this.bookCheckedAt.set(outcomeId, Date.now());
+          if (action === "resubscribe") {
+            this.watchdogResnapshotted.delete(outcomeId);
+            this.books.delete(outcomeId);
+            this.resyncing.add(outcomeId);
+            this.send({ action: "unsubscribe", channel: "orderbook", outcomeIds: [outcomeId] });
+            this.sendSubscribe([outcomeId]);
+          } else {
+            this.watchdogResnapshotted.add(outcomeId);
+            this.requestResnapshot(outcomeId, true);
+          }
+        });
+      } catch (e) {
+        if (!this.destroyed) this.emitDiagnostic({ type: "book_watchdog_error", status: null });
+      } finally {
+        clearTimeout(timeout);
+        if (this.watchdogAbort === abort) this.watchdogAbort = null;
+      }
+    });
+  }
   // ── Resnapshot ──
   requestResnapshot(outcomeId, force = false) {
     if (this.resyncing.has(outcomeId) && !force) return;

package/dist/market-data.mjs

@@ -6,7 +6,7 @@ import {
   decodeChartHistory,
   loadImmutableHistory,
   readChartHistoryText
-} from "./chunk-QXBVA5TW.mjs";
+} from "./chunk-CPMSVNBO.mjs";
 import {
   __async,
   __spreadProps,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agg-build/sdk",
-  "version": "4.25.0",
+  "version": "4.26.0",
   "description": "Vanilla TypeScript client for the AGG prediction market aggregator (auth, markets, orderbooks, charts, trading, managed execution, WebSockets). Works in browsers, Node.js, and React Native.",
   "sideEffects": false,
   "license": "MIT",