@woosh/meep-engine 2.169.0 → 2.169.2

package/src/engine/network/transport/Transport.js

@@ -28,6 +28,26 @@ import Signal from "../../../core/events/signal/Signal.js";
  */
 export class Transport {
 
+    /**
+     * Byte and packet counters, maintained through {@link count_in} and
+     * {@link count_out} so that every adapter reports the same four numbers
+     * with the same meaning. Lives here rather than in each adapter because
+     * six adapters previously declared this object and copied it out field by
+     * field in six identical `getStats()` bodies.
+     *
+     * @type {{bytes_in: number, bytes_out: number, packets_in: number, packets_out: number}}
+     */
+    #stats = { bytes_in: 0, bytes_out: 0, packets_in: 0, packets_out: 0 };
+
+    /**
+     * Set once a disconnect has been reported, or once a local teardown has
+     * decided that the transport's own imminent close notification is not
+     * news. See {@link fire_disconnect_once} and {@link latch_disconnect}.
+     *
+     * @type {boolean}
+     */
+    #disconnect_fired = false;
+
     /**
      * Whether this transport guarantees delivery of every packet sent.
      * `true` for TCP-style (WebSocket, WebTransport streams);
@@ -102,12 +122,76 @@ export class Transport {
     }
 
     /**
-     * Read-only stats snapshot. Default returns zeroes; subclasses are expected
-     * to track their own counters.
+     * Record one inbound packet of `byte_count` bytes. Subclasses call this
+     * from wherever they surface bytes on `onReceive`.
+     *
+     * @param {number} byte_count
+     * @protected
+     */
+    count_in(byte_count) {
+        this.#stats.bytes_in += byte_count;
+        this.#stats.packets_in += 1;
+    }
+
+    /**
+     * Record one outbound packet of `byte_count` bytes. Subclasses call this
+     * from `send`.
+     *
+     * @param {number} byte_count
+     * @protected
+     */
+    count_out(byte_count) {
+        this.#stats.bytes_out += byte_count;
+        this.#stats.packets_out += 1;
+    }
+
+    /**
+     * Read-only stats snapshot. Copied out so callers cannot mutate the live
+     * counters.
+     *
      * @returns {{bytes_in: number, bytes_out: number, packets_in: number, packets_out: number}}
      */
     getStats() {
-        return { bytes_in: 0, bytes_out: 0, packets_in: 0, packets_out: 0 };
+        return {
+            bytes_in: this.#stats.bytes_in,
+            bytes_out: this.#stats.bytes_out,
+            packets_in: this.#stats.packets_in,
+            packets_out: this.#stats.packets_out,
+        };
+    }
+
+    /**
+     * Report a lost connection through `onDisconnect`, at most once for the
+     * lifetime of this transport.
+     *
+     * Underlying APIs are not disciplined about this: an `RTCDataChannel` may
+     * raise `error` and then `close` for one failure, a dgram socket the same,
+     * and a WebSocket sometimes both. Subscribers run the reconnect ladder, so
+     * a duplicate is not a cosmetic problem.
+     *
+     * @param {string} reason implementation-specific, for diagnostics
+     * @protected
+     */
+    fire_disconnect_once(reason) {
+        if (this.#disconnect_fired) {
+            return;
+        }
+
+        this.#disconnect_fired = true;
+
+        this.onDisconnect.send1(reason);
+    }
+
+    /**
+     * Suppress any future {@link fire_disconnect_once}. Called from `disconnect()`
+     * by adapters whose underlying object raises a close event of its own on
+     * the way down: a caller who explicitly tore the transport down does not
+     * expect to be notified that it went away.
+     *
+     * @protected
+     */
+    latch_disconnect() {
+        this.#disconnect_fired = true;
     }
 }
 

