pmxt-core 2.39.0 → 2.40.0

package/dist/router/Router.js

@@ -50,7 +50,10 @@ class Router extends BaseExchange_1.PredictionMarketExchange {
             offset: params?.offset,
             closed: params?.status === 'closed' || params?.status === 'inactive',
         });
-        return response ?? [];
+        if (!Array.isArray(response)) {
+            throw new Error(`fetchMarketsImpl: expected array from searchMarkets but received ${typeof response}`);
+        }
+        return response;
     }
     async fetchEventsImpl(params) {
         const response = await this.client.searchEvents({
@@ -59,7 +62,10 @@ class Router extends BaseExchange_1.PredictionMarketExchange {
             limit: params?.limit,
             offset: params?.offset,
         });
-        return response ?? [];
+        if (!Array.isArray(response)) {
+            throw new Error(`fetchEventsImpl: expected array from searchEvents but received ${typeof response}`);
+        }
+        return response;
     }
     // -----------------------------------------------------------------------
     // Unified orderbook (cross-exchange merge)
@@ -86,19 +92,33 @@ class Router extends BaseExchange_1.PredictionMarketExchange {
             const outcome = findOutcomeForSide(match.market, resolvedSide);
             if (!outcome)
                 continue;
-            fetchPromises.push(exchange.fetchOrderBook(outcome.outcomeId, resolvedSide).catch(() => null));
+            fetchPromises.push(exchange
+                .fetchOrderBook(outcome.outcomeId, resolvedSide)
+                .then((book) => ({ book, venue: venueName, error: null }))
+                .catch((error) => ({ book: null, venue: venueName, error })));
         }
         // Fetch the source market's orderbook (try remaining exchanges with the raw ID)
         for (const [name, exchange] of Object.entries(this.exchanges)) {
             if (matchedVenues.has(name))
                 continue;
-            fetchPromises.push(exchange.fetchOrderBook(outcomeId, resolvedSide).catch(() => null));
+            fetchPromises.push(exchange
+                .fetchOrderBook(outcomeId, resolvedSide)
+                .then((book) => ({ book, venue: name, error: null }))
+                .catch((error) => ({ book: null, venue: name, error })));
+        }
+        const results = await Promise.all(fetchPromises);
+        const books = results.filter((r) => r.book !== null);
+        const failures = results.filter((r) => r.book === null && r.error !== null);
+        if (books.length === 0 && failures.length > 0) {
+            const reasons = failures
+                .map((f) => `${f.venue}: ${f.error instanceof Error ? f.error.message : String(f.error)}`)
+                .join('; ');
+            throw new Error(`fetchOrderBook failed on all exchanges for outcomeId "${outcomeId}": ${reasons}`);
         }
-        const books = (await Promise.all(fetchPromises)).filter((b) => b !== null);
         if (books.length === 0) {
-            return { bids: [], asks: [], timestamp: Date.now() };
+            throw new Error(`fetchOrderBook: no exchange returned an orderbook for outcomeId "${outcomeId}"`);
         }
-        return mergeOrderBooks(books);
+        return mergeOrderBooks(books.map((r) => r.book));
     }
     // -----------------------------------------------------------------------
     // Cross-exchange market matches
