@agg-build/sdk 4.32.0 → 4.34.0

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

@@ -509,6 +509,7 @@ const WATCHDOG_CHECK_INTERVAL_MS = 6e4;
 const WATCHDOG_BATCH_MAX = 100;
 /** A watchdog REST check that takes longer than this is abandoned. */
 const WATCHDOG_REQUEST_TIMEOUT_MS = 15e3;
+const CATALOG_FRAME_ID_PREFIX = "catalog-";
 /**
 * Agg WebSocket client. Single WS connection with refcounted market subscriptions.
 */
@@ -548,6 +549,10 @@ var AggWebSocket = class {
 		this.seenEventIds = /* @__PURE__ */ new Set();
 		this.hasConnected = false;
 		this.appEventCbs = /* @__PURE__ */ new Set();
+		this.catalogSubs = /* @__PURE__ */ new Set();
+		this.catalogSentKey = null;
+		this.catalogFrameSeq = 0;
+		this.catalogAckedSeq = 0;
 		this.rejected = false;
 		this.deferBookViews = options.deferBookViews ?? false;
 		this.url = options.url;
@@ -601,6 +606,7 @@ var AggWebSocket = class {
 			tradeOutcomeIds: this.activeTradeMarkets(),
 			arbMarketIds: this.activeArbMarkets(),
 			arbFeedSubscribers: this.arbFeedCbs.size,
+			catalogSubscribers: this.catalogSubs.size,
 			cachedBooks: this.books.size,
 			cachedArb: this.latestArb.size,
 			resyncingBooks: this.resyncing.size,
@@ -683,6 +689,78 @@ var AggWebSocket = class {
 		};
 	}
 	/**
+	* Subscribe to the catalog feed: new, changed and deleted events and
+	* markets. Live only — pair it with `GET /catalog/changes` (or use
+	* `AggClient.watchCatalog`, which does both).
+	*
+	* One server subscription is shared by every caller. Its filter is the
+	* union of the callers' filters (no filter when any caller has none), and
+	* each caller only receives frames matching its own filter. The subscribe
+	* is re-sent on every reconnect; `onSubscribed` fires each time the server
+	* confirms it. Returns an unsubscribe function.
+	*/
+	subscribeCatalog(filter, cb, opts = {}) {
+		const sub = {
+			filter: {
+				...filter.venues?.length ? { venues: [...filter.venues] } : {},
+				...filter.entities?.length ? { entities: [...filter.entities] } : {}
+			},
+			cb,
+			opts
+		};
+		this.catalogSubs.add(sub);
+		this.ensureConnected();
+		if (this._connected) {
+			if (!this.sendCatalogSubscribe(sub)) {
+				if (this.catalogAckedSeq >= this.catalogFrameSeq) queueMicrotask(() => {
+					if (this.catalogSubs.has(sub)) sub.opts.onSubscribed?.();
+				});
+				else sub.awaitingAck = this.catalogFrameSeq;
+			}
+		}
+		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();
+		};
+	}
+	/**
+	* Send the union filter if it differs from what the server holds. Callers
+	* in `confirm` wait for this frame's ack. Returns whether a frame was sent.
+	*/
+	sendCatalogSubscribe(...confirm) {
+		const filter = unionCatalogFilter([...this.catalogSubs].map((s) => s.filter));
+		const key = JSON.stringify(filter);
+		if (key === this.catalogSentKey) return false;
+		this.catalogSentKey = key;
+		const seq = ++this.catalogFrameSeq;
+		for (const sub of confirm) sub.awaitingAck = seq;
+		this.send({
+			action: "subscribe",
+			channel: "catalog",
+			...filter,
+			id: `${CATALOG_FRAME_ID_PREFIX}${seq}`
+		});
+		return true;
+	}
+	handleCatalogAck(msg) {
+		const seq = catalogFrameSeq(msg.id) ?? this.catalogFrameSeq;
+		if (seq > this.catalogAckedSeq) this.catalogAckedSeq = seq;
+		for (const sub of [...this.catalogSubs]) {
+			if (sub.awaitingAck === void 0 || sub.awaitingAck > seq) continue;
+			sub.awaitingAck = void 0;
+			sub.opts.onSubscribed?.();
+		}
+	}
+	handleCatalogChange(msg) {
+		for (const sub of [...this.catalogSubs]) if (this.catalogSubs.has(sub) && matchesCatalogFilter(sub.filter, msg)) sub.cb(msg);
+	}
+	/**
 	* Subscribe to a feed by outcome ID.
 	* @param outcomeId  The venueMarketOutcomeId to subscribe to.
 	* @param channel    "orderbook" (default) or "trades".
@@ -887,6 +965,8 @@ var AggWebSocket = class {
 		this.arbSubs.clear();
 		this.arbFeedCbs.clear();
 		this.appEventCbs.clear();
+		this.catalogSubs.clear();
+		this.catalogSentKey = null;
 		this.seenEventIds.clear();
 		this.latestArb.clear();
 		this.pendingFlushArbSubs.clear();
@@ -944,7 +1024,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.initialToken)) this.scheduleReconnect();
+			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();
 		};
 		ws.onerror = () => {};
 	}
@@ -1015,6 +1095,7 @@ var AggWebSocket = class {
 				this.handleHeartbeat(raw);
 				break;
 			case "subscribed":
+				if (raw.channel === "catalog") this.handleCatalogAck(raw);
 				this.callbacks.onSubscribed?.(raw);
 				break;
 			case "unsubscribed":
@@ -1046,13 +1127,24 @@ var AggWebSocket = class {
 					channels: msg.channels
 				});
 				this.callbacks.onStreamInterrupted?.(msg);
+				if (msg.channels?.includes("catalog")) for (const sub of [...this.catalogSubs]) sub.opts.onInterrupted?.();
 				break;
 			}
 			case "market_resolved":
 				this.handleMarketResolved(raw);
 				break;
-			case "error":
-				this.callbacks.onError?.(raw);
+			case "error": {
+				const msg = raw;
+				const seq = catalogFrameSeq(msg.id);
+				if (seq !== void 0) {
+					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);
+				}
+				this.callbacks.onError?.(msg);
+				break;
+			}
+			case "catalog_change":
+				this.handleCatalogChange(raw);
 				break;
 			case "order_submitted":
 				this.handleOrderSubmitted(raw);
@@ -1152,6 +1244,9 @@ var AggWebSocket = class {
 			channel: "arb-feed"
 		});
 		if (this.appEventCbs.size > 0) this.sendAppEventsSubscribe();
+		this.catalogSentKey = null;
+		this.catalogAckedSeq = this.catalogFrameSeq;
+		if (this.catalogSubs.size > 0) this.sendCatalogSubscribe(...this.catalogSubs);
 	}
 	/**
 	* Track `eventId` per stream and drop duplicates a resume re-delivers.
@@ -1556,6 +1651,24 @@ var AggWebSocket = class {
 		return this.enableLogs;
 	}
 };
+/** Union of caller filters; an unset dimension on any caller leaves it unset. */
+function unionCatalogFilter(filters) {
+	const union = {};
+	if (filters.every((f) => f.venues?.length)) union.venues = [...new Set(filters.flatMap((f) => f.venues))].sort();
+	if (filters.every((f) => f.entities?.length)) union.entities = [...new Set(filters.flatMap((f) => f.entities))].sort();
+	return union;
+}
+/** Same rule as the server: deletes carry no venue and pass the venue filter. */
+function matchesCatalogFilter(filter, change) {
+	if (filter.entities && !filter.entities.includes(change.entity)) return false;
+	if (change.op === "deleted" || change.venue === null) return true;
+	return !filter.venues || filter.venues.includes(change.venue);
+}
+function catalogFrameSeq(id) {
+	if (typeof id !== "string" || !id.startsWith(CATALOG_FRAME_ID_PREFIX)) return void 0;
+	const seq = Number(id.slice(8));
+	return Number.isInteger(seq) ? seq : void 0;
+}
 /** Order server event ids ("<ms>-<seq>"); an absent id sorts first. */
 function compareEventIds(a, b) {
 	if (b === void 0) return 1;