visaljs 0.0.8 → 0.0.10

package/node/prelude/net.js

@@ -9,15 +9,18 @@
 // Ported from Node.js (Copyright Node.js contributors, MIT): node/third_party/nodejs/LICENSE.
 import {
   errnoMessage, errnoName, netAddress, netBind, netCallback, netChmod, netClose, netConnect, netGuessHandle, netKeepAlive, netListen,
-  netNoDelay, netOpen, netOpenFd, netReadStart, netReadStop, netRef, netReset, netShutdown, netWrite, timerUnref,
+  loopNow, netFd, netNoDelay, netOpen, netOpenFd, netReadStart, netReadStop, netRef, netReset, netShutdown, netWrite, timerUnref,
 } from "visaljs:host";
-import { lookup } from "./dns.js";
+import { ADDRCONFIG, lookup } from "./dns.js";
 import { EventEmitter } from "./events.js";
 import { bindContext } from "./internal/async_context.js";
-import { codeError, invalidArgType, invalidArgValue, notSupported, outOfRange, validateFunction, validateString } from "./internal/errors.js";
+import { codeError, invalidArgType, invalidArgValue, outOfRange, validateFunction, validateString } from "./internal/errors.js";
 import { isIP, isIPv4, isIPv6 } from "./internal/net.js";
 import { BlockList, SocketAddress } from "./internal/socketaddress.js";
+import { AbortError } from "./internal/streams/errors.js";
+import { validateInt32 } from "./internal/streams/validators.js";
 import { Duplex } from "./stream.js";
+import { callableClass, feature, features, lazyClass, lazyFunction } from "./internal/features.js";
 
 export { BlockList, isIP, isIPv4, isIPv6, SocketAddress };
 
@@ -27,12 +30,6 @@ const UV_EOF = -4095;
 const UV_EINVAL = -22;
 const TIMEOUT_MAX = 2 ** 31 - 1;
 
-/* a monotonic clock in ms */
-const now = () => {
-  const [seconds, nanoseconds] = process.hrtime();
-  return seconds * 1e3 + nanoseconds / 1e6;
-};
-
 /* ---- Node's error shapes ------------------------------------------------------------------- */
 
 /** `read ECONNRESET` */
@@ -81,6 +78,9 @@ function validatePort(port, name = "Port", allowZero = true) {
   return +port;
 }
 
+/* for internal/net_bound.js (BoundSocket) */
+features.net = { errnoException, exceptionWithHostPort, validatePort };
+
 const toNumber = (x) => ((x = Number(x)) >= 0 ? x : false);
 const isPipeName = (s) => typeof s === "string" && toNumber(s) === false;
 