@@ -259,9 +279,16 @@ class Router extends BaseExchange_1.PredictionMarketExchange {
         try {
             return await this.fetchArbitrageBulk(params);
         }
-        catch {
-            // Dedicated endpoint not available — fall back to N+1 approach.
-            return this.fetchArbitrageFallback(params);
+        catch (error) {
+            // Only fall back when the bulk endpoint is genuinely not available (404/501).
+            // All other errors (network failures, 5xx, parsing errors) propagate so
+            // callers are not silently given stale N+1 data.
+            const status = error?.status ?? error?.response?.status;
+            if (status === 404 || status === 501) {
+                console.warn('[pmxt] Router: bulk arbitrage endpoint unavailable, falling back to N+1 approach');
+                return this.fetchArbitrageFallback(params);
+            }
+            throw error;
         }
     }
     /**
@@ -280,17 +307,24 @@ class Router extends BaseExchange_1.PredictionMarketExchange {
         const res = await this.client.getArbitrage(query);
         // getArbitrage already unwraps .data — res is the opportunities array.
         const items = Array.isArray(res) ? res : (res?.data ?? []);
-        return items.map((r) => ({
-            marketA: r.marketA,
-            marketB: r.marketB,
-            spread: r.spread ?? 0,
-            buyVenue: r.buyVenue ?? '',
-            sellVenue: r.sellVenue ?? '',
-            buyPrice: r.buyPrice ?? 0,
-            sellPrice: r.sellPrice ?? 0,
-            relation: r.relation,
-            confidence: r.confidence,
-        }));
+        return items.map((r) => {
+            if (r.spread == null || r.buyPrice == null || r.sellPrice == null) {
+                throw new Error(`fetchArbitrageBulk: arbitrage record is missing required price fields ` +
+                    `(spread=${r.spread}, buyPrice=${r.buyPrice}, sellPrice=${r.sellPrice}) ` +
+                    `for markets ${r.marketA?.marketId ?? '?'} / ${r.marketB?.marketId ?? '?'}`);
+            }
+            return {
+                marketA: r.marketA,
+                marketB: r.marketB,
+                spread: r.spread,
+                buyVenue: r.buyVenue ?? '',
+                sellVenue: r.sellVenue ?? '',
+                buyPrice: r.buyPrice,
+                sellPrice: r.sellPrice,
+                relation: r.relation,
+                confidence: r.confidence,
+            };
+        });
     }
     /**
      * Legacy N+1 fallback: fetch markets, then fetch matches per-market.

package/dist/server/exchange-factory.js

@@ -13,6 +13,8 @@ const metaculus_1 = require("../exchanges/metaculus");
 const smarkets_1 = require("../exchanges/smarkets");
 const polymarket_us_1 = require("../exchanges/polymarket_us");
 const hyperliquid_1 = require("../exchanges/hyperliquid");
+const gemini_titan_1 = require("../exchanges/gemini-titan");
+const mock_1 = require("../exchanges/mock");
 const router_1 = require("../router");
 function createExchange(name, credentials, bearerToken) {
     switch (name) {
@@ -96,6 +98,13 @@ function createExchange(name, credentials, bearerToken) {
                 apiKey: credentials?.apiKey || process.env.HYPERLIQUID_WALLET_ADDRESS,
                 privateKey: credentials?.privateKey || process.env.HYPERLIQUID_PRIVATE_KEY,
             });
+        case "gemini-titan":
+            return new gemini_titan_1.GeminiTitanExchange({
+                apiKey: credentials?.apiKey || process.env.GEMINI_API_KEY,
+                apiSecret: credentials?.apiSecret || process.env.GEMINI_API_SECRET,
+            });
+        case "mock":
+            return new mock_1.MockExchange();
         case "router":
             return new router_1.Router({
                 apiKey: bearerToken,

package/dist/server/openapi.yaml

@@ -3684,6 +3684,28 @@ x-sdk-constructors:
         tsName: privateKey
         type: string
         description: Private key for authentication
+  gemini-titan:
+    className: GeminiTitan
+    params:
+      - name: pmxt_api_key
+        tsName: pmxtApiKey
+        type: string
+        description: PMXT API key for hosted access
+      - name: api_key
+        tsName: apiKey
+        type: string
+        description: API key for authentication
+      - name: api_secret
+        tsName: apiSecret
+        type: string
+        description: API secret for authentication
+  mock:
+    className: Mock
+    params:
+      - name: pmxt_api_key
+        tsName: pmxtApiKey
+        type: string
+        description: PMXT API key for hosted access
   router:
     className: Router
     params:

package/dist/server/ws-handler.js

@@ -196,7 +196,9 @@ function createWebSocketHandler(options = {}) {
             // Close all exchange instances
             for (const [, exchange] of state.exchanges) {
                 if (typeof exchange.close === "function") {
-                    exchange.close().catch(() => { });
+                    exchange.close().catch((err) => {
+                        console.warn('[ws-handler] exchange close() failed', { error: err instanceof Error ? err.message : String(err) });
+                    });
                 }
             }
             state.exchanges.clear();
@@ -254,8 +256,16 @@ function handleSubscribe(ws, state, msg, exchangeName) {
     state.subscriptions.set(key, { abortController });
     const streamFn = method === "watchOrderBooks" ? streamBatch : streamSingle;
     // Fire and forget -- the loop runs until aborted or WS closes
-    streamFn(exchange, method, args || [], id, ws, abortController.signal).catch(() => {
-        // Stream ended -- clean up
+    streamFn(exchange, method, args || [], id, ws, abortController.signal).catch((err) => {
+        // Unexpected stream rejection (programming error — exchange errors are
+        // caught and reported to the client inside streamSingle/streamBatch).
+        console.warn('[ws-handler] stream ended with unexpected error', {
+            exchange: exchangeName,
+            method,
+            id,
+            error: err instanceof Error ? err.message : String(err),
+        });
+        sendError(ws, id, err instanceof Error ? err.message : 'Streaming error');
         state.subscriptions.delete(key);
     });
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pmxt-core",
-  "version": "2.39.0",
+  "version": "2.40.0",
   "description": "pmxt is a unified prediction market data API. The ccxt for prediction markets.",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -29,8 +29,8 @@
     "test": "jest -c jest.config.js",
     "server": "tsx watch src/server/index.ts",
     "server:prod": "node dist/server/index.js",
-    "generate:sdk:python": "npx @openapitools/openapi-generator-cli generate -i src/server/openapi.yaml -g python -o ../sdks/python/generated --package-name pmxt_internal --additional-properties=projectName=pmxt-internal,packageVersion=2.39.0,library=urllib3",
-    "generate:sdk:typescript": "npx @openapitools/openapi-generator-cli generate -i src/server/openapi.yaml -g typescript-fetch -o ../sdks/typescript/generated --additional-properties=npmName=pmxtjs,npmVersion=2.39.0,supportsES6=true,typescriptThreePlus=true && node ../sdks/typescript/scripts/fix-generated.js",
+    "generate:sdk:python": "npx @openapitools/openapi-generator-cli generate -i src/server/openapi.yaml -g python -o ../sdks/python/generated --package-name pmxt_internal --additional-properties=projectName=pmxt-internal,packageVersion=2.40.0,library=urllib3",
+    "generate:sdk:typescript": "npx @openapitools/openapi-generator-cli generate -i src/server/openapi.yaml -g typescript-fetch -o ../sdks/typescript/generated --additional-properties=npmName=pmxtjs,npmVersion=2.40.0,supportsES6=true,typescriptThreePlus=true && node ../sdks/typescript/scripts/fix-generated.js",
     "fetch:openapi": "node scripts/fetch-openapi-specs.js",
     "extract:jsdoc": "node ../scripts/extract-jsdoc.js",
     "generate:docs": "npm run extract:jsdoc && node ../scripts/generate-api-docs.js",

package/dist/exchanges/baozi/price.test.d.ts

@@ -1 +0,0 @@
-export {};

package/dist/exchanges/baozi/price.test.js

@@ -1,33 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-const price_1 = require("./price");
-describe("clampBaoziPrice", () => {
-    test("clamps values below 0 to 0", () => {
-        expect((0, price_1.clampBaoziPrice)(-0.1)).toBe(0);
-    });
-    test("clamps values above 1 to 1", () => {
-        expect((0, price_1.clampBaoziPrice)(1.2)).toBe(1);
-    });
-    test("leaves values in range unchanged", () => {
-        expect((0, price_1.clampBaoziPrice)(0.3)).toBe(0.3);
-        expect((0, price_1.clampBaoziPrice)(0)).toBe(0);
-        expect((0, price_1.clampBaoziPrice)(1)).toBe(1);
-    });
-});
-describe("normalizeBaoziOutcomes", () => {
-    function makeOutcome(price) {
-        return { outcomeId: "x", marketId: "m", label: "X", price };
-    }
-    test("normalizes prices to sum to 1", () => {
-        const outcomes = [makeOutcome(2), makeOutcome(3)];
-        (0, price_1.normalizeBaoziOutcomes)(outcomes);
-        expect(outcomes[0].price).toBeCloseTo(0.4);
-        expect(outcomes[1].price).toBeCloseTo(0.6);
-    });
-    test("does nothing when sum is zero", () => {
-        const outcomes = [makeOutcome(0), makeOutcome(0)];
-        (0, price_1.normalizeBaoziOutcomes)(outcomes);
-        expect(outcomes[0].price).toBe(0);
-        expect(outcomes[1].price).toBe(0);
-    });
-});

package/dist/exchanges/kalshi/kalshi.test.d.ts

@@ -1 +0,0 @@
-export {};