@ac-kit/node 0.1.0 → 0.2.0

package/CHANGELOG.md

@@ -0,0 +1,55 @@
+# @ac-kit/node
+
+## 0.2.0
+
+### Minor Changes
+
+- a493b4a: **Breaking:** `escapeCommandArg` and `escapeCommand` are gone. They dispatched
+  over `process.platform` to helpers that now live in `@ac-kit/format-shell`, and
+  `node` may not depend on a `format-*` package (`ARCHITECTURE.md` §3).
+  
+  Callers name the dialect instead, deriving it from the platform if that is what
+  they want:
+  
+  ```ts
+  import { escapeCommandArg, shellDialectForPlatform } from "@ac-kit/format-shell";
+  
+  escapeCommandArg(value, shellDialectForPlatform(process.platform));
+  ```
+
+- 70c1269: Rework the `net` socket and server wrappers, and add `TlsServer` / `IpcServer`
+  
+  - Connection helpers now always settle: a socket that closes before connecting
+    rejects with the new `ConnectionClosedError` instead of leaving the promise
+    pending, and `IpcSocket.connect` accepts an `AbortSignal` like its siblings.
+  - `TcpSocket` and `IpcSocket` no longer register their event forwarders twice,
+    which made every event dispatch to subscribers twice.
+  - New `InetSocket` base class: `TlsSocket` now exposes `remoteEndpoint`,
+    `localEndpoint`, `setNoDelay`, `setKeepAlive` and the connection-attempt and
+    `lookup` events, previously available on `TcpSocket` only.
+  - `TlsSocket.connect` destroys the transport when the handshake fails, so a
+    failed `STARTTLS` upgrade can no longer fall back to cleartext. It also
+    accepts a local endpoint path, for a TLS server behind a Unix domain socket.
+  - `TlsSocket` fixes: `TlsSocketOptions` keeps the secure-context options (`ca`,
+    `cert`, `key`, …) that were previously stripped, `getPeerCertificate` is
+    overloaded instead of taking an escapable return type parameter, empty
+    results are normalized to `null` consistently, `exportKeyingMaterial` takes an
+    optional context, `setKeyCert` accepts `SecureContextOptions`, `renegotiate`
+    takes its options optionally, and the `servername` and `secure` members are
+    exposed. `getTicket()` is renamed `getTLSTicket()` to match Node.js.
+  - New `StreamServer` base class with `TcpServer` rebuilt on top of it, plus
+    `IpcServer` and `TlsServer`.
+  - `IpcSocket.fromFd` adopts an already-open descriptor, such as a pipe
+    inherited from a parent process.
+  - `IpcSocketEvents` no longer declares the IP-only connection-attempt events,
+    which never fired.
+
+### Patch Changes
+
+- Updated dependencies [a493b4a]
+- Updated dependencies [a493b4a]
+- Updated dependencies [a493b4a]
+- Updated dependencies [2ab5593]
+- Updated dependencies [a493b4a]
+  - @ac-kit/core@0.2.0
+  - @ac-kit/async@0.1.1

package/README.md

@@ -23,6 +23,8 @@ await writeFileAtomic("config.json", JSON.stringify(config));
 ## What it covers
 
 - **Sockets** — promise-based TCP, TLS, IPC and UDP classes.
+- **Servers** — promise-based TCP, TLS and IPC listeners, dispatching typed
+  connection events.
 - **Filesystem** — `walkPaths`, `writeFileAtomic`, `existsAsync`,
   `isDirectoryAsync`, `fileContentEqual`, `compressFile`, `createTempDir`,
   `escapePath`.

package/dist/index.d.ts

@@ -16,19 +16,22 @@ export * from "./fs/write-file-atomic.js";
 export * from "./module/import-module.js";
 export * from "./module/optional-import.js";
 export * from "./module/resolve-module.js";
+export * from "./net/connection-closed-error.js";
 export * from "./net/dgram-socket.js";
+export * from "./net/inet-socket.js";
+export * from "./net/ipc-server.js";
 export * from "./net/ipc-socket.js";
+export * from "./net/stream-server.js";
 export * from "./net/stream-socket.js";
 export * from "./net/tcp-server.js";
 export * from "./net/tcp-socket.js";
+export * from "./net/tls-server.js";
 export * from "./net/tls-socket.js";
 export * from "./process/fork-process.js";
 export * from "./process/guarded.js";
 export * from "./process/spawn-process.js";
 export * from "./process/spawned-process.js";
 export * from "./process/start-process.js";
