@trystero-p2p/torrent 0.23.1 → 0.25.0

package/README.md

@@ -8,7 +8,7 @@ Trystero makes browsers discover each other and communicate directly. No
 accounts. No deploying infrastructure. Just import and connect.
 
 Peers can connect via 🌊 BitTorrent, 🐦 Nostr, 📡 MQTT, ⚡️ Supabase, 🔥Firebase,
-or 🪐 IPFS – all using the same API.
+🪐 IPFS, or a 🔌 self-hosted WebSocket relay – all using the same API.
 
 Besides making peer matching automatic, Trystero offers some nice abstractions
 on top of WebRTC:
@@ -42,6 +42,7 @@ You can see what people are building with Trystero
   - [React hooks](#react-hooks)
   - [Troubleshooting connection issues](#troubleshooting-connection-issues)
   - [Running server-side (Node, Bun)](#running-server-side-node-bun)
+  - [Self-hosted WebSocket relay](#self-hosted-websocket-relay)
   - [Write your own strategy](#write-your-own-strategy)
   - [Supabase setup](#supabase-setup)
   - [Firebase setup](#firebase-setup)
@@ -64,8 +65,9 @@ To establish a direct peer-to-peer connection with WebRTC, a signalling channel
 is needed to exchange peer information
 ([SDP](https://en.wikipedia.org/wiki/Session_Description_Protocol)). Typically
 this involves running your own matchmaking server but Trystero abstracts this
-away for you and offers multiple "serverless" strategies for connecting peers
-(currently BitTorrent, Nostr, MQTT, Supabase, Firebase, and IPFS).
+away for you and offers multiple strategies for connecting peers (currently
+BitTorrent, Nostr, MQTT, Supabase, Firebase, IPFS, and self-hosted WebSocket
+relay).
 
 The important point to remember is this:
 
@@ -112,6 +114,8 @@ import {joinRoom} from '@trystero-p2p/supabase'
 import {joinRoom} from '@trystero-p2p/firebase'
 // or
 import {joinRoom} from '@trystero-p2p/ipfs'
+// or
+import {joinRoom} from '@trystero-p2p/ws-relay'
 ```
 
 Next, join the user to a room with an ID:
@@ -138,21 +142,20 @@ Supabase, it should be your project URL.
 Listen for peers joining the room:
 
 ```js
-room.onPeerJoin(peerId => console.log(`${peerId} joined`))
+room.onPeerJoin = peerId => console.log(`${peerId} joined`)
 ```
 
 Listen for peers leaving the room:
 
 ```js
-room.onPeerLeave(peerId => console.log(`${peerId} left`))
+room.onPeerLeave = peerId => console.log(`${peerId} left`)
 ```
 
 Listen for peers sending their audio/video streams:
 
 ```js
-room.onPeerStream(
-  (stream, peerId) => (peerElements[peerId].video.srcObject = stream)
-)
+room.onPeerStream = (stream, peerId) =>
+  (peerElements[peerId].video.srcObject = stream)
 ```
 
 To unsubscribe from events, leave the room:
@@ -184,20 +187,61 @@ room.addStream(stream)
 Send and subscribe to custom peer-to-peer actions:
 
 ```js
-const [sendDrink, getDrink] = room.makeAction('drink')
+const drink = room.makeAction('drink')
 
 // buy drink for a friend
-sendDrink({drink: 'negroni', withIce: true}, friendId)
+drink.send({drink: 'negroni', withIce: true}, {target: friendId})
 
-// buy round for the house (second argument omitted)
-sendDrink({drink: 'mezcal', withIce: false})
+// buy round for the house
+drink.send({drink: 'mezcal', withIce: false})
 
 // listen for drinks sent to you
-getDrink((data, peerId) =>
+drink.onMessage = (data, {peerId}) =>
   console.log(
     `got a ${data.drink} with${data.withIce ? '' : 'out'} ice from ${peerId}`
   )
+```
+
+Actions can also use request/response semantics:
+
+```js
+const isEven = room.makeAction('is-even', {
+  kind: 'request',
+  onRequest: n => n % 2 === 0
+})
+
+const result = await isEven.request(42, {
+  target: friendId,
+  timeoutMs: 1000
+})
+```
+
+To ask multiple peers at once, use `requestMany()`. It resolves with a
+peer-labeled result for every target, while `onResult` lets you react as each
+peer answers:
+
+```js
+const availability = room.makeAction('availability', {
+  kind: 'request',
+  onRequest: ({date}) => calendar.isFree(date)
+})
+
+const results = await availability.requestMany(
+  {date: '2026-05-04'},
+  {
+    targets: teammateIds,
+    timeoutMs: 1000,
+    onResult: result => {
+      if (result.status === 'fulfilled') {
+        updateAvailabilityBadge(result.peerId, result.value)
+      }
+    }
+  }
 )
+
+const freePeers = results
+  .filter(result => result.status === 'fulfilled' && result.value)
+  .map(result => result.peerId)
 ```
 
 If you're using TypeScript, you can add a type hint to the action:
@@ -205,42 +249,40 @@ If you're using TypeScript, you can add a type hint to the action:
 ```typescript
 type CursorMove = {x: number; y: number}
 
-const [sendCursor, getCursor] = room.makeAction<CursorMove>('cursor-move')
+const cursor = room.makeAction<CursorMove>('cursor-move')
 ```
 
 You can also use actions to send binary data, like images:
 
 ```js
-const [sendPic, getPic] = room.makeAction('pic')
+const pic = room.makeAction('pic')
 
 // blobs are automatically handled, as are any form of TypedArray
-canvas.toBlob(blob => sendPic(blob))
+canvas.toBlob(blob => pic.send(blob))
 
 // binary data is received as raw ArrayBuffers so your handling code should
 // interpret it in a way that makes sense
-getPic(
-  (data, peerId) => (imgs[peerId].src = URL.createObjectURL(new Blob([data])))
-)
+pic.onMessage = (data, {peerId}) =>
+  (imgs[peerId].src = URL.createObjectURL(new Blob([data])))
 ```
 
 Let's say we want users to be able to name themselves:
 
 ```js
 const idsToNames = {}
-const [sendName, getName] = room.makeAction('name')
+const name = room.makeAction('name')
 
 // tell new peers your name when they connect
-room.onPeerJoin(peerId => sendName('Oedipa', peerId))
+room.onPeerJoin = peerId => name.send('Oedipa', {target: peerId})
 
 // listen for peers naming themselves
-getName((name, peerId) => (idsToNames[peerId] = name))
+name.onMessage = (value, {peerId}) => (idsToNames[peerId] = value)
 
 // tell all peers at once when your name changes
-nameInput.addEventListener('change', e => sendName(e.target.value))
+nameInput.addEventListener('change', e => name.send(e.target.value))
 
-room.onPeerLeave(peerId =>
+room.onPeerLeave = peerId =>
   console.log(`${idsToNames[peerId] || 'a weird stranger'} left`)
-)
 ```
 
 > Actions are smart and handle serialization and chunking for you behind the
@@ -266,10 +308,10 @@ const selfStream = await navigator.mediaDevices.getUserMedia({
 room.addStream(selfStream)
 
 // send stream to peers who join later
-room.onPeerJoin(peerId => room.addStream(selfStream, peerId))
+room.onPeerJoin = peerId => room.addStream(selfStream, {target: peerId})
 
 // handle streams from other peers
-room.onPeerStream((stream, peerId) => {
+room.onPeerStream = (stream, peerId) => {
   // create an audio instance and set the incoming stream
   const audio = new Audio()
   audio.srcObject = stream
@@ -278,7 +320,7 @@ room.onPeerStream((stream, peerId) => {
   // add the audio to peerAudios object if you want to address it for something
   // later (volume, etc.)
   peerAudios[peerId] = audio
-})
+}
 ```
 
 Doing the same with video is similar, just be sure to add incoming streams to
@@ -288,7 +330,7 @@ video elements in the DOM:
 const peerVideos = {}
 const videoContainer = document.getElementById('videos')
 
-room.onPeerStream((stream, peerId) => {
+room.onPeerStream = (stream, peerId) => {
   let video = peerVideos[peerId]
 
   // if this peer hasn't sent a stream before, create a video element
@@ -302,7 +344,7 @@ room.onPeerStream((stream, peerId) => {
 
   video.srcObject = stream
   peerVideos[peerId] = video
-})
+}
 ```
 
 ## Advanced
@@ -315,18 +357,17 @@ interpreted. Instead of manually adding metadata bytes to the buffer you can
 simply pass a metadata argument in the sender action for your binary payload:
 
 ```js
-const [sendFile, getFile] = room.makeAction('file')
+const file = room.makeAction('file')
 
-getFile((data, peerId, metadata) =>
+file.onMessage = (data, {peerId, metadata}) =>
   console.log(
     `got a file (${metadata.name}) from ${peerId} with type ${metadata.type}`,
     data
   )
-)
 
-// to send metadata, pass a third argument
-// to broadcast to the whole room, set the second peer ID argument to null
-sendFile(buffer, null, {name: 'The Courierʼs Tragedy', type: 'application/pdf'})
+file.send(buffer, {
+  metadata: {name: 'The Courierʼs Tragedy', type: 'application/pdf'}
+})
 ```
 
 ### Action promises
@@ -336,7 +377,7 @@ sending. You can optionally use this to indicate to the user when a large
 transfer is done.
 
 ```js
-await sendFile(amplePayload)
+await file.send(amplePayload)
 console.log('done sending to all peers')
 ```
 
@@ -348,30 +389,22 @@ a progress bar to the sender for large transfers. The callback is called with a
 percentage value between 0 and 1 and the receiving peer's ID:
 
 ```js
-sendFile(
-  payload,
-  // notice the peer target argument for any action sender can be a single peer
-  // ID, an array of IDs, or null (meaning send to all peers in the room)
-  [peerIdA, peerIdB, peerIdC],
-  // metadata, which can also be null if you're only interested in the
-  // progress handler
-  {filename: 'paranoids.flac'},
-  // assuming each peer has a loading bar added to the DOM, its value is
-  // updated here
-  (percent, peerId) => (loadingBars[peerId].value = percent)
-)
+file.send(payload, {
+  target: [peerIdA, peerIdB, peerIdC],
+  metadata: {filename: 'paranoids.flac'},
+  onProgress: (percent, {peerId}) => (loadingBars[peerId].value = percent)
+})
 ```
 
 Similarly you can listen for progress events as a receiver like this:
 
 ```js
-const [sendFile, getFile, onFileProgress] = room.makeAction('file')
+const file = room.makeAction('file')
 
-onFileProgress((percent, peerId, metadata) =>
+file.onReceiveProgress = (percent, {peerId, metadata}) =>
   console.log(
     `${percent * 100}% done receiving ${metadata.filename} from ${peerId}`
   )
-)
 ```
 
 Notice that any metadata is sent with progress events so you can show the
@@ -418,23 +451,22 @@ const trysteroConfig = {appId: 'thurn-und-taxis'}
 
 export default function App({roomId}) {
   const room = joinRoom(trysteroConfig, roomId)
-  const [sendColor, getColor] = room.makeAction('color')
+  const colorAction = room.makeAction('color')
   const [myColor, setMyColor] = useState('#c0ffee')
   const [peerColors, setPeerColors] = useState({})
 
   // whenever new peers join the room, send my color to them:
-  room.onPeerJoin(peer => sendColor(myColor, peer))
+  room.onPeerJoin = peer => colorAction.send(myColor, {target: peer})
 
   // listen for peers sending their colors and update the state accordingly:
-  getColor((color, peer) =>
-    setPeerColors(peerColors => ({...peerColors, [peer]: color}))
-  )
+  colorAction.onMessage = (color, {peerId}) =>
+    setPeerColors(peerColors => ({...peerColors, [peerId]: color}))
 
   const updateColor = e => {
     const {value} = e.target
 
     // when updating my own color, broadcast it to all peers:
-    sendColor(value)
+    colorAction.send(value)
     setMyColor(value)
   }
 
@@ -548,10 +580,42 @@ const room = joinRoom(
 )
 ```
 
+### Self-hosted WebSocket relay
+
+If you want a tiny relay that you control, use the WebSocket relay package.
+Start the relay on Node or Bun:
+
+```js
+import {createWsRelayServer} from '@trystero-p2p/ws-relay/server'
+
+createWsRelayServer({port: 8080})
+```
+
+Then in the browser:
+
+```js
+import {joinRoom} from '@trystero-p2p/ws-relay'
+
+const room = joinRoom(
+  {
+    appId: 'app-id',
+    relayConfig: {
+      urls: ['wss://localhost:8080']
+    }
+  },
+  'room-id'
+)
+```
+
+The `relayConfig.urls` config option is required for this strategy because there
+are no public default servers. You can pass multiple.
+
 ### Write your own strategy
 
 If you want to provide your own signaling backend, you can build a custom
-strategy with `createStrategy`.
+strategy with `createTopicStrategy`. This is the recommended helper for simple
+pub/sub relays because Trystero handles room lifecycle details like passive
+mode, announce scheduling, and peer-specific signaling topics.
 
 The example below assumes a WebSocket relay that does simple pub/sub routing:
 
@@ -559,74 +623,65 @@ The example below assumes a WebSocket relay that does simple pub/sub routing:
   `{"type": "subscribe" | "unsubscribe" | "publish", "topic", "payload"}`
 - Server broadcasts `{"topic", "payload"}` to subscribers of each topic
 
+This is just to show you how it works; if you want a simple self-hosted
+solution, use the `ws-relay` package explained above.
+
 ```js
-import {createStrategy, selfId, toJson} from '@trystero-p2p/core'
+import {createTopicStrategy, toJson} from '@trystero-p2p/core'
 
-export const joinRoom = createStrategy({
+export const joinRoom = createTopicStrategy({
   // Define init as a function that returns a promise of your signaling client.
   // Resolve the promise when your client is ready to send messages.
   // You can also return an array of client promises for redundancy.
   // In this case, the client is a single WebSocket.
   init: config =>
     new Promise((resolve, reject) => {
-      const ws = new WebSocket(config.relayUrl)
+      const ws = new WebSocket(config.relayConfig.urls[0])
       ws.addEventListener('open', () => resolve(ws), {once: true})
       ws.addEventListener('error', reject, {once: true})
     }),
 
-  // Subscribe takes 5 arguments:
-  // 1. One of the relay clients you defined in init.
-  // 2. rootTopic is the channel where peers in a room announce their presence.
-  // 3. selfTopic is the current peer's own channel where messages specific to
-  //    it should flow (i.e. offers and answers from external peers).
-  // 4. onMessage is a function that should be called when your relay client
-  // gets a message. Call it with the topic, data payload, and a callback
-  // function that takes another topic and payload.
-  // 5. getOffers is an optional helper for precomputed offers (only needed if
-  // the strategy needs to send offers in bulk, like torrents).
-  // It should return a cleanup function that unsubscribes
-  subscribe: (client, rootTopic, selfTopic, onMessage, _getOffers) => {
-    const topics = [rootTopic, selfTopic]
+  // Subscribe to one topic. Trystero decides which topics are needed and when.
+  subscribeTopic: (client, topic, onMessage) => {
     const onWsMessage = event => {
-      const {topic, payload} = JSON.parse(String(event.data))
+      const message = JSON.parse(String(event.data))
 
-      if (!topics.includes(topic)) {
+      if (message.topic !== topic) {
         return
       }
 
-      onMessage(topic, payload, (peerTopic, signal) =>
-        client.send(
-          toJson({type: 'publish', topic: peerTopic, payload: signal})
-        )
-      )
+      onMessage(message.topic, message.payload)
     }
 
     client.addEventListener('message', onWsMessage)
-    topics.forEach(topic => client.send(toJson({type: 'subscribe', topic})))
+    client.send(toJson({type: 'subscribe', topic}))
 
     return () => {
-      topics.forEach(topic => client.send(toJson({type: 'unsubscribe', topic})))
+      client.send(toJson({type: 'unsubscribe', topic}))
       client.removeEventListener('message', onWsMessage)
     }
   },
 
-  // announce takes a relay client and a rootTopic
-  announce: (client, rootTopic) =>
+  // Publish a payload to one topic.
+  publishTopic: (client, topic, payload) =>
     client.send(
       toJson({
         type: 'publish',
-        topic: rootTopic,
-        payload: toJson({peerId: selfId})
+        topic,
+        payload
       })
     )
 })
 
 const room = joinRoom(
-  {appId: 'my-app-id', relayUrl: 'wss://my-relay.example'},
+  {appId: 'my-app-id', relayConfig: {urls: ['wss://my-relay.example']}},
   'my-room-id'
 )
 ```
 
+For non-pub/sub signaling protocols, such as trackers that exchange offers in
+bulk, `createStrategy` is available as a lower-level advanced API.
+
 ### Supabase setup
 
 To use the Supabase strategy:
@@ -634,7 +689,8 @@ To use the Supabase strategy:
 1. Create a [Supabase](https://supabase.com) project or use an existing one
 2. On the dashboard, go to Project Settings -> API
 3. Copy the Project URL and set that as the `appId` in the Trystero config, copy
-   the `anon public` API key and set it as `supabaseKey` in the Trystero config
+   the `anon public` API key and set it as `relayConfig.supabaseKey` in the
+   Trystero config
 
 ### Firebase setup
 
@@ -684,8 +740,8 @@ the same namespace will return the same room instance.
     Supabase, this should be set to your project URL (see
     [Supabase setup instructions](#supabase-setup)). If using Firebase, this
     should be the `databaseURL` from your Firebase config (also see
-    `firebaseApp` below for an alternative way of configuring the Firebase
-    strategy).
+    `relayConfig.firebaseApp` below for an alternative way of configuring the
+    Firebase strategy).
 
   - `password` - **(optional)** A string to encrypt session descriptions via
     AES-GCM as they are passed through the peering medium. If not set, session
@@ -693,15 +749,46 @@ the same namespace will return the same room instance.
     name. A custom password must match between any peers in the room for them to
     connect. See [encryption](#encryption) for more details.
 
-  - `relayUrls` - **(optional, 🌊 BitTorrent, 🐦 Nostr, 📡 MQTT only)** Custom
-    list of URLs for the strategy to use to bootstrap P2P connections. These
-    would be BitTorrent trackers, Nostr relays, and MQTT brokers, respectively.
-    They must support secure WebSocket connections.
-
-  - `relayRedundancy` - **(optional, 🌊 BitTorrent, 🐦 Nostr, 📡 MQTT only)**
-    Integer specifying how many relay endpoints to connect to simultaneously.
-    Passing a `relayUrls` option will cause this option to be ignored as the
-    entire list will be used.
+  - `passive` - **(optional)** Boolean for backup or relay peers that should
+    listen for active peers without announcing themselves while a room is
+    dormant. Passive peers activate only after hearing a non-passive peer and
+    include a passive flag in their signaling so passive peers do not connect to
+    each other. For BitTorrent, dormant passive rooms announce as seeders
+    (`left: 0`) without offers, which avoids passive-to-passive discovery while
+    keeping tracker load low.
+
+  - `relayConfig` - **(optional unless required by your chosen strategy)**
+    Object containing strategy-specific relay settings:
+    - `urls` - **(optional for 🌊 BitTorrent, 🐦 Nostr, 📡 MQTT; required for 🔌
+      WebSocket relay)** Custom list of URLs for the strategy to use to
+      bootstrap P2P connections. These would be BitTorrent trackers, Nostr
+      relays, MQTT brokers, and WebSocket relays, respectively. They must
+      support secure WebSocket connections.
+
+    - `redundancy` - **(optional, 🌊 BitTorrent, 🐦 Nostr, 📡 MQTT only)**
+      Integer specifying how many default relay endpoints to connect to
+      simultaneously. Passing a `urls` option will cause this option to be
+      ignored as the entire list will be used.
+
+    - `manualReconnection` - **(optional, 🐦 Nostr and 🌊 BitTorrent only)**
+      Boolean (default: `false`) that when set to `true` disables automatically
+      pausing and resuming reconnection attempts when the browser goes offline
+      and comes back online. This is useful if you want to manage this behavior
+      yourself.
+
+    - `supabaseKey` - **(required, ⚡️ Supabase only)** Your Supabase project's
+      `anon public` API key.
+
+    - `firebaseApp` - **(optional, 🔥 Firebase only)** You can pass an already
+      initialized Firebase app instance instead of an `appId`. Normally Trystero
+      will initialize a Firebase app based on the `appId` but this will fail if
+      you've already initialized it for use elsewhere.
+
+    - `firebasePath` - **(optional, 🔥 Firebase only)** String specifying path
+      where Trystero writes its matchmaking data in your database
+      (`'__trystero__'` by default). Changing this is useful if you want to run
+      multiple apps using the same database and don't want to worry about
+      namespace collisions.
 
   - `rtcConfig` - **(optional)** Specifies a custom
     [`RTCConfiguration`](https://developer.mozilla.org/en-US/docs/Web/API/RTCConfiguration)
@@ -727,32 +814,16 @@ the same namespace will return the same room instance.
     constructor. This is useful for running outside of a browser, such as in
     Node (still experimental).
 
-  - `supabaseKey` - **(required, ⚡️ Supabase only)** Your Supabase project's
-    `anon public` API key.
-
-  - `firebaseApp` - **(optional, 🔥 Firebase only)** You can pass an already
-    initialized Firebase app instance instead of an `appId`. Normally Trystero
-    will initialize a Firebase app based on the `appId` but this will fail if
-    you've already initialized it for use elsewhere.
-
-  - `rootPath` - **(optional, 🔥 Firebase only)** String specifying path where
-    Trystero writes its matchmaking data in your database (`'__trystero__'` by
-    default). Changing this is useful if you want to run multiple apps using the
-    same database and don't want to worry about namespace collisions.
-
-  - `manualRelayReconnection` - **(optional, 🐦 Nostr and 🌊 BitTorrent only)**
-    Boolean (default: `false`) that when set to `true` disables automatically
-    pausing and resuming reconnection attempts when the browser goes offline and
-    comes back online. This is useful if you want to manage this behavior
-    yourself.
-
 - `roomId` - A string to namespace peers and events within a room.
 
 - `callbacks` - **(optional)** Callback config object containing:
   - `onJoinError(details)` - Called when room join fails due to an incorrect
-    password or when handshake admission fails (including timeout). `details` is
-    an object containing `appId`, `roomId`, `peerId`, and `error` describing the
-    failure.
+    password, when handshake admission fails (including timeout), or when peers
+    exchange SDP but WebRTC still cannot establish a direct connection. This
+    last case usually means TURN servers are needed or misconfigured (see
+    [Troubleshooting connection issues](#troubleshooting-connection-issues)).
+    `details` is an object containing `appId`, `roomId`, `peerId`, and `error`
+    describing the failure.
 
   - `onPeerHandshake(peerId, send, receive, isInitiator)` - Async predicate that
     runs after the transport connects but before the peer becomes active.
@@ -811,96 +882,100 @@ Returns an object with the following methods:
   for the peers present in room (not including the local user). The keys of this
   object are the respective peers' IDs.
 
-- ### `addStream(stream, [targetPeers], [metadata])`
+- ### `isPassive()`
+
+  Returns whether the room was joined with `passive: true`.
+
+- ### `addStream(stream, [options])`
 
   Broadcasts media stream to other peers.
   - `stream` - A `MediaStream` with audio and/or video to send to peers in the
     room.
 
-  - `targetPeers` - **(optional)** If specified, the stream is sent only to the
-    target peer ID (string) or list of peer IDs (array).
+  - `options.target` - **(optional)** If specified, the stream is sent only to
+    the target peer ID (string) or list of peer IDs (array). Passing `null` or
+    omitting this option sends to all peers in the room.
 
-  - `metadata` - **(optional)** Additional metadata (any serializable type) to
-    be sent with the stream. This is useful when sending multiple streams so
-    recipients know which is which (e.g. a webcam versus a screen capture). If
-    you want to broadcast a stream to all peers in the room with a metadata
-    argument, pass `null` as the second argument.
+  - `options.metadata` - **(optional)** Additional metadata (any serializable
+    type) to be sent with the stream. This is useful when sending multiple
+    streams so recipients know which is which (e.g. a webcam versus a screen
+    capture).
 
-- ### `removeStream(stream, [targetPeers])`
+- ### `removeStream(stream, [options])`
 
   Stops sending previously sent media stream to other peers.
   - `stream` - A previously sent `MediaStream` to stop sending.
 
-  - `targetPeers` - **(optional)** If specified, the stream is removed only from
-    the target peer ID (string) or list of peer IDs (array).
+  - `options.target` - **(optional)** If specified, the stream is removed only
+    from the target peer ID (string) or list of peer IDs (array).
 
-- ### `addTrack(track, stream, [targetPeers], [metadata])`
+- ### `addTrack(track, stream, [options])`
 
   Adds a new media track to a stream.
   - `track` - A `MediaStreamTrack` to add to an existing stream.
 
   - `stream` - The target `MediaStream` to attach the new track to.
 
-  - `targetPeers` - **(optional)** If specified, the track is sent only to the
-    target peer ID (string) or list of peer IDs (array).
+  - `options.target` - **(optional)** If specified, the track is sent only to
+    the target peer ID (string) or list of peer IDs (array).
 
-  - `metadata` - **(optional)** Additional metadata (any serializable type) to
-    be sent with the track. See `metadata` notes for `addStream()` above for
-    more details.
+  - `options.metadata` - **(optional)** Additional metadata (any serializable
+    type) to be sent with the track. See `metadata` notes for `addStream()`
+    above for more details.
 
-- ### `removeTrack(track, [targetPeers])`
+- ### `removeTrack(track, [options])`
 
   Removes a media track.
   - `track` - The `MediaStreamTrack` to remove.
 
-  - `targetPeers` - **(optional)** If specified, the track is removed only from
-    the target peer ID (string) or list of peer IDs (array).
+  - `options.target` - **(optional)** If specified, the track is removed only
+    from the target peer ID (string) or list of peer IDs (array).
 
-- ### `replaceTrack(oldTrack, newTrack, [targetPeers], [metadata])`
+- ### `replaceTrack(oldTrack, newTrack, [options])`
 
   Replaces a media track with a new one.
   - `oldTrack` - The `MediaStreamTrack` to remove.
 
   - `newTrack` - A `MediaStreamTrack` to attach.
 
-  - `targetPeers` - **(optional)** If specified, the track is replaced only for
-    the target peer ID (string) or list of peer IDs (array).
+  - `options.target` - **(optional)** If specified, the track is replaced only
+    for the target peer ID (string) or list of peer IDs (array).
 
-  - `metadata` - **(optional)** Additional metadata (any serializable type) to
-    be sent with the replacement track.
+  - `options.metadata` - **(optional)** Additional metadata (any serializable
+    type) to be sent with the replacement track.
 
-- ### `onPeerJoin(callback)`
+- ### `onPeerJoin`
 
-  Registers a callback function that will be called when a peer joins the room.
-  If called more than once, only the latest callback registered is ever called.
-  Existing active peers are immediately replayed to a newly registered callback.
+  A callback property that will be called when a peer joins the room. Assigning
+  a new function replaces the previous handler; assigning `null` clears it.
+  Existing active peers are immediately replayed to a newly assigned handler.
   - `callback(peerId)` - Function to run whenever a peer joins, called with the
     peer's ID.
 
   Example:
 
   ```js
-  onPeerJoin(peerId => console.log(`${peerId} joined`))
+  room.onPeerJoin = peerId => console.log(`${peerId} joined`)
   ```
 
-- ### `onPeerLeave(callback)`
+- ### `onPeerLeave`
 
-  Registers a callback function that will be called when a peer leaves the room.
-  If called more than once, only the latest callback registered is ever called.
+  A callback property that will be called when a peer leaves the room. Assigning
+  a new function replaces the previous handler; assigning `null` clears it.
   - `callback(peerId)` - Function to run whenever a peer leaves, called with the
     peer's ID.
 
   Example:
 
   ```js
-  onPeerLeave(peerId => console.log(`${peerId} left`))
+  room.onPeerLeave = peerId => console.log(`${peerId} left`)
   ```
 
-- ### `onPeerStream(callback)`
+- ### `onPeerStream`
 
-  Registers a callback function that will be called when a peer sends a media
-  stream. If called more than once, only the latest callback registered is ever
-  called.
+  A callback property that will be called when a peer sends a media stream.
+  Assigning a new function replaces the previous handler; assigning `null`
+  clears it.
   - `callback(stream, peerId, metadata)` - Function to run whenever a peer sends
     a media stream, called with the the peer's stream, ID, and optional metadata
     (see `addStream()` above for details).
@@ -908,16 +983,15 @@ Returns an object with the following methods:
   Example:
 
   ```js
-  onPeerStream((stream, peerId) =>
+  room.onPeerStream = (stream, peerId) =>
     console.log(`got stream from ${peerId}`, stream)
-  )
   ```
 
-- ### `onPeerTrack(callback)`
+- ### `onPeerTrack`
 
-  Registers a callback function that will be called when a peer sends a media
-  track. If called more than once, only the latest callback registered is ever
-  called.
+  A callback property that will be called when a peer sends a media track.
+  Assigning a new function replaces the previous handler; assigning `null`
+  clears it.
   - `callback(track, stream, peerId, metadata)` - Function to run whenever a
     peer sends a media track, called with the the peer's track, attached stream,
     ID, and optional metadata (see `addTrack()` above for details).
@@ -925,78 +999,48 @@ Returns an object with the following methods:
   Example:
 
   ```js
-  onPeerTrack((track, stream, peerId) =>
+  room.onPeerTrack = (track, stream, peerId) =>
     console.log(`got track from ${peerId}`, track)
-  )
   ```
 
-- ### `makeAction(actionId)`
+- ### `makeAction(actionId, [config])`
 
   Listen for and send custom data actions.
   - `actionId` - A string to register this action consistently among all peers.
 
-  Returns an array of three functions:
-  1. #### Sender
-     - Sends data to peers and returns a promise that resolves when all target
-       peers are finished sending locally.
-
-     - `(data, [targetPeers], [metadata], [onProgress])`
-       - `data` - Any value to send (primitive, object, binary). Serialization
-         and chunking is handled automatically. Binary data (e.g. `Blob`,
-         `TypedArray`) is received by other peer as an agnostic `ArrayBuffer`.
-
-       - `targetPeers` - **(optional)** Either a peer ID (string), an array of
-         peer IDs, or `null` (indicating to send to all peers in the room).
-
-       - `metadata` - **(optional)** If the data is binary, you can send an
-         optional metadata object describing it (see
-         [Binary metadata](#binary-metadata)).
+  If `config.kind` is omitted, the action is a one-way message action. Passing
+  `kind: 'request'` creates a request/response action.
 
-       - `onProgress` - **(optional)** A callback function that will be called
-         as every chunk for every peer is transmitted. The function will be
-         called with a value between 0 and 1 and a peer ID. See
-         [Progress updates](#progress-updates) for an example.
+  Message actions expose:
+  - `send(data, [options])` - Sends data to peers and resolves when local
+    sending is complete.
+  - `onMessage` - Nullable callback property for received messages.
+  - `onReceiveProgress` - Nullable callback property for inbound progress.
 
-  2. #### Receiver
-     - Registers a callback function that runs when data for this action is
-       received from other peers.
+  Request actions expose:
+  - `request(data, options)` - Sends to one peer and resolves with its response.
+  - `requestMany(data, options)` - Sends to many peers and resolves with
+    peer-labeled settled results.
+  - `onRequest` - Nullable callback property that returns the response.
+  - `onReceiveProgress` - Nullable callback property for inbound progress.
 
-     - `(data, peerId, metadata)`
-       - `data` - The value transmitted by the sending peer. Deserialization is
-         handled automatically, i.e. a number will be received as a number, an
-         object as an object, etc.
-
-       - `peerId` - The ID string of the sending peer.
-
-       - `metadata` - **(optional)** Optional metadata object supplied by the
-         sender if `data` is binary, e.g. a filename.
-
-  3. #### Progress handler
-     - Registers a callback function that runs when partial data is received
-       from peers. You can use this for tracking large binary transfers. See
-       [Progress updates](#progress-updates) for an example.
-
-     - `(percent, peerId, metadata)`
-       - `percent` - A number between 0 and 1 indicating the percentage complete
-         of the transfer.
-
-       - `peerId` - The ID string of the sending peer.
-
-       - `metadata` - **(optional)** Optional metadata object supplied by the
-         sender.
+  Send options use `target`, `metadata`, `onProgress`, and `signal`. Request
+  options use `target`, `metadata`, `timeoutMs`, `onProgress`, and `signal`.
+  `requestMany()` uses `targets` plus optional `onResult` for each peer result
+  as it arrives.
 
   Example:
 
   ```js
-  const [sendCursor, getCursor] = room.makeAction('cursormove')
+  const cursor = room.makeAction('cursormove')
 
-  window.addEventListener('mousemove', e => sendCursor([e.clientX, e.clientY]))
+  window.addEventListener('mousemove', e => cursor.send([e.clientX, e.clientY]))
 
-  getCursor(([x, y], peerId) => {
+  cursor.onMessage = ([x, y], {peerId}) => {
     const peerCursor = cursorMap[peerId]
     peerCursor.style.left = x + 'px'
     peerCursor.style.top = y + 'px'
-  })
+  }
   ```
 
 - ### `ping(peerId)`
@@ -1009,12 +1053,11 @@ Returns an object with the following methods:
 
   ```js
   // log round-trip time every 2 seconds
-  room.onPeerJoin(peerId =>
+  room.onPeerJoin = peerId =>
     setInterval(
       async () => console.log(`took ${await room.ping(peerId)}ms`),
       2000
     )
-  )
   ```
 
 ### `selfId`
@@ -1024,10 +1067,10 @@ rooms.
 
 ### `getRelaySockets()`
 
-**(🌊 BitTorrent, 🐦 Nostr, 📡 MQTT only)** Returns an object of relay URL keys
-mapped to their WebSocket connections. This can be useful for determining the
-state of the user's connection to the relays and handling any connection
-failures.
+**(🌊 BitTorrent, 🐦 Nostr, 📡 MQTT, 🔌 WebSocket relay only)** Returns an
+object of relay URL keys mapped to their WebSocket connections. This can be
+useful for determining the state of the user's connection to the relays and
+handling any connection failures.
 
 Example:
 
@@ -1044,9 +1087,9 @@ console.log(getRelaySockets())
 ### `pauseRelayReconnection()`
 
 **(🐦 Nostr, 🌊 BitTorrent only)** Normally Trystero will try to automatically
-reconnect to relay sockets unless `manualRelayReconnection: true` is set in the
-room config. Calling this function stops relay reconnection attempts until
-`resumeRelayReconnection()` is called.
+reconnect to relay sockets unless `relayConfig.manualReconnection: true` is set
+in the room config. Calling this function stops relay reconnection attempts
+until `resumeRelayReconnection()` is called.
 
 ### `resumeRelayReconnection()`
 

package/dist/index.d.mts

@@ -1,8 +1,8 @@
-import { BaseRoomConfig, JoinRoom, RelayConfig, pauseRelayReconnection, resumeRelayReconnection, selfId } from "@trystero-p2p/core";
-export * from "@trystero-p2p/core";
+import { JoinRoom, JoinRoomConfig, pauseRelayReconnection, resumeRelayReconnection, selfId } from "@trystero-p2p/core";
+export type * from "@trystero-p2p/core";
 
 //#region src/index.d.ts
-type TorrentRoomConfig = BaseRoomConfig & RelayConfig;
+type TorrentRoomConfig = JoinRoomConfig;
 declare const joinRoom: JoinRoom<TorrentRoomConfig>;
 declare const getRelaySockets: any;
 declare const defaultRelayUrls: string[];

package/dist/index.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.mts","names":[],"sources":["../src/index.ts"],"mappings":";;;;KA+CY,iBAAA,GAAoB,cAAA,GAAiB,WAAA;AAAA,cA6VpC,QAAA,EAAU,QAAA,CAAS,iBAAA;AAAA,cAcnB,eAAA;AAAA,cAIA,gBAAA"}
+{"version":3,"file":"index.d.mts","names":[],"sources":["../src/index.ts"],"mappings":";;;;KAmDY,iBAAA,GAAoB,cAAc;AAAA,cA6ZjC,QAAA,EAAU,QAAQ,CAAC,iBAAA;AAAA,cAcnB,eAAA;AAAA,cAIA,gBAAA"}

package/dist/index.mjs

@@ -9,6 +9,7 @@ const subscriptionTokens = relayManager.scoped();
 const trackerAnnounceMs = {};
 const handledSignals = {};
 const msgHandlers = relayManager.scoped();
+const topicStates = relayManager.scoped();
 const roomOutstandingOffers = {};
 const roomOfferGenerationPromises = {};
 const roomSubscriberCounts = {};
@@ -16,6 +17,7 @@ const trackerAction = "announce";
 const hashLimit = 20;
 const offerPoolSize = 3;
 const defaultAnnounceMs = 1e4;
+const dormantAnnounceMs = 12e4;
 const maxAnnounceMs = 2e4;
 const offerRetentionMs = 12e4;
 const signalDedupeWindowMs = 4e3;
@@ -125,11 +127,12 @@ const joinRoomStrategy = createStrategy({
 		}));
 		return client.ready;
 	}),
-	subscribe: (client, rootTopic, _, onMessage, getOffers) => {
+	subscribe: (client, rootTopic, _, onMessage, getOffers, context) => {
 		const handlers = msgHandlers.forRelay(client);
 		const relayFns = announceFns.forRelay(client);
 		const relayIntervals = announceIntervals.forRelay(client);
 		const activeTokens = subscriptionTokens.forRelay(client);
+		const states = topicStates.forRelay(client);
 		const subscriptionToken = Symbol(rootTopic);
 		activeTokens[rootTopic] = subscriptionToken;
 		roomSubscriberCounts[rootTopic] = (roomSubscriberCounts[rootTopic] ?? 0) + 1;
@@ -156,28 +159,45 @@ const joinRoomStrategy = createStrategy({
 			}
 		};
 		handlers[rootTopic] = topicHandler;
-		const announce = async () => {
-			if (activeTokens[rootTopic] !== subscriptionToken) return;
-			send(client, rootTopic, {
-				numwant: offerPoolSize,
-				offers: entries(await ensureOutstandingOffers(rootTopic, getOffers)).map(([id, { offer }]) => ({
-					offer_id: id,
-					offer: {
-						type: "offer",
-						sdp: offer
-					}
-				}))
-			});
+		const topicState = {
+			announce: async () => {
+				if (activeTokens[rootTopic] !== subscriptionToken) return;
+				if (!topicState.isActive) {
+					send(client, rootTopic, {
+						left: 0,
+						numwant: offerPoolSize,
+						offers: []
+					});
+					return;
+				}
+				send(client, rootTopic, {
+					numwant: offerPoolSize,
+					offers: entries(await ensureOutstandingOffers(rootTopic, getOffers)).map(([id, { offer }]) => ({
+						offer_id: id,
+						offer: {
+							type: "offer",
+							sdp: offer
+						}
+					}))
+				});
+			},
+			isActive: !context?.isPassive
 		};
 		trackerAnnounceMs[client.url] = defaultAnnounceMs;
+		const { announce } = topicState;
 		relayFns[rootTopic] = announce;
-		relayIntervals[rootTopic] = setInterval(announce, trackerAnnounceMs[client.url]);
+		states[rootTopic] = topicState;
+		const initialInterval = topicState.isActive ? trackerAnnounceMs[client.url] : dormantAnnounceMs;
+		relayIntervals[rootTopic] = setInterval(announce, initialInterval);
 		announce();
 		return () => {
 			roomSubscriberCounts[rootTopic] = Math.max(0, (roomSubscriberCounts[rootTopic] ?? 1) - 1);
 			if (!roomSubscriberCounts[rootTopic]) delete roomSubscriberCounts[rootTopic];
 			if (activeTokens[rootTopic] !== subscriptionToken) {
-				if (!roomSubscriberCounts[rootTopic]) reclaimAllOutstandingOffers(rootTopic);
+				if (!roomSubscriberCounts[rootTopic]) {
+					reclaimAllOutstandingOffers(rootTopic);
+					delete states[rootTopic];
+				}
 				return;
 			}
 			const interval = relayIntervals[rootTopic];
@@ -188,10 +208,38 @@ const joinRoomStrategy = createStrategy({
 			if (handlers[rootTopic] === topicHandler) delete handlers[rootTopic];
 			if (relayFns[rootTopic] === announce) delete relayFns[rootTopic];
 			delete activeTokens[rootTopic];
+			if (states[rootTopic] === topicState) delete states[rootTopic];
 			if (!roomSubscriberCounts[rootTopic]) reclaimAllOutstandingOffers(rootTopic);
 		};
 	},
-	announce: (client) => trackerAnnounceMs[client.url]
+	announce: (client, rootTopic) => {
+		const state = topicStates.forRelay(client)[rootTopic];
+		const relayIntervals = announceIntervals.forRelay(client);
+		const fn = announceFns.forRelay(client)[rootTopic];
+		if (state) state.isActive = true;
+		if (fn && relayIntervals[rootTopic]) {
+			clearInterval(relayIntervals[rootTopic]);
+			relayIntervals[rootTopic] = setInterval(() => {
+				fn();
+			}, trackerAnnounceMs[client.url]);
+			fn();
+		}
+		return trackerAnnounceMs[client.url];
+	},
+	deactivate: (client, rootTopic) => {
+		const state = topicStates.forRelay(client)[rootTopic];
+		const relayIntervals = announceIntervals.forRelay(client);
+		const fn = announceFns.forRelay(client)[rootTopic];
+		if (state) state.isActive = false;
+		reclaimAllOutstandingOffers(rootTopic);
+		if (fn && relayIntervals[rootTopic]) {
+			clearInterval(relayIntervals[rootTopic]);
+			relayIntervals[rootTopic] = setInterval(() => {
+				fn();
+			}, dormantAnnounceMs);
+			fn();
+		}
+	}
 });
 const joinRoom = (config, roomId, callbacks) => joinRoomStrategy({
 	...config,

package/dist/index.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.mjs","names":[],"sources":["../src/index.ts"],"sourcesContent":["import {\n  createRelayManager,\n  createStrategy,\n  entries,\n  fromJson,\n  genId,\n  getRelays,\n  keys,\n  libName,\n  makeSocket,\n  pauseRelayReconnection,\n  resumeRelayReconnection,\n  selfId,\n  sha1,\n  toJson,\n  type BaseRoomConfig,\n  type JoinRoom,\n  type OfferRecord,\n  type RelayConfig,\n  type SocketClient\n} from '@trystero-p2p/core'\n\nconst relayManager = createRelayManager<SocketClient>(client => client.socket)\nconst topicToInfoHash: Record<string, string> = {}\nconst infoHashToTopic: Record<string, string> = {}\nconst announceIntervals = relayManager.scoped<ReturnType<typeof setInterval>>()\nconst announceFns = relayManager.scoped<() => void | Promise<void>>()\nconst subscriptionTokens = relayManager.scoped<symbol>()\nconst trackerAnnounceMs: Record<string, number> = {}\nconst handledSignals: Record<string, number> = {}\nconst msgHandlers = relayManager.scoped<(data: TrackerMessage) => void>()\nconst roomOutstandingOffers: Record<\n  string,\n  Record<string, OfferRecord & {createdAt: number}>\n> = {}\nconst roomOfferGenerationPromises: Record<string, Promise<void> | undefined> =\n  {}\nconst roomSubscriberCounts: Record<string, number> = {}\nconst trackerAction = 'announce'\nconst hashLimit = 20\nconst offerPoolSize = 3\nconst defaultAnnounceMs = 10_000\nconst maxAnnounceMs = 20_000\nconst offerRetentionMs = 120_000\nconst signalDedupeWindowMs = 4_000\nconst defaultRedundancy = 3\n\nexport type TorrentRoomConfig = BaseRoomConfig & RelayConfig\n\ntype TrackerMessage = {\n  offer?: {\n    type: 'offer'\n    sdp: string\n  }\n  answer?: {\n    type: 'answer'\n    sdp: string\n  }\n  offer_id?: string\n  peer_id?: string\n  info_hash?: string\n  interval?: number\n  ['failure reason']?: string\n  ['warning message']?: string\n}\n\nconst getInfoHash = async (topic: string): Promise<string> => {\n  if (topicToInfoHash[topic]) {\n    return topicToInfoHash[topic]\n  }\n\n  const hash = (await sha1(topic)).slice(0, hashLimit)\n  topicToInfoHash[topic] = hash\n  infoHashToTopic[hash] = topic\n\n  return hash\n}\n\nconst send = async (\n  client: SocketClient,\n  topic: string,\n  payload: Record<string, unknown>\n): Promise<void> =>\n  client.send(\n    toJson({\n      action: trackerAction,\n      info_hash: await getInfoHash(topic),\n      peer_id: selfId,\n      ...payload\n    })\n  )\n\nconst warn = (url: string, msg: string, didFail = false): void =>\n  console.warn(\n    `${libName}: torrent tracker ${didFail ? 'failure' : 'warning'} from ${url} - ${msg}`\n  )\n\nconst getRoomOutstandingOffers = (\n  rootTopic: string\n): Record<string, OfferRecord & {createdAt: number}> =>\n  (roomOutstandingOffers[rootTopic] ??= {})\n\nconst deleteRoomOfferBookkeeping = (rootTopic: string): void => {\n  delete roomOutstandingOffers[rootTopic]\n  delete roomOfferGenerationPromises[rootTopic]\n}\n\nconst claimOutstandingOffer = (\n  rootTopic: string,\n  offerId: string\n): OfferRecord | undefined => {\n  const outstandingOffers = roomOutstandingOffers[rootTopic]\n  const offer = outstandingOffers?.[offerId]\n\n  if (!offer) {\n    return\n  }\n\n  delete outstandingOffers[offerId]\n  offer.claim?.()\n\n  if (!keys(outstandingOffers).length && !roomSubscriberCounts[rootTopic]) {\n    deleteRoomOfferBookkeeping(rootTopic)\n  }\n\n  return offer\n}\n\nconst reclaimOutstandingOffer = (rootTopic: string, offerId: string): void => {\n  const outstandingOffers = roomOutstandingOffers[rootTopic]\n  const offer = outstandingOffers?.[offerId]\n\n  if (!offer) {\n    return\n  }\n\n  delete outstandingOffers[offerId]\n  offer.reclaim?.()\n\n  if (!keys(outstandingOffers).length && !roomSubscriberCounts[rootTopic]) {\n    deleteRoomOfferBookkeeping(rootTopic)\n  }\n}\n\nconst reclaimAllOutstandingOffers = (rootTopic: string): void => {\n  keys(getRoomOutstandingOffers(rootTopic)).forEach(offerId =>\n    reclaimOutstandingOffer(rootTopic, offerId)\n  )\n  deleteRoomOfferBookkeeping(rootTopic)\n}\n\nconst pruneOutstandingOffers = (rootTopic: string): void => {\n  const now = Date.now()\n\n  entries(getRoomOutstandingOffers(rootTopic)).forEach(([offerId, offer]) => {\n    if (now - offer.createdAt > offerRetentionMs) {\n      reclaimOutstandingOffer(rootTopic, offerId)\n    }\n  })\n}\n\nconst ensureOutstandingOffers = async (\n  rootTopic: string,\n  getOffers: (n: number) => Promise<OfferRecord[]>\n): Promise<Record<string, OfferRecord & {createdAt: number}>> => {\n  while (roomOfferGenerationPromises[rootTopic]) {\n    await roomOfferGenerationPromises[rootTopic]\n  }\n\n  const nextPromise = (async () => {\n    pruneOutstandingOffers(rootTopic)\n\n    const outstandingOffers = getRoomOutstandingOffers(rootTopic)\n    const outstandingCount = keys(outstandingOffers).length\n    const missingOffers = Math.max(0, offerPoolSize - outstandingCount)\n\n    if (missingOffers > 0) {\n      ;(await getOffers(missingOffers)).forEach(peerAndOffer => {\n        outstandingOffers[genId(hashLimit)] = {\n          ...peerAndOffer,\n          createdAt: Date.now()\n        }\n      })\n    }\n  })().finally(() => {\n    if (roomOfferGenerationPromises[rootTopic] === nextPromise) {\n      delete roomOfferGenerationPromises[rootTopic]\n    }\n  })\n\n  roomOfferGenerationPromises[rootTopic] = nextPromise\n  await nextPromise\n\n  return getRoomOutstandingOffers(rootTopic)\n}\n\nconst joinRoomStrategy: JoinRoom<TorrentRoomConfig> = createStrategy({\n  init: config =>\n    getRelays(config, defaultRelayUrls, defaultRedundancy).map(rawUrl => {\n      const client = relayManager.register(\n        rawUrl,\n        makeSocket(rawUrl, rawData => {\n          const data = fromJson<TrackerMessage>(rawData)\n          const errMsg = data['failure reason']\n          const warnMsg = data['warning message']\n          const {interval} = data\n          const topic = data.info_hash\n            ? infoHashToTopic[data.info_hash]\n            : undefined\n\n          if (errMsg) {\n            warn(client.url, errMsg, true)\n            return\n          }\n\n          if (warnMsg) {\n            warn(client.url, warnMsg)\n          }\n\n          if (\n            interval &&\n            interval * 1000 >\n              (trackerAnnounceMs[client.url] ?? defaultAnnounceMs) &&\n            topic &&\n            announceFns.forKey(rawUrl)[topic]\n          ) {\n            const nextInterval = Math.min(interval * 1000, maxAnnounceMs)\n            const relayIntervals = announceIntervals.forKey(rawUrl)\n            const relayFns = announceFns.forKey(rawUrl)\n\n            if (relayIntervals[topic]) {\n              clearInterval(relayIntervals[topic])\n            }\n            trackerAnnounceMs[client.url] = nextInterval\n            const relayFn = relayFns[topic]\n\n            if (relayFn) {\n              relayIntervals[topic] = setInterval(() => {\n                void relayFn()\n              }, nextInterval)\n            }\n          }\n\n          if ((data.offer || data.answer) && topic && data.offer_id) {\n            if (data.peer_id === selfId) {\n              return\n            }\n\n            const signalType = data.offer ? 'offer' : 'answer'\n            const signalKey = `${topic}:${signalType}:${data.offer_id}:${data.peer_id ?? ''}`\n            const nowMs = Date.now()\n            const lastHandledMs = handledSignals[signalKey]\n\n            if (\n              typeof lastHandledMs === 'number' &&\n              nowMs - lastHandledMs < signalDedupeWindowMs\n            ) {\n              return\n            }\n\n            handledSignals[signalKey] = nowMs\n\n            entries(handledSignals).forEach(([key, handledAtMs]) => {\n              if (nowMs - handledAtMs > signalDedupeWindowMs * 6) {\n                delete handledSignals[key]\n              }\n            })\n\n            msgHandlers.forKey(rawUrl)[topic]?.(data)\n          }\n        })\n      )\n\n      return client.ready\n    }),\n\n  subscribe: (client, rootTopic, _, onMessage, getOffers) => {\n    const handlers = msgHandlers.forRelay(client)\n    const relayFns = announceFns.forRelay(client)\n    const relayIntervals = announceIntervals.forRelay(client)\n    const activeTokens = subscriptionTokens.forRelay(client)\n    const subscriptionToken = Symbol(rootTopic)\n\n    activeTokens[rootTopic] = subscriptionToken\n    roomSubscriberCounts[rootTopic] = (roomSubscriberCounts[rootTopic] ?? 0) + 1\n\n    const topicHandler = (data: TrackerMessage): void => {\n      if (data.offer && data.peer_id && data.offer_id) {\n        void onMessage(\n          rootTopic,\n          {\n            offer: data.offer.sdp,\n            peerId: data.peer_id,\n            hasOutgoingOffer:\n              keys(getRoomOutstandingOffers(rootTopic)).length > 0\n          },\n          (_, signal) =>\n            void send(client, rootTopic, {\n              answer: {\n                type: 'answer',\n                sdp: fromJson<{answer: string}>(signal).answer\n              },\n              offer_id: data.offer_id,\n              to_peer_id: data.peer_id\n            })\n        )\n      } else if (data.answer && data.offer_id && data.peer_id) {\n        const offer = claimOutstandingOffer(rootTopic, data.offer_id)\n\n        if (offer) {\n          void onMessage(\n            rootTopic,\n            {\n              answer: data.answer.sdp,\n              peerId: data.peer_id,\n              peer: offer.peer\n            },\n            () => {}\n          )\n        }\n      }\n    }\n\n    handlers[rootTopic] = topicHandler\n\n    const announce = async (): Promise<void> => {\n      if (activeTokens[rootTopic] !== subscriptionToken) {\n        return\n      }\n\n      const outstandingOffers = await ensureOutstandingOffers(\n        rootTopic,\n        getOffers\n      )\n      const offers = entries(outstandingOffers).map(([id, {offer}]) => ({\n        offer_id: id,\n        offer: {type: 'offer', sdp: offer}\n      }))\n\n      void send(client, rootTopic, {\n        numwant: offerPoolSize,\n        offers\n      })\n    }\n\n    trackerAnnounceMs[client.url] = defaultAnnounceMs\n    relayFns[rootTopic] = announce\n    relayIntervals[rootTopic] = setInterval(\n      announce,\n      trackerAnnounceMs[client.url]\n    )\n    void announce()\n\n    return () => {\n      roomSubscriberCounts[rootTopic] = Math.max(\n        0,\n        (roomSubscriberCounts[rootTopic] ?? 1) - 1\n      )\n\n      if (!roomSubscriberCounts[rootTopic]) {\n        delete roomSubscriberCounts[rootTopic]\n      }\n\n      if (activeTokens[rootTopic] !== subscriptionToken) {\n        if (!roomSubscriberCounts[rootTopic]) {\n          reclaimAllOutstandingOffers(rootTopic)\n        }\n\n        return\n      }\n\n      const interval = relayIntervals[rootTopic]\n      if (interval) {\n        clearInterval(interval)\n        delete relayIntervals[rootTopic]\n      }\n\n      if (handlers[rootTopic] === topicHandler) {\n        delete handlers[rootTopic]\n      }\n\n      if (relayFns[rootTopic] === announce) {\n        delete relayFns[rootTopic]\n      }\n\n      delete activeTokens[rootTopic]\n\n      if (!roomSubscriberCounts[rootTopic]) {\n        reclaimAllOutstandingOffers(rootTopic)\n      }\n    }\n  },\n\n  announce: client => trackerAnnounceMs[client.url]\n})\n\nexport const joinRoom: JoinRoom<TorrentRoomConfig> = (\n  config,\n  roomId,\n  callbacks\n) =>\n  joinRoomStrategy(\n    {\n      ...config,\n      trickleIce: config.trickleIce ?? false\n    },\n    roomId,\n    callbacks\n  )\n\nexport const getRelaySockets = relayManager.getSockets\n\nexport {pauseRelayReconnection, resumeRelayReconnection, selfId}\n\nexport const defaultRelayUrls = [\n  'tracker.webtorrent.dev',\n  'tracker.openwebtorrent.com',\n  'tracker.btorrent.xyz',\n  'tracker.files.fm:7073/announce'\n].map(url => 'wss://' + url)\n\nexport type * from '@trystero-p2p/core'\n"],"mappings":"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"}
+{"version":3,"file":"index.mjs","names":[],"sources":["../src/index.ts"],"sourcesContent":["import {\n  createRelayManager,\n  createStrategy,\n  entries,\n  fromJson,\n  genId,\n  getRelays,\n  keys,\n  libName,\n  makeSocket,\n  pauseRelayReconnection,\n  resumeRelayReconnection,\n  selfId,\n  sha1,\n  toJson,\n  type JoinRoom,\n  type JoinRoomConfig,\n  type OfferRecord,\n  type SocketClient\n} from '@trystero-p2p/core'\n\nconst relayManager = createRelayManager<SocketClient>(client => client.socket)\nconst topicToInfoHash: Record<string, string> = {}\nconst infoHashToTopic: Record<string, string> = {}\nconst announceIntervals = relayManager.scoped<ReturnType<typeof setInterval>>()\nconst announceFns = relayManager.scoped<() => void | Promise<void>>()\nconst subscriptionTokens = relayManager.scoped<symbol>()\nconst trackerAnnounceMs: Record<string, number> = {}\nconst handledSignals: Record<string, number> = {}\nconst msgHandlers = relayManager.scoped<(data: TrackerMessage) => void>()\nconst topicStates = relayManager.scoped<{\n  announce: () => void | Promise<void>\n  isActive: boolean\n}>()\nconst roomOutstandingOffers: Record<\n  string,\n  Record<string, OfferRecord & {createdAt: number}>\n> = {}\nconst roomOfferGenerationPromises: Record<string, Promise<void> | undefined> =\n  {}\nconst roomSubscriberCounts: Record<string, number> = {}\nconst trackerAction = 'announce'\nconst hashLimit = 20\nconst offerPoolSize = 3\nconst defaultAnnounceMs = 10_000\nconst dormantAnnounceMs = 120_000\nconst maxAnnounceMs = 20_000\nconst offerRetentionMs = 120_000\nconst signalDedupeWindowMs = 4_000\nconst defaultRedundancy = 3\n\nexport type TorrentRoomConfig = JoinRoomConfig\n\ntype TrackerMessage = {\n  offer?: {\n    type: 'offer'\n    sdp: string\n  }\n  answer?: {\n    type: 'answer'\n    sdp: string\n  }\n  offer_id?: string\n  peer_id?: string\n  info_hash?: string\n  interval?: number\n  ['failure reason']?: string\n  ['warning message']?: string\n}\n\nconst getInfoHash = async (topic: string): Promise<string> => {\n  if (topicToInfoHash[topic]) {\n    return topicToInfoHash[topic]\n  }\n\n  const hash = (await sha1(topic)).slice(0, hashLimit)\n  topicToInfoHash[topic] = hash\n  infoHashToTopic[hash] = topic\n\n  return hash\n}\n\nconst send = async (\n  client: SocketClient,\n  topic: string,\n  payload: Record<string, unknown>\n): Promise<void> =>\n  client.send(\n    toJson({\n      action: trackerAction,\n      info_hash: await getInfoHash(topic),\n      peer_id: selfId,\n      ...payload\n    })\n  )\n\nconst warn = (url: string, msg: string, didFail = false): void =>\n  console.warn(\n    `${libName}: torrent tracker ${didFail ? 'failure' : 'warning'} from ${url} - ${msg}`\n  )\n\nconst getRoomOutstandingOffers = (\n  rootTopic: string\n): Record<string, OfferRecord & {createdAt: number}> =>\n  (roomOutstandingOffers[rootTopic] ??= {})\n\nconst deleteRoomOfferBookkeeping = (rootTopic: string): void => {\n  delete roomOutstandingOffers[rootTopic]\n  delete roomOfferGenerationPromises[rootTopic]\n}\n\nconst claimOutstandingOffer = (\n  rootTopic: string,\n  offerId: string\n): OfferRecord | undefined => {\n  const outstandingOffers = roomOutstandingOffers[rootTopic]\n  const offer = outstandingOffers?.[offerId]\n\n  if (!offer) {\n    return\n  }\n\n  delete outstandingOffers[offerId]\n  offer.claim?.()\n\n  if (!keys(outstandingOffers).length && !roomSubscriberCounts[rootTopic]) {\n    deleteRoomOfferBookkeeping(rootTopic)\n  }\n\n  return offer\n}\n\nconst reclaimOutstandingOffer = (rootTopic: string, offerId: string): void => {\n  const outstandingOffers = roomOutstandingOffers[rootTopic]\n  const offer = outstandingOffers?.[offerId]\n\n  if (!offer) {\n    return\n  }\n\n  delete outstandingOffers[offerId]\n  offer.reclaim?.()\n\n  if (!keys(outstandingOffers).length && !roomSubscriberCounts[rootTopic]) {\n    deleteRoomOfferBookkeeping(rootTopic)\n  }\n}\n\nconst reclaimAllOutstandingOffers = (rootTopic: string): void => {\n  keys(getRoomOutstandingOffers(rootTopic)).forEach(offerId =>\n    reclaimOutstandingOffer(rootTopic, offerId)\n  )\n  deleteRoomOfferBookkeeping(rootTopic)\n}\n\nconst pruneOutstandingOffers = (rootTopic: string): void => {\n  const now = Date.now()\n\n  entries(getRoomOutstandingOffers(rootTopic)).forEach(([offerId, offer]) => {\n    if (now - offer.createdAt > offerRetentionMs) {\n      reclaimOutstandingOffer(rootTopic, offerId)\n    }\n  })\n}\n\nconst ensureOutstandingOffers = async (\n  rootTopic: string,\n  getOffers: (n: number) => Promise<OfferRecord[]>\n): Promise<Record<string, OfferRecord & {createdAt: number}>> => {\n  while (roomOfferGenerationPromises[rootTopic]) {\n    await roomOfferGenerationPromises[rootTopic]\n  }\n\n  const nextPromise = (async () => {\n    pruneOutstandingOffers(rootTopic)\n\n    const outstandingOffers = getRoomOutstandingOffers(rootTopic)\n    const outstandingCount = keys(outstandingOffers).length\n    const missingOffers = Math.max(0, offerPoolSize - outstandingCount)\n\n    if (missingOffers > 0) {\n      ;(await getOffers(missingOffers)).forEach(peerAndOffer => {\n        outstandingOffers[genId(hashLimit)] = {\n          ...peerAndOffer,\n          createdAt: Date.now()\n        }\n      })\n    }\n  })().finally(() => {\n    if (roomOfferGenerationPromises[rootTopic] === nextPromise) {\n      delete roomOfferGenerationPromises[rootTopic]\n    }\n  })\n\n  roomOfferGenerationPromises[rootTopic] = nextPromise\n  await nextPromise\n\n  return getRoomOutstandingOffers(rootTopic)\n}\n\nconst joinRoomStrategy: JoinRoom<TorrentRoomConfig> = createStrategy({\n  init: config =>\n    getRelays(config, defaultRelayUrls, defaultRedundancy).map(rawUrl => {\n      const client = relayManager.register(\n        rawUrl,\n        makeSocket(rawUrl, rawData => {\n          const data = fromJson<TrackerMessage>(rawData)\n          const errMsg = data['failure reason']\n          const warnMsg = data['warning message']\n          const {interval} = data\n          const topic = data.info_hash\n            ? infoHashToTopic[data.info_hash]\n            : undefined\n\n          if (errMsg) {\n            warn(client.url, errMsg, true)\n            return\n          }\n\n          if (warnMsg) {\n            warn(client.url, warnMsg)\n          }\n\n          if (\n            interval &&\n            interval * 1000 >\n              (trackerAnnounceMs[client.url] ?? defaultAnnounceMs) &&\n            topic &&\n            announceFns.forKey(rawUrl)[topic]\n          ) {\n            const nextInterval = Math.min(interval * 1000, maxAnnounceMs)\n            const relayIntervals = announceIntervals.forKey(rawUrl)\n            const relayFns = announceFns.forKey(rawUrl)\n\n            if (relayIntervals[topic]) {\n              clearInterval(relayIntervals[topic])\n            }\n            trackerAnnounceMs[client.url] = nextInterval\n            const relayFn = relayFns[topic]\n\n            if (relayFn) {\n              relayIntervals[topic] = setInterval(() => {\n                void relayFn()\n              }, nextInterval)\n            }\n          }\n\n          if ((data.offer || data.answer) && topic && data.offer_id) {\n            if (data.peer_id === selfId) {\n              return\n            }\n\n            const signalType = data.offer ? 'offer' : 'answer'\n            const signalKey = `${topic}:${signalType}:${data.offer_id}:${data.peer_id ?? ''}`\n            const nowMs = Date.now()\n            const lastHandledMs = handledSignals[signalKey]\n\n            if (\n              typeof lastHandledMs === 'number' &&\n              nowMs - lastHandledMs < signalDedupeWindowMs\n            ) {\n              return\n            }\n\n            handledSignals[signalKey] = nowMs\n\n            entries(handledSignals).forEach(([key, handledAtMs]) => {\n              if (nowMs - handledAtMs > signalDedupeWindowMs * 6) {\n                delete handledSignals[key]\n              }\n            })\n\n            msgHandlers.forKey(rawUrl)[topic]?.(data)\n          }\n        })\n      )\n\n      return client.ready\n    }),\n\n  subscribe: (client, rootTopic, _, onMessage, getOffers, context) => {\n    const handlers = msgHandlers.forRelay(client)\n    const relayFns = announceFns.forRelay(client)\n    const relayIntervals = announceIntervals.forRelay(client)\n    const activeTokens = subscriptionTokens.forRelay(client)\n    const states = topicStates.forRelay(client)\n    const subscriptionToken = Symbol(rootTopic)\n\n    activeTokens[rootTopic] = subscriptionToken\n    roomSubscriberCounts[rootTopic] = (roomSubscriberCounts[rootTopic] ?? 0) + 1\n\n    const topicHandler = (data: TrackerMessage): void => {\n      if (data.offer && data.peer_id && data.offer_id) {\n        void onMessage(\n          rootTopic,\n          {\n            offer: data.offer.sdp,\n            peerId: data.peer_id,\n            hasOutgoingOffer:\n              keys(getRoomOutstandingOffers(rootTopic)).length > 0\n          },\n          (_, signal) =>\n            void send(client, rootTopic, {\n              answer: {\n                type: 'answer',\n                sdp: fromJson<{answer: string}>(signal).answer\n              },\n              offer_id: data.offer_id,\n              to_peer_id: data.peer_id\n            })\n        )\n      } else if (data.answer && data.offer_id && data.peer_id) {\n        const offer = claimOutstandingOffer(rootTopic, data.offer_id)\n\n        if (offer) {\n          void onMessage(\n            rootTopic,\n            {\n              answer: data.answer.sdp,\n              peerId: data.peer_id,\n              peer: offer.peer\n            },\n            () => {}\n          )\n        }\n      }\n    }\n\n    handlers[rootTopic] = topicHandler\n\n    const topicState: {\n      announce: () => void | Promise<void>\n      isActive: boolean\n    } = {\n      announce: async () => {\n        if (activeTokens[rootTopic] !== subscriptionToken) {\n          return\n        }\n\n        if (!topicState.isActive) {\n          void send(client, rootTopic, {\n            left: 0,\n            numwant: offerPoolSize,\n            offers: []\n          })\n          return\n        }\n\n        const outstandingOffers = await ensureOutstandingOffers(\n          rootTopic,\n          getOffers\n        )\n        const offers = entries(outstandingOffers).map(([id, {offer}]) => ({\n          offer_id: id,\n          offer: {type: 'offer', sdp: offer}\n        }))\n\n        void send(client, rootTopic, {\n          numwant: offerPoolSize,\n          offers\n        })\n      },\n      isActive: !context?.isPassive\n    }\n\n    trackerAnnounceMs[client.url] = defaultAnnounceMs\n    const {announce} = topicState\n    relayFns[rootTopic] = announce\n    states[rootTopic] = topicState\n    const initialInterval = topicState.isActive\n      ? trackerAnnounceMs[client.url]\n      : dormantAnnounceMs\n\n    relayIntervals[rootTopic] = setInterval(announce, initialInterval)\n    void announce()\n\n    return () => {\n      roomSubscriberCounts[rootTopic] = Math.max(\n        0,\n        (roomSubscriberCounts[rootTopic] ?? 1) - 1\n      )\n\n      if (!roomSubscriberCounts[rootTopic]) {\n        delete roomSubscriberCounts[rootTopic]\n      }\n\n      if (activeTokens[rootTopic] !== subscriptionToken) {\n        if (!roomSubscriberCounts[rootTopic]) {\n          reclaimAllOutstandingOffers(rootTopic)\n          delete states[rootTopic]\n        }\n\n        return\n      }\n\n      const interval = relayIntervals[rootTopic]\n      if (interval) {\n        clearInterval(interval)\n        delete relayIntervals[rootTopic]\n      }\n\n      if (handlers[rootTopic] === topicHandler) {\n        delete handlers[rootTopic]\n      }\n\n      if (relayFns[rootTopic] === announce) {\n        delete relayFns[rootTopic]\n      }\n\n      delete activeTokens[rootTopic]\n\n      if (states[rootTopic] === topicState) {\n        delete states[rootTopic]\n      }\n\n      if (!roomSubscriberCounts[rootTopic]) {\n        reclaimAllOutstandingOffers(rootTopic)\n      }\n    }\n  },\n\n  announce: (client, rootTopic) => {\n    const state = topicStates.forRelay(client)[rootTopic]\n    const relayIntervals = announceIntervals.forRelay(client)\n    const relayFns = announceFns.forRelay(client)\n    const fn = relayFns[rootTopic]\n\n    if (state) {\n      state.isActive = true\n    }\n\n    if (fn && relayIntervals[rootTopic]) {\n      clearInterval(relayIntervals[rootTopic])\n      relayIntervals[rootTopic] = setInterval(() => {\n        void fn()\n      }, trackerAnnounceMs[client.url])\n      void fn()\n    }\n\n    return trackerAnnounceMs[client.url]\n  },\n\n  deactivate: (client, rootTopic) => {\n    const state = topicStates.forRelay(client)[rootTopic]\n    const relayIntervals = announceIntervals.forRelay(client)\n    const relayFns = announceFns.forRelay(client)\n    const fn = relayFns[rootTopic]\n\n    if (state) {\n      state.isActive = false\n    }\n\n    reclaimAllOutstandingOffers(rootTopic)\n\n    if (fn && relayIntervals[rootTopic]) {\n      clearInterval(relayIntervals[rootTopic])\n      relayIntervals[rootTopic] = setInterval(() => {\n        void fn()\n      }, dormantAnnounceMs)\n      void fn()\n    }\n  }\n})\n\nexport const joinRoom: JoinRoom<TorrentRoomConfig> = (\n  config,\n  roomId,\n  callbacks\n) =>\n  joinRoomStrategy(\n    {\n      ...config,\n      trickleIce: config.trickleIce ?? false\n    },\n    roomId,\n    callbacks\n  )\n\nexport const getRelaySockets = relayManager.getSockets\n\nexport {pauseRelayReconnection, resumeRelayReconnection, selfId}\n\nexport const defaultRelayUrls = [\n  'tracker.webtorrent.dev',\n  'tracker.openwebtorrent.com',\n  'tracker.btorrent.xyz',\n  'tracker.files.fm:7073/announce'\n].map(url => 'wss://' + url)\n\nexport type * from '@trystero-p2p/core'\n"],"mappings":"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"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@trystero-p2p/torrent",
-  "version": "0.23.1",
-  "description": "Torrent tracker strategy for Trystero",
+  "version": "0.25.0",
+  "description": "Simple, serverless WebRTC (via Torrent)",
   "keywords": [
     "bittorrent",
     "chat",
@@ -15,6 +15,7 @@
     "serverless",
     "signaling",
     "torrent",
+    "trystero",
     "webrtc",
     "webtorrent"
   ],
@@ -34,6 +35,6 @@
     "./package.json": "./package.json"
   },
   "dependencies": {
-    "@trystero-p2p/core": "0.23.1"
+    "@trystero-p2p/core": "0.25.0"
   }
 }