@ac-kit/node 0.1.0 → 0.3.0

package/dist/net/stream-server.js

@@ -0,0 +1,129 @@
+import { EventDispatcherMapBase } from "@ac-kit/async";
+/**
+ * Base class for stream-oriented servers.
+ *
+ * This abstraction wraps a {@link net.Server} instance and exposes the lifecycle
+ * that is independent of the transport: binding state, connection accounting,
+ * event-loop referencing and closing.
+ *
+ * Binding and address reporting are transport-specific and are added by the
+ * concrete subclasses {@link TcpServer} and {@link IpcServer}, as is the
+ * "connection" event, whose payload is a socket of the matching type.
+ */
+export class StreamServer extends EventDispatcherMapBase {
+    server;
+    handledErrorEvents = new Set();
+    /**
+     * Creates a new {@link StreamServer} instance.
+     *
+     * @param server The underlying Node.js server.
+     */
+    constructor(server) {
+        super();
+        this.server = server;
+        this.setupEventForwarding();
+    }
+    /** Whether the server is currently listening for connections. */
+    get listening() {
+        return this.server.listening;
+    }
+    /** Maximum number of concurrent connections accepted by the server. */
+    get maxConnections() {
+        return this.server.maxConnections;
+    }
+    /**
+     * Updates the maximum number of concurrent connections.
+     *
+     * Connections accepted beyond this limit are dropped.
+     */
+    set maxConnections(maxConnections) {
+        this.server.maxConnections = maxConnections;
+    }
+    /**
+     * Counts the connections currently handled by the server.
+     *
+     * @returns A promise that resolves with the connection count.
+     */
+    getConnections() {
+        return new Promise((resolve, reject) => {
+            this.server.getConnections((error, count) => {
+                if (error) {
+                    reject(error);
+                    return;
+                }
+                resolve(count);
+            });
+        });
+    }
+    /**
+     * Marks the server as referenced, preventing the Node.js process from exiting
+     * while it is listening.
+     */
+    ref() {
+        this.server.ref();
+    }
+    /**
+     * Marks the server as unreferenced, allowing the Node.js process to exit even
+     * while it is listening.
+     */
+    unref() {
+        this.server.unref();
+    }
+    /**
+     * Stops the server from accepting new connections. Established connections
+     * are not closed; the promise resolves once the last of them ends.
+     *
+     * @returns A promise that resolves when the server is fully closed.
+     * @throws When the server was not listening.
+     */
+    close() {
+        return new Promise((resolve, reject) => {
+            this.server.close((error) => {
+                if (error) {
+                    reject(error);
+                    return;
+                }
+                resolve();
+            });
+        });
+    }
+    /**
+     * Binds the server and resolves once it is listening.
+     *
+     * The bind error is consumed rather than dispatched, so that a rejected
+     * promise is not also reported as an unhandled "error" event.
+     *
+     * @param options The listen options to bind with. Without any, the server
+     *   binds a system-assigned port on every interface.
+     * @returns A promise that resolves once the server is listening.
+     */
+    listenOn(options) {
+        return new Promise((resolve, reject) => {
+            const handleError = (error) => {
+                this.handledErrorEvents.add(error);
+                reject(error);
+            };
+            this.server.prependOnceListener("error", handleError);
+            this.server.listen(options ?? {}, () => {
+                this.server.removeListener("error", handleError);
+                resolve();
+            });
+        });
+    }
+    setupEventForwarding() {
+        this.server.on("close", () => {
+            this.dispatch("close", []);
+        });
+        this.server.on("error", (error) => {
+            if (this.handledErrorEvents.has(error)) {
+                this.handledErrorEvents.delete(error);
+                return;
+            }
+            this.dispatch("error", [error]);
+        });
+        this.server.on("listening", () => {
+            this.dispatch("listening", []);
+        });
+    }
+}
+//# sourceMappingURL=stream-server.js.map

package/dist/net/stream-server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stream-server.js","sourceRoot":"","sources":["../../src/net/stream-server.ts"],"names":[],"mappings":"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"}

package/dist/net/stream-socket.d.ts

@@ -44,6 +44,23 @@ export type StreamSocketEvents = {
      */
     timeout: [];
 };
