pmxtjs 2.20.2 → 2.21.0

package/dist/esm/index.d.ts

@@ -20,13 +20,30 @@
 import { Exchange, Polymarket, Kalshi, KalshiDemo, Limitless, Myriad, Probable, Baozi } from "./pmxt/client.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, PolymarketOptions } from "./pmxt/client.js";
 export { ServerManager } from "./pmxt/server-manager.js";
 export { MarketList } from "./pmxt/models.js";
 export type * from "./pmxt/models.js";
+export * from "./pmxt/errors.js";
 declare function stopServer(): Promise<void>;
 declare function restartServer(): Promise<void>;
 declare const pmxt: {
+    fromServerError(errorData: any): errors.PmxtError;
+    PmxtError: typeof errors.PmxtError;
+    BadRequest: typeof errors.BadRequest;
+    AuthenticationError: typeof errors.AuthenticationError;
+    PermissionDenied: typeof errors.PermissionDenied;
+    NotFoundError: typeof errors.NotFoundError;
+    OrderNotFound: typeof errors.OrderNotFound;
+    MarketNotFound: typeof errors.MarketNotFound;
+    EventNotFound: typeof errors.EventNotFound;
+    RateLimitExceeded: typeof errors.RateLimitExceeded;
+    InvalidOrder: typeof errors.InvalidOrder;
+    InsufficientFunds: typeof errors.InsufficientFunds;
+    ValidationError: typeof errors.ValidationError;
+    NetworkError: typeof errors.NetworkError;
+    ExchangeNotAvailable: typeof errors.ExchangeNotAvailable;
     MarketList: typeof models.MarketList;
     Exchange: typeof Exchange;
     Polymarket: typeof Polymarket;

package/dist/esm/index.js

@@ -20,9 +20,11 @@
 import { Exchange, Polymarket, Kalshi, KalshiDemo, Limitless, Myriad, Probable, Baozi } from "./pmxt/client.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 } from "./pmxt/client.js";
 export { ServerManager } from "./pmxt/server-manager.js";
 export { MarketList } from "./pmxt/models.js";
+export * from "./pmxt/errors.js";
 const defaultManager = new ServerManager();
 async function stopServer() {
     await defaultManager.stop();
@@ -42,6 +44,7 @@ const pmxt = {
     ServerManager,
     stopServer,
     restartServer,
-    ...models
+    ...models,
+    ...errors
 };
 export default pmxt;

package/dist/esm/pmxt/client.js

@@ -8,6 +8,7 @@ import { Configuration, DefaultApi, } from "../generated/src/index.js";
 import { MarketList, } from "./models.js";
 import { ServerManager } from "./server-manager.js";
 import { buildArgsWithOptionalOptions } from "./args.js";
+import { PmxtError, fromServerError } from "./errors.js";
 // Converter functions
 function convertMarket(raw) {
     const outcomes = (raw.outcomes || []).map((o) => ({
@@ -204,7 +205,7 @@ export class Exchange {
                 this.api = new DefaultApi(this.config);
             }
             catch (error) {
-                throw new Error(`Failed to start PMXT server: ${error}\n\n` +
+                throw new PmxtError(`Failed to start PMXT server: ${error}\n\n` +
                     `Please ensure 'pmxt-core' is installed: npm install -g pmxt-core\n` +
                     `Or start the server manually: pmxt-server`);
             }
@@ -213,7 +214,10 @@ export class Exchange {
     handleResponse(response) {
         if (!response.success) {
             const error = response.error || {};
-            throw new Error(error.message || "Unknown error");
+            if (error && typeof error === "object" && (error.code || error.message)) {
+                throw fromServerError(error);
+            }
+            throw new PmxtError(error.message || "Unknown error");
         }
         return response.data;
     }
@@ -269,14 +273,19 @@ export class Exchange {
                 body: JSON.stringify(requestBody)
             });
             if (!response.ok) {
-                const error = await response.json().catch(() => ({}));
-                throw new Error(error.error?.message || response.statusText);
+                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();
             return this.handleResponse(json);
         }
         catch (error) {
-            throw new Error(`Failed to call API '${operationId}': ${error}`);
+            if (error instanceof PmxtError)
+                throw error;
+            throw new PmxtError(`Failed to call API '${operationId}': ${error}`);
         }
     }
     // BEGIN GENERATED METHODS
@@ -291,8 +300,11 @@ export class Exchange {
                 body: JSON.stringify({ args, credentials: this.getCredentials() }),
             });
             if (!response.ok) {
-                const error = await response.json().catch(() => ({}));
-                throw new Error(error.error?.message || response.statusText);
+                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);
@@ -303,7 +315,9 @@ export class Exchange {
             return result;
         }
         catch (error) {
-            throw new Error(`Failed to loadMarkets: ${error}`);
+            if (error instanceof PmxtError)
+                throw error;
+            throw new PmxtError(`Failed to loadMarkets: ${error}`);
         }
     }
     async fetchMarkets(params) {
@@ -316,15 +330,20 @@ export class Exchange {
                 body: JSON.stringify({ args, credentials: this.getCredentials() }),
             });
             if (!response.ok) {
-                const error = await response.json().catch(() => ({}));
-                throw new Error(error.error?.message || response.statusText);
+                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(convertMarket);
         }
         catch (error) {
-            throw new Error(`Failed to fetchMarkets: ${error}`);
+            if (error instanceof PmxtError)
+                throw error;
+            throw new PmxtError(`Failed to fetchMarkets: ${error}`);
         }
     }
     async fetchMarketsPaginated(params) {
@@ -337,8 +356,11 @@ export class Exchange {
                 body: JSON.stringify({ args, credentials: this.getCredentials() }),
             });
             if (!response.ok) {
-                const error = await response.json().catch(() => ({}));
-                throw new Error(error.error?.message || response.statusText);
+                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);
@@ -349,7 +371,9 @@ export class Exchange {
             };
         }
         catch (error) {
-            throw new Error(`Failed to fetchMarketsPaginated: ${error}`);
+            if (error instanceof PmxtError)
+                throw error;
+            throw new PmxtError(`Failed to fetchMarketsPaginated: ${error}`);
         }
     }
     async fetchEvents(params) {
@@ -362,15 +386,20 @@ export class Exchange {
                 body: JSON.stringify({ args, credentials: this.getCredentials() }),
             });
             if (!response.ok) {
-                const error = await response.json().catch(() => ({}));
-                throw new Error(error.error?.message || response.statusText);
+                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(convertEvent);
         }
         catch (error) {
-            throw new Error(`Failed to fetchEvents: ${error}`);
+            if (error instanceof PmxtError)
+                throw error;
+            throw new PmxtError(`Failed to fetchEvents: ${error}`);
         }
     }
     async fetchMarket(params) {
@@ -383,15 +412,20 @@ export class Exchange {
                 body: JSON.stringify({ args, credentials: this.getCredentials() }),
             });
             if (!response.ok) {
-                const error = await response.json().catch(() => ({}));
-                throw new Error(error.error?.message || response.statusText);
+                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 convertMarket(data);
         }
         catch (error) {
-            throw new Error(`Failed to fetchMarket: ${error}`);
+            if (error instanceof PmxtError)
+                throw error;
+            throw new PmxtError(`Failed to fetchMarket: ${error}`);
         }
     }
     async fetchEvent(params) {
@@ -404,15 +438,20 @@ export class Exchange {
                 body: JSON.stringify({ args, credentials: this.getCredentials() }),
             });
             if (!response.ok) {
-                const error = await response.json().catch(() => ({}));
-                throw new Error(error.error?.message || response.statusText);
+                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 convertEvent(data);
         }
         catch (error) {
-            throw new Error(`Failed to fetchEvent: ${error}`);
+            if (error instanceof PmxtError)
+                throw error;
+            throw new PmxtError(`Failed to fetchEvent: ${error}`);
         }
     }
     async fetchOrderBook(id) {
@@ -426,15 +465,20 @@ export class Exchange {
                 body: JSON.stringify({ args, credentials: this.getCredentials() }),
             });
             if (!response.ok) {
-                const error = await response.json().catch(() => ({}));
-                throw new Error(error.error?.message || response.statusText);
+                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) {
-            throw new Error(`Failed to fetchOrderBook: ${error}`);
+            if (error instanceof PmxtError)
+                throw error;
+            throw new PmxtError(`Failed to fetchOrderBook: ${error}`);
         }
     }
     async cancelOrder(orderId) {
@@ -448,15 +492,20 @@ export class Exchange {
                 body: JSON.stringify({ args, credentials: this.getCredentials() }),
             });
             if (!response.ok) {
-                const error = await response.json().catch(() => ({}));
-                throw new Error(error.error?.message || response.statusText);
+                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 convertOrder(data);
         }
         catch (error) {
-            throw new Error(`Failed to cancelOrder: ${error}`);
+            if (error instanceof PmxtError)
+                throw error;
+            throw new PmxtError(`Failed to cancelOrder: ${error}`);
         }
     }
     async fetchOrder(orderId) {
@@ -470,15 +519,20 @@ export class Exchange {
                 body: JSON.stringify({ args, credentials: this.getCredentials() }),
             });
             if (!response.ok) {
-                const error = await response.json().catch(() => ({}));
-                throw new Error(error.error?.message || response.statusText);
+                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 convertOrder(data);
         }
         catch (error) {
-            throw new Error(`Failed to fetchOrder: ${error}`);
+            if (error instanceof PmxtError)
+                throw error;
+            throw new PmxtError(`Failed to fetchOrder: ${error}`);
         }
     }
     async fetchOpenOrders(marketId) {
@@ -491,15 +545,20 @@ export class Exchange {
                 body: JSON.stringify({ args, credentials: this.getCredentials() }),
             });
             if (!response.ok) {
-                const error = await response.json().catch(() => ({}));
-                throw new Error(error.error?.message || response.statusText);
+                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(convertOrder);
         }
         catch (error) {
-            throw new Error(`Failed to fetchOpenOrders: ${error}`);
+            if (error instanceof PmxtError)
+                throw error;
+            throw new PmxtError(`Failed to fetchOpenOrders: ${error}`);
         }
     }
     async fetchMyTrades(params) {
@@ -512,15 +571,20 @@ export class Exchange {
                 body: JSON.stringify({ args, credentials: this.getCredentials() }),
             });
             if (!response.ok) {
-                const error = await response.json().catch(() => ({}));
-                throw new Error(error.error?.message || response.statusText);
+                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(convertUserTrade);
         }
         catch (error) {
-            throw new Error(`Failed to fetchMyTrades: ${error}`);
+            if (error instanceof PmxtError)
+                throw error;
+            throw new PmxtError(`Failed to fetchMyTrades: ${error}`);
         }
     }
     async fetchClosedOrders(params) {
@@ -533,15 +597,20 @@ export class Exchange {
                 body: JSON.stringify({ args, credentials: this.getCredentials() }),
             });
             if (!response.ok) {
-                const error = await response.json().catch(() => ({}));
-                throw new Error(error.error?.message || response.statusText);
+                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(convertOrder);
         }
         catch (error) {
-            throw new Error(`Failed to fetchClosedOrders: ${error}`);
+            if (error instanceof PmxtError)
+                throw error;
+            throw new PmxtError(`Failed to fetchClosedOrders: ${error}`);
         }
     }
     async fetchAllOrders(params) {
@@ -554,15 +623,20 @@ export class Exchange {
                 body: JSON.stringify({ args, credentials: this.getCredentials() }),
             });
             if (!response.ok) {
-                const error = await response.json().catch(() => ({}));
-                throw new Error(error.error?.message || response.statusText);
+                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(convertOrder);
         }
         catch (error) {
-            throw new Error(`Failed to fetchAllOrders: ${error}`);
+            if (error instanceof PmxtError)
+                throw error;
+            throw new PmxtError(`Failed to fetchAllOrders: ${error}`);
         }
     }
     async fetchPositions(address) {
@@ -575,15 +649,20 @@ export class Exchange {
                 body: JSON.stringify({ args, credentials: this.getCredentials() }),
             });
             if (!response.ok) {
-                const error = await response.json().catch(() => ({}));
-                throw new Error(error.error?.message || response.statusText);
+                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(convertPosition);
         }
         catch (error) {
-            throw new Error(`Failed to fetchPositions: ${error}`);
+            if (error instanceof PmxtError)
+                throw error;
+            throw new PmxtError(`Failed to fetchPositions: ${error}`);
         }
     }
     async fetchBalance(address) {
@@ -596,15 +675,20 @@ export class Exchange {
                 body: JSON.stringify({ args, credentials: this.getCredentials() }),
             });
             if (!response.ok) {
-                const error = await response.json().catch(() => ({}));
-                throw new Error(error.error?.message || response.statusText);
+                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(convertBalance);
         }
         catch (error) {
-            throw new Error(`Failed to fetchBalance: ${error}`);
+            if (error instanceof PmxtError)
+                throw error;
+            throw new PmxtError(`Failed to fetchBalance: ${error}`);
         }
     }
     async close() {
@@ -617,14 +701,19 @@ export class Exchange {
                 body: JSON.stringify({ args, credentials: this.getCredentials() }),
             });
             if (!response.ok) {
-                const error = await response.json().catch(() => ({}));
-                throw new Error(error.error?.message || response.statusText);
+                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);
         }
         catch (error) {
-            throw new Error(`Failed to close: ${error}`);
+            if (error instanceof PmxtError)
+                throw error;
+            throw new PmxtError(`Failed to close: ${error}`);
         }
     }
     // END GENERATED METHODS
