pmxtjs 1.0.3 → 1.1.0-b3

package/dist/pmxt/client.js

@@ -139,8 +139,16 @@ class Exchange {
                 // (may differ from default if default port was busy)
                 const actualPort = this.serverManager.getRunningPort();
                 const newBaseUrl = `http://localhost:${actualPort}`;
+                const accessToken = this.serverManager.getAccessToken();
+                const headers = {};
+                if (accessToken) {
+                    headers['x-pmxt-access-token'] = accessToken;
+                }
                 // Update API client with actual base URL
-                const newConfig = new index_js_1.Configuration({ basePath: newBaseUrl });
+                const newConfig = new index_js_1.Configuration({
+                    basePath: newBaseUrl,
+                    headers
+                });
                 this.api = new index_js_1.DefaultApi(newConfig);
             }
             catch (error) {
@@ -378,6 +386,96 @@ class Exchange {
             throw new Error(`Failed to fetch trades: ${error}`);
         }
     }
+    // WebSocket Streaming Methods
+    /**
+     * Watch real-time order book updates via WebSocket.
+     *
+     * Returns a promise that resolves with the next order book update.
+     * Call repeatedly in a loop to stream updates (CCXT Pro pattern).
+     *
+     * @param outcomeId - Outcome ID to watch
+     * @param limit - Optional depth limit for order book
+     * @returns Next order book update
+     *
+     * @example
+     * ```typescript
+     * // Stream order book updates
+     * while (true) {
+     *   const orderBook = await exchange.watchOrderBook(outcomeId);
+     *   console.log(`Best bid: ${orderBook.bids[0].price}`);
+     *   console.log(`Best ask: ${orderBook.asks[0].price}`);
+     * }
+     * ```
+     */
+    async watchOrderBook(outcomeId, limit) {
+        await this.initPromise;
+        try {
+            const args = [outcomeId];
+            if (limit !== undefined) {
+                args.push(limit);
+            }
+            const requestBody = {
+                args,
+                credentials: this.getCredentials()
+            };
+            const response = await this.api.watchOrderBook({
+                exchange: this.exchangeName,
+                watchOrderBookRequest: requestBody,
+            });
+            const data = this.handleResponse(response);
+            return convertOrderBook(data);
+        }
+        catch (error) {
+            throw new Error(`Failed to watch order book: ${error}`);
+        }
+    }
+    /**
+     * Watch real-time trade updates via WebSocket.
+     *
+     * Returns a promise that resolves with the next trade(s).
+     * Call repeatedly in a loop to stream updates (CCXT Pro pattern).
+     *
+     * @param outcomeId - Outcome ID to watch
+     * @param since - Optional timestamp to filter trades from
+     * @param limit - Optional limit for number of trades
+     * @returns Next trade update(s)
+     *
+     * @example
+     * ```typescript
+     * // Stream trade updates
+     * while (true) {
+     *   const trades = await exchange.watchTrades(outcomeId);
+     *   for (const trade of trades) {
+     *     console.log(`Trade: ${trade.price} @ ${trade.amount}`);
+     *   }
+     * }
+     * ```
+     */
+    async watchTrades(outcomeId, since, limit) {
+        await this.initPromise;
+        try {
+            const args = [outcomeId];
+            if (since !== undefined) {
+                args.push(since);
+            }
+            if (limit !== undefined) {
+                args.push(limit);
+            }
+            const requestBody = {
+                args,
+                credentials: this.getCredentials()
+            };
+            const response = await this.api.watchTrades({
+                exchange: this.exchangeName,
+                watchTradesRequest: requestBody,
+            });
+            const data = this.handleResponse(response);
+            return data.map(convertTrade);
+        }
+        catch (error) {
+            throw new Error(`Failed to watch trades: ${error}`);
+        }
+    }
     // Trading Methods (require authentication)
     /**
      * Create a new order.

package/dist/pmxt/server-manager.d.ts

@@ -28,8 +28,9 @@ export declare class ServerManager {
      */
     getRunningPort(): number;
     /**
-     * Check if the server is running.
+     * Get the access token from the lock file.
      */
