@taphubhq/sdk-core 0.15.0 → 0.15.1

package/dist/index.cjs

@@ -1398,11 +1398,30 @@ function normaliseMyWalletByCurrencyResponse(body) {
   }
   return normaliseWalletNode(body.myWalletByCurrency);
 }
+function normaliseUserPnL(node) {
+  if (!node) {
+    throw new TaphubServerError("Invalid response from server", {
+      code: "InvalidResponse"
+    });
+  }
+  return {
+    gain: node.gain,
+    totalWagered: node.total_wagered,
+    totalPayout: node.total_payout,
+    totalBids: node.total_bids,
+    totalWins: node.total_wins
+  };
+}
 
 // src/modules/user/queries.ts
 var ME_QUERY = "query Me { me { id username wallet_address balance is_demo } }";
 var MY_WALLETS_QUERY = "query MyWallets { myWallets { id amount currency isEnable } }";
 var MY_WALLET_BY_CURRENCY_QUERY = "query MyWalletByCurrency($currency: String!) { myWalletByCurrency(currency: $currency) { id amount currency isEnable } }";
+var USER_PNL_QUERY = `query UserPnL($period: String) {
+  userPnL(period: $period) {
+    gain total_wagered total_payout total_bids total_wins
+  }
+}`;
 
 // src/modules/user/index.ts
 var UserModule = class {
@@ -1419,6 +1438,20 @@ var UserModule = class {
     const body = await this.#graphql.request(ME_QUERY);
     return normaliseMeResponse(body);
   }
+  /**
+   * Fetch the authenticated user's realized PnL (grid-api).
+   * `period` defaults to 'all_time' ('weekly' also accepted). Agency scope is
+   * resolved server-side from the JWT — never passed from the client.
+   */
+  async pnl(args) {
+    const period = args?.period ?? "all_time";
+    const body = await this.#graphql.request(
+      USER_PNL_QUERY,
+      { period },
+      args?.signal ? { signal: args.signal } : void 0
+    );
+    return normaliseUserPnL(body.userPnL);
+  }
   async wallets(opts) {
     const body = await this.#graphqlUser.request(
       MY_WALLETS_QUERY,

package/dist/index.d.mts

@@ -701,6 +701,19 @@ interface Wallet {
     currency: string;
     isEnable: boolean;
 }
+type UserPnLPeriod = 'weekly' | 'all_time';
+/**
+ * Public, normalised PnL shape (camelCase). The wire shape is the codegen'd
+ * `UserPnL` from `@/types/gql/grid`; `normaliseUserPnL` maps wire → this.
+ */
+interface UserPnL {
+    /** Realized PnL: totalPayout − totalWagered. Decimal string. */
+    gain: string;
+    totalWagered: string;
+    totalPayout: string;
+    totalBids: number;
+    totalWins: number;
+}
 
 interface UserModuleDeps {
     rest: RestTransport;
@@ -714,6 +727,15 @@ declare class UserModule {
     #private;
     constructor(deps: UserModuleDeps);
     me(): Promise<Me>;
+    /**
+     * Fetch the authenticated user's realized PnL (grid-api).
+     * `period` defaults to 'all_time' ('weekly' also accepted). Agency scope is
+     * resolved server-side from the JWT — never passed from the client.
+     */
+    pnl(args?: {
+        period?: UserPnLPeriod;
+        signal?: AbortSignal;
+    }): Promise<UserPnL>;
     wallets(opts?: RequestOpts): Promise<Wallet[]>;
     walletByCurrency(currency: string, opts?: RequestOpts): Promise<Wallet>;
     get currencies(): Currency[] | null;
@@ -879,4 +901,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 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 Wallet as UserWallet, type Wallet$1 as Wallet, 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, 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 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, adaptiveSimpson, autoDetectStorage, calculateProbWin, calculateProbWin_v2, errorFunction, isCancelled, isLoss, isPending, isTerminal, isWin, normalCDF, normalPDF };

package/dist/index.d.ts

@@ -701,6 +701,19 @@ interface Wallet {
     currency: string;
     isEnable: boolean;
 }
+type UserPnLPeriod = 'weekly' | 'all_time';
+/**
+ * Public, normalised PnL shape (camelCase). The wire shape is the codegen'd
+ * `UserPnL` from `@/types/gql/grid`; `normaliseUserPnL` maps wire → this.
+ */
+interface UserPnL {
+    /** Realized PnL: totalPayout − totalWagered. Decimal string. */
+    gain: string;
+    totalWagered: string;
+    totalPayout: string;
+    totalBids: number;
+    totalWins: number;
+}
 
 interface UserModuleDeps {
     rest: RestTransport;
@@ -714,6 +727,15 @@ declare class UserModule {
     #private;
     constructor(deps: UserModuleDeps);
     me(): Promise<Me>;
+    /**
+     * Fetch the authenticated user's realized PnL (grid-api).
+     * `period` defaults to 'all_time' ('weekly' also accepted). Agency scope is
+     * resolved server-side from the JWT — never passed from the client.
+     */
+    pnl(args?: {
+        period?: UserPnLPeriod;
+        signal?: AbortSignal;
+    }): Promise<UserPnL>;
     wallets(opts?: RequestOpts): Promise<Wallet[]>;
     walletByCurrency(currency: string, opts?: RequestOpts): Promise<Wallet>;
     get currencies(): Currency[] | null;
@@ -879,4 +901,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 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 Wallet as UserWallet, type Wallet$1 as Wallet, 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, 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 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, adaptiveSimpson, autoDetectStorage, calculateProbWin, calculateProbWin_v2, errorFunction, isCancelled, isLoss, isPending, isTerminal, isWin, normalCDF, normalPDF };

package/dist/index.js

@@ -1333,11 +1333,30 @@ function normaliseMyWalletByCurrencyResponse(body) {
   }
   return normaliseWalletNode(body.myWalletByCurrency);
 }
+function normaliseUserPnL(node) {
+  if (!node) {
+    throw new TaphubServerError("Invalid response from server", {
+      code: "InvalidResponse"
+    });
+  }
+  return {
+    gain: node.gain,
+    totalWagered: node.total_wagered,
+    totalPayout: node.total_payout,
+    totalBids: node.total_bids,
+    totalWins: node.total_wins
+  };
+}
 
 // src/modules/user/queries.ts
 var ME_QUERY = "query Me { me { id username wallet_address balance is_demo } }";
 var MY_WALLETS_QUERY = "query MyWallets { myWallets { id amount currency isEnable } }";
 var MY_WALLET_BY_CURRENCY_QUERY = "query MyWalletByCurrency($currency: String!) { myWalletByCurrency(currency: $currency) { id amount currency isEnable } }";
+var USER_PNL_QUERY = `query UserPnL($period: String) {
+  userPnL(period: $period) {
+    gain total_wagered total_payout total_bids total_wins
+  }
+}`;
 
 // src/modules/user/index.ts
 var UserModule = class {
@@ -1354,6 +1373,20 @@ var UserModule = class {
     const body = await this.#graphql.request(ME_QUERY);
     return normaliseMeResponse(body);
   }
+  /**
+   * Fetch the authenticated user's realized PnL (grid-api).
+   * `period` defaults to 'all_time' ('weekly' also accepted). Agency scope is
+   * resolved server-side from the JWT — never passed from the client.
+   */
+  async pnl(args) {
+    const period = args?.period ?? "all_time";
+    const body = await this.#graphql.request(
+      USER_PNL_QUERY,
+      { period },
+      args?.signal ? { signal: args.signal } : void 0
+    );
+    return normaliseUserPnL(body.userPnL);
+  }
   async wallets(opts) {
     const body = await this.#graphqlUser.request(
       MY_WALLETS_QUERY,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@taphubhq/sdk-core",
-  "version": "0.15.0",
+  "version": "0.15.1",
   "description": "Core SDK for building on the TabHub platform",
   "license": "MIT",
   "main": "./dist/index.cjs",