@taphubhq/sdk-core 0.15.3 → 0.16.0

package/dist/index.cjs

@@ -33,10 +33,10 @@ __export(index_exports, {
   AgencyPairModule: () => AgencyPairModule,
   AuthModule: () => AuthModule,
   BidModule: () => BidModule,
-  GameModule: () => GameModule,
   LeaderboardModule: () => LeaderboardModule,
   LocaleModule: () => LocaleModule,
   NetworkQualityMonitor: () => NetworkQualityMonitor,
+  PairModule: () => PairModule,
   RealtimeModule: () => RealtimeModule,
   TaphubAuthError: () => TaphubAuthError,
   TaphubClient: () => TaphubClient,
@@ -574,8 +574,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"
@@ -634,7 +777,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" });
   }
@@ -644,13 +787,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 }
@@ -659,8 +803,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
   }
 }`;
@@ -671,12 +815,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;
@@ -686,7 +830,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", {
@@ -696,13 +840,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.
@@ -711,9 +855,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 = {};
@@ -723,10 +867,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;
     }
@@ -739,149 +884,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
 var import_mqtt = __toESM(require("mqtt"));
 
@@ -2536,8 +2538,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. */
@@ -2621,7 +2624,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 });
@@ -2644,8 +2647,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
@@ -2807,10 +2810,10 @@ function calculateProbWin_v2(time1, time2, _price1, price2, creationTime, curren
   AgencyPairModule,
   AuthModule,
   BidModule,
-  GameModule,
   LeaderboardModule,
   LocaleModule,
   NetworkQualityMonitor,
+  PairModule,
   RealtimeModule,
   TaphubAuthError,
   TaphubClient,

package/dist/index.d.mts

@@ -233,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 {
@@ -427,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;
@@ -891,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. */
@@ -988,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

@@ -233,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 {
@@ -427,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;
@@ -891,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. */
@@ -988,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.js

@@ -509,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"
@@ -569,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" });
   }
@@ -579,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 }
@@ -594,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
   }
 }`;
@@ -606,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;
@@ -621,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", {
@@ -631,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.
@@ -646,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 = {};
@@ -658,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;
     }
@@ -674,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";
 
@@ -2471,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. */
@@ -2556,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 });
@@ -2579,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
@@ -2741,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.3",
+  "version": "0.16.0",
   "description": "Core SDK for building on the TabHub platform",
   "license": "MIT",
   "main": "./dist/index.cjs",