-export * from "./shell/escape-command-arg.js";
-export * from "./shell/escape-command.js";
 export * from "./stream/non-closing-writable-stream.js";
 export * from "./stream/write-async.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,+BAA+B,CAAC;AAC9C,cAAc,iCAAiC,CAAC;AAChD,cAAc,uBAAuB,CAAC;AACtC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,8BAA8B,CAAC;AAC7C,cAAc,+BAA+B,CAAC;AAC9C,cAAc,uBAAuB,CAAC;AACtC,cAAc,yBAAyB,CAAC;AACxC,cAAc,qBAAqB,CAAC;AACpC,cAAc,sBAAsB,CAAC;AACrC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,eAAe,CAAC;AAC9B,cAAc,oBAAoB,CAAC;AACnC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,2BAA2B,CAAC;AAC1C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,uBAAuB,CAAC;AACtC,cAAc,qBAAqB,CAAC;AACpC,cAAc,wBAAwB,CAAC;AACvC,cAAc,qBAAqB,CAAC;AACpC,cAAc,qBAAqB,CAAC;AACpC,cAAc,qBAAqB,CAAC;AACpC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,sBAAsB,CAAC;AACrC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,8BAA8B,CAAC;AAC7C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,+BAA+B,CAAC;AAC9C,cAAc,2BAA2B,CAAC;AAC1C,cAAc,yCAAyC,CAAC;AACxD,cAAc,yBAAyB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,+BAA+B,CAAC;AAC9C,cAAc,iCAAiC,CAAC;AAChD,cAAc,uBAAuB,CAAC;AACtC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,8BAA8B,CAAC;AAC7C,cAAc,+BAA+B,CAAC;AAC9C,cAAc,uBAAuB,CAAC;AACtC,cAAc,yBAAyB,CAAC;AACxC,cAAc,qBAAqB,CAAC;AACpC,cAAc,sBAAsB,CAAC;AACrC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,eAAe,CAAC;AAC9B,cAAc,oBAAoB,CAAC;AACnC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,2BAA2B,CAAC;AAC1C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,kCAAkC,CAAC;AACjD,cAAc,uBAAuB,CAAC;AACtC,cAAc,sBAAsB,CAAC;AACrC,cAAc,qBAAqB,CAAC;AACpC,cAAc,qBAAqB,CAAC;AACpC,cAAc,wBAAwB,CAAC;AACvC,cAAc,wBAAwB,CAAC;AACvC,cAAc,qBAAqB,CAAC;AACpC,cAAc,qBAAqB,CAAC;AACpC,cAAc,qBAAqB,CAAC;AACpC,cAAc,qBAAqB,CAAC;AACpC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,sBAAsB,CAAC;AACrC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,8BAA8B,CAAC;AAC7C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,yCAAyC,CAAC;AACxD,cAAc,yBAAyB,CAAC"}

package/dist/index.js

@@ -16,19 +16,22 @@ export * from "./fs/write-file-atomic.js";
 export * from "./module/import-module.js";
 export * from "./module/optional-import.js";
 export * from "./module/resolve-module.js";
+export * from "./net/connection-closed-error.js";
 export * from "./net/dgram-socket.js";
+export * from "./net/inet-socket.js";
+export * from "./net/ipc-server.js";
 export * from "./net/ipc-socket.js";
+export * from "./net/stream-server.js";
 export * from "./net/stream-socket.js";
 export * from "./net/tcp-server.js";
 export * from "./net/tcp-socket.js";
+export * from "./net/tls-server.js";
 export * from "./net/tls-socket.js";
 export * from "./process/fork-process.js";
 export * from "./process/guarded.js";
 export * from "./process/spawn-process.js";
 export * from "./process/spawned-process.js";
 export * from "./process/start-process.js";
