rollback-netcode 0.0.4

package/dist/transport/local.js

@@ -0,0 +1,435 @@
+/**
+ * Local/in-memory transport for testing.
+ *
+ * Allows connecting multiple LocalTransport instances together
+ * with simulated network conditions (latency, jitter, packet loss).
+ */
+/**
+ * Min-heap implementation for efficient message queue ordering.
+ * Uses deliverAt time as the priority.
+ */
+class MessageHeap {
+    heap = [];
+    /**
+     * Get the number of messages in the heap.
+     */
+    get length() {
+        return this.heap.length;
+    }
+    /**
+     * Insert a message into the heap. O(log n)
+     */
+    push(message) {
+        this.heap.push(message);
+        this.bubbleUp(this.heap.length - 1);
+    }
+    /**
+     * Remove and return the message with the earliest delivery time. O(log n)
+     */
+    pop() {
+        if (this.heap.length === 0) {
+            return undefined;
+        }
+        const min = this.heap[0];
+        const last = this.heap.pop();
+        if (this.heap.length > 0 && last !== undefined) {
+            this.heap[0] = last;
+            this.bubbleDown(0);
+        }
+        return min;
+    }
+    /**
+     * Peek at the message with the earliest delivery time without removing it.
+     */
+    peek() {
+        return this.heap[0];
+    }
+    /**
+     * Clear all messages from the heap.
+     */
+    clear() {
+        this.heap.length = 0;
+    }
+    /**
+     * Move a node up the heap to maintain heap property.
+     */
+    bubbleUp(startIndex) {
+        let idx = startIndex;
+        while (idx > 0) {
+            const parentIndex = Math.floor((idx - 1) / 2);
+            const parent = this.heap[parentIndex];
+            const current = this.heap[idx];
+            if (parent === undefined || current === undefined)
+                break;
+            if (parent.deliverAt <= current.deliverAt)
+                break;
+            // Swap with parent
+            this.heap[parentIndex] = current;
+            this.heap[idx] = parent;
+            idx = parentIndex;
+        }
+    }
+    /**
+     * Move a node down the heap to maintain heap property.
+     */
+    bubbleDown(startIndex) {
+        const length = this.heap.length;
+        let idx = startIndex;
+        while (true) {
+            const leftIndex = 2 * idx + 1;
+            const rightIndex = 2 * idx + 2;
+            let smallest = idx;
+            const current = this.heap[idx];
+            const left = this.heap[leftIndex];
+            const right = this.heap[rightIndex];
+            if (current === undefined)
+                break;
+            if (leftIndex < length &&
+                left !== undefined &&
+                left.deliverAt < current.deliverAt) {
+                smallest = leftIndex;
+            }
+            const smallestItem = this.heap[smallest];
+            if (rightIndex < length &&
+                right !== undefined &&
+                smallestItem !== undefined &&
+                right.deliverAt < smallestItem.deliverAt) {
+                smallest = rightIndex;
+            }
+            if (smallest === idx)
+                break;
+            // Swap with smallest child
+            const swap = this.heap[smallest];
+            if (swap !== undefined) {
+                this.heap[smallest] = current;
+                this.heap[idx] = swap;
+            }
+            idx = smallest;
+        }
+    }
+}
+/**
+ * Simple seeded random number generator for deterministic testing.
+ */
+class SeededRandom {
+    seed;
+    constructor(seed) {
+        this.seed = seed;
+    }
+    /**
+     * Returns a random number between 0 and 1.
+     */
+    next() {
+        // Simple LCG
+        this.seed = (this.seed * 1664525 + 1013904223) >>> 0;
+        return this.seed / 0xffffffff;
+    }
+}
+/**
+ * In-memory transport for testing.
+ *
+ * Features:
+ * - Connect multiple LocalTransport instances together
+ * - Simulated network conditions (latency, jitter, packet loss)
+ * - Deterministic mode for reproducible tests
+ * - Manual time control via tick() method
+ */
+export class LocalTransport {
+    localPeerId;
+    onMessage = null;
+    onConnect = null;
+    onDisconnect = null;
+    onError = null;
+    /** Callback for keepalive ping - set by Session to send Ping messages */
+    onKeepalivePing = null;
+    _connectedPeers = new Set();
+    linkedTransports = new Map();
+    pendingMessages = new MessageHeap();
+    packetLoss;
+    random;
+    currentTime = 0;
+    /** Simulated one-way latency in milliseconds */
+    _latency = 0;
+    /** Simulated jitter (latency variation) in milliseconds */
+    _jitter = 0;
+    /**
+     * Create a new LocalTransport.
+     *
+     * @param localPeerId - Unique ID for this transport
+     * @param config - Network simulation configuration
+     */
+    constructor(localPeerId, config) {
+        this.localPeerId = localPeerId;
+        this.latency = config?.latency ?? 0;
+        this.jitter = config?.jitter ?? 0;
+        this.packetLoss = config?.packetLoss ?? 0;
+        const deterministic = config?.deterministic ?? false;
+        const seed = config?.seed ?? 12345;
+        this.random = deterministic ? new SeededRandom(seed) : null;
+    }
+    /**
+     * Get the set of connected peer IDs.
+     */
+    get connectedPeers() {
+        return this._connectedPeers;
+    }
+    /**
+     * Link two LocalTransport instances together.
+     * Creates a bidirectional connection.
+     *
+     * @param a - First transport
+     * @param b - Second transport
+     */
+    static link(a, b) {
+        a.linkedTransports.set(b.localPeerId, b);
+        b.linkedTransports.set(a.localPeerId, a);
+    }
+    /**
+     * Unlink two LocalTransport instances.
+     *
+     * @param a - First transport
+     * @param b - Second transport
+     */
+    static unlink(a, b) {
+        a.linkedTransports.delete(b.localPeerId);
+        b.linkedTransports.delete(a.localPeerId);
+    }
+    /**
+     * Connect to a peer.
+     * The peer must be linked via LocalTransport.link().
+     */
+    async connect(peerId) {
+        const peer = this.linkedTransports.get(peerId);
+        if (!peer) {
+            throw new Error(`Peer ${peerId} is not linked`);
+        }
+        if (this._connectedPeers.has(peerId)) {
+            return; // Already connected
+        }
+        // Add to connected peers on both sides
+        this._connectedPeers.add(peerId);
+        peer._connectedPeers.add(this.localPeerId);
+        // Notify both sides
+        this.onConnect?.(peerId);
+        peer.onConnect?.(this.localPeerId);
+    }
+    /**
+     * Disconnect from a peer.
+     */
+    disconnect(peerId) {
+        if (!this._connectedPeers.has(peerId)) {
+            return;
+        }
+        const peer = this.linkedTransports.get(peerId);
+        // Remove from connected peers on both sides
+        this._connectedPeers.delete(peerId);
+        if (peer) {
+            peer._connectedPeers.delete(this.localPeerId);
+            peer.onDisconnect?.(this.localPeerId);
+        }
+        this.onDisconnect?.(peerId);
+    }
+    /**
+     * Disconnect from all peers.
+     */
+    disconnectAll() {
+        const peers = Array.from(this._connectedPeers);
+        for (const peerId of peers) {
+            this.disconnect(peerId);
+        }
+    }
+    /**
+     * Send a message to a specific peer.
+     * Uses a min-heap for O(log n) insertion instead of O(n log n) sort.
+     */
+    send(peerId, message, reliable) {
+        if (!this._connectedPeers.has(peerId)) {
+            return; // Not connected, silently drop
+        }
+        // Check for packet loss (unreliable only)
+        if (!reliable && this.shouldDropPacket()) {
+            return;
+        }
+        // Calculate delivery time with latency and jitter
+        const deliverAt = this.currentTime + this.calculateDelay();
+        // Copy message to prevent external mutation
+        const messageCopy = new Uint8Array(message.length);
+        messageCopy.set(message);
+        // Push to heap - O(log n) instead of O(n log n) for sort
+        this.pendingMessages.push({
+            targetPeerId: peerId,
+            message: messageCopy,
+            deliverAt,
+            reliable,
+        });
+    }
+    /**
+     * Broadcast a message to all connected peers.
+     */
+    broadcast(message, reliable) {
+        for (const peerId of this._connectedPeers) {
+            this.send(peerId, message, reliable);
+        }
+    }
+    /**
+     * Process all pending messages immediately, ignoring simulated delay.
+     * Useful for synchronous tests.
+     */
+    flush() {
+        while (this.pendingMessages.length > 0) {
+            const pending = this.pendingMessages.pop();
+            if (pending !== undefined) {
+                this.deliverMessage(pending);
+            }
+        }
+    }
+    /**
+     * Advance simulated time and deliver any messages due.
+     *
+     * @param deltaMs - Time to advance in milliseconds
+     */
+    tick(deltaMs) {
+        this.currentTime += deltaMs;
+        this.deliverDueMessages();
+    }
+    /**
+     * Get the current simulated time.
+     */
+    getCurrentTime() {
+        return this.currentTime;
+    }
+    /**
+     * Set the current simulated time.
+     */
+    setCurrentTime(time) {
+        this.currentTime = time;
+        this.deliverDueMessages();
+    }
+    /**
+     * Get the number of pending messages.
+     */
+    getPendingMessageCount() {
+        return this.pendingMessages.length;
+    }
+    /**
+     * Deliver all messages that are due based on current time.
+     * Uses O(k log n) where k is the number of messages delivered.
+     */
+    deliverDueMessages() {
+        while (this.pendingMessages.length > 0) {
+            const first = this.pendingMessages.peek();
+            if (first === undefined || first.deliverAt > this.currentTime) {
+                break;
+            }
+            this.pendingMessages.pop();
+            this.deliverMessage(first);
+        }
+    }
+    /**
+     * Deliver a single message to its target peer.
+     * Messages are delivered regardless of current connection state, simulating
+     * real networks where messages in flight can arrive after disconnect.
+     */
+    deliverMessage(pending) {
+        const peer = this.linkedTransports.get(pending.targetPeerId);
+        if (peer) {
+            peer.onMessage?.(this.localPeerId, pending.message);
+        }
+    }
+    /**
+     * Calculate delay for a message based on latency and jitter.
+     */
+    calculateDelay() {
+        let delay = this._latency;
+        if (this._jitter > 0) {
+            const jitterAmount = this.getRandomValue() * this._jitter * 2;
+            delay += jitterAmount - this._jitter;
+        }
+        return Math.max(0, delay);
+    }
+    /**
+     * Determine if a packet should be dropped.
+     */
+    shouldDropPacket() {
+        if (this.packetLoss <= 0) {
+            return false;
+        }
+        return this.getRandomValue() < this.packetLoss;
+    }
+    /**
+     * Get a random value between 0 and 1.
+     */
+    getRandomValue() {
+        if (this.random) {
+            return this.random.next();
+        }
+        return Math.random();
+    }
+    /**
+     * Get the current simulated latency in milliseconds.
+     */
+    get latency() {
+        return this._latency;
+    }
+    /**
+     * Set the simulated latency in milliseconds.
+     * Can be changed at any time; affects only new messages.
+     */
+    set latency(value) {
+        this._latency = Math.max(0, value);
+    }
+    /**
+     * Get the current simulated jitter in milliseconds.
+     */
+    get jitter() {
+        return this._jitter;
+    }
+    /**
+     * Set the simulated jitter in milliseconds.
+     * Can be changed at any time; affects only new messages.
+     */
+    set jitter(value) {
+        this._jitter = Math.max(0, value);
+    }
+    /**
+     * Trigger keepalive pings for all connected peers.
+     * Call this periodically to trigger RTT measurement.
+     * The Session will handle the actual Ping/Pong and RTT calculation.
+     */
+    triggerKeepalive() {
+        if (!this.onKeepalivePing)
+            return;
+        for (const peerId of this._connectedPeers) {
+            this.onKeepalivePing(peerId);
+        }
+    }
+}
+/**
+ * Create a group of linked LocalTransport instances.
+ *
+ * @param peerIds - Array of peer IDs to create
+ * @param config - Optional shared configuration
+ * @returns Map of peer ID to LocalTransport
+ */
+export function createLocalTransportGroup(peerIds, config) {
+    const transports = new Map();
+    // Create all transports
+    for (const peerId of peerIds) {
+        transports.set(peerId, new LocalTransport(peerId, config));
+    }
+    // Link all transports together (full mesh)
+    const transportArray = Array.from(transports.values());
+    for (let i = 0; i < transportArray.length; i++) {
+        const transportI = transportArray[i];
+        if (!transportI)
+            continue;
+        for (let j = i + 1; j < transportArray.length; j++) {
+            const transportJ = transportArray[j];
+            if (!transportJ)
+                continue;
+            LocalTransport.link(transportI, transportJ);
+        }
+    }
+    return transports;
+}
+//# sourceMappingURL=local.js.map

