@taphubhq/sdk-core 0.15.2 → 0.16.0

package/dist/index.js

@@ -366,6 +366,15 @@ function coerceStatus(raw) {
   console.warn(`Unknown bid status "${raw}", defaulting to "pending"`);
   return "pending";
 }
+var SDK_TO_WIRE_STATUS = {
+  pending: "pending",
+  win: "won",
+  lose: "lost",
+  cancelled: "cancelled"
+};
+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 === "") {
     throw new TaphubServerError("Invalid response from server", {
@@ -404,8 +413,8 @@ var PLACE_BID_MUTATION = `mutation PlaceBid($input: PlaceBidInput!) {
     id user_id game_id currency amount coefficient time1 time2 price1 price2 status payout slippage created_at
   }
 }`;
-var MY_BIDS_QUERY = `query MyBids($status: String, $limit: Int, $offset: Int, $gameId: ID) {
-  myBids(status: $status, limit: $limit, offset: $offset, gameId: $gameId) {
+var MY_BIDS_QUERY = `query MyBids($statuses: [BidStatus!], $limit: Int, $offset: Int, $gameId: ID) {
+  myBids(statuses: $statuses, limit: $limit, offset: $offset, gameId: $gameId) {
     id user_id game_id currency amount coefficient time1 time2 price1 price2 status payout slippage created_at
   }
 }`;
@@ -478,8 +487,9 @@ var BidModule = class {
   }
   async listBids(opts) {
     const variables = {};
-    if (opts?.status !== void 0) {
-      variables.status = opts.status;
+    const statusList = opts?.statuses ?? (opts?.status !== void 0 ? [opts.status] : void 0);
+    if (statusList !== void 0 && statusList.length > 0) {
+      variables.statuses = statusList.map(toWireStatus);
     }
     if (opts?.limit !== void 0) {
       variables.limit = opts.limit;
@@ -499,8 +509,151 @@ var BidModule = class {
   }
 };
 
-// src/modules/game/normalise.ts
-function normaliseGame(node) {
+// src/modules/leaderboard/normalise.ts
+function normaliseLeaderboard(rows) {
+  if (!Array.isArray(rows)) {
+    throw new TaphubServerError("Invalid response from server", {
+      code: "InvalidResponse"
+    });
+  }
+  return rows.map((row) => ({
+    userId: row.user_id,
+    username: row.username,
+    rank: row.rank,
+    totalBids: row.total_bids,
+    totalWins: row.total_wins,
+    totalWagered: row.total_wagered,
+    totalPayout: row.total_payout,
+    gain: row.gain
+  }));
+}
+
+// src/modules/leaderboard/queries.ts
+var LEADERBOARD_QUERY = `query Leaderboard($period: String!, $sort_by: String!) {
+  leaderboard(period: $period, sort_by: $sort_by) {
+    user_id username rank total_bids total_wins total_wagered total_payout gain
+  }
+}`;
+
+// src/modules/leaderboard/index.ts
+var LeaderboardModule = class {
+  #graphql;
+  constructor(deps) {
+    this.#graphql = deps.graphql;
+  }
+  async list(args) {
+    const body = await this.#graphql.request(
+      LEADERBOARD_QUERY,
+      { period: args.period, sort_by: args.sortBy },
+      args.signal ? { signal: args.signal } : void 0
+    );
+    return normaliseLeaderboard(body.leaderboard);
+  }
+};
+
+// src/modules/locale/normalise.ts
+function normaliseLocaleResponse(node) {
+  let translations = null;
+  if (node.translations !== null) {
+    try {
+      translations = JSON.parse(node.translations);
+    } catch (err) {
+      throw new TaphubValidationError("Malformed translations JSON string from backend", {
+        code: "InvalidLocaleResponse",
+        details: {
+          lang: node.lang,
+          version: node.version,
+          parseError: err instanceof Error ? err.message : String(err)
+        }
+      });
+    }
+  }
+  return {
+    lang: node.lang,
+    version: node.version,
+    notModified: node.notModified,
+    translations
+  };
+}
+function normaliseRefreshLocalesPayload(node) {
+  let versions;
+  try {
+    versions = JSON.parse(node.versions);
+  } catch (err) {
+    throw new TaphubValidationError("Malformed versions JSON string from backend", {
+      code: "InvalidRefreshLocalesPayload",
+      details: {
+        parseError: err instanceof Error ? err.message : String(err)
+      }
+    });
+  }
+  return {
+    refreshed: node.refreshed,
+    versions
+  };
+}
+
+// src/modules/locale/queries.ts
+var LOCALES_QUERY = `query Locales($input: LocalesInput!) {
+  locales(input: $input) {
+    lang
+    version
+    notModified
+    translations
+  }
+}`;
+var REFRESH_LOCALES_MUTATION = `mutation RefreshLocales {
+  refreshLocales {
+    refreshed
+    versions
+  }
+}`;
+
+// src/modules/locale/index.ts
+var LocaleModule = class {
+  #graphql;
+  constructor(deps) {
+    this.#graphql = deps.graphql;
+  }
+  /**
+   * Fetch translations for a single language.
+   *
+   * Pass the last-seen `version` as `knownVersion` to opt into not-modified
+   * short-circuit semantics: backend returns `{notModified: true, translations: null}`
+   * when the cached body still matches, and the caller keeps prior state.
+   *
+   * Errors surface as TaphubError subclasses with `extensions.code` codes from
+   * the backend (e.g. `LangNotSupported`, `InsufficientUpstream`, `FeatureDisabled`).
+   * Caller decides the fallback strategy.
+   */
+  async get(lang, knownVersion, opts) {
+    const input = { lang };
+    if (knownVersion !== void 0 && knownVersion !== "") {
+      input.knownVersion = knownVersion;
+    }
+    const body = await this.#graphql.request(LOCALES_QUERY, { input }, opts);
+    return normaliseLocaleResponse(body.locales);
+  }
+  /**
+   * Trigger an admin refresh — backend re-pulls the source Sheet, invalidates
+   * its cache, and writes fresh entries for every supported language.
+   *
+   * Requires `X-API-Key` header equal to backend `InternalApiKey`. The transport
+   * layer is responsible for attaching the header; this method does not handle
+   * auth concerns directly.
+   */
+  async refresh(opts) {
+    const body = await this.#graphql.request(
+      REFRESH_LOCALES_MUTATION,
+      {},
+      opts
+    );
+    return normaliseRefreshLocalesPayload(body.refreshLocales);
+  }
+};
+
+// 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) {
     throw new TaphubServerError("Invalid response from server", {
       code: "InvalidResponse"
@@ -559,7 +712,7 @@ function normaliseCandles(list) {
     coefMults: c.coefMults
   }));
 }
-function normaliseGamePairInfo(node) {
+function normalisePairInfo(node) {
   if (typeof node.id !== "string" || node.id === "" || typeof node.pair !== "string" || node.pair === "") {
     throw new TaphubServerError("Invalid response from server", { code: "InvalidResponse" });
   }
@@ -569,13 +722,14 @@ function normaliseGamePairInfo(node) {
     gameplayId: node.gameplayId,
     gameplayName: node.gameplayName,
     source: node.source,
-    gameId: node.gameId ?? null
+    // REVIEW[bid-260602]: maps node.agencyPairId (was: node.gameId)
+    agencyPairId: node.agencyPairId ?? null
   };
 }
 
-// src/modules/game/queries.ts
-var GAME_QUERY = `query Game($pair: String!, $gameplaySlug: String) {
-  game(pair: $pair, gameplaySlug: $gameplaySlug) {
+// src/modules/pair/queries.ts
+var PAIR_QUERY = `query Pair($pair: String!, $gameplaySlug: String) {
+  pair(pair: $pair, gameplaySlug: $gameplaySlug) {
     id pair status created_at
     config {
       gridConfig { cellSizeTime cellSizeValue candleSize baseline baselineTime }
@@ -584,8 +738,8 @@ var GAME_QUERY = `query Game($pair: String!, $gameplaySlug: String) {
     }
   }
 }`;
-var CHART_HISTORY_QUERY = `query ChartHistory($gameId: ID!, $limit: Int) {
-  chartHistory(gameId: $gameId, limit: $limit) {
+var CHART_HISTORY_QUERY = `query ChartHistory($agencyPairId: ID!, $limit: Int) {
+  chartHistory(agencyPairId: $agencyPairId, limit: $limit) {
     time o h l c volatility coefMults
   }
 }`;
@@ -596,12 +750,12 @@ var BUILDER_AVAILABLE_GAME_PAIRS_QUERY = `query BuilderAvailableGamePairs($gamep
     gameplayId
     gameplayName
     source
-    gameId
+    agencyPairId
   }
 }`;
 
-// src/modules/game/index.ts
-var GameModule = class {
+// src/modules/pair/index.ts
+var PairModule = class {
   #graphql;
   constructor(deps) {
     this.#graphql = deps.graphql;
@@ -611,7 +765,7 @@ var GameModule = class {
     if (opts?.gameplaySlug) variables.gameplaySlug = opts.gameplaySlug;
     let body;
     try {
-      body = await this.#graphql.request(GAME_QUERY, variables, opts);
+      body = await this.#graphql.request(PAIR_QUERY, variables, opts);
     } catch (err) {
       if (err instanceof TaphubValidationError && err.code === "NotExist") {
         throw new TaphubValidationError("Game not found for pair", {
@@ -621,13 +775,13 @@ var GameModule = class {
       }
       throw err;
     }
-    if (body.game === null) {
+    if (body.pair === null) {
       throw new TaphubValidationError("Game not found for pair", {
         code: "GameNotFound",
         details: { pair }
       });
     }
-    return normaliseGame(body.game);
+    return normalisePair(body.pair);
   }
   /**
    * Returns available game pairs, optionally filtered by gameplay.
@@ -636,9 +790,9 @@ var GameModule = class {
    * `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);
+   * 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);
    */
   async availableGamePairs(opts) {
     const variables = {};
@@ -648,10 +802,11 @@ var GameModule = class {
       variables,
       opts
     );
-    return body.builderAvailableGamePairs.map(normaliseGamePairInfo);
+    return body.builderAvailableGamePairs.map(normalisePairInfo);
   }
-  async chartHistory(gameId, limit, opts) {
-    const variables = { gameId };
+  // REVIEW[bid-260602]: chartHistory param/variable renamed agencyPairId (was: gameId)
+  async chartHistory(agencyPairId, limit, opts) {
+    const variables = { agencyPairId };
     if (limit !== void 0) {
       variables.limit = limit;
     }
@@ -664,149 +819,6 @@ var GameModule = class {
   }
 };
 
-// src/modules/leaderboard/normalise.ts
-function normaliseLeaderboard(rows) {
-  if (!Array.isArray(rows)) {
-    throw new TaphubServerError("Invalid response from server", {
-      code: "InvalidResponse"
-    });
-  }
-  return rows.map((row) => ({
-    userId: row.user_id,
-    username: row.username,
-    rank: row.rank,
-    totalBids: row.total_bids,
-    totalWins: row.total_wins,
-    totalWagered: row.total_wagered,
-    totalPayout: row.total_payout,
-    gain: row.gain
-  }));
-}
-
-// src/modules/leaderboard/queries.ts
-var LEADERBOARD_QUERY = `query Leaderboard($period: String!, $sort_by: String!) {
-  leaderboard(period: $period, sort_by: $sort_by) {
-    user_id username rank total_bids total_wins total_wagered total_payout gain
-  }
-}`;
-
-// src/modules/leaderboard/index.ts
-var LeaderboardModule = class {
-  #graphql;
-  constructor(deps) {
-    this.#graphql = deps.graphql;
-  }
-  async list(args) {
-    const body = await this.#graphql.request(
-      LEADERBOARD_QUERY,
-      { period: args.period, sort_by: args.sortBy },
-      args.signal ? { signal: args.signal } : void 0
-    );
-    return normaliseLeaderboard(body.leaderboard);
-  }
-};
-
-// src/modules/locale/normalise.ts
-function normaliseLocaleResponse(node) {
-  let translations = null;
-  if (node.translations !== null) {
-    try {
-      translations = JSON.parse(node.translations);
-    } catch (err) {
-      throw new TaphubValidationError("Malformed translations JSON string from backend", {
-        code: "InvalidLocaleResponse",
-        details: {
-          lang: node.lang,
-          version: node.version,
-          parseError: err instanceof Error ? err.message : String(err)
-        }
-      });
-    }
-  }
-  return {
-    lang: node.lang,
-    version: node.version,
-    notModified: node.notModified,
-    translations
-  };
-}
-function normaliseRefreshLocalesPayload(node) {
-  let versions;
-  try {
-    versions = JSON.parse(node.versions);
-  } catch (err) {
-    throw new TaphubValidationError("Malformed versions JSON string from backend", {
-      code: "InvalidRefreshLocalesPayload",
-      details: {
-        parseError: err instanceof Error ? err.message : String(err)
-      }
-    });
-  }
-  return {
-    refreshed: node.refreshed,
-    versions
-  };
-}
-
-// src/modules/locale/queries.ts
-var LOCALES_QUERY = `query Locales($input: LocalesInput!) {
-  locales(input: $input) {
-    lang
-    version
-    notModified
-    translations
-  }
-}`;
-var REFRESH_LOCALES_MUTATION = `mutation RefreshLocales {
-  refreshLocales {
-    refreshed
-    versions
-  }
-}`;
-
-// src/modules/locale/index.ts
-var LocaleModule = class {
-  #graphql;
-  constructor(deps) {
-    this.#graphql = deps.graphql;
-  }
-  /**
-   * Fetch translations for a single language.
-   *
-   * Pass the last-seen `version` as `knownVersion` to opt into not-modified
-   * short-circuit semantics: backend returns `{notModified: true, translations: null}`
-   * when the cached body still matches, and the caller keeps prior state.
-   *
-   * Errors surface as TaphubError subclasses with `extensions.code` codes from
-   * the backend (e.g. `LangNotSupported`, `InsufficientUpstream`, `FeatureDisabled`).
-   * Caller decides the fallback strategy.
-   */
-  async get(lang, knownVersion, opts) {
-    const input = { lang };
-    if (knownVersion !== void 0 && knownVersion !== "") {
-      input.knownVersion = knownVersion;
-    }
-    const body = await this.#graphql.request(LOCALES_QUERY, { input }, opts);
-    return normaliseLocaleResponse(body.locales);
-  }
-  /**
-   * Trigger an admin refresh — backend re-pulls the source Sheet, invalidates
-   * its cache, and writes fresh entries for every supported language.
-   *
-   * Requires `X-API-Key` header equal to backend `InternalApiKey`. The transport
-   * layer is responsible for attaching the header; this method does not handle
-   * auth concerns directly.
-   */
-  async refresh(opts) {
-    const body = await this.#graphql.request(
-      REFRESH_LOCALES_MUTATION,
-      {},
-      opts
-    );
-    return normaliseRefreshLocalesPayload(body.refreshLocales);
-  }
-};
-
 // src/transport/mqtt/index.ts
 import mqtt from "mqtt";
 
@@ -2461,8 +2473,9 @@ var TaphubClient = class {
   user;
   /** @readonly Auth module — reassignment has no effect at runtime. */
   auth;
-  /** @readonly Game module — reassignment has no effect at runtime. */
-  game;
+  /** @readonly Pair module — reassignment has no effect at runtime. */
+  // REVIEW[bid-260602]: field pair: PairModule (was: game: GameModule)
+  pair;
   /** @readonly Bid module — reassignment has no effect at runtime. */
   bid;
   /** @readonly Leaderboard module — reassignment has no effect at runtime. */
@@ -2546,7 +2559,7 @@ var TaphubClient = class {
         this.user.clearCurrencies();
       }
     });
-    this.game = new GameModule({ graphql: this.#graphql });
+    this.pair = new PairModule({ graphql: this.#graphql });
     this.bid = new BidModule({ graphql: this.#graphql });
     this.leaderboard = new LeaderboardModule({ graphql: this.#graphql });
     this.agencyPairs = new AgencyPairModule({ graphql: this.#graphql });
@@ -2569,8 +2582,8 @@ var TaphubClient = class {
       enumerable: true,
       configurable: false
     });
-    Object.defineProperty(this, "game", {
-      value: this.game,
+    Object.defineProperty(this, "pair", {
+      value: this.pair,
       writable: false,
       enumerable: true,
       configurable: false
@@ -2731,10 +2744,10 @@ export {
   AgencyPairModule,
   AuthModule,
   BidModule,
-  GameModule,
   LeaderboardModule,
   LocaleModule,
   NetworkQualityMonitor,
+  PairModule,
   RealtimeModule,
   TaphubAuthError,
   TaphubClient,

package/package.json

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