fastrtc 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 NotZero
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,233 @@
+# fastrtc
+
+Browser WebRTC mesh library. Zero runtime dependencies.
+
+You wire signaling (WebSocket, SSE, whatever). fastrtc handles peer connections, data channels, and media tracks.
+
+## Mental model
+
+```
+You                          fastrtc                         Remote peer
+ │                              │                                  │
+ │  signal(to, payload) ───────►│ forwards SDP / ICE               │
+ │◄──── receive(from, payload) ──│                                  │
+ │                              │◄──────── WebRTC ────────────────►│
+ │                              │                                  │
+ │  channel("chat")             │ opens labeled data channels      │
+ │  connect("bob")              │ negotiates connection            │
+ │  on("ready")                 │ all channels open → safe to send │
+ │  send / sendTo               │ text or streamed files           │
+```
+
+**Three things to remember:**
+
+1. **Signaling is yours** — forward `SignalPayload` objects between peers. fastrtc never touches your server.
+2. **Declare channels before `connect()`** — `channel("files")` registers a label for every current and future peer.
+3. **`ready` means go** — wait for `ready` (or `whenOpen`) before sending on a channel.
+
+## Install
+
+```bash
+pnpm add fastrtc
+# or
+npm install fastrtc
+```
+
+## Quick start
+
+```ts
+import { RTCManager } from "fastrtc";
+import type { SignalPayload } from "fastrtc";
+
+const rtc = new RTCManager({
+  id: "alice",
+  signal: (to, payload) => {
+    ws.send(JSON.stringify({ to, from: "alice", payload }));
+  },
+});
+
+ws.onmessage = (e) => {
+  const { from, payload } = JSON.parse(e.data);
+  rtc.receive(from, payload as SignalPayload);
+};
+
+rtc.channel("chat", { ordered: true });
+rtc.connect("bob");
+
+rtc.on("channel", (_id, ch) => {
+  ch.on("message", (data) => console.log(data));
+  ch.on("open", () => void ch.send("hello"));
+});
+```
+
+## Signaling
+
+Each outbound signal is a `SignalPayload`:
+
+```ts
+type SignalPayload =
+  | { type: "description"; description: RTCSessionDescriptionInit }
+  | { type: "candidate"; candidate: RTCIceCandidateInit };
+```
+
+- `signal(to, payload)` — fastrtc needs to send SDP or ICE to `to`
+- `receive(from, payload)` — apply a remote signal (auto-connects if needed)
+
+**Offer glare:** peer with the lexicographically larger ID is *polite* and yields on collision. Only the *impolite* peer creates labeled data channels; the polite peer waits for `ondatachannel`.
+
+## Data channels
+
+### Setup
+
+```ts
+rtc.channel("chat", { ordered: true });
+rtc.channel("files", { ordered: true });
+
+rtc.on("channel", (peerId, ch) => {
+  ch.on("open", () => { /* channel is open for this peer */ });
+  ch.on("message", (data) => { /* string message */ });
+  ch.on("stream", async (stream, meta) => {
+    const blob = await new Response(stream).blob();
+    console.log(peerId, meta, blob.size);
+  });
+  ch.on("progress", ({ direction, bytes, total }) => {
+    console.log(direction, bytes, total);
+  });
+});
+
+rtc.on("ready", (peerId) => {
+  // every declared channel is open for this peer
+  void rtc.sendTo(peerId, "files", file);
+});
+```
+
+| Event   | When |
+| ------- | ---- |
+| `join`  | Peer connection created |
+| `ready` | All declared channels open for that peer (fires once) |
+| `leave` | Peer disconnected |
+
+Get a channel directly: `rtc.getChannel(peerId, "files")` or `await rtc.whenOpen(peerId, "files")`.
+
+### Sending
+
+| Method | Target |
+| ------ | ------ |
+| `send(label, data)` | Every peer with an open channel on `label` |
+| `sendTo(peerId, label, data)` | One peer |
+| `ch.send(data)` | When you already have the `FastDataChannel` |
+
+**Data types:**
+
+- **String** → single SCTP message → `message` event
+- **Blob / File / BufferSource / ReadableStream / async iterable** → framed stream → `stream` event
+
+```ts
+await rtc.send("files", file);              // all peers
+await rtc.sendTo("bob", "files", file);       // one peer
+await rtc.sendTo("bob", "files", file, {
+  meta: { name: file.name },                  // JSON on first frame
+  offset: 1024,                                // Blob/File slice start
+  onProgress: (bytes, total) => { /* ... */ },
+  signal: abortController.signal,
+});
+```
+
+**Multi-peer file sends:** pass the `Blob`/`File`, not `blob.stream()`. Each peer gets its own `blob.stream()`, so a slow peer does not block others. A late joiner gets a fresh stream from byte 0.
+
+**ReadableStream caveat:** one-shot streams work with `sendTo` only. `send()` to multiple peers throws — use a `Blob`/`File` instead.
+
+Strings are drained before queued file frames, so control messages are not stuck behind a large send.
+
+### Receiving
+
+Attach a `stream` listener before data arrives — streams without a listener are dropped. A slow consumer that lets the receive queue grow past the backlog limit gets an error instead of unbounded RAM.
+
+## Media
+
+```ts
+const stream = await navigator.mediaDevices.getUserMedia({ video: true, audio: true });
+rtc.add(stream);   // tracks added before connect() attach to new peers automatically
+
+rtc.on("track", (peerId, track, stream) => {
+  videoElement.srcObject = stream;
+});
+
+rtc.on("track-ended", (peerId, track) => { /* remote track stopped */ });
+
+rtc.remove(stream);
+```
+
+## Transfer limiter
+
+Large file sends use memory. `maxTransfers` caps how many run at once (default `4`); extras wait in FIFO.
+
+```ts
+const rtc = new RTCManager({ id: "alice", signal, maxTransfers: 4 });
+// Infinity = unlimited
+```
+
+Each outgoing framed send holds one slot until complete. Same-channel sends are serialized and do not hold a slot while waiting.
+
+## API
+
+### `RTCManager`
+
+```ts
+new RTCManager({
+  id: string;
+  signal: (to: string, payload: SignalPayload) => void;
+  rtcConfig?: RTCConfiguration;  // default: Google STUN
+  maxTransfers?: number;           // default: 4
+})
+```
+
+| Method | Description |
+| ------ | ----------- |
+| `connect(remoteId)` | Open connection to a peer |
+| `receive(remoteId, payload)` | Apply remote SDP/ICE |
+| `channel(label, options?)` | Register a labeled channel for all peers |
+| `getChannel(peerId, label)` | Existing channel, or `undefined` |
+| `whenOpen(peerId, label, { signal? })` | Promise for an open channel |
+| `send(label, data, options?)` | Send to every open peer on `label` |
+| `sendTo(peerId, label, data, options?)` | Send to one peer |
+| `add(stream)` / `remove(stream)` | Manage outgoing media tracks |
+| `close(remoteId)` | Tear down one peer |
+| `destroy()` | Close everything, reject queued transfers |
+
+| Property | Description |
+| -------- | ----------- |
+| `id` | Local peer ID |
+| `rtcConfig` | Active RTC configuration |
+
+**Events:** `join`, `ready`, `leave`, `channel`, `track`, `track-ended`. `.on(event, handler)` returns unsubscribe.
+
+### `FastDataChannel`
+
+Wraps `RTCDataChannel` with streaming, backpressure, and typed events.
+
+| Method / property | Description |
+| ----------------- | ----------- |
+| `channel` | Underlying `RTCDataChannel` |
+| `send(data, options?)` | String → message; else → framed stream |
+| `destroy()` | Close and detach |
+
+**Events:** `open`, `close`, `message`, `error`, `stream`, `progress`.
+
+### Exports
+
+`RTCManager`, `FastDataChannel`, `SignalPayload`, `SendData`, `SendOptions`
+
+## Build
+
+```bash
+pnpm build   # output in dist/
+```
+
+## Requirements
+
+- Browser with `RTCPeerConnection` and `RTCDataChannel`
+- A signaling transport you control
+
+## Source Code
+Since this plugin is MIT licensed, you can also contribute to it at it's repo on [GitHub](https://github.com/YSpoof/fastrtc)