-export * from "./shell/escape-command-arg.js";
-export * from "./shell/escape-command.js";
 export * from "./stream/non-closing-writable-stream.js";
 export * from "./stream/write-async.js";
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,+BAA+B,CAAC;AAC9C,cAAc,iCAAiC,CAAC;AAChD,cAAc,uBAAuB,CAAC;AACtC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,8BAA8B,CAAC;AAC7C,cAAc,+BAA+B,CAAC;AAC9C,cAAc,uBAAuB,CAAC;AACtC,cAAc,yBAAyB,CAAC;AACxC,cAAc,qBAAqB,CAAC;AACpC,cAAc,sBAAsB,CAAC;AACrC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,eAAe,CAAC;AAC9B,cAAc,oBAAoB,CAAC;AACnC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,2BAA2B,CAAC;AAC1C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,uBAAuB,CAAC;AACtC,cAAc,qBAAqB,CAAC;AACpC,cAAc,wBAAwB,CAAC;AACvC,cAAc,qBAAqB,CAAC;AACpC,cAAc,qBAAqB,CAAC;AACpC,cAAc,qBAAqB,CAAC;AACpC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,sBAAsB,CAAC;AACrC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,8BAA8B,CAAC;AAC7C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,+BAA+B,CAAC;AAC9C,cAAc,2BAA2B,CAAC;AAC1C,cAAc,yCAAyC,CAAC;AACxD,cAAc,yBAAyB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,+BAA+B,CAAC;AAC9C,cAAc,iCAAiC,CAAC;AAChD,cAAc,uBAAuB,CAAC;AACtC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,8BAA8B,CAAC;AAC7C,cAAc,+BAA+B,CAAC;AAC9C,cAAc,uBAAuB,CAAC;AACtC,cAAc,yBAAyB,CAAC;AACxC,cAAc,qBAAqB,CAAC;AACpC,cAAc,sBAAsB,CAAC;AACrC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,eAAe,CAAC;AAC9B,cAAc,oBAAoB,CAAC;AACnC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,2BAA2B,CAAC;AAC1C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,kCAAkC,CAAC;AACjD,cAAc,uBAAuB,CAAC;AACtC,cAAc,sBAAsB,CAAC;AACrC,cAAc,qBAAqB,CAAC;AACpC,cAAc,qBAAqB,CAAC;AACpC,cAAc,wBAAwB,CAAC;AACvC,cAAc,wBAAwB,CAAC;AACvC,cAAc,qBAAqB,CAAC;AACpC,cAAc,qBAAqB,CAAC;AACpC,cAAc,qBAAqB,CAAC;AACpC,cAAc,qBAAqB,CAAC;AACpC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,sBAAsB,CAAC;AACrC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,8BAA8B,CAAC;AAC7C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,yCAAyC,CAAC;AACxD,cAAc,yBAAyB,CAAC"}

package/dist/net/connection-closed-error.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Error thrown when a socket closes before the operation awaiting it could
+ * complete.
+ *
+ * Node.js usually reports a failed connection or handshake through an "error"
+ * event, but a peer that drops the transport can close it without one. This
+ * error makes that case observable instead of leaving the caller waiting.
+ */
+export declare class ConnectionClosedError extends Error {
+    constructor(message?: string, options?: ErrorOptions);
+}
+//# sourceMappingURL=connection-closed-error.d.ts.map

package/dist/net/connection-closed-error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"connection-closed-error.d.ts","sourceRoot":"","sources":["../../src/net/connection-closed-error.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,qBAAa,qBAAsB,SAAQ,KAAK;IAC/C,YAAY,OAAO,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,YAAY,EAInD;CACD"}

package/dist/net/connection-closed-error.js

@@ -0,0 +1,15 @@
+/**
+ * Error thrown when a socket closes before the operation awaiting it could
+ * complete.
+ *
+ * Node.js usually reports a failed connection or handshake through an "error"
+ * event, but a peer that drops the transport can close it without one. This
+ * error makes that case observable instead of leaving the caller waiting.
+ */
+export class ConnectionClosedError extends Error {
+    constructor(message, options) {
+        super(message, options);
+        this.name = "ConnectionClosedError";
+    }
+}
+//# sourceMappingURL=connection-closed-error.js.map

package/dist/net/connection-closed-error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"connection-closed-error.js","sourceRoot":"","sources":["../../src/net/connection-closed-error.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,MAAM,OAAO,qBAAsB,SAAQ,KAAK;IAC/C,YAAY,OAAgB,EAAE,OAAsB;QACnD,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QAExB,IAAI,CAAC,IAAI,GAAG,uBAAuB,CAAC;IACrC,CAAC;CACD"}

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

