pmxtjs 1.0.3 → 1.1.0-b3

package/generated/src/models/WatchOrderBookRequest.ts

@@ -0,0 +1,89 @@
+/* tslint:disable */
+/* eslint-disable */
+/**
+ * PMXT Sidecar API
+ * A unified local sidecar API for prediction markets (Polymarket, Kalshi). This API acts as a JSON-RPC-style gateway. Each endpoint corresponds to a specific method on the generic exchange implementation. 
+ *
+ * The version of the OpenAPI document: 0.4.4
+ * 
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+
+import { mapValues } from '../runtime';
+import type { ExchangeCredentials } from './ExchangeCredentials';
+import {
+    ExchangeCredentialsFromJSON,
+    ExchangeCredentialsFromJSONTyped,
+    ExchangeCredentialsToJSON,
+    ExchangeCredentialsToJSONTyped,
+} from './ExchangeCredentials';
+import type { WatchOrderBookRequestArgsInner } from './WatchOrderBookRequestArgsInner';
+import {
+    WatchOrderBookRequestArgsInnerFromJSON,
+    WatchOrderBookRequestArgsInnerFromJSONTyped,
+    WatchOrderBookRequestArgsInnerToJSON,
+    WatchOrderBookRequestArgsInnerToJSONTyped,
+} from './WatchOrderBookRequestArgsInner';
+
+/**
+ * 
+ * @export
+ * @interface WatchOrderBookRequest
+ */
+export interface WatchOrderBookRequest {
+    /**
+     * [outcomeId, limit?]
+     * @type {Array<WatchOrderBookRequestArgsInner>}
+     * @memberof WatchOrderBookRequest
+     */
+    args: Array<WatchOrderBookRequestArgsInner>;
+    /**
+     * 
+     * @type {ExchangeCredentials}
+     * @memberof WatchOrderBookRequest
+     */
+    credentials?: ExchangeCredentials;
+}
+
+/**
+ * Check if a given object implements the WatchOrderBookRequest interface.
+ */
+export function instanceOfWatchOrderBookRequest(value: object): value is WatchOrderBookRequest {
+    if (!('args' in value) || value['args'] === undefined) return false;
+    return true;
+}
+
+export function WatchOrderBookRequestFromJSON(json: any): WatchOrderBookRequest {
+    return WatchOrderBookRequestFromJSONTyped(json, false);
+}
+
+export function WatchOrderBookRequestFromJSONTyped(json: any, ignoreDiscriminator: boolean): WatchOrderBookRequest {
+    if (json == null) {
+        return json;
+    }
+    return {
+        
+        'args': ((json['args'] as Array<any>).map(WatchOrderBookRequestArgsInnerFromJSON)),
+        'credentials': json['credentials'] == null ? undefined : ExchangeCredentialsFromJSON(json['credentials']),
+    };
+}
+
+export function WatchOrderBookRequestToJSON(json: any): WatchOrderBookRequest {
+    return WatchOrderBookRequestToJSONTyped(json, false);
+}
+
+export function WatchOrderBookRequestToJSONTyped(value?: WatchOrderBookRequest | null, ignoreDiscriminator: boolean = false): any {
+    if (value == null) {
+        return value;
+    }
+
+    return {
+        
+        'args': ((value['args'] as Array<any>).map(WatchOrderBookRequestArgsInnerToJSON)),
+        'credentials': ExchangeCredentialsToJSON(value['credentials']),
+    };
+}
+

package/generated/src/models/WatchOrderBookRequestArgsInner.ts