@@ -120,6 +120,7 @@ export function setDefaultAutoSelectFamilyAttemptTimeout(value) {
 
 /* a descriptor as a handle: Node's createHandle */
 function handleForFd(fd, cb) {
+  validateInt32(fd, "fd", 0);
   const type = netGuessHandle(fd);
   if (type !== "PIPE" && type !== "TCP") throw codeError(TypeError, "ERR_INVALID_FD_TYPE", "Unsupported fd type: " + type);
   return netOpen(type === "PIPE", bindContext(cb));
@@ -129,6 +130,14 @@ function validateBlockList(value, name) {
   if (value !== undefined && !BlockList.isBlockList(value)) throw invalidArgType(name, "an net.BlockList", value);
 }
 
+/* Node's ERR_INVALID_ADDRESS_FAMILY, with the host and port */
+function addressFamilyError(addressType, host, port) {
+  const err = codeError(RangeError, "ERR_INVALID_ADDRESS_FAMILY", "Invalid address family: " + addressType + " " + host + ":" + port);
+  err.host = host;
+  err.port = port;
+  return err;
+}
+
 const ipBlocked = (ip) => codeError(Error, "ERR_IP_BLOCKED", "IP(" + ip + ") is blocked by net.BlockList");
 
 /* ---- Socket -------------------------------------------------------------------------------- */
@@ -148,13 +157,30 @@ function writeAfterFIN(chunk, encoding, cb) {
   return false;
 }
 
-export class Socket extends Duplex {
+class SocketClass extends Duplex {
   constructor(options) {
     if (typeof options === "number") options = { fd: options };
     else options = { ...options };
+    if (options.objectMode) throw invalidArgValue("options.objectMode", "is not supported", options.objectMode);
+    if (options.readableObjectMode || options.writableObjectMode) {
+      const name = options.readableObjectMode ? "readableObjectMode" : "writableObjectMode";
+      throw invalidArgValue("options." + name, "is not supported", options[name]);
+    }
     /* Node's: not half-open by default, 'close' emitted by the socket itself, strings written as given */
     const allowHalfOpen = Boolean(options.allowHalfOpen);
-    super({ ...options, allowHalfOpen, emitClose: false, autoDestroy: true, decodeStrings: false });
+    super({ ...options, signal: undefined, allowHalfOpen, emitClose: false, autoDestroy: true, decodeStrings: false });
+    /* the signal option, as Node's socket has it: aborted, the socket is destroyed with an AbortError
+     * (one already aborted: on the next tick, once connect() has begun) */
+    if (options.signal !== undefined) {
+      const signal = options.signal;
+      if (signal === null || typeof signal !== "object" || !("aborted" in signal)) throw invalidArgType("options.signal", "an instance of AbortSignal", signal);
+      const onAbort = () => this.destroy(new AbortError(undefined, { cause: signal.reason }));
+      if (signal.aborted) process.nextTick(onAbort);
+      else {
+        signal.addEventListener("abort", onAbort, { once: true });
+        this.once("close", () => signal.removeEventListener("abort", onAbort));
+      }
+    }
     this.connecting = false;
     this._hadError = false;
     this._handle = null;     /* the host handle's id while open */
@@ -178,9 +204,16 @@ export class Socket extends Duplex {
     this._keepAlive = options.keepAlive === true ? [true, ~~((options.keepAliveInitialDelay ?? 0) / 1000)] : null;
     this._unref = false;
     this._timer = null;         /* the timeout: an unref'd timer, re-armed for the idle time left when it fires */
-    this._timeoutMs = 0;
+    this._timerDue = 0;         /* when _timer fires (loopNow's clock) */
+    this._timeoutMs = 0;        /* 0: off; a pending _timer then finds nothing to do */
     this._lastActive = 0;
     this._onread = null;
+    if (options.typeOfService !== undefined) feature("validateTypeOfService")(options.typeOfService);
+    this._tos = options.typeOfService;  /* internal/net_tos.js's: the type of service, set at connect when given before it */
+    this._boundSource = false;  /* the handle is an adopted BoundSocket's */
+    this._boundPath = undefined;  /* an adopted pipe BoundSocket's path, its local address */
+    this._perfConnect = null;  /* a TCP connect's start, while a PerformanceObserver takes 'net' entries */  /* set at connect when given before it */
+    this._onreadRest = null;  /* internal/net_onread.js's: the bytes read but not yet given when reading stopped */
     this.timeout = undefined;
     this.autoSelectFamilyAttemptedAddresses = undefined;
     validateBlockList(options.blockList, "options.blockList");
@@ -188,10 +221,28 @@ export class Socket extends Duplex {
     const onread = options.onread;
     if (onread !== null && typeof onread === "object" && (typeof onread.buffer === "function" || onread.buffer instanceof Uint8Array) &&
       typeof onread.callback === "function") {
+      feature("onread");  /* internal/net_onread.js's */
       this._onread = onread;
     }
     this.on("end", onReadableStreamEnd);
-    if (options.handle !== undefined) {
+    /* an adopted BoundSocket's handle: bound, not yet connected, so not read until it is */
+    const bound = options.handle !== undefined ? features.adoptBoundSocket?.(options.handle) : null;
+    if (bound) {
+      const { id, path } = bound;
+      this._handle = id;
+      this._boundSource = true;
+      this._isPipe = path !== undefined;
+      netCallback(id, bindContext((event, value) => this._onEvent(event, value, id)));
+      if (path !== undefined) {
+        this._boundPath = path;
+        /* a pipe's bind leaves its stream unopened: opened on its own descriptor, as Node's */
+        const fd = netFd(id);
+        if (fd >= 0) {
+          const err = netOpenFd(id, fd);
+          if (err) throw errnoException(err, "open");
+        }
+      }
+    } else if (options.handle !== undefined) {
       const id = options.handle;
       this._isPipe = !!options._isPipe;
       this._attach(id);
@@ -209,7 +260,7 @@ export class Socket extends Duplex {
       }
       this._attach(id);
     }
-    if (this._handle !== null && options.readable !== false) {
+    if (this._handle !== null && !bound && options.readable !== false) {
       if (options.pauseOnCreate) this._readableState.flowing = false;
       else if (!options.manualStart) this.read(0);
     }
@@ -257,7 +308,7 @@ export class Socket extends Duplex {
       this._bytesRead += value.byteLength;
       this._unrefTimer();
       let more;
-      if (this._onread) more = this._deliver(value);
+      if (this._onread) more = features.onread.deliver(this, value);
       else more = this.push(Buffer.from(value.buffer, value.byteOffset, value.byteLength));
       if (!more) {
         this._reading = false;
@@ -273,22 +324,31 @@ export class Socket extends Duplex {
       this.destroy(errnoException(value, "read"));
       return;
     }
+    if (this._onread) features.onread.eof(this);
     this.push(null);
     this.read(0);
   }
 
-  /* onread: the bytes in the user's buffer, a buffer's worth at a time; false stops reading */
-  _deliver(bytes) {
-    let more = true;
-    for (let at = 0; at < bytes.length;) {
-      const { buffer, callback } = this._onread;
-      const buf = typeof buffer === "function" ? buffer() : buffer;
-      const n = Math.min(buf.length, bytes.length - at);
-      buf.set(bytes.subarray(at, at + n));
-      at += n;
-      if (callback.call(this, n, buf) === false) more = false;
+  /* with onread, pausing stops reading from the handle and resuming starts it, as Node's */
+  pause() {
+    if (this._onread) features.onread.pause(this);
+    return super.pause();
+  }
+
+  resume() {
+    if (this._onread) features.onread.resume(this);
+    return super.resume();
+  }
+
+  /* reading from the handle again (with onread, the bytes left from the last read first) */
+  _startReading() {
+    this._reading = true;
+    if (this._onreadRest) {
+      features.onread.rest(this);
+      return;
     }
-    return more;
+    const err = netReadStart(this._handle);
+    if (err) this.destroy(errnoException(err, "read"));
   }
 
   get pending() {
@@ -304,25 +364,36 @@ export class Socket extends Duplex {
   }
 
   get bufferSize() {
-    return this._handle !== null ? this.writableLength : undefined;
+    return this._handle !== null || this.connecting ? this.writableLength : undefined;
+  }
+
+  get _connecting() {
+    return this.connecting;
   }
 
   get bytesRead() {
     return this._bytesRead;
   }
 
+  /* Node's: what was sent, and what's still buffered (undefined on the prototype) */
   get bytesWritten() {
+    const writableBuffer = this.writableBuffer;
+    if (!writableBuffer) return undefined;
     let bytes = this._bytesDispatched;
-    const state = this._writableState;
-    for (const el of state.buffered) bytes += typeof el.chunk === "string" ? Buffer.byteLength(el.chunk, el.encoding) : el.chunk.length;
+    for (const el of writableBuffer) bytes += typeof el.chunk === "string" ? Buffer.byteLength(el.chunk, el.encoding) : el.chunk.length;
     const data = this._pendingData;
-    if (data) bytes += typeof data === "string" ? Buffer.byteLength(data, this._pendingEncoding) : data.length;
+    if (Array.isArray(data)) {
+      for (const el of data) bytes += typeof el.chunk === "string" ? Buffer.byteLength(el.chunk, el.encoding) : el.chunk.length;
+    } else if (data) {
+      bytes += typeof data === "string" ? Buffer.byteLength(data, this._pendingEncoding) : data.length;
+    }
     return bytes;
   }
 
-  /* a pipe's ends have no address object: Node's Pipe has no getpeername/getsockname */
+  /* a pipe's ends have no address object: Node's Pipe has no getpeername/getsockname;
+   * once closed, the address read while connected */
   _getpeername() {
-    if (this._handle === null || this._isPipe) return {};
+    if (this._handle === null || this._isPipe || this.connecting) return this._peername || {};
     if (!this._peername) {
       const a = netAddress(this._handle, true);
       if (typeof a === "number") return {};
@@ -332,7 +403,8 @@ export class Socket extends Duplex {
   }
 
   _getsockname() {
-    if (this._handle === null || this._isPipe) return {};
+    if (this._boundPath !== undefined) return { address: this._boundPath };
+    if (this._handle === null || this._isPipe) return this._sockname || {};
     if (!this._sockname) {
       const a = netAddress(this._handle, false);
       if (typeof a === "number") return {};
@@ -391,16 +463,19 @@ export class Socket extends Duplex {
     if (typeof msecs !== "number") throw invalidArgType("msecs", "of type number", msecs);
     if (!(msecs >= 0 && msecs !== Infinity)) throw outOfRange("msecs", "a non-negative finite number", msecs);
     if (msecs > TIMEOUT_MAX) msecs = TIMEOUT_MAX;
-    this._clearTimeout();
+    /* the pending timer stays when it fires no later than the new deadline: _onTimer re-arms it
+     * for the rest, so a keep-alive socket, off for each request and on after it, sets no timer */
     if (msecs === 0) {
+      this._timeoutMs = 0;
       if (callback !== undefined) {
         validateFunction(callback, "callback");
         this.removeListener("timeout", callback);
       }
     } else {
       this._timeoutMs = msecs;
-      this._lastActive = now();
-      this._armTimeout(msecs);
+      this._lastActive = loopNow();
+      if (this._timer !== null && this._timerDue > this._lastActive + msecs) this._stopTimer();
+      if (this._timer === null) this._armTimeout(msecs);
       if (callback !== undefined) {
         validateFunction(callback, "callback");
         this.once("timeout", callback);
@@ -410,26 +485,32 @@ export class Socket extends Duplex {
   }
 
   _armTimeout(ms) {
+    this._timerDue = loopNow() + ms;
     this._timer = timerUnref(() => this._onTimer(), ms);
   }
 
   _onTimer() {
     this._timer = null;
-    const idle = now() - this._lastActive;
+    if (this._timeoutMs === 0) return;
+    const idle = loopNow() - this._lastActive;
     if (idle < this._timeoutMs - 1) this._armTimeout(this._timeoutMs - idle);
     else this.emit("timeout");
   }
 
-  _clearTimeout() {
+  _stopTimer() {
     if (this._timer !== null) clearTimeout(this._timer);
     this._timer = null;
+  }
+
+  _clearTimeout() {
+    this._stopTimer();
     this._timeoutMs = 0;
   }
 
   /* activity: the timeout counts from now (Node's timer.refresh(), which re-arms a fired one) */
   _unrefTimer() {
     if (this._timeoutMs) {
-      this._lastActive = now();
+      this._lastActive = loopNow();
       if (this._timer === null) this._armTimeout(this._timeoutMs);
     }
   }
@@ -448,11 +529,7 @@ export class Socket extends Duplex {
 
   _read(n) {
     if (this.connecting || this._handle === null) this.once("connect", () => this._read(n));
-    else if (!this._reading) {
-      this._reading = true;
-      const err = netReadStart(this._handle);
-      if (err) this.destroy(errnoException(err, "read"));
-    }
+    else if (!this._reading) this._startReading();
   }
 
   /* Node's _writeGeneric: a write before the connection waits for it; a write the kernel takes at
@@ -498,7 +575,7 @@ export class Socket extends Duplex {
 
   /* end(): shut the write side down once the writes are out */
   _final(cb) {
-    if (this.pending) {
+    if (this.connecting) {
       this.once("connect", () => this._final(cb));
       return;
     }
@@ -551,7 +628,7 @@ export class Socket extends Duplex {
 
   /* close with a TCP RST instead of a FIN */
   resetAndDestroy() {
-    if (this._handle !== null) {
+    if (this._handle !== null || this.connecting) {
       if (this._isPipe) throw codeError(TypeError, "ERR_INVALID_HANDLE_TYPE", "This handle type cannot be sent");
       if (this.connecting) this.once("connect", () => this._reset());
       else this._reset();
@@ -574,12 +651,27 @@ export class Socket extends Duplex {
   connect(...args) {
     const [options, cb] = args[0] && args[0][normalizedArgs] ? args[0] : normalizeArgs(args);
     if (this.write !== Socket.prototype.write) this.write = Socket.prototype.write;
-    if (this.destroyed) throw notSupported("reconnecting a destroyed socket");
+    if (options.port === undefined && options.path == null) {
+      throw codeError(TypeError, "ERR_MISSING_ARGS", 'The "options" or "port" or "path" argument must be specified');
+    }
+    /* a closed socket connects again, as Node's: its streams undestroyed, its counts the new handle's */
+    if (this.destroyed) {
+      this._handle = null;
+      this._peername = null;
+      this._sockname = null;
+      this._bytesRead = 0;
+      this._bytesDispatched = 0;
+      this._hadError = false;
+      this._perfConnect = null;
+      this._undestroy();
+    }
     const { path } = options;
     if (cb !== null) this.once("connect", cb);
     this._unrefTimer();
     this.connecting = true;
-    if (path) {
+    /* an adopted handle is a pipe or not whatever the options say; once it's gone, the path does */
+    const pipe = this._boundSource && this._handle !== null ? this._isPipe : !!path;
+    if (pipe) {
       validateString(path, "options.path");
       this._isPipe = true;
       this._internalConnect(path);
@@ -594,23 +686,37 @@ export class Socket extends Duplex {
     const host = options.host || "localhost";
     let { port, autoSelectFamilyAttemptTimeout: attemptTimeout, autoSelectFamily: selectFamily } = options;
     if (localAddress && !isIP(localAddress)) throw codeError(TypeError, "ERR_INVALID_IP_ADDRESS", "Invalid IP address: " + localAddress);
-    if (localPort !== undefined && typeof localPort !== "number") throw invalidArgType("options.localPort", "of type number", localPort);
+    if (localPort && typeof localPort !== "number") throw invalidArgType("options.localPort", "of type number", localPort);
     if (typeof host !== "string") throw invalidArgType("options.host", "of type string", host);
+    if (host.includes("\0")) throw invalidArgValue("options.host", "must be a string without null bytes", host);
+    /* an adopted BoundSocket owns the local end and the address family */
+    if (this._boundSource) {
+      if (localAddress !== undefined || localPort !== undefined) {
+        throw invalidArgValue("options", "localAddress and localPort cannot be used with an adopted bound socket", options);
+      }
+      selectFamily = false;
+    }
     if (typeof port !== "undefined") {
       if (typeof port !== "number" && typeof port !== "string") throw invalidArgType("options.port", "of type number or string", port);
       port = validatePort(port);
     }
     port |= 0;
-    if (selectFamily !== undefined && typeof selectFamily !== "boolean") throw invalidArgType("options.autoSelectFamily", "of type boolean", selectFamily);
+    if (selectFamily != null && typeof selectFamily !== "boolean") throw invalidArgType("options.autoSelectFamily", "of type boolean", selectFamily);
     selectFamily ??= autoSelectFamily;
-    if (attemptTimeout !== undefined) {
-      if (typeof attemptTimeout !== "number") throw invalidArgType("options.autoSelectFamilyAttemptTimeout", "of type number", attemptTimeout);
+    if (attemptTimeout != null) {
+      validateInt32(attemptTimeout, "options.autoSelectFamilyAttemptTimeout", 1);
       if (attemptTimeout < 10) attemptTimeout = 10;
     } else {
       attemptTimeout = autoSelectFamilyAttemptTimeout;
     }
     this._host = host;
     const addressType = isIP(host);
+    /* an adopted BoundSocket connects in this tick, so its local address is known at once (a
+     * failure still comes as an 'error' event) */
+    if (addressType && this._boundSource) {
+      this._internalConnect(host, port, addressType, localAddress, localPort);
+      return;
+    }
     if (addressType) {
       process.nextTick(() => {
         if (this.connecting) this._internalConnect(host, port, addressType, localAddress, localPort);
@@ -620,17 +726,19 @@ export class Socket extends Duplex {
     let family = options.family ?? 0;
     if (family === "IPv4") family = 4;
     else if (family === "IPv6") family = 6;
-    const dnsopts = { family, all: selectFamily && family === 0 };
     const lookupFn = options.lookup ?? lookup;
     if (typeof lookupFn !== "function") throw invalidArgType("options.lookup", "of type function", lookupFn);
+    const dnsopts = { family, hints: options.hints || 0, all: false };
+    if (process.platform !== "win32" && family !== 4 && family !== 6 && dnsopts.hints === 0) dnsopts.hints = ADDRCONFIG;
+    dnsopts.all = family !== 4 && family !== 6 && !localAddress && selectFamily;
     if (!dnsopts.all) {
       lookupFn(host, dnsopts, (err, ip, addressType) => {
         this.emit("lookup", err, ip, addressType, host);
         if (!this.connecting) return;
         if (err) process.nextTick(() => this.destroy(err));
-        else if (!isIP(ip)) process.nextTick(() => this.destroy(codeError(TypeError, "ERR_INVALID_IP_ADDRESS", "Invalid IP address: " + ip)));
+        else if (typeof ip !== "string" || !isIP(ip)) process.nextTick(() => this.destroy(codeError(TypeError, "ERR_INVALID_IP_ADDRESS", "Invalid IP address: " + ip)));
         else if (addressType !== 4 && addressType !== 6) {
-          process.nextTick(() => this.destroy(codeError(TypeError, "ERR_INVALID_ADDRESS_FAMILY", "Invalid address family: " + addressType + " " + host + ":" + port)));
+          process.nextTick(() => this.destroy(addressFamilyError(addressType, host, options.port)));
         } else {
           this._unrefTimer();
           this._internalConnect(ip, port, addressType, localAddress, localPort);
@@ -661,7 +769,7 @@ export class Socket extends Duplex {
         const first = addresses[0];
         const error = !first || !isIP(first.address)
           ? codeError(TypeError, "ERR_INVALID_IP_ADDRESS", "Invalid IP address: " + first?.address)
-          : codeError(TypeError, "ERR_INVALID_ADDRESS_FAMILY", "Invalid address family: " + first.family + " " + host + ":" + port);
+          : addressFamilyError(first.family, host, options.port);
         process.nextTick(() => this.destroy(error));
         return;
       }
@@ -687,14 +795,23 @@ export class Socket extends Duplex {
   /* a new handle bound to the local address, if any, and connecting: 0 or the failure as Node reports it */
   _open(address, port, addressType, localAddress, localPort, onConnect) {
     let id;
-    id = netOpen(this._isPipe, bindContext((event, value) => {
+    const cb = bindContext((event, value) => {
       if (event === NET_CONNECT) {
         if (this._handle === id) onConnect(value, id);
       } else {
         this._onEvent(event, value, id);
       }
-    }));
-    this._handle = id;
+    });
+    if (this._boundSource && this._handle !== null) {  /* an adopted BoundSocket's, already bound */
+      id = this._handle;
+      netCallback(id, cb);
+    } else {
+      id = netOpen(this._isPipe, cb);
+      this._handle = id;
+    }
+    if (!this._isPipe && this._perfConnect === null && features.perfObserving?.("net")) {
+      this._perfConnect = { start: features.perfNow(), host: address, port };
+    }
     if (!this._isPipe && (localAddress || localPort)) {
       localAddress ||= addressType === 4 ? "0.0.0.0" : "::";
       const err = netBind(id, localAddress, localPort | 0, 0);
@@ -780,17 +897,27 @@ export class Socket extends Duplex {
     }
     this._attach(this._handle);
     this._unrefTimer();
+    if (this._perfConnect !== null) {
+      const { start, host, port } = this._perfConnect;
+      this._perfConnect = null;
+      features.perfObserve(features.perfEntry("connect", "net", start, features.perfNow() - start, { host, port }));
+    }
+    if (this._tos !== undefined && !this._isPipe) features.applyTypeOfService(this);
     this.emit("connect");
     this.emit("ready");
     if (this.readable && !this.isPaused()) this.read(0);
   }
 }
+/* internal/net_tos.js's, linked when the program names them */
+SocketClass.prototype.setTypeOfService = lazyFunction("setTypeOfService", 1);
+SocketClass.prototype.getTypeOfService = lazyFunction("getTypeOfService");
+export const Socket = callableClass(SocketClass, "Socket");  /* Socket(…) without new, as Node's */
 
 export const Stream = Socket;
 
 /* ---- Server -------------------------------------------------------------------------------- */
 
-export class Server extends EventEmitter {
+class ServerClass extends EventEmitter {
   constructor(options, connectionListener) {
     super();
     if (typeof options === "function") {
@@ -803,6 +930,7 @@ export class Server extends EventEmitter {
     }
     if (typeof connectionListener === "function") this.on("connection", connectionListener);
     this._connections = 0;
+    this._listeningId = 1;  /* a listen or close since a lookup began makes the lookup's result stale */
     this._handle = null;
     this._isPipe = false;
     this._pipeName = undefined;
@@ -827,7 +955,16 @@ export class Server extends EventEmitter {
     if (typeof options.callback === "function") cb = options.callback;
     if (this._handle !== null) throw codeError(Error, "ERR_SERVER_ALREADY_LISTEN", "Listen method has been called more than once without closing.");
     if (cb !== null) this.once("listening", cb);
+    this._listeningId++;
     const backlogFromArgs = toNumber(args.length > 1 && args[1]) || toNumber(args.length > 2 && args[2]);
+    /* listen(boundSocket) or listen({ handle: boundSocket }): the server takes its handle */
+    const bound = features.adoptBoundSocket?.(options) ?? features.adoptBoundSocket?.(options.handle);
+    if (bound) {
+      if (bound.path !== undefined) this._pipeName = bound.path;
+      this._isPipe = bound.path !== undefined;
+      this._setupListen(null, -1, -1, backlogFromArgs, undefined, 0, bound.id);
+      return this;
+    }
     if (options._handle !== undefined && options._handle !== null) options = options._handle;
     else if (options.handle !== undefined && options.handle !== null) options = options.handle;
     const flags = (options.ipv6Only ? 1 : 0) | (options.reusePort ? 2 : 0);
@@ -880,7 +1017,9 @@ export class Server extends EventEmitter {
   }
 
   _lookupAndListen(port, address, backlog, flags) {
+    const listeningId = this._listeningId;
     lookup(address, (err, ip, addressType) => {
+      if (listeningId !== this._listeningId) return;
       if (err) this.emit("error", err);
       else this._setupListen(ip, port, ip ? addressType : 4, backlog, undefined, flags);
     });
@@ -970,6 +1109,7 @@ export class Server extends EventEmitter {
       process.nextTick(() => this.emit("error", ex));
       return;
     }
+    this._connectionKey = addressType + ":" + address + ":" + port;
     if (this._unref) netRef(id, false);
     process.nextTick(() => {
       if (this._handle !== null) this.emit("listening");
@@ -1024,6 +1164,7 @@ export class Server extends EventEmitter {
 
   /* close([cb]): stop accepting; 'close' once the open connections end too */
   close(cb) {
+    this._listeningId++;
     if (typeof cb === "function") {
       if (this._handle === null) this.once("close", () => cb(codeError(Error, "ERR_SERVER_NOT_RUNNING", "Server is not running.")));
       else this.once("close", cb);
@@ -1036,6 +1177,12 @@ export class Server extends EventEmitter {
     return this;
   }
 
+  /* captureRejections: a 'connection' listener's rejection destroys the socket, as Node's */
+  [Symbol.for("nodejs.rejection")](err, event, sock) {
+    if (event === "connection") sock.destroy(err);
+    else this.emit("error", err);
+  }
+
   _emitCloseIfDrained() {
     if (this._handle !== null || this._connections) return;
     process.nextTick(() => this.emit("close"));
@@ -1063,6 +1210,7 @@ export class Server extends EventEmitter {
     return new Promise((resolve, reject) => this.close((err) => (err ? reject(err) : resolve())));
   }
 }
+export const Server = callableClass(ServerClass, "Server");  /* Server(…) without new, as Node's */
 
 export function createServer(options, connectionListener) {
   return new Server(options, connectionListener);
@@ -1079,7 +1227,10 @@ export function connect(...args) {
 
 export const createConnection = connect;
 
+/* internal/net_bound.js's, linked when the program names it */
+export const BoundSocket = lazyClass("BoundSocket");
+
 export default {
-  BlockList, SocketAddress, isIP, isIPv4, isIPv6, Socket, Stream, Server, connect, createConnection, createServer,
+  BlockList, BoundSocket, SocketAddress, isIP, isIPv4, isIPv6, Socket, Stream, Server, connect, createConnection, createServer,
   getDefaultAutoSelectFamily, setDefaultAutoSelectFamily, getDefaultAutoSelectFamilyAttemptTimeout, setDefaultAutoSelectFamilyAttemptTimeout,
 };

package/node/prelude/perf_hooks.js

@@ -15,6 +15,10 @@ const now = () => hrMs() - origin;
 
 const kConstruct = Symbol("construct");
 
+/* for internal/perf_observe.js's users: the clock, and an entry of another module's (net's 'connect') */
+features.perfNow = now;
+features.perfEntry = (name, entryType, startTime, duration, detail) => new PerformanceEntry(kConstruct, name, entryType, startTime, duration, detail);
+
 export class PerformanceEntry {
   constructor(key, name, entryType, startTime, duration, detail) {
     if (key !== kConstruct) throw codeError(TypeError, "ERR_ILLEGAL_CONSTRUCTOR", "Illegal constructor");