pmxtjs 0.4.3 → 1.0.0-b2

package/dist/pmxt/models.d.ts

@@ -0,0 +1,218 @@
+/**
+ * Data models for PMXT TypeScript SDK.
+ *
+ * These are clean TypeScript interfaces that provide a user-friendly API.
+ */
+/**
+ * A single tradeable outcome within a market.
+ */
+export interface MarketOutcome {
+    /**
+     * Outcome ID. Use this for fetchOHLCV/fetchOrderBook/fetchTrades.
+     * - Polymarket: CLOB Token ID
+     * - Kalshi: Market Ticker
+     */
+    id: string;
+    /** Human-readable label (e.g., "Trump", "Yes") */
+    label: string;
+    /** Current price (0.0 to 1.0, representing probability) */
+    price: number;
+    /** 24-hour price change */
+    priceChange24h?: number;
+    /** Exchange-specific metadata */
+    metadata?: Record<string, any>;
+}
+/**
+ * A unified market representation across exchanges.
+ */
+export interface UnifiedMarket {
+    /** Market ID */
+    id: string;
+    /** Market title */
+    title: string;
+    /** All tradeable outcomes */
+    outcomes: MarketOutcome[];
+    /** 24-hour trading volume (USD) */
+    volume24h: number;
+    /** Current liquidity (USD) */
+    liquidity: number;
+    /** Direct URL to the market */
+    url: string;
+    /** Market description */
+    description?: string;
+    /** Expected resolution date */
+    resolutionDate?: Date;
+    /** Total volume (USD) */
+    volume?: number;
+    /** Open interest (USD) */
+    openInterest?: number;
+    /** Market image URL */
+    image?: string;
+    /** Market category */
+    category?: string;
+    /** Market tags */
+    tags?: string[];
+}
+/**
+ * OHLCV price candle.
+ */
+export interface PriceCandle {
+    /** Unix timestamp (milliseconds) */
+    timestamp: number;
+    /** Opening price (0.0 to 1.0) */
+    open: number;
+    /** Highest price (0.0 to 1.0) */
+    high: number;
+    /** Lowest price (0.0 to 1.0) */
+    low: number;
+    /** Closing price (0.0 to 1.0) */
+    close: number;
+    /** Trading volume */
+    volume?: number;
+}
+/**
+ * A single price level in the order book.
+ */
+export interface OrderLevel {
+    /** Price (0.0 to 1.0) */
+    price: number;
+    /** Number of contracts */
+    size: number;
+}
+/**
+ * Current order book for an outcome.
+ */
+export interface OrderBook {
+    /** Bid orders (sorted high to low) */
+    bids: OrderLevel[];
+    /** Ask orders (sorted low to high) */
+    asks: OrderLevel[];
+    /** Unix timestamp (milliseconds) */
+    timestamp?: number;
+}
+/**
+ * A historical trade.
+ */
+export interface Trade {
+    /** Trade ID */
+    id: string;
+    /** Unix timestamp (milliseconds) */
+    timestamp: number;
+    /** Trade price (0.0 to 1.0) */
+    price: number;
+    /** Trade amount (contracts) */
+    amount: number;
+    /** Trade side */
+    side: "buy" | "sell" | "unknown";
+}
+/**
+ * An order (open, filled, or cancelled).
+ */
+export interface Order {
+    /** Order ID */
+    id: string;
+    /** Market ID */
+    marketId: string;
+    /** Outcome ID */
+    outcomeId: string;
+    /** Order side */
+    side: "buy" | "sell";
+    /** Order type */
+    type: "market" | "limit";
+    /** Order amount (contracts) */
+    amount: number;
+    /** Order status */
+    status: string;
+    /** Amount filled */
+    filled: number;
+    /** Amount remaining */
+    remaining: number;
+    /** Unix timestamp (milliseconds) */
+    timestamp: number;
+    /** Limit price (for limit orders) */
+    price?: number;
+    /** Trading fee */
+    fee?: number;
+}
+/**
+ * A current position in a market.
+ */
+export interface Position {
+    /** Market ID */
+    marketId: string;
+    /** Outcome ID */
+    outcomeId: string;
+    /** Outcome label */
+    outcomeLabel: string;
+    /** Position size (positive for long, negative for short) */
+    size: number;
+    /** Average entry price */
+    entryPrice: number;
+    /** Current market price */
+    currentPrice: number;
+    /** Unrealized profit/loss */
+    unrealizedPnL: number;
+    /** Realized profit/loss */
+    realizedPnL?: number;
+}
+/**
+ * Account balance.
+ */
+export interface Balance {
+    /** Currency (e.g., "USDC") */
+    currency: string;
+    /** Total balance */
+    total: number;
+    /** Available for trading */
+    available: number;
+    /** Locked in open orders */
+    locked: number;
+}
+export type CandleInterval = "1m" | "5m" | "15m" | "1h" | "6h" | "1d";
+export type SortOption = "volume" | "liquidity" | "newest";
+export type SearchIn = "title" | "description" | "both";
+export type OrderSide = "buy" | "sell";
+export type OrderType = "market" | "limit";
+/**
+ * Parameters for filtering markets.
+ */
+export interface MarketFilterParams {
+    /** Maximum number of results */
+    limit?: number;
+    /** Pagination offset */
+    offset?: number;
+    /** Sort order */
+    sort?: SortOption;
+    /** Where to search (for searchMarkets) */
+    searchIn?: SearchIn;
+}
+/**
+ * Parameters for fetching historical data.
+ */
+export interface HistoryFilterParams {
+    /** Candle resolution */
+    resolution: CandleInterval;
+    /** Start time */
+    start?: Date;
+    /** End time */
+    end?: Date;
+    /** Maximum number of results */
+    limit?: number;
+}
+/**
+ * Parameters for creating an order.
+ */
+export interface CreateOrderParams {
+    /** Market ID */
+    marketId: string;
+    /** Outcome ID */
+    outcomeId: string;
+    /** Order side (buy/sell) */
+    side: OrderSide;
+    /** Order type (market/limit) */
+    type: OrderType;
+    /** Number of contracts */
+    amount: number;
+    /** Limit price (required for limit orders, 0.0-1.0) */
+    price?: number;
+}