@@ -58,7 +58,7 @@ export interface DgramSocketStat {
  * ```
  */
 export declare class DgramSocket extends EventDispatcherMapBase<DgramSocketEvents> implements IEventDispatcherMap<DgramSocketEvents> {
-    private readonly sock;
+    private readonly socket;
     /** Creates a new `DgramSocket` instance with the specified options. */
     static from(options?: dgram.SocketOptions): DgramSocket;
     private readonly handledErrorEvents;
@@ -66,7 +66,7 @@ export declare class DgramSocket extends EventDispatcherMapBase<DgramSocketEvent
      * Constructs a new `DgramSocket` instance wrapping the provided
      * `dgram.Socket`.
      */
-    constructor(sock: dgram.Socket);
+    constructor(socket: dgram.Socket);
     /**
      * References the socket, preventing the process from exiting while the socket
      * is active.

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

@@ -1 +1 @@
-{"version":3,"file":"dgram-socket.d.ts","sourceRoot":"","sources":["../../src/net/dgram-socket.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,YAAY,CAAC;AAGpC,OAAO,EAAE,sBAAsB,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AAC5E,OAAO,EAAsB,YAAY,EAAE,KAAK,MAAM,EAAE,MAAM,cAAc,CAAC;AAC7E,OAAO,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAIpD,wDAAwD;AACxD,MAAM,MAAM,iBAAiB,GAAG;IAC/B,yCAAyC;IACzC,KAAK,EAAE,EAAE,CAAC;IAEV,0DAA0D;IAC1D,OAAO,EAAE,EAAE,CAAC;IAEZ,oCAAoC;IACpC,KAAK,EAAE,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;IAEvB,wDAAwD;IACxD,SAAS,EAAE,EAAE,CAAC;IAEd;;;;;;OAMG;IACH,OAAO,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,YAAY,CAAC,CAAC;CAC5D,CAAC;AAEF,MAAM,WAAW,eAAe;IAC/B,4DAA4D;IAC5D,cAAc,EAAE,MAAM,CAAC;IAEvB,8DAA8D;IAC9D,aAAa,EAAE,MAAM,CAAC;CACtB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,qBAAa,WACZ,SAAQ,sBAAsB,CAAC,iBAAiB,CAChD,YAAW,mBAAmB,CAAC,iBAAiB,CAAC;IAarC,OAAO,CAAC,QAAQ,CAAC,IAAI;IAXjC,uEAAuE;IACvE,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,KAAK,CAAC,aAAa,GAAG,WAAW,CAEtD;IAED,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAA0B;IAE7D;;;OAGG;IACH,YAA6B,IAAI,EAAE,KAAK,CAAC,MAAM,EAG9C;IAED;;;OAGG;IACH,GAAG,IAAI,IAAI,CAEV;IAED;;;OAGG;IACH,KAAK,IAAI,IAAI,CAEZ;IAED;;;;;;;;OAQG;IACH,YAAY,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI,CAEhC;IAED;;;;;OAKG;IACH,aAAa,CAAC,gBAAgB,EAAE,MAAM,EAAE,kBAAkB,CAAC,EAAE,MAAM,GAAG,IAAI,CAEzE;IAED;;;;;OAKG;IACH,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAEpC;IAED;;;;;OAKG;IACH,iBAAiB,IAAI,MAAM,CAE1B;IAED;;;;;OAKG;IACH,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAEpC;IAED;;;;;OAKG;IACH,iBAAiB,IAAI,MAAM,CAE1B;IAED;;;;;OAKG;IACH,cAAc,CAAC,gBAAgB,EAAE,MAAM,EAAE,kBAAkB,CAAC,EAAE,MAAM,GAAG,IAAI,CAE1E;IAED;;;;;;OAMG;IACH,mBAAmB,CAClB,aAAa,EAAE,MAAM,EACrB,YAAY,EAAE,MAAM,EACpB,kBAAkB,CAAC,EAAE,MAAM,GACzB,IAAI,CAMN;IAED;;;;;;OAMG;IACH,oBAAoB,CACnB,aAAa,EAAE,MAAM,EACrB,YAAY,EAAE,MAAM,EACpB,kBAAkB,CAAC,EAAE,MAAM,GACzB,IAAI,CAMN;IAED;;;;;OAKG;IACH,qBAAqB,CAAC,kBAAkB,EAAE,MAAM,GAAG,IAAI,CAEtD;IAED;;;;;OAKG;IACH,gBAAgB,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI,CAEpC;IAED;;;;;OAKG;IACH,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAEjC;IAED;;;;;OAKG;IACH,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAExB;IAED;;;;;;;OAOG;IACH,OAAO,IAAI,YAAY,GAAG,IAAI,CAoB7B;IAED;;;;;;;;;OASG;IACH,IAAI,CACH,IAAI,GAAE,MAAU,EAChB,OAAO,CAAC,EAAE,MAAM,EAChB,OAAO,CAAC,EAAE,MAAM,CAAC,KAAK,CAAC,WAAW,EAAE,SAAS,GAAG,MAAM,CAAC,GACrD,OAAO,CAAC,IAAI,CAAC,CAyBf;IAED;;;;OAIG;IACH,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAarB;IAED;;;;;OAKG;IACH,OAAO,IAAI,eAAe,CAKzB;IAED;;;;;;;;;;;;;;;;;;;;;;OAsBG;IACH,IAAI,CACH,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,EACf,GAAG,EAAE,MAAM,GAAG,UAAU,GAAG,QAAQ,EACnC,MAAM,CAAC,EAAE,MAAM,EACf,MAAM,CAAC,EAAE,MAAM,GACb,OAAO,CAAC,MAAM,CAAC,CAiBjB;IAED,OAAO,CAAC,oBAAoB;CA6B5B"}
+{"version":3,"file":"dgram-socket.d.ts","sourceRoot":"","sources":["../../src/net/dgram-socket.ts"],"names":[],"mappings":"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"}

package/dist/net/dgram-socket.js

@@ -33,7 +33,7 @@ import { isNodeErrorWithCode } from "../error/node-error.js";
  * ```
  */
 export class DgramSocket extends EventDispatcherMapBase {
-    sock;
+    socket;
     /** Creates a new `DgramSocket` instance with the specified options. */
     static from(options) {
         return new DgramSocket(dgram.createSocket(options || { type: "udp4" }));
@@ -43,9 +43,9 @@ export class DgramSocket extends EventDispatcherMapBase {
      * Constructs a new `DgramSocket` instance wrapping the provided
      * `dgram.Socket`.
      */
-    constructor(sock) {
+    constructor(socket) {
         super();
-        this.sock = sock;
+        this.socket = socket;
         this.setupEventForwarding();
     }
     /**
@@ -53,14 +53,14 @@ export class DgramSocket extends EventDispatcherMapBase {
      * is active.
      */
     ref() {
-        this.sock.ref();
+        this.socket.ref();
     }
     /**
      * Unreferences the socket, allowing the process to exit even if the socket is
      * active.
      */
     unref() {
-        this.sock.unref();
+        this.socket.unref();
     }
     /**
      * Enables or disables sending of broadcast datagrams.
@@ -72,7 +72,7 @@ export class DgramSocket extends EventDispatcherMapBase {
      * @param flag Whether broadcast should be enabled.
      */
     setBroadcast(flag) {
-        this.sock.setBroadcast(flag);
+        this.socket.setBroadcast(flag);
     }
     /**
      * Adds this socket to the given multicast group.
@@ -81,7 +81,7 @@ export class DgramSocket extends EventDispatcherMapBase {
      * configures `IP_ADD_MEMBERSHIP` for the given multicast group.
      */
     addMembership(multicastAddress, multicastInterface) {
-        this.sock.addMembership(multicastAddress, multicastInterface);
+        this.socket.addMembership(multicastAddress, multicastInterface);
     }
     /**
      * Sets the size in bytes of the underlying receive buffer.
@@ -90,7 +90,7 @@ export class DgramSocket extends EventDispatcherMapBase {
      * sets the `SO_RCVBUF` socket option.
      */
     setRecvBufferSize(size) {
-        this.sock.setRecvBufferSize(size);
+        this.socket.setRecvBufferSize(size);
     }
     /**
      * Returns the size in bytes of the underlying receive buffer.
@@ -99,7 +99,7 @@ export class DgramSocket extends EventDispatcherMapBase {
      * reads the `SO_RCVBUF` socket option.
      */
     getRecvBufferSize() {
-        return this.sock.getRecvBufferSize();
+        return this.socket.getRecvBufferSize();
     }
     /**
      * Sets the size in bytes of the underlying send buffer.
@@ -108,7 +108,7 @@ export class DgramSocket extends EventDispatcherMapBase {
      * sets the `SO_SNDBUF` socket option.
      */
     setSendBufferSize(size) {
-        this.sock.setSendBufferSize(size);
+        this.socket.setSendBufferSize(size);
     }
     /**
      * Returns the size in bytes of the underlying send buffer.
@@ -117,7 +117,7 @@ export class DgramSocket extends EventDispatcherMapBase {
      * reads the `SO_SNDBUF` socket option.
      */
     getSendBufferSize() {
-        return this.sock.getSendBufferSize();
+        return this.socket.getSendBufferSize();
     }
     /**
      * Removes this socket from the given multicast group.
@@ -126,7 +126,7 @@ export class DgramSocket extends EventDispatcherMapBase {
      * configures `IP_DROP_MEMBERSHIP` for the given multicast group.
      */
     dropMembership(multicastAddress, multicastInterface) {
-        this.sock.dropMembership(multicastAddress, multicastInterface);
+        this.socket.dropMembership(multicastAddress, multicastInterface);
     }
     /**
      * Adds this socket to a source-specific multicast group.
@@ -136,7 +136,7 @@ export class DgramSocket extends EventDispatcherMapBase {
      * source-specific multicast membership for the given source and group.
      */
     addSourceMembership(sourceAddress, groupAddress, multicastInterface) {
-        this.sock.addSourceSpecificMembership(sourceAddress, groupAddress, multicastInterface);
+        this.socket.addSourceSpecificMembership(sourceAddress, groupAddress, multicastInterface);
     }
     /**
      * Removes this socket from a source-specific multicast group.
@@ -146,7 +146,7 @@ export class DgramSocket extends EventDispatcherMapBase {
      * multicast membership for the given source and group.
      */
     dropSourceMembership(sourceAddress, groupAddress, multicastInterface) {
-        this.sock.dropSourceSpecificMembership(sourceAddress, groupAddress, multicastInterface);
+        this.socket.dropSourceSpecificMembership(sourceAddress, groupAddress, multicastInterface);
     }
     /**
      * Sets the outbound multicast interface.
@@ -155,7 +155,7 @@ export class DgramSocket extends EventDispatcherMapBase {
      * which controls the default outgoing interface for multicast traffic.
      */
     setMulticastInterface(multicastInterface) {
-        this.sock.setMulticastInterface(multicastInterface);
+        this.socket.setMulticastInterface(multicastInterface);
     }
     /**
      * Enables or disables loopback for multicast packets sent from this socket.
@@ -164,7 +164,7 @@ export class DgramSocket extends EventDispatcherMapBase {
      * which toggles the `IP_MULTICAST_LOOP` socket option.
      */
     setMulticastLoop(flag) {
-        this.sock.setMulticastLoopback(flag);
+        this.socket.setMulticastLoopback(flag);
     }
     /**
      * Sets the time-to-live (TTL) value for multicast packets.
@@ -173,7 +173,7 @@ export class DgramSocket extends EventDispatcherMapBase {
      * configures the `IP_MULTICAST_TTL` socket option.
      */
     setMulticastTtl(ttl) {
-        this.sock.setMulticastTTL(ttl);
+        this.socket.setMulticastTTL(ttl);
     }
     /**
      * Sets the unicast time-to-live (TTL) value for outgoing packets.
@@ -182,7 +182,7 @@ export class DgramSocket extends EventDispatcherMapBase {
      * the `IP_TTL` socket option.
      */
     setTtl(ttl) {
-        this.sock.setTTL(ttl);
+        this.socket.setTTL(ttl);
     }
     /**
      * Gets the address information of the bound socket.
@@ -195,7 +195,7 @@ export class DgramSocket extends EventDispatcherMapBase {
     address() {
         let addr;
         try {
-            addr = this.sock.address();
+            addr = this.socket.address();
         }
         catch (error) {
             // dgram throws "Not running" error when socket is not bound/closed
@@ -226,19 +226,19 @@ export class DgramSocket extends EventDispatcherMapBase {
                 this.handledErrorEvents.add(error);
                 reject(error);
             };
-            this.sock.prependOnceListener("error", handleError);
+            this.socket.prependOnceListener("error", handleError);
             try {
-                this.sock.bind({
+                this.socket.bind({
                     ...options,
                     address,
                     port,
                 }, () => {
-                    this.sock.removeListener("error", handleError);
+                    this.socket.removeListener("error", handleError);
                     resolve();
                 });
             }
             catch (error) {
-                this.sock.removeListener("error", handleError);
+                this.socket.removeListener("error", handleError);
                 reject(error);
             }
         });
@@ -254,9 +254,9 @@ export class DgramSocket extends EventDispatcherMapBase {
                 this.handledErrorEvents.add(error);
                 reject(error);
             };
-            this.sock.prependOnceListener("error", handleError);
-            this.sock.close(() => {
-                this.sock.removeListener("error", handleError);
+            this.socket.prependOnceListener("error", handleError);
+            this.socket.close(() => {
+                this.socket.removeListener("error", handleError);
                 resolve();
             });
         });
@@ -269,8 +269,8 @@ export class DgramSocket extends EventDispatcherMapBase {
      */
     getStat() {
         return {
-            sendQueueCount: this.sock.getSendQueueCount(),
-            sendQueueSize: this.sock.getSendQueueSize(),
+            sendQueueCount: this.socket.getSendQueueCount(),
+            sendQueueSize: this.socket.getSendQueueSize(),
         };
     }
     /**
@@ -306,30 +306,30 @@ export class DgramSocket extends EventDispatcherMapBase {
                 resolve(bytes);
             };
             if (offset === undefined || length === undefined) {
-                this.sock.send(msg, port, address, callback);
+                this.socket.send(msg, port, address, callback);
                 return;
             }
-            this.sock.send(msg, offset, length, port, address, callback);
+            this.socket.send(msg, offset, length, port, address, callback);
         });
     }
     setupEventForwarding() {
-        this.sock.on("close", () => {
+        this.socket.on("close", () => {
             this.dispatch("close", []);
         });
-        this.sock.on("connect", () => {
+        this.socket.on("connect", () => {
             this.dispatch("connect", []);
         });
-        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("listening", () => {
+        this.socket.on("listening", () => {
             this.dispatch("listening", []);
         });
-        this.sock.on("message", (msg, rinfo) => {
+        this.socket.on("message", (msg, rinfo) => {
             const from = {
                 ...composeInetAddress(rinfo.family, rinfo.address),
                 port: rinfo.port,

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

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

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

@@ -0,0 +1,64 @@
+import * as net from "node:net";
+import { type InetAddress, type InetEndpoint } from "@ac-kit/core";
+import { StreamSocket, type StreamSocketEvents } from "./stream-socket.js";
+/** Event map for sockets running over an IP transport. */
+export type InetSocketEvents = StreamSocketEvents & {
+    /**
+     * Emitted when a new connection attempt is started. May be emitted multiple
+     * times if family autoselection is enabled.
+     */
+    connectionAttempt: [endpoint: InetEndpoint];
+    /**
+     * Emitted when a connection attempt failed. May be emitted multiple times if
+     * family autoselection is enabled.
+     */
+    connectionAttemptFailed: [endpoint: InetEndpoint, error: Error];
+    /**
+     * Emitted when a connection attempt timed out. May be emitted multiple times
+     * if family autoselection is enabled.
+     */
+    connectionAttemptTimeout: [endpoint: InetEndpoint];
+    /** Emitted after resolving the host name but before connecting. */
+    lookup: [error: Error | null, address: InetAddress, host: string];
+};
+/**
+ * Base class for sockets whose transport is an IP connection.
+ *
+ * On top of {@link StreamSocket} it exposes the endpoint accessors and the
+ * socket options that only make sense over IP, plus the connection-attempt and
+ * name-resolution events Node.js emits while dialling.
+ *
+ * It is shared by {@link TcpSocket} and {@link TlsSocket}: both run over IP, but
+ * they establish their connection differently, so neither can be expressed as a
+ * subclass of the other.
+ */
+export declare class InetSocket<TSocket extends net.Socket = net.Socket, TEvents extends InetSocketEvents = InetSocketEvents> extends StreamSocket<TSocket, TEvents> {
+    /**
+     * Remote endpoint of the socket, or `null` while it is not connected.
+     *
+     * @throws {UnsupportedError} If the socket family is not IPv4 or IPv6.
+     */
+    get remoteEndpoint(): InetEndpoint | null;
+    /**
+     * Local endpoint of the socket, or `null` while it is not connected.
+     *
+     * @throws {UnsupportedError} If the socket family is not IPv4 or IPv6.
+     */
+    get localEndpoint(): InetEndpoint | null;
+    /**
+     * Sets the keep-alive option for the socket.
+     *
+     * @param enable Whether to enable keep-alive.
+     * @param initialDelay The initial delay in milliseconds before the first
+     *   keep-alive probe.
+     */
+    setKeepAlive(enable: boolean, initialDelay?: number): void;
+    /**
+     * Enables or disables the Nagle algorithm for the socket.
+     *
+     * @param noDelay Whether to disable the Nagle algorithm.
+     */
+    setNoDelay(noDelay: boolean): void;
+    protected setupEventForwarding(): void;
+}
+//# sourceMappingURL=inet-socket.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"inet-socket.d.ts","sourceRoot":"","sources":["../../src/net/inet-socket.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,GAAG,MAAM,UAAU,CAAC;AAEhC,OAAO,EAEN,KAAK,WAAW,EAChB,KAAK,YAAY,EACjB,MAAM,cAAc,CAAC;AAEtB,OAAO,EAAE,YAAY,EAAE,KAAK,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAE3E,0DAA0D;AAC1D,MAAM,MAAM,gBAAgB,GAAG,kBAAkB,GAAG;IACnD;;;OAGG;IACH,iBAAiB,EAAE,CAAC,QAAQ,EAAE,YAAY,CAAC,CAAC;IAE5C;;;OAGG;IACH,uBAAuB,EAAE,CAAC,QAAQ,EAAE,YAAY,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC;IAEhE;;;OAGG;IACH,wBAAwB,EAAE,CAAC,QAAQ,EAAE,YAAY,CAAC,CAAC;IAEnD,mEAAmE;IACnE,MAAM,EAAE,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI,EAAE,OAAO,EAAE,WAAW,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC;CAClE,CAAC;AAEF;;;;;;;;;;GAUG;AACH,qBAAa,UAAU,CACtB,OAAO,SAAS,GAAG,CAAC,MAAM,GAAG,GAAG,CAAC,MAAM,EACvC,OAAO,SAAS,gBAAgB,GAAG,gBAAgB,CAClD,SAAQ,YAAY,CAAC,OAAO,EAAE,OAAO,CAAC;IACvC;;;;OAIG;IACH,IAAI,cAAc,IAAI,YAAY,GAAG,IAAI,CAaxC;IAED;;;;OAIG;IACH,IAAI,aAAa,IAAI,YAAY,GAAG,IAAI,CAavC;IAED;;;;;;OAMG;IACH,YAAY,CAAC,MAAM,EAAE,OAAO,EAAE,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAEzD;IAED;;;;OAIG;IACH,UAAU,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAEjC;IAED,UAAmB,oBAAoB,IAAI,IAAI,CAsC9C;CACD"}

package/dist/net/inet-socket.js

@@ -0,0 +1,103 @@
+import { composeInetAddress, } from "@ac-kit/core";
+import { StreamSocket } from "./stream-socket.js";
+/**
+ * Base class for sockets whose transport is an IP connection.
+ *
+ * On top of {@link StreamSocket} it exposes the endpoint accessors and the
+ * socket options that only make sense over IP, plus the connection-attempt and
+ * name-resolution events Node.js emits while dialling.
+ *
+ * It is shared by {@link TcpSocket} and {@link TlsSocket}: both run over IP, but
+ * they establish their connection differently, so neither can be expressed as a
+ * subclass of the other.
+ */
+export class InetSocket extends StreamSocket {
+    /**
+     * Remote endpoint of the socket, or `null` while it is not connected.
+     *
+     * @throws {UnsupportedError} If the socket family is not IPv4 or IPv6.
+     */
+    get remoteEndpoint() {
+        const address = this.socket.remoteAddress;
+        const port = this.socket.remotePort;
+        const family = this.socket.remoteFamily;
+        if (address === undefined || port === undefined || family === undefined) {
+            return null;
+        }
+        return {
+            ...composeInetAddress(family, address),
+            port,
+        };
+    }
+    /**
+     * Local endpoint of the socket, or `null` while it is not connected.
+     *
+     * @throws {UnsupportedError} If the socket family is not IPv4 or IPv6.
+     */
+    get localEndpoint() {
+        const address = this.socket.localAddress;
+        const port = this.socket.localPort;
+        const family = this.socket.localFamily;
+        if (address === undefined || port === undefined || family === undefined) {
+            return null;
+        }
+        return {
+            ...composeInetAddress(family, address),
+            port,
+        };
+    }
+    /**
+     * Sets the keep-alive option for the socket.
+     *
+     * @param enable Whether to enable keep-alive.
+     * @param initialDelay The initial delay in milliseconds before the first
+     *   keep-alive probe.
+     */
+    setKeepAlive(enable, initialDelay) {
+        this.socket.setKeepAlive(enable, initialDelay);
+    }
+    /**
+     * Enables or disables the Nagle algorithm for the socket.
+     *
+     * @param noDelay Whether to disable the Nagle algorithm.
+     */
+    setNoDelay(noDelay) {
+        this.socket.setNoDelay(noDelay);
+    }
+    setupEventForwarding() {
+        super.setupEventForwarding();
+        this.socket.on("connectionAttempt", (ip, port, family) => {
+            this.dispatch("connectionAttempt", [
+                {
+                    ...composeInetAddress(family, ip),
+                    port,
+                },
+            ]);
+        });
+        this.socket.on("connectionAttemptFailed", (ip, port, family, error) => {
+            this.dispatch("connectionAttemptFailed", [
+                {
+                    ...composeInetAddress(family, ip),
+                    port,
+                },
+                error,
+            ]);
+        });
+        this.socket.on("connectionAttemptTimeout", (ip, port, family) => {
+            this.dispatch("connectionAttemptTimeout", [
+                {
+                    ...composeInetAddress(family, ip),
+                    port,
+                },
+            ]);
+        });
+        this.socket.on("lookup", (error, address, family, host) => {
+            this.dispatch("lookup", [
+                error,
+                composeInetAddress(family, address),
+                host,
+            ]);
+        });
+    }
+}
+//# sourceMappingURL=inet-socket.js.map