@liberfi.io/ui-predict 0.1.75 → 0.1.77

package/dist/client-Doli88ls.d.ts

@@ -1,420 +0,0 @@
-/**
- * V2 types for the prediction-server REST API (/api/v1/events).
- *
- * These types are intentionally isolated from the legacy client types so that
- * the v1 (DFlow) and v2 (prediction-server) clients can coexist and be migrated
- * incrementally.
- *
- * Mirrors: github.com/liberfi-io/prediction-server/internal/domain
- */
-/** Upstream data provider that produced a domain object. */
-type V2ProviderSource = "dflow" | "polymarket";
-/**
- * Provider-specific metadata attached to every domain aggregate.
- * Keys are namespaced field paths, e.g. "polymarket.conditionId" or "dflow.yesMint".
- * Values are raw JSON-decoded values.
- */
-type V2ProviderMeta = Record<string, unknown>;
-/** Provider-sourced label attached to an Event. */
-interface V2Tag {
-    slug: string;
-    label: string;
-    source: V2ProviderSource;
-    provider_meta?: V2ProviderMeta;
-}
-/** Lifecycle status of a prediction event (normalised across all providers). */
-type V2EventStatus = "pending" | "open" | "closed" | "voided";
-/** Settlement / resolution data source for an event. */
-interface V2SettlementSource {
-    url: string;
-    name?: string;
-}
-/** Root aggregate for a prediction event from the prediction-server API. */
-interface V2Event {
-    /** Internal database surrogate key (absent when not yet persisted). */
-    id?: number;
-    /**
-     * Canonical business key shared across all providers.
-     * - DFlow:      ticker (e.g. "KXBTCD-25FEB-T68000")
-     * - Polymarket: slug   (e.g. "will-trump-win-2024")
-     */
-    slug: string;
-    title: string;
-    subtitle?: string;
-    description?: string;
-    image_url?: string;
-    status: V2EventStatus;
-    /** ISO 8601 timestamp; absent if the provider does not supply it. */
-    start_at?: string;
-    end_at?: string;
-    created_at?: string;
-    updated_at?: string;
-    /** Provider-sourced labels for display only. */
-    tags?: V2Tag[];
-    /** All values are USD amounts. */
-    volume?: number;
-    volume_24h?: number;
-    liquidity?: number;
-    open_interest?: number;
-    settlement_sources?: V2SettlementSource[];
-    /** Nested markets; omitted when the request used `with_markets=false`. */
-    markets?: V2Market[];
-    source: V2ProviderSource;
-    provider_meta?: V2ProviderMeta;
-}
-/** Lifecycle status of a prediction market (normalised across all providers). */
-type V2MarketStatus = "pending" | "open" | "closed" | "voided";
-/** Final resolution of a closed market. Empty string means unresolved. */
-type V2MarketResult = "yes" | "no" | "voided" | "";
-/** One possible outcome in a binary (or multi-outcome) prediction market. */
-interface V2Outcome {
-    /** Display name, e.g. "Yes" or "No". */
-    label: string;
-    /** Current implied probability [0, 1]. */
-    price?: number;
-    best_bid?: number;
-    best_ask?: number;
-}
-/** Tradeable prediction outcome within an Event. */
-interface V2Market {
-    id?: number;
-    event_id?: number;
-    slug: string;
-    event_slug: string;
-    question: string;
-    description?: string;
-    image_url?: string;
-    /** Resolution/settlement rules in order. */
-    rules?: string[];
-    status: V2MarketStatus;
-    result?: V2MarketResult;
-    start_at?: string;
-    end_at?: string;
-    expires_at?: string;
-    created_at?: string;
-    updated_at?: string;
-    /** Always present; binary markets have exactly 2 outcomes (YES at [0], NO at [1]). */
-    outcomes: V2Outcome[];
-    volume?: number;
-    volume_24h?: number;
-    liquidity?: number;
-    open_interest?: number;
-    source: V2ProviderSource;
-    provider_meta?: V2ProviderMeta;
-}
-/** Generic paginated result set returned by the prediction-server list endpoints. */
-interface V2Page<T> {
-    items: T[];
-    next_cursor?: string;
-    has_more?: boolean;
-    limit?: number;
-    /** Not all backends support total count. */
-    total?: number;
-}
-/** Valid sort fields accepted by `GET /api/v1/events`. */
-type V2EventSortField = "volume" | "volume_24h" | "liquidity" | "open_interest" | "end_at" | "start_at" | "created_at";
-/** Query parameters for `listEvents`. All fields are optional. */
-interface V2ListEventsParams {
-    /** Page size. Server default: 20. */
-    limit?: number;
-    /** Opaque pagination cursor returned by the previous page's `next_cursor`. */
-    cursor?: string;
-    /** Filter by event lifecycle status. */
-    status?: V2EventStatus;
-    /** Filter by upstream provider. */
-    source?: V2ProviderSource;
-    /** Unified navigation tag slug (e.g. "politics", "sports"). */
-    tag_slug?: string;
-    /** Full-text search query. */
-    search?: string;
-    /** Field to sort by. */
-    sort_by?: V2EventSortField;
-    /** When `true`, sort ascending. Defaults to descending. */
-    sort_asc?: boolean;
-    /**
-     * When `false`, markets are omitted from each event for lighter payloads.
-     * Defaults to `true` on the server.
-     */
-    with_markets?: boolean;
-}
-/** Single price level in an order book. */
-interface V2OrderbookOrder {
-    price: number;
-    size: number;
-}
-/** Aggregated order book for a market. */
-interface V2Orderbook {
-    market_id: string;
-    /** Sorted by price descending. */
-    bids: V2OrderbookOrder[];
-    /** Sorted by price ascending. */
-    asks: V2OrderbookOrder[];
-    /** best_ask − best_bid; absent when either side is empty. */
-    spread?: number;
-}
-/** On-chain trade type. */
-type V2TradeType = "TRADE" | "SPLIT" | "MERGE" | "REDEEM" | "REWARD" | "CONVERSION" | "MAKER_REBATE" | "REFERRAL_REWARD";
-/** Lightweight event summary embedded in a trade. */
-interface V2EventSummary {
-    slug: string;
-    title: string;
-    image_url?: string;
-    status: V2EventStatus;
-}
-/** Lightweight market summary embedded in a trade. */
-interface V2MarketSummary {
-    slug: string;
-    question: string;
-    status: V2MarketStatus;
-}
-/** A single trade record. */
-interface V2Trade {
-    id: string;
-    source: V2ProviderSource;
-    side: string;
-    outcome: string;
-    outcome_index: number;
-    price: number;
-    size: number;
-    usd_size: number;
-    /** Unix seconds. */
-    timestamp: number;
-    tx_hash: string;
-    wallet: string;
-    type: V2TradeType;
-    event?: V2EventSummary;
-    market?: V2MarketSummary;
-    provider_meta?: V2ProviderMeta;
-}
-/** Query parameters for `GET /api/v1/markets/{slug}/trades`. */
-interface V2ListMarketTradesParams {
-    source: V2ProviderSource;
-    limit?: number;
-    cursor?: string;
-    /** Filter by side: `"BUY"` or `"SELL"`. */
-    side?: string;
-}
-/** Query parameters for `GET /api/v1/trades` (by wallet). */
-interface V2ListTradesByWalletParams {
-    source: V2ProviderSource;
-    wallet: string;
-    limit?: number;
-    cursor?: string;
-    /** Comma-separated trade types. */
-    type?: string;
-    side?: string;
-}
-/** A single price-history data point. */
-interface V2PricePoint {
-    /** Unix seconds. */
-    t: number;
-    /** Price [0, 1]. */
-    p: number;
-}
-/** Response from `GET /api/v1/markets/{slug}/price-history`. */
-interface V2PriceHistoryResponse {
-    points: V2PricePoint[];
-}
-/** Accepted values for the `range` query parameter. */
-type V2PriceHistoryRange = "1d" | "1w" | "1m" | "all";
-/** OHLCV candlestick data point. */
-interface V2Candlestick {
-    timestamp: string;
-    open: number;
-    high: number;
-    low: number;
-    close: number;
-    volume: number;
-}
-/** Query parameters for `GET /api/v1/markets/{slug}/candlesticks`. */
-interface V2ListCandlesticksParams {
-    /** Candle interval (e.g. `"1m"`, `"5m"`, `"1h"`, `"1d"`). Default: `"1h"`. */
-    interval?: string;
-    /** Number of candles. Default: 100. */
-    limit?: number;
-}
-/** Query parameters for `GET /api/v1/events/{slug}/similar`. */
-interface V2SimilarEventsParams {
-    /** Number of results (default 5, max 20). */
-    limit?: number;
-    /** When true, only return events from the same provider. */
-    same_source?: boolean;
-}
-/** A single user position in a prediction market. */
-interface V2Position {
-    source: V2ProviderSource;
-    side: string;
-    size: number;
-    avg_price: number;
-    current_price: number;
-    current_value: number;
-    initial_value: number;
-    pnl: number;
-    pnl_percent: number;
-    realized_pnl: number;
-    redeemable: boolean;
-    event?: V2Event;
-    market?: V2Market;
-    provider_meta?: V2ProviderMeta;
-}
-/** Response from `GET /api/v1/positions`. */
-interface V2PositionsResponse {
-    user: string;
-    positions: V2Position[];
-}
-/** Lifecycle status of a user order. */
-type V2UserOrderStatus = "live" | "matched" | "cancelled" | "invalid" | "submitted" | "pending" | "open" | "pending_close" | "closed" | "failed" | "expired";
-/** Order direction. */
-type V2OrderSide = "BUY" | "SELL";
-/** A single user order record. */
-interface V2UserOrder {
-    id: string;
-    source: V2ProviderSource;
-    status: V2UserOrderStatus;
-    market_id?: string;
-    asset_id?: string;
-    side: V2OrderSide;
-    outcome?: string;
-    price?: string;
-    original_size?: string;
-    size_matched?: string;
-    in_amount?: string;
-    out_amount?: string;
-    order_type?: string;
-    /** Unix seconds. */
-    created_at?: number;
-    expires_at?: number;
-    provider_meta?: V2ProviderMeta;
-}
-/** Query parameters for `GET /api/v1/orders`. */
-interface V2ListOrdersParams {
-    source: V2ProviderSource;
-    wallet_address?: string;
-    market_id?: string;
-    asset_id?: string;
-    next_cursor?: string;
-}
-/** Result of `DELETE /api/v1/orders/{id}`. */
-interface V2CancelOrderResult {
-    cancelled: string[];
-    not_cancelled: Record<string, string>;
-}
-/** Request body for `POST /api/v1/orders/dflow/quote`. */
-interface V2DFlowQuoteRequest {
-    inputMint: string;
-    outputMint: string;
-    amount: string;
-    userPublicKey: string;
-    slippageBps?: number;
-}
-/** Raw upstream response from DFlow quote (transparent passthrough). */
-type V2DFlowQuoteResponse = Record<string, unknown>;
-/** Context stored alongside a DFlow order for later enrichment. */
-interface V2DFlowOrderContext {
-    user_public_key: string;
-    input_mint: string;
-    output_mint: string;
-    amount: string;
-    price: string;
-    side: string;
-    outcome: string;
-    market_slug: string;
-    slippage_bps: number;
-}
-/** Request body for `POST /api/v1/orders/dflow/submit`. */
-interface V2DFlowSubmitRequest {
-    signedTransaction: string;
-    orderContext: V2DFlowOrderContext;
-}
-/** Response from `POST /api/v1/orders/dflow/submit`. */
-interface V2DFlowSubmitResponse {
-    signature: string;
-    status: V2UserOrderStatus;
-}
-
-/**
- * HTTP client for the prediction-server REST API (v2 / prediction-server backend).
- *
- * Covers `GET /api/v1/events` (listEvents), `GET /api/v1/events/:slug` (getEvent),
- * and `GET /api/v1/markets/:slug` (getMarket).
- *
- * This client is intentionally decoupled from the legacy `DflowPredictClient` so
- * that both can be used in parallel during the incremental migration from the old
- * DFlow-direct integration to the unified prediction-server backend.
- *
- * @example
- * ```ts
- * const client = new PredictClientV2("https://api.example.com");
- * const page = await client.listEvents({ status: "open", limit: 20 });
- * const event = await client.getEvent("will-trump-win-2024");
- * const market = await client.getMarket("will-trump-win-2024-yes");
- * ```
- */
-declare class PredictClientV2 {
-    private readonly endpoint;
-    constructor(endpoint: string);
-    /**
-     * List prediction events with optional filtering, sorting, and pagination.
-     *
-     * Maps to `GET /api/v1/events`.
-     *
-     * @param params - Optional query parameters (filter, sort, pagination).
-     * @returns A paginated page of events.
-     */
-    listEvents(params?: V2ListEventsParams): Promise<V2Page<V2Event>>;
-    /**
-     * Fetch a single prediction event by its slug.
-     *
-     * Maps to `GET /api/v1/events/:slug?source=...`.
-     *
-     * @param slug - Canonical event slug (e.g. "will-trump-win-2024" for Polymarket
-     *               or "KXBTCD-25FEB-T68000" for DFlow).
-     * @param source - Upstream provider (`"dflow"` or `"polymarket"`).
-     * @returns The matching event.
-     * @throws When the server responds with 404 or any other non-2xx status.
-     */
-    getEvent(slug: string, source?: V2ProviderSource): Promise<V2Event>;
-    /**
-     * Fetch a single prediction market by its slug.
-     *
-     * Maps to `GET /api/v1/markets/:slug?source=...`.
-     *
-     * @param slug - Canonical market slug.
-     * @param source - Upstream provider (`"dflow"` or `"polymarket"`).
-     * @returns The matching market.
-     * @throws When the server responds with 404 or any other non-2xx status.
-     */
-    getMarket(slug: string, source?: V2ProviderSource): Promise<V2Market>;
-    /** Maps to `GET /api/v1/markets/:slug/orderbook?source=...`. */
-    getOrderbook(slug: string, source: V2ProviderSource): Promise<V2Orderbook>;
-    /** Maps to `GET /api/v1/markets/:slug/trades?source=...`. */
-    listMarketTrades(slug: string, params: V2ListMarketTradesParams): Promise<V2Page<V2Trade>>;
-    /** Maps to `GET /api/v1/markets/:slug/price-history?source=...&range=...`. */
-    getPriceHistory(slug: string, source: V2ProviderSource, range?: V2PriceHistoryRange): Promise<V2PriceHistoryResponse>;
-    /** Maps to `GET /api/v1/markets/:slug/candlesticks?interval=...&limit=...`. */
-    listCandlesticks(slug: string, params?: V2ListCandlesticksParams): Promise<V2Candlestick[]>;
-    /** Maps to `GET /api/v1/events/:slug/similar?source=...`. */
-    getSimilarEvents(slug: string, source: V2ProviderSource, params?: V2SimilarEventsParams): Promise<V2Event[]>;
-    /** Maps to `GET /api/v1/positions?source=...&user=...`. */
-    getPositions(source: V2ProviderSource, user: string): Promise<V2PositionsResponse>;
-    /** Maps to `GET /api/v1/orders?source=...&wallet_address=...`. */
-    listOrders(params: V2ListOrdersParams): Promise<V2Page<V2UserOrder>>;
-    /** Maps to `GET /api/v1/orders/:id?source=...`. */
-    getOrder(id: string, source: V2ProviderSource): Promise<V2UserOrder>;
-    /** Maps to `DELETE /api/v1/orders/:id?source=...`. */
-    cancelOrder(id: string, source: V2ProviderSource): Promise<V2CancelOrderResult>;
-    /** Maps to `POST /api/v1/orders/dflow/quote`. */
-    createDFlowQuote(body: V2DFlowQuoteRequest): Promise<V2DFlowQuoteResponse>;
-    /** Maps to `POST /api/v1/orders/dflow/submit`. */
-    submitDFlowTransaction(body: V2DFlowSubmitRequest): Promise<V2DFlowSubmitResponse>;
-    /** Maps to `GET /api/v1/trades?source=...&wallet=...`. */
-    listTradesByWallet(params: V2ListTradesByWalletParams): Promise<V2Page<V2Trade>>;
-}
-/**
- * Factory function for `PredictClientV2`.
- *
- * @param endpoint - Base URL of the prediction-server, without a trailing slash.
- */
-declare function createPredictClientV2(endpoint: string): PredictClientV2;
-
-export { type V2Outcome as A, type V2ProviderMeta as B, type V2SettlementSource as C, type V2Tag as D, PredictClientV2 as P, type V2EventSortField as V, type V2ProviderSource as a, type V2Event as b, type V2Market as c, type V2EventStatus as d, type V2Page as e, type V2ListEventsParams as f, type V2SimilarEventsParams as g, type V2Orderbook as h, type V2ListMarketTradesParams as i, type V2Trade as j, type V2PriceHistoryRange as k, type V2PriceHistoryResponse as l, type V2ListCandlesticksParams as m, type V2Candlestick as n, type V2PositionsResponse as o, type V2ListOrdersParams as p, type V2UserOrder as q, type V2CancelOrderResult as r, type V2DFlowQuoteRequest as s, type V2DFlowQuoteResponse as t, type V2DFlowSubmitResponse as u, type V2DFlowSubmitRequest as v, type V2ListTradesByWalletParams as w, createPredictClientV2 as x, type V2MarketResult as y, type V2MarketStatus as z };