pmxtjs 2.44.5 → 2.45.0

package/dist/esm/index.d.ts

@@ -22,9 +22,10 @@ import { Router } from "./pmxt/router.js";
 import { ServerManager } from "./pmxt/server-manager.js";
 import * as models from "./pmxt/models.js";
 import * as errors from "./pmxt/errors.js";
-export { Exchange, Polymarket, Kalshi, KalshiDemo, Limitless, Myriad, Probable, Baozi, Opinion, Metaculus, Smarkets, PolymarketUS, GeminiTitan, Hyperliquid, Mock, PolymarketOptions } from "./pmxt/client.js";
+export { Exchange, Polymarket, Kalshi, KalshiDemo, Limitless, Myriad, Probable, Baozi, Opinion, Metaculus, Smarkets, PolymarketUS, GeminiTitan, Hyperliquid, SuiBets, Mock, PolymarketOptions } from "./pmxt/client.js";
 export { Router } from "./pmxt/router.js";
 export { ServerManager } from "./pmxt/server-manager.js";
+export { HOSTED_URL, LOCAL_URL, ENV, resolvePmxtBaseUrl } from "./pmxt/constants.js";
 export { MarketList } from "./pmxt/models.js";
 export type * from "./pmxt/models.js";
 export * from "./pmxt/errors.js";

package/dist/esm/index.js

@@ -22,9 +22,10 @@ import { Router } from "./pmxt/router.js";
 import { ServerManager } from "./pmxt/server-manager.js";
 import * as models from "./pmxt/models.js";
 import * as errors from "./pmxt/errors.js";
-export { Exchange, Polymarket, Kalshi, KalshiDemo, Limitless, Myriad, Probable, Baozi, Opinion, Metaculus, Smarkets, PolymarketUS, GeminiTitan, Hyperliquid, Mock } from "./pmxt/client.js";
+export { Exchange, Polymarket, Kalshi, KalshiDemo, Limitless, Myriad, Probable, Baozi, Opinion, Metaculus, Smarkets, PolymarketUS, GeminiTitan, Hyperliquid, SuiBets, Mock } from "./pmxt/client.js";
 export { Router } from "./pmxt/router.js";
 export { ServerManager } from "./pmxt/server-manager.js";
+export { HOSTED_URL, LOCAL_URL, ENV, resolvePmxtBaseUrl } from "./pmxt/constants.js";
 export { MarketList } from "./pmxt/models.js";
 export * from "./pmxt/errors.js";
 const defaultManager = new ServerManager();

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

