@taphubhq/sdk-core 0.15.2 → 0.16.0

package/dist/index.d.mts

@@ -222,7 +222,10 @@ declare class BidModule {
         signal?: AbortSignal;
     }): Promise<CancelBidResult>;
     listBids(opts?: {
+        /** @deprecated Use `statuses` instead. Folded into a one-element `statuses` list. */
         status?: BidStatus;
+        /** Include-semantics: return only bids whose status is in this list. */
+        statuses?: BidStatus[];
         limit?: number;
         offset?: number;
         gameId?: string;
@@ -230,97 +233,6 @@ declare class BidModule {
     }): Promise<Bid[]>;
 }
 
-interface Game {
-    id: string;
-    pair: string;
-    status: string;
-    config: GameConfig;
-    /** ISO-8601 string passthrough from the server. */
-    createdAt: string | null;
-}
-interface GameConfig {
-    gridConfig: GridConfig;
-    constraints: Constraints;
-    acceptableBids: number[];
-    minBidAmount: number;
-    maxBidAmount: number;
-}
-interface GridConfig {
-    cellSizeTime: number;
-    cellSizeValue: number;
-    candleSize: number;
-    baseline: number;
-    baselineTime: number;
-}
-interface Constraints {
-    minBetTime: number;
-    maxBetTime: number;
-    slippage: number;
-    priceMinRange: number;
-    priceMaxRange: number;
-    coefMults: number[];
-    maxCoef: number;
-}
-interface GamePairInfo {
-    /** game_pairs.id — catalog identifier for this pair within a gameplay. */
-    id: string;
-    /** Trading pair symbol, e.g. "BTC/USD". */
-    pair: string;
-    /** ID of the gameplay this pair belongs to. Use as `gameplaySlug` in game.get(). */
-    gameplayId: string;
-    /** Human-readable gameplay name. */
-    gameplayName: string;
-    /** Price feed source, e.g. "binance". */
-    source: string;
-    /**
-     * agency_game_pairs.id — the runtime game ID for this agency.
-     * Present only when the caller is authenticated with a valid JWT.
-     * Use directly as `gameId` in MQTT topic `game/{gameId}/candle`.
-     * Null when called without authentication.
-     */
-    gameId: string | null;
-}
-interface Candle {
-    /** Unix epoch SECONDS (not ms). Multiply by 1000 for JS Date. */
-    time: number;
-    o: number;
-    h: number;
-    l: number;
-    c: number;
-    volatility: number;
-    coefMults: number[];
-}
-
-interface GameModuleDeps {
-    graphql: GraphQLTransport;
-}
-declare class GameModule {
-    #private;
-    constructor(deps: GameModuleDeps);
-    get(pair: string, opts?: {
-        gameplaySlug?: string;
-        signal?: AbortSignal;
-    }): Promise<Game>;
-    /**
-     * Returns available game pairs, optionally filtered by gameplay.
-     *
-     * When called with a valid JWT (authenticated builder), each entry includes
-     * `gameId` — use it directly as the MQTT topic `game/{gameId}/candle`.
-     *
-     * @example
-     * const pairs = await client.game.availableGamePairs({ gameplayId: 'taptrading' });
-     * const game  = await client.game.get(pairs[0].pair, { gameplaySlug: pairs[0].gameplayId });
-     * const ch    = client.realtime?.subscribe(pairs[0].gameId ?? game.id, userId);
-     */
-    availableGamePairs(opts?: {
-        gameplayId?: string;
-        signal?: AbortSignal;
-    }): Promise<GamePairInfo[]>;
-    chartHistory(gameId: string, limit?: number, opts?: {
-        signal?: AbortSignal;
-    }): Promise<Candle[]>;
-}
-
 type LeaderboardPeriod = 'weekly' | 'all_time';
 type LeaderboardSortBy = 'gain' | 'wagered';
 interface LeaderboardEntry {
@@ -424,6 +336,97 @@ declare class LocaleModule {
     }): Promise<LocaleRefreshResult>;
 }
 
