@agg-build/sdk 4.34.1 → 4.37.0

package/dist/{agg-websocket-MYZiMRXn.js → agg-websocket-Cq4E0T0f.js}

@@ -472,9 +472,12 @@ var IndexedOrderbook = class {
 /**
 * Agg platform WebSocket client.
 *
-* Single connection, refcounted subscriptions. Orderbook/trades subscriptions
-* are keyed by venueMarketOutcomeId (the `outcomes[].id` on REST market
-* responses — NOT a venueMarketId); arb subscriptions are keyed by marketId.
+* Refcounted subscriptions. Orderbook/trades subscriptions are keyed by
+* venueMarketOutcomeId (the `outcomes[].id` on REST market responses — NOT a
+* venueMarketId); arb subscriptions are keyed by marketId.
+* One socket unless `orderbookUrl` is set, in which case only the orderbook
+* channel uses that second socket. An orderbook-only subscription then leaves
+* the primary socket idle. Trades, arb, catalog, and user events still use it.
 * Maintains in-memory orderbook state per subscribed outcome id.
 * All timestamps converted from server ms to seconds before invoking callbacks.
 *
@@ -486,6 +489,10 @@ var IndexedOrderbook = class {
 */
 const RECONNECT_BASE_MS = 1e3;
 const RECONNECT_MAX_MS = 3e4;
+const SNAPSHOT_RETRY_MAX_ATTEMPTS = 3;
+/** Bound recovery traffic independently of the number of subscribed outcomes. */
+const SNAPSHOT_RETRY_BATCH_SIZE = 20;
+const SNAPSHOT_RETRY_TICK_MS = 1e3;
 /** WebSocket.OPEN — a literal so environments without a global WebSocket still load. */
 const WS_OPEN = 1;
 /** Close codes for configuration errors that a retry cannot fix. */
@@ -511,7 +518,8 @@ const WATCHDOG_BATCH_MAX = 100;
 const WATCHDOG_REQUEST_TIMEOUT_MS = 15e3;
 const CATALOG_FRAME_ID_PREFIX = "catalog-";
 /**
-* Agg WebSocket client. Single WS connection with refcounted market subscriptions.
+* Agg WebSocket client. Refcounted market subscriptions on one socket,
+* or a second socket for orderbooks when `orderbookUrl` is set.
 */
 var AggWebSocket = class {
 	constructor(options) {
@@ -537,6 +545,9 @@ var AggWebSocket = class {
 		this.watchdogTimer = null;
 		this.watchdogAbort = null;
 		this.watchdogPausedUntil = 0;
+		this.snapshotRetries = /* @__PURE__ */ new Map();
+		this.snapshotRetryTimer = null;
+		this.snapshotRetryLastSentAt = -Infinity;
 		this.connecting = false;
 		this._connected = false;
 		this.reconnectAttempts = 0;
@@ -545,6 +556,14 @@ var AggWebSocket = class {
 		this.lastMessageTime = 0;
 		this.destroyed = false;
 		this.historyControllers = /* @__PURE__ */ new Set();
+		this.obWs = null;
+		this.obConnecting = false;
+		this._obConnected = false;
+		this.obReconnectAttempts = 0;
+		this.obReconnectTimer = null;
+		this.obStaleTimer = null;
+		this.obLastMessageTime = 0;
+		this.obRejected = false;
 		this.lastEventId = {};
 		this.seenEventIds = /* @__PURE__ */ new Set();
 		this.hasConnected = false;
@@ -556,6 +575,8 @@ var AggWebSocket = class {
 		this.rejected = false;
 		this.deferBookViews = options.deferBookViews ?? false;
 		this.url = options.url;
+		this.orderbookUrl = options.orderbookUrl || void 0;
+		this.orderbookLatency = options.orderbookLatency === "realtime" ? "realtime" : "conflated";
 		this.webSocketImpl = options.webSocketImpl;
 		this.headers = options.headers;
 		this.resumeEvents = options.resumeEvents ?? true;
@@ -662,6 +683,7 @@ var AggWebSocket = class {
 						this.scheduleFlush();
 					}
 				}
+				this.releasePrimaryIfIdle();
 			}
 		};
 	}
@@ -686,6 +708,7 @@ var AggWebSocket = class {
 				action: "unsubscribe",
 				channel: "arb-feed"
 			});
+			this.releasePrimaryIfIdle();
 		};
 	}
 	/**
@@ -719,14 +742,17 @@ var AggWebSocket = class {
 			}
 		}
 		return () => {
-			if (!this.catalogSubs.delete(sub) || !this._connected) return;
-			if (this.catalogSubs.size === 0) {
-				this.catalogSentKey = null;
-				this.send({
-					action: "unsubscribe",
-					channel: "catalog"
-				});
-			} else this.sendCatalogSubscribe();
+			if (!this.catalogSubs.delete(sub)) return;
+			if (this._connected) {
+				if (this.catalogSubs.size === 0) {
+					this.catalogSentKey = null;
+					this.send({
+						action: "unsubscribe",
+						channel: "catalog"
+					});
+				} else this.sendCatalogSubscribe();
+			}
+			this.releasePrimaryIfIdle();
 		};
 	}
 	/**
@@ -779,8 +805,8 @@ var AggWebSocket = class {
 		if (sub.refCount === 0) {
 			this.bookCheckedAt.set(outcomeId, Date.now());
 			this.pendingSubs.add(outcomeId);
-			this.ensureConnected();
-			if (this._connected) {
+			this.ensureOrderbookTransport();
+			if (this.orderbookTransportReady()) {
 				this.pendingFlushUnsubs.delete(outcomeId);
 				this.pendingFlushSubs.add(outcomeId);
 				this.pendingSubs.delete(outcomeId);
@@ -789,6 +815,7 @@ var AggWebSocket = class {
 		}
 		sub.refCount++;
 		let released = false;
+		this.releasePrimaryIfIdle();
 		return () => {
 			if (released) return;
 			released = true;
@@ -803,8 +830,9 @@ var AggWebSocket = class {
 				}
 				this.resyncing.delete(outcomeId);
 				this.bookCheckedAt.delete(outcomeId);
+				this.snapshotRetries.delete(outcomeId);
 				this.watchdogResnapshotted.delete(outcomeId);
-				if (this._connected) {
+				if (this.orderbookTransportReady()) {
 					if (this.pendingFlushSubs.has(outcomeId)) this.pendingFlushSubs.delete(outcomeId);
 					else {
 						this.pendingFlushUnsubs.add(outcomeId);
@@ -813,6 +841,7 @@ var AggWebSocket = class {
 				}
 				this.pendingSubs.delete(outcomeId);
 				this.pendingResnapshots.delete(outcomeId);
+				this.releasePrimaryIfIdle();
 			}
 		};
 	}
@@ -867,6 +896,7 @@ var AggWebSocket = class {
 					this.books.delete(outcomeId);
 					this.resyncing.delete(outcomeId);
 				}
+				this.releasePrimaryIfIdle();
 			}
 		};
 	}
@@ -896,6 +926,7 @@ var AggWebSocket = class {
 				action: "unsubscribe",
 				channel: "app-events"
 			});
+			this.releasePrimaryIfIdle();
 		};
 	}
 	sendAppEventsSubscribe() {
@@ -923,20 +954,34 @@ var AggWebSocket = class {
 	/** Connect (idempotent). Called automatically on first subscribe. */
 	connect() {
 		this.rejected = false;
-		this.ensureConnected();
+		this.obRejected = false;
+		if (!this.orderbookUrl || this.needsPrimarySocket()) this.ensureConnected();
+		if (this.orderbookUrl && (this.activeOrderbookMarkets().length > 0 || this.pendingSubs.size > 0 || this.pendingResnapshots.size > 0)) this.ensureOrderbookConnected();
 	}
 	/** Disconnect and clean up. Reusable — call connect() to reconnect. */
 	disconnect() {
 		this.cancelReconnect();
+		this.cancelOrderbookReconnect();
 		this.cancelStaleTimer();
+		this.cancelOrderbookStaleTimer();
+		this.clearSnapshotRetries();
+		const orderbookWasConnected = !!this.orderbookUrl && this._obConnected;
 		this._connected = false;
+		this._obConnected = false;
 		this.connecting = false;
+		this.obConnecting = false;
 		if (this.ws) {
 			this.ws.onclose = null;
 			this.ws.close();
 			this.ws = null;
 		}
+		if (this.obWs) {
+			this.obWs.onclose = null;
+			this.obWs.close();
+			this.obWs = null;
+		}
 		this.callbacks.onConnectionStateChange?.(false);
+		if (orderbookWasConnected) this.callbacks.onOrderbookConnectionStateChange?.(false);
 	}
 	/** Permanently destroy. Cannot reconnect after this. */
 	destroy() {
@@ -983,6 +1028,50 @@ var AggWebSocket = class {
 		if (this.ws?.readyState === WS_OPEN || this.connecting) return;
 		this.doConnect();
 	}
+	/** Trades, arb, catalog, app events, and user sessions. Orderbooks count only on the shared socket. */
+	needsPrimarySocket() {
+		if (this.initialToken) return true;
+		if (this.arbSubs.size > 0 || this.arbFeedCbs.size > 0 || this.appEventCbs.size > 0 || this.catalogSubs.size > 0) return true;
+		for (const sub of this.subs.values()) {
+			if (sub.tradeRefs > 0) return true;
+			if (!this.orderbookUrl && sub.refCount > 0) return true;
+		}
+		return false;
+	}
+	/** Drop a primary socket that only an orderbook subscription was holding open. */
+	releasePrimaryIfIdle() {
+		if (!this.orderbookUrl || this.needsPrimarySocket()) return;
+		this.cancelReconnect();
+		const wasConnected = this._connected;
+		this.connecting = false;
+		this._connected = false;
+		this.cancelStaleTimer();
+		const ws = this.ws;
+		this.ws = null;
+		if (ws) {
+			ws.onclose = null;
+			ws.close();
+		}
+		if (wasConnected) this.callbacks.onConnectionStateChange?.(false);
+	}
+	/** True when orderbook subscriptions use the separate `orderbookUrl` socket. */
+	get usesOrderbookSocket() {
+		return !!this.orderbookUrl;
+	}
+	/** Orderbook readiness. Without `orderbookUrl` this is the primary socket. */
+	orderbookTransportReady() {
+		return this.orderbookUrl ? this._obConnected : this._connected;
+	}
+	ensureOrderbookTransport() {
+		if (this.orderbookUrl) this.ensureOrderbookConnected();
+		else this.ensureConnected();
+	}
+	ensureOrderbookConnected() {
+		if (!this.orderbookUrl) return;
+		if (this.destroyed || this.obRejected) return;
+		if (this.obWs?.readyState === WS_OPEN || this.obConnecting) return;
+		this.doConnectOrderbook();
+	}
 	doConnect() {
 		if (this.destroyed) return;
 		const Impl = this.webSocketImpl ?? globalThis.WebSocket;
@@ -1013,6 +1102,7 @@ var AggWebSocket = class {
 			const wasConnected = this._connected;
 			this._connected = false;
 			this.cancelStaleTimer();
+			if (!this.orderbookUrl) this.clearSnapshotRetries();
 			if (wasConnected) this.callbacks.onConnectionStateChange?.(false);
 			const code = event?.code ?? 0;
 			if (NON_RETRYABLE_CLOSE_CODES.has(code)) {
@@ -1024,7 +1114,7 @@ var AggWebSocket = class {
 				});
 				return;
 			}
-			if (!this.destroyed && (this.subs.size > 0 || this.arbSubs.size > 0 || this.arbFeedCbs.size > 0 || this.appEventCbs.size > 0 || this.catalogSubs.size > 0 || !!this.initialToken)) this.scheduleReconnect();
+			if (!this.destroyed && this.needsPrimarySocket()) this.scheduleReconnect();
 		};
 		ws.onerror = () => {};
 	}