+    getAccessToken(): string | undefined;
     /**
      * Check if the server is running.
      */
@@ -42,4 +43,6 @@ export declare class ServerManager {
      * Ensure the server is running, starting it if necessary.
      */
     ensureServerRunning(): Promise<void>;
+    private isVersionMismatch;
+    private killOldServer;
 }

package/dist/pmxt/server-manager.js

@@ -84,8 +84,12 @@ class ServerManager {
         return info?.port || ServerManager.DEFAULT_PORT;
     }
     /**
-     * Check if the server is running.
+     * Get the access token from the lock file.
      */
+    getAccessToken() {
+        const info = this.getServerInfo();
+        return info?.accessToken;
+    }
     /**
      * Check if the server is running.
      */
@@ -122,9 +126,18 @@ class ServerManager {
      * Ensure the server is running, starting it if necessary.
      */
     async ensureServerRunning() {
-        // Check if already running
+        // Check for force restart
+        if (process.env.PMXT_ALWAYS_RESTART === '1') {
+            await this.killOldServer();
+        }
+        // Check if already running and version matches
         if (await this.isServerRunning()) {
-            return;
+            if (await this.isVersionMismatch()) {
+                await this.killOldServer();
+            }
+            else {
+                return;
+            }
         }
         // Locate pmxt-ensure-server
         let launcherPath = 'pmxt-ensure-server'; // Default to PATH
@@ -160,5 +173,57 @@ class ServerManager {
                 `Or start the server manually: pmxt-server`);
         }
     }
+    async isVersionMismatch() {
+        const info = this.getServerInfo();
+        if (!info || !info.version) {
+            return true; // Old server without version
+        }
+        try {
+            // 1. Try to find package.json relative to the installed location (Production)
+            let corePackageJsonPath;
+            try {
+                corePackageJsonPath = require.resolve('pmxt-core/package.json');
+            }
+            catch {
+                // 2. Try dev path (Monorepo)
+                const devPath = (0, path_1.join)((0, path_1.dirname)(__dirname), '../../core/package.json');
+                if ((0, fs_1.existsSync)(devPath)) {
+                    corePackageJsonPath = devPath;
+                }
+            }
+            if (corePackageJsonPath && (0, fs_1.existsSync)(corePackageJsonPath)) {
+                const content = (0, fs_1.readFileSync)(corePackageJsonPath, 'utf-8');
+                const pkg = JSON.parse(content);
+                // Check if running version starts with package version
+                // (Server version might have extra hash in dev mode)
+                if (pkg.version && !info.version.startsWith(pkg.version)) {
+                    return true;
+                }
+            }
+        }
+        catch {
+            // Ignore errors
+        }
+        return false;
+    }
+    async killOldServer() {
+        const info = this.getServerInfo();
+        if (info && info.pid) {
+            try {
+                process.kill(info.pid, 'SIGTERM');
+                // Brief wait
+                await new Promise(resolve => setTimeout(resolve, 500));
+            }
+            catch {
+                // Ignore
+            }
+        }
+        // Remove lock file (best effort)
+        try {
+            const { unlinkSync } = await Promise.resolve().then(() => __importStar(require('fs')));
+            unlinkSync(this.lockPath);
+        }
+        catch { }
+    }
 }
 exports.ServerManager = ServerManager;

package/generated/.openapi-generator/FILES

@@ -40,6 +40,9 @@ docs/SearchMarketsRequest.md
 docs/SearchMarketsRequestArgsInner.md
 docs/Trade.md
 docs/UnifiedMarket.md
+docs/WatchOrderBookRequest.md
+docs/WatchOrderBookRequestArgsInner.md
+docs/WatchTradesRequest.md
 package.json
 src/apis/DefaultApi.ts
 src/apis/index.ts