+interface Pair {
+    id: string;
+    pair: string;
+    status: string;
+    config: GameConfig;
+    /** ISO-8601 string passthrough from the server. */
+    createdAt: string | null;
+}
+interface GameConfig {
+    gridConfig: GridConfig;
+    constraints: Constraints;
+    acceptableBids: number[];
+    minBidAmount: number;
+    maxBidAmount: number;
+}
+interface GridConfig {
+    cellSizeTime: number;
+    cellSizeValue: number;
+    candleSize: number;
+    baseline: number;
+    baselineTime: number;
+}
+interface Constraints {
+    minBetTime: number;
+    maxBetTime: number;
+    slippage: number;
+    priceMinRange: number;
+    priceMaxRange: number;
+    coefMults: number[];
+    maxCoef: number;
+}
+interface PairInfo {
+    /** game_pairs.id — catalog identifier for this pair within a gameplay. */
+    id: string;
+    /** Trading pair symbol, e.g. "BTC/USD". */
+    pair: string;
+    /** ID of the gameplay this pair belongs to. Use as `gameplaySlug` in game.get(). */
+    gameplayId: string;
+    /** Human-readable gameplay name. */
+    gameplayName: string;
+    /** Price feed source, e.g. "binance". */
+    source: string;
+    /**
+     * agency_game_pairs.id — the runtime game ID for this agency.
+     * Present only when the caller is authenticated with a valid JWT.
+     * Use directly as `gameId` in MQTT topic `game/{gameId}/candle`.
+     * Null when called without authentication.
+     */
+    agencyPairId: string | null;
+}
+interface Candle {
+    /** Unix epoch SECONDS (not ms). Multiply by 1000 for JS Date. */
+    time: number;
+    o: number;
+    h: number;
+    l: number;
+    c: number;
+    volatility: number;
+    coefMults: number[];
+}
+
+interface PairModuleDeps {
+    graphql: GraphQLTransport;
+}
+declare class PairModule {
+    #private;
+    constructor(deps: PairModuleDeps);
+    get(pair: string, opts?: {
+        gameplaySlug?: string;
+        signal?: AbortSignal;
+    }): Promise<Pair>;
+    /**
+     * Returns available game pairs, optionally filtered by gameplay.
+     *
+     * When called with a valid JWT (authenticated builder), each entry includes
+     * `gameId` — use it directly as the MQTT topic `game/{gameId}/candle`.
+     *
+     * @example
+     * const pairs = await client.pair.availableGamePairs({ gameplayId: 'taptrading' });
+     * const game  = await client.pair.get(pairs[0].pair, { gameplaySlug: pairs[0].gameplayId });
+     * const ch    = client.realtime?.subscribe(pairs[0].agencyPairId ?? game.id, userId);
+     */
+    availableGamePairs(opts?: {
+        gameplayId?: string;
+        signal?: AbortSignal;
+    }): Promise<PairInfo[]>;
+    chartHistory(agencyPairId: string, limit?: number, opts?: {
+        signal?: AbortSignal;
+    }): Promise<Candle[]>;
+}
+
 interface MqttWireCandle {
     type: 'new' | 'update';
     time: number;
@@ -888,8 +891,8 @@ declare class TaphubClient {
     user: UserModule;
     /** @readonly Auth module — reassignment has no effect at runtime. */
     auth: AuthModule;
-    /** @readonly Game module — reassignment has no effect at runtime. */
-    game: GameModule;
+    /** @readonly Pair module — reassignment has no effect at runtime. */
+    pair: PairModule;
     /** @readonly Bid module — reassignment has no effect at runtime. */
     bid: BidModule;
     /** @readonly Leaderboard module — reassignment has no effect at runtime. */
@@ -985,4 +988,4 @@ declare function adaptiveSimpson(f: (x: number) => number, a: number, b: number,
 declare function calculateProbWin(time1: number, time2: number, _price1: number, price2: number, creationTime: number, currentPrice: number, volatility: number): number;
 declare function calculateProbWin_v2(time1: number, time2: number, _price1: number, price2: number, creationTime: number, currentPrice: number, volatility: number): number;
 
-export { type AgencyPairFilter, AgencyPairModule, type AgencyPairStats, type AgencyPairStatus, AuthModule, type BackendHealth, type Bid, BidModule, type BidStatus, type CancelBidResult, type Candle, type Constraints, type Currency, type Game, GameChannel, type GameConfig, GameModule, type GamePairInfo, type GridConfig, type LeaderboardEntry, LeaderboardModule, type LeaderboardPeriod, type LeaderboardSortBy, LocaleModule, type LocaleRefreshResult, type LocaleResponse, type LocaleTranslations, type LoginResult, type Me, type MqttAcceptedBid, type MqttAgencyPairStatsEvent, type MqttBalanceEvent, type MqttBidAcceptedEvent, type MqttBidLostEvent, type MqttBidWonEvent, type MqttCandleEvent, type MqttConfigEvent, type MqttIdealConfigEvent, type MqttWalletBalanceEvent, type NetworkLevel, type NetworkQuality, NetworkQualityMonitor, type PlaceBidInput, RealtimeModule, type Sample, type SampleReason, type SignalSource, TaphubAuthError, TaphubClient, type TaphubClientConfig, TaphubError, TaphubEventBus, type TaphubEventMap, TaphubNetworkError, TaphubServerError, TaphubSlippageError, TaphubStorage, type TaphubStorageAdapter, TaphubValidationError, type User, UserModule, type UserPnL, type UserPnLPeriod, type Wallet as UserWallet, type Wallet$1 as Wallet, type WalletBalanceReason, WalletChannel, adaptiveSimpson, autoDetectStorage, calculateProbWin, calculateProbWin_v2, errorFunction, isCancelled, isLoss, isPending, isTerminal, isWin, normalCDF, normalPDF };
+export { type AgencyPairFilter, AgencyPairModule, type AgencyPairStats, type AgencyPairStatus, AuthModule, type BackendHealth, type Bid, BidModule, type BidStatus, type CancelBidResult, type Candle, type Constraints, type Currency, GameChannel, type GameConfig, type GridConfig, type LeaderboardEntry, LeaderboardModule, type LeaderboardPeriod, type LeaderboardSortBy, LocaleModule, type LocaleRefreshResult, type LocaleResponse, type LocaleTranslations, type LoginResult, type Me, type MqttAcceptedBid, type MqttAgencyPairStatsEvent, type MqttBalanceEvent, type MqttBidAcceptedEvent, type MqttBidLostEvent, type MqttBidWonEvent, type MqttCandleEvent, type MqttConfigEvent, type MqttIdealConfigEvent, type MqttWalletBalanceEvent, type NetworkLevel, type NetworkQuality, NetworkQualityMonitor, type Pair, type PairInfo, PairModule, type PlaceBidInput, RealtimeModule, type Sample, type SampleReason, type SignalSource, TaphubAuthError, TaphubClient, type TaphubClientConfig, TaphubError, TaphubEventBus, type TaphubEventMap, TaphubNetworkError, TaphubServerError, TaphubSlippageError, TaphubStorage, type TaphubStorageAdapter, TaphubValidationError, type User, UserModule, type UserPnL, type UserPnLPeriod, type Wallet as UserWallet, type Wallet$1 as Wallet, type WalletBalanceReason, WalletChannel, adaptiveSimpson, autoDetectStorage, calculateProbWin, calculateProbWin_v2, errorFunction, isCancelled, isLoss, isPending, isTerminal, isWin, normalCDF, normalPDF };

package/dist/index.d.ts

@@ -222,7 +222,10 @@ declare class BidModule {
         signal?: AbortSignal;
     }): Promise<CancelBidResult>;
     listBids(opts?: {
+        /** @deprecated Use `statuses` instead. Folded into a one-element `statuses` list. */
         status?: BidStatus;
+        /** Include-semantics: return only bids whose status is in this list. */
+        statuses?: BidStatus[];
         limit?: number;
         offset?: number;
         gameId?: string;
@@ -230,97 +233,6 @@ declare class BidModule {
     }): Promise<Bid[]>;
 }
 
-interface Game {
-    id: string;
-    pair: string;
-    status: string;
-    config: GameConfig;
-    /** ISO-8601 string passthrough from the server. */
-    createdAt: string | null;
-}
-interface GameConfig {
-    gridConfig: GridConfig;
-    constraints: Constraints;
-    acceptableBids: number[];
-    minBidAmount: number;
-    maxBidAmount: number;
-}
-interface GridConfig {
-    cellSizeTime: number;
-    cellSizeValue: number;
-    candleSize: number;
-    baseline: number;
-    baselineTime: number;
-}
-interface Constraints {
-    minBetTime: number;
-    maxBetTime: number;
-    slippage: number;
-    priceMinRange: number;
-    priceMaxRange: number;
-    coefMults: number[];
-    maxCoef: number;
-}
-interface GamePairInfo {
-    /** game_pairs.id — catalog identifier for this pair within a gameplay. */
-    id: string;
-    /** Trading pair symbol, e.g. "BTC/USD". */
-    pair: string;
-    /** ID of the gameplay this pair belongs to. Use as `gameplaySlug` in game.get(). */
-    gameplayId: string;
-    /** Human-readable gameplay name. */
-    gameplayName: string;
-    /** Price feed source, e.g. "binance". */
-    source: string;
-    /**
-     * agency_game_pairs.id — the runtime game ID for this agency.
-     * Present only when the caller is authenticated with a valid JWT.
-     * Use directly as `gameId` in MQTT topic `game/{gameId}/candle`.
-     * Null when called without authentication.
-     */
-    gameId: string | null;
-}
-interface Candle {
-    /** Unix epoch SECONDS (not ms). Multiply by 1000 for JS Date. */
-    time: number;
-    o: number;
-    h: number;
-    l: number;
-    c: number;
-    volatility: number;
-    coefMults: number[];
-}
-
-interface GameModuleDeps {
-    graphql: GraphQLTransport;
-}
-declare class GameModule {
-    #private;
-    constructor(deps: GameModuleDeps);
-    get(pair: string, opts?: {
-        gameplaySlug?: string;
-        signal?: AbortSignal;
-    }): Promise<Game>;
-    /**
-     * Returns available game pairs, optionally filtered by gameplay.
-     *
-     * When called with a valid JWT (authenticated builder), each entry includes
-     * `gameId` — use it directly as the MQTT topic `game/{gameId}/candle`.
-     *
-     * @example
-     * const pairs = await client.game.availableGamePairs({ gameplayId: 'taptrading' });
-     * const game  = await client.game.get(pairs[0].pair, { gameplaySlug: pairs[0].gameplayId });
-     * const ch    = client.realtime?.subscribe(pairs[0].gameId ?? game.id, userId);
-     */
-    availableGamePairs(opts?: {
-        gameplayId?: string;
-        signal?: AbortSignal;
-    }): Promise<GamePairInfo[]>;
-    chartHistory(gameId: string, limit?: number, opts?: {
-        signal?: AbortSignal;
-    }): Promise<Candle[]>;
-}
-
 type LeaderboardPeriod = 'weekly' | 'all_time';
 type LeaderboardSortBy = 'gain' | 'wagered';
 interface LeaderboardEntry {
@@ -424,6 +336,97 @@ declare class LocaleModule {
     }): Promise<LocaleRefreshResult>;
 }
 
+interface Pair {
+    id: string;
+    pair: string;
+    status: string;
+    config: GameConfig;
+    /** ISO-8601 string passthrough from the server. */
+    createdAt: string | null;
+}
+interface GameConfig {
+    gridConfig: GridConfig;
+    constraints: Constraints;
+    acceptableBids: number[];
+    minBidAmount: number;
+    maxBidAmount: number;
+}
+interface GridConfig {
+    cellSizeTime: number;
+    cellSizeValue: number;
+    candleSize: number;
+    baseline: number;
+    baselineTime: number;
+}
+interface Constraints {
+    minBetTime: number;
+    maxBetTime: number;
+    slippage: number;
+    priceMinRange: number;
+    priceMaxRange: number;
+    coefMults: number[];
+    maxCoef: number;
+}
+interface PairInfo {
+    /** game_pairs.id — catalog identifier for this pair within a gameplay. */
+    id: string;
+    /** Trading pair symbol, e.g. "BTC/USD". */
+    pair: string;
+    /** ID of the gameplay this pair belongs to. Use as `gameplaySlug` in game.get(). */
+    gameplayId: string;
+    /** Human-readable gameplay name. */
+    gameplayName: string;
+    /** Price feed source, e.g. "binance". */
+    source: string;
+    /**
+     * agency_game_pairs.id — the runtime game ID for this agency.
+     * Present only when the caller is authenticated with a valid JWT.
+     * Use directly as `gameId` in MQTT topic `game/{gameId}/candle`.
+     * Null when called without authentication.
+     */
+    agencyPairId: string | null;
+}
+interface Candle {
+    /** Unix epoch SECONDS (not ms). Multiply by 1000 for JS Date. */
+    time: number;
+    o: number;
+    h: number;
+    l: number;
+    c: number;
+    volatility: number;
+    coefMults: number[];
+}
+
+interface PairModuleDeps {
+    graphql: GraphQLTransport;
+}
+declare class PairModule {
+    #private;
+    constructor(deps: PairModuleDeps);
+    get(pair: string, opts?: {
+        gameplaySlug?: string;
+        signal?: AbortSignal;
+    }): Promise<Pair>;
+    /**
+     * Returns available game pairs, optionally filtered by gameplay.
+     *
+     * When called with a valid JWT (authenticated builder), each entry includes
+     * `gameId` — use it directly as the MQTT topic `game/{gameId}/candle`.
+     *
+     * @example
+     * const pairs = await client.pair.availableGamePairs({ gameplayId: 'taptrading' });
+     * const game  = await client.pair.get(pairs[0].pair, { gameplaySlug: pairs[0].gameplayId });
+     * const ch    = client.realtime?.subscribe(pairs[0].agencyPairId ?? game.id, userId);
+     */
+    availableGamePairs(opts?: {
+        gameplayId?: string;
+        signal?: AbortSignal;
+    }): Promise<PairInfo[]>;
+    chartHistory(agencyPairId: string, limit?: number, opts?: {
+        signal?: AbortSignal;
+    }): Promise<Candle[]>;
+}
+
 interface MqttWireCandle {
     type: 'new' | 'update';
     time: number;
@@ -888,8 +891,8 @@ declare class TaphubClient {
     user: UserModule;
     /** @readonly Auth module — reassignment has no effect at runtime. */
     auth: AuthModule;
-    /** @readonly Game module — reassignment has no effect at runtime. */
-    game: GameModule;
+    /** @readonly Pair module — reassignment has no effect at runtime. */
+    pair: PairModule;
     /** @readonly Bid module — reassignment has no effect at runtime. */
     bid: BidModule;
     /** @readonly Leaderboard module — reassignment has no effect at runtime. */
@@ -985,4 +988,4 @@ declare function adaptiveSimpson(f: (x: number) => number, a: number, b: number,
 declare function calculateProbWin(time1: number, time2: number, _price1: number, price2: number, creationTime: number, currentPrice: number, volatility: number): number;
 declare function calculateProbWin_v2(time1: number, time2: number, _price1: number, price2: number, creationTime: number, currentPrice: number, volatility: number): number;
 
-export { type AgencyPairFilter, AgencyPairModule, type AgencyPairStats, type AgencyPairStatus, AuthModule, type BackendHealth, type Bid, BidModule, type BidStatus, type CancelBidResult, type Candle, type Constraints, type Currency, type Game, GameChannel, type GameConfig, GameModule, type GamePairInfo, type GridConfig, type LeaderboardEntry, LeaderboardModule, type LeaderboardPeriod, type LeaderboardSortBy, LocaleModule, type LocaleRefreshResult, type LocaleResponse, type LocaleTranslations, type LoginResult, type Me, type MqttAcceptedBid, type MqttAgencyPairStatsEvent, type MqttBalanceEvent, type MqttBidAcceptedEvent, type MqttBidLostEvent, type MqttBidWonEvent, type MqttCandleEvent, type MqttConfigEvent, type MqttIdealConfigEvent, type MqttWalletBalanceEvent, type NetworkLevel, type NetworkQuality, NetworkQualityMonitor, type PlaceBidInput, RealtimeModule, type Sample, type SampleReason, type SignalSource, TaphubAuthError, TaphubClient, type TaphubClientConfig, TaphubError, TaphubEventBus, type TaphubEventMap, TaphubNetworkError, TaphubServerError, TaphubSlippageError, TaphubStorage, type TaphubStorageAdapter, TaphubValidationError, type User, UserModule, type UserPnL, type UserPnLPeriod, type Wallet as UserWallet, type Wallet$1 as Wallet, type WalletBalanceReason, WalletChannel, adaptiveSimpson, autoDetectStorage, calculateProbWin, calculateProbWin_v2, errorFunction, isCancelled, isLoss, isPending, isTerminal, isWin, normalCDF, normalPDF };
+export { type AgencyPairFilter, AgencyPairModule, type AgencyPairStats, type AgencyPairStatus, AuthModule, type BackendHealth, type Bid, BidModule, type BidStatus, type CancelBidResult, type Candle, type Constraints, type Currency, GameChannel, type GameConfig, type GridConfig, type LeaderboardEntry, LeaderboardModule, type LeaderboardPeriod, type LeaderboardSortBy, LocaleModule, type LocaleRefreshResult, type LocaleResponse, type LocaleTranslations, type LoginResult, type Me, type MqttAcceptedBid, type MqttAgencyPairStatsEvent, type MqttBalanceEvent, type MqttBidAcceptedEvent, type MqttBidLostEvent, type MqttBidWonEvent, type MqttCandleEvent, type MqttConfigEvent, type MqttIdealConfigEvent, type MqttWalletBalanceEvent, type NetworkLevel, type NetworkQuality, NetworkQualityMonitor, type Pair, type PairInfo, PairModule, type PlaceBidInput, RealtimeModule, type Sample, type SampleReason, type SignalSource, TaphubAuthError, TaphubClient, type TaphubClientConfig, TaphubError, TaphubEventBus, type TaphubEventMap, TaphubNetworkError, TaphubServerError, TaphubSlippageError, TaphubStorage, type TaphubStorageAdapter, TaphubValidationError, type User, UserModule, type UserPnL, type UserPnLPeriod, type Wallet as UserWallet, type Wallet$1 as Wallet, type WalletBalanceReason, WalletChannel, adaptiveSimpson, autoDetectStorage, calculateProbWin, calculateProbWin_v2, errorFunction, isCancelled, isLoss, isPending, isTerminal, isWin, normalCDF, normalPDF };