package/dist/transport/local.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"local.js","sourceRoot":"","sources":["../../src/transport/local.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAqDH;;;GAGG;AACH,MAAM,WAAW;IACC,IAAI,GAAqB,EAAE,CAAC;IAE7C;;OAEG;IACH,IAAI,MAAM;QACT,OAAO,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC;IACzB,CAAC;IAED;;OAEG;IACH,IAAI,CAAC,OAAuB;QAC3B,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACxB,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IACrC,CAAC;IAED;;OAEG;IACH,GAAG;QACF,IAAI,IAAI,CAAC,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC5B,OAAO,SAAS,CAAC;QAClB,CAAC;QAED,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACzB,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC;QAE7B,IAAI,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;YAChD,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC;YACpB,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;QACpB,CAAC;QAED,OAAO,GAAG,CAAC;IACZ,CAAC;IAED;;OAEG;IACH,IAAI;QACH,OAAO,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACrB,CAAC;IAED;;OAEG;IACH,KAAK;QACJ,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC;IACtB,CAAC;IAED;;OAEG;IACK,QAAQ,CAAC,UAAkB;QAClC,IAAI,GAAG,GAAG,UAAU,CAAC;QACrB,OAAO,GAAG,GAAG,CAAC,EAAE,CAAC;YAChB,MAAM,WAAW,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;YAC9C,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;YACtC,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YAE/B,IAAI,MAAM,KAAK,SAAS,IAAI,OAAO,KAAK,SAAS;gBAAE,MAAM;YACzD,IAAI,MAAM,CAAC,SAAS,IAAI,OAAO,CAAC,SAAS;gBAAE,MAAM;YAEjD,mBAAmB;YACnB,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,GAAG,OAAO,CAAC;YACjC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,MAAM,CAAC;YACxB,GAAG,GAAG,WAAW,CAAC;QACnB,CAAC;IACF,CAAC;IAED;;OAEG;IACK,UAAU,CAAC,UAAkB;QACpC,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC;QAChC,IAAI,GAAG,GAAG,UAAU,CAAC;QAErB,OAAO,IAAI,EAAE,CAAC;YACb,MAAM,SAAS,GAAG,CAAC,GAAG,GAAG,GAAG,CAAC,CAAC;YAC9B,MAAM,UAAU,GAAG,CAAC,GAAG,GAAG,GAAG,CAAC,CAAC;YAC/B,IAAI,QAAQ,GAAG,GAAG,CAAC;YAEnB,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YAC/B,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;YAClC,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;YAEpC,IAAI,OAAO,KAAK,SAAS;gBAAE,MAAM;YAEjC,IACC,SAAS,GAAG,MAAM;gBAClB,IAAI,KAAK,SAAS;gBAClB,IAAI,CAAC,SAAS,GAAG,OAAO,CAAC,SAAS,EACjC,CAAC;gBACF,QAAQ,GAAG,SAAS,CAAC;YACtB,CAAC;YAED,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;YACzC,IACC,UAAU,GAAG,MAAM;gBACnB,KAAK,KAAK,SAAS;gBACnB,YAAY,KAAK,SAAS;gBAC1B,KAAK,CAAC,SAAS,GAAG,YAAY,CAAC,SAAS,EACvC,CAAC;gBACF,QAAQ,GAAG,UAAU,CAAC;YACvB,CAAC;YAED,IAAI,QAAQ,KAAK,GAAG;gBAAE,MAAM;YAE5B,2BAA2B;YAC3B,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;YACjC,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;gBACxB,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,OAAO,CAAC;gBAC9B,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC;YACvB,CAAC;YACD,GAAG,GAAG,QAAQ,CAAC;QAChB,CAAC;IACF,CAAC;CACD;AAED;;GAEG;AACH,MAAM,YAAY;IACT,IAAI,CAAS;IAErB,YAAY,IAAY;QACvB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IAClB,CAAC;IAED;;OAEG;IACH,IAAI;QACH,aAAa;QACb,IAAI,CAAC,IAAI,GAAG,CAAC,IAAI,CAAC,IAAI,GAAG,OAAO,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC;QACrD,OAAO,IAAI,CAAC,IAAI,GAAG,UAAU,CAAC;IAC/B,CAAC;CACD;AAED;;;;;;;;GAQG;AACH,MAAM,OAAO,cAAc;IA8BT;IA7BV,SAAS,GACf,IAAI,CAAC;IACC,SAAS,GAAsC,IAAI,CAAC;IACpD,YAAY,GAAsC,IAAI,CAAC;IACvD,OAAO,GAEJ,IAAI,CAAC;IAEf,yEAAyE;IAClE,eAAe,GAAsC,IAAI,CAAC;IAEhD,eAAe,GAAgB,IAAI,GAAG,EAAE,CAAC;IACzC,gBAAgB,GAAgC,IAAI,GAAG,EAAE,CAAC;IAC1D,eAAe,GAAgB,IAAI,WAAW,EAAE,CAAC;IACjD,UAAU,CAAS;IACnB,MAAM,CAAsB;IACrC,WAAW,GAAG,CAAC,CAAC;IACxB,gDAAgD;IACxC,QAAQ,GAAG,CAAC,CAAC;IACrB,2DAA2D;IACnD,OAAO,GAAG,CAAC,CAAC;IAEpB;;;;;OAKG;IACH,YACiB,WAAmB,EACnC,MAA6B;QADb,gBAAW,GAAX,WAAW,CAAQ;QAGnC,IAAI,CAAC,OAAO,GAAG,MAAM,EAAE,OAAO,IAAI,CAAC,CAAC;QACpC,IAAI,CAAC,MAAM,GAAG,MAAM,EAAE,MAAM,IAAI,CAAC,CAAC;QAClC,IAAI,CAAC,UAAU,GAAG,MAAM,EAAE,UAAU,IAAI,CAAC,CAAC;QAE1C,MAAM,aAAa,GAAG,MAAM,EAAE,aAAa,IAAI,KAAK,CAAC;QACrD,MAAM,IAAI,GAAG,MAAM,EAAE,IAAI,IAAI,KAAK,CAAC;QACnC,IAAI,CAAC,MAAM,GAAG,aAAa,CAAC,CAAC,CAAC,IAAI,YAAY,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IAC7D,CAAC;IAED;;OAEG;IACH,IAAI,cAAc;QACjB,OAAO,IAAI,CAAC,eAAe,CAAC;IAC7B,CAAC;IAED;;;;;;OAMG;IACH,MAAM,CAAC,IAAI,CAAC,CAAiB,EAAE,CAAiB;QAC/C,CAAC,CAAC,gBAAgB,CAAC,GAAG,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC;QACzC,CAAC,CAAC,gBAAgB,CAAC,GAAG,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC;IAC1C,CAAC;IAED;;;;;OAKG;IACH,MAAM,CAAC,MAAM,CAAC,CAAiB,EAAE,CAAiB;QACjD,CAAC,CAAC,gBAAgB,CAAC,MAAM,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC;QACzC,CAAC,CAAC,gBAAgB,CAAC,MAAM,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC;IAC1C,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,OAAO,CAAC,MAAc;QAC3B,MAAM,IAAI,GAAG,IAAI,CAAC,gBAAgB,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QAC/C,IAAI,CAAC,IAAI,EAAE,CAAC;YACX,MAAM,IAAI,KAAK,CAAC,QAAQ,MAAM,gBAAgB,CAAC,CAAC;QACjD,CAAC;QAED,IAAI,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC;YACtC,OAAO,CAAC,oBAAoB;QAC7B,CAAC;QAED,uCAAuC;QACvC,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QACjC,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;QAE3C,oBAAoB;QACpB,IAAI,CAAC,SAAS,EAAE,CAAC,MAAM,CAAC,CAAC;QACzB,IAAI,CAAC,SAAS,EAAE,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IACpC,CAAC;IAED;;OAEG;IACH,UAAU,CAAC,MAAc;QACxB,IAAI,CAAC,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC;YACvC,OAAO;QACR,CAAC;QAED,MAAM,IAAI,GAAG,IAAI,CAAC,gBAAgB,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QAE/C,4CAA4C;QAC5C,IAAI,CAAC,eAAe,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QACpC,IAAI,IAAI,EAAE,CAAC;YACV,IAAI,CAAC,eAAe,CAAC,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;YAC9C,IAAI,CAAC,YAAY,EAAE,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;QACvC,CAAC;QAED,IAAI,CAAC,YAAY,EAAE,CAAC,MAAM,CAAC,CAAC;IAC7B,CAAC;IAED;;OAEG;IACH,aAAa;QACZ,MAAM,KAAK,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;QAC/C,KAAK,MAAM,MAAM,IAAI,KAAK,EAAE,CAAC;YAC5B,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;QACzB,CAAC;IACF,CAAC;IAED;;;OAGG;IACH,IAAI,CAAC,MAAc,EAAE,OAAmB,EAAE,QAAiB;QAC1D,IAAI,CAAC,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC;YACvC,OAAO,CAAC,+BAA+B;QACxC,CAAC;QAED,0CAA0C;QAC1C,IAAI,CAAC,QAAQ,IAAI,IAAI,CAAC,gBAAgB,EAAE,EAAE,CAAC;YAC1C,OAAO;QACR,CAAC;QAED,kDAAkD;QAClD,MAAM,SAAS,GAAG,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC,cAAc,EAAE,CAAC;QAE3D,4CAA4C;QAC5C,MAAM,WAAW,GAAG,IAAI,UAAU,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QACnD,WAAW,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QAEzB,yDAAyD;QACzD,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC;YACzB,YAAY,EAAE,MAAM;YACpB,OAAO,EAAE,WAAW;YACpB,SAAS;YACT,QAAQ;SACR,CAAC,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,SAAS,CAAC,OAAmB,EAAE,QAAiB;QAC/C,KAAK,MAAM,MAAM,IAAI,IAAI,CAAC,eAAe,EAAE,CAAC;YAC3C,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,OAAO,EAAE,QAAQ,CAAC,CAAC;QACtC,CAAC;IACF,CAAC;IAED;;;OAGG;IACH,KAAK;QACJ,OAAO,IAAI,CAAC,eAAe,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACxC,MAAM,OAAO,GAAG,IAAI,CAAC,eAAe,CAAC,GAAG,EAAE,CAAC;YAC3C,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;gBAC3B,IAAI,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC;YAC9B,CAAC;QACF,CAAC;IACF,CAAC;IAED;;;;OAIG;IACH,IAAI,CAAC,OAAe;QACnB,IAAI,CAAC,WAAW,IAAI,OAAO,CAAC;QAC5B,IAAI,CAAC,kBAAkB,EAAE,CAAC;IAC3B,CAAC;IAED;;OAEG;IACH,cAAc;QACb,OAAO,IAAI,CAAC,WAAW,CAAC;IACzB,CAAC;IAED;;OAEG;IACH,cAAc,CAAC,IAAY;QAC1B,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC;QACxB,IAAI,CAAC,kBAAkB,EAAE,CAAC;IAC3B,CAAC;IAED;;OAEG;IACH,sBAAsB;QACrB,OAAO,IAAI,CAAC,eAAe,CAAC,MAAM,CAAC;IACpC,CAAC;IAED;;;OAGG;IACK,kBAAkB;QACzB,OAAO,IAAI,CAAC,eAAe,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACxC,MAAM,KAAK,GAAG,IAAI,CAAC,eAAe,CAAC,IAAI,EAAE,CAAC;YAC1C,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,CAAC,SAAS,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC;gBAC/D,MAAM;YACP,CAAC;YACD,IAAI,CAAC,eAAe,CAAC,GAAG,EAAE,CAAC;YAC3B,IAAI,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC;QAC5B,CAAC;IACF,CAAC;IAED;;;;OAIG;IACK,cAAc,CAAC,OAAuB;QAC7C,MAAM,IAAI,GAAG,IAAI,CAAC,gBAAgB,CAAC,GAAG,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC;QAC7D,IAAI,IAAI,EAAE,CAAC;YACV,IAAI,CAAC,SAAS,EAAE,CAAC,IAAI,CAAC,WAAW,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC;QACrD,CAAC;IACF,CAAC;IAED;;OAEG;IACK,cAAc;QACrB,IAAI,KAAK,GAAG,IAAI,CAAC,QAAQ,CAAC;QAE1B,IAAI,IAAI,CAAC,OAAO,GAAG,CAAC,EAAE,CAAC;YACtB,MAAM,YAAY,GAAG,IAAI,CAAC,cAAc,EAAE,GAAG,IAAI,CAAC,OAAO,GAAG,CAAC,CAAC;YAC9D,KAAK,IAAI,YAAY,GAAG,IAAI,CAAC,OAAO,CAAC;QACtC,CAAC;QAED,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;IAC3B,CAAC;IAED;;OAEG;IACK,gBAAgB;QACvB,IAAI,IAAI,CAAC,UAAU,IAAI,CAAC,EAAE,CAAC;YAC1B,OAAO,KAAK,CAAC;QACd,CAAC;QACD,OAAO,IAAI,CAAC,cAAc,EAAE,GAAG,IAAI,CAAC,UAAU,CAAC;IAChD,CAAC;IAED;;OAEG;IACK,cAAc;QACrB,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YACjB,OAAO,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;QAC3B,CAAC;QACD,OAAO,IAAI,CAAC,MAAM,EAAE,CAAC;IACtB,CAAC;IAED;;OAEG;IACH,IAAI,OAAO;QACV,OAAO,IAAI,CAAC,QAAQ,CAAC;IACtB,CAAC;IAED;;;OAGG;IACH,IAAI,OAAO,CAAC,KAAa;QACxB,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;IACpC,CAAC;IAED;;OAEG;IACH,IAAI,MAAM;QACT,OAAO,IAAI,CAAC,OAAO,CAAC;IACrB,CAAC;IAED;;;OAGG;IACH,IAAI,MAAM,CAAC,KAAa;QACvB,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;IACnC,CAAC;IAED;;;;OAIG;IACH,gBAAgB;QACf,IAAI,CAAC,IAAI,CAAC,eAAe;YAAE,OAAO;QAClC,KAAK,MAAM,MAAM,IAAI,IAAI,CAAC,eAAe,EAAE,CAAC;YAC3C,IAAI,CAAC,eAAe,CAAC,MAAM,CAAC,CAAC;QAC9B,CAAC;IACF,CAAC;CACD;AAED;;;;;;GAMG;AACH,MAAM,UAAU,yBAAyB,CACxC,OAAiB,EACjB,MAA6B;IAE7B,MAAM,UAAU,GAAG,IAAI,GAAG,EAA0B,CAAC;IAErD,wBAAwB;IACxB,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC9B,UAAU,CAAC,GAAG,CAAC,MAAM,EAAE,IAAI,cAAc,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IAC5D,CAAC;IAED,2CAA2C;IAC3C,MAAM,cAAc,GAAG,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,MAAM,EAAE,CAAC,CAAC;IACvD,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,cAAc,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QAChD,MAAM,UAAU,GAAG,cAAc,CAAC,CAAC,CAAC,CAAC;QACrC,IAAI,CAAC,UAAU;YAAE,SAAS;QAC1B,KAAK,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,cAAc,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YACpD,MAAM,UAAU,GAAG,cAAc,CAAC,CAAC,CAAC,CAAC;YACrC,IAAI,CAAC,UAAU;gBAAE,SAAS;YAC1B,cAAc,CAAC,IAAI,CAAC,UAAU,EAAE,UAAU,CAAC,CAAC;QAC7C,CAAC;IACF,CAAC;IAED,OAAO,UAAU,CAAC;AACnB,CAAC"}