package/src/engine/network/transport/adapters/NodeUDPTransport.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"NodeUDPTransport.d.ts","sourceRoot":"","sources":["../../../../../../src/engine/network/transport/adapters/NodeUDPTransport.js"],"names":[],"mappings":"AAIA;;;;;;;;;;;;;;;GAeG;AACH;IASI;;;;;;OAMG;IACH,kDANW;QACV,YAAgB,CAAC,EAAE,MAAM,CAAC;QAC1B,SAAa,CAAC,EAAE,MAAM,CAAC;QACvB,MAAU,CAAC,EAAE;YAAE,OAAO,EAAE,MAAM,CAAC;YAAC,IAAI,EAAE,MAAM,CAAA;SAAE,CAAC;KAC5C,EAkEH;IA3DG,0CAA0C;IAC1C,QADW,OAAO,YAAY,EAAE,MAAM,CACJ;IA4DtC;;;;OAIG;IACH,oBAHW,MAAM,QACN,MAAM,QAMhB;IAED;;;;OAIG;IACH,qBAFa;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAC,GAAC,IAAI,CAQhD;IAmBD;;;;;OAKG;IACH,WAFa,QAAQ,IAAI,CAAC,CA0BzB;;CAsCJ;0BAjNyB,iBAAiB"}
+{"version":3,"file":"NodeUDPTransport.d.ts","sourceRoot":"","sources":["../../../../../../src/engine/network/transport/adapters/NodeUDPTransport.js"],"names":[],"mappings":"AAIA;;;;;;;;;;;;;;;GAeG;AACH;IAOI;;;;;;OAMG;IACH,kDANW;QACV,YAAgB,CAAC,EAAE,MAAM,CAAC;QAC1B,SAAa,CAAC,EAAE,MAAM,CAAC;QACvB,MAAU,CAAC,EAAE;YAAE,OAAO,EAAE,MAAM,CAAC;YAAC,IAAI,EAAE,MAAM,CAAA;SAAE,CAAC;KAC5C,EAuDH;IAhDG,0CAA0C;IAC1C,QADW,OAAO,YAAY,EAAE,MAAM,CACJ;IAiDtC;;;;OAIG;IACH,oBAHW,MAAM,QACN,MAAM,QAMhB;IAED;;;;OAIG;IACH,qBAFa;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAC,GAAC,IAAI,CAQhD;IAkBD;;;;;OAKG;IACH,WAFa,QAAQ,IAAI,CAAC,CA0BzB;;CA0BJ;0BAvLyB,iBAAiB"}

package/src/engine/network/transport/adapters/NodeUDPTransport.js

