pmxtjs 2.34.2 → 2.35.0

package/dist/pmxt/models.d.ts

@@ -155,6 +155,17 @@ export interface PaginatedMarketsResult {
     /** Cursor for the next page (pass to fetchMarketsPaginated) */
     nextCursor?: string;
 }
+/**
+ * Result of a paginated event fetch.
+ */
+export interface PaginatedEventsResult {
+    /** The events for this page */
+    data: UnifiedEvent[];
+    /** Total number of events (if available) */
+    total?: number;
+    /** Cursor for the next page (pass to fetchEventsPaginated) */
+    nextCursor?: string;
+}
 /**
  * A historical trade.
  */

package/dist/pmxt/server-manager.js

@@ -341,11 +341,25 @@ class ServerManager {
         if (info && info.pid) {
             try {
                 process.kill(info.pid, 'SIGTERM');
-                // Brief wait
                 await new Promise(resolve => setTimeout(resolve, 500));
             }
             catch {
-                // Ignore
+                // Process already dead — fall through to lock cleanup
+            }
+            // Verify the process is actually dead; escalate to SIGKILL if not
+            try {
+                process.kill(info.pid, 0); // throws if dead
+                // Still alive — force kill
+                try {
+                    process.kill(info.pid, 'SIGKILL');
+                    await new Promise(resolve => setTimeout(resolve, 200));
+                }
+                catch {
+                    // Ignore — SIGKILL may race with natural exit
+                }
+            }
+            catch {
+                // Process is dead — good
             }
         }
         // Remove lock file (best effort)

package/generated/.openapi-generator/FILES

@@ -34,6 +34,7 @@ docs/FetchEvent200Response.md
 docs/FetchEventMatches200Response.md
 docs/FetchEventMatchesParams.md
 docs/FetchEvents200Response.md
+docs/FetchEventsPaginated200Response.md
 docs/FetchMarket200Response.md
 docs/FetchMarketMatches200Response.md
 docs/FetchMarketMatchesParams.md
@@ -74,6 +75,7 @@ docs/Order.md
 docs/OrderBook.md
 docs/OrderHistoryParams.md
 docs/OrderLevel.md
+docs/PaginatedEventsResult.md
 docs/PaginatedMarketsResult.md
 docs/Position.md
 docs/PriceCandle.md
@@ -127,6 +129,7 @@ src/models/FetchEvent200Response.ts
 src/models/FetchEventMatches200Response.ts
 src/models/FetchEventMatchesParams.ts
 src/models/FetchEvents200Response.ts
+src/models/FetchEventsPaginated200Response.ts
 src/models/FetchMarket200Response.ts
 src/models/FetchMarketMatches200Response.ts
 src/models/FetchMarketMatchesParams.ts
@@ -167,6 +170,7 @@ src/models/Order.ts
 src/models/OrderBook.ts
 src/models/OrderHistoryParams.ts
 src/models/OrderLevel.ts
+src/models/PaginatedEventsResult.ts
 src/models/PaginatedMarketsResult.ts
 src/models/Position.ts
 src/models/PriceCandle.ts

package/generated/docs/DefaultApi.md

@@ -16,6 +16,7 @@ All URIs are relative to *http://localhost:3847*
 | [**fetchEvent**](DefaultApi.md#fetchevent) | **GET** /api/{exchange}/fetchEvent | Fetch Event |
 | [**fetchEventMatches**](DefaultApi.md#fetcheventmatches) | **GET** /api/{exchange}/fetchEventMatches | Find Similar Events |
 | [**fetchEvents**](DefaultApi.md#fetchevents) | **GET** /api/{exchange}/fetchEvents | Fetch Events |
+| [**fetchEventsPaginated**](DefaultApi.md#fetcheventspaginated) | **GET** /api/{exchange}/fetchEventsPaginated | Fetch Events Paginated |
 | [**fetchHedges**](DefaultApi.md#fetchhedges) | **GET** /api/{exchange}/fetchHedges | Find Hedging Opportunities |
 | [**fetchMarket**](DefaultApi.md#fetchmarket) | **GET** /api/{exchange}/fetchMarket | Fetch Market |
 | [**fetchMarketMatches**](DefaultApi.md#fetchmarketmatches) | **GET** /api/{exchange}/fetchMarketMatches | Find Similar Markets |
@@ -991,6 +992,82 @@ 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)
 
 
+## fetchEventsPaginated
+
+> FetchEventsPaginated200Response fetchEventsPaginated(exchange, limit, cursor, filter)
+
+Fetch Events Paginated
+
+Paginated variant of {@link fetchEvents}. On the first call (no `cursor`), all events are fetched from the exchange and cached in an in-memory snapshot. A cursor is returned along with the first page. Subsequent calls with that cursor serve additional pages directly from the cached snapshot -- no additional API calls are made. The snapshot is invalidated after `snapshotTTL` ms (configured via `ExchangeOptions` in the constructor). A request using a cursor from an expired snapshot throws `\'Cursor has expired\'`.
+
+### Example
+
+```ts
+import {
+  Configuration,
+  DefaultApi,
+} from 'pmxtjs';
+import type { FetchEventsPaginatedRequest } from 'pmxtjs';
+
+async function example() {
+  console.log("🚀 Testing pmxtjs SDK...");
+  const api = new DefaultApi();
+
+  const body = {
+    // 'polymarket' | 'kalshi' | 'kalshi-demo' | 'limitless' | 'probable' | 'baozi' | 'myriad' | 'opinion' | 'metaculus' | 'smarkets' | 'polymarket_us' | 'router' | The prediction market exchange to target.
+    exchange: exchange_example,
+    // number (optional)
+    limit: 8.14,
+    // string (optional)
+    cursor: cursor_example,
+    // EventFilterCriteria (optional)
+    filter: ...,
+  } satisfies FetchEventsPaginatedRequest;
+
+  try {
+    const data = await api.fetchEventsPaginated(body);
+    console.log(data);
+  } catch (error) {
+    console.error(error);
+  }
+}
+
+// Run the test
+example().catch(console.error);
+```
+
+### Parameters
+
+
+| Name | Type | Description  | Notes |
+|------------- | ------------- | ------------- | -------------|
+| **exchange** | `polymarket`, `kalshi`, `kalshi-demo`, `limitless`, `probable`, `baozi`, `myriad`, `opinion`, `metaculus`, `smarkets`, `polymarket_us`, `router` | The prediction market exchange to target. | [Defaults to `undefined`] [Enum: polymarket, kalshi, kalshi-demo, limitless, probable, baozi, myriad, opinion, metaculus, smarkets, polymarket_us, router] |
+| **limit** | `number` |  | [Optional] [Defaults to `undefined`] |
+| **cursor** | `string` |  | [Optional] [Defaults to `undefined`] |
+| **filter** | [](.md) |  | [Optional] [Defaults to `undefined`] |
+
+### Return type
+
+[**FetchEventsPaginated200Response**](FetchEventsPaginated200Response.md)
+
+### Authorization
+
+No authorization required
+
+### HTTP request headers
+
+- **Content-Type**: Not defined
+- **Accept**: `application/json`
+
+
+### HTTP response details
+| Status code | Description | Response headers |
+|-------------|-------------|------------------|
+| **200** | Fetch Events Paginated response |  -  |
+
+[[Back to top]](#) [[Back to API list]](../README.md#api-endpoints) [[Back to Model list]](../README.md#models) [[Back to README]](../README.md)
+
+
 ## fetchHedges
 
 > CompareMarketPrices200Response fetchHedges(exchange, market, marketId, slug, url, relation, minConfidence, limit, includePrices)

package/generated/docs/FetchEventsPaginated200Response.md

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

@@ -0,0 +1,39 @@
+
+# PaginatedEventsResult
+
+Shape returned by fetchEventsPaginated
+
+## Properties
+
+Name | Type
+------------ | -------------
+`data` | [Array<UnifiedEvent>](UnifiedEvent.md)
+`total` | number
+`nextCursor` | string
+
+## Example
+
+```typescript
+import type { PaginatedEventsResult } from 'pmxtjs'
+
+// TODO: Update the object below with actual values
+const example = {
+  "data": null,
+  "total": null,
+  "nextCursor": null,
+} satisfies PaginatedEventsResult
+
+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 PaginatedEventsResult
+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": "2.34.2",
+  "version": "2.35.0",
   "description": "OpenAPI client for pmxtjs",
   "author": "OpenAPI-Generator",
   "repository": {

package/generated/src/apis/DefaultApi.ts

@@ -30,6 +30,7 @@ import type {
   FetchEvent200Response,
   FetchEventMatches200Response,
   FetchEvents200Response,
+  FetchEventsPaginated200Response,
   FetchMarket200Response,
   FetchMarketMatches200Response,
   FetchMarkets200Response,
@@ -91,6 +92,8 @@ import {
     FetchEventMatches200ResponseToJSON,
     FetchEvents200ResponseFromJSON,
     FetchEvents200ResponseToJSON,
+    FetchEventsPaginated200ResponseFromJSON,
+    FetchEventsPaginated200ResponseToJSON,
     FetchMarket200ResponseFromJSON,
     FetchMarket200ResponseToJSON,
     FetchMarketMatches200ResponseFromJSON,
@@ -248,6 +251,13 @@ export interface FetchEventsRequest {
     tags?: Array<string>;
 }
 
+export interface FetchEventsPaginatedRequest {
+    exchange: FetchEventsPaginatedExchangeEnum;
+    limit?: number;
+    cursor?: string;
+    filter?: EventFilterCriteria;
+}
+
 export interface FetchHedgesRequest {
     exchange: FetchHedgesExchangeEnum;
     market?: UnifiedMarket;
@@ -1085,6 +1095,57 @@ export class DefaultApi extends runtime.BaseAPI {
         return await response.value();
     }
 
+    /**
+     * Paginated variant of {@link fetchEvents}. On the first call (no `cursor`), all events are fetched from the exchange and cached in an in-memory snapshot. A cursor is returned along with the first page. Subsequent calls with that cursor serve additional pages directly from the cached snapshot -- no additional API calls are made. The snapshot is invalidated after `snapshotTTL` ms (configured via `ExchangeOptions` in the constructor). A request using a cursor from an expired snapshot throws `\'Cursor has expired\'`.
+     * Fetch Events Paginated
+     */
+    async fetchEventsPaginatedRaw(requestParameters: FetchEventsPaginatedRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<FetchEventsPaginated200Response>> {
+        if (requestParameters['exchange'] == null) {
+            throw new runtime.RequiredError(
+                'exchange',
+                'Required parameter "exchange" was null or undefined when calling fetchEventsPaginated().'
+            );
+        }
+
+        const queryParameters: any = {};
+
+        if (requestParameters['limit'] != null) {
+            queryParameters['limit'] = requestParameters['limit'];
+        }
+
+        if (requestParameters['cursor'] != null) {
+            queryParameters['cursor'] = requestParameters['cursor'];
+        }
+
+        if (requestParameters['filter'] != null) {
+            queryParameters['filter'] = requestParameters['filter'];
+        }
+
+        const headerParameters: runtime.HTTPHeaders = {};
+
+
+        let urlPath = `/api/{exchange}/fetchEventsPaginated`;
+        urlPath = urlPath.replace(`{${"exchange"}}`, encodeURIComponent(String(requestParameters['exchange'])));
+
+        const response = await this.request({
+            path: urlPath,
+            method: 'GET',
+            headers: headerParameters,
+            query: queryParameters,
+        }, initOverrides);
+
+        return new runtime.JSONApiResponse(response, (jsonValue) => FetchEventsPaginated200ResponseFromJSON(jsonValue));
+    }
+
+    /**
+     * Paginated variant of {@link fetchEvents}. On the first call (no `cursor`), all events are fetched from the exchange and cached in an in-memory snapshot. A cursor is returned along with the first page. Subsequent calls with that cursor serve additional pages directly from the cached snapshot -- no additional API calls are made. The snapshot is invalidated after `snapshotTTL` ms (configured via `ExchangeOptions` in the constructor). A request using a cursor from an expired snapshot throws `\'Cursor has expired\'`.
+     * Fetch Events Paginated
+     */
+    async fetchEventsPaginated(requestParameters: FetchEventsPaginatedRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<FetchEventsPaginated200Response> {
+        const response = await this.fetchEventsPaginatedRaw(requestParameters, initOverrides);
+        return await response.value();
+    }
+
     /**
      * Find hedging opportunities across venues. Discovers subset/superset market relationships where one market\'s outcome implies another, enabling cross-venue hedging strategies with live prices.
      * Find Hedging Opportunities
@@ -2685,6 +2746,24 @@ export const FetchEventsSearchInEnum = {
     Both: 'both'
 } as const;
 export type FetchEventsSearchInEnum = typeof FetchEventsSearchInEnum[keyof typeof FetchEventsSearchInEnum];
+/**
+ * @export
+ */
+export const FetchEventsPaginatedExchangeEnum = {
+    Polymarket: 'polymarket',
+    Kalshi: 'kalshi',
+    KalshiDemo: 'kalshi-demo',
+    Limitless: 'limitless',
+    Probable: 'probable',
+    Baozi: 'baozi',
+    Myriad: 'myriad',
+    Opinion: 'opinion',
+    Metaculus: 'metaculus',
+    Smarkets: 'smarkets',
+    PolymarketUs: 'polymarket_us',
+    Router: 'router'
+} as const;
+export type FetchEventsPaginatedExchangeEnum = typeof FetchEventsPaginatedExchangeEnum[keyof typeof FetchEventsPaginatedExchangeEnum];
 /**
  * @export
  */

package/generated/src/models/FetchEventsPaginated200Response.ts

@@ -0,0 +1,96 @@
+/* tslint:disable */
+/* eslint-disable */
+/**
+ * PMXT Sidecar API
+ * A unified local sidecar API for prediction markets (Polymarket, Kalshi, Limitless). 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 { ErrorDetail } from './ErrorDetail';
+import {
+    ErrorDetailFromJSON,
+    ErrorDetailFromJSONTyped,
+    ErrorDetailToJSON,
+    ErrorDetailToJSONTyped,
+} from './ErrorDetail';
+import type { PaginatedEventsResult } from './PaginatedEventsResult';
+import {
+    PaginatedEventsResultFromJSON,
+    PaginatedEventsResultFromJSONTyped,
+    PaginatedEventsResultToJSON,
+    PaginatedEventsResultToJSONTyped,
+} from './PaginatedEventsResult';
+
+/**
+ * 
+ * @export
+ * @interface FetchEventsPaginated200Response
+ */
+export interface FetchEventsPaginated200Response {
+    /**
+     * 
+     * @type {boolean}
+     * @memberof FetchEventsPaginated200Response
+     */
+    success?: boolean;
+    /**
+     * 
+     * @type {ErrorDetail}
+     * @memberof FetchEventsPaginated200Response
+     */
+    error?: ErrorDetail;
+    /**
+     * 
+     * @type {PaginatedEventsResult}
+     * @memberof FetchEventsPaginated200Response
+     */
+    data?: PaginatedEventsResult;
+}
+
+/**
+ * Check if a given object implements the FetchEventsPaginated200Response interface.
+ */
+export function instanceOfFetchEventsPaginated200Response(value: object): value is FetchEventsPaginated200Response {
+    return true;
+}
+
+export function FetchEventsPaginated200ResponseFromJSON(json: any): FetchEventsPaginated200Response {
+    return FetchEventsPaginated200ResponseFromJSONTyped(json, false);
+}
+
+export function FetchEventsPaginated200ResponseFromJSONTyped(json: any, ignoreDiscriminator: boolean): FetchEventsPaginated200Response {
+    if (json == null) {
+        return json;
+    }
+    return {
+        
+        'success': json['success'] == null ? undefined : json['success'],
+        'error': json['error'] == null ? undefined : ErrorDetailFromJSON(json['error']),
+        'data': json['data'] == null ? undefined : PaginatedEventsResultFromJSON(json['data']),
+    };
+}
+
+export function FetchEventsPaginated200ResponseToJSON(json: any): FetchEventsPaginated200Response {
+    return FetchEventsPaginated200ResponseToJSONTyped(json, false);
+}
+
+export function FetchEventsPaginated200ResponseToJSONTyped(value?: FetchEventsPaginated200Response | null, ignoreDiscriminator: boolean = false): any {
+    if (value == null) {
+        return value;
+    }
+
+    return {
+        
+        'success': value['success'],
+        'error': ErrorDetailToJSON(value['error']),
+        'data': PaginatedEventsResultToJSON(value['data']),
+    };
+}
+

package/generated/src/models/PaginatedEventsResult.ts

@@ -0,0 +1,91 @@
+/* tslint:disable */
+/* eslint-disable */
+/**
+ * PMXT Sidecar API
+ * A unified local sidecar API for prediction markets (Polymarket, Kalshi, Limitless). 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 { UnifiedEvent } from './UnifiedEvent';
+import {
+    UnifiedEventFromJSON,
+    UnifiedEventFromJSONTyped,
+    UnifiedEventToJSON,
+    UnifiedEventToJSONTyped,
+} from './UnifiedEvent';
+
+/**
+ * Shape returned by fetchEventsPaginated
+ * @export
+ * @interface PaginatedEventsResult
+ */
+export interface PaginatedEventsResult {
+    /**
+     * The page of unified events
+     * @type {Array<UnifiedEvent>}
+     * @memberof PaginatedEventsResult
+     */
+    data: Array<UnifiedEvent>;
+    /**
+     * Total number of events in the snapshot
+     * @type {number}
+     * @memberof PaginatedEventsResult
+     */
+    total: number;
+    /**
+     * Cursor to pass to the next call, or undefined if this is the last page
+     * @type {string}
+     * @memberof PaginatedEventsResult
+     */
+    nextCursor?: string;
+}
+
+/**
+ * Check if a given object implements the PaginatedEventsResult interface.
+ */
+export function instanceOfPaginatedEventsResult(value: object): value is PaginatedEventsResult {
+    if (!('data' in value) || value['data'] === undefined) return false;
+    if (!('total' in value) || value['total'] === undefined) return false;
+    return true;
+}
+
+export function PaginatedEventsResultFromJSON(json: any): PaginatedEventsResult {
+    return PaginatedEventsResultFromJSONTyped(json, false);
+}
+
+export function PaginatedEventsResultFromJSONTyped(json: any, ignoreDiscriminator: boolean): PaginatedEventsResult {
+    if (json == null) {
+        return json;
+    }
+    return {
+        
+        'data': ((json['data'] as Array<any>).map(UnifiedEventFromJSON)),
+        'total': json['total'],
+        'nextCursor': json['nextCursor'] == null ? undefined : json['nextCursor'],
+    };
+}
+
+export function PaginatedEventsResultToJSON(json: any): PaginatedEventsResult {
+    return PaginatedEventsResultToJSONTyped(json, false);
+}
+
+export function PaginatedEventsResultToJSONTyped(value?: PaginatedEventsResult | null, ignoreDiscriminator: boolean = false): any {
+    if (value == null) {
+        return value;
+    }
+
+    return {
+        
+        'data': ((value['data'] as Array<any>).map(UnifiedEventToJSON)),
+        'total': value['total'],
+        'nextCursor': value['nextCursor'],
+    };
+}
+

package/generated/src/models/index.ts

@@ -31,6 +31,7 @@ export * from './FetchEvent200Response';
 export * from './FetchEventMatches200Response';
 export * from './FetchEventMatchesParams';
 export * from './FetchEvents200Response';
+export * from './FetchEventsPaginated200Response';
 export * from './FetchMarket200Response';
 export * from './FetchMarketMatches200Response';
 export * from './FetchMarketMatchesParams';
@@ -71,6 +72,7 @@ export * from './Order';
 export * from './OrderBook';
 export * from './OrderHistoryParams';
 export * from './OrderLevel';
+export * from './PaginatedEventsResult';
 export * from './PaginatedMarketsResult';
 export * from './Position';
 export * from './PriceCandle';

package/package.json

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