@@ -670,7 +759,9 @@ export class Exchange {
             return data.map(convertCandle);
         }
         catch (error) {
-            throw new Error(`Failed to fetch OHLCV: ${error}`);
+            if (error instanceof PmxtError)
+                throw error;
+            throw new PmxtError(`Failed to fetch OHLCV: ${error}`);
         }
     }
     /**
@@ -701,7 +792,9 @@ export class Exchange {
             return data.map(convertTrade);
         }
         catch (error) {
-            throw new Error(`Failed to fetch trades: ${error}`);
+            if (error instanceof PmxtError)
+                throw error;
+            throw new PmxtError(`Failed to fetch trades: ${error}`);
         }
     }
     // WebSocket Streaming Methods
@@ -744,7 +837,9 @@ export class Exchange {
             return convertOrderBook(data);
         }
         catch (error) {
-            throw new Error(`Failed to watch order book: ${error}`);
+            if (error instanceof PmxtError)
+                throw error;
+            throw new PmxtError(`Failed to watch order book: ${error}`);
         }
     }
     /**
@@ -795,7 +890,9 @@ export class Exchange {
             return data.map(convertTrade);
         }
         catch (error) {
-            throw new Error(`Failed to watch trades: ${error}`);
+            if (error instanceof PmxtError)
+                throw error;
+            throw new PmxtError(`Failed to watch trades: ${error}`);
         }
     }
     /**
@@ -838,7 +935,9 @@ export class Exchange {
             return convertSubscriptionSnapshot(data);
         }
         catch (error) {
-            throw new Error(`Failed to watch address: ${error}`);
+            if (error instanceof PmxtError)
+                throw error;
+            throw new PmxtError(`Failed to watch address: ${error}`);
         }
     }
     /**
@@ -862,7 +961,9 @@ export class Exchange {
             return this.handleResponse(response);
         }
         catch (error) {
-            throw new Error(`Failed to unwatch address: ${error}`);
+            if (error instanceof PmxtError)
+                throw error;
+            throw new PmxtError(`Failed to unwatch address: ${error}`);
         }
     }
     // Trading Methods (require authentication)
@@ -909,11 +1010,11 @@ export class Exchange {
             let outcomeId = params.outcomeId;
             if (params.outcome) {
                 if (marketId !== undefined || outcomeId !== undefined) {
-                    throw new Error("Cannot specify both 'outcome' and 'marketId'/'outcomeId'. Use one or the other.");
+                    throw new PmxtError("Cannot specify both 'outcome' and 'marketId'/'outcomeId'. Use one or the other.");
                 }
                 const outcome = params.outcome;
                 if (!outcome.marketId) {
-                    throw new Error("outcome.marketId is not set. Ensure the outcome comes from a fetched market.");
+                    throw new PmxtError("outcome.marketId is not set. Ensure the outcome comes from a fetched market.");
                 }
                 marketId = outcome.marketId;
                 outcomeId = outcome.outcomeId;
@@ -943,7 +1044,9 @@ export class Exchange {
             return data;
         }
         catch (error) {
-            throw new Error(`Failed to build order: ${error}`);
+            if (error instanceof PmxtError)
+                throw error;
+            throw new PmxtError(`Failed to build order: ${error}`);
         }
     }
     /**
@@ -980,7 +1083,9 @@ export class Exchange {
             return convertOrder(data);
         }
         catch (error) {
-            throw new Error(`Failed to submit order: ${error}`);
+            if (error instanceof PmxtError)
+                throw error;
+            throw new PmxtError(`Failed to submit order: ${error}`);
         }
     }
     /**
@@ -1009,11 +1114,11 @@ export class Exchange {
             let outcomeId = params.outcomeId;
             if (params.outcome) {
                 if (marketId !== undefined || outcomeId !== undefined) {
-                    throw new Error("Cannot specify both 'outcome' and 'marketId'/'outcomeId'. Use one or the other.");
+                    throw new PmxtError("Cannot specify both 'outcome' and 'marketId'/'outcomeId'. Use one or the other.");
                 }
                 const outcome = params.outcome;
                 if (!outcome.marketId) {
-                    throw new Error("outcome.marketId is not set. Ensure the outcome comes from a fetched market.");
+                    throw new PmxtError("outcome.marketId is not set. Ensure the outcome comes from a fetched market.");
                 }
                 marketId = outcome.marketId;
                 outcomeId = outcome.outcomeId;
@@ -1043,7 +1148,9 @@ export class Exchange {
             return convertOrder(data);
         }
         catch (error) {
-            throw new Error(`Failed to create order: ${error}`);
+            if (error instanceof PmxtError)
+                throw error;
+            throw new PmxtError(`Failed to create order: ${error}`);
         }
     }
     /**
@@ -1088,14 +1195,19 @@ export class Exchange {
                 body: JSON.stringify(body)
             });
             if (!response.ok) {
-                const error = await response.json().catch(() => ({}));
-                throw new Error(error.error?.message || response.statusText);
+                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();
             return this.handleResponse(json);
         }
         catch (error) {
-            throw new Error(`Failed to get execution price: ${error}`);
+            if (error instanceof PmxtError)
+                throw error;
+            throw new PmxtError(`Failed to get execution price: ${error}`);
         }
     }
     // ----------------------------------------------------------------------------