@trystero-p2p/torrent 0.23.0 → 0.24.0

package/README.md

@@ -0,0 +1,1113 @@
+# ✨🤝✨ Trystero
+
+**Build instant multiplayer web apps, no server required**
+
+👉 **[Try it live on trystero.dev](https://trystero.dev)** 👈
+
+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,
+🪐 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:
+
+- 👂📣 Rooms / broadcasting
+- 🔢📩 Automatic serialization / deserialization of data
+- 🎥🏷 Attach metadata to binary data and media streams
+- ✂️⏳ Automatic chunking and throttling of large data
+- ⏱🤞 Progress events and promises for data transfers
+- 🔐📝 Session data encryption
+- 🏭⚡ Can run peers server-side on Node and Bun
+- ⚛️🪝 React hooks
+
+You can see what people are building with Trystero
+[here](https://github.com/jeremyckahn/awesome-trystero).
+
+---
+
+## Contents
+
+- [How it works](#how-it-works)
+- [Get started](#get-started)
+- [Listen for events](#listen-for-events)
+- [Broadcast events](#broadcast-events)
+- [Audio and video](#audio-and-video)
+- [Advanced](#advanced)
+  - [Binary metadata](#binary-metadata)
+  - [Action promises](#action-promises)
+  - [Progress updates](#progress-updates)
+  - [Encryption](#encryption)
+  - [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)
+- [API](#api)
+  - [`joinRoom(config, roomId, [callbacks])`](#joinroomconfig-roomid-callbacks)
+  - [`selfId`](#selfid)
+  - [`getRelaySockets()`](#getrelaysockets)
+  - [`pauseRelayReconnection()`](#pauserelayreconnection)
+  - [`resumeRelayReconnection()`](#resumerelayreconnection)
+- [Which strategy should I choose?](#which-strategy-should-i-choose)
+
+---
+
+## How it works
+
+👉 **If you just want to try out Trystero, you can skip this explainer and
+[jump into using it](#get-started).**
+
+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 strategies for connecting peers (currently
+BitTorrent, Nostr, MQTT, Supabase, Firebase, IPFS, and self-hosted WebSocket
+relay).
+
+The important point to remember is this:
+
+> 🔒
+>
+> Beyond peer discovery, your app's data never touches the strategy medium and
+> is sent directly peer-to-peer and end-to-end encrypted between users.
+>
+> 👆
+
+You can [compare strategies here](#which-strategy-should-i-choose).
+
+## Get started
+
+Install Trystero with your preferred package manager, then import it in your
+code:
+
+```sh
+npm i trystero
+```
+
+```js
+import {joinRoom} from 'trystero'
+```
+
+No package manager? You can also use a CDN:
+
+```html
+<script type="module">
+  import {joinRoom} from 'https://esm.run/trystero'
+</script>
+```
+
+The default Trystero package runs on the Nostr network, but you can swap in any
+other stategy by changing which package you import:
+
+```js
+import {joinRoom} from '@trystero-p2p/mqtt'
+// or
+import {joinRoom} from '@trystero-p2p/torrent'
+// or
+import {joinRoom} from '@trystero-p2p/supabase'
+// or
+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:
+
+```js
+const config = {appId: 'san_narciso_3d'}
+const room = joinRoom(config, 'yoyodyne')
+```
+
+The first argument is a configuration object that requires an `appId`. This
+should be a completely unique identifier for your app¹. The second argument is
+the room ID.
+
+> Why rooms? Browsers can only handle a limited amount of WebRTC connections at
+> a time so it's recommended to design your app such that users are divided into
+> groups (or rooms, or namespaces, or channels... whatever you'd like to call
+> them).
+
+¹ When using Firebase, `appId` should be your `databaseURL` and when using
+Supabase, it should be your project URL.
+
+## Listen for events
+
+Listen for peers joining the room:
+
+```js
+room.onPeerJoin(peerId => console.log(`${peerId} joined`))
+```
+
+Listen for peers leaving the room:
+
+```js
+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)
+)
+```
+
+To unsubscribe from events, leave the room:
+
+```js
+room.leave()
+```
+
+You can access the local user's peer ID by importing `selfId` like so:
+
+```js
+import {selfId} from 'trystero'
+
+console.log(`my peer ID is ${selfId}`)
+```
+
+## Broadcast events
+
+Send peers your video stream:
+
+```js
+const stream = await navigator.mediaDevices.getUserMedia({
+  audio: true,
+  video: true
+})
+room.addStream(stream)
+```
+
+Send and subscribe to custom peer-to-peer actions:
+
+```js
+const [sendDrink, getDrink] = room.makeAction('drink')
+
+// buy drink for a friend
+sendDrink({drink: 'negroni', withIce: true}, friendId)
+
+// buy round for the house (second argument omitted)
+sendDrink({drink: 'mezcal', withIce: false})
+
+// listen for drinks sent to you
+getDrink((data, peerId) =>
+  console.log(
+    `got a ${data.drink} with${data.withIce ? '' : 'out'} ice from ${peerId}`
+  )
+)
+```
+
+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')
+```
+
+You can also use actions to send binary data, like images:
+
+```js
+const [sendPic, getPic] = room.makeAction('pic')
+
+// blobs are automatically handled, as are any form of TypedArray
+canvas.toBlob(blob => sendPic(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])))
+)
+```
+
+Let's say we want users to be able to name themselves:
+
+```js
+const idsToNames = {}
+const [sendName, getName] = room.makeAction('name')
+
+// tell new peers your name when they connect
+room.onPeerJoin(peerId => sendName('Oedipa', peerId))
+
+// listen for peers naming themselves
+getName((name, peerId) => (idsToNames[peerId] = name))
+
+// tell all peers at once when your name changes
+nameInput.addEventListener('change', e => sendName(e.target.value))
+
+room.onPeerLeave(peerId =>
+  console.log(`${idsToNames[peerId] || 'a weird stranger'} left`)
+)
+```
+
+> Actions are smart and handle serialization and chunking for you behind the
+> scenes. This means you can send very large files and whatever data you send
+> will be received on the other side as the same type (a number as a number, a
+> string as a string, an object as an object, binary as binary, etc.).
+
+## Audio and video
+
+Here's a simple example of how you could create an audio chatroom:
+
+```js
+// this object can store audio instances for later
+const peerAudios = {}
+
+// get a local audio stream from the microphone
+const selfStream = await navigator.mediaDevices.getUserMedia({
+  audio: true,
+  video: false
+})
+
+// send stream to peers currently in the room
+room.addStream(selfStream)
+
+// send stream to peers who join later
+room.onPeerJoin(peerId => room.addStream(selfStream, peerId))
+
+// handle streams from other peers
+room.onPeerStream((stream, peerId) => {
+  // create an audio instance and set the incoming stream
+  const audio = new Audio()
+  audio.srcObject = stream
+  audio.autoplay = true
+
+  // 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
+video elements in the DOM:
+
+```js
+const peerVideos = {}
+const videoContainer = document.getElementById('videos')
+
+room.onPeerStream((stream, peerId) => {
+  let video = peerVideos[peerId]
+
+  // if this peer hasn't sent a stream before, create a video element
+  if (!video) {
+    video = document.createElement('video')
+    video.autoplay = true
+
+    // add video element to the DOM
+    videoContainer.appendChild(video)
+  }
+
+  video.srcObject = stream
+  peerVideos[peerId] = video
+})
+```
+
+## Advanced
+
+### Binary metadata
+
+Let's say your app supports sending various types of files and you want to
+annotate the raw bytes being sent with metadata about how they should be
+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')
+
+getFile((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'})
+```
+
+### Action promises
+
+Action sender functions return a promise that resolves when they're done
+sending. You can optionally use this to indicate to the user when a large
+transfer is done.
+
+```js
+await sendFile(amplePayload)
+console.log('done sending to all peers')
+```
+
+### Progress updates
+
+Action sender functions also take an optional callback function that will be
+continuously called as the transmission progresses. This can be used for showing
+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)
+)
+```
+
+Similarly you can listen for progress events as a receiver like this:
+
+```js
+const [sendFile, getFile, onFileProgress] = room.makeAction('file')
+
+onFileProgress((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
+receiving user that there is a transfer in progress with perhaps the name of the
+incoming file.
+
+Since a peer can send multiple transmissions in parallel, you can also use
+metadata to differentiate between them, e.g. by sending a unique ID.
+
+### Encryption
+
+Once peers are connected to each other all of their communications are
+end-to-end encrypted. During the initial connection / discovery process, peers'
+[SDPs](https://en.wikipedia.org/wiki/Session_Description_Protocol) are sent via
+the chosen peering strategy medium. By default the SDP is encrypted using a key
+derived from your app ID and room ID to prevent plaintext session data from
+appearing in logs. This is fine for most use cases, however a relay strategy
+operator can reverse engineer the key using the room and app IDs. A more secure
+option is to pass a `password` parameter in the app configuration object which
+will be used to derive the encryption key:
+
+```js
+joinRoom({appId: 'kinneret', password: 'MuchoMaa$'}, 'w_a_s_t_e__v_i_p')
+```
+
+This is a shared secret that must be known ahead of time and the password must
+match for all peers in the room for them to be able to connect. An example use
+case might be a private chat room where users learn the password via external
+means.
+
+### React hooks
+
+Trystero functions are idempotent so they already work out of the box as React
+hooks.
+
+Here's a simple example component where each peer syncs their favorite color to
+everyone else:
+
+```jsx
+import {joinRoom} from 'trystero'
+import {useState} from 'react'
+
+const trysteroConfig = {appId: 'thurn-und-taxis'}
+
+export default function App({roomId}) {
+  const room = joinRoom(trysteroConfig, roomId)
+  const [sendColor, getColor] = 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))
+
+  // listen for peers sending their colors and update the state accordingly:
+  getColor((color, peer) =>
+    setPeerColors(peerColors => ({...peerColors, [peer]: color}))
+  )
+
+  const updateColor = e => {
+    const {value} = e.target
+
+    // when updating my own color, broadcast it to all peers:
+    sendColor(value)
+    setMyColor(value)
+  }
+
+  return (
+    <>
+      <h1>Trystero + React</h1>
+
+      <h2>My color:</h2>
+      <input type="color" value={myColor} onChange={updateColor} />
+
+      <h2>Peer colors:</h2>
+      <ul>
+        {Object.entries(peerColors).map(([peerId, color]) => (
+          <li key={peerId} style={{backgroundColor: color}}>
+            {peerId}: {color}
+          </li>
+        ))}
+      </ul>
+    </>
+  )
+}
+```
+
+Astute readers may notice the above example is simple and doesn't consider if we
+want to change the component's room ID or unmount it. For those scenarios you
+can use this simple `useRoom()` hook that unsubscribes from room events
+accordingly:
+
+```js
+import {joinRoom} from 'trystero'
+import {useEffect, useRef} from 'react'
+
+export const useRoom = (roomConfig, roomId) => {
+  const roomRef = useRef(joinRoom(roomConfig, roomId))
+  const lastRoomIdRef = useRef(roomId)
+
+  useEffect(() => {
+    if (roomId !== lastRoomIdRef.current) {
+      roomRef.current.leave()
+      roomRef.current = joinRoom(roomConfig, roomId)
+      lastRoomIdRef.current = roomId
+    }
+
+    return () => roomRef.current.leave()
+  }, [roomConfig, roomId])
+
+  return roomRef.current
+}
+```
+
+### Troubleshooting connection issues
+
+WebRTC is powerful but some networks simply don't allow direct P2P connections
+using it. If you find that certain user pairings aren't working in Trystero,
+you're likely encountering an issue at the network provider level. To solve this
+you can configure a TURN server which will act as a proxy layer for peers that
+aren't able to connect directly to one another.
+
+1. If you can, confirm that the issue is specific to particular network
+   conditions (e.g. user with ISP X cannot connect to a user with ISP Y). If
+   other user pairings are working (like those between two browsers on the same
+   machine), this likely confirms that Trystero is working correctly.
+2. Sign up for a TURN service or host your own. There are various hosted TURN
+   services you can find online like
+   [Cloudflare](https://developers.cloudflare.com/calls/turn/) (which offers a
+   free tier with 1,000 GB traffic per month) or
+   [Open Relay](https://www.metered.ca/stun-turn). You can also host an open
+   source TURN server like [coturn](https://github.com/coturn/coturn),
+   [Pion TURN](https://github.com/pion/turn),
+   [Violet](https://github.com/paullouisageneau/violet), or
+   [eturnal](https://github.com/processone/eturnal). Keep in mind data will only
+   go through the TURN server for peers that can't directly connect and will
+   still be end-to-end encrypted.
+3. Once you have a TURN server, configure Trystero with it like this:
+   ```js
+   const room = joinRoom(
+     {
+       // ...your app config
+       turnConfig: [
+         {
+           // single string or list of strings of URLs to access TURN server
+           urls: ['turn:your-turn-server.ok:1979'],
+           username: 'username',
+           credential: 'password'
+         }
+       ]
+     },
+     'roomId'
+   )
+   ```
+
+### Running server-side (Node, Bun)
+
+Trystero works outside browsers too, like in Node or Bun. Why would you want to
+run something that helps you avoid servers on a server? One reason is if you
+want an always-on peer which can be useful for remembering the last state of
+data, broadcasting it to new users. Another reason might be to run peers that
+are lighter weight and don't need a full browser running, like an embedded
+device or Raspberry Pi.
+
+Running server-side uses the same syntax as in the browser, but you need to
+import a polyfill for WebRTC support:
+
+```js
+import {joinRoom} from 'trystero'
+import {RTCPeerConnection} from 'werift'
+
+const room = joinRoom(
+  {appId: 'your-app-id', rtcPolyfill: RTCPeerConnection},
+  'your-room-name'
+)
+```
+
+### 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`.
+
+The example below assumes a WebSocket relay that does simple pub/sub routing:
+
+- Client sends
+  `{"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'
+
+export const joinRoom = createStrategy({
+  // 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.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]
+    const onWsMessage = event => {
+      const {topic, payload} = JSON.parse(String(event.data))
+
+      if (!topics.includes(topic)) {
+        return
+      }
+
+      onMessage(topic, payload, (peerTopic, signal) =>
+        client.send(
+          toJson({type: 'publish', topic: peerTopic, payload: signal})
+        )
+      )
+    }
+
+    client.addEventListener('message', onWsMessage)
+    topics.forEach(topic => client.send(toJson({type: 'subscribe', topic})))
+
+    return () => {
+      topics.forEach(topic => client.send(toJson({type: 'unsubscribe', topic})))
+      client.removeEventListener('message', onWsMessage)
+    }
+  },
+
+  // announce takes a relay client and a rootTopic
+  announce: (client, rootTopic) =>
+    client.send(
+      toJson({
+        type: 'publish',
+        topic: rootTopic,
+        payload: toJson({peerId: selfId})
+      })
+    )
+})
+
+const room = joinRoom(
+  {appId: 'my-app-id', relayConfig: {urls: ['wss://my-relay.example']}},
+  'my-room-id'
+)
+```
+
+### Supabase setup
+
+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 `relayConfig.supabaseKey` in the
+   Trystero config
+
+### Firebase setup
+
+If you want to use the Firebase strategy and don't have an existing project:
+
+1. Create a [Firebase](https://firebase.google.com/) project
+2. Create a new Realtime Database
+3. Copy the `databaseURL` and use it as the `appId` in your Trystero config
+
+<details>
+  <summary>
+  Optional: configure the database with security rules to limit activity:
+  </summary>
+
+```json
+{
+  "rules": {
+    ".read": false,
+    ".write": false,
+    "__trystero__": {
+      ".read": false,
+      ".write": false,
+      "$room_id": {
+        ".read": true,
+        ".write": true
+      }
+    }
+  }
+}
+```
+
+These rules ensure room peer presence is only readable if the room namespace is
+known ahead of time.
+
+</details>
+
+## API
+
+### `joinRoom(config, roomId, [callbacks])`
+
+Adds local user to room whereby other peers in the same namespace will open
+communication channels and send events. Calling `joinRoom()` multiple times with
+the same namespace will return the same room instance.
+
+- `config` - Configuration object containing the following keys:
+  - `appId` - **(required)** A unique string identifying your app. When using
+    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
+    `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
+    descriptions will be encrypted with a key derived from the app ID and room
+    name. A custom password must match between any peers in the room for them to
+    connect. See [encryption](#encryption) for more details.
+
+  - `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)
+    for all peer connections.
+
+  - `trickleIce` - **(optional)** Boolean controlling whether ICE candidates are
+    sent incrementally (`true`) or bundled with SDP (`false`). Default is
+    strategy-dependent: `true` for most strategies, `false` for BitTorrent and
+    IPFS unless explicitly set.
+
+  - `turnConfig` - **(optional)** Specifies a custom list of TURN servers to use
+    (see
+    [Troubleshooting connection issues](#troubleshooting-connection-issues)).
+    Each item in the list should correspond to an
+    [ICE server config object](https://developer.mozilla.org/en-US/docs/Web/API/RTCPeerConnection/RTCPeerConnection#iceservers).
+    When passing a TURN config like this, Trystero's default STUN servers will
+    also be used. To override this and use both custom STUN and TURN servers,
+    instead pass the config via the above `rtcConfig.iceServers` option as a
+    list of both STUN/TURN servers — this won't inherit Trystero's defaults.
+
+  - `rtcPolyfill` - **(optional)** Use this to pass a custom
+    [`RTCPeerConnection`](https://developer.mozilla.org/en-US/docs/Web/API/RTCPeerConnection/RTCPeerConnection)-compatible
+    constructor. This is useful for running outside of a browser, such as in
+    Node (still experimental).
+
+- `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.
+
+  - `onPeerHandshake(peerId, send, receive, isInitiator)` - Async predicate that
+    runs after the transport connects but before the peer becomes active.
+    Return/resolve to accept the peer, throw/reject to deny the peer.
+    - `peerId` - ID of the pending peer.
+    - `send(data, [metadata])` - Sends handshake payloads to the pending peer.
+    - `receive()` - Resolves to the next handshake message from the peer as
+      `{data, metadata}`.
+    - `isInitiator` - Deterministic role flag for avoiding protocol deadlocks.
+
+  - `handshakeTimeoutMs` - Timeout for pending handshakes in milliseconds
+    (`10000` by default). If exceeded, the peer is denied and `onJoinError` is
+    called.
+
+  During handshake, the peer remains pending and is not included in `getPeers()`
+  and does not trigger Trystero API events (`onPeerJoin`, action receivers,
+  stream/track callbacks). Non-handshake data received while pending is dropped.
+
+  Minimal handshake example:
+
+  ```js
+  import {joinRoom} from 'trystero'
+
+  const room = joinRoom({appId: 'my-app'}, 'secure-room', {
+    onPeerHandshake: async (_, send, receive, isInitiator) => {
+      if (isInitiator) {
+        await send({challenge: 'prove-you-know-the-secret'})
+        const {data} = await receive()
+
+        if (data?.response !== 'shared-secret') {
+          throw new Error('handshake rejected')
+        }
+      } else {
+        const {data} = await receive()
+
+        if (data?.challenge !== 'prove-you-know-the-secret') {
+          throw new Error('handshake rejected')
+        }
+
+        await send({response: 'shared-secret'})
+      }
+    }
+  })
+  ```
+
+Returns an object with the following methods:
+
+- ### `leave()`
+
+  Remove local user from room and unsubscribe from room events.
+
+- ### `getPeers()`
+
+  Returns a map of
+  [`RTCPeerConnection`](https://developer.mozilla.org/en-US/docs/Web/API/RTCPeerConnection)s
+  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])`
+
+  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).
+
+  - `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.
+
+- ### `removeStream(stream, [targetPeers])`
+
+  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).
+
+- ### `addTrack(track, stream, [targetPeers], [metadata])`
+
+  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).
+
+  - `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])`
+
+  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).
+
+- ### `replaceTrack(oldTrack, newTrack, [targetPeers], [metadata])`
+
+  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).
+
+  - `metadata` - **(optional)** Additional metadata (any serializable type) to
+    be sent with the replacement track.
+
+- ### `onPeerJoin(callback)`
+
+  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.
+  - `callback(peerId)` - Function to run whenever a peer joins, called with the
+    peer's ID.
+
+  Example:
+
+  ```js
+  onPeerJoin(peerId => console.log(`${peerId} joined`))
+  ```
+
+- ### `onPeerLeave(callback)`
+
+  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.
+  - `callback(peerId)` - Function to run whenever a peer leaves, called with the
+    peer's ID.
+
+  Example:
+
+  ```js
+  onPeerLeave(peerId => console.log(`${peerId} left`))
+  ```
+
+- ### `onPeerStream(callback)`
+
+  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.
+  - `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).
+
+  Example:
+
+  ```js
+  onPeerStream((stream, peerId) =>
+    console.log(`got stream from ${peerId}`, stream)
+  )
+  ```
+
+- ### `onPeerTrack(callback)`
+
+  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.
+  - `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).
+
+  Example:
+
+  ```js
+  onPeerTrack((track, stream, peerId) =>
+    console.log(`got track from ${peerId}`, track)
+  )
+  ```
+
+- ### `makeAction(actionId)`
+
+  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)).
+
+       - `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.
+
+  2. #### Receiver
+     - Registers a callback function that runs when data for this action is
+       received from other peers.
+
+     - `(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.
+
+  Example:
+
+  ```js
+  const [sendCursor, getCursor] = room.makeAction('cursormove')
+
+  window.addEventListener('mousemove', e => sendCursor([e.clientX, e.clientY]))
+
+  getCursor(([x, y], peerId) => {
+    const peerCursor = cursorMap[peerId]
+    peerCursor.style.left = x + 'px'
+    peerCursor.style.top = y + 'px'
+  })
+  ```
+
+- ### `ping(peerId)`
+
+  Takes a peer ID and returns a promise that resolves to the milliseconds the
+  round-trip to that peer took. Use this for measuring latency.
+  - `peerId` - Peer ID string of the target peer.
+
+  Example:
+
+  ```js
+  // log round-trip time every 2 seconds
+  room.onPeerJoin(peerId =>
+    setInterval(
+      async () => console.log(`took ${await room.ping(peerId)}ms`),
+      2000
+    )
+  )
+  ```
+
+### `selfId`
+
+A unique ID string other peers will know the local user as globally across
+rooms.
+
+### `getRelaySockets()`
+
+**(🌊 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:
+
+```js
+import {getRelaySockets} from '@trystero-p2p/torrent'
+
+console.log(getRelaySockets())
+// => Object {
+//  "wss://tracker.webtorrent.dev": WebSocket,
+//  "wss://tracker.openwebtorrent.com": WebSocket
+//  }
+```
+
+### `pauseRelayReconnection()`
+
+**(🐦 Nostr, 🌊 BitTorrent only)** Normally Trystero will try to automatically
+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()`
+
+**(🐦 Nostr, 🌊 BitTorrent only)** Allows relay reconnection attempts to resume.
+(See `pauseRelayReconnection()` above).
+
+## Which strategy should I choose?
+
+By default Trystero uses the Nostr network which is highly decentralized with
+hundreds of active relays running. This is a good choice if you're interested in
+decentralization and high redundancy. The other decentralized strategies are
+recommended in the order of MQTT, BitTorrent, and IPFS, based on robustness.
+These networks have far less relay redundancy than Nostr, but you might prefer
+them for other reasons. You can of course host your own relay server for any of
+these strategies.
+
+For a middleground between using public relays and self-hosting, the built-in
+Supabase and Firebase strategies are a good option.
+
+---
+
+Trystero by [Dan Motzenbecker](https://oxism.com)

package/dist/index.d.mts

@@ -1,8 +1,8 @@
-import { BaseRoomConfig, JoinRoom, RelayConfig, pauseRelayReconnection, resumeRelayReconnection, selfId } from "@trystero-p2p/core";
+import { JoinRoom, JoinRoomConfig, pauseRelayReconnection, resumeRelayReconnection, selfId } from "@trystero-p2p/core";
 export * 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,cAoVpC,QAAA,EAAU,QAAA,CAAS,iBAAA;AAAA,cAcnB,eAAA;AAAA,cAIA,gBAAA"}
+{"version":3,"file":"index.d.mts","names":[],"sources":["../src/index.ts"],"mappings":";;;;KA8CY,iBAAA,GAAoB,cAAA;AAAA,cA6VnB,QAAA,EAAU,QAAA,CAAS,iBAAA;AAAA,cAcnB,eAAA;AAAA,cAIA,gBAAA"}

package/dist/index.mjs

@@ -135,18 +135,21 @@ const joinRoomStrategy = createStrategy({
 		roomSubscriberCounts[rootTopic] = (roomSubscriberCounts[rootTopic] ?? 0) + 1;
 		const topicHandler = (data) => {
 			if (data.offer && data.peer_id && data.offer_id) onMessage(rootTopic, {
-				offer: data.offer,
+				offer: data.offer.sdp,
 				peerId: data.peer_id,
 				hasOutgoingOffer: keys(getRoomOutstandingOffers(rootTopic)).length > 0
 			}, (_, signal) => void send(client, rootTopic, {
-				answer: fromJson(signal)["answer"],
+				answer: {
+					type: "answer",
+					sdp: fromJson(signal).answer
+				},
 				offer_id: data.offer_id,
 				to_peer_id: data.peer_id
 			}));
 			else if (data.answer && data.offer_id && data.peer_id) {
 				const offer = claimOutstandingOffer(rootTopic, data.offer_id);
 				if (offer) onMessage(rootTopic, {
-					answer: data.answer,
+					answer: data.answer.sdp,
 					peerId: data.peer_id,
 					peer: offer.peer
 				}, () => {});
@@ -159,7 +162,10 @@ const joinRoomStrategy = createStrategy({
 				numwant: offerPoolSize,
 				offers: entries(await ensureOutstandingOffers(rootTopic, getOffers)).map(([id, { offer }]) => ({
 					offer_id: id,
-					offer
+					offer: {
+						type: "offer",
+						sdp: offer
+					}
 				}))
 			});
 		};

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?: unknown\n  answer?: unknown\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,\n            peerId: data.peer_id,\n            hasOutgoingOffer:\n              keys(getRoomOutstandingOffers(rootTopic)).length > 0\n          },\n          (_, signal) =>\n            void send(client, rootTopic, {\n              answer: fromJson<Record<string, unknown>>(signal)['answer'],\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,\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\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 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 = 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) => {\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":";;AAqBA,MAAM,eAAe,oBAAiC,WAAU,OAAO,OAAO;AAC9E,MAAM,kBAA0C,EAAE;AAClD,MAAM,kBAA0C,EAAE;AAClD,MAAM,oBAAoB,aAAa,QAAwC;AAC/E,MAAM,cAAc,aAAa,QAAoC;AACrE,MAAM,qBAAqB,aAAa,QAAgB;AACxD,MAAM,oBAA4C,EAAE;AACpD,MAAM,iBAAyC,EAAE;AACjD,MAAM,cAAc,aAAa,QAAwC;AACzE,MAAM,wBAGF,EAAE;AACN,MAAM,8BACJ,EAAE;AACJ,MAAM,uBAA+C,EAAE;AACvD,MAAM,gBAAgB;AACtB,MAAM,YAAY;AAClB,MAAM,gBAAgB;AACtB,MAAM,oBAAoB;AAC1B,MAAM,gBAAgB;AACtB,MAAM,mBAAmB;AACzB,MAAM,uBAAuB;AAC7B,MAAM,oBAAoB;AAqB1B,MAAM,cAAc,OAAO,UAAmC;AAC5D,KAAI,gBAAgB,OAClB,QAAO,gBAAgB;CAGzB,MAAM,QAAQ,MAAM,KAAK,MAAM,EAAE,MAAM,GAAG,UAAU;AACpD,iBAAgB,SAAS;AACzB,iBAAgB,QAAQ;AAExB,QAAO;;AAGT,MAAM,OAAO,OACX,QACA,OACA,YAEA,OAAO,KACL,OAAO;CACL,QAAQ;CACR,WAAW,MAAM,YAAY,MAAM;CACnC,SAAS;CACT,GAAG;CACJ,CAAC,CACH;AAEH,MAAM,QAAQ,KAAa,KAAa,UAAU,UAChD,QAAQ,KACN,GAAG,QAAQ,oBAAoB,UAAU,YAAY,UAAU,QAAQ,IAAI,KAAK,MACjF;AAEH,MAAM,4BACJ,cAEC,sBAAsB,eAAe,EAAE;AAE1C,MAAM,8BAA8B,cAA4B;AAC9D,QAAO,sBAAsB;AAC7B,QAAO,4BAA4B;;AAGrC,MAAM,yBACJ,WACA,YAC4B;CAC5B,MAAM,oBAAoB,sBAAsB;CAChD,MAAM,QAAQ,oBAAoB;AAElC,KAAI,CAAC,MACH;AAGF,QAAO,kBAAkB;AACzB,OAAM,SAAS;AAEf,KAAI,CAAC,KAAK,kBAAkB,CAAC,UAAU,CAAC,qBAAqB,WAC3D,4BAA2B,UAAU;AAGvC,QAAO;;AAGT,MAAM,2BAA2B,WAAmB,YAA0B;CAC5E,MAAM,oBAAoB,sBAAsB;CAChD,MAAM,QAAQ,oBAAoB;AAElC,KAAI,CAAC,MACH;AAGF,QAAO,kBAAkB;AACzB,OAAM,WAAW;AAEjB,KAAI,CAAC,KAAK,kBAAkB,CAAC,UAAU,CAAC,qBAAqB,WAC3D,4BAA2B,UAAU;;AAIzC,MAAM,+BAA+B,cAA4B;AAC/D,MAAK,yBAAyB,UAAU,CAAC,CAAC,SAAQ,YAChD,wBAAwB,WAAW,QAAQ,CAC5C;AACD,4BAA2B,UAAU;;AAGvC,MAAM,0BAA0B,cAA4B;CAC1D,MAAM,MAAM,KAAK,KAAK;AAEtB,SAAQ,yBAAyB,UAAU,CAAC,CAAC,SAAS,CAAC,SAAS,WAAW;AACzE,MAAI,MAAM,MAAM,YAAY,iBAC1B,yBAAwB,WAAW,QAAQ;GAE7C;;AAGJ,MAAM,0BAA0B,OAC9B,WACA,cAC+D;AAC/D,QAAO,4BAA4B,WACjC,OAAM,4BAA4B;CAGpC,MAAM,eAAe,YAAY;AAC/B,yBAAuB,UAAU;EAEjC,MAAM,oBAAoB,yBAAyB,UAAU;EAC7D,MAAM,mBAAmB,KAAK,kBAAkB,CAAC;EACjD,MAAM,gBAAgB,KAAK,IAAI,GAAG,gBAAgB,iBAAiB;AAEnE,MAAI,gBAAgB,EACjB,EAAC,MAAM,UAAU,cAAc,EAAE,SAAQ,iBAAgB;AACxD,qBAAkB,MAAM,UAAU,IAAI;IACpC,GAAG;IACH,WAAW,KAAK,KAAK;IACtB;IACD;KAEF,CAAC,cAAc;AACjB,MAAI,4BAA4B,eAAe,YAC7C,QAAO,4BAA4B;GAErC;AAEF,6BAA4B,aAAa;AACzC,OAAM;AAEN,QAAO,yBAAyB,UAAU;;AAG5C,MAAM,mBAAgD,eAAe;CACnE,OAAM,WACJ,UAAU,QAAQ,kBAAkB,kBAAkB,CAAC,KAAI,WAAU;EACnE,MAAM,SAAS,aAAa,SAC1B,QACA,WAAW,SAAQ,YAAW;GAC5B,MAAM,OAAO,SAAyB,QAAQ;GAC9C,MAAM,SAAS,KAAK;GACpB,MAAM,UAAU,KAAK;GACrB,MAAM,EAAC,aAAY;GACnB,MAAM,QAAQ,KAAK,YACf,gBAAgB,KAAK,aACrB,KAAA;AAEJ,OAAI,QAAQ;AACV,SAAK,OAAO,KAAK,QAAQ,KAAK;AAC9B;;AAGF,OAAI,QACF,MAAK,OAAO,KAAK,QAAQ;AAG3B,OACE,YACA,WAAW,OACR,kBAAkB,OAAO,QAAQ,sBACpC,SACA,YAAY,OAAO,OAAO,CAAC,QAC3B;IACA,MAAM,eAAe,KAAK,IAAI,WAAW,KAAM,cAAc;IAC7D,MAAM,iBAAiB,kBAAkB,OAAO,OAAO;IACvD,MAAM,WAAW,YAAY,OAAO,OAAO;AAE3C,QAAI,eAAe,OACjB,eAAc,eAAe,OAAO;AAEtC,sBAAkB,OAAO,OAAO;IAChC,MAAM,UAAU,SAAS;AAEzB,QAAI,QACF,gBAAe,SAAS,kBAAkB;AACnC,cAAS;OACb,aAAa;;AAIpB,QAAK,KAAK,SAAS,KAAK,WAAW,SAAS,KAAK,UAAU;AACzD,QAAI,KAAK,YAAY,OACnB;IAIF,MAAM,YAAY,GAAG,MAAM,GADR,KAAK,QAAQ,UAAU,SACD,GAAG,KAAK,SAAS,GAAG,KAAK,WAAW;IAC7E,MAAM,QAAQ,KAAK,KAAK;IACxB,MAAM,gBAAgB,eAAe;AAErC,QACE,OAAO,kBAAkB,YACzB,QAAQ,gBAAgB,qBAExB;AAGF,mBAAe,aAAa;AAE5B,YAAQ,eAAe,CAAC,SAAS,CAAC,KAAK,iBAAiB;AACtD,SAAI,QAAQ,cAAc,uBAAuB,EAC/C,QAAO,eAAe;MAExB;AAEF,gBAAY,OAAO,OAAO,CAAC,SAAS,KAAK;;IAE3C,CACH;AAED,SAAO,OAAO;GACd;CAEJ,YAAY,QAAQ,WAAW,GAAG,WAAW,cAAc;EACzD,MAAM,WAAW,YAAY,SAAS,OAAO;EAC7C,MAAM,WAAW,YAAY,SAAS,OAAO;EAC7C,MAAM,iBAAiB,kBAAkB,SAAS,OAAO;EACzD,MAAM,eAAe,mBAAmB,SAAS,OAAO;EACxD,MAAM,oBAAoB,OAAO,UAAU;AAE3C,eAAa,aAAa;AAC1B,uBAAqB,cAAc,qBAAqB,cAAc,KAAK;EAE3E,MAAM,gBAAgB,SAA+B;AACnD,OAAI,KAAK,SAAS,KAAK,WAAW,KAAK,SAChC,WACH,WACA;IACE,OAAO,KAAK,MAAM;IAClB,QAAQ,KAAK;IACb,kBACE,KAAK,yBAAyB,UAAU,CAAC,CAAC,SAAS;IACtD,GACA,GAAG,WACF,KAAK,KAAK,QAAQ,WAAW;IAC3B,QAAQ;KACN,MAAM;KACN,KAAK,SAA2B,OAAO,CAAC;KACzC;IACD,UAAU,KAAK;IACf,YAAY,KAAK;IAClB,CAAC,CACL;YACQ,KAAK,UAAU,KAAK,YAAY,KAAK,SAAS;IACvD,MAAM,QAAQ,sBAAsB,WAAW,KAAK,SAAS;AAE7D,QAAI,MACG,WACH,WACA;KACE,QAAQ,KAAK,OAAO;KACpB,QAAQ,KAAK;KACb,MAAM,MAAM;KACb,QACK,GACP;;;AAKP,WAAS,aAAa;EAEtB,MAAM,WAAW,YAA2B;AAC1C,OAAI,aAAa,eAAe,kBAC9B;AAYG,QAAK,QAAQ,WAAW;IAC3B,SAAS;IACT,QAPa,QAAQ,MAJS,wBAC9B,WACA,UACD,CACwC,CAAC,KAAK,CAAC,IAAI,EAAC,cAAa;KAChE,UAAU;KACV,OAAO;MAAC,MAAM;MAAS,KAAK;MAAM;KACnC,EAIO;IACP,CAAC;;AAGJ,oBAAkB,OAAO,OAAO;AAChC,WAAS,aAAa;AACtB,iBAAe,aAAa,YAC1B,UACA,kBAAkB,OAAO,KAC1B;AACI,YAAU;AAEf,eAAa;AACX,wBAAqB,aAAa,KAAK,IACrC,IACC,qBAAqB,cAAc,KAAK,EAC1C;AAED,OAAI,CAAC,qBAAqB,WACxB,QAAO,qBAAqB;AAG9B,OAAI,aAAa,eAAe,mBAAmB;AACjD,QAAI,CAAC,qBAAqB,WACxB,6BAA4B,UAAU;AAGxC;;GAGF,MAAM,WAAW,eAAe;AAChC,OAAI,UAAU;AACZ,kBAAc,SAAS;AACvB,WAAO,eAAe;;AAGxB,OAAI,SAAS,eAAe,aAC1B,QAAO,SAAS;AAGlB,OAAI,SAAS,eAAe,SAC1B,QAAO,SAAS;AAGlB,UAAO,aAAa;AAEpB,OAAI,CAAC,qBAAqB,WACxB,6BAA4B,UAAU;;;CAK5C,WAAU,WAAU,kBAAkB,OAAO;CAC9C,CAAC;AAEF,MAAa,YACX,QACA,QACA,cAEA,iBACE;CACE,GAAG;CACH,YAAY,OAAO,cAAc;CAClC,EACD,QACA,UACD;AAEH,MAAa,kBAAkB,aAAa;AAI5C,MAAa,mBAAmB;CAC9B;CACA;CACA;CACA;CACD,CAAC,KAAI,QAAO,WAAW,IAAI"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@trystero-p2p/torrent",
-  "version": "0.23.0",
+  "version": "0.24.0",
   "description": "Torrent tracker strategy for Trystero",
   "keywords": [
     "bittorrent",
@@ -34,6 +34,6 @@
     "./package.json": "./package.json"
   },
   "dependencies": {
-    "@trystero-p2p/core": "0.23.0"
+    "@trystero-p2p/core": "0.24.0"
   }
 }