package/dist/pmxt/models.js

@@ -0,0 +1,6 @@
+/**
+ * Data models for PMXT TypeScript SDK.
+ *
+ * These are clean TypeScript interfaces that provide a user-friendly API.
+ */
+export {};

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

@@ -0,0 +1,29 @@
+/**
+ * Server manager for PMXT TypeScript SDK.
+ *
+ * Handles automatic server startup and health checks.
+ */
+export interface ServerManagerOptions {
+    baseUrl?: string;
+    maxRetries?: number;
+    retryDelayMs?: number;
+}
+export declare class ServerManager {
+    private baseUrl;
+    private maxRetries;
+    private retryDelayMs;
+    private api;
+    constructor(options?: ServerManagerOptions);
+    /**
+     * Check if the server is running.
+     */
+    isServerRunning(): Promise<boolean>;
+    /**
+     * Wait for the server to be ready.
+     */
+    private waitForServer;
+    /**
+     * Ensure the server is running, starting it if necessary.
+     */
+    ensureServerRunning(): Promise<void>;
+}

package/dist/pmxt/server-manager.js

@@ -0,0 +1,68 @@
+/**
+ * Server manager for PMXT TypeScript SDK.
+ *
+ * Handles automatic server startup and health checks.
+ */
+import { DefaultApi, Configuration } from "../generated/src/index.js";
+export class ServerManager {
+    baseUrl;
+    maxRetries;
+    retryDelayMs;
+    api;
+    constructor(options = {}) {
+        this.baseUrl = options.baseUrl || "http://localhost:3847";
+        this.maxRetries = options.maxRetries || 30;
+        this.retryDelayMs = options.retryDelayMs || 1000;
+        const config = new Configuration({ basePath: this.baseUrl });
+        this.api = new DefaultApi(config);
+    }
+    /**
+     * Check if the server is running.
+     */
+    async isServerRunning() {
+        try {
+            const response = await this.api.healthCheck();
+            return response.status === "ok";
+        }
+        catch (error) {
+            return false;
+        }
+    }
+    /**
+     * Wait for the server to be ready.
+     */
+    async waitForServer() {
+        for (let i = 0; i < this.maxRetries; i++) {
+            if (await this.isServerRunning()) {
+                return;
+            }
+            await new Promise((resolve) => setTimeout(resolve, this.retryDelayMs));
+        }
+        throw new Error(`Server did not start within ${(this.maxRetries * this.retryDelayMs) / 1000}s`);
+    }
+    /**
+     * Ensure the server is running, starting it if necessary.
+     */
+    async ensureServerRunning() {
+        // Check if already running
+        if (await this.isServerRunning()) {
+            return;
+        }
+        // Try to start the server using pmxt-ensure-server
+        const { spawn } = await import("child_process");
+        try {
+            const proc = spawn("pmxt-ensure-server", [], {
+                detached: true,
+                stdio: "ignore",
+            });
+            proc.unref();
+            // Wait for server to be ready
+            await this.waitForServer();
+        }
+        catch (error) {
+            throw new Error(`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`);
+        }
+    }
+}

