@taphubhq/sdk-core 0.17.4 → 0.19.0

package/dist/index.cjs

@@ -420,6 +420,18 @@ var AuthModule = class {
 };
 
 // src/modules/bid/normalise.ts
+function parseMeta(raw) {
+  if (!raw) return null;
+  try {
+    const obj = JSON.parse(raw);
+    return {
+      userName: typeof obj.userName === "string" ? obj.userName : "",
+      pairName: typeof obj.pairName === "string" ? obj.pairName : ""
+    };
+  } catch {
+    return null;
+  }
+}
 var VALID_STATUSES = /* @__PURE__ */ new Set(["pending", "win", "lose", "cancelled"]);
 var PAST_TENSE_MAP = {
   won: "win",
@@ -442,7 +454,7 @@ function toWireStatus(status) {
   return SDK_TO_WIRE_STATUS[status];
 }
 function normaliseBid(node) {
-  if (typeof node.id !== "string" || node.id === "" || typeof node.user_id !== "string" || node.user_id === "" || typeof node.game_id !== "string" || node.game_id === "" || typeof node.status !== "string" || node.status === "") {
+  if (typeof node.id !== "string" || node.id === "" || typeof node.user_id !== "string" || node.user_id === "" || typeof node.pair_id !== "string" || node.pair_id === "" || typeof node.status !== "string" || node.status === "") {
     throw new TaphubServerError("Invalid response from server", {
       code: "InvalidResponse"
     });
@@ -450,7 +462,7 @@ function normaliseBid(node) {
   return {
     id: node.id,
     userId: node.user_id,
-    gameId: node.game_id,
+    pairId: node.pair_id,
     currency: node.currency,
     amount: node.amount,
     coefficient: node.coefficient,
@@ -461,7 +473,8 @@ function normaliseBid(node) {
     status: coerceStatus(node.status),
     payout: node.payout || null,
     slippage: node.slippage,
-    createdAt: node.created_at || null
+    createdAt: node.created_at || null,
+    meta: parseMeta(node.meta)
   };
 }
 function normaliseBids(list) {
@@ -476,17 +489,17 @@ function normaliseBids(list) {
 // src/modules/bid/queries.ts
 var PLACE_BID_MUTATION = `mutation PlaceBid($input: PlaceBidInput!) {
   placeBid(input: $input) {
-    id user_id game_id currency amount coefficient time1 time2 price1 price2 status payout slippage created_at
+    id user_id pair_id currency amount coefficient time1 time2 price1 price2 status payout slippage created_at meta
   }
 }`;
 var MY_BIDS_QUERY = `query MyBids($statuses: [BidStatus!], $limit: Int, $offset: Int, $pairId: ID) {
   myBids(statuses: $statuses, limit: $limit, offset: $offset, pairId: $pairId) {
-    id user_id game_id currency amount coefficient time1 time2 price1 price2 status payout slippage created_at
+    id user_id pair_id currency amount coefficient time1 time2 price1 price2 status payout slippage created_at meta
   }
 }`;
 var CANCEL_BID_MUTATION = `mutation CancelBid($input: CancelBidInput!) {
   cancelBid(input: $input) {
-    bid { id user_id game_id currency amount coefficient time1 time2 price1 price2 status cancelled payout slippage created_at }
+    bid { id user_id pair_id currency amount coefficient time1 time2 price1 price2 status cancelled payout slippage created_at meta }
     refund_amount
     new_balance
   }
@@ -722,17 +735,17 @@ var LocaleModule = class {
 
 // src/modules/pair/normalise.ts
 function normalisePair(node) {
-  if (typeof node.id !== "string" || node.id === "" || typeof node.pair !== "string" || node.pair === "" || typeof node.status !== "string" || node.status === "" || !node.config) {
+  if (typeof node.id !== "string" || node.id === "" || !node.pair || typeof node.pair.pair !== "string" || node.pair.pair === "" || typeof node.status !== "string" || node.status === "" || !node.config) {
     throw new TaphubServerError("Invalid response from server", {
       code: "InvalidResponse"
     });
   }
   return {
     id: node.id,
-    pair: node.pair,
+    pair: node.pair.pair,
     status: node.status,
     config: normaliseGameConfig(node.config),
-    createdAt: node.created_at || null
+    createdAt: node.createdAt || null
   };
 }
 function normaliseGameConfig(node) {
@@ -796,9 +809,9 @@ function normalisePairInfo(node) {
 }
 
 // src/modules/pair/queries.ts
-var PAIR_QUERY = `query Pair($pairId: ID!) {
-  pair(pairId: $pairId) {
-    id pair status created_at
+var PAIR_QUERY = `query AgencyPair($pairId: ID!) {
+  agencyPair(pairId: $pairId) {
+    id pair { id pair source thumb } status createdAt
     config {
       gridConfig { cellSizeTime cellSizeValue candleSize baseline baselineTime }
       constraints { minBetTime maxBetTime slippage priceMinRange priceMaxRange coefMults maxCoef }
@@ -845,13 +858,13 @@ var PairModule = class {
       }
       throw err;
     }
-    if (body.pair === null) {
+    if (body.agencyPair === null) {
       throw new TaphubValidationError("Game not found for pair", {
         code: "GameNotFound",
         details: { pairId }
       });
     }
-    return normalisePair(body.pair);
+    return normalisePair(body.agencyPair);
   }
   /**
    * Returns available game pairs, optionally filtered by gameplay.
@@ -901,7 +914,7 @@ function subKey(gameId, userId) {
 var GAME_SCOPED_SUFFIXES = ["config", "ideal_config"];
 var USER_SCOPED_SUFFIXES = ["bid_result", "balance_update"];
 var TOPIC_PREFIX = "game";
-var MARKET_TOPIC_PREFIX = "market";
+var MARKET_TOPIC_PREFIX = "public/market";
 var WALLET_TOPIC_PREFIX = "wallet";
 var PUBLIC_PREFIX = "public";
 function walletBalanceTopic(userId) {
@@ -1069,7 +1082,7 @@ function createMqttTransport(endpoint, opts = {}) {
       }
     },
     subscribeCandle(pairId, onCandle) {
-      const topic = `${PUBLIC_PREFIX}/${MARKET_TOPIC_PREFIX}/${pairId}/candle`;
+      const topic = `${MARKET_TOPIC_PREFIX}/${pairId}/candle`;
       if (candleSubscriptions.has(pairId)) return;
       const mqttClient = ensureConnected();
       candleSubscriptions.set(pairId, { topic, onCandle });

package/dist/index.d.mts

@@ -171,10 +171,22 @@ declare class AuthModule {
 }
 
 type BidStatus = 'pending' | 'win' | 'lose' | 'cancelled';
+/** Denormalised display data frozen onto the bid at placement time. */
+interface BidMeta {
+    /** Display name of the user who placed the bid. */
+    userName: string;
+    /** Display pair, e.g. "ETH/USD". */
+    pairName: string;
+}
 interface Bid {
     id: string;
     userId: string;
-    gameId: string;
+    /**
+     * Pair id, e.g. "grid-ETH-USD" (slash-free system id).
+     * Renamed from `gameId` in bid-260601 — the value is now the bare pair id,
+     * not the agency-scoped composite.
+     */
+    pairId: string;
     currency: string;
     amount: string;
     coefficient: string;
@@ -187,6 +199,12 @@ interface Bid {
     slippage: number;
     /** ISO-8601 string passthrough from the server. */
     createdAt: string | null;
+    /**
+     * Parsed display metadata. Null for bids placed before meta shipped, or when
+     * the server sends malformed/absent meta. Read `meta.pairName` for the
+     * display pair instead of mapping `pairId` yourself.
+     */
+    meta?: BidMeta | null;
 }
 interface CancelBidResult {
     bid: Bid;
@@ -449,7 +467,10 @@ interface MqttWireCandle {
 interface MqttWireAcceptedBid {
     id: string;
     userId: string;
+    /** @deprecated server now also sends `pairId`; both carry the bare pair id. */
     gameUuid: string;
+    /** Pair id, e.g. "grid-ETH-USD". */
+    pairId?: string;
     currency: string;
     amount: string;
     coefficient: number;

package/dist/index.d.ts

@@ -171,10 +171,22 @@ declare class AuthModule {
 }
 
 type BidStatus = 'pending' | 'win' | 'lose' | 'cancelled';
+/** Denormalised display data frozen onto the bid at placement time. */
+interface BidMeta {
+    /** Display name of the user who placed the bid. */
+    userName: string;
+    /** Display pair, e.g. "ETH/USD". */
+    pairName: string;
+}
 interface Bid {
     id: string;
     userId: string;
-    gameId: string;
+    /**
+     * Pair id, e.g. "grid-ETH-USD" (slash-free system id).
+     * Renamed from `gameId` in bid-260601 — the value is now the bare pair id,
+     * not the agency-scoped composite.
+     */
+    pairId: string;
     currency: string;
     amount: string;
     coefficient: string;
@@ -187,6 +199,12 @@ interface Bid {
     slippage: number;
     /** ISO-8601 string passthrough from the server. */
     createdAt: string | null;
+    /**
+     * Parsed display metadata. Null for bids placed before meta shipped, or when
+     * the server sends malformed/absent meta. Read `meta.pairName` for the
+     * display pair instead of mapping `pairId` yourself.
+     */
+    meta?: BidMeta | null;
 }
 interface CancelBidResult {
     bid: Bid;
@@ -449,7 +467,10 @@ interface MqttWireCandle {
 interface MqttWireAcceptedBid {
     id: string;
     userId: string;
+    /** @deprecated server now also sends `pairId`; both carry the bare pair id. */
     gameUuid: string;
+    /** Pair id, e.g. "grid-ETH-USD". */
+    pairId?: string;
     currency: string;
     amount: string;
     coefficient: number;

package/dist/index.js

@@ -355,6 +355,18 @@ var AuthModule = class {
 };
 
 // src/modules/bid/normalise.ts
+function parseMeta(raw) {
+  if (!raw) return null;
+  try {
+    const obj = JSON.parse(raw);
+    return {
+      userName: typeof obj.userName === "string" ? obj.userName : "",
+      pairName: typeof obj.pairName === "string" ? obj.pairName : ""
+    };
+  } catch {
+    return null;
+  }
+}
 var VALID_STATUSES = /* @__PURE__ */ new Set(["pending", "win", "lose", "cancelled"]);
 var PAST_TENSE_MAP = {
   won: "win",
@@ -377,7 +389,7 @@ function toWireStatus(status) {
   return SDK_TO_WIRE_STATUS[status];
 }
 function normaliseBid(node) {
-  if (typeof node.id !== "string" || node.id === "" || typeof node.user_id !== "string" || node.user_id === "" || typeof node.game_id !== "string" || node.game_id === "" || typeof node.status !== "string" || node.status === "") {
+  if (typeof node.id !== "string" || node.id === "" || typeof node.user_id !== "string" || node.user_id === "" || typeof node.pair_id !== "string" || node.pair_id === "" || typeof node.status !== "string" || node.status === "") {
     throw new TaphubServerError("Invalid response from server", {
       code: "InvalidResponse"
     });
@@ -385,7 +397,7 @@ function normaliseBid(node) {
   return {
     id: node.id,
     userId: node.user_id,
-    gameId: node.game_id,
+    pairId: node.pair_id,
     currency: node.currency,
     amount: node.amount,
     coefficient: node.coefficient,
@@ -396,7 +408,8 @@ function normaliseBid(node) {
     status: coerceStatus(node.status),
     payout: node.payout || null,
     slippage: node.slippage,
-    createdAt: node.created_at || null
+    createdAt: node.created_at || null,
+    meta: parseMeta(node.meta)
   };
 }
 function normaliseBids(list) {
@@ -411,17 +424,17 @@ function normaliseBids(list) {
 // src/modules/bid/queries.ts
 var PLACE_BID_MUTATION = `mutation PlaceBid($input: PlaceBidInput!) {
   placeBid(input: $input) {
-    id user_id game_id currency amount coefficient time1 time2 price1 price2 status payout slippage created_at
+    id user_id pair_id currency amount coefficient time1 time2 price1 price2 status payout slippage created_at meta
   }
 }`;
 var MY_BIDS_QUERY = `query MyBids($statuses: [BidStatus!], $limit: Int, $offset: Int, $pairId: ID) {
   myBids(statuses: $statuses, limit: $limit, offset: $offset, pairId: $pairId) {
-    id user_id game_id currency amount coefficient time1 time2 price1 price2 status payout slippage created_at
+    id user_id pair_id currency amount coefficient time1 time2 price1 price2 status payout slippage created_at meta
   }
 }`;
 var CANCEL_BID_MUTATION = `mutation CancelBid($input: CancelBidInput!) {
   cancelBid(input: $input) {
-    bid { id user_id game_id currency amount coefficient time1 time2 price1 price2 status cancelled payout slippage created_at }
+    bid { id user_id pair_id currency amount coefficient time1 time2 price1 price2 status cancelled payout slippage created_at meta }
     refund_amount
     new_balance
   }
@@ -657,17 +670,17 @@ var LocaleModule = class {
 
 // src/modules/pair/normalise.ts
 function normalisePair(node) {
-  if (typeof node.id !== "string" || node.id === "" || typeof node.pair !== "string" || node.pair === "" || typeof node.status !== "string" || node.status === "" || !node.config) {
+  if (typeof node.id !== "string" || node.id === "" || !node.pair || typeof node.pair.pair !== "string" || node.pair.pair === "" || typeof node.status !== "string" || node.status === "" || !node.config) {
     throw new TaphubServerError("Invalid response from server", {
       code: "InvalidResponse"
     });
   }
   return {
     id: node.id,
-    pair: node.pair,
+    pair: node.pair.pair,
     status: node.status,
     config: normaliseGameConfig(node.config),
-    createdAt: node.created_at || null
+    createdAt: node.createdAt || null
   };
 }
 function normaliseGameConfig(node) {
@@ -731,9 +744,9 @@ function normalisePairInfo(node) {
 }
 
 // src/modules/pair/queries.ts
-var PAIR_QUERY = `query Pair($pairId: ID!) {
-  pair(pairId: $pairId) {
-    id pair status created_at
+var PAIR_QUERY = `query AgencyPair($pairId: ID!) {
+  agencyPair(pairId: $pairId) {
+    id pair { id pair source thumb } status createdAt
     config {
       gridConfig { cellSizeTime cellSizeValue candleSize baseline baselineTime }
       constraints { minBetTime maxBetTime slippage priceMinRange priceMaxRange coefMults maxCoef }
@@ -780,13 +793,13 @@ var PairModule = class {
       }
       throw err;
     }
-    if (body.pair === null) {
+    if (body.agencyPair === null) {
       throw new TaphubValidationError("Game not found for pair", {
         code: "GameNotFound",
         details: { pairId }
       });
     }
-    return normalisePair(body.pair);
+    return normalisePair(body.agencyPair);
   }
   /**
    * Returns available game pairs, optionally filtered by gameplay.
@@ -836,7 +849,7 @@ function subKey(gameId, userId) {
 var GAME_SCOPED_SUFFIXES = ["config", "ideal_config"];
 var USER_SCOPED_SUFFIXES = ["bid_result", "balance_update"];
 var TOPIC_PREFIX = "game";
-var MARKET_TOPIC_PREFIX = "market";
+var MARKET_TOPIC_PREFIX = "public/market";
 var WALLET_TOPIC_PREFIX = "wallet";
 var PUBLIC_PREFIX = "public";
 function walletBalanceTopic(userId) {
@@ -1004,7 +1017,7 @@ function createMqttTransport(endpoint, opts = {}) {
       }
     },
     subscribeCandle(pairId, onCandle) {
-      const topic = `${PUBLIC_PREFIX}/${MARKET_TOPIC_PREFIX}/${pairId}/candle`;
+      const topic = `${MARKET_TOPIC_PREFIX}/${pairId}/candle`;
       if (candleSubscriptions.has(pairId)) return;
       const mqttClient = ensureConnected();
       candleSubscriptions.set(pairId, { topic, onCandle });

package/package.json

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