pmxtjs 2.49.1 → 2.49.4

package/README.md

@@ -2,7 +2,7 @@
 
 A unified TypeScript/Node.js SDK for prediction markets — The ccxt for prediction markets.
 
-> **Note**: Use with a PMXT API key (hosted, recommended) or self-host the sidecar locally. Get a key at [pmxt.dev/dashboard](https://pmxt.dev/dashboard).
+> **Note**: Use with a PMXT API key (hosted, recommended) or run a local PMXT service. Get a key at [pmxt.dev/dashboard](https://pmxt.dev/dashboard).
 
 ## Installation
 
@@ -53,7 +53,7 @@ When you pass `pmxtApiKey`, the SDK talks to PMXT's hosted services: catalog req
 
 ### How it works (self-hosted)
 
-Omit `pmxtApiKey` to use the local sidecar. Install `pmxt-core` from npm and supply venue credentials directly. See [Self-hosted trading (advanced)](#self-hosted-trading-advanced) below.
+Omit `pmxtApiKey` to use the local PMXT service. Install `pmxt-core` from npm and supply venue credentials directly. See [Self-hosted trading (advanced)](#self-hosted-trading-advanced) below.
 
 ## Core Methods
 
@@ -139,7 +139,7 @@ See the full [hosted trading guide](https://pmxt.dev/docs/concepts/hosted-tradin
 
 ### Self-hosted trading (advanced)
 
-When self-hosting, supply venue credentials directly — no `pmxtApiKey`. The SDK spawns a local sidecar process.
+When self-hosting, supply venue credentials directly — no `pmxtApiKey`. The SDK spawns a local PMXT service.
 
 **Polymarket:**
 ```typescript

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

@@ -72,6 +72,9 @@ export interface ExchangeOptions {
  */
 export declare abstract class Exchange {
     private static readonly OBDATA_WATCH_ALL_SOURCES;
+    private static readonly _UUID_RE;
+    /** True iff `value` parses as a canonical catalog UUID string. */
+    protected static _isCatalogUuid(value: string): boolean;
     exchangeName: string;
     pmxtApiKey?: string;
     protected apiKey?: string;

package/dist/esm/pmxt/client.js

@@ -148,6 +148,14 @@ export class Exchange {
         "kalshi",
         "opinion",
     ]);
+    // Match a canonical 8-4-4-4-12 UUID string. The hosted catalog emits
+    // UUIDs in this exact shape, so a regex is both faster and stricter
+    // than `crypto.randomUUID()`-style parsing.
+    static _UUID_RE = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
+    /** True iff `value` parses as a canonical catalog UUID string. */
+    static _isCatalogUuid(value) {
+        return Exchange._UUID_RE.test(value);
+    }
     // Public so structural interfaces like `HostedClientLike`
     // (./hosted-routing) can read the venue name and hosted credentials
     // without violating protected-access on this base class.
@@ -2202,12 +2210,17 @@ export class Exchange {
                 throw new InvalidOrder("cannot specify both 'outcome' and 'marketId'/'outcomeId'");
             }
             const outcome = params.outcome;
-            if (!outcome.marketId) {
-                throw new InvalidOrder("outcome.marketId is not set; ensure the outcome comes from a fetched market");
+            if (!outcome.outcomeId) {
+                throw new InvalidOrder("outcome.outcomeId is not set; ensure the outcome comes from a fetched market");
             }
-            marketId = outcome.marketId;
+            // marketId is optional in hosted mode -- backend derives it from
+            // outcomeId (catalog UUID). Forward it when present for backcompat.
+            marketId = outcome.marketId || undefined;
             outcomeId = outcome.outcomeId;
         }
+        if (!outcomeId) {
+            throw new InvalidOrder("outcomeId is required (or pass an 'outcome' from a fetched market)");
+        }
         const side = String(params.side);
         const orderType = String(params.type ?? "market");
         const denom = params["denom"];
@@ -2244,15 +2257,37 @@ export class Exchange {
         }
         // to6dec throws InvalidOrder for sub-micro precision.
         const amount6dec = to6dec(params.amount).toString();
+        // The supplied outcomeId may be a catalog UUID OR a venue-native id
+        // (e.g. a Polymarket tokenId or an Opinion market hash). Catalog
+        // UUIDs are forwarded as `outcome_id`; venue-native ids are
+        // forwarded as `(venue, venue_outcome_id)` so the backend resolver
+        // picks the right path. Either shape is accepted by the v0 trading
+        // API.
         const body = {
-            market_id: marketId,
-            outcome_id: outcomeId,
             side,
             order_type: orderType,
             denom: resolvedDenom,
             amount: params.amount,
             amount_6dec: amount6dec,
         };
+        if (Exchange._isCatalogUuid(outcomeId)) {
+            body["outcome_id"] = outcomeId;
+            // market_id is optional in hosted mode: backend derives it
+            // from outcome_id (UUID) when omitted. Forward only when the
+            // caller supplied a non-empty UUID -- "absent" and "null" are
+            // not equivalent under some Pydantic configs on the backend.
+            if (marketId && Exchange._isCatalogUuid(marketId)) {
+                body["market_id"] = marketId;
+            }
+        }
+        else {
+            // Venue-native form: backend resolves the row from
+            // (source_exchange, pmxt_id). marketId from a venue client is
+            // itself venue-native and would fail backend UUID validation
+            // if forwarded -- suppress it.
+            body["venue"] = this.exchangeName;
+            body["venue_outcome_id"] = outcomeId;
+        }
         if (params.price !== undefined)
             body["price"] = params.price;
         const extra = params;

package/dist/pmxt/client.d.ts

@@ -72,6 +72,9 @@ export interface ExchangeOptions {
  */
 export declare abstract class Exchange {
     private static readonly OBDATA_WATCH_ALL_SOURCES;
+    private static readonly _UUID_RE;
+    /** True iff `value` parses as a canonical catalog UUID string. */
+    protected static _isCatalogUuid(value: string): boolean;
     exchangeName: string;
     pmxtApiKey?: string;
     protected apiKey?: string;

package/dist/pmxt/client.js

@@ -151,6 +151,14 @@ class Exchange {
         "kalshi",
         "opinion",
     ]);
+    // Match a canonical 8-4-4-4-12 UUID string. The hosted catalog emits
+    // UUIDs in this exact shape, so a regex is both faster and stricter
+    // than `crypto.randomUUID()`-style parsing.
+    static _UUID_RE = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
+    /** True iff `value` parses as a canonical catalog UUID string. */
+    static _isCatalogUuid(value) {
+        return Exchange._UUID_RE.test(value);
+    }
     // Public so structural interfaces like `HostedClientLike`
     // (./hosted-routing) can read the venue name and hosted credentials
     // without violating protected-access on this base class.
@@ -2205,12 +2213,17 @@ class Exchange {
                 throw new errors_js_1.InvalidOrder("cannot specify both 'outcome' and 'marketId'/'outcomeId'");
             }
             const outcome = params.outcome;
-            if (!outcome.marketId) {
-                throw new errors_js_1.InvalidOrder("outcome.marketId is not set; ensure the outcome comes from a fetched market");
+            if (!outcome.outcomeId) {
+                throw new errors_js_1.InvalidOrder("outcome.outcomeId is not set; ensure the outcome comes from a fetched market");
             }
-            marketId = outcome.marketId;
+            // marketId is optional in hosted mode -- backend derives it from
+            // outcomeId (catalog UUID). Forward it when present for backcompat.
+            marketId = outcome.marketId || undefined;
             outcomeId = outcome.outcomeId;
         }
+        if (!outcomeId) {
+            throw new errors_js_1.InvalidOrder("outcomeId is required (or pass an 'outcome' from a fetched market)");
+        }
         const side = String(params.side);
         const orderType = String(params.type ?? "market");
         const denom = params["denom"];
@@ -2247,15 +2260,37 @@ class Exchange {
         }
         // to6dec throws InvalidOrder for sub-micro precision.
         const amount6dec = (0, hosted_mappers_js_1.to6dec)(params.amount).toString();
+        // The supplied outcomeId may be a catalog UUID OR a venue-native id
+        // (e.g. a Polymarket tokenId or an Opinion market hash). Catalog
+        // UUIDs are forwarded as `outcome_id`; venue-native ids are
+        // forwarded as `(venue, venue_outcome_id)` so the backend resolver
+        // picks the right path. Either shape is accepted by the v0 trading
+        // API.
         const body = {
-            market_id: marketId,
-            outcome_id: outcomeId,
             side,
             order_type: orderType,
             denom: resolvedDenom,
             amount: params.amount,
             amount_6dec: amount6dec,
         };
+        if (Exchange._isCatalogUuid(outcomeId)) {
+            body["outcome_id"] = outcomeId;
+            // market_id is optional in hosted mode: backend derives it
+            // from outcome_id (UUID) when omitted. Forward only when the
+            // caller supplied a non-empty UUID -- "absent" and "null" are
+            // not equivalent under some Pydantic configs on the backend.
+            if (marketId && Exchange._isCatalogUuid(marketId)) {
+                body["market_id"] = marketId;
+            }
+        }
+        else {
+            // Venue-native form: backend resolves the row from
+            // (source_exchange, pmxt_id). marketId from a venue client is
+            // itself venue-native and would fail backend UUID validation
+            // if forwarded -- suppress it.
+            body["venue"] = this.exchangeName;
+            body["venue_outcome_id"] = outcomeId;
+        }
         if (params.price !== undefined)
             body["price"] = params.price;
         const extra = params;

package/generated/package.json

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

package/package.json

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

package/pmxt/client.ts

@@ -300,6 +300,17 @@ export abstract class Exchange {
         "opinion",
     ]);
 
+    // Match a canonical 8-4-4-4-12 UUID string. The hosted catalog emits
+    // UUIDs in this exact shape, so a regex is both faster and stricter
+    // than `crypto.randomUUID()`-style parsing.
+    private static readonly _UUID_RE =
+        /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
+
+    /** True iff `value` parses as a canonical catalog UUID string. */
+    protected static _isCatalogUuid(value: string): boolean {
+        return Exchange._UUID_RE.test(value);
+    }
+
     // Public so structural interfaces like `HostedClientLike`
     // (./hosted-routing) can read the venue name and hosted credentials
     // without violating protected-access on this base class.
@@ -2434,8 +2445,8 @@ export abstract class Exchange {
     private _hostedBuildOrderBody(
         params: CreateOrderParams & { outcome?: MarketOutcome },
     ): Record<string, unknown> {
-        let marketId = params.marketId;
-        let outcomeId = params.outcomeId;
+        let marketId: string | undefined = params.marketId;
+        let outcomeId: string | undefined = params.outcomeId;
 
         if (params.outcome) {
             if (marketId !== undefined || outcomeId !== undefined) {
@@ -2444,15 +2455,23 @@ export abstract class Exchange {
                 );
             }
             const outcome: MarketOutcome = params.outcome;
-            if (!outcome.marketId) {
+            if (!outcome.outcomeId) {
                 throw new InvalidOrder(
-                    "outcome.marketId is not set; ensure the outcome comes from a fetched market",
+                    "outcome.outcomeId is not set; ensure the outcome comes from a fetched market",
                 );
             }
-            marketId = outcome.marketId;
+            // marketId is optional in hosted mode -- backend derives it from
+            // outcomeId (catalog UUID). Forward it when present for backcompat.
+            marketId = outcome.marketId || undefined;
             outcomeId = outcome.outcomeId;
         }
 
+        if (!outcomeId) {
+            throw new InvalidOrder(
+                "outcomeId is required (or pass an 'outcome' from a fetched market)",
+            );
+        }
+
         const side = String(params.side);
         const orderType = String(params.type ?? "market");
         const denom = (params as unknown as Record<string, unknown>)["denom"] as
@@ -2493,15 +2512,36 @@ export abstract class Exchange {
         // to6dec throws InvalidOrder for sub-micro precision.
         const amount6dec = to6dec(params.amount as number).toString();
 
+        // The supplied outcomeId may be a catalog UUID OR a venue-native id
+        // (e.g. a Polymarket tokenId or an Opinion market hash). Catalog
+        // UUIDs are forwarded as `outcome_id`; venue-native ids are
+        // forwarded as `(venue, venue_outcome_id)` so the backend resolver
+        // picks the right path. Either shape is accepted by the v0 trading
+        // API.
         const body: Record<string, unknown> = {
-            market_id: marketId,
-            outcome_id: outcomeId,
             side,
             order_type: orderType,
             denom: resolvedDenom,
             amount: params.amount,
             amount_6dec: amount6dec,
         };
+        if (Exchange._isCatalogUuid(outcomeId)) {
+            body["outcome_id"] = outcomeId;
+            // market_id is optional in hosted mode: backend derives it
+            // from outcome_id (UUID) when omitted. Forward only when the
+            // caller supplied a non-empty UUID -- "absent" and "null" are
+            // not equivalent under some Pydantic configs on the backend.
+            if (marketId && Exchange._isCatalogUuid(marketId)) {
+                body["market_id"] = marketId;
+            }
+        } else {
+            // Venue-native form: backend resolves the row from
+            // (source_exchange, pmxt_id). marketId from a venue client is
+            // itself venue-native and would fail backend UUID validation
+            // if forwarded -- suppress it.
+            body["venue"] = this.exchangeName;
+            body["venue_outcome_id"] = outcomeId;
+        }
 
         if (params.price !== undefined) body["price"] = params.price;
         const extra = params as unknown as Record<string, unknown>;