@@ -82,6 +85,9 @@ src/models/SearchMarketsRequest.ts
 src/models/SearchMarketsRequestArgsInner.ts
 src/models/Trade.ts
 src/models/UnifiedMarket.ts
+src/models/WatchOrderBookRequest.ts
+src/models/WatchOrderBookRequestArgsInner.ts
+src/models/WatchTradesRequest.ts
 src/models/index.ts
 src/runtime.ts
 tsconfig.esm.json

package/generated/docs/DefaultApi.md

@@ -17,6 +17,8 @@ All URIs are relative to *http://localhost:3847*
 | [**getMarketsBySlug**](DefaultApi.md#getmarketsbyslugoperation) | **POST** /api/{exchange}/getMarketsBySlug | Get Market by Slug |
 | [**healthCheck**](DefaultApi.md#healthcheck) | **GET** /health | Server Health Check |
 | [**searchMarkets**](DefaultApi.md#searchmarketsoperation) | **POST** /api/{exchange}/searchMarkets | Search Markets |
+| [**watchOrderBook**](DefaultApi.md#watchorderbookoperation) | **POST** /api/{exchange}/watchOrderBook | Watch Order Book (WebSocket Stream) |
+| [**watchTrades**](DefaultApi.md#watchtradesoperation) | **POST** /api/{exchange}/watchTrades | Watch Trades (WebSocket Stream) |
 
 
 
@@ -894,3 +896,143 @@ No authorization required
 
 [[Back to top]](#) [[Back to API list]](../README.md#api-endpoints) [[Back to Model list]](../README.md#models) [[Back to README]](../README.md)
 
+
+## watchOrderBook
+
+> FetchOrderBook200Response watchOrderBook(exchange, watchOrderBookRequest)
+
+Watch Order Book (WebSocket Stream)
+
+Subscribe to real-time order book updates via WebSocket. Returns a promise that resolves with the next order book update. Call repeatedly in a loop to stream updates (CCXT Pro pattern). 
+
+### Example
+
+```ts
+import {
+  Configuration,
+  DefaultApi,
+} from 'pmxtjs';
+import type { WatchOrderBookOperationRequest } from 'pmxtjs';
+
+async function example() {
+  console.log("🚀 Testing pmxtjs SDK...");
+  const api = new DefaultApi();
+
+  const body = {
+    // 'polymarket' | 'kalshi' | The prediction market exchange to target.
+    exchange: exchange_example,
+    // WatchOrderBookRequest (optional)
+    watchOrderBookRequest: ...,
+  } satisfies WatchOrderBookOperationRequest;
+
+  try {
+    const data = await api.watchOrderBook(body);
+    console.log(data);
+  } catch (error) {
+    console.error(error);
+  }
+}
+
+// Run the test
+example().catch(console.error);
+```
+
+### Parameters
+
+
+| Name | Type | Description  | Notes |
+|------------- | ------------- | ------------- | -------------|
+| **exchange** | `polymarket`, `kalshi` | The prediction market exchange to target. | [Defaults to `undefined`] [Enum: polymarket, kalshi] |
+| **watchOrderBookRequest** | [WatchOrderBookRequest](WatchOrderBookRequest.md) |  | [Optional] |
+
+### Return type
+
+[**FetchOrderBook200Response**](FetchOrderBook200Response.md)
+
+### Authorization
+
+No authorization required
+
+### HTTP request headers
+
+- **Content-Type**: `application/json`
+- **Accept**: `application/json`
+
+
+### HTTP response details
+| Status code | Description | Response headers |
+|-------------|-------------|------------------|
+| **200** | Next order book update |  -  |
+
+[[Back to top]](#) [[Back to API list]](../README.md#api-endpoints) [[Back to Model list]](../README.md#models) [[Back to README]](../README.md)
+
+
+## watchTrades
+
+> FetchTrades200Response watchTrades(exchange, watchTradesRequest)
+
+Watch Trades (WebSocket Stream)
+
+Subscribe to real-time trade updates via WebSocket. Returns a promise that resolves with the next trade(s). Call repeatedly in a loop to stream updates (CCXT Pro pattern). 
+
+### Example
+
+```ts
+import {
+  Configuration,
+  DefaultApi,
+} from 'pmxtjs';
+import type { WatchTradesOperationRequest } from 'pmxtjs';
+
+async function example() {
+  console.log("🚀 Testing pmxtjs SDK...");
+  const api = new DefaultApi();
+
+  const body = {
+    // 'polymarket' | 'kalshi' | The prediction market exchange to target.
+    exchange: exchange_example,
+    // WatchTradesRequest (optional)
+    watchTradesRequest: ...,
+  } satisfies WatchTradesOperationRequest;
+
+  try {
+    const data = await api.watchTrades(body);
+    console.log(data);
+  } catch (error) {
+    console.error(error);
+  }
+}
+
+// Run the test
+example().catch(console.error);
+```
+
+### Parameters
+
+
+| Name | Type | Description  | Notes |
+|------------- | ------------- | ------------- | -------------|
+| **exchange** | `polymarket`, `kalshi` | The prediction market exchange to target. | [Defaults to `undefined`] [Enum: polymarket, kalshi] |
+| **watchTradesRequest** | [WatchTradesRequest](WatchTradesRequest.md) |  | [Optional] |
+
+### Return type
+
+[**FetchTrades200Response**](FetchTrades200Response.md)
+
+### Authorization
+
+No authorization required
+
+### HTTP request headers
+
+- **Content-Type**: `application/json`
+- **Accept**: `application/json`
+
+
+### HTTP response details
+| Status code | Description | Response headers |
+|-------------|-------------|------------------|
+| **200** | Next trade update(s) |  -  |
+
+[[Back to top]](#) [[Back to API list]](../README.md#api-endpoints) [[Back to Model list]](../README.md#models) [[Back to README]](../README.md)
+

package/generated/docs/WatchOrderBookRequest.md

@@ -0,0 +1,36 @@
+
+# WatchOrderBookRequest
+
+
+## Properties
+
+Name | Type
+------------ | -------------
+`args` | [Array<WatchOrderBookRequestArgsInner>](WatchOrderBookRequestArgsInner.md)
+`credentials` | [ExchangeCredentials](ExchangeCredentials.md)
+
+## Example
+
+```typescript
+import type { WatchOrderBookRequest } from 'pmxtjs'
+
+// TODO: Update the object below with actual values
+const example = {
+  "args": null,
+  "credentials": null,
+} satisfies WatchOrderBookRequest
+
+console.log(example)
+
+// Convert the instance to a JSON string
+const exampleJSON: string = JSON.stringify(example)
+console.log(exampleJSON)
+
+// Parse the JSON string back to an object
+const exampleParsed = JSON.parse(exampleJSON) as WatchOrderBookRequest
+console.log(exampleParsed)
+```
+
+[[Back to top]](#) [[Back to API list]](../README.md#api-endpoints) [[Back to Model list]](../README.md#models) [[Back to README]](../README.md)
+
+

package/generated/docs/WatchOrderBookRequestArgsInner.md

@@ -0,0 +1,32 @@
+
+# WatchOrderBookRequestArgsInner
+
+
+## Properties
+
+Name | Type
+------------ | -------------
+
+## Example
+
+```typescript
+import type { WatchOrderBookRequestArgsInner } from 'pmxtjs'
+
+// TODO: Update the object below with actual values
+const example = {
+} satisfies WatchOrderBookRequestArgsInner
+
+console.log(example)
+
+// Convert the instance to a JSON string
+const exampleJSON: string = JSON.stringify(example)
+console.log(exampleJSON)
+
+// Parse the JSON string back to an object
+const exampleParsed = JSON.parse(exampleJSON) as WatchOrderBookRequestArgsInner
+console.log(exampleParsed)
+```
+
+[[Back to top]](#) [[Back to API list]](../README.md#api-endpoints) [[Back to Model list]](../README.md#models) [[Back to README]](../README.md)
+
+

package/generated/docs/WatchTradesRequest.md

@@ -0,0 +1,36 @@
+
+# WatchTradesRequest
+
+
+## Properties
+
+Name | Type
+------------ | -------------
+`args` | [Array<WatchOrderBookRequestArgsInner>](WatchOrderBookRequestArgsInner.md)
+`credentials` | [ExchangeCredentials](ExchangeCredentials.md)
+
+## Example
+
+```typescript
+import type { WatchTradesRequest } from 'pmxtjs'
+
+// TODO: Update the object below with actual values
+const example = {
+  "args": null,
+  "credentials": null,
+} satisfies WatchTradesRequest
+
+console.log(example)
+
+// Convert the instance to a JSON string
+const exampleJSON: string = JSON.stringify(example)
+console.log(exampleJSON)
+
+// Parse the JSON string back to an object
+const exampleParsed = JSON.parse(exampleJSON) as WatchTradesRequest
+console.log(exampleParsed)
+```
+
+[[Back to top]](#) [[Back to API list]](../README.md#api-endpoints) [[Back to Model list]](../README.md#models) [[Back to README]](../README.md)
+
+

package/generated/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pmxtjs",
-  "version": "1.0.3",
+  "version": "1.1.0-b3",
   "description": "OpenAPI client for pmxtjs",
   "author": "OpenAPI-Generator",
   "repository": {

package/generated/src/apis/DefaultApi.ts

@@ -34,6 +34,8 @@ import type {
   GetMarketsBySlugRequest,
   HealthCheck200Response,
   SearchMarketsRequest,
+  WatchOrderBookRequest,
+  WatchTradesRequest,
 } from '../models/index';
 import {
     CancelOrderRequestFromJSON,
@@ -74,6 +76,10 @@ import {
     HealthCheck200ResponseToJSON,
     SearchMarketsRequestFromJSON,
     SearchMarketsRequestToJSON,
+    WatchOrderBookRequestFromJSON,
+    WatchOrderBookRequestToJSON,
+    WatchTradesRequestFromJSON,
+    WatchTradesRequestToJSON,
 } from '../models/index';
 
 export interface CancelOrderOperationRequest {
@@ -136,6 +142,16 @@ export interface SearchMarketsOperationRequest {
     searchMarketsRequest?: SearchMarketsRequest;
 }
 
+export interface WatchOrderBookOperationRequest {
+    exchange: WatchOrderBookOperationExchangeEnum;
+    watchOrderBookRequest?: WatchOrderBookRequest;
+}
+
+export interface WatchTradesOperationRequest {
+    exchange: WatchTradesOperationExchangeEnum;
+    watchTradesRequest?: WatchTradesRequest;
+}
+
 /**
  * 
  */
@@ -652,6 +668,90 @@ export class DefaultApi extends runtime.BaseAPI {
         return await response.value();
     }
 
+    /**
+     * Subscribe to real-time order book updates via WebSocket. Returns a promise that resolves with the next order book update. Call repeatedly in a loop to stream updates (CCXT Pro pattern). 
+     * Watch Order Book (WebSocket Stream)
+     */
+    async watchOrderBookRaw(requestParameters: WatchOrderBookOperationRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<FetchOrderBook200Response>> {
+        if (requestParameters['exchange'] == null) {
+            throw new runtime.RequiredError(
+                'exchange',
+                'Required parameter "exchange" was null or undefined when calling watchOrderBook().'
+            );
+        }
+
+        const queryParameters: any = {};
+
+        const headerParameters: runtime.HTTPHeaders = {};
+
+        headerParameters['Content-Type'] = 'application/json';
+
+
+        let urlPath = `/api/{exchange}/watchOrderBook`;
+        urlPath = urlPath.replace(`{${"exchange"}}`, encodeURIComponent(String(requestParameters['exchange'])));
+
+        const response = await this.request({
+            path: urlPath,
+            method: 'POST',
+            headers: headerParameters,
+            query: queryParameters,
+            body: WatchOrderBookRequestToJSON(requestParameters['watchOrderBookRequest']),
+        }, initOverrides);
+
+        return new runtime.JSONApiResponse(response, (jsonValue) => FetchOrderBook200ResponseFromJSON(jsonValue));
+    }
+
+    /**
+     * Subscribe to real-time order book updates via WebSocket. Returns a promise that resolves with the next order book update. Call repeatedly in a loop to stream updates (CCXT Pro pattern). 
+     * Watch Order Book (WebSocket Stream)
+     */
+    async watchOrderBook(requestParameters: WatchOrderBookOperationRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<FetchOrderBook200Response> {
+        const response = await this.watchOrderBookRaw(requestParameters, initOverrides);
+        return await response.value();
+    }
+
+    /**
+     * Subscribe to real-time trade updates via WebSocket. Returns a promise that resolves with the next trade(s). Call repeatedly in a loop to stream updates (CCXT Pro pattern). 
+     * Watch Trades (WebSocket Stream)
+     */
+    async watchTradesRaw(requestParameters: WatchTradesOperationRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<FetchTrades200Response>> {
+        if (requestParameters['exchange'] == null) {
+            throw new runtime.RequiredError(
+                'exchange',
+                'Required parameter "exchange" was null or undefined when calling watchTrades().'
+            );
+        }
+
+        const queryParameters: any = {};
+
+        const headerParameters: runtime.HTTPHeaders = {};
+
+        headerParameters['Content-Type'] = 'application/json';
+
+
+        let urlPath = `/api/{exchange}/watchTrades`;
+        urlPath = urlPath.replace(`{${"exchange"}}`, encodeURIComponent(String(requestParameters['exchange'])));
+
+        const response = await this.request({
+            path: urlPath,
+            method: 'POST',
+            headers: headerParameters,
+            query: queryParameters,
+            body: WatchTradesRequestToJSON(requestParameters['watchTradesRequest']),
+        }, initOverrides);
+
+        return new runtime.JSONApiResponse(response, (jsonValue) => FetchTrades200ResponseFromJSON(jsonValue));
+    }
+
+    /**
+     * Subscribe to real-time trade updates via WebSocket. Returns a promise that resolves with the next trade(s). Call repeatedly in a loop to stream updates (CCXT Pro pattern). 
+     * Watch Trades (WebSocket Stream)
+     */
+    async watchTrades(requestParameters: WatchTradesOperationRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<FetchTrades200Response> {
+        const response = await this.watchTradesRaw(requestParameters, initOverrides);
+        return await response.value();
+    }
+
 }
 
 /**
@@ -750,3 +850,19 @@ export const SearchMarketsOperationExchangeEnum = {
     Kalshi: 'kalshi'
 } as const;
 export type SearchMarketsOperationExchangeEnum = typeof SearchMarketsOperationExchangeEnum[keyof typeof SearchMarketsOperationExchangeEnum];
+/**
+ * @export
+ */
+export const WatchOrderBookOperationExchangeEnum = {
+    Polymarket: 'polymarket',
+    Kalshi: 'kalshi'
+} as const;
+export type WatchOrderBookOperationExchangeEnum = typeof WatchOrderBookOperationExchangeEnum[keyof typeof WatchOrderBookOperationExchangeEnum];
+/**
+ * @export
+ */
+export const WatchTradesOperationExchangeEnum = {
+    Polymarket: 'polymarket',
+    Kalshi: 'kalshi'
+} as const;
+export type WatchTradesOperationExchangeEnum = typeof WatchTradesOperationExchangeEnum[keyof typeof WatchTradesOperationExchangeEnum];