pmxtjs 2.46.3 → 2.46.5

package/dist/esm/pmxt/client.d.ts

@@ -57,6 +57,7 @@ export interface ExchangeOptions {
  * prediction market platforms (Polymarket, Kalshi, etc.).
  */
 export declare abstract class Exchange {
+    private static readonly OBDATA_WATCH_ALL_SOURCES;
     protected exchangeName: string;
     protected apiKey?: string;
     protected privateKey?: string;
@@ -116,6 +117,7 @@ export declare abstract class Exchange {
     private watchViaWs;
     private wsTransportUnavailableError;
     private isWsTransportUnavailableError;
+    private defaultWatchAllOrderBookVenues;
     private getWsInternals;
     private wsSubscriptionKey;
     private getWsSubscriptionId;
@@ -282,7 +284,8 @@ export declare abstract class Exchange {
      * Call repeatedly in a loop to stream updates (CCXT Pro pattern).
      * Requires hosted mode (`pmxtApiKey` set).
      *
-     * @param venues - Optional venue filter (e.g. ["polymarket", "limitless"])
+     * @param venues - Optional venue filter. Defaults to this exchange's venue
+     *   for venue clients (e.g. Kalshi -> ["kalshi"]); Router defaults to all venues.
      * @returns Next event with source, symbol, and orderbook
      *
      * @example

package/dist/esm/pmxt/client.js

@@ -126,6 +126,12 @@ function convertSubscriptionSnapshot(raw) {
  * prediction market platforms (Polymarket, Kalshi, etc.).
  */
 export class Exchange {
+    static OBDATA_WATCH_ALL_SOURCES = new Set([
+        "polymarket",
+        "limitless",
+        "kalshi",
+        "opinion",
+    ]);
     exchangeName;
     apiKey;
     privateKey;
@@ -358,6 +364,12 @@ export class Exchange {
         return error instanceof PmxtError
             && /connection failed|no websocket|websocket.*not connected/i.test(error.message);
     }
+    defaultWatchAllOrderBookVenues() {
+        if (Exchange.OBDATA_WATCH_ALL_SOURCES.has(this.exchangeName)) {
+            return [this.exchangeName];
+        }
+        return undefined;
+    }
     getWsInternals(ws) {
         return ws;
     }
@@ -384,6 +396,7 @@ export class Exchange {
         }
         internals.activeSubs.delete(subKey);
         internals.subscriptions.delete(requestId);
+        internals.dataQueues.delete(requestId);
         internals.dataStore.delete(requestId);
         const firstArg = args[0] ?? "";
         const symbols = Array.isArray(firstArg)
@@ -1563,7 +1576,8 @@ export class Exchange {
      * Call repeatedly in a loop to stream updates (CCXT Pro pattern).
      * Requires hosted mode (`pmxtApiKey` set).
      *
-     * @param venues - Optional venue filter (e.g. ["polymarket", "limitless"])
+     * @param venues - Optional venue filter. Defaults to this exchange's venue
+     *   for venue clients (e.g. Kalshi -> ["kalshi"]); Router defaults to all venues.
      * @returns Next event with source, symbol, and orderbook
      *
      * @example
@@ -1580,7 +1594,8 @@ export class Exchange {
         if (!this.isHosted) {
             throw new PmxtError("watchAllOrderBooks() requires hosted mode (set pmxtApiKey)");
         }
-        const args = venues ? [venues] : [];
+        const effectiveVenues = venues ?? this.defaultWatchAllOrderBookVenues();
+        const args = effectiveVenues?.length ? [effectiveVenues] : [];
         const wsData = await this.watchViaWs("watchAllOrderBooks", args);
         if (wsData !== null) {
             return {

package/dist/esm/pmxt/ws-client.d.ts

@@ -18,7 +18,9 @@ export declare class SidecarWsClient {
     private accessToken;
     private authParamName;
     private closed;
-    /** requestId -> latest data payload */
+    /** requestId -> queued data payloads for single-event watch methods */
+    private dataQueues;
+    /** requestId[:symbol] -> latest data payload for batch snapshots */
     private dataStore;
     /** requestId -> subscription metadata */
     private subscriptions;
@@ -30,6 +32,7 @@ export declare class SidecarWsClient {
     private connect;
     private getWebSocketConstructor;
     private dispatch;
+    private deliverOrQueue;
     subscribe(exchange: string, method: string, args: any[], credentials?: Record<string, any>, timeoutMs?: number): Promise<any>;
     subscribeBatch(exchange: string, method: string, args: any[], credentials?: Record<string, any>, timeoutMs?: number): Promise<Record<string, any>>;
     close(): void;

package/dist/esm/pmxt/ws-client.js

@@ -7,6 +7,7 @@
  * does not support the /ws endpoint.
  */
 import { PmxtError } from "./errors.js";
+const MAX_QUEUED_MESSAGES_PER_SUBSCRIPTION = 100_000;
 /**
  * Multiplexed WebSocket client for the pmxt sidecar.
  *
@@ -19,7 +20,9 @@ export class SidecarWsClient {
     accessToken;
     authParamName;
     closed = false;
-    /** requestId -> latest data payload */
+    /** requestId -> queued data payloads for single-event watch methods */
+    dataQueues = new Map();
+    /** requestId[:symbol] -> latest data payload for batch snapshots */
     dataStore = new Map();
     /** requestId -> subscription metadata */
     subscriptions = new Map();
@@ -154,16 +157,27 @@ export class SidecarWsClient {
         if (eventType === "data" && requestId) {
             const symbol = msg.symbol || "";
             const data = msg.data || {};
-            // Store by (requestId:symbol) for batch methods
+            // Store by (requestId:symbol) for batch methods.
             this.dataStore.set(`${requestId}:${symbol}`, data);
-            // Store by requestId alone for single-symbol methods
-            this.dataStore.set(requestId, data);
-            const sub = this.subscriptions.get(requestId);
-            if (sub?.resolve) {
-                sub.resolve(data);
-                sub.resolve = null;
-                sub.reject = null;
-            }
+            this.deliverOrQueue(requestId, data);
+        }
+    }
+    deliverOrQueue(requestId, data) {
+        const sub = this.subscriptions.get(requestId);
+        if (sub?.resolve) {
+            sub.resolve(data);
+            sub.resolve = null;
+            sub.reject = null;
+            return;
+        }
+        let queue = this.dataQueues.get(requestId);
+        if (!queue) {
+            queue = [];
+            this.dataQueues.set(requestId, queue);
+        }
+        queue.push(data);
+        if (queue.length > MAX_QUEUED_MESSAGES_PER_SUBSCRIPTION) {
+            queue.splice(0, queue.length - MAX_QUEUED_MESSAGES_PER_SUBSCRIPTION);
         }
     }
     // ------------------------------------------------------------------
@@ -233,8 +247,8 @@ export class SidecarWsClient {
             throw new PmxtError('[ws-client] Cannot send: WebSocket not connected');
         }
         this.ws.send(JSON.stringify(message));
-        // Wait for first data event
-        await this.waitForData(requestId, timeoutMs);
+        // Wait for first data event.
+        const firstData = await this.waitForData(requestId, timeoutMs);
         // Collect per-symbol data
         const result = {};
         for (const symbol of symbols) {
@@ -246,9 +260,8 @@ export class SidecarWsClient {
         }
         // If no per-symbol data, return the single data event as-is
         if (Object.keys(result).length === 0) {
-            const data = this.dataStore.get(requestId);
-            if (data && typeof data === "object") {
-                return data;
+            if (firstData && typeof firstData === "object") {
+                return firstData;
             }
         }
         return result;
@@ -264,6 +277,8 @@ export class SidecarWsClient {
             }
             this.ws = null;
         }
+        this.dataQueues.clear();
+        this.dataStore.clear();
     }
     get connected() {
         return this.ws !== null && !this.closed;
@@ -272,11 +287,14 @@ export class SidecarWsClient {
     // Internal
     // ------------------------------------------------------------------
     waitForData(requestId, timeoutMs) {
-        // Check if data is already available
-        const existing = this.dataStore.get(requestId);
-        if (existing !== undefined) {
-            this.dataStore.delete(requestId);
-            return Promise.resolve(existing);
+        // Check if queued data is already available.
+        const queue = this.dataQueues.get(requestId);
+        if (queue && queue.length > 0) {
+            const next = queue.shift();
+            if (queue.length === 0) {
+                this.dataQueues.delete(requestId);
+            }
+            return Promise.resolve(next);
         }
         return new Promise((resolve, reject) => {
             const sub = this.subscriptions.get(requestId);

package/dist/pmxt/client.d.ts

@@ -57,6 +57,7 @@ export interface ExchangeOptions {
  * prediction market platforms (Polymarket, Kalshi, etc.).
  */
 export declare abstract class Exchange {
+    private static readonly OBDATA_WATCH_ALL_SOURCES;
     protected exchangeName: string;
     protected apiKey?: string;
     protected privateKey?: string;
@@ -116,6 +117,7 @@ export declare abstract class Exchange {
     private watchViaWs;
     private wsTransportUnavailableError;
     private isWsTransportUnavailableError;
+    private defaultWatchAllOrderBookVenues;
     private getWsInternals;
     private wsSubscriptionKey;
     private getWsSubscriptionId;
@@ -282,7 +284,8 @@ export declare abstract class Exchange {
      * Call repeatedly in a loop to stream updates (CCXT Pro pattern).
      * Requires hosted mode (`pmxtApiKey` set).
      *
-     * @param venues - Optional venue filter (e.g. ["polymarket", "limitless"])
+     * @param venues - Optional venue filter. Defaults to this exchange's venue
+     *   for venue clients (e.g. Kalshi -> ["kalshi"]); Router defaults to all venues.
      * @returns Next event with source, symbol, and orderbook
      *
      * @example

package/dist/pmxt/client.js

@@ -129,6 +129,12 @@ function convertSubscriptionSnapshot(raw) {
  * prediction market platforms (Polymarket, Kalshi, etc.).
  */
 class Exchange {
+    static OBDATA_WATCH_ALL_SOURCES = new Set([
+        "polymarket",
+        "limitless",
+        "kalshi",
+        "opinion",
+    ]);
     exchangeName;
     apiKey;
     privateKey;
@@ -361,6 +367,12 @@ class Exchange {
         return error instanceof errors_js_1.PmxtError
             && /connection failed|no websocket|websocket.*not connected/i.test(error.message);
     }
+    defaultWatchAllOrderBookVenues() {
+        if (Exchange.OBDATA_WATCH_ALL_SOURCES.has(this.exchangeName)) {
+            return [this.exchangeName];
+        }
+        return undefined;
+    }
     getWsInternals(ws) {
         return ws;
     }
@@ -387,6 +399,7 @@ class Exchange {
         }
         internals.activeSubs.delete(subKey);
         internals.subscriptions.delete(requestId);
+        internals.dataQueues.delete(requestId);
         internals.dataStore.delete(requestId);
         const firstArg = args[0] ?? "";
         const symbols = Array.isArray(firstArg)
@@ -1566,7 +1579,8 @@ class Exchange {
      * Call repeatedly in a loop to stream updates (CCXT Pro pattern).
      * Requires hosted mode (`pmxtApiKey` set).
      *
-     * @param venues - Optional venue filter (e.g. ["polymarket", "limitless"])
+     * @param venues - Optional venue filter. Defaults to this exchange's venue
+     *   for venue clients (e.g. Kalshi -> ["kalshi"]); Router defaults to all venues.
      * @returns Next event with source, symbol, and orderbook
      *
      * @example
@@ -1583,7 +1597,8 @@ class Exchange {
         if (!this.isHosted) {
             throw new errors_js_1.PmxtError("watchAllOrderBooks() requires hosted mode (set pmxtApiKey)");
         }
-        const args = venues ? [venues] : [];
+        const effectiveVenues = venues ?? this.defaultWatchAllOrderBookVenues();
+        const args = effectiveVenues?.length ? [effectiveVenues] : [];
         const wsData = await this.watchViaWs("watchAllOrderBooks", args);
         if (wsData !== null) {
             return {

package/dist/pmxt/ws-client.d.ts

@@ -18,7 +18,9 @@ export declare class SidecarWsClient {
     private accessToken;
     private authParamName;
     private closed;
-    /** requestId -> latest data payload */
+    /** requestId -> queued data payloads for single-event watch methods */
+    private dataQueues;
+    /** requestId[:symbol] -> latest data payload for batch snapshots */
     private dataStore;
     /** requestId -> subscription metadata */
     private subscriptions;
@@ -30,6 +32,7 @@ export declare class SidecarWsClient {
     private connect;
     private getWebSocketConstructor;
     private dispatch;
+    private deliverOrQueue;
     subscribe(exchange: string, method: string, args: any[], credentials?: Record<string, any>, timeoutMs?: number): Promise<any>;
     subscribeBatch(exchange: string, method: string, args: any[], credentials?: Record<string, any>, timeoutMs?: number): Promise<Record<string, any>>;
     close(): void;

package/dist/pmxt/ws-client.js

@@ -10,6 +10,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.SidecarWsClient = void 0;
 const errors_js_1 = require("./errors.js");
+const MAX_QUEUED_MESSAGES_PER_SUBSCRIPTION = 100_000;
 /**
  * Multiplexed WebSocket client for the pmxt sidecar.
  *
@@ -22,7 +23,9 @@ class SidecarWsClient {
     accessToken;
     authParamName;
     closed = false;
-    /** requestId -> latest data payload */
+    /** requestId -> queued data payloads for single-event watch methods */
+    dataQueues = new Map();
+    /** requestId[:symbol] -> latest data payload for batch snapshots */
     dataStore = new Map();
     /** requestId -> subscription metadata */
     subscriptions = new Map();
@@ -157,16 +160,27 @@ class SidecarWsClient {
         if (eventType === "data" && requestId) {
             const symbol = msg.symbol || "";
             const data = msg.data || {};
-            // Store by (requestId:symbol) for batch methods
+            // Store by (requestId:symbol) for batch methods.
             this.dataStore.set(`${requestId}:${symbol}`, data);
-            // Store by requestId alone for single-symbol methods
-            this.dataStore.set(requestId, data);
-            const sub = this.subscriptions.get(requestId);
-            if (sub?.resolve) {
-                sub.resolve(data);
-                sub.resolve = null;
-                sub.reject = null;
-            }
+            this.deliverOrQueue(requestId, data);
+        }
+    }
+    deliverOrQueue(requestId, data) {
+        const sub = this.subscriptions.get(requestId);
+        if (sub?.resolve) {
+            sub.resolve(data);
+            sub.resolve = null;
+            sub.reject = null;
+            return;
+        }
+        let queue = this.dataQueues.get(requestId);
+        if (!queue) {
+            queue = [];
+            this.dataQueues.set(requestId, queue);
+        }
+        queue.push(data);
+        if (queue.length > MAX_QUEUED_MESSAGES_PER_SUBSCRIPTION) {
+            queue.splice(0, queue.length - MAX_QUEUED_MESSAGES_PER_SUBSCRIPTION);
         }
     }
     // ------------------------------------------------------------------
@@ -236,8 +250,8 @@ class SidecarWsClient {
             throw new errors_js_1.PmxtError('[ws-client] Cannot send: WebSocket not connected');
         }
         this.ws.send(JSON.stringify(message));
-        // Wait for first data event
-        await this.waitForData(requestId, timeoutMs);
+        // Wait for first data event.
+        const firstData = await this.waitForData(requestId, timeoutMs);
         // Collect per-symbol data
         const result = {};
         for (const symbol of symbols) {
@@ -249,9 +263,8 @@ class SidecarWsClient {
         }
         // If no per-symbol data, return the single data event as-is
         if (Object.keys(result).length === 0) {
-            const data = this.dataStore.get(requestId);
-            if (data && typeof data === "object") {
-                return data;
+            if (firstData && typeof firstData === "object") {
+                return firstData;
             }
         }
         return result;
@@ -267,6 +280,8 @@ class SidecarWsClient {
             }
             this.ws = null;
         }
+        this.dataQueues.clear();
+        this.dataStore.clear();
     }
     get connected() {
         return this.ws !== null && !this.closed;
@@ -275,11 +290,14 @@ class SidecarWsClient {
     // Internal
     // ------------------------------------------------------------------
     waitForData(requestId, timeoutMs) {
-        // Check if data is already available
-        const existing = this.dataStore.get(requestId);
-        if (existing !== undefined) {
-            this.dataStore.delete(requestId);
-            return Promise.resolve(existing);
+        // Check if queued data is already available.
+        const queue = this.dataQueues.get(requestId);
+        if (queue && queue.length > 0) {
+            const next = queue.shift();
+            if (queue.length === 0) {
+                this.dataQueues.delete(requestId);
+            }
+            return Promise.resolve(next);
         }
         return new Promise((resolve, reject) => {
             const sub = this.subscriptions.get(requestId);

package/generated/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pmxtjs",
-  "version": "2.46.3",
+  "version": "2.46.5",
   "description": "OpenAPI client for pmxtjs",
   "author": "OpenAPI-Generator",
   "repository": {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pmxtjs",
-  "version": "2.46.3",
+  "version": "2.46.5",
   "description": "Unified prediction market data API - The ccxt for prediction markets",
   "author": "PMXT Contributors",
   "repository": {
@@ -43,7 +43,7 @@
     "unified"
   ],
   "dependencies": {
-    "pmxt-core": "2.46.3",
+    "pmxt-core": "2.46.5",
     "ws": "^8.18.0"
   },
   "devDependencies": {

package/pmxt/client.ts

@@ -61,6 +61,7 @@ interface SidecarWsClientInternals {
     ws: RawWebSocketLike | null;
     activeSubs: Map<string, string>;
     subscriptions: Map<string, { reject: ((error: Error) => void) | null }>;
+    dataQueues: Map<string, any[]>;
     dataStore: Map<string, any>;
 }
 
@@ -238,6 +239,13 @@ export interface ExchangeOptions {
  * prediction market platforms (Polymarket, Kalshi, etc.).
  */
 export abstract class Exchange {
+    private static readonly OBDATA_WATCH_ALL_SOURCES = new Set([
+        "polymarket",
+        "limitless",
+        "kalshi",
+        "opinion",
+    ]);
+
     protected exchangeName: string;
     protected apiKey?: string;
     protected privateKey?: string;
@@ -508,6 +516,13 @@ export abstract class Exchange {
             && /connection failed|no websocket|websocket.*not connected/i.test(error.message);
     }
 
+    private defaultWatchAllOrderBookVenues(): string[] | undefined {
+        if (Exchange.OBDATA_WATCH_ALL_SOURCES.has(this.exchangeName)) {
+            return [this.exchangeName];
+        }
+        return undefined;
+    }
+
     private getWsInternals(ws: SidecarWsClient): SidecarWsClientInternals {
         return ws as unknown as SidecarWsClientInternals;
     }
@@ -538,6 +553,7 @@ export abstract class Exchange {
 
         internals.activeSubs.delete(subKey);
         internals.subscriptions.delete(requestId);
+        internals.dataQueues.delete(requestId);
         internals.dataStore.delete(requestId);
 
         const firstArg = args[0] ?? "";
@@ -1718,7 +1734,8 @@ export abstract class Exchange {
      * Call repeatedly in a loop to stream updates (CCXT Pro pattern).
      * Requires hosted mode (`pmxtApiKey` set).
      *
-     * @param venues - Optional venue filter (e.g. ["polymarket", "limitless"])
+     * @param venues - Optional venue filter. Defaults to this exchange's venue
+     *   for venue clients (e.g. Kalshi -> ["kalshi"]); Router defaults to all venues.
      * @returns Next event with source, symbol, and orderbook
      *
      * @example
@@ -1737,7 +1754,8 @@ export abstract class Exchange {
             throw new PmxtError("watchAllOrderBooks() requires hosted mode (set pmxtApiKey)");
         }
 
-        const args: any[] = venues ? [venues] : [];
+        const effectiveVenues = venues ?? this.defaultWatchAllOrderBookVenues();
+        const args: any[] = effectiveVenues?.length ? [effectiveVenues] : [];
         const wsData = await this.watchViaWs("watchAllOrderBooks", args);
         if (wsData !== null) {
             return {

package/pmxt/ws-client.ts

@@ -9,6 +9,8 @@
 
 import { PmxtError } from "./errors.js";
 
+const MAX_QUEUED_MESSAGES_PER_SUBSCRIPTION = 100_000;
+
 interface WsSubscription {
     readonly requestId: string;
     readonly method: string;
@@ -39,7 +41,9 @@ export class SidecarWsClient {
     private authParamName: string;
     private closed = false;
 
-    /** requestId -> latest data payload */
+    /** requestId -> queued data payloads for single-event watch methods */
+    private dataQueues: Map<string, any[]> = new Map();
+    /** requestId[:symbol] -> latest data payload for batch snapshots */
     private dataStore: Map<string, any> = new Map();
     /** requestId -> subscription metadata */
     private subscriptions: Map<string, WsSubscription> = new Map();
@@ -189,17 +193,30 @@ export class SidecarWsClient {
             const symbol = msg.symbol || "";
             const data = msg.data || {};
 
-            // Store by (requestId:symbol) for batch methods
+            // Store by (requestId:symbol) for batch methods.
             this.dataStore.set(`${requestId}:${symbol}`, data);
-            // Store by requestId alone for single-symbol methods
-            this.dataStore.set(requestId, data);
+            this.deliverOrQueue(requestId, data);
+        }
+    }
 
-            const sub = this.subscriptions.get(requestId);
-            if (sub?.resolve) {
-                sub.resolve(data);
-                sub.resolve = null;
-                sub.reject = null;
-            }
+    private deliverOrQueue(requestId: string, data: any): void {
+        const sub = this.subscriptions.get(requestId);
+        if (sub?.resolve) {
+            sub.resolve(data);
+            sub.resolve = null;
+            sub.reject = null;
+            return;
+        }
+
+        let queue = this.dataQueues.get(requestId);
+        if (!queue) {
+            queue = [];
+            this.dataQueues.set(requestId, queue);
+        }
+        queue.push(data);
+
+        if (queue.length > MAX_QUEUED_MESSAGES_PER_SUBSCRIPTION) {
+            queue.splice(0, queue.length - MAX_QUEUED_MESSAGES_PER_SUBSCRIPTION);
         }
     }
 
@@ -297,8 +314,8 @@ export class SidecarWsClient {
         }
         this.ws.send(JSON.stringify(message));
 
-        // Wait for first data event
-        await this.waitForData(requestId, timeoutMs);
+        // Wait for first data event.
+        const firstData = await this.waitForData(requestId, timeoutMs);
 
         // Collect per-symbol data
         const result: Record<string, any> = {};
@@ -312,9 +329,8 @@ export class SidecarWsClient {
 
         // If no per-symbol data, return the single data event as-is
         if (Object.keys(result).length === 0) {
-            const data = this.dataStore.get(requestId);
-            if (data && typeof data === "object") {
-                return data;
+            if (firstData && typeof firstData === "object") {
+                return firstData;
             }
         }
 
@@ -331,6 +347,8 @@ export class SidecarWsClient {
             }
             this.ws = null;
         }
+        this.dataQueues.clear();
+        this.dataStore.clear();
     }
 
     get connected(): boolean {
@@ -342,11 +360,14 @@ export class SidecarWsClient {
     // ------------------------------------------------------------------
 
     private waitForData(requestId: string, timeoutMs: number): Promise<any> {
-        // Check if data is already available
-        const existing = this.dataStore.get(requestId);
-        if (existing !== undefined) {
-            this.dataStore.delete(requestId);
-            return Promise.resolve(existing);
+        // Check if queued data is already available.
+        const queue = this.dataQueues.get(requestId);
+        if (queue && queue.length > 0) {
+            const next = queue.shift();
+            if (queue.length === 0) {
+                this.dataQueues.delete(requestId);
+            }
+            return Promise.resolve(next);
         }
 
         return new Promise<any>((resolve, reject) => {