pmxtjs 2.20.2 → 2.21.0

package/dist/pmxt/client.js

@@ -11,6 +11,7 @@ const index_js_1 = require("../generated/src/index.js");
 const models_js_1 = require("./models.js");
 const server_manager_js_1 = require("./server-manager.js");
 const args_js_1 = require("./args.js");
+const errors_js_1 = require("./errors.js");
 // Converter functions
 function convertMarket(raw) {
     const outcomes = (raw.outcomes || []).map((o) => ({
@@ -207,7 +208,7 @@ class Exchange {
                 this.api = new index_js_1.DefaultApi(this.config);
             }
             catch (error) {
-                throw new Error(`Failed to start PMXT server: ${error}\n\n` +
+                throw new errors_js_1.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`);
             }
@@ -216,7 +217,10 @@ 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 (0, errors_js_1.fromServerError)(error);
+            }
+            throw new errors_js_1.PmxtError(error.message || "Unknown error");
         }
         return response.data;
     }
@@ -272,14 +276,19 @@ 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 (0, errors_js_1.fromServerError)(body.error);
+                }
+                throw new errors_js_1.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 errors_js_1.PmxtError)
+                throw error;
+            throw new errors_js_1.PmxtError(`Failed to call API '${operationId}': ${error}`);
         }
     }
     // BEGIN GENERATED METHODS
@@ -294,8 +303,11 @@ 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 (0, errors_js_1.fromServerError)(body.error);
+                }
+                throw new errors_js_1.PmxtError(body.error?.message || response.statusText);
             }
             const json = await response.json();
             const data = this.handleResponse(json);
@@ -306,7 +318,9 @@ class Exchange {
             return result;
         }
         catch (error) {
-            throw new Error(`Failed to loadMarkets: ${error}`);
+            if (error instanceof errors_js_1.PmxtError)
+                throw error;
+            throw new errors_js_1.PmxtError(`Failed to loadMarkets: ${error}`);
         }
     }
     async fetchMarkets(params) {
@@ -319,15 +333,20 @@ 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 (0, errors_js_1.fromServerError)(body.error);
+                }
+                throw new errors_js_1.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 errors_js_1.PmxtError)
+                throw error;
+            throw new errors_js_1.PmxtError(`Failed to fetchMarkets: ${error}`);
         }
     }
     async fetchMarketsPaginated(params) {
@@ -340,8 +359,11 @@ 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 (0, errors_js_1.fromServerError)(body.error);
+                }
+                throw new errors_js_1.PmxtError(body.error?.message || response.statusText);
             }
             const json = await response.json();
             const data = this.handleResponse(json);
@@ -352,7 +374,9 @@ class Exchange {
             };
         }
         catch (error) {
-            throw new Error(`Failed to fetchMarketsPaginated: ${error}`);
+            if (error instanceof errors_js_1.PmxtError)
+                throw error;
+            throw new errors_js_1.PmxtError(`Failed to fetchMarketsPaginated: ${error}`);
         }
     }
     async fetchEvents(params) {
@@ -365,15 +389,20 @@ 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 (0, errors_js_1.fromServerError)(body.error);
+                }
+                throw new errors_js_1.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 errors_js_1.PmxtError)
+                throw error;
+            throw new errors_js_1.PmxtError(`Failed to fetchEvents: ${error}`);
         }
     }
     async fetchMarket(params) {
@@ -386,15 +415,20 @@ 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 (0, errors_js_1.fromServerError)(body.error);
+                }
+                throw new errors_js_1.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 errors_js_1.PmxtError)
+                throw error;
+            throw new errors_js_1.PmxtError(`Failed to fetchMarket: ${error}`);
         }
     }
     async fetchEvent(params) {
@@ -407,15 +441,20 @@ 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 (0, errors_js_1.fromServerError)(body.error);
+                }
+                throw new errors_js_1.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 errors_js_1.PmxtError)
+                throw error;
+            throw new errors_js_1.PmxtError(`Failed to fetchEvent: ${error}`);
         }
     }
     async fetchOrderBook(id) {
@@ -429,15 +468,20 @@ 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 (0, errors_js_1.fromServerError)(body.error);
+                }
+                throw new errors_js_1.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 errors_js_1.PmxtError)
+                throw error;
+            throw new errors_js_1.PmxtError(`Failed to fetchOrderBook: ${error}`);
         }
     }
     async cancelOrder(orderId) {
@@ -451,15 +495,20 @@ 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 (0, errors_js_1.fromServerError)(body.error);
+                }
+                throw new errors_js_1.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 errors_js_1.PmxtError)
+                throw error;
+            throw new errors_js_1.PmxtError(`Failed to cancelOrder: ${error}`);
         }
     }
     async fetchOrder(orderId) {
@@ -473,15 +522,20 @@ 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 (0, errors_js_1.fromServerError)(body.error);
+                }
+                throw new errors_js_1.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 errors_js_1.PmxtError)
+                throw error;
+            throw new errors_js_1.PmxtError(`Failed to fetchOrder: ${error}`);
         }
     }
     async fetchOpenOrders(marketId) {
@@ -494,15 +548,20 @@ 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 (0, errors_js_1.fromServerError)(body.error);
+                }
+                throw new errors_js_1.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 errors_js_1.PmxtError)
+                throw error;
+            throw new errors_js_1.PmxtError(`Failed to fetchOpenOrders: ${error}`);
         }
     }
     async fetchMyTrades(params) {
@@ -515,15 +574,20 @@ 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 (0, errors_js_1.fromServerError)(body.error);
+                }
+                throw new errors_js_1.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 errors_js_1.PmxtError)
+                throw error;
+            throw new errors_js_1.PmxtError(`Failed to fetchMyTrades: ${error}`);
         }
     }
     async fetchClosedOrders(params) {
@@ -536,15 +600,20 @@ 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 (0, errors_js_1.fromServerError)(body.error);
+                }
+                throw new errors_js_1.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 errors_js_1.PmxtError)
+                throw error;
+            throw new errors_js_1.PmxtError(`Failed to fetchClosedOrders: ${error}`);
         }
     }
     async fetchAllOrders(params) {
@@ -557,15 +626,20 @@ 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 (0, errors_js_1.fromServerError)(body.error);
+                }
+                throw new errors_js_1.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 errors_js_1.PmxtError)
+                throw error;
+            throw new errors_js_1.PmxtError(`Failed to fetchAllOrders: ${error}`);
         }
     }
     async fetchPositions(address) {
@@ -578,15 +652,20 @@ 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 (0, errors_js_1.fromServerError)(body.error);
+                }
+                throw new errors_js_1.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 errors_js_1.PmxtError)
+                throw error;
+            throw new errors_js_1.PmxtError(`Failed to fetchPositions: ${error}`);
         }
     }
     async fetchBalance(address) {
@@ -599,15 +678,20 @@ 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 (0, errors_js_1.fromServerError)(body.error);
+                }
+                throw new errors_js_1.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 errors_js_1.PmxtError)
+                throw error;
+            throw new errors_js_1.PmxtError(`Failed to fetchBalance: ${error}`);
         }
     }
     async close() {
@@ -620,14 +704,19 @@ 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 (0, errors_js_1.fromServerError)(body.error);
+                }
+                throw new errors_js_1.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 errors_js_1.PmxtError)
+                throw error;
+            throw new errors_js_1.PmxtError(`Failed to close: ${error}`);
         }
     }
     // END GENERATED METHODS
@@ -673,7 +762,9 @@ class Exchange {
             return data.map(convertCandle);
         }
         catch (error) {
-            throw new Error(`Failed to fetch OHLCV: ${error}`);
+            if (error instanceof errors_js_1.PmxtError)
+                throw error;
+            throw new errors_js_1.PmxtError(`Failed to fetch OHLCV: ${error}`);
         }
     }
     /**
@@ -704,7 +795,9 @@ class Exchange {
             return data.map(convertTrade);
         }
         catch (error) {
-            throw new Error(`Failed to fetch trades: ${error}`);
+            if (error instanceof errors_js_1.PmxtError)
+                throw error;
+            throw new errors_js_1.PmxtError(`Failed to fetch trades: ${error}`);
         }
     }
     // WebSocket Streaming Methods
@@ -747,7 +840,9 @@ class Exchange {
             return convertOrderBook(data);
         }
         catch (error) {
-            throw new Error(`Failed to watch order book: ${error}`);
+            if (error instanceof errors_js_1.PmxtError)
+                throw error;
+            throw new errors_js_1.PmxtError(`Failed to watch order book: ${error}`);
         }
     }
     /**
@@ -798,7 +893,9 @@ class Exchange {
             return data.map(convertTrade);
         }
         catch (error) {
-            throw new Error(`Failed to watch trades: ${error}`);
+            if (error instanceof errors_js_1.PmxtError)
+                throw error;
+            throw new errors_js_1.PmxtError(`Failed to watch trades: ${error}`);
         }
     }
     /**
@@ -841,7 +938,9 @@ class Exchange {
             return convertSubscriptionSnapshot(data);
         }
         catch (error) {
-            throw new Error(`Failed to watch address: ${error}`);
+            if (error instanceof errors_js_1.PmxtError)
+                throw error;
+            throw new errors_js_1.PmxtError(`Failed to watch address: ${error}`);
         }
     }
     /**
@@ -865,7 +964,9 @@ class Exchange {
             return this.handleResponse(response);
         }
         catch (error) {
-            throw new Error(`Failed to unwatch address: ${error}`);
+            if (error instanceof errors_js_1.PmxtError)
+                throw error;
+            throw new errors_js_1.PmxtError(`Failed to unwatch address: ${error}`);
         }
     }
     // Trading Methods (require authentication)
@@ -912,11 +1013,11 @@ 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 errors_js_1.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 errors_js_1.PmxtError("outcome.marketId is not set. Ensure the outcome comes from a fetched market.");
                 }
                 marketId = outcome.marketId;
                 outcomeId = outcome.outcomeId;
@@ -946,7 +1047,9 @@ class Exchange {
             return data;
         }
         catch (error) {
-            throw new Error(`Failed to build order: ${error}`);
+            if (error instanceof errors_js_1.PmxtError)
+                throw error;
+            throw new errors_js_1.PmxtError(`Failed to build order: ${error}`);
         }
     }
     /**
@@ -983,7 +1086,9 @@ class Exchange {
             return convertOrder(data);
         }
         catch (error) {
-            throw new Error(`Failed to submit order: ${error}`);
+            if (error instanceof errors_js_1.PmxtError)
+                throw error;
+            throw new errors_js_1.PmxtError(`Failed to submit order: ${error}`);
         }
     }
     /**
@@ -1012,11 +1117,11 @@ 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 errors_js_1.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 errors_js_1.PmxtError("outcome.marketId is not set. Ensure the outcome comes from a fetched market.");
                 }
                 marketId = outcome.marketId;
                 outcomeId = outcome.outcomeId;
@@ -1046,7 +1151,9 @@ class Exchange {
             return convertOrder(data);
         }
         catch (error) {
-            throw new Error(`Failed to create order: ${error}`);
+            if (error instanceof errors_js_1.PmxtError)
+                throw error;
+            throw new errors_js_1.PmxtError(`Failed to create order: ${error}`);
         }
     }
     /**
@@ -1091,14 +1198,19 @@ 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 (0, errors_js_1.fromServerError)(body.error);
+                }
+                throw new errors_js_1.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 errors_js_1.PmxtError)
+                throw error;
+            throw new errors_js_1.PmxtError(`Failed to get execution price: ${error}`);
         }
     }
     // ----------------------------------------------------------------------------

package/dist/pmxt/errors.d.ts

@@ -0,0 +1,55 @@
+/**
+ * Typed error classes for pmxt.
+ *
+ * These mirror the error hierarchy in the core TypeScript library,
+ * enabling users to catch specific error types.
+ */
+export declare class PmxtError extends Error {
+    readonly code: string;
+    readonly retryable: boolean;
+    readonly exchange?: string;
+    constructor(message: string, code?: string, retryable?: boolean, exchange?: string);
+}
+export declare class BadRequest extends PmxtError {
+    constructor(message: string, exchange?: string);
+}
+export declare class AuthenticationError extends PmxtError {
+    constructor(message: string, exchange?: string);
+}
+export declare class PermissionDenied extends PmxtError {
+    constructor(message: string, exchange?: string);
+}
+export declare class NotFoundError extends PmxtError {
+    constructor(message: string, exchange?: string);
+}
+export declare class OrderNotFound extends NotFoundError {
+    constructor(orderId: string, exchange?: string);
+}
+export declare class MarketNotFound extends NotFoundError {
+    constructor(marketId: string, exchange?: string);
+}
+export declare class EventNotFound extends NotFoundError {
+    constructor(identifier: string, exchange?: string);
+}
+export declare class RateLimitExceeded extends PmxtError {
+    readonly retryAfter?: number;
+    constructor(message: string, retryAfter?: number, exchange?: string);
+}
+export declare class InvalidOrder extends PmxtError {
+    constructor(message: string, exchange?: string);
+}
+export declare class InsufficientFunds extends PmxtError {
+    constructor(message: string, exchange?: string);
+}
+export declare class ValidationError extends PmxtError {
+    readonly field?: string;
+    constructor(message: string, field?: string, exchange?: string);
+}
+export declare class NetworkError extends PmxtError {
+    constructor(message: string, exchange?: string);
+}
+export declare class ExchangeNotAvailable extends PmxtError {
+    constructor(message: string, exchange?: string);
+}
+/** Convert a server error response object into a typed PmxtError. */
+export declare function fromServerError(errorData: any): PmxtError;