package/dist/transport/transforming.d.ts

@@ -0,0 +1,177 @@
+/**
+ * TransformingTransport - Wraps a transport with compression and segmentation.
+ *
+ * Provides transparent compression (using pako/gzip) and segmentation for large
+ * messages that exceed WebRTC DataChannel limits (~16KB).
+ */
+import type { ConnectionMetrics, TransportAdapter } from "./adapter.js";
+/**
+ * Configuration for TransformingTransport.
+ */
+export interface TransformingTransportConfig {
+    /**
+     * Compression mode:
+     * - 'auto': Compress if result is smaller than original (default)
+     * - 'always': Always compress
+     * - 'never': Never compress
+     * @default 'auto'
+     */
+    compression: "auto" | "always" | "never";
+    /**
+     * Minimum message size in bytes before compression is attempted.
+     * Messages smaller than this are sent raw.
+     * @default 128
+     */
+    compressionThreshold: number;
+    /**
+     * Whether to segment large messages.
+     * @default true
+     */
+    segmentation: boolean;
+    /**
+     * Maximum size of each segment in bytes (including headers).
+     * WebRTC DataChannels typically have ~16KB limit.
+     * @default 16000
+     */
+    maxSegmentSize: number;
+    /**
+     * Timeout in milliseconds for reassembling segmented messages.
+     * Incomplete messages are discarded after this timeout.
+     * @default 5000
+     */
+    reassemblyTimeout: number;
+}
+/**
+ * Default configuration for TransformingTransport.
+ */
+export declare const DEFAULT_TRANSFORMING_TRANSPORT_CONFIG: TransformingTransportConfig;
+/**
+ * Wraps a transport with transparent compression and segmentation.
+ *
+ * Send path: compress -> segment -> send via inner transport
+ * Receive path: reassemble -> decompress -> deliver to callback
+ */
+export declare class TransformingTransport implements TransportAdapter {
+    onMessage: ((peerId: string, message: Uint8Array) => void) | null;
+    onConnect: ((peerId: string) => void) | null;
+    onDisconnect: ((peerId: string) => void) | null;
+    onError: ((peerId: string | null, error: Error, context: string) => void) | null;
+    private readonly inner;
+    private readonly config;
+    /** Per-peer message ID counters for outgoing messages */
+    private readonly messageIdCounters;
+    /** Per-peer reassembly buffers for incoming messages */
+    private readonly reassemblyBuffers;
+    /** Timer ID for periodic cleanup */
+    private cleanupTimerId;
+    /**
+     * Create a new TransformingTransport.
+     *
+     * @param inner - The underlying transport to wrap
+     * @param config - Optional configuration (uses defaults for missing values)
+     */
+    constructor(inner: TransportAdapter, config?: Partial<TransformingTransportConfig>);
+    /**
+     * Get the set of connected peer IDs.
+     */
+    get connectedPeers(): ReadonlySet<string>;
+    /**
+     * Get the local peer's ID.
+     */
+    get localPeerId(): string;
+    /**
+     * Connect to a peer.
+     */
+    connect(peerId: string): Promise<void>;
+    /**
+     * Disconnect from a peer.
+     */
+    disconnect(peerId: string): void;
+    /**
+     * Disconnect from all peers.
+     */
+    disconnectAll(): void;
+    /**
+     * Send a message to a specific peer.
+     * Applies compression and segmentation as configured.
+     */
+    send(peerId: string, message: Uint8Array, reliable: boolean): void;
+    /**
+     * Broadcast a message to all connected peers.
+     * Each peer receives independently segmented messages with unique message IDs.
+     */
+    broadcast(message: Uint8Array, reliable: boolean): void;
+    /**
+     * Get connection quality metrics for a peer.
+     */
+    getConnectionMetrics?(peerId: string): ConnectionMetrics | null;
+    /**
+     * Stop the cleanup timer and dispose of the inner transport.
+     * Call this when disposing of the transport.
+     */
+    dispose(): void;
+    /**
+     * Apply compression to outgoing message data.
+     * Returns data with a 1-byte compression header.
+     */
+    private transformOutgoing;
+    /**
+     * Add compression header to message data.
+     */
+    private addCompressionHeader;
+    /**
+     * Segment a transformed message for sending.
+     * Returns an array of segments, each with an 8-byte header.
+     */
+    private segmentMessage;
+    /**
+     * Create a segment with auto-generated message ID.
+     */
+    private createSegment;
+    /**
+     * Create a segment with a specific message ID.
+     */
+    private createSegmentWithId;
+    /**
+     * Get the next message ID for a peer.
+     *
+     * Note: Wraps at 2^32 (~4 billion). Collisions after wrap-around are handled by:
+     * 1. The total-mismatch check in bufferSegment() (rejects segments with wrong total)
+     * 2. The reassembly timeout cleanup (removes stale entries after 5s)
+     * 3. Practical impossibility: at 60 msg/sec, wrap-around takes ~2.2 years
+     */
+    private getNextMessageId;
+    /**
+     * Handle an incoming message from the inner transport.
+     */
+    private handleIncomingMessage;
+    /**
+     * Buffer a segment and attempt reassembly.
+     */
+    private bufferSegment;
+    /**
+     * Reassemble a complete message from segments.
+     */
+    private reassembleMessage;
+    /**
+     * Decompress and deliver a reassembled message.
+     */
+    private deliverMessage;
+    /**
+     * Clean up state for a disconnected peer.
+     */
+    private cleanupPeerState;
+    /**
+     * Start the periodic cleanup timer.
+     */
+    private startCleanupTimer;
+    /**
+     * Stop the cleanup timer.
+     */
+    private stopCleanupTimer;
+    /**
+     * Remove incomplete messages that have timed out.
+     */
+    private cleanupTimedOutMessages;
+}
+//# sourceMappingURL=transforming.d.ts.map

