@taphubhq/sdk-core 0.15.3 → 0.16.1

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";
 
@@ -887,6 +889,19 @@ function createMqttTransport(endpoint, opts = {}) {
       }
     });
     client.on("connect", () => {
+      const c = client;
+      for (const sub of subscriptions.values()) {
+        for (const t of sub.topics) c.subscribe(t, { qos: 1 });
+      }
+      for (const entry of candleSubscriptions.values()) {
+        c.subscribe(entry.topic, { qos: 0 });
+      }
+      for (const entry of statsSubscriptions.values()) {
+        c.subscribe(entry.topic, { qos: 0 });
+      }
+      for (const entry of walletSubscriptions.values()) {
+        c.subscribe(entry.topic, { qos: 1 });
+      }
       fireLifecycle({ kind: "connect", rttMs: Date.now() - connectStartedAt });
     });
     client.on("reconnect", () => {
@@ -1601,10 +1616,18 @@ function classifyBackendHealth(samples) {
   }
   return "ok";
 }
-var isPoor = (m) => m.rtt > 450 || m.jitter > 150 || m.lossRate > 0.05;
-var canLeavePoor = (m) => m.rtt < 350 && m.jitter < 120 && m.lossRate < 0.03;
-var isFairUpper = (rtt) => rtt > 180;
-var canReachGood = (rtt) => rtt < 120;
+var RTT_GOOD_TO_FAIR = 180;
+var RTT_FAIR_TO_GOOD = 120;
+var RTT_FAIR_TO_POOR = 450;
+var RTT_POOR_TO_FAIR = 350;
+var JITTER_POOR = 150;
+var JITTER_LEAVE_POOR = 120;
+var LOSS_POOR = 0.05;
+var LOSS_LEAVE_POOR = 0.03;
+var isPoor = (m) => m.rtt > RTT_FAIR_TO_POOR || m.jitter > JITTER_POOR || m.lossRate > LOSS_POOR;
+var canLeavePoor = (m) => m.rtt < RTT_POOR_TO_FAIR && m.jitter < JITTER_LEAVE_POOR && m.lossRate < LOSS_LEAVE_POOR;
+var isFairUpper = (rtt) => rtt > RTT_GOOD_TO_FAIR;
+var canReachGood = (rtt) => rtt < RTT_FAIR_TO_GOOD;
 function classifyNetworkLevel(metrics, current) {
   if (current === "offline") {
     return isPoor(metrics) ? "poor" : "fair";
@@ -1731,13 +1754,11 @@ var NetworkQualityMonitor = class {
     if (bucket.length > WINDOW_MAX_SAMPLES_PER_SOURCE) {
       bucket.shift();
     }
-    if (sample.source !== "connection" && sample.source !== "browser") {
-      if (sample.reason === "ok") {
-        this.lastSuccessfulHttpAt = sample.ts;
-        this.smoother.add(sample.rtt, this.deriveMetrics());
-      } else if (sample.reason === "network" || sample.reason === "timeout") {
-        this.smoother.add(sample.rtt, this.deriveMetrics());
-      }
+    if (sample.reason === "ok" && sample.source !== "connection" && sample.source !== "browser") {
+      this.lastSuccessfulHttpAt = sample.ts;
+    }
+    if (sample.source === "mqtt" && sample.reason === "ok") {
+      this.smoother.add(sample.rtt, this.deriveMetrics());
     }
     this.recompute(prevMqttConnectedOverride);
   }
@@ -1908,17 +1929,15 @@ var NetworkQualityMonitor = class {
       (s) => s.reason === "network" || s.reason === "timeout" || s.reason === "offline"
     ).length;
     const lossRate = total > 0 ? lossCount / total : 0;
-    const okRtts = httpSamples.filter(
-      (s) => s.reason === "ok" || s.reason === "backend5xx" || s.reason === "backend4xx" || s.reason === "gqlError"
-    ).map((s) => s.rtt).filter((r) => Number.isFinite(r));
+    const mqttRtts = samples.filter((s) => s.source === "mqtt" && s.reason === "ok").map((s) => s.rtt).filter((r) => Number.isFinite(r));
     let jitter = 0;
-    if (okRtts.length > 1) {
-      const mean = okRtts.reduce((a, b) => a + b, 0) / okRtts.length;
-      const variance = okRtts.reduce((a, b) => a + (b - mean) ** 2, 0) / okRtts.length;
+    if (mqttRtts.length > 1) {
+      const mean = mqttRtts.reduce((a, b) => a + b, 0) / mqttRtts.length;
+      const variance = mqttRtts.reduce((a, b) => a + (b - mean) ** 2, 0) / mqttRtts.length;
       jitter = Math.sqrt(variance);
     }
     const connectionFallback = samples.filter((s) => s.source === "connection" && Number.isFinite(s.rtt)).slice(-1)[0]?.rtt;
-    const emaForLevel = this.smoother.ema > 0 ? this.smoother.ema : okRtts.length > 0 ? okRtts[okRtts.length - 1] ?? 0 : connectionFallback ?? 0;
+    const emaForLevel = this.smoother.ema > 0 ? this.smoother.ema : mqttRtts.length > 0 ? mqttRtts[mqttRtts.length - 1] ?? 0 : connectionFallback ?? 0;
     return { jitter, lossRate, emaForLevel };
   }
   isHardOffline() {
@@ -2471,8 +2490,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 +2576,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 +2599,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 +2761,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.1",
   "description": "Core SDK for building on the TabHub platform",
   "license": "MIT",
   "main": "./dist/index.cjs",