package/generated/.openapi-generator/FILES

@@ -0,0 +1,84 @@
+.gitignore
+.npmignore
+README.md
+docs/Balance.md
+docs/BaseResponse.md
+docs/CancelOrderRequest.md
+docs/CreateOrder200Response.md
+docs/CreateOrderParams.md
+docs/CreateOrderRequest.md
+docs/DefaultApi.md
+docs/ErrorDetail.md
+docs/ErrorResponse.md
+docs/FetchBalance200Response.md
+docs/FetchMarkets200Response.md
+docs/FetchMarketsRequest.md
+docs/FetchOHLCV200Response.md
+docs/FetchOHLCVRequest.md
+docs/FetchOHLCVRequestArgsInner.md
+docs/FetchOpenOrders200Response.md
+docs/FetchOpenOrdersRequest.md
+docs/FetchOrderBook200Response.md
+docs/FetchOrderBookRequest.md
+docs/FetchPositions200Response.md
+docs/FetchPositionsRequest.md
+docs/FetchTrades200Response.md
+docs/FetchTradesRequest.md
+docs/GetMarketsBySlugRequest.md
+docs/HealthCheck200Response.md
+docs/HistoryFilterParams.md
+docs/MarketFilterParams.md
+docs/MarketOutcome.md
+docs/Order.md
+docs/OrderBook.md
+docs/OrderLevel.md
+docs/Position.md
+docs/PriceCandle.md
+docs/SearchMarketsRequest.md
+docs/SearchMarketsRequestArgsInner.md
+docs/Trade.md
+docs/UnifiedMarket.md
+package.json
+src/apis/DefaultApi.ts
+src/apis/index.ts
+src/index.ts
+src/models/Balance.ts
+src/models/BaseResponse.ts
+src/models/CancelOrderRequest.ts
+src/models/CreateOrder200Response.ts
+src/models/CreateOrderParams.ts
+src/models/CreateOrderRequest.ts
+src/models/ErrorDetail.ts
+src/models/ErrorResponse.ts
+src/models/FetchBalance200Response.ts
+src/models/FetchMarkets200Response.ts
+src/models/FetchMarketsRequest.ts
+src/models/FetchOHLCV200Response.ts
+src/models/FetchOHLCVRequest.ts
+src/models/FetchOHLCVRequestArgsInner.ts
+src/models/FetchOpenOrders200Response.ts
+src/models/FetchOpenOrdersRequest.ts
+src/models/FetchOrderBook200Response.ts
+src/models/FetchOrderBookRequest.ts
+src/models/FetchPositions200Response.ts
+src/models/FetchPositionsRequest.ts
+src/models/FetchTrades200Response.ts
+src/models/FetchTradesRequest.ts
+src/models/GetMarketsBySlugRequest.ts
+src/models/HealthCheck200Response.ts
+src/models/HistoryFilterParams.ts
+src/models/MarketFilterParams.ts
+src/models/MarketOutcome.ts
+src/models/Order.ts
+src/models/OrderBook.ts
+src/models/OrderLevel.ts
+src/models/Position.ts
+src/models/PriceCandle.ts
+src/models/SearchMarketsRequest.ts
+src/models/SearchMarketsRequestArgsInner.ts
+src/models/Trade.ts
+src/models/UnifiedMarket.ts
+src/models/index.ts
+src/runtime.ts
+tsconfig.esm.json
+tsconfig.json

package/generated/.openapi-generator/VERSION

@@ -0,0 +1 @@
+7.18.0

package/generated/.openapi-generator-ignore