@@ -20,11 +20,9 @@ import { Transport } from "../Transport.js";
  */
 export class NodeUDPTransport extends Transport {
     #remote;
-    #stats;
     #on_message;
     #on_close;
     #on_socket_error;
-    #disconnect_fired;
 
 
     /**
@@ -50,14 +48,8 @@ export class NodeUDPTransport extends Transport {
          */
         this.#remote = remote;
 
-        /** @private */
-        this.#stats = { bytes_in: 0, bytes_out: 0, packets_in: 0, packets_out: 0 };
-
         // A socket-level error and a subsequent close are the same failure to
-        // higher layers — fire `onDisconnect` once.
-        /** @private */
-        this.#disconnect_fired = false;
-
+        // higher layers; the base's latch fires `onDisconnect` once.
         /** @private */
         this.#on_message = (msg, rinfo) => {
             // If we don't have a remote yet, latch onto the first sender (server
@@ -70,24 +62,19 @@ export class NodeUDPTransport extends Transport {
             if (this.#remote === null) {
                 this.#remote = { address: rinfo.address, port: rinfo.port };
             }
-            this.#stats.bytes_in += msg.length;
-            this.#stats.packets_in += 1;
+            this.count_in(msg.length);
             // Buffer extends Uint8Array; safe to pass directly.
             this.onReceive.send2(msg, msg.length);
         };
 
         /** @private */
         this.#on_close = () => {
-            if (this.#disconnect_fired) return;
-            this.#disconnect_fired = true;
-            this.onDisconnect.send1('socket_closed');
+            this.fire_disconnect_once('socket_closed');
         };
 
         /** @private */
         this.#on_socket_error = (err) => {
-            if (this.#disconnect_fired) return;
-            this.#disconnect_fired = true;
-            this.onDisconnect.send1(err && err.message ? err.message : 'socket_error');
+            this.fire_disconnect_once(err && err.message ? err.message : 'socket_error');
         };
 
         this.socket.on('message', this.#on_message);
@@ -137,8 +124,7 @@ export class NodeUDPTransport extends Transport {
         // dgram.send accepts a typed array; subarray to bound the length.
         const payload = (length === bytes.byteLength) ? bytes : bytes.subarray(0, length);
         this.socket.send(payload, this.#remote.port, this.#remote.address);
-        this.#stats.bytes_out += length;
-        this.#stats.packets_out += 1;
+        this.count_out(length);
     }
 
     /**
@@ -165,7 +151,7 @@ export class NodeUDPTransport extends Transport {
                 this.socket.off('listening', on_listening);
                 // Latch so the persistent runtime handler doesn't also
                 // fire `onDisconnect` for the same bind failure.
-                this.#disconnect_fired = true;
+                this.latch_disconnect();
                 reject(err);
             };
             this.socket.once('listening', on_listening);
@@ -181,7 +167,7 @@ export class NodeUDPTransport extends Transport {
      * who explicitly tore down the transport. Suppressed via the latch.
      */
     disconnect() {
-        this.#disconnect_fired = true;
+        this.latch_disconnect();
         try {
             this.socket.off('message', this.#on_message);
             this.socket.off('close', this.#on_close);
@@ -192,18 +178,6 @@ export class NodeUDPTransport extends Transport {
         }
     }
 
-    /**
-     * @returns {{bytes_in: number, bytes_out: number, packets_in: number, packets_out: number}}
-     */
-    getStats() {
-        return {
-            bytes_in: this.#stats.bytes_in,
-            bytes_out: this.#stats.bytes_out,
-            packets_in: this.#stats.packets_in,
-            packets_out: this.#stats.packets_out,
-        };
-    }
-
     /** @private */
     #try_bound() {
         try { this.socket.address(); return true; }

package/src/engine/network/transport/adapters/SimulatedTransport.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"SimulatedTransport.d.ts","sourceRoot":"","sources":["../../../../../../src/engine/network/transport/adapters/SimulatedTransport.js"],"names":[],"mappings":"AAIA;;;;;;;;;;;;;;;;;;;GAmBG;AACH;IA0FI;;;;;OAKG;IACH,oBAHW,kBAAkB,KAClB,kBAAkB,QAO5B;IA/FD;;;;;;;;;;;;;;OAcG;IACH,sEAdW;QACV,UAAc,CAAC,EAAE,MAAM,CAAC;QACxB,SAAa,CAAC,EAAE,MAAM,CAAC;QACvB,QAAY,CAAC,EAAE,MAAM,CAAC;QACtB,KAAS,CAAC,QAAc,MAAM,CAAC;KAC5B,EA4EH;IAtDG;;;OAGG;IACH,MAFU,kBAAkB,GAAC,IAAI,CAEjB;IAEhB;;;;OAIG;IACH,UAFU;QAAC,aAAa,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,UAAU,CAAA;KAAC,EAAE,CAEpC;IAElB;;;OAGG;IACH;;;;MAAiD;IA8BjD;;;;;OAKG;IACH,aAFsB,MAAM,CAEV;IAyDtB;;;;;;OAMG;IACH,aAHW,MAAM,GACJ,MAAM,CAclB;IAED;;;OAGG;IACH,gBAFa,MAAM,CAIlB;IAED;;;OAGG;IACH,iBAFa,MAAM,CAIlB;IAED;;;;;;;OAOG;IACH,mBAFW,MAAM,QAKhB;;CAmCJ;0BAzPyB,iBAAiB"}
+{"version":3,"file":"SimulatedTransport.d.ts","sourceRoot":"","sources":["../../../../../../src/engine/network/transport/adapters/SimulatedTransport.js"],"names":[],"mappings":"AAIA;;;;;;;;;;;;;;;;;;;GAmBG;AACH;IAwFI;;;;;OAKG;IACH,oBAHW,kBAAkB,KAClB,kBAAkB,QAO5B;IA7FD;;;;;;;;;;;;;;OAcG;IACH,sEAdW;QACV,UAAc,CAAC,EAAE,MAAM,CAAC;QACxB,SAAa,CAAC,EAAE,MAAM,CAAC;QACvB,QAAY,CAAC,EAAE,MAAM,CAAC;QACtB,KAAS,CAAC,QAAc,MAAM,CAAC;KAC5B,EA0EH;IApDG;;;OAGG;IACH,MAFU,kBAAkB,GAAC,IAAI,CAEjB;IAEhB;;;;OAIG;IACH,UAFU;QAAC,aAAa,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,UAAU,CAAA;KAAC,EAAE,CAEpC;IAElB;;;OAGG;IACH;;;;MAAiD;IA4BjD;;;;;OAKG;IACH,aAFsB,MAAM,CAEV;IAwDtB;;;;;;OAMG;IACH,aAHW,MAAM,GACJ,MAAM,CAalB;IAED;;;OAGG;IACH,gBAFa,MAAM,CAIlB;IAED;;;OAGG;IACH,iBAFa,MAAM,CAIlB;IAED;;;;;;;OAOG;IACH,mBAFW,MAAM,QAKhB;;CA4BJ;0BA9OyB,iBAAiB"}

package/src/engine/network/transport/adapters/SimulatedTransport.js

@@ -23,7 +23,7 @@ import { Transport } from "../Transport.js";
  * @copyright Company Named Limited (c) 2026
  */
 export class SimulatedTransport extends Transport {
-    #stats;
+    #packets_dropped;
     #forced_drops_remaining;
     #random;
 
@@ -76,15 +76,13 @@ export class SimulatedTransport extends Transport {
         this.config = { latency_ms, jitter_ms, loss_pct };
 
         /**
-         * Stats. Includes `packets_dropped` (a SimulatedTransport-specific count
-         * not in the base `getStats()` shape).
-         * @private
+         * Packets discarded to simulated loss. Specific to this adapter --
+         * the base's four counters have no notion of a link that eats
+         * packets on purpose, and `getStats()` deliberately does not
+         * surface it (see {@link dropped_count}).
+         * @private @type {number}
          */
-        this.#stats = {
-            bytes_in: 0, bytes_out: 0,
-            packets_in: 0, packets_out: 0,
-            packets_dropped: 0,
-        };
+        this.#packets_dropped = 0;
 
         /**
          * Counter for deterministic forced losses scheduled by {@link force_drop_next}.
@@ -132,8 +130,7 @@ export class SimulatedTransport extends Transport {
     send(bytes, length) {
         assert.isNonNegativeInteger(length, 'length');
 
-        this.#stats.bytes_out += length;
-        this.#stats.packets_out += 1;
+        this.count_out(length);
 
         if (this.peer === null) return;
 
@@ -141,12 +138,12 @@ export class SimulatedTransport extends Transport {
         // loss burst — useful for demos and reproducible repros.
         if (this.#forced_drops_remaining > 0) {
             this.#forced_drops_remaining--;
-            this.#stats.packets_dropped += 1;
+            this.#packets_dropped += 1;
             return;
         }
 
         if (this.#random() * 100 < this.config.loss_pct) {
-            this.#stats.packets_dropped += 1;
+            this.#packets_dropped += 1;
             return;
         }
 
@@ -179,8 +176,7 @@ export class SimulatedTransport extends Transport {
         const q = this.in_queue;
         while (q.length > 0 && q[0].deliver_at_ms <= now_ms) {
             const e = q.shift();
-            this.#stats.bytes_in += e.bytes.length;
-            this.#stats.packets_in += 1;
+            this.count_in(e.bytes.length);
             this.onReceive.send2(e.bytes, e.bytes.length);
             delivered++;
         }
@@ -200,7 +196,7 @@ export class SimulatedTransport extends Transport {
      * @returns {number}
      */
     dropped_count() {
-        return this.#stats.packets_dropped;
+        return this.#packets_dropped;
     }
 
     /**
@@ -224,6 +220,11 @@ export class SimulatedTransport extends Transport {
      * deterministically, and the formerly-paired peer is notified so its
      * own listeners observe the link drop. Symmetric whether the
      * disconnect originates here or on the peer.
+     *
+     * Like {@link LoopbackTransport#disconnect}, this dispatches directly
+     * rather than through the base's `fire_disconnect_once` latch: there is no
+     * underlying socket to echo a close back at us, so nothing to suppress,
+     * and the signal has to fire on every `disconnect()`.
      */
     disconnect() {
         this.in_queue.length = 0;
@@ -237,16 +238,4 @@ export class SimulatedTransport extends Transport {
         }
         this.onDisconnect.send1('local_disconnect');
     }
-
-    /**
-     * @returns {{bytes_in: number, bytes_out: number, packets_in: number, packets_out: number}}
-     */
-    getStats() {
-        return {
-            bytes_in: this.#stats.bytes_in,
-            bytes_out: this.#stats.bytes_out,
-            packets_in: this.#stats.packets_in,
-            packets_out: this.#stats.packets_out,
-        };
-    }
 }

package/src/engine/network/transport/adapters/WebRTCDataChannelTransport.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"WebRTCDataChannelTransport.d.ts","sourceRoot":"","sources":["../../../../../../src/engine/network/transport/adapters/WebRTCDataChannelTransport.js"],"names":[],"mappings":"AAGA;;;;;;;;;;;;;;;;;;;GAmBG;AACH;IAQI;;OAEG;IACH,8BAFW;QAAE,YAAY,EAAE,cAAc,CAAA;KAAE,EAgD1C;IA1CG,6BAA6B;IAC7B,cADW,cAAc,CACO;;CA2FvC;0BAjIyB,iBAAiB"}
+{"version":3,"file":"WebRTCDataChannelTransport.d.ts","sourceRoot":"","sources":["../../../../../../src/engine/network/transport/adapters/WebRTCDataChannelTransport.js"],"names":[],"mappings":"AAGA;;;;;;;;;;;;;;;;;;;GAmBG;AACH;IAMI;;OAEG;IACH,8BAFW;QAAE,YAAY,EAAE,cAAc,CAAA;KAAE,EAqC1C;IA/BG,6BAA6B;IAC7B,cADW,cAAc,CACO;;CAmEvC;0BAvGyB,iBAAiB"}

package/src/engine/network/transport/adapters/WebRTCDataChannelTransport.js

@@ -22,11 +22,9 @@ import { Transport } from "../Transport.js";
  * @copyright Company Named Limited (c) 2026
  */
 export class WebRTCDataChannelTransport extends Transport {
-    #stats;
     #on_message;
     #on_close;
     #on_error;
-    #disconnect_fired;
 
 
     /**
@@ -40,39 +38,28 @@ export class WebRTCDataChannelTransport extends Transport {
         this.data_channel = data_channel;
         this.data_channel.binaryType = 'arraybuffer';
 
-        /** @private */
-        this.#stats = { bytes_in: 0, bytes_out: 0, packets_in: 0, packets_out: 0 };
-
         // RTCDataChannel may fire 'close' and 'error' separately for the same
-        // failure (browsers vary). Latch on the first to avoid double-dispatch.
-        /** @private */
-        this.#disconnect_fired = false;
-
+        // failure (browsers vary); the base's latch dispatches only the first.
         /** @private */
         this.#on_message = (event) => {
             // event.data is an ArrayBuffer because we set binaryType above.
             const ab = event.data;
             const bytes = new Uint8Array(ab);
-            this.#stats.bytes_in += bytes.length;
-            this.#stats.packets_in += 1;
+            this.count_in(bytes.length);
             this.onReceive.send2(bytes, bytes.length);
         };
 
         /** @private */
         this.#on_close = () => {
-            if (this.#disconnect_fired) return;
-            this.#disconnect_fired = true;
-            this.onDisconnect.send1('channel_closed');
+            this.fire_disconnect_once('channel_closed');
         };
 
         /** @private */
         this.#on_error = (event) => {
-            if (this.#disconnect_fired) return;
-            this.#disconnect_fired = true;
             const reason = event && event.error && event.error.message
                 ? event.error.message
                 : 'channel_error';
-            this.onDisconnect.send1(reason);
+            this.fire_disconnect_once(reason);
         };
 
         this.data_channel.addEventListener('message', this.#on_message);
@@ -94,8 +81,7 @@ export class WebRTCDataChannelTransport extends Transport {
             : bytes.subarray(0, length);
         // .send accepts ArrayBufferView; pass the typed array directly.
         this.data_channel.send(payload);
-        this.#stats.bytes_out += length;
-        this.#stats.packets_out += 1;
+        this.count_out(length);
     }
 
     /**
@@ -106,7 +92,7 @@ export class WebRTCDataChannelTransport extends Transport {
      * disconnect don't expect a notification echo.
      */
     disconnect() {
-        this.#disconnect_fired = true;
+        this.latch_disconnect();
         this.data_channel.removeEventListener('message', this.#on_message);
         this.data_channel.removeEventListener('close', this.#on_close);
         this.data_channel.removeEventListener('error', this.#on_error);
@@ -116,16 +102,4 @@ export class WebRTCDataChannelTransport extends Transport {
             // Channel may already be closed; ignore.
         }
     }
-
-    /**
-     * @returns {{bytes_in: number, bytes_out: number, packets_in: number, packets_out: number}}
-     */
-    getStats() {
-        return {
-            bytes_in: this.#stats.bytes_in,
-            bytes_out: this.#stats.bytes_out,
-            packets_in: this.#stats.packets_in,
-            packets_out: this.#stats.packets_out,
-        };
-    }
 }

package/src/engine/network/transport/adapters/WebSocketTransport.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"WebSocketTransport.d.ts","sourceRoot":"","sources":["../../../../../../src/engine/network/transport/adapters/WebSocketTransport.js"],"names":[],"mappings":"AAGA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH;IAOI;;OAEG;IACH,8BAFW;QAAE,MAAM,CAAC,EAAE,SAAS,CAAC;QAAC,GAAG,CAAC,EAAE,MAAM,CAAA;KAAE,EA8D9C;IAjDG,wBAAwB;IACxB,QADW,SAAS,CAC4C;IA+DpE;;;;;;;;;;OAUG;IACH,WAFa,QAAQ,IAAI,CAAC,CA4BzB;;CA+BJ;0BAlLyB,iBAAiB"}
+{"version":3,"file":"WebSocketTransport.d.ts","sourceRoot":"","sources":["../../../../../../src/engine/network/transport/adapters/WebSocketTransport.js"],"names":[],"mappings":"AAGA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH;IAKI;;OAEG;IACH,8BAFW;QAAE,MAAM,CAAC,EAAE,SAAS,CAAC;QAAC,GAAG,CAAC,EAAE,MAAM,CAAA;KAAE,EAmD9C;IAtCG,wBAAwB;IACxB,QADW,SAAS,CAC4C;IAmDpE;;;;;;;;;;OAUG;IACH,WAFa,QAAQ,IAAI,CAAC,CA4BzB;;CAmBJ;0BAxJyB,iBAAiB"}

package/src/engine/network/transport/adapters/WebSocketTransport.js

@@ -25,10 +25,8 @@ import { Transport } from "../Transport.js";
  * @copyright Company Named Limited (c) 2026
  */
 export class WebSocketTransport extends Transport {
-    #stats;
     #on_message;
     #on_close;
-    #disconnect_fired;
 
 
     /**
@@ -52,14 +50,6 @@ export class WebSocketTransport extends Transport {
 
         this.socket.binaryType = 'arraybuffer';
 
-        /** @private */
-        this.#stats = { bytes_in: 0, bytes_out: 0, packets_in: 0, packets_out: 0 };
-
-        // Latch so that local disconnect() and the subsequent socket
-        // 'close' event don't both fire `onDisconnect`.
-        /** @private */
-        this.#disconnect_fired = false;
-
         /** @private */
         this.#on_message = (event) => {
             // event.data is ArrayBuffer (binaryType set above) for binary frames,
@@ -73,8 +63,7 @@ export class WebSocketTransport extends Transport {
                 // Some browsers wrap as Blob if binaryType is misset; ignore.
                 return;
             }
-            this.#stats.bytes_in += bytes.length;
-            this.#stats.packets_in += 1;
+            this.count_in(bytes.length);
             this.onReceive.send2(bytes, bytes.length);
         };
 
@@ -82,14 +71,12 @@ export class WebSocketTransport extends Transport {
         // layers (e.g. `NetworkSession`'s reconnect ladder) can react.
         // `'close'` covers both clean and abrupt closures; some
         // implementations fire `'error'` first and then `'close'`, so we
-        // only fire ours on close. The latch additionally suppresses the
-        // echo when callers locally disconnect.
+        // only fire ours on close. The base's latch additionally suppresses
+        // the echo when callers locally disconnect.
         /** @private */
         this.#on_close = (ev) => {
-            if (this.#disconnect_fired) return;
-            this.#disconnect_fired = true;
             const reason = ev && ev.reason ? ev.reason : `code:${ev && ev.code}`;
-            this.onDisconnect.send1(reason);
+            this.fire_disconnect_once(reason);
         };
 
         this.socket.addEventListener('message', this.#on_message);
@@ -105,8 +92,7 @@ export class WebSocketTransport extends Transport {
         if (length === 0) return;
         const payload = (length === bytes.byteLength) ? bytes : bytes.subarray(0, length);
         this.socket.send(payload);
-        this.#stats.bytes_out += length;
-        this.#stats.packets_out += 1;
+        this.count_out(length);
     }
 
     /**
@@ -156,7 +142,7 @@ export class WebSocketTransport extends Transport {
      * explicitly tore down don't expect a notification echo.
      */
     disconnect() {
-        this.#disconnect_fired = true;
+        this.latch_disconnect();
         try {
             this.socket.removeEventListener('message', this.#on_message);
             this.socket.removeEventListener('close', this.#on_close);
@@ -165,16 +151,4 @@ export class WebSocketTransport extends Transport {
             // Already closed; ignore.
         }
     }
-
-    /**
-     * @returns {{bytes_in: number, bytes_out: number, packets_in: number, packets_out: number}}
-     */
-    getStats() {
-        return {
-            bytes_in: this.#stats.bytes_in,
-            bytes_out: this.#stats.bytes_out,
-            packets_in: this.#stats.packets_in,
-            packets_out: this.#stats.packets_out,
-        };
-    }
 }

package/src/engine/network/transport/adapters/WebTransportTransport.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"WebTransportTransport.d.ts","sourceRoot":"","sources":["../../../../../../src/engine/network/transport/adapters/WebTransportTransport.js"],"names":[],"mappings":"AAIA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH;IAOI;;OAEG;IACH,mCAFW;QAAE,EAAE,CAAC,EAAE,MAAM,CAAC;QAAC,GAAG,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,EAsDzD;IAvCG;;;;;OAKG;IACH,IAFU,MAAM,CAEgD;IAiBhE;;;;;;;;;;;;;;OAcG;IACH,eAFU,MAAM,CAEiB;IAGrC;;;;;OAKG;IACH,WAFa,QAAQ,IAAI,CAAC,CASzB;;CAmGJ;0BA/MyB,iBAAiB;mBADxB,0CAA0C"}
+{"version":3,"file":"WebTransportTransport.d.ts","sourceRoot":"","sources":["../../../../../../src/engine/network/transport/adapters/WebTransportTransport.js"],"names":[],"mappings":"AAIA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH;IAMI;;OAEG;IACH,mCAFW;QAAE,EAAE,CAAC,EAAE,MAAM,CAAC;QAAC,GAAG,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,EAmDzD;IApCG;;;;;OAKG;IACH,IAFU,MAAM,CAEgD;IAchE;;;;;;;;;;;;;;OAcG;IACH,eAFU,MAAM,CAEiB;IAGrC;;;;;OAKG;IACH,WAFa,QAAQ,IAAI,CAAC,CASzB;;CA4FJ;0BApMyB,iBAAiB;mBADxB,0CAA0C"}

package/src/engine/network/transport/adapters/WebTransportTransport.js

@@ -32,7 +32,6 @@ import { Transport } from "../Transport.js";
  * @copyright Company Named Limited (c) 2026
  */
 export class WebTransportTransport extends Transport {
-    #stats;
     #writer;
     #reader;
     #read_loop_running;
@@ -65,9 +64,6 @@ export class WebTransportTransport extends Transport {
         assert.ok(this.wt.datagrams !== undefined,
             'WebTransport instance must expose .datagrams (browser support / version)');
 
-        /** @private */
-        this.#stats = { bytes_in: 0, bytes_out: 0, packets_in: 0, packets_out: 0 };
-
         /** @private */
         this.#writer = null;
         /** @private */
@@ -136,14 +132,20 @@ export class WebTransportTransport extends Transport {
             const reason = err && err.message ? err.message : 'write_rejected';
             this.onSendDropped.send1(reason);
         });
-        this.#stats.bytes_out += length;
-        this.#stats.packets_out += 1;
+        this.count_out(length);
     }
 
     /**
      * Cancel the read loop and close the WebTransport.
+     *
+     * Locally-initiated disconnect: `wt.closed` settles as a result of the
+     * close below, and without the latch that settlement would report the
+     * teardown back to the caller who asked for it -- kicking the reconnect
+     * ladder over a link nobody lost. The other adapters have always latched
+     * here; this one is brought in line.
      */
     disconnect() {
+        this.latch_disconnect();
         if (this.#reader !== null) {
             try { this.#reader.cancel(); } catch (_) { /* swallow */ }
             this.#reader = null;
@@ -155,18 +157,6 @@ export class WebTransportTransport extends Transport {
         try { this.wt.close(); } catch (_) { /* swallow */ }
     }
 
-    /**
-     * @returns {{bytes_in: number, bytes_out: number, packets_in: number, packets_out: number}}
-     */
-    getStats() {
-        return {
-            bytes_in: this.#stats.bytes_in,
-            bytes_out: this.#stats.bytes_out,
-            packets_in: this.#stats.packets_in,
-            packets_out: this.#stats.packets_out,
-        };
-    }
-
     /** @private */
     #start_read_loop() {
         if (this.#read_loop_running) return;
@@ -177,8 +167,7 @@ export class WebTransportTransport extends Transport {
                     const { value, done } = await this.#reader.read();
                     if (done) break;
                     if (!(value instanceof Uint8Array)) continue;
-                    this.#stats.bytes_in += value.length;
-                    this.#stats.packets_in += 1;
+                    this.count_in(value.length);
                     this.onReceive.send2(value, value.length);
                 }
             } catch (_) {
@@ -200,11 +189,11 @@ export class WebTransportTransport extends Transport {
         this.wt.closed
             .then((info) => {
                 const reason = (info && info.reason) ? info.reason : 'closed';
-                this.onDisconnect.send1(reason);
+                this.fire_disconnect_once(reason);
             })
             .catch((err) => {
                 const reason = err && err.message ? err.message : 'errored';
-                this.onDisconnect.send1(reason);
+                this.fire_disconnect_once(reason);
             });
     }
 }

package/src/engine/physics/constraint/solve_constraints.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"solve_constraints.d.ts","sourceRoot":"","sources":["../../../../../src/engine/physics/constraint/solve_constraints.js"],"names":[],"mappings":"AA6UA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,sCANW,MAAM,MACN,MAAM,MACN,MAAM,MACN,MAAM,OACN,YAAY,QAkCtB;AAuKD;;;;;;;;;;;;;;;;GAgBG;AACH,qCATW,OAAO,iCAEP,MAAM,SAEN,MAAM,YACN,OAAO,QAuSjB"}
+{"version":3,"file":"solve_constraints.d.ts","sourceRoot":"","sources":["../../../../../src/engine/physics/constraint/solve_constraints.js"],"names":[],"mappings":"AA+SA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,sCANW,MAAM,MACN,MAAM,MACN,MAAM,MACN,MAAM,OACN,YAAY,QAkCtB;AAuKD;;;;;;;;;;;;;;;;GAgBG;AACH,qCATW,OAAO,iCAEP,MAAM,SAEN,MAAM,YACN,OAAO,QAuSjB"}