@@ -1066,6 +1156,89 @@ var AggWebSocket = class {
 			this.staleTimer = null;
 		}
 	}
+	doConnectOrderbook() {
+		if (this.destroyed || !this.orderbookUrl) return;
+		const Impl = this.webSocketImpl ?? globalThis.WebSocket;
+		if (!Impl) throw new Error("No WebSocket implementation available. Pass `webSocketImpl` (e.g. the `ws` package).");
+		this.obConnecting = true;
+		const ws = this.headers ? new Impl(this.orderbookUrl, { headers: this.headers }) : new Impl(this.orderbookUrl);
+		this.obWs = ws;
+		ws.onopen = () => {
+			if (this.destroyed || this.obWs !== ws) return;
+			this.obConnecting = false;
+			this.resetOrderbookStaleTimer();
+		};
+		ws.onmessage = (event) => {
+			if (this.destroyed || this.obWs !== ws) return;
+			this.obLastMessageTime = Date.now();
+			this.callbacks.onFrameReceived?.(this.obLastMessageTime);
+			this.resetOrderbookStaleTimer();
+			try {
+				const raw = JSON.parse(event.data);
+				this.handleOrderbookSocketMessage(raw);
+			} catch {}
+		};
+		ws.onclose = (event) => {
+			if (this.obWs !== ws) return;
+			this.obWs = null;
+			this.obConnecting = false;
+			const wasConnected = this._obConnected;
+			this._obConnected = false;
+			this.cancelOrderbookStaleTimer();
+			this.clearSnapshotRetries();
+			if (wasConnected) this.callbacks.onOrderbookConnectionStateChange?.(false);
+			const code = event?.code ?? 0;
+			if (NON_RETRYABLE_CLOSE_CODES.has(code)) {
+				this.obRejected = true;
+				this.emitDiagnostic({
+					type: "connection_rejected",
+					code,
+					reason: event?.reason ?? ""
+				});
+				return;
+			}
+			if (!this.destroyed && (this.activeOrderbookMarkets().length > 0 || this.pendingSubs.size > 0 || this.pendingResnapshots.size > 0)) this.scheduleOrderbookReconnect();
+		};
+		ws.onerror = () => {};
+	}
+	scheduleOrderbookReconnect() {
+		this.cancelOrderbookReconnect();
+		const step = Math.min(RECONNECT_BASE_MS * Math.pow(2, this.obReconnectAttempts), RECONNECT_MAX_MS);
+		const delay = Math.round(step * (.5 + Math.random() * .5));
+		this.obReconnectAttempts++;
+		this.emitDiagnostic({
+			type: "reconnect",
+			attempt: this.obReconnectAttempts,
+			delayMs: delay
+		});
+		this.obReconnectTimer = setTimeout(() => {
+			this.obReconnectTimer = null;
+			this.doConnectOrderbook();
+		}, delay);
+	}
+	cancelOrderbookReconnect() {
+		if (this.obReconnectTimer) {
+			clearTimeout(this.obReconnectTimer);
+			this.obReconnectTimer = null;
+		}
+	}
+	resetOrderbookStaleTimer() {
+		this.cancelOrderbookStaleTimer();
+		this.obStaleTimer = setTimeout(() => {
+			const age = Date.now() - this.obLastMessageTime;
+			this.emitDiagnostic({
+				type: "stale_connection",
+				lastMessageAge: age
+			});
+			if (this.obWs) this.obWs.close();
+		}, STALE_TIMEOUT_MS);
+	}
+	cancelOrderbookStaleTimer() {
+		if (this.obStaleTimer) {
+			clearTimeout(this.obStaleTimer);
+			this.obStaleTimer = null;
+		}
+	}
 	handleMessage(raw) {
 		const type = raw.type;
 		if (USER_EVENT_TYPES.has(type) && !this.acceptEvent(raw)) return;
@@ -1140,6 +1313,7 @@ var AggWebSocket = class {
 					if (seq === this.catalogFrameSeq) this.catalogSentKey = null;
 					for (const sub of [...this.catalogSubs]) if (sub.awaitingAck !== void 0 && sub.awaitingAck <= seq) sub.opts.onError?.(msg);
 				}
+				if (msg.code === "snapshot_unavailable") for (const outcomeId of msg.outcomeIds ?? []) this.queueSnapshotRetry(outcomeId);
 				this.callbacks.onError?.(msg);
 				break;
 			}