@@ -0,0 +1,23 @@
+# OpenAPI Generator Ignore
+# Generated by openapi-generator https://github.com/openapitools/openapi-generator
+
+# Use this file to prevent files from being overwritten by the generator.
+# The patterns follow closely to .gitignore or .dockerignore.
+
+# As an example, the C# client generator defines ApiClient.cs.
+# You can make changes and tell OpenAPI Generator to ignore just this file by uncommenting the following line:
+#ApiClient.cs
+
+# You can match any string of characters against a directory, file or extension with a single asterisk (*):
+#foo/*/qux
+# The above matches foo/bar/qux and foo/baz/qux, but not foo/bar/baz/qux
+
+# You can recursively match patterns against a directory, file or extension with a double asterisk (**):
+#foo/**/qux
+# This matches foo/bar/qux, foo/baz/qux, and foo/bar/baz/qux
+
+# You can also negate patterns with an exclamation (!).
+# For example, you can ignore all files in a docs folder with the file extension .md:
+#docs/*.md
+# Then explicitly reverse the ignore rule for a single file:
+#!docs/README.md

package/generated/docs/Balance.md

@@ -0,0 +1,40 @@
+
+# Balance
+
+
+## Properties
+
+Name | Type
+------------ | -------------
+`currency` | string
+`total` | number
+`available` | number
+`locked` | number
+
+## Example
+
+```typescript
+import type { Balance } from 'pmxtjs'
+
+// TODO: Update the object below with actual values
+const example = {
+  "currency": null,
+  "total": null,
+  "available": null,
+  "locked": null,
+} satisfies Balance
+
+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 Balance
+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/BaseResponse.md

@@ -0,0 +1,36 @@
+
+# BaseResponse
+
+
+## Properties
+
+Name | Type
+------------ | -------------
+`success` | boolean
+`error` | [ErrorDetail](ErrorDetail.md)
+
+## Example
+
+```typescript
+import type { BaseResponse } from 'pmxtjs'
+
+// TODO: Update the object below with actual values
+const example = {
+  "success": true,
+  "error": null,
+} satisfies BaseResponse
+
+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 BaseResponse
+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/CancelOrderRequest.md

@@ -0,0 +1,34 @@
+
+# CancelOrderRequest
+
+
+## Properties
+
+Name | Type
+------------ | -------------
+`args` | Array<string>
+
+## Example
+
+```typescript
+import type { CancelOrderRequest } from 'pmxtjs'
+
+// TODO: Update the object below with actual values
+const example = {
+  "args": null,
+} satisfies CancelOrderRequest
+
+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 CancelOrderRequest
+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/CreateOrder200Response.md

@@ -0,0 +1,38 @@
+
+# CreateOrder200Response
+
+
+## Properties
+
+Name | Type
+------------ | -------------
+`success` | boolean
+`error` | [ErrorDetail](ErrorDetail.md)
+`data` | [Order](Order.md)
+
+## Example
+
+```typescript
+import type { CreateOrder200Response } from 'pmxtjs'
+
+// TODO: Update the object below with actual values
+const example = {
+  "success": true,
+  "error": null,
+  "data": null,
+} satisfies CreateOrder200Response
+
+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 CreateOrder200Response
+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/CreateOrderParams.md

@@ -0,0 +1,44 @@
+
+# CreateOrderParams
+
+
+## Properties
+
+Name | Type
+------------ | -------------
+`marketId` | string
+`outcomeId` | string
+`side` | string
+`type` | string
+`amount` | number
+`price` | number
+
+## Example
+
+```typescript
+import type { CreateOrderParams } from 'pmxtjs'
+
+// TODO: Update the object below with actual values
+const example = {
+  "marketId": null,
+  "outcomeId": null,
+  "side": null,
+  "type": null,
+  "amount": null,
+  "price": null,
+} satisfies CreateOrderParams
+
+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 CreateOrderParams
+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/CreateOrderRequest.md

@@ -0,0 +1,34 @@
+
+# CreateOrderRequest
+
+
+## Properties
+
+Name | Type
+------------ | -------------
+`args` | [Array<CreateOrderParams>](CreateOrderParams.md)
+
+## Example
+
+```typescript
+import type { CreateOrderRequest } from 'pmxtjs'
+
+// TODO: Update the object below with actual values
+const example = {
+  "args": null,
+} satisfies CreateOrderRequest
+
+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 CreateOrderRequest
+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)
+
+