@xtr-dev/rondevu-webtorrent 0.0.1 → 0.0.2

package/README.md

@@ -147,6 +147,14 @@ interface RondevuConnectionManagerOptions {
     RTCSessionDescription: typeof RTCSessionDescription;
     RTCIceCandidate: typeof RTCIceCandidate;
   };
+
+  /**
+   * Optional prefix to add to all topics
+   * Allows creating separate discovery pools for different environments or applications
+   * @default '' (empty string - uses infoHash directly)
+   * @example 'dev.xtr.player:' would create topics like 'dev.xtr.player:abc123...'
+   */
+  topicPrefix?: string;
 }
 ```
 
@@ -216,6 +224,31 @@ connectionManager.destroy();
 
 ## Advanced Usage
 
+### Topic Prefix for Separate Discovery Pools
+
+Use a custom topic prefix to create isolated peer discovery pools. This is useful for:
+- Separating development, staging, and production environments
+- Creating application-specific discovery pools
+- Preventing peers from different versions/contexts from discovering each other
+
+```typescript
+// Production environment
+const prodManager = new RondevuConnectionManager(client, {
+  topicPrefix: 'prod.myapp:',
+  debug: false
+});
+
+// Development environment
+const devManager = new RondevuConnectionManager(client, {
+  topicPrefix: 'dev.myapp:',
+  debug: true
+});
+
+// Now torrents with the same infoHash in prod and dev won't discover each other
+// Production uses topics like: 'prod.myapp:abc123...'
+// Development uses topics like: 'dev.myapp:abc123...'
+```
+
 ### Custom RTCConfiguration
 
 Provide custom STUN/TURN servers for WebRTC connections:

package/dist/RondevuConnectionManager.d.ts

@@ -41,6 +41,13 @@ export interface RondevuConnectionManagerOptions {
      * Required for WebRTC functionality in Node.js environments
      */
     wrtc?: WebRTCPolyfill;
+    /**
+     * Optional prefix to add to all topics. This allows creating separate discovery pools
+     * for different environments or applications.
+     * For example: 'dev.xtr.player:' would make topics like 'dev.xtr.player:abc123...'
+     * (default: empty string - uses infoHash directly)
+     */
+    topicPrefix?: string;
 }
 /**
  * Connection manager that uses Rondevu for WebTorrent peer discovery via WebRTC.
@@ -61,6 +68,10 @@ export declare class RondevuConnectionManager {
      * Initialize the connection manager by setting up event listeners and registering with rondevu
      */
     private initialize;
+    /**
+     * Build the full topic string from an infoHash, applying the configured prefix if any
+     */
+    private buildTopic;
     /**
      * Handle a torrent being added to the WebTorrent client
      */

package/dist/RondevuConnectionManager.js

@@ -19,6 +19,7 @@ export class RondevuConnectionManager {
             refreshInterval: options.refreshInterval ?? 30000,
             rtcConfig: options.rtcConfig,
             wrtc: options.wrtc,
+            topicPrefix: options.topicPrefix ?? '',
         };
         this.rondevu = new Rondevu({
             baseUrl: options.rondevuServer,
@@ -56,6 +57,12 @@ export class RondevuConnectionManager {
             this.handleTorrentAdded(torrent);
         });
     }
+    /**
+     * Build the full topic string from an infoHash, applying the configured prefix if any
+     */
+    buildTopic(infoHash) {
+        return `${this.options.topicPrefix}${infoHash}`;
+    }
     /**
      * Handle a torrent being added to the WebTorrent client
      */
@@ -134,7 +141,7 @@ export class RondevuConnectionManager {
             const peer = this.rondevu.createPeer(this.options.rtcConfig);
             this.log(`Creating offer for torrent ${infoHash}`);
             const offerId = await peer.createOffer({
-                topics: [infoHash],
+                topics: [this.buildTopic(infoHash)],
                 ttl: 300000, // 5 minutes in milliseconds
                 createDataChannel: true,
                 dataChannelLabel: 'webtorrent',
@@ -145,7 +152,7 @@ export class RondevuConnectionManager {
             // Discover other peers' offers for this torrent
             this.log(`Discovering peers for torrent ${infoHash}`);
             const bloomFilter = this.torrentBloomFilters.get(infoHash);
-            const offers = await this.rondevu.offers.findByTopic(infoHash, {
+            const offers = await this.rondevu.offers.findByTopic(this.buildTopic(infoHash), {
                 limit: this.options.maxPeersPerTorrent - currentPeerCount,
                 bloomFilter: bloomFilter?.toBytes(),
             });
@@ -167,7 +174,7 @@ export class RondevuConnectionManager {
                     const answerPeer = this.rondevu.createPeer(this.options.rtcConfig);
                     this.log(`Answering offer ${remoteOffer.id} for torrent ${infoHash}`);
                     await answerPeer.answer(remoteOffer.id, remoteOffer.sdp, {
-                        topics: [infoHash],
+                        topics: [this.buildTopic(infoHash)],
                     });
                     // Set up peer connection handlers
                     this.setupPeerHandlers(answerPeer, torrent, false);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xtr-dev/rondevu-webtorrent",
-  "version": "0.0.1",
+  "version": "0.0.2",
   "description": "WebTorrent peer discovery plugin using Rondevu WebRTC signaling",
   "type": "module",
   "main": "dist/index.js",