@@ -1200,16 +1374,7 @@ var AggWebSocket = class {
 		if (this.bookWatchdog && !this.watchdogTimer && !this.destroyed) this.watchdogTimer = setInterval(() => void this.checkSilentBooks(), this.bookWatchdog.checkIntervalMs ?? WATCHDOG_CHECK_INTERVAL_MS);
 		this.callbacks.onConnectionStateChange?.(true);
 		this.callbacks.onConnected?.(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);
-		if (orderbookIds.length > 0) this.sendSubscribe(orderbookIds);
-		this.pendingSubs.clear();
-		this.pendingFlushSubs.clear();
-		this.pendingFlushUnsubs.clear();
+		if (!this.orderbookUrl) this.flushOrderbookSubscriptions();
 		const tradeSet = new Set(this.activeTradeMarkets());
 		this.pendingTradeSubs.forEach((id) => tradeSet.add(id));
 		this.pendingFlushTradeSubs.forEach((id) => tradeSet.add(id));
@@ -1222,13 +1387,7 @@ var AggWebSocket = class {
 		this.pendingTradeSubs.clear();
 		this.pendingFlushTradeSubs.clear();
 		this.pendingFlushTradeUnsubs.clear();
-		const resnapshotIds = Array.from(this.pendingResnapshots);
-		if (resnapshotIds.length > 0) this.send({
-			action: "resnapshot",
-			channel: "orderbook",
-			outcomeIds: resnapshotIds
-		});
-		this.pendingResnapshots.clear();
+		if (!this.orderbookUrl) this.flushOrderbookResnapshots();
 		const arbSet = new Set(this.activeArbMarkets());
 		this.pendingFlushArbSubs.forEach((id) => arbSet.add(id));
 		const arbIds = Array.from(arbSet);
@@ -1248,6 +1407,89 @@ var AggWebSocket = class {
 		this.catalogAckedSeq = this.catalogFrameSeq;
 		if (this.catalogSubs.size > 0) this.sendCatalogSubscribe(...this.catalogSubs);
 	}
+	/** Resubscribe orderbooks on the socket that owns that channel. */
+	flushOrderbookSubscriptions() {
+		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);
+		if (orderbookIds.length > 0) this.sendSubscribe(orderbookIds);
+		this.pendingSubs.clear();
+		this.pendingFlushSubs.clear();
+		this.pendingFlushUnsubs.clear();
+	}
+	flushOrderbookResnapshots() {
+		const resnapshotIds = Array.from(this.pendingResnapshots);
+		if (resnapshotIds.length > 0) this.sendOrderbook({
+			action: "resnapshot",
+			channel: "orderbook",
+			outcomeIds: resnapshotIds
+		});
+		this.pendingResnapshots.clear();
+	}
+	/**
+	* The orderbook socket confirmed the app. It does not carry trades, arb,
+	* catalog, or user events, and it does not change the primary connection flag.
+	*/
+	handleOrderbookConnected() {
+		this.obReconnectAttempts = 0;
+		this._obConnected = true;
+		this.callbacks.onOrderbookConnectionStateChange?.(true);
+		if (this.bookWatchdog && !this.watchdogTimer && !this.destroyed) this.watchdogTimer = setInterval(() => void this.checkSilentBooks(), this.bookWatchdog.checkIntervalMs ?? WATCHDOG_CHECK_INTERVAL_MS);
+		this.flushOrderbookSubscriptions();
+		this.flushOrderbookResnapshots();
+	}
+	handleOrderbookSocketMessage(raw) {
+		const type = raw.type;
+		if ((type === "orderbook_snapshot" || type === "orderbook_delta") && !validMarketFrame(raw)) {
+			this.callbacks.onError?.({
+				type: "error",
+				message: "Invalid market-data frame"
+			});
+			if (typeof raw.outcomeId === "string" && this.subs.has(raw.outcomeId)) this.requestResnapshot(raw.outcomeId);
+			return;
+		}
+		switch (type) {
+			case "orderbook_snapshot":
+				this.handleSnapshot(raw);
+				break;
+			case "orderbook_delta":
+				this.handleDelta(raw);
+				break;
+			case "heartbeat":
+				this.handleHeartbeat(raw);
+				break;
+			case "subscribed":
+				this.callbacks.onSubscribed?.(raw);
+				break;
+			case "unsubscribed":
+				this.callbacks.onUnsubscribed?.(raw);
+				break;
+			case "connected":
+				this.handleOrderbookConnected();
+				break;
+			case "market_resolved":
+				this.handleMarketResolved(raw);
+				break;
+			case "error": {
+				const msg = raw;
+				if (msg.code === "snapshot_unavailable") for (const outcomeId of msg.outcomeIds ?? []) this.queueSnapshotRetry(outcomeId);
+				this.callbacks.onError?.(msg);
+				break;
+			}
+			case "stream_interrupted": {
+				const msg = raw;
+				this.emitDiagnostic({
+					type: "stream_interrupted",
+					channels: msg.channels
+				});
+				this.callbacks.onStreamInterrupted?.(msg);
+				break;
+			}
+		}
+	}
 	/**
 	* Track `eventId` per stream and drop duplicates a resume re-delivers.
 	* App-stream frames go to `subscribeAppEvents` listeners only. Returns
@@ -1279,6 +1521,7 @@ var AggWebSocket = class {
 			timestamp: raw.timestamp / 1e3
 		};
 		const book = snapshotToOrderbook(msg);
+		this.snapshotRetries.delete(msg.outcomeId);
 		this.books.set(msg.outcomeId, new IndexedOrderbook(book));
 		this.bookCheckedAt.set(msg.outcomeId, Date.now());
 		this.resyncing.delete(msg.outcomeId);
@@ -1385,6 +1628,7 @@ var AggWebSocket = class {
 			timestamp: raw.timestamp / 1e3
 		};
 		this.books.delete(msg.outcomeId);
+		this.snapshotRetries.delete(msg.outcomeId);
 		this.bookCheckedAt.delete(msg.outcomeId);
 		this.watchdogResnapshotted.delete(msg.outcomeId);
 		this.pendingResnapshots.delete(msg.outcomeId);
@@ -1425,7 +1669,7 @@ var AggWebSocket = class {
 	*/
 	async checkSilentBooks() {
 		const opts = this.bookWatchdog;
-		if (!opts || !this._connected || this.watchdogAbort) return;
+		if (!opts || !this.orderbookTransportReady() || this.watchdogAbort) return;
 		const now = Date.now();
 		if (now < this.watchdogPausedUntil) return;
 		const silenceMs = opts.silenceMs ?? WATCHDOG_SILENCE_MS;
@@ -1480,7 +1724,7 @@ var AggWebSocket = class {
 					this.watchdogResnapshotted.delete(outcomeId);
 					this.books.delete(outcomeId);
 					this.resyncing.add(outcomeId);
-					this.send({
+					this.sendOrderbook({
 						action: "unsubscribe",
 						channel: "orderbook",
 						outcomeIds: [outcomeId]
@@ -1501,11 +1745,56 @@ var AggWebSocket = class {
 			if (this.watchdogAbort === abort) this.watchdogAbort = null;
 		}
 	}
+	/** Retry only explicitly failed active books; never reconnect healthy sockets. */
+	queueSnapshotRetry(outcomeId) {
+		if (this.destroyed || !this.orderbookTransportReady() || !this.subs.get(outcomeId)?.refCount) return;
+		const previous = this.snapshotRetries.get(outcomeId);
+		if (previous && (Number.isFinite(previous.dueAt) || previous.attempts >= SNAPSHOT_RETRY_MAX_ATTEMPTS)) return;
+		const attempts = (previous?.attempts ?? 0) + 1;
+		const delay = SNAPSHOT_RETRY_TICK_MS * 2 ** (attempts - 1) * (.5 + Math.random() * .5);
+		this.snapshotRetries.set(outcomeId, {
+			attempts,
+			dueAt: Date.now() + delay
+		});
+		this.scheduleSnapshotRetries();
+	}
+	scheduleSnapshotRetries() {
+		if (this.snapshotRetryTimer || !this.orderbookTransportReady() || this.destroyed) return;
+		let nextDueAt = Infinity;
+		for (const retry of this.snapshotRetries.values()) nextDueAt = Math.min(nextDueAt, retry.dueAt);
+		if (!Number.isFinite(nextDueAt)) return;
+		const delay = Math.max(0, nextDueAt - Date.now(), this.snapshotRetryLastSentAt + SNAPSHOT_RETRY_TICK_MS - Date.now());
+		this.snapshotRetryTimer = setTimeout(() => {
+			this.snapshotRetryTimer = null;
+			if (!this.orderbookTransportReady() || this.destroyed) return;
+			const ids = [];
+			for (const [id, retry] of [...this.snapshotRetries].sort((a, b) => a[1].dueAt - b[1].dueAt)) if (!this.subs.get(id)?.refCount) this.snapshotRetries.delete(id);
+			else if (retry.dueAt <= Date.now() && ids.length < SNAPSHOT_RETRY_BATCH_SIZE) {
+				retry.dueAt = Infinity;
+				this.resyncing.add(id);
+				ids.push(id);
+			}
+			if (ids.length) {
+				this.snapshotRetryLastSentAt = Date.now();
+				this.sendOrderbook({
+					action: "resnapshot",
+					channel: "orderbook",
+					outcomeIds: ids
+				});
+			}
+			if ([...this.snapshotRetries.values()].some((retry) => Number.isFinite(retry.dueAt))) this.scheduleSnapshotRetries();
+		}, Math.ceil(delay));
+	}
+	clearSnapshotRetries() {
+		if (this.snapshotRetryTimer) clearTimeout(this.snapshotRetryTimer);
+		this.snapshotRetryTimer = null;
+		this.snapshotRetries.clear();
+	}
 	requestResnapshot(outcomeId, force = false) {
 		if (this.resyncing.has(outcomeId) && !force) return;
 		this.resyncing.add(outcomeId);
-		if (this._connected) {
-			this.send({
+		if (this.orderbookTransportReady()) {
+			this.sendOrderbook({
 				action: "resnapshot",
 				channel: "orderbook",
 				outcomeIds: [outcomeId]
@@ -1514,7 +1803,7 @@ var AggWebSocket = class {
 			return;
 		}
 		this.pendingResnapshots.add(outcomeId);
-		this.ensureConnected();
+		this.ensureOrderbookTransport();
 	}
 	/**
 	* Schedule a microtask that flushes queued subscribe/unsubscribe frames.
@@ -1526,35 +1815,52 @@ var AggWebSocket = class {
 		this.flushScheduled = true;
 		queueMicrotask(() => {
 			this.flushScheduled = false;
-			if (!this._connected) {
+			if (!this.orderbookUrl) {
+				if (!this._connected) {
+					this.pendingFlushSubs.clear();
+					this.pendingFlushUnsubs.clear();
+					this.pendingFlushTradeSubs.clear();
+					this.pendingFlushTradeUnsubs.clear();
+					this.pendingFlushArbSubs.clear();
+					this.pendingFlushArbUnsubs.clear();
+					return;
+				}
+				this.flushPending();
+				return;
+			}
+			if (!this._obConnected) {
 				this.pendingFlushSubs.clear();
 				this.pendingFlushUnsubs.clear();
+			}
+			if (!this._connected) {
 				this.pendingFlushTradeSubs.clear();
 				this.pendingFlushTradeUnsubs.clear();
 				this.pendingFlushArbSubs.clear();
 				this.pendingFlushArbUnsubs.clear();
-				return;
 			}
-			this.flushPending();
+			if (this._obConnected || this._connected) this.flushPending();
 		});
 	}
 	flushPending() {
-		for (const id of [...this.pendingFlushSubs]) if (this.pendingFlushUnsubs.has(id)) {
-			this.pendingFlushSubs.delete(id);
-			this.pendingFlushUnsubs.delete(id);
-		}
-		if (this.pendingFlushSubs.size > 0) {
-			this.sendSubscribe(Array.from(this.pendingFlushSubs));
-			this.pendingFlushSubs.clear();
-		}
-		if (this.pendingFlushUnsubs.size > 0) {
-			this.send({
-				action: "unsubscribe",
-				channel: "orderbook",
-				outcomeIds: Array.from(this.pendingFlushUnsubs)
-			});
-			this.pendingFlushUnsubs.clear();
+		if (!this.orderbookUrl || this._obConnected) {
+			for (const id of [...this.pendingFlushSubs]) if (this.pendingFlushUnsubs.has(id)) {
+				this.pendingFlushSubs.delete(id);
+				this.pendingFlushUnsubs.delete(id);
+			}
+			if (this.pendingFlushSubs.size > 0) {
+				this.sendSubscribe(Array.from(this.pendingFlushSubs));
+				this.pendingFlushSubs.clear();
+			}
+			if (this.pendingFlushUnsubs.size > 0) {
+				this.sendOrderbook({
+					action: "unsubscribe",
+					channel: "orderbook",
+					outcomeIds: Array.from(this.pendingFlushUnsubs)
+				});
+				this.pendingFlushUnsubs.clear();
+			}
 		}
+		if (!this._connected) return;
 		for (const id of [...this.pendingFlushTradeSubs]) if (this.pendingFlushTradeUnsubs.has(id)) {
 			this.pendingFlushTradeSubs.delete(id);
 			this.pendingFlushTradeUnsubs.delete(id);
@@ -1597,25 +1903,33 @@ var AggWebSocket = class {
 		}
 	}
 	sendSubscribe(outcomeIds) {
-		this.send({
+		const msg = {
 			action: "subscribe",
 			channel: "orderbook",
 			outcomeIds
-		});
+		};
+		if (this.orderbookLatency === "realtime") msg.latency = "realtime";
+		this.sendOrderbook(msg);
+	}
+	sendOrderbook(msg) {
+		this.sendOn(this.orderbookUrl ? this.obWs : this.ws, msg);
 	}
 	send(msg) {
-		if (this.ws?.readyState !== WS_OPEN) return;
+		this.sendOn(this.ws, msg);
+	}
+	sendOn(ws, msg) {
+		if (ws?.readyState !== WS_OPEN) return;
 		const m = msg;
 		const key = m.outcomeIds ? "outcomeIds" : m.marketIds ? "marketIds" : void 0;
 		const ids = key ? m[key] : void 0;
 		if (key && ids && ids.length > MAX_IDS_PER_FRAME) {
-			for (let i = 0; i < ids.length; i += MAX_IDS_PER_FRAME) this.ws.send(JSON.stringify({
+			for (let i = 0; i < ids.length; i += MAX_IDS_PER_FRAME) ws.send(JSON.stringify({
 				...m,
 				[key]: ids.slice(i, i + MAX_IDS_PER_FRAME)
 			}));
 			return;
 		}
-		this.ws.send(JSON.stringify(msg));
+		ws.send(JSON.stringify(msg));
 	}
 	activeOrderbookMarkets() {
 		const markets = [];