package/dist/consts.d.ts

@@ -0,0 +1,9 @@
+export declare const FRAME_MAGIC = 252;
+export declare const FLAG_FIRST = 1;
+export declare const FLAG_LAST = 2;
+export declare const FLAG_META = 4;
+export declare const FRAME_HEADER_SIZE = 2;
+export declare const RECEIVE_BACKLOG = 32;
+export declare const SCTP_DEFAULT_MESSAGE_SIZE = 65536;
+export declare const DEFAULT_RTC_CONFIG: RTCConfiguration;
+export declare const DEFAULT_MAX_TRANSFERS = 4;

package/dist/event-emitter.d.ts

@@ -0,0 +1,7 @@
+export declare class EventEmitter<TEvents extends object = Record<string, (...args: unknown[]) => void>> {
+    #private;
+    on<K extends keyof TEvents & string>(name: K, fn: TEvents[K]): () => void;
+    has<K extends keyof TEvents & string>(name: K): boolean;
+    emit<K extends keyof TEvents & string>(name: K, ...args: Parameters<TEvents[K] extends (...args: infer A) => unknown ? TEvents[K] : never>): void;
+    destroy(): void;
+}

package/dist/fast-data-channel.d.ts

@@ -0,0 +1,24 @@
+import { EventEmitter } from "./event-emitter";
+import { type SendData, type SendOptions } from "./stream-source";
+import { TransferLimiter } from "./transfer-limiter";
+export type ChannelProgress = {
+    direction: "send" | "receive";
+    bytes: number;
+    total?: number;
+};
+interface FastDataChannelEvents {
+    open: () => void;
+    close: () => void;
+    message: (data: unknown) => void;
+    error: (error: unknown) => void;
+    stream: (stream: ReadableStream<Uint8Array>, meta?: unknown) => void;
+    progress: (info: ChannelProgress) => void;
+}
+export declare class FastDataChannel extends EventEmitter<FastDataChannelEvents> {
+    #private;
+    readonly channel: RTCDataChannel;
+    constructor(channel: RTCDataChannel, transport: RTCSctpTransport | RTCPeerConnection | null, limiter?: TransferLimiter);
+    send(data: SendData, options?: SendOptions): Promise<void>;
+    destroy(): void;
+}
+export {};

package/dist/framing.d.ts

@@ -0,0 +1,5 @@
+export declare function encodeFrame(flags: number, payload: Uint8Array): ArrayBuffer;
+export declare function parseFrame(data: ArrayBuffer): {
+    flags: number;
+    payload: Uint8Array;
+} | null;

package/dist/index.cjs