@@ -0,0 +1,55 @@
+/* tslint:disable */
+/* eslint-disable */
+/**
+ * PMXT Sidecar API
+ * A unified local sidecar API for prediction markets (Polymarket, Kalshi). This API acts as a JSON-RPC-style gateway. Each endpoint corresponds to a specific method on the generic exchange implementation. 
+ *
+ * The version of the OpenAPI document: 0.4.4
+ * 
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+
+/**
+ * @type WatchOrderBookRequestArgsInner
+ * 
+ * @export
+ */
+export type WatchOrderBookRequestArgsInner = number | string;
+
+export function WatchOrderBookRequestArgsInnerFromJSON(json: any): WatchOrderBookRequestArgsInner {
+    return WatchOrderBookRequestArgsInnerFromJSONTyped(json, false);
+}
+
+export function WatchOrderBookRequestArgsInnerFromJSONTyped(json: any, ignoreDiscriminator: boolean): WatchOrderBookRequestArgsInner {
+    if (json == null) {
+        return json;
+    }
+    if (typeof json === 'number') {
+        return json;
+    }
+    if (typeof json === 'string') {
+        return json;
+    }
+    return {} as any;
+}
+
+export function WatchOrderBookRequestArgsInnerToJSON(json: any): any {
+    return WatchOrderBookRequestArgsInnerToJSONTyped(json, false);
+}
+
+export function WatchOrderBookRequestArgsInnerToJSONTyped(value?: WatchOrderBookRequestArgsInner | null, ignoreDiscriminator: boolean = false): any {
+    if (value == null) {
+        return value;
+    }
+    if (typeof value === 'number') {
+        return value;
+    }
+    if (typeof value === 'string') {
+        return value;
+    }
+    return {};
+}
+

package/generated/src/models/WatchTradesRequest.ts

@@ -0,0 +1,89 @@
+/* tslint:disable */
+/* eslint-disable */
+/**
+ * PMXT Sidecar API
+ * A unified local sidecar API for prediction markets (Polymarket, Kalshi). This API acts as a JSON-RPC-style gateway. Each endpoint corresponds to a specific method on the generic exchange implementation. 
+ *
+ * The version of the OpenAPI document: 0.4.4
+ * 
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+
+import { mapValues } from '../runtime';
+import type { ExchangeCredentials } from './ExchangeCredentials';
+import {
+    ExchangeCredentialsFromJSON,
+    ExchangeCredentialsFromJSONTyped,
+    ExchangeCredentialsToJSON,
+    ExchangeCredentialsToJSONTyped,
+} from './ExchangeCredentials';
+import type { WatchOrderBookRequestArgsInner } from './WatchOrderBookRequestArgsInner';
+import {
+    WatchOrderBookRequestArgsInnerFromJSON,
+    WatchOrderBookRequestArgsInnerFromJSONTyped,
+    WatchOrderBookRequestArgsInnerToJSON,
+    WatchOrderBookRequestArgsInnerToJSONTyped,
+} from './WatchOrderBookRequestArgsInner';
+
+/**
+ * 
+ * @export
+ * @interface WatchTradesRequest
+ */
+export interface WatchTradesRequest {
+    /**
+     * [outcomeId, since?, limit?]
+     * @type {Array<WatchOrderBookRequestArgsInner>}
+     * @memberof WatchTradesRequest
+     */
+    args: Array<WatchOrderBookRequestArgsInner>;
+    /**
+     * 
+     * @type {ExchangeCredentials}
+     * @memberof WatchTradesRequest
+     */
+    credentials?: ExchangeCredentials;
+}
+
+/**
+ * Check if a given object implements the WatchTradesRequest interface.
+ */
+export function instanceOfWatchTradesRequest(value: object): value is WatchTradesRequest {
+    if (!('args' in value) || value['args'] === undefined) return false;
+    return true;
+}
+
+export function WatchTradesRequestFromJSON(json: any): WatchTradesRequest {
+    return WatchTradesRequestFromJSONTyped(json, false);
+}
+
+export function WatchTradesRequestFromJSONTyped(json: any, ignoreDiscriminator: boolean): WatchTradesRequest {
+    if (json == null) {
+        return json;
+    }
+    return {
+        
+        'args': ((json['args'] as Array<any>).map(WatchOrderBookRequestArgsInnerFromJSON)),
+        'credentials': json['credentials'] == null ? undefined : ExchangeCredentialsFromJSON(json['credentials']),
+    };
+}
+
+export function WatchTradesRequestToJSON(json: any): WatchTradesRequest {
+    return WatchTradesRequestToJSONTyped(json, false);
+}
+
+export function WatchTradesRequestToJSONTyped(value?: WatchTradesRequest | null, ignoreDiscriminator: boolean = false): any {
+    if (value == null) {
+        return value;
+    }
+
+    return {
+        
+        'args': ((value['args'] as Array<any>).map(WatchOrderBookRequestArgsInnerToJSON)),
+        'credentials': ExchangeCredentialsToJSON(value['credentials']),
+    };
+}
+