package/dist/transport/transforming.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transforming.d.ts","sourceRoot":"","sources":["../../src/transport/transforming.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAExE;;GAEG;AACH,MAAM,WAAW,2BAA2B;IAC3C;;;;;;OAMG;IACH,WAAW,EAAE,MAAM,GAAG,QAAQ,GAAG,OAAO,CAAC;IAEzC;;;;OAIG;IACH,oBAAoB,EAAE,MAAM,CAAC;IAE7B;;;OAGG;IACH,YAAY,EAAE,OAAO,CAAC;IAEtB;;;;OAIG;IACH,cAAc,EAAE,MAAM,CAAC;IAEvB;;;;OAIG;IACH,iBAAiB,EAAE,MAAM,CAAC;CAC1B;AAED;;GAEG;AACH,eAAO,MAAM,qCAAqC,EAAE,2BAOlD,CAAC;AAuCH;;;;;GAKG;AACH,qBAAa,qBAAsB,YAAW,gBAAgB;IACtD,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,UAAU,KAAK,IAAI,CAAC,GAAG,IAAI,CAClE;IACC,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC,GAAG,IAAI,CAAQ;IACpD,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC,GAAG,IAAI,CAAQ;IACvD,OAAO,EACX,CAAC,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC,GAChE,IAAI,CAAQ;IAEf,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAmB;IACzC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA8B;IAErD,yDAAyD;IACzD,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAkC;IAEpE,wDAAwD;IACxD,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CACvB;IAEX,oCAAoC;IACpC,OAAO,CAAC,cAAc,CAA+C;IAErE;;;;;OAKG;gBAEF,KAAK,EAAE,gBAAgB,EACvB,MAAM,CAAC,EAAE,OAAO,CAAC,2BAA2B,CAAC;IAiC9C;;OAEG;IACH,IAAI,cAAc,IAAI,WAAW,CAAC,MAAM,CAAC,CAExC;IAED;;OAEG;IACH,IAAI,WAAW,IAAI,MAAM,CAExB;IAED;;OAEG;IACG,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAI5C;;OAEG;IACH,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAKhC;;OAEG;IACH,aAAa,IAAI,IAAI;IAOrB;;;OAGG;IACH,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,OAAO,GAAG,IAAI;IASlE;;;OAGG;IACH,SAAS,CAAC,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,OAAO,GAAG,IAAI;IAWvD;;OAEG;IACH,oBAAoB,CAAC,CAAC,MAAM,EAAE,MAAM,GAAG,iBAAiB,GAAG,IAAI;IAI/D;;;OAGG;IACH,OAAO,IAAI,IAAI;IAQf;;;OAGG;IACH,OAAO,CAAC,iBAAiB;IA2BzB;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAU5B;;;OAGG;IACH,OAAO,CAAC,cAAc;IA2BtB;;OAEG;IACH,OAAO,CAAC,aAAa;IAUrB;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAoB3B;;;;;;;OAOG;IACH,OAAO,CAAC,gBAAgB;IAOxB;;OAEG;IACH,OAAO,CAAC,qBAAqB;IA8B7B;;OAEG;IACH,OAAO,CAAC,aAAa;IAsDrB;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAsBzB;;OAEG;IACH,OAAO,CAAC,cAAc;IA0BtB;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAKxB;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAYzB;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAOxB;;OAEG;IACH,OAAO,CAAC,uBAAuB;CAgB/B"}