@@ -106,7 +106,7 @@ export declare abstract class Exchange {
      * Return the shared WebSocket client, creating it on first use.
      *
      * Returns `null` if the sidecar /ws endpoint was previously found
-     * to be unavailable, letting callers fall back to HTTP.
+     * to be unavailable.
      */
     private getOrCreateWs;
     /**
@@ -114,6 +114,13 @@ export declare abstract class Exchange {
      * Returns the raw data on success, or `null` if WS is unavailable.
      */
     private watchViaWs;
+    private wsTransportUnavailableError;
+    private isWsTransportUnavailableError;
+    private getWsInternals;
+    private wsSubscriptionKey;
+    private getWsSubscriptionId;
+    private clearWsSubscription;
+    private sendWsMessage;
     /**
      * Call an exchange-specific REST endpoint by its operationId.
      * This provides direct access to all implicit API methods defined in
@@ -251,9 +258,6 @@ export declare abstract class Exchange {
      * order book snapshot. Call repeatedly in a loop to stream updates
      * (CCXT Pro pattern).
      *
-     * Prefers the sidecar WebSocket transport when available, falling
-     * back to HTTP POST for older sidecars.
-     *
      * @param outcomeIds - Array of outcome IDs (or MarketOutcome objects)
      * @param limit - Optional depth limit for each order book
      * @param params - Optional exchange-specific parameters
@@ -713,6 +717,18 @@ export declare class GeminiTitan extends Exchange {
 export declare class Hyperliquid extends Exchange {
     constructor(options?: ExchangeOptions);
 }
+/**
+ * SuiBets exchange client.
+ *
+ * @example
+ * ```typescript
+ * const suibets = new SuiBets();
+ * const markets = await suibets.fetchMarkets();
+ * ```
+ */
+export declare class SuiBets extends Exchange {
+    constructor(options?: ExchangeOptions);
+}
 /**
  * Mock exchange client.
  *

package/dist/esm/pmxt/client.js

@@ -297,7 +297,7 @@ export class Exchange {
      * Return the shared WebSocket client, creating it on first use.
      *
      * Returns `null` if the sidecar /ws endpoint was previously found
-     * to be unavailable, letting callers fall back to HTTP.
+     * to be unavailable.
      */
     async getOrCreateWs() {
         if (this._wsUnsupported)
@@ -345,13 +345,65 @@ export class Exchange {
             return await ws.subscribe(this.exchangeName, method, args, this.getCredentials());
         }
         catch (error) {
-            // Only fall back to HTTP for transport-level failures
-            if (error instanceof PmxtError && /connection failed|no websocket/i.test(error.message)) {
+            if (this.isWsTransportUnavailableError(error)) {
                 return null;
             }
             throw error;
         }
     }
+    wsTransportUnavailableError(method) {
+        return new PmxtError(`${method}() requires WebSocket transport — connection failed`);
+    }
+    isWsTransportUnavailableError(error) {
+        return error instanceof PmxtError
+            && /connection failed|no websocket|websocket.*not connected/i.test(error.message);
+    }
+    getWsInternals(ws) {
+        return ws;
+    }
+    wsSubscriptionKey(method, args) {
+        const firstArg = args[0] ?? "";
+        return Array.isArray(firstArg)
+            ? `${method}:${[...firstArg].sort().join(",")}`
+            : `${method}:${firstArg}`;
+    }
+    getWsSubscriptionId(ws, method, args) {
+        const internals = this.getWsInternals(ws);
+        const subKey = this.wsSubscriptionKey(method, args);
+        return internals.activeSubs.get(subKey);
+    }
+    clearWsSubscription(ws, method, args) {
+        const internals = this.getWsInternals(ws);
+        const subKey = this.wsSubscriptionKey(method, args);
+        const requestId = internals.activeSubs.get(subKey);
+        if (!requestId)
+            return;
+        const sub = internals.subscriptions.get(requestId);
+        if (sub?.reject) {
+            sub.reject(new PmxtError(`${method} subscription cancelled`));
+        }
+        internals.activeSubs.delete(subKey);
+        internals.subscriptions.delete(requestId);
+        internals.dataStore.delete(requestId);
+        const firstArg = args[0] ?? "";
+        const symbols = Array.isArray(firstArg)
+            ? firstArg.map(String)
+            : firstArg
+                ? [String(firstArg)]
+                : [];
+        for (const symbol of symbols) {
+            internals.dataStore.delete(`${requestId}:${symbol}`);
+        }
+    }
+    async sendWsMessage(ws, message) {
+        const internals = this.getWsInternals(ws);
+        await internals.ensureConnected();
+        const socket = internals.ws;
+        if (!socket) {
+            throw new PmxtError('[ws-client] Cannot send: WebSocket not connected');
+        }
+        socket.send(JSON.stringify(message));
+    }
     // Low-Level API Access
     /**
      * Call an exchange-specific REST endpoint by its operationId.
@@ -1002,25 +1054,28 @@ export class Exchange {
     }
     async unwatchOrderBook(outcomeId) {
         await this.initPromise;
+        const resolvedOutcomeId = resolveOutcomeId(outcomeId);
+        const args = [resolvedOutcomeId];
         try {
-            const args = [];
-            args.push(resolveOutcomeId(outcomeId));
-            const response = await this.fetchWithRetry(`${this.resolveBaseUrl()}/api/${this.exchangeName}/unwatchOrderBook`, {
-                method: 'POST',
-                headers: { 'Content-Type': 'application/json', ...this.getAuthHeaders() },
-                body: JSON.stringify({ args, credentials: this.getCredentials() }),
+            const ws = await this.getOrCreateWs();
+            if (!ws) {
+                throw this.wsTransportUnavailableError("unwatchOrderBook");
+            }
+            const requestId = this.getWsSubscriptionId(ws, "watchOrderBook", args)
+                ?? `req-${Math.random().toString(36).slice(2, 14)}`;
+            await this.sendWsMessage(ws, {
+                id: requestId,
+                action: "unsubscribe",
+                exchange: this.exchangeName,
+                method: "unwatchOrderBook",
+                args,
             });
-            if (!response.ok) {
-                const body = await response.json().catch(() => ({}));
-                if (body.error && typeof body.error === "object") {
-                    throw fromServerError(body.error);
-                }
-                throw new PmxtError(body.error?.message || response.statusText);
-            }
-            const json = await response.json();
-            this.handleResponse(json);
+            this.clearWsSubscription(ws, "watchOrderBook", args);
         }
         catch (error) {
+            if (this.isWsTransportUnavailableError(error)) {
+                throw this.wsTransportUnavailableError("unwatchOrderBook");
+            }
             if (error instanceof PmxtError)
                 throw error;
             throw new PmxtError(`Failed to unwatchOrderBook: ${error}`);
@@ -1433,34 +1488,11 @@ export class Exchange {
             }
             args.push(params);
         }
-        // Try WebSocket transport first
         const wsData = await this.watchViaWs("watchOrderBook", args);
         if (wsData !== null) {
             return convertOrderBook(wsData);
         }
-        // HTTP fallback
-        try {
-            const response = await this.fetchWithRetry(`${this.resolveBaseUrl()}/api/${this.exchangeName}/watchOrderBook`, {
-                method: 'POST',
-                headers: { 'Content-Type': 'application/json', ...this.getAuthHeaders() },
-                body: JSON.stringify({ args, credentials: this.getCredentials() }),
-            });
-            if (!response.ok) {
-                const body = await response.json().catch(() => ({}));
-                if (body.error && typeof body.error === "object") {
-                    throw fromServerError(body.error);
-                }
-                throw new PmxtError(body.error?.message || response.statusText);
-            }
-            const json = await response.json();
-            const data = this.handleResponse(json);
-            return convertOrderBook(data);
-        }
-        catch (error) {
-            if (error instanceof PmxtError)
-                throw error;
-            throw new PmxtError(`Failed to watch order book: ${error}`);
-        }
+        throw this.wsTransportUnavailableError("watchOrderBook");
     }
     /**
      * Watch real-time order book updates for multiple outcomes at once.
@@ -1469,9 +1501,6 @@ export class Exchange {
      * order book snapshot. Call repeatedly in a loop to stream updates
      * (CCXT Pro pattern).
      *
-     * Prefers the sidecar WebSocket transport when available, falling
-     * back to HTTP POST for older sidecars.
-     *
      * @param outcomeIds - Array of outcome IDs (or MarketOutcome objects)
      * @param limit - Optional depth limit for each order book
      * @param params - Optional exchange-specific parameters
@@ -1501,54 +1530,27 @@ export class Exchange {
             }
             args.push(params);
         }
-        // Try WebSocket transport first
-        const ws = await this.getOrCreateWs();
-        if (ws) {
-            try {
-                const rawResult = await ws.subscribeBatch(this.exchangeName, "watchOrderBooks", args, this.getCredentials());
-                if (rawResult && typeof rawResult === "object") {
-                    const result = {};
-                    for (const [k, v] of Object.entries(rawResult)) {
-                        if (v && typeof v === "object") {
-                            result[k] = convertOrderBook(v);
-                        }
-                    }
-                    return result;
-                }
-            }
-            catch (error) {
-                // Only fall through to HTTP for transport-level WS failures
-                if (!(error instanceof PmxtError) || !/connection failed|no websocket/i.test(error.message)) {
-                    throw error;
-                }
-            }
-        }
-        // HTTP fallback
         try {
-            const response = await this.fetchWithRetry(`${this.resolveBaseUrl()}/api/${this.exchangeName}/watchOrderBooks`, {
-                method: 'POST',
-                headers: { 'Content-Type': 'application/json', ...this.getAuthHeaders() },
-                body: JSON.stringify({ args, credentials: this.getCredentials() }),
-            });
-            if (!response.ok) {
-                const body = await response.json().catch(() => ({}));
-                if (body.error && typeof body.error === "object") {
-                    throw fromServerError(body.error);
-                }
-                throw new PmxtError(body.error?.message || response.statusText);
+            const ws = await this.getOrCreateWs();
+            if (!ws) {
+                throw this.wsTransportUnavailableError("watchOrderBooks");
             }
-            const json = await response.json();
-            const data = this.handleResponse(json);
-            if (data && typeof data === "object") {
+            const rawResult = await ws.subscribeBatch(this.exchangeName, "watchOrderBooks", args, this.getCredentials());
+            if (rawResult && typeof rawResult === "object") {
                 const result = {};
-                for (const [k, v] of Object.entries(data)) {
-                    result[k] = convertOrderBook(v);
+                for (const [k, v] of Object.entries(rawResult)) {
+                    if (v && typeof v === "object") {
+                        result[k] = convertOrderBook(v);
+                    }
                 }
                 return result;
             }
             throw new PmxtError("watchOrderBooks: unexpected response shape from server");
         }
         catch (error) {
+            if (this.isWsTransportUnavailableError(error)) {
+                throw this.wsTransportUnavailableError("watchOrderBooks");
+            }
             if (error instanceof PmxtError)
                 throw error;
             throw new PmxtError(`Failed to watch order books: ${error}`);
@@ -1587,7 +1589,7 @@ export class Exchange {
                 orderbook: convertOrderBook(wsData),
             };
         }
-        throw new PmxtError("watchAllOrderBooks() requires WebSocket transport — connection failed");
+        throw this.wsTransportUnavailableError("watchAllOrderBooks");
     }
     /** @deprecated Use {@link watchAllOrderBooks} instead. */
     async firehose(venues) {
@@ -1619,38 +1621,21 @@ export class Exchange {
     async watchTrades(outcomeId, address, since, limit) {
         await this.initPromise;
         const resolvedOutcomeId = resolveOutcomeId(outcomeId);
-        try {
-            const args = [resolvedOutcomeId];
-            if (address !== undefined) {
-                args.push(address);
-            }
-            if (since !== undefined) {
-                args.push(since);
-            }
-            if (limit !== undefined) {
-                args.push(limit);
-            }
-            const response = await this.fetchWithRetry(`${this.resolveBaseUrl()}/api/${this.exchangeName}/watchTrades`, {
-                method: 'POST',
-                headers: { 'Content-Type': 'application/json', ...this.getAuthHeaders() },
-                body: JSON.stringify({ args, credentials: this.getCredentials() }),
-            });
-            if (!response.ok) {
-                const body = await response.json().catch(() => ({}));
-                if (body.error && typeof body.error === "object") {
-                    throw fromServerError(body.error);
-                }
-                throw new PmxtError(body.error?.message || response.statusText);
-            }
-            const json = await response.json();
-            const data = this.handleResponse(json);
-            return data.map(convertTrade);
+        const args = [resolvedOutcomeId];
+        if (address !== undefined) {
+            args.push(address);
         }
-        catch (error) {
-            if (error instanceof PmxtError)
-                throw error;
-            throw new PmxtError(`Failed to watch trades: ${error}`);
+        if (since !== undefined) {
+            args.push(since);
+        }
+        if (limit !== undefined) {
+            args.push(limit);
+        }
+        const wsData = await this.watchViaWs("watchTrades", args);
+        if (wsData !== null) {
+            return wsData.map(convertTrade);
         }
+        throw this.wsTransportUnavailableError("watchTrades");
     }
     /**
      * Watch real-time updates of a public wallet via WebSocket.
@@ -2516,6 +2501,20 @@ export class Hyperliquid extends Exchange {
         super("hyperliquid", options);
     }
 }
+/**
+ * SuiBets exchange client.
+ *
+ * @example
+ * ```typescript
+ * const suibets = new SuiBets();
+ * const markets = await suibets.fetchMarkets();
+ * ```
+ */
+export class SuiBets extends Exchange {
+    constructor(options = {}) {
+        super("suibets", options);
+    }
+}
 /**
  * Mock exchange client.
  *

package/dist/esm/pmxt/router.js

@@ -159,11 +159,11 @@ export class Router extends Exchange {
         const params = 'title' in marketOrParams ? { market: marketOrParams } : marketOrParams;
         await this.initPromise;
         const query = {};
-        const marketId = params.marketId ?? params.market?.marketId;
+        const marketId = params.marketId ?? (!params.market?.slug ? params.market?.marketId : undefined);
         if (marketId)
             query.marketId = marketId;
-        if (params.slug)
-            query.slug = params.slug;
+        if (params.slug ?? params.market?.slug)
+            query.slug = params.slug ?? params.market?.slug;
         if (params.url)
             query.url = params.url;
         if (params.relation)
@@ -179,6 +179,9 @@ export class Router extends Exchange {
             const data = this.handleResponse(json);
             if (!data)
                 return [];
+            if (!Array.isArray(data)) {
+                throw new Error('fetchMarketMatches returned an unexpected response shape: expected an array');
+            }
             return data.map(parseMatchResult);
         }
         catch (error) {
@@ -195,11 +198,11 @@ export class Router extends Exchange {
         const params = 'title' in eventOrParams && 'markets' in eventOrParams ? { event: eventOrParams } : eventOrParams;
         await this.initPromise;
         const query = {};
-        const eventId = params.eventId ?? params.event?.id;
+        const eventId = params.eventId ?? (!params.event?.slug ? params.event?.id : undefined);
         if (eventId)
             query.eventId = eventId;
-        if (params.slug)
-            query.slug = params.slug;
+        if (params.slug ?? params.event?.slug)
+            query.slug = params.slug ?? params.event?.slug;
         if (params.relation)
             query.relation = params.relation;
         if (params.minConfidence !== undefined)
@@ -213,6 +216,9 @@ export class Router extends Exchange {
             const data = this.handleResponse(json);
             if (!data)
                 return [];
+            if (!Array.isArray(data)) {
+                throw new Error('fetchEventMatches returned an unexpected response shape: expected an array');
+            }
             return data.map((entry) => {
                 const event = convertEvent(entry.event || {});
                 return {

package/dist/index.d.ts

@@ -22,9 +22,10 @@ import { Router } from "./pmxt/router.js";
 import { ServerManager } from "./pmxt/server-manager.js";
 import * as models from "./pmxt/models.js";
 import * as errors from "./pmxt/errors.js";
-export { Exchange, Polymarket, Kalshi, KalshiDemo, Limitless, Myriad, Probable, Baozi, Opinion, Metaculus, Smarkets, PolymarketUS, GeminiTitan, Hyperliquid, Mock, PolymarketOptions } from "./pmxt/client.js";
+export { Exchange, Polymarket, Kalshi, KalshiDemo, Limitless, Myriad, Probable, Baozi, Opinion, Metaculus, Smarkets, PolymarketUS, GeminiTitan, Hyperliquid, SuiBets, Mock, PolymarketOptions } from "./pmxt/client.js";
 export { Router } from "./pmxt/router.js";
 export { ServerManager } from "./pmxt/server-manager.js";
+export { HOSTED_URL, LOCAL_URL, ENV, resolvePmxtBaseUrl } from "./pmxt/constants.js";
 export { MarketList } from "./pmxt/models.js";
 export type * from "./pmxt/models.js";
 export * from "./pmxt/errors.js";

package/dist/index.js

@@ -55,7 +55,7 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.server = exports.MarketList = exports.ServerManager = exports.Router = exports.Mock = exports.Hyperliquid = exports.GeminiTitan = exports.PolymarketUS = exports.Smarkets = exports.Metaculus = exports.Opinion = exports.Baozi = exports.Probable = exports.Myriad = exports.Limitless = exports.KalshiDemo = exports.Kalshi = exports.Polymarket = exports.Exchange = void 0;
+exports.server = exports.MarketList = exports.resolvePmxtBaseUrl = exports.ENV = exports.LOCAL_URL = exports.HOSTED_URL = exports.ServerManager = exports.Router = exports.Mock = exports.SuiBets = exports.Hyperliquid = exports.GeminiTitan = exports.PolymarketUS = exports.Smarkets = exports.Metaculus = exports.Opinion = exports.Baozi = exports.Probable = exports.Myriad = exports.Limitless = exports.KalshiDemo = exports.Kalshi = exports.Polymarket = exports.Exchange = void 0;
 const client_js_1 = require("./pmxt/client.js");
 const router_js_1 = require("./pmxt/router.js");
 const server_manager_js_1 = require("./pmxt/server-manager.js");
@@ -76,11 +76,17 @@ Object.defineProperty(exports, "Smarkets", { enumerable: true, get: function ()
 Object.defineProperty(exports, "PolymarketUS", { enumerable: true, get: function () { return client_js_2.PolymarketUS; } });
 Object.defineProperty(exports, "GeminiTitan", { enumerable: true, get: function () { return client_js_2.GeminiTitan; } });
 Object.defineProperty(exports, "Hyperliquid", { enumerable: true, get: function () { return client_js_2.Hyperliquid; } });
+Object.defineProperty(exports, "SuiBets", { enumerable: true, get: function () { return client_js_2.SuiBets; } });
 Object.defineProperty(exports, "Mock", { enumerable: true, get: function () { return client_js_2.Mock; } });
 var router_js_2 = require("./pmxt/router.js");
 Object.defineProperty(exports, "Router", { enumerable: true, get: function () { return router_js_2.Router; } });
 var server_manager_js_2 = require("./pmxt/server-manager.js");
 Object.defineProperty(exports, "ServerManager", { enumerable: true, get: function () { return server_manager_js_2.ServerManager; } });
+var constants_js_1 = require("./pmxt/constants.js");
+Object.defineProperty(exports, "HOSTED_URL", { enumerable: true, get: function () { return constants_js_1.HOSTED_URL; } });
+Object.defineProperty(exports, "LOCAL_URL", { enumerable: true, get: function () { return constants_js_1.LOCAL_URL; } });
+Object.defineProperty(exports, "ENV", { enumerable: true, get: function () { return constants_js_1.ENV; } });
+Object.defineProperty(exports, "resolvePmxtBaseUrl", { enumerable: true, get: function () { return constants_js_1.resolvePmxtBaseUrl; } });
 var models_js_1 = require("./pmxt/models.js");
 Object.defineProperty(exports, "MarketList", { enumerable: true, get: function () { return models_js_1.MarketList; } });
 __exportStar(require("./pmxt/errors.js"), exports);

package/dist/pmxt/client.d.ts

@@ -106,7 +106,7 @@ export declare abstract class Exchange {
      * Return the shared WebSocket client, creating it on first use.
      *
      * Returns `null` if the sidecar /ws endpoint was previously found
-     * to be unavailable, letting callers fall back to HTTP.
+     * to be unavailable.
      */
     private getOrCreateWs;
     /**
@@ -114,6 +114,13 @@ export declare abstract class Exchange {
      * Returns the raw data on success, or `null` if WS is unavailable.
      */
     private watchViaWs;
+    private wsTransportUnavailableError;
+    private isWsTransportUnavailableError;
+    private getWsInternals;
+    private wsSubscriptionKey;
+    private getWsSubscriptionId;
+    private clearWsSubscription;
+    private sendWsMessage;
     /**
      * Call an exchange-specific REST endpoint by its operationId.
      * This provides direct access to all implicit API methods defined in
@@ -251,9 +258,6 @@ export declare abstract class Exchange {
      * order book snapshot. Call repeatedly in a loop to stream updates
      * (CCXT Pro pattern).
      *
-     * Prefers the sidecar WebSocket transport when available, falling
-     * back to HTTP POST for older sidecars.
-     *
      * @param outcomeIds - Array of outcome IDs (or MarketOutcome objects)
      * @param limit - Optional depth limit for each order book
      * @param params - Optional exchange-specific parameters
@@ -713,6 +717,18 @@ export declare class GeminiTitan extends Exchange {
 export declare class Hyperliquid extends Exchange {
     constructor(options?: ExchangeOptions);
 }
+/**
+ * SuiBets exchange client.
+ *
+ * @example
+ * ```typescript
+ * const suibets = new SuiBets();
+ * const markets = await suibets.fetchMarkets();
+ * ```
+ */
+export declare class SuiBets extends Exchange {
+    constructor(options?: ExchangeOptions);
+}
 /**
  * Mock exchange client.
  *