+/** Options accepted by {@link StreamSocket.from}. */
+export type StreamSocketOptions = net.SocketConstructorOpts;
+/** Options accepted by {@link StreamSocket.end}. */
+export type StreamSocketEndOptions = {
+    /**
+     * Waits for the remote side to close as well, instead of resolving as soon as
+     * the local FIN is queued.
+     */
+    waitForClose?: boolean;
+};
+/** Options accepted by {@link StreamSocket.awaitReady}. */
+export type StreamSocketAwaitReadyOptions = {
+    /** Aborts the attempt, destroying the socket. */
+    signal?: AbortSignal;
+    /** Starts the attempt, once the settlement listeners are in place. */
+    start?: () => void;
+};
 /**
  * Base class for stream-oriented client sockets.
  *
@@ -64,8 +81,8 @@ export type StreamSocketEvents = {
  * Unless explicitly documented otherwise, methods mirror the semantics of their
  * underlying {@link net.Socket} counterparts.
  */
-export declare class StreamSocket<TSock extends net.Socket = net.Socket, TEvents extends StreamSocketEvents = StreamSocketEvents> extends EventDispatcherMapBase<TEvents> implements IEventDispatcherMap<TEvents> {
-    protected readonly sock: TSock;
+export declare class StreamSocket<TSocket extends net.Socket = net.Socket, TEvents extends StreamSocketEvents = StreamSocketEvents> extends EventDispatcherMapBase<TEvents> implements IEventDispatcherMap<TEvents> {
+    protected readonly socket: TSocket;
     protected readonly handledErrorEvents: Set<IError>;
     /**
      * Creates a new {@link StreamSocket} instance.
@@ -73,13 +90,13 @@ export declare class StreamSocket<TSock extends net.Socket = net.Socket, TEvents
      * @param options Options for creating the underlying Node.js socket.
      * @returns A new `StreamSocket` instance.
      */
-    static from(options?: net.SocketConstructorOpts): StreamSocket;
+    static from(options?: StreamSocketOptions): StreamSocket;
     /**
      * Creates a new {@link StreamSocket} instance.
      *
-     * @param sock The underlying Node.js socket.
+     * @param socket The underlying Node.js socket.
      */
-    constructor(sock: TSock);
+    constructor(socket: TSocket);
     /**
      * Underlying duplex stream for reading and writing data.
      *
@@ -128,9 +145,7 @@ export declare class StreamSocket<TSock extends net.Socket = net.Socket, TEvents
      * @param options Optional settings for ending the socket.
      * @returns A promise that resolves once the socket has ended.
      */
-    end(options?: {
-        waitForClose?: boolean;
-    }): Promise<void>;
+    end(options?: StreamSocketEndOptions): Promise<void>;
     /**
      * Writes data to the socket and resolves once that chunk has been flushed.
      *
@@ -151,6 +166,20 @@ export declare class StreamSocket<TSock extends net.Socket = net.Socket, TEvents
      * still be invoked.
      */
     destroy(): void;
+    /**
+     * Runs an operation that establishes the connection and resolves once the
+     * socket emits `readyEvent`.
+     *
+     * The promise always settles: an "error" event rejects it and is consumed so
+     * it is not also dispatched to subscribers, a "close" event without a
+     * preceding error rejects with {@link ConnectionClosedError}, and aborting the
+     * signal destroys the socket and rejects with the abort reason.
+     *
+     * @param readyEvent Underlying socket event signalling a usable connection.
+     * @param options Abort signal and the operation that starts the connection.
+     * @returns A promise that resolves once the connection is established.
+     */
+    protected awaitReady(readyEvent: string, options?: StreamSocketAwaitReadyOptions): Promise<void>;
     protected setupEventForwarding(): void;
 }
 //# sourceMappingURL=stream-socket.d.ts.map

package/dist/net/stream-socket.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"stream-socket.d.ts","sourceRoot":"","sources":["../../src/net/stream-socket.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,GAAG,MAAM,UAAU,CAAC;AAChC,OAAO,KAAK,KAAK,MAAM,MAAM,aAAa,CAAC;AAE3C,OAAO,EAAE,sBAAsB,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AAC5E,OAAO,EAAE,KAAK,MAAM,EAAE,MAAM,cAAc,CAAC;AAE3C;;;;;;GAMG;AACH,MAAM,MAAM,kBAAkB,GAAG;IAChC;;;;;OAKG;IACH,KAAK,EAAE,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;IAEvB;;;;OAIG;IACH,KAAK,EAAE,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IAE3B;;;;OAIG;IACH,OAAO,EAAE,EAAE,CAAC;IAEZ;;;;;OAKG;IACH,KAAK,EAAE,EAAE,CAAC;IAEV;;;;;OAKG;IACH,OAAO,EAAE,EAAE,CAAC;CACZ,CAAC;AAEF;;;;;;;;;;;;;;;;;;;GAmBG;AACH,qBAAa,YAAY,CACxB,KAAK,SAAS,GAAG,CAAC,MAAM,GAAG,GAAG,CAAC,MAAM,EACrC,OAAO,SAAS,kBAAkB,GAAG,kBAAkB,CAEvD,SAAQ,sBAAsB,CAAC,OAAO,CACtC,YAAW,mBAAmB,CAAC,OAAO,CAAC;IAmB3B,SAAS,CAAC,QAAQ,CAAC,IAAI,EAAE,KAAK;IAjB1C,SAAS,CAAC,QAAQ,CAAC,kBAAkB,EAAE,GAAG,CAAC,MAAM,CAAC,CAAa;IAE/D;;;;;OAKG;IACH,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,GAAG,CAAC,qBAAqB,GAAG,YAAY,CAE7D;IAED;;;;OAIG;IACH,YAA+B,IAAI,EAAE,KAAK,EAGzC;IAED;;;;;OAKG;IACH,IAAI,MAAM,IAAI,MAAM,CAAC,MAAM,CAE1B;IAED,0DAA0D;IAC1D,IAAI,MAAM,IAAI,OAAO,CAEpB;IAED,kEAAkE;IAClE,IAAI,SAAS,IAAI,OAAO,CAEvB;IAED,yDAAyD;IACzD,IAAI,SAAS,IAAI,MAAM,CAEtB;IAED,0DAA0D;IAC1D,IAAI,YAAY,IAAI,MAAM,CAEzB;IAED,oEAAoE;IACpE,IAAI,UAAU,IAAI,OAAO,CAExB;IAED,yEAAyE;IACzE,IAAI,OAAO,IAAI,MAAM,GAAG,IAAI,CAE3B;IAED;;;;;;OAMG;IACH,IAAI,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,EAEjC;IAED;;;OAGG;IACH,GAAG,IAAI,IAAI,CAEV;IAED;;;OAGG;IACH,KAAK,IAAI,IAAI,CAEZ;IAED;;;;;;;;;;OAUG;IACH,GAAG,CAAC,OAAO,CAAC,EAAE;QAAE,YAAY,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAwBvD;IAED;;;;;;;;;;OAUG;IACH,KAAK,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAYrC;IAED;;;;;;OAMG;IACH,OAAO,IAAI,IAAI,CAEd;IAED,SAAS,CAAC,oBAAoB,IAAI,IAAI,CAwBrC;CACD"}
+{"version":3,"file":"stream-socket.d.ts","sourceRoot":"","sources":["../../src/net/stream-socket.ts"],"names":[],"mappings":"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"}

package/dist/net/stream-socket.js

@@ -1,5 +1,6 @@
 import * as net from "node:net";
 import { EventDispatcherMapBase } from "@ac-kit/async";
+import { ConnectionClosedError } from "./connection-closed-error.js";
 /**
  * Base class for stream-oriented client sockets.
  *
@@ -21,7 +22,7 @@ import { EventDispatcherMapBase } from "@ac-kit/async";
  * underlying {@link net.Socket} counterparts.
  */
 export class StreamSocket extends EventDispatcherMapBase {
-    sock;
+    socket;
     handledErrorEvents = new Set();
     /**
      * Creates a new {@link StreamSocket} instance.
@@ -35,11 +36,11 @@ export class StreamSocket extends EventDispatcherMapBase {
     /**
      * Creates a new {@link StreamSocket} instance.
      *
-     * @param sock The underlying Node.js socket.
+     * @param socket The underlying Node.js socket.
      */
-    constructor(sock) {
+    constructor(socket) {
         super();
-        this.sock = sock;
+        this.socket = socket;
         this.setupEventForwarding();
     }
     /**
@@ -49,31 +50,31 @@ export class StreamSocket extends EventDispatcherMapBase {
      * to APIs that expect a Node.js stream.
      */
     get stream() {
-        return this.sock;
+        return this.socket;
     }
     /** Indicates whether the socket has been fully closed. */
     get closed() {
-        return this.sock.closed;
+        return this.socket.closed;
     }
     /** Indicates whether the underlying socket has been destroyed. */
     get destroyed() {
-        return this.sock.destroyed;
+        return this.socket.destroyed;
     }
     /** Total number of bytes read from the socket so far. */
     get bytesRead() {
-        return this.sock.bytesRead;
+        return this.socket.bytesRead;
     }
     /** Total number of bytes written to the socket so far. */
     get bytesWritten() {
-        return this.sock.bytesWritten;
+        return this.socket.bytesWritten;
     }
     /** Whether the socket is currently in the process of connecting. */
     get connecting() {
-        return this.sock.connecting;
+        return this.socket.connecting;
     }
     /** Current inactivity timeout in milliseconds, or `null` if disabled. */
     get timeout() {
-        return this.sock.timeout ?? null;
+        return this.socket.timeout ?? null;
     }
     /**
      * Updates the inactivity timeout for the socket.
@@ -83,21 +84,21 @@ export class StreamSocket extends EventDispatcherMapBase {
      * `null` disables the timeout entirely.
      */
     set timeout(timeout) {
-        this.sock.setTimeout(timeout ?? 0);
+        this.socket.setTimeout(timeout ?? 0);
     }
     /**
      * Marks the socket as referenced, preventing the Node.js process from exiting
      * while the socket is active.
      */
     ref() {
-        this.sock.ref();
+        this.socket.ref();
     }
     /**
      * Marks the socket as unreferenced, allowing the Node.js process to exit even
      * if the socket is still active.
      */
     unref() {
-        this.sock.unref();
+        this.socket.unref();
     }
     /**
      * Half-closes the socket, optionally waiting for a full close.
@@ -117,17 +118,17 @@ export class StreamSocket extends EventDispatcherMapBase {
                 reject(error);
             };
             const handleEnd = () => {
-                this.sock.removeListener("error", handleError);
+                this.socket.removeListener("error", handleError);
                 resolve();
             };
-            this.sock.prependOnceListener("error", handleError);
-            if (options?.waitForClose && !this.sock.closed) {
-                this.sock.prependOnceListener("close", () => {
-                    this.sock.removeListener("error", handleError);
+            this.socket.prependOnceListener("error", handleError);
+            if (options?.waitForClose && !this.socket.closed) {
+                this.socket.prependOnceListener("close", () => {
+                    this.socket.removeListener("error", handleError);
                     resolve();
                 });
             }
-            this.sock.end(options?.waitForClose && !this.sock.closed ? undefined : handleEnd);
+            this.socket.end(options?.waitForClose && !this.socket.closed ? undefined : handleEnd);
         });
     }
     /**
@@ -150,7 +151,7 @@ export class StreamSocket extends EventDispatcherMapBase {
                 }
                 resolve();
             };
-            this.sock.write(data, callback);
+            this.socket.write(data, callback);
         });
     }
     /**
@@ -161,26 +162,78 @@ export class StreamSocket extends EventDispatcherMapBase {
      * still be invoked.
      */
     destroy() {
-        this.sock.destroy();
+        this.socket.destroy();
+    }
+    /**
+     * Runs an operation that establishes the connection and resolves once the
+     * socket emits `readyEvent`.
+     *
+     * The promise always settles: an "error" event rejects it and is consumed so
+     * it is not also dispatched to subscribers, a "close" event without a
+     * preceding error rejects with {@link ConnectionClosedError}, and aborting the
+     * signal destroys the socket and rejects with the abort reason.
+     *
+     * @param readyEvent Underlying socket event signalling a usable connection.
+     * @param options Abort signal and the operation that starts the connection.
+     * @returns A promise that resolves once the connection is established.
+     */
+    awaitReady(readyEvent, options) {
+        const { signal, start } = options ?? {};
+        return new Promise((resolve, reject) => {
+            const abortListeners = new AbortController();
+            const cleanup = () => {
+                abortListeners.abort();
+                this.socket.removeListener(readyEvent, handleReady);
+                this.socket.removeListener("error", handleError);
+                this.socket.removeListener("close", handleClose);
+            };
+            const handleReady = () => {
+                cleanup();
+                resolve();
+            };
+            const handleError = (error) => {
+                this.handledErrorEvents.add(error);
+                cleanup();
+                reject(error);
+            };
+            // A peer that drops the transport mid-connection closes it without an
+            // "error"; without this the promise would stay pending forever.
+            const handleClose = () => {
+                cleanup();
+                reject(new ConnectionClosedError(`Socket closed before the "${readyEvent}" event`));
+            };
+            if (signal) {
+                signal.throwIfAborted();
+                signal.addEventListener("abort", () => {
+                    cleanup();
+                    this.socket.destroy();
+                    reject(signal.reason);
+                }, { once: true, signal: abortListeners.signal });
+            }
+            this.socket.once(readyEvent, handleReady);
+            this.socket.prependOnceListener("error", handleError);
+            this.socket.once("close", handleClose);
+            start?.();
+        });
     }
     setupEventForwarding() {
-        this.sock.on("error", (err) => {
+        this.socket.on("error", (err) => {
             if (this.handledErrorEvents.has(err)) {
                 this.handledErrorEvents.delete(err);
                 return;
             }
             this.dispatch("error", [err]);
         });
-        this.sock.on("close", (hadError) => {
+        this.socket.on("close", (hadError) => {
             this.dispatch("close", [hadError]);
         });
-        this.sock.on("connect", () => {
+        this.socket.on("connect", () => {
             this.dispatch("connect", []);
         });
-        this.sock.on("ready", () => {
+        this.socket.on("ready", () => {
             this.dispatch("ready", []);
         });
-        this.sock.on("timeout", () => {
+        this.socket.on("timeout", () => {
             this.dispatch("timeout", []);
         });
     }

package/dist/net/stream-socket.js.map

@@ -1 +1 @@
-{"version":3,"file":"stream-socket.js","sourceRoot":"","sources":["../../src/net/stream-socket.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,GAAG,MAAM,UAAU,CAAC;AAGhC,OAAO,EAAE,sBAAsB,EAAuB,MAAM,eAAe,CAAC;AAkD5E;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,OAAO,YAIZ,SAAQ,sBAA+B;IAoBR,IAAI;IAjBhB,kBAAkB,GAAgB,IAAI,GAAG,EAAE,CAAC;IAE/D;;;;;OAKG;IACH,MAAM,CAAC,IAAI,CAAC,OAAmC;QAC9C,OAAO,IAAI,YAAY,CAAC,IAAI,GAAG,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC;IAClD,CAAC;IAED;;;;OAIG;IACH,YAA+B,IAAW;QACzC,KAAK,EAAE,CAAC;oBADsB,IAAI;QAElC,IAAI,CAAC,oBAAoB,EAAE,CAAC;IAC7B,CAAC;IAED;;;;;OAKG;IACH,IAAI,MAAM;QACT,OAAO,IAAI,CAAC,IAAI,CAAC;IAClB,CAAC;IAED,0DAA0D;IAC1D,IAAI,MAAM;QACT,OAAO,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC;IACzB,CAAC;IAED,kEAAkE;IAClE,IAAI,SAAS;QACZ,OAAO,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC;IAC5B,CAAC;IAED,yDAAyD;IACzD,IAAI,SAAS;QACZ,OAAO,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC;IAC5B,CAAC;IAED,0DAA0D;IAC1D,IAAI,YAAY;QACf,OAAO,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC;IAC/B,CAAC;IAED,oEAAoE;IACpE,IAAI,UAAU;QACb,OAAO,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC;IAC7B,CAAC;IAED,yEAAyE;IACzE,IAAI,OAAO;QACV,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,IAAI,IAAI,CAAC;IAClC,CAAC;IAED;;;;;;OAMG;IACH,IAAI,OAAO,CAAC,OAAsB;QACjC,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,OAAO,IAAI,CAAC,CAAC,CAAC;IACpC,CAAC;IAED;;;OAGG;IACH,GAAG;QACF,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC;IACjB,CAAC;IAED;;;OAGG;IACH,KAAK;QACJ,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC;IACnB,CAAC;IAED;;;;;;;;;;OAUG;IACH,GAAG,CAAC,OAAoC;QACvC,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YACtC,MAAM,WAAW,GAAG,CAAC,KAAa,EAAE,EAAE;gBACrC,IAAI,CAAC,kBAAkB,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;gBACnC,MAAM,CAAC,KAAK,CAAC,CAAC;YACf,CAAC,CAAC;YACF,MAAM,SAAS,GAAG,GAAG,EAAE;gBACtB,IAAI,CAAC,IAAI,CAAC,cAAc,CAAC,OAAO,EAAE,WAAW,CAAC,CAAC;gBAC/C,OAAO,EAAE,CAAC;YACX,CAAC,CAAC;YAEF,IAAI,CAAC,IAAI,CAAC,mBAAmB,CAAC,OAAO,EAAE,WAAW,CAAC,CAAC;YAEpD,IAAI,OAAO,EAAE,YAAY,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;gBAChD,IAAI,CAAC,IAAI,CAAC,mBAAmB,CAAC,OAAO,EAAE,GAAG,EAAE;oBAC3C,IAAI,CAAC,IAAI,CAAC,cAAc,CAAC,OAAO,EAAE,WAAW,CAAC,CAAC;oBAC/C,OAAO,EAAE,CAAC;gBACX,CAAC,CAAC,CAAC;YACJ,CAAC;YAED,IAAI,CAAC,IAAI,CAAC,GAAG,CACZ,OAAO,EAAE,YAAY,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,CAClE,CAAC;QACH,CAAC,CAAC,CAAC;IACJ,CAAC;IAED;;;;;;;;;;OAUG;IACH,KAAK,CAAC,IAAgB;QACrB,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YACtC,MAAM,QAAQ,GAAG,CAAC,KAAqB,EAAE,EAAE;gBAC1C,IAAI,KAAK,EAAE,CAAC;oBACX,MAAM,CAAC,KAAK,CAAC,CAAC;oBACd,OAAO;gBACR,CAAC;gBACD,OAAO,EAAE,CAAC;YACX,CAAC,CAAC;YAEF,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;QACjC,CAAC,CAAC,CAAC;IACJ,CAAC;IAED;;;;;;OAMG;IACH,OAAO;QACN,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;IACrB,CAAC;IAES,oBAAoB;QAC7B,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,EAAE;YAC7B,IAAI,IAAI,CAAC,kBAAkB,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;gBACtC,IAAI,CAAC,kBAAkB,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;gBACpC,OAAO;YACR,CAAC;YACD,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;QAC/B,CAAC,CAAC,CAAC;QAEH,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,EAAE;YAClC,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC;QACpC,CAAC,CAAC,CAAC;QAEH,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,SAAS,EAAE,GAAG,EAAE;YAC5B,IAAI,CAAC,QAAQ,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC;QAC9B,CAAC,CAAC,CAAC;QAEH,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE;YAC1B,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;QAC5B,CAAC,CAAC,CAAC;QAEH,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,SAAS,EAAE,GAAG,EAAE;YAC5B,IAAI,CAAC,QAAQ,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC;QAC9B,CAAC,CAAC,CAAC;IACJ,CAAC;CACD"}
+{"version":3,"file":"stream-socket.js","sourceRoot":"","sources":["../../src/net/stream-socket.ts"],"names":[],"mappings":"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"}

package/dist/net/tcp-server.d.ts

@@ -1,110 +1,68 @@
 import * as net from "node:net";
-import { EventDispatcherMapBase, IEventDispatcherMap } from "@ac-kit/async";
-import { InetEndpoint, type IError } from "@ac-kit/core";
 import type { Except } from "type-fest";
+import type { InetEndpoint } from "./inet-endpoint.js";
+import { StreamServer, type StreamServerEvents } from "./stream-server.js";
 import { TcpSocket } from "./tcp-socket.js";
-/** Event map for TcpServer server-specific events. */
-export type TcpServerEvents = {
-    /** Emitted when the server closes. */
-    close: [];
+/** Event map for {@link TcpServer}. */
+export type TcpServerEvents = StreamServerEvents & {
+    /** Emitted when a new connection is accepted. */
+    connection: [socket: TcpSocket];
     /**
-     * Emitted when a new connection is made. The connection is wrapped in a
-     * TcpClient instance.
-     */
-    connection: [client: TcpSocket];
-    /**
-     * Emitted when a new connection is dropped. Provides the local and remote
-     * endpoint information of the dropped connection.
+     * Emitted when a connection is dropped because
+     * {@link StreamServer.maxConnections} was reached. Each endpoint is `null`
+     * when Node.js did not report it.
      */
     drop: [
         localEndpoint: InetEndpoint | null,
         remoteEndpoint: InetEndpoint | null
     ];
-    /** Emitted when an error occurs. */
-    error: [err: IError];
-    /** Emitted when the server has been bound after calling server.listen(). */
-    listening: [];
 };
+/** Options accepted by {@link TcpServer.from}. */
+export type TcpServerOptions = net.ServerOpts;
+/** Options accepted by {@link TcpServer.listen}. */
+export type TcpServerListenOptions = Except<net.ListenOptions, "port" | "path" | "handle">;
 /**
- * TCP server to accept incoming connections.
+ * TCP server accepting incoming connections.
  *
  * Example usage:
  *
  * ```ts
  * const server = TcpServer.from();
- * server.on("connection", (client) => {
- * 	console.log("Client connected");
- * 	client.stream.on("data", (data) => {
+ * server.subscribe("connection", (socket) => {
+ * 	socket.stream.on("data", (data) => {
  * 		console.log("Received:", data.toString());
  * 	});
  * });
- * await server.listen(8080, "0.0.0.0");
+ * await server.listen(8080, { host: "0.0.0.0" });
  * // ... later
  * await server.close();
  * ```
  */
-export declare class TcpServer extends EventDispatcherMapBase<TcpServerEvents> implements IEventDispatcherMap<TcpServerEvents> {
-    private readonly srv;
+export declare class TcpServer<TServer extends net.Server = net.Server, TEvents extends TcpServerEvents = TcpServerEvents> extends StreamServer<TServer, TEvents> {
     /**
-     * Creates a new `TcpServer` instance with the specified options.
+     * Creates a new {@link TcpServer} instance.
      *
-     * @param options Options for creating the TCP server.
+     * @param options Options for creating the underlying Node.js server.
      * @returns A new `TcpServer` instance.
      */
-    static from(options?: net.ServerOpts): TcpServer;
-    private readonly handledErrorEvents;
-    constructor(srv: net.Server);
-    /**
-     * Gets the current number of concurrent connections on the server.
-     *
-     * @returns A promise that resolves with the connection count.
-     */
-    getConnections(): Promise<number>;
-    /** Gets whether the server is currently listening for connections. */
-    get listening(): boolean;
+    static from(options?: TcpServerOptions): TcpServer;
     /**
-     * Sets the maximum number of queued pending connections.
+     * Binds the server and resolves once it is listening.
      *
-     * @param maxConnections The maximum number of connections to queue.
-     */
-    set maxConnections(maxConnections: number);
-    /** Gets the maximum number of queued pending connections. */
-    get maxConnections(): number;
-    /**
-     * References the server, preventing the process from exiting while the server
-     * is active.
-     */
-    ref(): void;
-    /**
-     * Unreferences the server, allowing the process from exiting even if the
-     * server is active.
-     */
-    unref(): void;
-    /**
-     * Starts the TCP server listening on the specified port and host.
-     *
-     * @param port The port to listen on. If 0, a random available port will be
-     *   assigned.
-     * @param host The host/interface to bind to. Defaults to '::' (IPv6) or
-     *   '0.0.0.0' (IPv4).
+     * @param port The port to listen on. Use `0` to let the system assign one.
      * @param options Additional listen options.
-     * @returns A promise that resolves when the server is successfully listening.
-     */
-    listen(port: number, host?: string, options?: Except<net.ListenOptions, "port" | "host">): Promise<void>;
-    /**
-     * Closes the TCP server, stopping it from accepting new connections. Existing
-     * connections are not automatically closed.
-     *
-     * @returns A promise that resolves when the server is fully closed.
+     * @returns A promise that resolves once the server is listening.
+     * @throws When the address is already in use or cannot be bound.
      */
-    close(): Promise<void>;
+    listen(port: number, options?: TcpServerListenOptions): Promise<void>;
     /**
-     * Gets the address information of the server.
+     * Returns the endpoint the server is bound to.
      *
-     * @returns The server's endpoint information or null if the server is not
-     *   listening.
+     * @returns The bound endpoint, or `null` when the server is not listening.
+     * @throws {UnsupportedError} When the server is bound to a path rather than
+     *   an IP endpoint. Use {@link IpcServer} for those.
      */
     address(): InetEndpoint | null;
-    private setupEventForwarding;
+    protected setupEventForwarding(): void;
 }
 //# sourceMappingURL=tcp-server.d.ts.map

package/dist/net/tcp-server.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tcp-server.d.ts","sourceRoot":"","sources":["../../src/net/tcp-server.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,GAAG,MAAM,UAAU,CAAC;AAEhC,OAAO,EAAE,sBAAsB,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AAC5E,OAAO,EAEN,YAAY,EAEZ,KAAK,MAAM,EACX,MAAM,cAAc,CAAC;AACtB,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AAExC,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAE5C,sDAAsD;AACtD,MAAM,MAAM,eAAe,GAAG;IAC7B,sCAAsC;IACtC,KAAK,EAAE,EAAE,CAAC;IAEV;;;OAGG;IACH,UAAU,EAAE,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IAEhC;;;OAGG;IACH,IAAI,EAAE;QACL,aAAa,EAAE,YAAY,GAAG,IAAI;QAClC,cAAc,EAAE,YAAY,GAAG,IAAI;KACnC,CAAC;IAEF,oCAAoC;IACpC,KAAK,EAAE,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;IAErB,4EAA4E;IAC5E,SAAS,EAAE,EAAE,CAAC;CACd,CAAC;AAEF;;;;;;;;;;;;;;;;;GAiBG;AACH,qBAAa,SACZ,SAAQ,sBAAsB,CAAC,eAAe,CAC9C,YAAW,mBAAmB,CAAC,eAAe,CAAC;IAcnC,OAAO,CAAC,QAAQ,CAAC,GAAG;IAZhC;;;;;OAKG;IACH,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,GAAG,CAAC,UAAU,GAAG,SAAS,CAE/C;IAED,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAA0B;IAE7D,YAA6B,GAAG,EAAE,GAAG,CAAC,MAAM,EAG3C;IAED;;;;OAIG;IACH,cAAc,IAAI,OAAO,CAAC,MAAM,CAAC,CAUhC;IAED,sEAAsE;IACtE,IAAI,SAAS,IAAI,OAAO,CAEvB;IAED;;;;OAIG;IACH,IAAI,cAAc,CAAC,cAAc,EAAE,MAAM,EAExC;IAED,6DAA6D;IAC7D,IAAI,cAAc,IAAI,MAAM,CAE3B;IAED;;;OAGG;IACH,GAAG,IAAI,IAAI,CAEV;IAED;;;OAGG;IACH,KAAK,IAAI,IAAI,CAEZ;IAED;;;;;;;;;OASG;IACH,MAAM,CACL,IAAI,EAAE,MAAM,EACZ,IAAI,CAAC,EAAE,MAAM,EACb,OAAO,CAAC,EAAE,MAAM,CAAC,GAAG,CAAC,aAAa,EAAE,MAAM,GAAG,MAAM,CAAC,GAClD,OAAO,CAAC,IAAI,CAAC,CAoBf;IAED;;;;;OAKG;IACH,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAUrB;IAED;;;;;OAKG;IACH,OAAO,IAAI,YAAY,GAAG,IAAI,CAiB7B;IAED,OAAO,CAAC,oBAAoB;CAsD5B"}
+{"version":3,"file":"tcp-server.d.ts","sourceRoot":"","sources":["../../src/net/tcp-server.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,GAAG,MAAM,UAAU,CAAC;AAGhC,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AAGxC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,EAAE,YAAY,EAAE,KAAK,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAC3E,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAE5C,uCAAuC;AACvC,MAAM,MAAM,eAAe,GAAG,kBAAkB,GAAG;IAClD,iDAAiD;IACjD,UAAU,EAAE,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IAEhC;;;;OAIG;IACH,IAAI,EAAE;QACL,aAAa,EAAE,YAAY,GAAG,IAAI;QAClC,cAAc,EAAE,YAAY,GAAG,IAAI;KACnC,CAAC;CACF,CAAC;AAEF,kDAAkD;AAClD,MAAM,MAAM,gBAAgB,GAAG,GAAG,CAAC,UAAU,CAAC;AAE9C,oDAAoD;AACpD,MAAM,MAAM,sBAAsB,GAAG,MAAM,CAC1C,GAAG,CAAC,aAAa,EACjB,MAAM,GAAG,MAAM,GAAG,QAAQ,CAC1B,CAAC;AAEF;;;;;;;;;;;;;;;;GAgBG;AACH,qBAAa,SAAS,CACrB,OAAO,SAAS,GAAG,CAAC,MAAM,GAAG,GAAG,CAAC,MAAM,EACvC,OAAO,SAAS,eAAe,GAAG,eAAe,CAChD,SAAQ,YAAY,CAAC,OAAO,EAAE,OAAO,CAAC;IACvC;;;;;OAKG;IACH,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,gBAAgB,GAAG,SAAS,CAEjD;IAED;;;;;;;OAOG;IACH,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,sBAAsB,GAAG,OAAO,CAAC,IAAI,CAAC,CAKpE;IAED;;;;;;OAMG;IACH,OAAO,IAAI,YAAY,GAAG,IAAI,CAiB7B;IAED,UAAmB,oBAAoB,IAAI,IAAI,CA8B9C;CACD"}