@taphubhq/sdk-core 0.13.0 → 0.14.0

package/dist/index.cjs

@@ -818,9 +818,17 @@ var LocaleModule = class {
 
 // src/transport/mqtt/index.ts
 var import_mqtt = __toESM(require("mqtt"));
-var GAME_SCOPED_SUFFIXES = ["candle", "config", "ideal_config"];
+
+// src/transport/mqtt/utils.ts
+function subKey(gameId, userId) {
+  return `${gameId}::${userId ?? ""}`;
+}
+
+// src/transport/mqtt/index.ts
+var GAME_SCOPED_SUFFIXES = ["config", "ideal_config"];
 var USER_SCOPED_SUFFIXES = ["bid_result", "balance_update"];
 var TOPIC_PREFIX = "game";
+var MARKET_TOPIC_PREFIX = "market";
 function topicFor(gameId, suffix, userId) {
   if (USER_SCOPED_SUFFIXES.includes(suffix)) {
     return `${TOPIC_PREFIX}/${gameId}/user/${userId}/${suffix}`;
@@ -833,12 +841,10 @@ function normaliseUserId(userId) {
 function userScopedTopicsFor(gameId, userId) {
   return USER_SCOPED_SUFFIXES.map((s) => topicFor(gameId, s, userId));
 }
-function subKey(gameId, userId) {
-  return `${gameId}::${userId ?? ""}`;
-}
 function createMqttTransport(endpoint, opts = {}) {
   let client = null;
   const subscriptions = /* @__PURE__ */ new Map();
+  const candleSubscriptions = /* @__PURE__ */ new Map();
   const { onLifecycle } = opts;
   let connectStartedAt = 0;
   function fireLifecycle(event) {
@@ -885,6 +891,17 @@ function createMqttTransport(endpoint, opts = {}) {
       fireLifecycle({ kind: "error", err });
     });
     client.on("message", (receivedTopic, message) => {
+      const candleSub = [...candleSubscriptions.values()].find((s) => s.topic === receivedTopic);
+      if (candleSub) {
+        let payload2;
+        try {
+          payload2 = JSON.parse(message.toString());
+        } catch {
+          return;
+        }
+        candleSub.onCandle(receivedTopic, payload2);
+        return;
+      }
       let matched;
       for (const sub of subscriptions.values()) {
         if (sub.topics.includes(receivedTopic)) {
@@ -929,9 +946,22 @@ function createMqttTransport(endpoint, opts = {}) {
         onError
       });
       for (const t of fullTopics) {
-        mqttClient.subscribe(t, { qos: t.endsWith("candle") ? 0 : 1 });
+        mqttClient.subscribe(t, { qos: 1 });
       }
     },
+    subscribeCandle(pair, onCandle) {
+      const topic = `${MARKET_TOPIC_PREFIX}/${pair.replace(/\//g, "_")}/candle`;
+      if (candleSubscriptions.has(pair)) return;
+      const mqttClient = ensureConnected();
+      candleSubscriptions.set(pair, { topic, onCandle });
+      mqttClient.subscribe(topic, { qos: 0 });
+    },
+    unsubscribeCandle(pair) {
+      const entry = candleSubscriptions.get(pair);
+      if (!entry) return;
+      if (client) client.unsubscribe(entry.topic);
+      candleSubscriptions.delete(pair);
+    },
     unsubscribeAll(gameId, userId) {
       const matches = entriesForGame(gameId);
       if (matches.length === 0) return;
@@ -963,8 +993,12 @@ function createMqttTransport(endpoint, opts = {}) {
             client.unsubscribe(t);
           }
         }
+        for (const entry of candleSubscriptions.values()) {
+          client.unsubscribe(entry.topic);
+        }
       }
       subscriptions.clear();
+      candleSubscriptions.clear();
       if (client) {
         client.end(true);
         client = null;
@@ -1082,9 +1116,6 @@ function mapWireToEvent(topic, payload) {
 function normaliseUserId2(userId) {
   return userId && userId !== "" ? userId : null;
 }
-function subKey2(gameId, userId) {
-  return `${gameId}::${userId ?? ""}`;
-}
 var RealtimeModule = class extends import_eventemitter32.default {
   #transport;
   #entries = /* @__PURE__ */ new Map();
@@ -1104,7 +1135,7 @@ var RealtimeModule = class extends import_eventemitter32.default {
   }
   subscribe(gameId, userId) {
     const cleanUserId = normaliseUserId2(userId);
-    const key = subKey2(gameId, cleanUserId);
+    const key = subKey(gameId, cleanUserId);
     const existing = this.#entries.get(key);
     if (existing) {
       existing.refcount += 1;
@@ -1160,11 +1191,22 @@ var RealtimeModule = class extends import_eventemitter32.default {
     }
     target.refcount -= 1;
     if (target.refcount > 0) return;
-    const key = subKey2(target.gameId, target.userId);
+    const key = subKey(target.gameId, target.userId);
     this.#entries.delete(key);
     target.channel.removeAllListeners();
     this.#transport.unsubscribeAll(gameId, target.userId);
   }
+  /**
+   * Subscribe to public market candle data for a pair (e.g. "ETH/USD").
+   * Independent of game/agency — candle is market-wide public data.
+   */
+  subscribeCandle(pair, onCandle) {
+    this.#transport.subscribeCandle(pair, onCandle);
+  }
+  /** Unsubscribe from candle data for a pair. */
+  unsubscribeCandle(pair) {
+    this.#transport.unsubscribeCandle(pair);
+  }
   disconnect() {
     for (const entry of this.#entries.values()) {
       entry.channel.removeAllListeners();

package/dist/index.d.mts

@@ -452,14 +452,13 @@ type MqttLifecycleEvent = {
     rttMs: number;
 };
 type MqttLifecycleHook = (event: MqttLifecycleEvent) => void;
+type MqttCandleHandler = (topic: string, payload: MqttWirePayload) => void;
 interface MqttTransport {
     /**
-     * Subscribe to a game's MQTT topics keyed by the tuple `(gameId, userId)`.
-     * When `userId` is nullish (including the empty string `''`), only
-     * game-scoped topics are subscribed and the entry is stored under the
-     * anonymous slot for that gameId. Two calls with the same `(gameId, userId)`
-     * tuple are idempotent; calls with the same `gameId` but a different
-     * `userId` create an independent entry with its own user-scoped topics.
+     * Subscribe to a game's MQTT topics (config, ideal_config, bid_result, balance)
+     * keyed by the tuple `(gameId, userId)`. Does NOT subscribe to candle —
+     * use `subscribeCandle` for public market candle data.
+     * Two calls with the same `(gameId, userId)` tuple are idempotent.
      */
     subscribe(gameId: string, userId: string | null | undefined, onMessage: MqttMessageHandler, onError: MqttErrorHandler): void;
     /**
@@ -470,6 +469,14 @@ interface MqttTransport {
      * `code='AmbiguousUnsubscribe'`.
      */
     unsubscribeAll(gameId: string, userId?: string | null): void;
+    /**
+     * Subscribe to public market candle data for a pair (e.g. "ETH/USD").
+     * Independent of game/agency context — candle is market-wide public data.
+     * Idempotent: multiple calls for the same pair are deduplicated.
+     */
+    subscribeCandle(pair: string, onCandle: MqttCandleHandler): void;
+    /** Tear down the candle subscription for a pair. */
+    unsubscribeCandle(pair: string): void;
     close(): void;
 }
 
@@ -580,6 +587,13 @@ declare class RealtimeModule extends EventEmitter<RealtimeModuleEvents> {
     get _transport(): MqttTransport;
     subscribe(gameId: string, userId?: string | null): GameChannel;
     unsubscribe(gameId: string, userId?: string | null): void;
+    /**
+     * Subscribe to public market candle data for a pair (e.g. "ETH/USD").
+     * Independent of game/agency — candle is market-wide public data.
+     */
+    subscribeCandle(pair: string, onCandle: MqttCandleHandler): void;
+    /** Unsubscribe from candle data for a pair. */
+    unsubscribeCandle(pair: string): void;
     disconnect(): void;
 }
 

package/dist/index.d.ts

@@ -452,14 +452,13 @@ type MqttLifecycleEvent = {
     rttMs: number;
 };
 type MqttLifecycleHook = (event: MqttLifecycleEvent) => void;
+type MqttCandleHandler = (topic: string, payload: MqttWirePayload) => void;
 interface MqttTransport {
     /**
-     * Subscribe to a game's MQTT topics keyed by the tuple `(gameId, userId)`.
-     * When `userId` is nullish (including the empty string `''`), only
-     * game-scoped topics are subscribed and the entry is stored under the
-     * anonymous slot for that gameId. Two calls with the same `(gameId, userId)`
-     * tuple are idempotent; calls with the same `gameId` but a different
-     * `userId` create an independent entry with its own user-scoped topics.
+     * Subscribe to a game's MQTT topics (config, ideal_config, bid_result, balance)
+     * keyed by the tuple `(gameId, userId)`. Does NOT subscribe to candle —
+     * use `subscribeCandle` for public market candle data.
+     * Two calls with the same `(gameId, userId)` tuple are idempotent.
      */
     subscribe(gameId: string, userId: string | null | undefined, onMessage: MqttMessageHandler, onError: MqttErrorHandler): void;
     /**
@@ -470,6 +469,14 @@ interface MqttTransport {
      * `code='AmbiguousUnsubscribe'`.
      */
     unsubscribeAll(gameId: string, userId?: string | null): void;
+    /**
+     * Subscribe to public market candle data for a pair (e.g. "ETH/USD").
+     * Independent of game/agency context — candle is market-wide public data.
+     * Idempotent: multiple calls for the same pair are deduplicated.
+     */
+    subscribeCandle(pair: string, onCandle: MqttCandleHandler): void;
+    /** Tear down the candle subscription for a pair. */
+    unsubscribeCandle(pair: string): void;
     close(): void;
 }
 
@@ -580,6 +587,13 @@ declare class RealtimeModule extends EventEmitter<RealtimeModuleEvents> {
     get _transport(): MqttTransport;
     subscribe(gameId: string, userId?: string | null): GameChannel;
     unsubscribe(gameId: string, userId?: string | null): void;
+    /**
+     * Subscribe to public market candle data for a pair (e.g. "ETH/USD").
+     * Independent of game/agency — candle is market-wide public data.
+     */
+    subscribeCandle(pair: string, onCandle: MqttCandleHandler): void;
+    /** Unsubscribe from candle data for a pair. */
+    unsubscribeCandle(pair: string): void;
     disconnect(): void;
 }
 

package/dist/index.js

@@ -754,9 +754,17 @@ var LocaleModule = class {
 
 // src/transport/mqtt/index.ts
 import mqtt from "mqtt";
-var GAME_SCOPED_SUFFIXES = ["candle", "config", "ideal_config"];
+
+// src/transport/mqtt/utils.ts
+function subKey(gameId, userId) {
+  return `${gameId}::${userId ?? ""}`;
+}
+
+// src/transport/mqtt/index.ts
+var GAME_SCOPED_SUFFIXES = ["config", "ideal_config"];
 var USER_SCOPED_SUFFIXES = ["bid_result", "balance_update"];
 var TOPIC_PREFIX = "game";
+var MARKET_TOPIC_PREFIX = "market";
 function topicFor(gameId, suffix, userId) {
   if (USER_SCOPED_SUFFIXES.includes(suffix)) {
     return `${TOPIC_PREFIX}/${gameId}/user/${userId}/${suffix}`;
@@ -769,12 +777,10 @@ function normaliseUserId(userId) {
 function userScopedTopicsFor(gameId, userId) {
   return USER_SCOPED_SUFFIXES.map((s) => topicFor(gameId, s, userId));
 }
-function subKey(gameId, userId) {
-  return `${gameId}::${userId ?? ""}`;
-}
 function createMqttTransport(endpoint, opts = {}) {
   let client = null;
   const subscriptions = /* @__PURE__ */ new Map();
+  const candleSubscriptions = /* @__PURE__ */ new Map();
   const { onLifecycle } = opts;
   let connectStartedAt = 0;
   function fireLifecycle(event) {
@@ -821,6 +827,17 @@ function createMqttTransport(endpoint, opts = {}) {
       fireLifecycle({ kind: "error", err });
     });
     client.on("message", (receivedTopic, message) => {
+      const candleSub = [...candleSubscriptions.values()].find((s) => s.topic === receivedTopic);
+      if (candleSub) {
+        let payload2;
+        try {
+          payload2 = JSON.parse(message.toString());
+        } catch {
+          return;
+        }
+        candleSub.onCandle(receivedTopic, payload2);
+        return;
+      }
       let matched;
       for (const sub of subscriptions.values()) {
         if (sub.topics.includes(receivedTopic)) {
@@ -865,9 +882,22 @@ function createMqttTransport(endpoint, opts = {}) {
         onError
       });
       for (const t of fullTopics) {
-        mqttClient.subscribe(t, { qos: t.endsWith("candle") ? 0 : 1 });
+        mqttClient.subscribe(t, { qos: 1 });
       }
     },
+    subscribeCandle(pair, onCandle) {
+      const topic = `${MARKET_TOPIC_PREFIX}/${pair.replace(/\//g, "_")}/candle`;
+      if (candleSubscriptions.has(pair)) return;
+      const mqttClient = ensureConnected();
+      candleSubscriptions.set(pair, { topic, onCandle });
+      mqttClient.subscribe(topic, { qos: 0 });
+    },
+    unsubscribeCandle(pair) {
+      const entry = candleSubscriptions.get(pair);
+      if (!entry) return;
+      if (client) client.unsubscribe(entry.topic);
+      candleSubscriptions.delete(pair);
+    },
     unsubscribeAll(gameId, userId) {
       const matches = entriesForGame(gameId);
       if (matches.length === 0) return;
@@ -899,8 +929,12 @@ function createMqttTransport(endpoint, opts = {}) {
             client.unsubscribe(t);
           }
         }
+        for (const entry of candleSubscriptions.values()) {
+          client.unsubscribe(entry.topic);
+        }
       }
       subscriptions.clear();
+      candleSubscriptions.clear();
       if (client) {
         client.end(true);
         client = null;
@@ -1018,9 +1052,6 @@ function mapWireToEvent(topic, payload) {
 function normaliseUserId2(userId) {
   return userId && userId !== "" ? userId : null;
 }
-function subKey2(gameId, userId) {
-  return `${gameId}::${userId ?? ""}`;
-}
 var RealtimeModule = class extends EventEmitter2 {
   #transport;
   #entries = /* @__PURE__ */ new Map();
@@ -1040,7 +1071,7 @@ var RealtimeModule = class extends EventEmitter2 {
   }
   subscribe(gameId, userId) {
     const cleanUserId = normaliseUserId2(userId);
-    const key = subKey2(gameId, cleanUserId);
+    const key = subKey(gameId, cleanUserId);
     const existing = this.#entries.get(key);
     if (existing) {
       existing.refcount += 1;
@@ -1096,11 +1127,22 @@ var RealtimeModule = class extends EventEmitter2 {
     }
     target.refcount -= 1;
     if (target.refcount > 0) return;
-    const key = subKey2(target.gameId, target.userId);
+    const key = subKey(target.gameId, target.userId);
     this.#entries.delete(key);
     target.channel.removeAllListeners();
     this.#transport.unsubscribeAll(gameId, target.userId);
   }
+  /**
+   * Subscribe to public market candle data for a pair (e.g. "ETH/USD").
+   * Independent of game/agency — candle is market-wide public data.
+   */
+  subscribeCandle(pair, onCandle) {
+    this.#transport.subscribeCandle(pair, onCandle);
+  }
+  /** Unsubscribe from candle data for a pair. */
+  unsubscribeCandle(pair) {
+    this.#transport.unsubscribeCandle(pair);
+  }
   disconnect() {
     for (const entry of this.#entries.values()) {
       entry.channel.removeAllListeners();

package/package.json

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