@@ -0,0 +1 @@
+"use strict";var R=Object.defineProperty;var N=Object.getOwnPropertyDescriptor;var j=Object.getOwnPropertyNames;var I=Object.prototype.hasOwnProperty;var K=(i,e)=>{for(var t in e)R(i,t,{get:e[t],enumerable:!0})},q=(i,e,t,n)=>{if(e&&typeof e=="object"||typeof e=="function")for(let r of j(e))!I.call(i,r)&&r!==t&&R(i,r,{get:()=>e[r],enumerable:!(n=N(e,r))||n.enumerable});return i};var V=i=>q(R({},"__esModule",{value:!0}),i);var H={};K(H,{FastDataChannel:()=>w,RTCManager:()=>k});module.exports=V(H);var F={iceServers:[{urls:"stun:stun.l.google.com:19302"}]},L=4;var p=class{#t=new Map;on(e,t){let n=t,r=this.#t.get(e)??[];return r.push(n),this.#t.set(e,r),()=>{let s=this.#t.get(e);if(!s)return;let a=s.indexOf(n);a>=0&&s.splice(a,1),s.length===0&&this.#t.delete(e)}}has(e){return(this.#t.get(e)?.length??0)>0}emit(e,...t){let n=this.#t.get(e);if(n)for(let r of n.slice())r(...t)}destroy(){this.#t.clear()}};function B(i,e){let t=new ArrayBuffer(2+e.byteLength),n=new DataView(t);return n.setUint8(0,252),n.setUint8(1,i),new Uint8Array(t,2).set(e),t}function U(i){if(i.byteLength<2)return null;let e=new DataView(i);return e.getUint8(0)!==252?null:{flags:e.getUint8(1),payload:new Uint8Array(i,2)}}function _(i){return i instanceof Blob||i instanceof ArrayBuffer||ArrayBuffer.isView(i)}function O(i){if(i instanceof Blob)return i.stream();if(i instanceof ArrayBuffer||ArrayBuffer.isView(i)){let t=T(i);return new ReadableStream({start(n){n.enqueue(t),n.close()}})}if(i instanceof ReadableStream)return i;let e=i[Symbol.asyncIterator]();return new ReadableStream({async pull(t){let{done:n,value:r}=await e.next();if(n){t.close();return}t.enqueue(T(r))},cancel:()=>{e.return?.()}})}function T(i){if(i instanceof Uint8Array)return i;if(i instanceof ArrayBuffer)return new Uint8Array(i);if(ArrayBuffer.isView(i))return new Uint8Array(i.buffer,i.byteOffset,i.byteLength);if(typeof i=="string")return new TextEncoder().encode(i);throw i instanceof Blob?new Error("Pass the Blob/File to send, not blob chunks"):new Error("Unsupported stream chunk")}var S=class{#t;#e=0;#s=[];#i=!1;constructor(e){this.#t=e}async acquire(){if(this.#i)throw new Error("Transfer limiter destroyed");if(this.#e<this.#t)this.#e++;else{let t=Promise.withResolvers();if(this.#s.push(t),await t.promise,this.#i)throw this.#e--,new Error("Transfer limiter destroyed")}let e=!1;return()=>{e||(e=!0,this.#n())}}destroy(){this.#i=!0;let e=new Error("Transfer limiter destroyed");for(let t of this.#s.splice(0))t.reject(e)}#n(){if(this.#i){this.#e--;return}let e=this.#s.shift();if(e){e.resolve();return}this.#e--}};function Z(i){let e=i?.maxMessageSize;return!e||!Number.isFinite(e)?65536:e}var w=class extends p{channel;#t=0;#e=null;#s=null;#i;#n=[];#r=null;#a=null;#o=!1;#l=!1;#u=Promise.resolve();#d=0;constructor(e,t,n=new S(1/0)){super(),this.channel=e,this.#i=n,t instanceof RTCPeerConnection?this.#e=t:this.#s=t,this.#f(),this.channel.binaryType="arraybuffer",this.channel.onopen=()=>this.#m(),this.channel.onclose=()=>this.destroy(),this.channel.onmessage=r=>this.#C(r.data),this.channel.onerror=r=>this.emit("error",r),this.channel.onbufferedamountlow=()=>{this.#c(),this.#p()},this.channel.readyState==="open"&&queueMicrotask(()=>this.#m())}async send(e,t={}){if(this.#l)throw new Error("Data channel closed");if(typeof e=="string"){this.#n.push(e),this.#c();return}await this.#v(async()=>{let n=await this.#i.acquire();try{await this.#b(e,t)}finally{n()}})}destroy(){if(this.#l)return;this.#l=!0,this.#n.length=0,this.#o=!1;let e=new Error("Data channel closed");this.#r?.reject(e),this.#r=null,this.#a?.error(e),this.#a=null,this.emit("close"),this.channel.onopen=null,this.channel.onclose=null,this.channel.onmessage=null,this.channel.onerror=null,this.channel.onbufferedamountlow=null,super.destroy();try{this.channel.close()}catch{}}#m(){this.#l||(this.#f(),this.#c(),this.emit("open"))}#f(){let e=Z(this.#s??this.#e?.sctp??null);this.#t=Math.max(1,e-2),this.channel.bufferedAmountLowThreshold=e*2}async#v(e){let t=this.#u,{promise:n,resolve:r}=Promise.withResolvers();this.#u=n,await t;try{await e()}finally{r()}}#S(e,t){if(e instanceof Blob)return e.size-t;if(e instanceof ArrayBuffer||ArrayBuffer.isView(e))return e.byteLength-t}#w(e,t,n){n?.(e,t),this.emit("progress",{direction:"send",bytes:e,total:t})}async#b(e,t){this.#f();let n=t.offset??0;if(n!==0&&!(e instanceof Blob))throw new Error("offset requires a Blob/File");let r=e;n!==0&&e instanceof Blob&&(r=e.slice(n));let s=this.#S(e,n),a=0,h=!1;if(t.meta!==void 0){let l=new TextEncoder().encode(JSON.stringify(t.meta));this.#h(5,l),h=!0}let m=O(r),u=m.getReader(),c=!h,d=null,b=()=>{if(t.signal?.aborted)throw t.signal.reason??new Error("Aborted");if(this.#l)throw new Error("Data channel closed")},y=l=>{if(!d)return;let g=d.payload;this.#h(d.flags|(l?2:0),g),d=null,a+=g.byteLength,this.#w(a,s,t.onProgress)},o=()=>{u.cancel(t.signal?.reason??new Error("Aborted"))};t.signal?.addEventListener("abort",o,{once:!0});try{for(;;){b(),await this.#g(t.signal);let{done:l,value:g}=await u.read();if(l){d?y(!0):c?this.#h(3,new Uint8Array(0)):h&&this.#h(2,new Uint8Array(0));break}let D=T(g),C=0;for(;C<D.byteLength;){b(),await this.#g(t.signal);let P=Math.min(C+this.#t,D.byteLength);y(!1);let G=c?1:0;c=!1,d={flags:G,payload:D.subarray(C,P)},C=P}}}catch(l){try{d?y(!0):c||this.#h(2,new Uint8Array(0))}catch{}try{await u.cancel(l)}catch{}throw l}finally{t.signal?.removeEventListener("abort",o),m.locked&&u.releaseLock()}}#C(e){let t=e instanceof ArrayBuffer?U(e):null;if(!t){this.emit("message",e);return}if(this.#o){t.flags&2&&(this.#o=!1);return}if(!this.#a){if(!(t.flags&1))return;if(!this.has("stream")){this.#o=!(t.flags&2);return}let r;if(t.flags&4)try{r=JSON.parse(new TextDecoder().decode(t.payload))}catch(h){this.emit("error",h),this.#o=!(t.flags&2);return}let s,a=new ReadableStream({start:h=>{s=h,this.#a=h},cancel:()=>{this.#a=null}});if(this.#d=0,this.emit("stream",a,r),t.flags&4){t.flags&2&&(s?.close(),this.#a=null);return}}let n=this.#a;if(n){if(n.enqueue(t.payload),this.#d+=t.payload.byteLength,this.emit("progress",{direction:"receive",bytes:this.#d}),(n.desiredSize??0)<-32){n.error(new Error("Receive stream backlog exceeded")),this.#a=null,this.#o=!(t.flags&2);return}t.flags&2&&(n.close(),this.#a=null)}}#h(e,t){this.#l||(this.#n.push(B(e,t)),this.#c())}#y(){return!this.#l&&this.channel.readyState==="open"&&this.#n.length===0&&this.channel.bufferedAmount<=this.channel.bufferedAmountLowThreshold}#T(){let e=this.#n.findIndex(t=>typeof t=="string");return e>=0?this.#n.splice(e,1)[0]:this.#n.shift()}#c(){if(!(this.#l||this.channel.readyState!=="open")){for(;this.#n.length>0&&!(this.channel.bufferedAmount>this.channel.bufferedAmountLowThreshold);){let e=this.#T();if(e===void 0)break;try{typeof e=="string"?this.channel.send(e):this.channel.send(e)}catch(t){this.emit("error",t),this.#n.unshift(e);break}}this.#p()}}#g(e){if(this.#l)return Promise.reject(new Error("Data channel closed"));if(e?.aborted)return Promise.reject(e.reason??new Error("Aborted"));if(this.#y())return Promise.resolve();this.#r||(this.#r=Promise.withResolvers());let{promise:t}=this.#r,n=()=>{this.#r?.reject(e?.reason??new Error("Aborted")),this.#r=null};return e?.addEventListener("abort",n,{once:!0}),t.finally(()=>{e?.removeEventListener("abort",n)})}#p(){this.#y()&&(this.#r?.resolve(),this.#r=null)}};var E=class{remoteId;channels=new Map;#t;#e;#s;#i=[];#n=!1;#r=!1;constructor(e){this.remoteId=e.remoteId,this.#t=e,this.#s=e.localId>e.remoteId,this.#e=new RTCPeerConnection(e.rtcConfig),this.#e.onicecandidate=t=>{t.candidate&&this.#t.onSignal({type:"candidate",candidate:t.candidate})},this.#e.onnegotiationneeded=async()=>{try{this.#n=!0,await this.#e.setLocalDescription(),this.#t.onSignal({type:"description",description:this.#e.localDescription})}catch{}finally{this.#n=!1}},this.#e.onconnectionstatechange=()=>{["disconnected","failed","closed"].includes(this.#e.connectionState)&&this.#t.onDisconnect()},this.#e.ontrack=t=>{let n=t.streams[0];t.track.onended=()=>this.#t.onTrackEnded(t.track,n),this.#t.onTrack(t.track,n)},this.#e.ondatachannel=t=>this.#a(t.channel)}addTrack(e,t){this.#e.addTrack(e,t)}removeTrack(e){let t=this.#e.getSenders().find(n=>n.track===e);if(t)try{this.#e.removeTrack(t)}catch{}}async receiveSignal(e){try{if(e.type==="description"){let t=e.description.type==="offer"&&(this.#n||this.#e.signalingState!=="stable");if(this.#r=!this.#s&&t,this.#r)return;await this.#e.setRemoteDescription(e.description);for(let n of this.#i)await this.#e.addIceCandidate(n);this.#i=[],e.description.type==="offer"&&(await this.#e.setLocalDescription(),this.#t.onSignal({type:"description",description:this.#e.localDescription}));return}this.#e.remoteDescription?await this.#e.addIceCandidate(e.candidate):this.#i.push(e.candidate)}catch{}}createDataChannel(e,t){this.#s||this.#a(this.#e.createDataChannel(e,t))}#a(e){this.channels.get(e.label)?.destroy();let n=new w(e,this.#e,this.#t.limiter);this.channels.set(e.label,n),this.#t.onChannel(n)}destroy(){this.#e.onicecandidate=null,this.#e.onnegotiationneeded=null,this.#e.onconnectionstatechange=null,this.#e.ontrack=null,this.#e.ondatachannel=null;for(let e of this.#e.getReceivers())e.track.onended=null;for(let e of this.channels.values())e.destroy();this.channels.clear();try{this.#e.close()}catch{}}};var k=class extends p{id;rtcConfig;#t=new Map;#e;#s=new Set;#i=new Map;#n;#r=new Set;constructor({id:e,signal:t,rtcConfig:n=F,maxTransfers:r=L}){super(),this.id=e,this.#e=t,this.rtcConfig=n,this.#n=new S(r)}add(e){this.#s.add(e);for(let t of e.getTracks())for(let n of this.#t.values())n.addTrack(t,e)}remove(e){this.#s.delete(e);for(let t of e.getTracks())for(let n of this.#t.values())n.removeTrack(t)}channel(e,t={}){this.#i.set(e,t);for(let n of this.#t.values())n.createDataChannel(e,t)}getChannel(e,t){return this.#t.get(e)?.channels.get(t)}whenOpen(e,t,n={}){let r=this.getChannel(e,t);if(r?.channel.readyState==="open")return Promise.resolve(r);let{promise:s,resolve:a,reject:h}=Promise.withResolvers(),m=[],u=!1,c=(o,l)=>{if(!u){u=!0;for(let g of m)g();n.signal?.removeEventListener("abort",d),l?a(l):h(o??new Error("Channel open failed"))}},d=()=>{c(n.signal?.reason??new Error("Aborted"))};if(n.signal?.aborted)return Promise.reject(n.signal.reason??new Error("Aborted"));n.signal?.addEventListener("abort",d,{once:!0});let b=o=>{if(o.channel.readyState==="open"){c(void 0,o);return}m.push(o.on("open",()=>c(void 0,o)),o.on("close",()=>c(new Error("Data channel closed"))))},y=this.getChannel(e,t);return y&&b(y),m.push(this.on("channel",(o,l)=>{o!==e||l.channel.label!==t||b(l)}),this.on("leave",o=>{o===e&&c(new Error(`Peer left: ${e}`))})),s}connect(e){if(this.#t.has(e))return;let t=new E({localId:this.id,remoteId:e,rtcConfig:this.rtcConfig,limiter:this.#n,onSignal:n=>this.#e(e,n),onTrack:(n,r)=>this.emit("track",e,n,r),onTrackEnded:(n,r)=>this.emit("track-ended",e,n,r),onChannel:n=>{this.emit("channel",e,n);let r=()=>this.#o(e);n.on("open",r),n.channel.readyState==="open"&&r()},onDisconnect:()=>{this.#t.delete(e)&&(this.#r.delete(e),t.destroy(),this.emit("leave",e))}});this.#i.forEach((n,r)=>t.createDataChannel(r,n));for(let n of this.#s)for(let r of n.getTracks())t.addTrack(r,n);this.#t.set(e,t),this.emit("join",e),this.#o(e)}receive(e,t){this.connect(e),this.#t.get(e).receiveSignal(t)}async sendTo(e,t,n,r={}){let s=this.#t.get(e);if(!s)throw new Error(`Unknown peer: ${e}`);let a=s.channels.get(t);if(!a)throw new Error(`No channel "${t}" for peer ${e}`);if(a.channel.readyState!=="open")throw new Error(`Channel "${t}" with ${e} is not open`);await a.send(n,r)}async send(e,t,n={}){let r=[];for(let s of this.#t.values()){let a=s.channels.get(e);a?.channel.readyState==="open"&&r.push(a)}if(r.length!==0){if(r.length>1&&typeof t!="string"&&!_(t))throw new Error("Pass a Blob/File/BufferSource to send to multiple peers");await Promise.all(r.map(s=>s.send(t,n)))}}close(e){let t=this.#t.get(e);t&&(this.#t.delete(e),this.#r.delete(e),t.destroy(),this.emit("leave",e))}destroy(){this.#n.destroy();for(let e of[...this.#t.keys()])this.close(e);this.#s.clear(),this.#i.clear(),this.#r.clear(),super.destroy()}#a(e){let t=this.#t.get(e);if(!t)return!1;for(let n of this.#i.keys()){let r=t.channels.get(n);if(!r||r.channel.readyState!=="open")return!1}return!0}#o(e){this.#r.has(e)||this.#a(e)&&(this.#r.add(e),this.emit("ready",e))}};0&&(module.exports={FastDataChannel,RTCManager});

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+export { FastDataChannel } from "./fast-data-channel";
+export { RTCManager, type SignalPayload } from "./rtc-manager";
+export type { SendData, SendOptions } from "./stream-source";

package/dist/index.js

@@ -0,0 +1 @@
+var P={iceServers:[{urls:"stun:stun.l.google.com:19302"}]},F=4;var p=class{#t=new Map;on(e,t){let n=t,r=this.#t.get(e)??[];return r.push(n),this.#t.set(e,r),()=>{let s=this.#t.get(e);if(!s)return;let a=s.indexOf(n);a>=0&&s.splice(a,1),s.length===0&&this.#t.delete(e)}}has(e){return(this.#t.get(e)?.length??0)>0}emit(e,...t){let n=this.#t.get(e);if(n)for(let r of n.slice())r(...t)}destroy(){this.#t.clear()}};function M(i,e){let t=new ArrayBuffer(2+e.byteLength),n=new DataView(t);return n.setUint8(0,252),n.setUint8(1,i),new Uint8Array(t,2).set(e),t}function B(i){if(i.byteLength<2)return null;let e=new DataView(i);return e.getUint8(0)!==252?null:{flags:e.getUint8(1),payload:new Uint8Array(i,2)}}function U(i){return i instanceof Blob||i instanceof ArrayBuffer||ArrayBuffer.isView(i)}function _(i){if(i instanceof Blob)return i.stream();if(i instanceof ArrayBuffer||ArrayBuffer.isView(i)){let t=T(i);return new ReadableStream({start(n){n.enqueue(t),n.close()}})}if(i instanceof ReadableStream)return i;let e=i[Symbol.asyncIterator]();return new ReadableStream({async pull(t){let{done:n,value:r}=await e.next();if(n){t.close();return}t.enqueue(T(r))},cancel:()=>{e.return?.()}})}function T(i){if(i instanceof Uint8Array)return i;if(i instanceof ArrayBuffer)return new Uint8Array(i);if(ArrayBuffer.isView(i))return new Uint8Array(i.buffer,i.byteOffset,i.byteLength);if(typeof i=="string")return new TextEncoder().encode(i);throw i instanceof Blob?new Error("Pass the Blob/File to send, not blob chunks"):new Error("Unsupported stream chunk")}var S=class{#t;#e=0;#s=[];#i=!1;constructor(e){this.#t=e}async acquire(){if(this.#i)throw new Error("Transfer limiter destroyed");if(this.#e<this.#t)this.#e++;else{let t=Promise.withResolvers();if(this.#s.push(t),await t.promise,this.#i)throw this.#e--,new Error("Transfer limiter destroyed")}let e=!1;return()=>{e||(e=!0,this.#n())}}destroy(){this.#i=!0;let e=new Error("Transfer limiter destroyed");for(let t of this.#s.splice(0))t.reject(e)}#n(){if(this.#i){this.#e--;return}let e=this.#s.shift();if(e){e.resolve();return}this.#e--}};function j(i){let e=i?.maxMessageSize;return!e||!Number.isFinite(e)?65536:e}var b=class extends p{channel;#t=0;#e=null;#s=null;#i;#n=[];#r=null;#a=null;#o=!1;#l=!1;#u=Promise.resolve();#d=0;constructor(e,t,n=new S(1/0)){super(),this.channel=e,this.#i=n,t instanceof RTCPeerConnection?this.#e=t:this.#s=t,this.#f(),this.channel.binaryType="arraybuffer",this.channel.onopen=()=>this.#m(),this.channel.onclose=()=>this.destroy(),this.channel.onmessage=r=>this.#C(r.data),this.channel.onerror=r=>this.emit("error",r),this.channel.onbufferedamountlow=()=>{this.#c(),this.#p()},this.channel.readyState==="open"&&queueMicrotask(()=>this.#m())}async send(e,t={}){if(this.#l)throw new Error("Data channel closed");if(typeof e=="string"){this.#n.push(e),this.#c();return}await this.#v(async()=>{let n=await this.#i.acquire();try{await this.#b(e,t)}finally{n()}})}destroy(){if(this.#l)return;this.#l=!0,this.#n.length=0,this.#o=!1;let e=new Error("Data channel closed");this.#r?.reject(e),this.#r=null,this.#a?.error(e),this.#a=null,this.emit("close"),this.channel.onopen=null,this.channel.onclose=null,this.channel.onmessage=null,this.channel.onerror=null,this.channel.onbufferedamountlow=null,super.destroy();try{this.channel.close()}catch{}}#m(){this.#l||(this.#f(),this.#c(),this.emit("open"))}#f(){let e=j(this.#s??this.#e?.sctp??null);this.#t=Math.max(1,e-2),this.channel.bufferedAmountLowThreshold=e*2}async#v(e){let t=this.#u,{promise:n,resolve:r}=Promise.withResolvers();this.#u=n,await t;try{await e()}finally{r()}}#S(e,t){if(e instanceof Blob)return e.size-t;if(e instanceof ArrayBuffer||ArrayBuffer.isView(e))return e.byteLength-t}#w(e,t,n){n?.(e,t),this.emit("progress",{direction:"send",bytes:e,total:t})}async#b(e,t){this.#f();let n=t.offset??0;if(n!==0&&!(e instanceof Blob))throw new Error("offset requires a Blob/File");let r=e;n!==0&&e instanceof Blob&&(r=e.slice(n));let s=this.#S(e,n),a=0,h=!1;if(t.meta!==void 0){let l=new TextEncoder().encode(JSON.stringify(t.meta));this.#h(5,l),h=!0}let m=_(r),u=m.getReader(),c=!h,d=null,w=()=>{if(t.signal?.aborted)throw t.signal.reason??new Error("Aborted");if(this.#l)throw new Error("Data channel closed")},y=l=>{if(!d)return;let g=d.payload;this.#h(d.flags|(l?2:0),g),d=null,a+=g.byteLength,this.#w(a,s,t.onProgress)},o=()=>{u.cancel(t.signal?.reason??new Error("Aborted"))};t.signal?.addEventListener("abort",o,{once:!0});try{for(;;){w(),await this.#g(t.signal);let{done:l,value:g}=await u.read();if(l){d?y(!0):c?this.#h(3,new Uint8Array(0)):h&&this.#h(2,new Uint8Array(0));break}let k=T(g),C=0;for(;C<k.byteLength;){w(),await this.#g(t.signal);let x=Math.min(C+this.#t,k.byteLength);y(!1);let O=c?1:0;c=!1,d={flags:O,payload:k.subarray(C,x)},C=x}}}catch(l){try{d?y(!0):c||this.#h(2,new Uint8Array(0))}catch{}try{await u.cancel(l)}catch{}throw l}finally{t.signal?.removeEventListener("abort",o),m.locked&&u.releaseLock()}}#C(e){let t=e instanceof ArrayBuffer?B(e):null;if(!t){this.emit("message",e);return}if(this.#o){t.flags&2&&(this.#o=!1);return}if(!this.#a){if(!(t.flags&1))return;if(!this.has("stream")){this.#o=!(t.flags&2);return}let r;if(t.flags&4)try{r=JSON.parse(new TextDecoder().decode(t.payload))}catch(h){this.emit("error",h),this.#o=!(t.flags&2);return}let s,a=new ReadableStream({start:h=>{s=h,this.#a=h},cancel:()=>{this.#a=null}});if(this.#d=0,this.emit("stream",a,r),t.flags&4){t.flags&2&&(s?.close(),this.#a=null);return}}let n=this.#a;if(n){if(n.enqueue(t.payload),this.#d+=t.payload.byteLength,this.emit("progress",{direction:"receive",bytes:this.#d}),(n.desiredSize??0)<-32){n.error(new Error("Receive stream backlog exceeded")),this.#a=null,this.#o=!(t.flags&2);return}t.flags&2&&(n.close(),this.#a=null)}}#h(e,t){this.#l||(this.#n.push(M(e,t)),this.#c())}#y(){return!this.#l&&this.channel.readyState==="open"&&this.#n.length===0&&this.channel.bufferedAmount<=this.channel.bufferedAmountLowThreshold}#T(){let e=this.#n.findIndex(t=>typeof t=="string");return e>=0?this.#n.splice(e,1)[0]:this.#n.shift()}#c(){if(!(this.#l||this.channel.readyState!=="open")){for(;this.#n.length>0&&!(this.channel.bufferedAmount>this.channel.bufferedAmountLowThreshold);){let e=this.#T();if(e===void 0)break;try{typeof e=="string"?this.channel.send(e):this.channel.send(e)}catch(t){this.emit("error",t),this.#n.unshift(e);break}}this.#p()}}#g(e){if(this.#l)return Promise.reject(new Error("Data channel closed"));if(e?.aborted)return Promise.reject(e.reason??new Error("Aborted"));if(this.#y())return Promise.resolve();this.#r||(this.#r=Promise.withResolvers());let{promise:t}=this.#r,n=()=>{this.#r?.reject(e?.reason??new Error("Aborted")),this.#r=null};return e?.addEventListener("abort",n,{once:!0}),t.finally(()=>{e?.removeEventListener("abort",n)})}#p(){this.#y()&&(this.#r?.resolve(),this.#r=null)}};var E=class{remoteId;channels=new Map;#t;#e;#s;#i=[];#n=!1;#r=!1;constructor(e){this.remoteId=e.remoteId,this.#t=e,this.#s=e.localId>e.remoteId,this.#e=new RTCPeerConnection(e.rtcConfig),this.#e.onicecandidate=t=>{t.candidate&&this.#t.onSignal({type:"candidate",candidate:t.candidate})},this.#e.onnegotiationneeded=async()=>{try{this.#n=!0,await this.#e.setLocalDescription(),this.#t.onSignal({type:"description",description:this.#e.localDescription})}catch{}finally{this.#n=!1}},this.#e.onconnectionstatechange=()=>{["disconnected","failed","closed"].includes(this.#e.connectionState)&&this.#t.onDisconnect()},this.#e.ontrack=t=>{let n=t.streams[0];t.track.onended=()=>this.#t.onTrackEnded(t.track,n),this.#t.onTrack(t.track,n)},this.#e.ondatachannel=t=>this.#a(t.channel)}addTrack(e,t){this.#e.addTrack(e,t)}removeTrack(e){let t=this.#e.getSenders().find(n=>n.track===e);if(t)try{this.#e.removeTrack(t)}catch{}}async receiveSignal(e){try{if(e.type==="description"){let t=e.description.type==="offer"&&(this.#n||this.#e.signalingState!=="stable");if(this.#r=!this.#s&&t,this.#r)return;await this.#e.setRemoteDescription(e.description);for(let n of this.#i)await this.#e.addIceCandidate(n);this.#i=[],e.description.type==="offer"&&(await this.#e.setLocalDescription(),this.#t.onSignal({type:"description",description:this.#e.localDescription}));return}this.#e.remoteDescription?await this.#e.addIceCandidate(e.candidate):this.#i.push(e.candidate)}catch{}}createDataChannel(e,t){this.#s||this.#a(this.#e.createDataChannel(e,t))}#a(e){this.channels.get(e.label)?.destroy();let n=new b(e,this.#e,this.#t.limiter);this.channels.set(e.label,n),this.#t.onChannel(n)}destroy(){this.#e.onicecandidate=null,this.#e.onnegotiationneeded=null,this.#e.onconnectionstatechange=null,this.#e.ontrack=null,this.#e.ondatachannel=null;for(let e of this.#e.getReceivers())e.track.onended=null;for(let e of this.channels.values())e.destroy();this.channels.clear();try{this.#e.close()}catch{}}};var R=class extends p{id;rtcConfig;#t=new Map;#e;#s=new Set;#i=new Map;#n;#r=new Set;constructor({id:e,signal:t,rtcConfig:n=P,maxTransfers:r=F}){super(),this.id=e,this.#e=t,this.rtcConfig=n,this.#n=new S(r)}add(e){this.#s.add(e);for(let t of e.getTracks())for(let n of this.#t.values())n.addTrack(t,e)}remove(e){this.#s.delete(e);for(let t of e.getTracks())for(let n of this.#t.values())n.removeTrack(t)}channel(e,t={}){this.#i.set(e,t);for(let n of this.#t.values())n.createDataChannel(e,t)}getChannel(e,t){return this.#t.get(e)?.channels.get(t)}whenOpen(e,t,n={}){let r=this.getChannel(e,t);if(r?.channel.readyState==="open")return Promise.resolve(r);let{promise:s,resolve:a,reject:h}=Promise.withResolvers(),m=[],u=!1,c=(o,l)=>{if(!u){u=!0;for(let g of m)g();n.signal?.removeEventListener("abort",d),l?a(l):h(o??new Error("Channel open failed"))}},d=()=>{c(n.signal?.reason??new Error("Aborted"))};if(n.signal?.aborted)return Promise.reject(n.signal.reason??new Error("Aborted"));n.signal?.addEventListener("abort",d,{once:!0});let w=o=>{if(o.channel.readyState==="open"){c(void 0,o);return}m.push(o.on("open",()=>c(void 0,o)),o.on("close",()=>c(new Error("Data channel closed"))))},y=this.getChannel(e,t);return y&&w(y),m.push(this.on("channel",(o,l)=>{o!==e||l.channel.label!==t||w(l)}),this.on("leave",o=>{o===e&&c(new Error(`Peer left: ${e}`))})),s}connect(e){if(this.#t.has(e))return;let t=new E({localId:this.id,remoteId:e,rtcConfig:this.rtcConfig,limiter:this.#n,onSignal:n=>this.#e(e,n),onTrack:(n,r)=>this.emit("track",e,n,r),onTrackEnded:(n,r)=>this.emit("track-ended",e,n,r),onChannel:n=>{this.emit("channel",e,n);let r=()=>this.#o(e);n.on("open",r),n.channel.readyState==="open"&&r()},onDisconnect:()=>{this.#t.delete(e)&&(this.#r.delete(e),t.destroy(),this.emit("leave",e))}});this.#i.forEach((n,r)=>t.createDataChannel(r,n));for(let n of this.#s)for(let r of n.getTracks())t.addTrack(r,n);this.#t.set(e,t),this.emit("join",e),this.#o(e)}receive(e,t){this.connect(e),this.#t.get(e).receiveSignal(t)}async sendTo(e,t,n,r={}){let s=this.#t.get(e);if(!s)throw new Error(`Unknown peer: ${e}`);let a=s.channels.get(t);if(!a)throw new Error(`No channel "${t}" for peer ${e}`);if(a.channel.readyState!=="open")throw new Error(`Channel "${t}" with ${e} is not open`);await a.send(n,r)}async send(e,t,n={}){let r=[];for(let s of this.#t.values()){let a=s.channels.get(e);a?.channel.readyState==="open"&&r.push(a)}if(r.length!==0){if(r.length>1&&typeof t!="string"&&!U(t))throw new Error("Pass a Blob/File/BufferSource to send to multiple peers");await Promise.all(r.map(s=>s.send(t,n)))}}close(e){let t=this.#t.get(e);t&&(this.#t.delete(e),this.#r.delete(e),t.destroy(),this.emit("leave",e))}destroy(){this.#n.destroy();for(let e of[...this.#t.keys()])this.close(e);this.#s.clear(),this.#i.clear(),this.#r.clear(),super.destroy()}#a(e){let t=this.#t.get(e);if(!t)return!1;for(let n of this.#i.keys()){let r=t.channels.get(n);if(!r||r.channel.readyState!=="open")return!1}return!0}#o(e){this.#r.has(e)||this.#a(e)&&(this.#r.add(e),this.emit("ready",e))}};export{b as FastDataChannel,R as RTCManager};

package/dist/peer-node.d.ts

@@ -0,0 +1,26 @@
+import { FastDataChannel } from "./fast-data-channel";
+import type { SignalPayload } from "./rtc-manager";
+import type { TransferLimiter } from "./transfer-limiter";
+type PeerNodeOptions = {
+    localId: string;
+    remoteId: string;
+    rtcConfig: RTCConfiguration;
+    limiter: TransferLimiter;
+    onSignal: (payload: SignalPayload) => void;
+    onTrack: (track: MediaStreamTrack, stream: MediaStream) => void;
+    onTrackEnded: (track: MediaStreamTrack, stream: MediaStream) => void;
+    onChannel: (channel: FastDataChannel) => void;
+    onDisconnect: () => void;
+};
+export declare class PeerNode {
+    #private;
+    readonly remoteId: string;
+    readonly channels: Map<string, FastDataChannel>;
+    constructor(opts: PeerNodeOptions);
+    addTrack(track: MediaStreamTrack, stream: MediaStream): void;
+    removeTrack(track: MediaStreamTrack): void;
+    receiveSignal(signal: SignalPayload): Promise<void>;
+    createDataChannel(label: string, options?: RTCDataChannelInit): void;
+    destroy(): void;
+}
+export {};

package/dist/rtc-manager.d.ts

@@ -0,0 +1,44 @@
+import { EventEmitter } from "./event-emitter";
+import { FastDataChannel } from "./fast-data-channel";
+import { type SendData, type SendOptions } from "./stream-source";
+export type SignalPayload = {
+    type: "description";
+    description: RTCSessionDescriptionInit;
+} | {
+    type: "candidate";
+    candidate: RTCIceCandidateInit;
+};
+interface RTCManagerOptions {
+    id: string;
+    signal: (to: string, payload: SignalPayload) => void;
+    rtcConfig?: RTCConfiguration;
+    maxTransfers?: number;
+}
+interface RTCManagerEvents {
+    join: (id: string) => void;
+    leave: (id: string) => void;
+    ready: (id: string) => void;
+    channel: (id: string, channel: FastDataChannel) => void;
+    track: (id: string, track: MediaStreamTrack, stream: MediaStream) => void;
+    "track-ended": (id: string, track: MediaStreamTrack, stream: MediaStream) => void;
+}
+export declare class RTCManager extends EventEmitter<RTCManagerEvents> {
+    #private;
+    readonly id: string;
+    readonly rtcConfig: RTCConfiguration;
+    constructor({ id, signal, rtcConfig, maxTransfers, }: RTCManagerOptions);
+    add(stream: MediaStream): void;
+    remove(stream: MediaStream): void;
+    channel(label: string, options?: RTCDataChannelInit): void;
+    getChannel(peerId: string, label: string): FastDataChannel | undefined;
+    whenOpen(peerId: string, label: string, options?: {
+        signal?: AbortSignal;
+    }): Promise<FastDataChannel>;
+    connect(remoteId: string): void;
+    receive(remoteId: string, payload: SignalPayload): void;
+    sendTo(peerId: string, label: string, data: SendData, options?: SendOptions): Promise<void>;
+    send(label: string, data: SendData, options?: SendOptions): Promise<void>;
+    close(remoteId: string): void;
+    destroy(): void;
+}
+export {};

package/dist/stream-source.d.ts

@@ -0,0 +1,12 @@
+export type SendableData = string | Blob | ArrayBuffer | ArrayBufferView;
+export type SendData = string | Blob | BufferSource | ReadableStream<SendableData> | AsyncIterable<SendableData>;
+export type SendOptions = {
+    signal?: AbortSignal;
+    meta?: unknown;
+    /** Blob/File only. Slice from this byte before streaming. */
+    offset?: number;
+    onProgress?: (bytes: number, total?: number) => void;
+};
+export declare function canCloneSource(data: SendData): boolean;
+export declare function toReadableStream(source: Exclude<SendData, string>): ReadableStream<SendableData>;
+export declare function normalizeChunk(value: SendableData): Uint8Array;

package/dist/transfer-limiter.d.ts

@@ -0,0 +1,6 @@
+export declare class TransferLimiter {
+    #private;
+    constructor(max: number);
+    acquire(): Promise<() => void>;
+    destroy(): void;
+}

package/package.json

@@ -0,0 +1,37 @@
+{
+  "name": "fastrtc",
+  "version": "1.0.0",
+  "description": "Easy to use, zero-dependency WebRTC mesh library for browsers",
+  "keywords": [
+    "datachannel",
+    "fast",
+    "mesh",
+    "p2p",
+    "rtc",
+    "webrtc"
+  ],
+  "license": "MIT",
+  "author": "n0tz3r0",
+  "files": [
+    "dist"
+  ],
+  "type": "module",
+  "main": "dist/index.cjs",
+  "module": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    }
+  },
+  "devDependencies": {
+    "typescript": "^7.0.2",
+    "tsup": "^8.5.1"
+  },
+  "scripts": {
+    "clean": "rm -rf dist",
+    "build": "pnpm clean && tsup && tsc",
+    "test": "echo \"Error: no test specified\" && exit 1"
+  }
+}