package/generated/src/models/index.ts

@@ -38,3 +38,6 @@ export * from './SearchMarketsRequest';
 export * from './SearchMarketsRequestArgsInner';
 export * from './Trade';
 export * from './UnifiedMarket';
+export * from './WatchOrderBookRequest';
+export * from './WatchOrderBookRequestArgsInner';
+export * from './WatchTradesRequest';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pmxtjs",
-  "version": "1.0.3",
+  "version": "1.1.0-b3",
   "description": "Unified prediction market data API - The ccxt for prediction markets",
   "author": "PMXT Contributors",
   "repository": {
@@ -42,7 +42,7 @@
     "unified"
   ],
   "dependencies": {
-    "pmxt-core": "1.0.3"
+    "pmxt-core": "1.1.0-b3"
   },
   "devDependencies": {
     "@types/jest": "^30.0.0",

package/pmxt/client.ts

@@ -203,8 +203,17 @@ export abstract class Exchange {
                 const actualPort = this.serverManager.getRunningPort();
                 const newBaseUrl = `http://localhost:${actualPort}`;
 
+                const accessToken = this.serverManager.getAccessToken();
+                const headers: any = {};
+                if (accessToken) {
+                    headers['x-pmxt-access-token'] = accessToken;
+                }
+
                 // Update API client with actual base URL
-                const newConfig = new Configuration({ basePath: newBaseUrl });
+                const newConfig = new Configuration({
+                    basePath: newBaseUrl,
+                    headers
+                });
                 this.api = new DefaultApi(newConfig);
             } catch (error) {
                 throw new Error(
@@ -472,6 +481,107 @@ export abstract class Exchange {
         }
     }
 
+    // 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: string, limit?: number): Promise<OrderBook> {
+        await this.initPromise;
+        try {
+            const args: any[] = [outcomeId];
+            if (limit !== undefined) {
+                args.push(limit);
+            }
+
+            const requestBody: any = {
+                args,
+                credentials: this.getCredentials()
+            };
+
+            const response = await this.api.watchOrderBook({
+                exchange: this.exchangeName as any,
+                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: string,
+        since?: number,
+        limit?: number
+    ): Promise<Trade[]> {
+        await this.initPromise;
+        try {
+            const args: any[] = [outcomeId];
+            if (since !== undefined) {
+                args.push(since);
+            }
+            if (limit !== undefined) {
+                args.push(limit);
+            }
+
+            const requestBody: any = {
+                args,
+                credentials: this.getCredentials()
+            };
+
+            const response = await this.api.watchTrades({
+                exchange: this.exchangeName as any,
+                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)
 
     /**

package/pmxt/server-manager.ts

@@ -18,6 +18,8 @@ export interface ServerManagerOptions {
 interface ServerLockInfo {
     port: number;
     pid: number;
+    accessToken?: string;
+    version?: string;
     timestamp: number;
 }
 
@@ -66,8 +68,13 @@ export class ServerManager {
     }
 
     /**
-     * Check if the server is running.
+     * Get the access token from the lock file.
      */
+    getAccessToken(): string | undefined {
+        const info = this.getServerInfo();
+        return info?.accessToken;
+    }
+
     /**
      * Check if the server is running.
      */
@@ -108,9 +115,18 @@ export class ServerManager {
      * Ensure the server is running, starting it if necessary.
      */
     async ensureServerRunning(): Promise<void> {
-        // 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
@@ -152,5 +168,56 @@ export class ServerManager {
             );
         }
     }
-}
 
+    private async isVersionMismatch(): Promise<boolean> {
+        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: string | undefined;
+            try {
+                corePackageJsonPath = require.resolve('pmxt-core/package.json');
+            } catch {
+                // 2. Try dev path (Monorepo)
+                const devPath = join(dirname(__dirname), '../../core/package.json');
+                if (existsSync(devPath)) {
+                    corePackageJsonPath = devPath;
+                }
+            }
+
+            if (corePackageJsonPath && existsSync(corePackageJsonPath)) {
+                const content = 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;
+    }
+
+    private async killOldServer(): Promise<void> {
+        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 import('fs');
+            unlinkSync(this.lockPath);
+        } catch { }
+    }
+}