net-socket-address 0.0.1 → 0.1.0

package/LICENSE

@@ -1,21 +1,21 @@
-MIT License
-
-Copyright (c) 2026 Luolapeikko
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
+MIT License
+
+Copyright (c) 2026 Luolapeikko
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -13,9 +13,9 @@ npm i net-socket-address net-address @luolapeikko/result-option
 ```typescript
 const socketAddr = new SocketAddrV4({port: 6372});
 // or new SocketAddrV4({addr: Ipv4Addr.UNSPECIFIED, port: 6372});
-tcpServer.listen(socketAddr..asNodeListenerOptions(), () => {});
-udpSocket.bind(socketAddr, () => {});
-tcpServer.listen({...socketAddr.asNodeListenerOptions(), ipv6Only: true}, () => {});
+tcpServer.listen(socketAddr.asNodeListener(), () => {});
+udpSocket.bind(socketAddr.asNodeBind(), () => {});
+tcpServer.listen({...socketAddr.asNodeListener(), ipv6Only: true}, () => {});
 ```
 
 ## Full [Documentation](https://luolapeikko.github.io/net-address-base/)

package/dist/index.cjs

@@ -1,2 +1,2 @@
-Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});let e=require(`net-address`);var t=class{#e;port;address;family=`ipv4`;constructor({addr:t,port:n}){this.#e=t??e.Ipv4Addr.UNSPECIFIED,this.port=n,this.address=this.#e.toString()}asNodeListenerOptions(){return{port:this.port,host:this.address}}getRawAddress(){return this.#e}toString(){return`${this.address}:${this.port}`}},n=class{#e;port;family=`ipv6`;address;flowlabel;constructor({address:t,port:n,flowlabel:r}){this.#e=t??e.Ipv6Addr.UNSPECIFIED,this.port=n,this.flowlabel=r,this.address=this.#e.toString()}asNodeListenerOptions(){return{port:this.port,host:this.address}}getRawAddress(){return this.#e}toString(){return`${this.address}:${this.port}`}};exports.SocketAddrV4=t,exports.SocketAddrV6=n;
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});let e=require("net-address");var t=class{port;address;family=`ipv4`;constructor({addr:t,port:n}){this.address=t??e.Ipv4Addr.UNSPECIFIED,this.port=n}asNodeListener(){return{port:this.port,host:this.address.toString()}}asNodeBind(){return{port:this.port,address:this.address.toString()}}toString(){return`${this.address.toString()}:${this.port}`}},n=class{port;family=`ipv6`;address;flowlabel;constructor({address:t,port:n,flowlabel:r}){this.address=t??e.Ipv6Addr.UNSPECIFIED,this.port=n,this.flowlabel=r}asNodeListener(){return{port:this.port,host:this.address.toString()}}asNodeBind(){return{port:this.port,address:this.address.toString()}}toString(){return`[${this.address.toString()}]:${this.port}`}};exports.SocketAddrV4=t,exports.SocketAddrV6=n;
 //# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.cjs","names":["#addr","Ipv4Addr","#addr","Ipv6Addr"],"sources":["../src/SocketAddrV4.ts","../src/SocketAddrV6.ts"],"sourcesContent":["import {Ipv4Addr} from 'net-address';\n\n/**\n * Represents an IPv4 socket address, consisting of an IPv4 address and a port number.\n * @example\n * const socketAddr = new SocketAddrV4({port: 6372}); // new SocketAddrV4({addr: Ipv4Addr.UNSPECIFIED, port: 6372});\n * tcpServer.listen(socketAddr.asNodeListenerOptions(), () => {});\n * udpSocket.bind(socketAddr, () => {});\n * tcpServer.listen({...socketAddr.asNodeListenerOptions(), ipv6Only: true}, () => {});\n * @since v0.0.1\n */\nexport class SocketAddrV4 {\n\t#addr: Ipv4Addr;\n\tpublic readonly port: number;\n\tpublic readonly address: string;\n\tpublic readonly family = 'ipv4';\n\t/**\n\t * Creates a new `SocketAddrV4` instance.\n\t * @param options - The options for creating the socket address.\n\t * @param options.addr - The IPv4 address. Defaults to {@link Ipv4Addr.UNSPECIFIED}.\n\t * @param options.port - The port number.\n\t */\n\tpublic constructor({addr, port}: {addr?: Ipv4Addr; port: number}) {\n\t\tthis.#addr = addr ?? Ipv4Addr.UNSPECIFIED;\n\t\tthis.port = port;\n\t\tthis.address = this.#addr.toString();\n\t}\n\n\t/**\n\t * Returns an object suitable for use as options in Node.js `net.Server.listen()` method.\n\t * @returns An object containing the `port` and `host` properties.\n\t * @since v0.0.1\n\t */\n\tpublic asNodeListenerOptions(): {port: number; host: string} {\n\t\treturn {\n\t\t\tport: this.port,\n\t\t\thost: this.address,\n\t\t};\n\t}\n\n\t/**\n\t * Gets the raw `Ipv4Addr` instance representing the IP address of this socket address.\n\t * @returns Ipv4Addr instance of the socket address's IP address.\n\t * @since v0.0.1\n\t */\n\tpublic getRawAddress(): Ipv4Addr {\n\t\treturn this.#addr;\n\t}\n\n\t/**\n\t * Returns a string representation of this socket address.\n\t * @returns The string representation in the format \"address:port\".\n\t * @since v0.0.1\n\t */\n\tpublic toString(): string {\n\t\treturn `${this.address}:${this.port}`;\n\t}\n}\n","import {Ipv6Addr} from 'net-address';\n\n/**\n * Represents an IPv6 socket address, consisting of an IPv6 address, a port number, and an optional flow label.\n * @example\n * const anySocketAddress = new SocketAddrV6(6372); // new SocketAddrV6(Ipv6Addr.UNSPECIFIED, 6372);\n * tcpServer.listen(anySocketAddress.asNodeListenerOptions(), () => {});\n * udpSocket.bind(anySocketAddress, () => {});\n * @since v0.0.1\n */\nexport class SocketAddrV6 {\n\t#addr: Ipv6Addr;\n\tpublic readonly port: number;\n\tpublic readonly family = 'ipv6';\n\tpublic readonly address: string;\n\tpublic flowlabel?: number;\n\n\t/**\n\t * Creates a new `SocketAddrV6` instance.\n\t * @param options - The options for creating the socket address.\n\t * @param options.address - The IPv6 address. Defaults to {@link Ipv6Addr.UNSPECIFIED}.\n\t * @param options.port - The port number.\n\t * @param options.flowlabel - The flow label.\n\t */\n\tpublic constructor({address, port, flowlabel}: {address?: Ipv6Addr; port: number; flowlabel?: number}) {\n\t\tthis.#addr = address ?? Ipv6Addr.UNSPECIFIED;\n\t\tthis.port = port;\n\t\tthis.flowlabel = flowlabel;\n\t\tthis.address = this.#addr.toString();\n\t}\n\n\t/**\n\t * Returns an object suitable for use as options in Node.js `net.Server.listen()` method.\n\t * @returns An object containing the `port` and `host` properties.\n\t * @since v0.0.1\n\t */\n\tpublic asNodeListenerOptions(): {port: number; host: string} {\n\t\treturn {\n\t\t\tport: this.port,\n\t\t\thost: this.address,\n\t\t};\n\t}\n\n\t/**\n\t * Gets the raw `Ipv6Addr` instance representing the IP address of this socket address.\n\t * @returns Ipv6Addr instance of the socket address's IP address.\n\t * @since v0.0.1\n\t */\n\tpublic getRawAddress(): Ipv6Addr {\n\t\treturn this.#addr;\n\t}\n\n\t/**\n\t * Returns a string representation of this socket address.\n\t * @returns The string representation in the format \"address:port\".\n\t * @since v0.0.1\n\t */\n\tpublic toString(): string {\n\t\treturn `${this.address}:${this.port}`;\n\t}\n}\n"],"mappings":"gGAWA,IAAa,EAAb,KAA0B,CACzB,GACA,KACA,QACA,OAAyB,OAOzB,YAAmB,CAAC,OAAM,QAAwC,CACjE,MAAA,EAAa,GAAQC,EAAAA,SAAS,YAC9B,KAAK,KAAO,EACZ,KAAK,QAAU,MAAA,EAAW,UAAU,CAQrC,uBAA6D,CAC5D,MAAO,CACN,KAAM,KAAK,KACX,KAAM,KAAK,QACX,CAQF,eAAiC,CAChC,OAAO,MAAA,EAQR,UAA0B,CACzB,MAAO,GAAG,KAAK,QAAQ,GAAG,KAAK,SC7CpB,EAAb,KAA0B,CACzB,GACA,KACA,OAAyB,OACzB,QACA,UASA,YAAmB,CAAC,UAAS,OAAM,aAAoE,CACtG,MAAA,EAAa,GAAWE,EAAAA,SAAS,YACjC,KAAK,KAAO,EACZ,KAAK,UAAY,EACjB,KAAK,QAAU,MAAA,EAAW,UAAU,CAQrC,uBAA6D,CAC5D,MAAO,CACN,KAAM,KAAK,KACX,KAAM,KAAK,QACX,CAQF,eAAiC,CAChC,OAAO,MAAA,EAQR,UAA0B,CACzB,MAAO,GAAG,KAAK,QAAQ,GAAG,KAAK"}
+{"version":3,"file":"index.cjs","names":["Ipv4Addr","Ipv6Addr"],"sources":["../src/SocketAddrV4.ts","../src/SocketAddrV6.ts"],"sourcesContent":["import {Ipv4Addr} from 'net-address';\n\n/**\n * Represents an IPv4 socket address, consisting of an IPv4 address and a port number.\n * @example\n * const socketAddr = new SocketAddrV4({port: 6372}); // new SocketAddrV4({addr: Ipv4Addr.UNSPECIFIED, port: 6372});\n * tcpServer.listen(socketAddr.asNodeListenerOptions(), () => {});\n * udpSocket.bind(socketAddr.asNodeBindOptions(), () => {});\n * tcpServer.listen({...socketAddr.asNodeListenerOptions(), ipv6Only: true}, () => {});\n * @since v0.0.1\n */\nexport class SocketAddrV4 {\n\tpublic readonly port: number;\n\tpublic readonly address: Ipv4Addr;\n\tpublic readonly family = 'ipv4';\n\t/**\n\t * Creates a new `SocketAddrV4` instance.\n\t * @param options - The options for creating the socket address.\n\t * @param options.addr - The IPv4 address. Defaults to {@link Ipv4Addr.UNSPECIFIED}.\n\t * @param options.port - The port number.\n\t */\n\tpublic constructor({addr, port}: {addr?: Ipv4Addr; port: number}) {\n\t\tthis.address = addr ?? Ipv4Addr.UNSPECIFIED;\n\t\tthis.port = port;\n\t}\n\n\t/**\n\t * Returns an object suitable for use as options in Node.js `net.Server.listen()` method.\n\t * @returns An object containing the `port` and `host` properties.\n\t * @since v0.0.1\n\t */\n\tpublic asNodeListener(): {port: number; host: string} {\n\t\treturn {\n\t\t\tport: this.port,\n\t\t\thost: this.address.toString(),\n\t\t};\n\t}\n\n\t/**\n\t * Returns an object suitable for use as options in Node.js `dgram.Socket.bind()` method.\n\t * @returns An object containing the `port` and `address` properties.\n\t * @since v0.1.0\n\t */\n\tpublic asNodeBind(): {port: number; address: string} {\n\t\treturn {\n\t\t\tport: this.port,\n\t\t\taddress: this.address.toString(),\n\t\t};\n\t}\n\n\t/**\n\t * Returns a string representation of this socket address.\n\t * @returns The string representation in the format \"address:port\".\n\t * @since v0.0.1\n\t */\n\tpublic toString(): string {\n\t\treturn `${this.address.toString()}:${this.port}`;\n\t}\n}\n","import {Ipv6Addr} from 'net-address';\n\n/**\n * Represents an IPv6 socket address, consisting of an IPv6 address, a port number, and an optional flow label.\n * @example\n * const anySocketAddress = new SocketAddrV6(6372); // new SocketAddrV6(Ipv6Addr.UNSPECIFIED, 6372);\n * tcpServer.listen(anySocketAddress.asNodeListenerOptions(), () => {});\n * udpSocket.bind(anySocketAddress, () => {});\n * @since v0.0.1\n */\nexport class SocketAddrV6 {\n\tpublic readonly port: number;\n\tpublic readonly family = 'ipv6';\n\tpublic readonly address: Ipv6Addr;\n\tpublic flowlabel?: number;\n\n\t/**\n\t * Creates a new `SocketAddrV6` instance.\n\t * @param options - The options for creating the socket address.\n\t * @param options.address - The IPv6 address. Defaults to {@link Ipv6Addr.UNSPECIFIED}.\n\t * @param options.port - The port number.\n\t * @param options.flowlabel - The flow label.\n\t */\n\tpublic constructor({address, port, flowlabel}: {address?: Ipv6Addr; port: number; flowlabel?: number}) {\n\t\tthis.address = address ?? Ipv6Addr.UNSPECIFIED;\n\t\tthis.port = port;\n\t\tthis.flowlabel = flowlabel;\n\t}\n\n\t/**\n\t * Returns an object suitable for use as options in Node.js `net.Server.listen()` method.\n\t * @returns An object containing the `port` and `host` properties.\n\t * @since v0.0.1\n\t */\n\tpublic asNodeListener(): {port: number; host: string} {\n\t\treturn {\n\t\t\tport: this.port,\n\t\t\thost: this.address.toString(),\n\t\t};\n\t}\n\n\t/**\n\t * Returns an object suitable for use as options in Node.js `dgram.Socket.bind()` method.\n\t * @returns An object containing the `port` and `address` properties.\n\t * @since v0.1.0\n\t */\n\tpublic asNodeBind(): {port: number; address: string} {\n\t\treturn {\n\t\t\tport: this.port,\n\t\t\taddress: this.address.toString(),\n\t\t};\n\t}\n\n\t/**\n\t * Returns a string representation of this socket address.\n\t * @returns The string representation in the format \"[address]:port\".\n\t * @since v0.0.1\n\t */\n\tpublic toString(): string {\n\t\treturn `[${this.address.toString()}]:${this.port}`;\n\t}\n}\n"],"mappings":"gGAWA,IAAa,EAAb,KAA0B,CACzB,KACA,QACA,OAAyB,OAOzB,YAAmB,CAAC,OAAM,QAAwC,CACjE,KAAK,QAAU,GAAQA,EAAAA,SAAS,YAChC,KAAK,KAAO,CACb,CAOA,gBAAsD,CACrD,MAAO,CACN,KAAM,KAAK,KACX,KAAM,KAAK,QAAQ,SAAS,CAC7B,CACD,CAOA,YAAqD,CACpD,MAAO,CACN,KAAM,KAAK,KACX,QAAS,KAAK,QAAQ,SAAS,CAChC,CACD,CAOA,UAA0B,CACzB,MAAO,GAAG,KAAK,QAAQ,SAAS,EAAE,GAAG,KAAK,MAC3C,CACD,EChDa,EAAb,KAA0B,CACzB,KACA,OAAyB,OACzB,QACA,UASA,YAAmB,CAAC,UAAS,OAAM,aAAoE,CACtG,KAAK,QAAU,GAAWC,EAAAA,SAAS,YACnC,KAAK,KAAO,EACZ,KAAK,UAAY,CAClB,CAOA,gBAAsD,CACrD,MAAO,CACN,KAAM,KAAK,KACX,KAAM,KAAK,QAAQ,SAAS,CAC7B,CACD,CAOA,YAAqD,CACpD,MAAO,CACN,KAAM,KAAK,KACX,QAAS,KAAK,QAAQ,SAAS,CAChC,CACD,CAOA,UAA0B,CACzB,MAAO,IAAI,KAAK,QAAQ,SAAS,EAAE,IAAI,KAAK,MAC7C,CACD"}

package/dist/index.d.cts

@@ -6,14 +6,13 @@ import { Ipv4Addr, Ipv6Addr } from "net-address";
 * @example
 * const socketAddr = new SocketAddrV4({port: 6372}); // new SocketAddrV4({addr: Ipv4Addr.UNSPECIFIED, port: 6372});
 * tcpServer.listen(socketAddr.asNodeListenerOptions(), () => {});
-* udpSocket.bind(socketAddr, () => {});
+* udpSocket.bind(socketAddr.asNodeBindOptions(), () => {});
 * tcpServer.listen({...socketAddr.asNodeListenerOptions(), ipv6Only: true}, () => {});
 * @since v0.0.1
 */
 declare class SocketAddrV4 {
-  #private;
   readonly port: number;
-  readonly address: string;
+  readonly address: Ipv4Addr;
   readonly family = "ipv4";
   /**
   * Creates a new `SocketAddrV4` instance.
@@ -33,16 +32,19 @@ declare class SocketAddrV4 {
   * @returns An object containing the `port` and `host` properties.
   * @since v0.0.1
   */
-  asNodeListenerOptions(): {
+  asNodeListener(): {
     port: number;
     host: string;
   };
   /**
-  * Gets the raw `Ipv4Addr` instance representing the IP address of this socket address.
-  * @returns Ipv4Addr instance of the socket address's IP address.
-  * @since v0.0.1
+  * Returns an object suitable for use as options in Node.js `dgram.Socket.bind()` method.
+  * @returns An object containing the `port` and `address` properties.
+  * @since v0.1.0
   */
-  getRawAddress(): Ipv4Addr;
+  asNodeBind(): {
+    port: number;
+    address: string;
+  };
   /**
   * Returns a string representation of this socket address.
   * @returns The string representation in the format "address:port".
@@ -61,10 +63,9 @@ declare class SocketAddrV4 {
 * @since v0.0.1
 */
 declare class SocketAddrV6 {
-  #private;
   readonly port: number;
   readonly family = "ipv6";
-  readonly address: string;
+  readonly address: Ipv6Addr;
   flowlabel?: number;
   /**
   * Creates a new `SocketAddrV6` instance.
@@ -87,19 +88,22 @@ declare class SocketAddrV6 {
   * @returns An object containing the `port` and `host` properties.
   * @since v0.0.1
   */
-  asNodeListenerOptions(): {
+  asNodeListener(): {
     port: number;
     host: string;
   };
   /**
-  * Gets the raw `Ipv6Addr` instance representing the IP address of this socket address.
-  * @returns Ipv6Addr instance of the socket address's IP address.
-  * @since v0.0.1
+  * Returns an object suitable for use as options in Node.js `dgram.Socket.bind()` method.
+  * @returns An object containing the `port` and `address` properties.
+  * @since v0.1.0
   */
-  getRawAddress(): Ipv6Addr;
+  asNodeBind(): {
+    port: number;
+    address: string;
+  };
   /**
   * Returns a string representation of this socket address.
-  * @returns The string representation in the format "address:port".
+  * @returns The string representation in the format "[address]:port".
   * @since v0.0.1
   */
   toString(): string;

package/dist/index.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.cts","names":[],"sources":["../src/SocketAddrV4.ts","../src/SocketAddrV6.ts"],"mappings":";;;;;AAWA;;;;;;;cAAa,YAAA;EAAA;WAEI,IAAA;EAAA,SACA,OAAA;EAAA,SACA,MAAA;;;;;;;EAOhB,WAAA,CAAA;IAAoB,IAAA;IAAM;EAAA;IAAQ,IAAA,GAAO,QAAA;IAAU,IAAA;EAAA;;;;;;EAWnD,qBAAA,CAAA;IAAiC,IAAA;IAAc,IAAA;EAAA;;ACvBhD;;;;EDmCC,aAAA,CAAA,GAAwB,QAAA;;;;;;EASxB,QAAA,CAAA;AAAA;;;;;AA3CD;;;;;;cCDa,YAAA;EAAA;WAEI,IAAA;EAAA,SACA,MAAA;EAAA,SACA,OAAA;EAChB,SAAA;;;;;;;;EASA,WAAA,CAAA;IAAoB,OAAA;IAAS,IAAA;IAAM;EAAA;IAAa,OAAA,GAAU,QAAA;IAAU,IAAA;IAAc,SAAA;EAAA;;;;;;EAYlF,qBAAA,CAAA;IAAiC,IAAA;IAAc,IAAA;EAAA;EA1BnC;;;;;EAsCZ,aAAA,CAAA,GAAwB,QAAA;;;;;;EASxB,QAAA,CAAA;AAAA"}
+{"version":3,"file":"index.d.cts","names":[],"sources":["../src/SocketAddrV4.ts","../src/SocketAddrV6.ts"],"mappings":";;;;;AAWA;;;;;;;cAAa,YAAA;EAAA,SACI,IAAA;EAAA,SACA,OAAA,EAAS,QAAA;EAAA,SACT,MAAA;;;;;;;EAOhB,WAAA;IAAoB,IAAA;IAAM;EAAA;IAAQ,IAAA,GAAO,QAAA;IAAU,IAAA;EAAA;;;;;;EAUnD,cAAA;IAA0B,IAAA;IAAc,IAAA;EAAA;;;;ACrBzC;;EDiCC,UAAA;IAAsB,IAAA;IAAc,OAAA;EAAA;;;;;;EAYpC,QAAA;AAAA;;;;;AA5CD;;;;;;cCDa,YAAA;EAAA,SACI,IAAA;EAAA,SACA,MAAA;EAAA,SACA,OAAA,EAAS,QAAA;EACzB,SAAA;;;;;;;;EASA,WAAA;IAAoB,OAAA;IAAS,IAAA;IAAM;EAAA;IAAa,OAAA,GAAU,QAAA;IAAU,IAAA;IAAc,SAAA;EAAA;;;;;;EAWlF,cAAA;IAA0B,IAAA;IAAc,IAAA;EAAA;;AAxBzC;;;;EAoCC,UAAA;IAAsB,IAAA;IAAc,OAAA;EAAA;EAvBsB;;;;;EAmC1D,QAAA;AAAA"}

package/dist/index.d.mts

@@ -6,14 +6,13 @@ import { Ipv4Addr, Ipv6Addr } from "net-address";
 * @example
 * const socketAddr = new SocketAddrV4({port: 6372}); // new SocketAddrV4({addr: Ipv4Addr.UNSPECIFIED, port: 6372});
 * tcpServer.listen(socketAddr.asNodeListenerOptions(), () => {});
-* udpSocket.bind(socketAddr, () => {});
+* udpSocket.bind(socketAddr.asNodeBindOptions(), () => {});
 * tcpServer.listen({...socketAddr.asNodeListenerOptions(), ipv6Only: true}, () => {});
 * @since v0.0.1
 */
 declare class SocketAddrV4 {
-  #private;
   readonly port: number;
-  readonly address: string;
+  readonly address: Ipv4Addr;
   readonly family = "ipv4";
   /**
   * Creates a new `SocketAddrV4` instance.
@@ -33,16 +32,19 @@ declare class SocketAddrV4 {
   * @returns An object containing the `port` and `host` properties.
   * @since v0.0.1
   */
-  asNodeListenerOptions(): {
+  asNodeListener(): {
     port: number;
     host: string;
   };
   /**
-  * Gets the raw `Ipv4Addr` instance representing the IP address of this socket address.
-  * @returns Ipv4Addr instance of the socket address's IP address.
-  * @since v0.0.1
+  * Returns an object suitable for use as options in Node.js `dgram.Socket.bind()` method.
+  * @returns An object containing the `port` and `address` properties.
+  * @since v0.1.0
   */
-  getRawAddress(): Ipv4Addr;
+  asNodeBind(): {
+    port: number;
+    address: string;
+  };
   /**
   * Returns a string representation of this socket address.
   * @returns The string representation in the format "address:port".
@@ -61,10 +63,9 @@ declare class SocketAddrV4 {
 * @since v0.0.1
 */
 declare class SocketAddrV6 {
-  #private;
   readonly port: number;
   readonly family = "ipv6";
-  readonly address: string;
+  readonly address: Ipv6Addr;
   flowlabel?: number;
   /**
   * Creates a new `SocketAddrV6` instance.
@@ -87,19 +88,22 @@ declare class SocketAddrV6 {
   * @returns An object containing the `port` and `host` properties.
   * @since v0.0.1
   */
-  asNodeListenerOptions(): {
+  asNodeListener(): {
     port: number;
     host: string;
   };
   /**
-  * Gets the raw `Ipv6Addr` instance representing the IP address of this socket address.
-  * @returns Ipv6Addr instance of the socket address's IP address.
-  * @since v0.0.1
+  * Returns an object suitable for use as options in Node.js `dgram.Socket.bind()` method.
+  * @returns An object containing the `port` and `address` properties.
+  * @since v0.1.0
   */
-  getRawAddress(): Ipv6Addr;
+  asNodeBind(): {
+    port: number;
+    address: string;
+  };
   /**
   * Returns a string representation of this socket address.
-  * @returns The string representation in the format "address:port".
+  * @returns The string representation in the format "[address]:port".
   * @since v0.0.1
   */
   toString(): string;

package/dist/index.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.mts","names":[],"sources":["../src/SocketAddrV4.ts","../src/SocketAddrV6.ts"],"mappings":";;;;;AAWA;;;;;;;cAAa,YAAA;EAAA;WAEI,IAAA;EAAA,SACA,OAAA;EAAA,SACA,MAAA;;;;;;;EAOhB,WAAA,CAAA;IAAoB,IAAA;IAAM;EAAA;IAAQ,IAAA,GAAO,QAAA;IAAU,IAAA;EAAA;;;;;;EAWnD,qBAAA,CAAA;IAAiC,IAAA;IAAc,IAAA;EAAA;;ACvBhD;;;;EDmCC,aAAA,CAAA,GAAwB,QAAA;;;;;;EASxB,QAAA,CAAA;AAAA;;;;;AA3CD;;;;;;cCDa,YAAA;EAAA;WAEI,IAAA;EAAA,SACA,MAAA;EAAA,SACA,OAAA;EAChB,SAAA;;;;;;;;EASA,WAAA,CAAA;IAAoB,OAAA;IAAS,IAAA;IAAM;EAAA;IAAa,OAAA,GAAU,QAAA;IAAU,IAAA;IAAc,SAAA;EAAA;;;;;;EAYlF,qBAAA,CAAA;IAAiC,IAAA;IAAc,IAAA;EAAA;EA1BnC;;;;;EAsCZ,aAAA,CAAA,GAAwB,QAAA;;;;;;EASxB,QAAA,CAAA;AAAA"}
+{"version":3,"file":"index.d.mts","names":[],"sources":["../src/SocketAddrV4.ts","../src/SocketAddrV6.ts"],"mappings":";;;;;AAWA;;;;;;;cAAa,YAAA;EAAA,SACI,IAAA;EAAA,SACA,OAAA,EAAS,QAAA;EAAA,SACT,MAAA;;;;;;;EAOhB,WAAA;IAAoB,IAAA;IAAM;EAAA;IAAQ,IAAA,GAAO,QAAA;IAAU,IAAA;EAAA;;;;;;EAUnD,cAAA;IAA0B,IAAA;IAAc,IAAA;EAAA;;;;ACrBzC;;EDiCC,UAAA;IAAsB,IAAA;IAAc,OAAA;EAAA;;;;;;EAYpC,QAAA;AAAA;;;;;AA5CD;;;;;;cCDa,YAAA;EAAA,SACI,IAAA;EAAA,SACA,MAAA;EAAA,SACA,OAAA,EAAS,QAAA;EACzB,SAAA;;;;;;;;EASA,WAAA;IAAoB,OAAA;IAAS,IAAA;IAAM;EAAA;IAAa,OAAA,GAAU,QAAA;IAAU,IAAA;IAAc,SAAA;EAAA;;;;;;EAWlF,cAAA;IAA0B,IAAA;IAAc,IAAA;EAAA;;AAxBzC;;;;EAoCC,UAAA;IAAsB,IAAA;IAAc,OAAA;EAAA;EAvBsB;;;;;EAmC1D,QAAA;AAAA"}

package/dist/index.mjs

@@ -1,2 +1,2 @@
-import{Ipv4Addr as e,Ipv6Addr as t}from"net-address";var n=class{#e;port;address;family=`ipv4`;constructor({addr:t,port:n}){this.#e=t??e.UNSPECIFIED,this.port=n,this.address=this.#e.toString()}asNodeListenerOptions(){return{port:this.port,host:this.address}}getRawAddress(){return this.#e}toString(){return`${this.address}:${this.port}`}},r=class{#e;port;family=`ipv6`;address;flowlabel;constructor({address:e,port:n,flowlabel:r}){this.#e=e??t.UNSPECIFIED,this.port=n,this.flowlabel=r,this.address=this.#e.toString()}asNodeListenerOptions(){return{port:this.port,host:this.address}}getRawAddress(){return this.#e}toString(){return`${this.address}:${this.port}`}};export{n as SocketAddrV4,r as SocketAddrV6};
+import{Ipv4Addr as e,Ipv6Addr as t}from"net-address";var n=class{port;address;family=`ipv4`;constructor({addr:t,port:n}){this.address=t??e.UNSPECIFIED,this.port=n}asNodeListener(){return{port:this.port,host:this.address.toString()}}asNodeBind(){return{port:this.port,address:this.address.toString()}}toString(){return`${this.address.toString()}:${this.port}`}},r=class{port;family=`ipv6`;address;flowlabel;constructor({address:e,port:n,flowlabel:r}){this.address=e??t.UNSPECIFIED,this.port=n,this.flowlabel=r}asNodeListener(){return{port:this.port,host:this.address.toString()}}asNodeBind(){return{port:this.port,address:this.address.toString()}}toString(){return`[${this.address.toString()}]:${this.port}`}};export{n as SocketAddrV4,r as SocketAddrV6};
 //# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.mjs","names":["#addr","#addr"],"sources":["../src/SocketAddrV4.ts","../src/SocketAddrV6.ts"],"sourcesContent":["import {Ipv4Addr} from 'net-address';\n\n/**\n * Represents an IPv4 socket address, consisting of an IPv4 address and a port number.\n * @example\n * const socketAddr = new SocketAddrV4({port: 6372}); // new SocketAddrV4({addr: Ipv4Addr.UNSPECIFIED, port: 6372});\n * tcpServer.listen(socketAddr.asNodeListenerOptions(), () => {});\n * udpSocket.bind(socketAddr, () => {});\n * tcpServer.listen({...socketAddr.asNodeListenerOptions(), ipv6Only: true}, () => {});\n * @since v0.0.1\n */\nexport class SocketAddrV4 {\n\t#addr: Ipv4Addr;\n\tpublic readonly port: number;\n\tpublic readonly address: string;\n\tpublic readonly family = 'ipv4';\n\t/**\n\t * Creates a new `SocketAddrV4` instance.\n\t * @param options - The options for creating the socket address.\n\t * @param options.addr - The IPv4 address. Defaults to {@link Ipv4Addr.UNSPECIFIED}.\n\t * @param options.port - The port number.\n\t */\n\tpublic constructor({addr, port}: {addr?: Ipv4Addr; port: number}) {\n\t\tthis.#addr = addr ?? Ipv4Addr.UNSPECIFIED;\n\t\tthis.port = port;\n\t\tthis.address = this.#addr.toString();\n\t}\n\n\t/**\n\t * Returns an object suitable for use as options in Node.js `net.Server.listen()` method.\n\t * @returns An object containing the `port` and `host` properties.\n\t * @since v0.0.1\n\t */\n\tpublic asNodeListenerOptions(): {port: number; host: string} {\n\t\treturn {\n\t\t\tport: this.port,\n\t\t\thost: this.address,\n\t\t};\n\t}\n\n\t/**\n\t * Gets the raw `Ipv4Addr` instance representing the IP address of this socket address.\n\t * @returns Ipv4Addr instance of the socket address's IP address.\n\t * @since v0.0.1\n\t */\n\tpublic getRawAddress(): Ipv4Addr {\n\t\treturn this.#addr;\n\t}\n\n\t/**\n\t * Returns a string representation of this socket address.\n\t * @returns The string representation in the format \"address:port\".\n\t * @since v0.0.1\n\t */\n\tpublic toString(): string {\n\t\treturn `${this.address}:${this.port}`;\n\t}\n}\n","import {Ipv6Addr} from 'net-address';\n\n/**\n * Represents an IPv6 socket address, consisting of an IPv6 address, a port number, and an optional flow label.\n * @example\n * const anySocketAddress = new SocketAddrV6(6372); // new SocketAddrV6(Ipv6Addr.UNSPECIFIED, 6372);\n * tcpServer.listen(anySocketAddress.asNodeListenerOptions(), () => {});\n * udpSocket.bind(anySocketAddress, () => {});\n * @since v0.0.1\n */\nexport class SocketAddrV6 {\n\t#addr: Ipv6Addr;\n\tpublic readonly port: number;\n\tpublic readonly family = 'ipv6';\n\tpublic readonly address: string;\n\tpublic flowlabel?: number;\n\n\t/**\n\t * Creates a new `SocketAddrV6` instance.\n\t * @param options - The options for creating the socket address.\n\t * @param options.address - The IPv6 address. Defaults to {@link Ipv6Addr.UNSPECIFIED}.\n\t * @param options.port - The port number.\n\t * @param options.flowlabel - The flow label.\n\t */\n\tpublic constructor({address, port, flowlabel}: {address?: Ipv6Addr; port: number; flowlabel?: number}) {\n\t\tthis.#addr = address ?? Ipv6Addr.UNSPECIFIED;\n\t\tthis.port = port;\n\t\tthis.flowlabel = flowlabel;\n\t\tthis.address = this.#addr.toString();\n\t}\n\n\t/**\n\t * Returns an object suitable for use as options in Node.js `net.Server.listen()` method.\n\t * @returns An object containing the `port` and `host` properties.\n\t * @since v0.0.1\n\t */\n\tpublic asNodeListenerOptions(): {port: number; host: string} {\n\t\treturn {\n\t\t\tport: this.port,\n\t\t\thost: this.address,\n\t\t};\n\t}\n\n\t/**\n\t * Gets the raw `Ipv6Addr` instance representing the IP address of this socket address.\n\t * @returns Ipv6Addr instance of the socket address's IP address.\n\t * @since v0.0.1\n\t */\n\tpublic getRawAddress(): Ipv6Addr {\n\t\treturn this.#addr;\n\t}\n\n\t/**\n\t * Returns a string representation of this socket address.\n\t * @returns The string representation in the format \"address:port\".\n\t * @since v0.0.1\n\t */\n\tpublic toString(): string {\n\t\treturn `${this.address}:${this.port}`;\n\t}\n}\n"],"mappings":"qDAWA,IAAa,EAAb,KAA0B,CACzB,GACA,KACA,QACA,OAAyB,OAOzB,YAAmB,CAAC,OAAM,QAAwC,CACjE,MAAA,EAAa,GAAQ,EAAS,YAC9B,KAAK,KAAO,EACZ,KAAK,QAAU,MAAA,EAAW,UAAU,CAQrC,uBAA6D,CAC5D,MAAO,CACN,KAAM,KAAK,KACX,KAAM,KAAK,QACX,CAQF,eAAiC,CAChC,OAAO,MAAA,EAQR,UAA0B,CACzB,MAAO,GAAG,KAAK,QAAQ,GAAG,KAAK,SC7CpB,EAAb,KAA0B,CACzB,GACA,KACA,OAAyB,OACzB,QACA,UASA,YAAmB,CAAC,UAAS,OAAM,aAAoE,CACtG,MAAA,EAAa,GAAW,EAAS,YACjC,KAAK,KAAO,EACZ,KAAK,UAAY,EACjB,KAAK,QAAU,MAAA,EAAW,UAAU,CAQrC,uBAA6D,CAC5D,MAAO,CACN,KAAM,KAAK,KACX,KAAM,KAAK,QACX,CAQF,eAAiC,CAChC,OAAO,MAAA,EAQR,UAA0B,CACzB,MAAO,GAAG,KAAK,QAAQ,GAAG,KAAK"}
+{"version":3,"file":"index.mjs","names":[],"sources":["../src/SocketAddrV4.ts","../src/SocketAddrV6.ts"],"sourcesContent":["import {Ipv4Addr} from 'net-address';\n\n/**\n * Represents an IPv4 socket address, consisting of an IPv4 address and a port number.\n * @example\n * const socketAddr = new SocketAddrV4({port: 6372}); // new SocketAddrV4({addr: Ipv4Addr.UNSPECIFIED, port: 6372});\n * tcpServer.listen(socketAddr.asNodeListenerOptions(), () => {});\n * udpSocket.bind(socketAddr.asNodeBindOptions(), () => {});\n * tcpServer.listen({...socketAddr.asNodeListenerOptions(), ipv6Only: true}, () => {});\n * @since v0.0.1\n */\nexport class SocketAddrV4 {\n\tpublic readonly port: number;\n\tpublic readonly address: Ipv4Addr;\n\tpublic readonly family = 'ipv4';\n\t/**\n\t * Creates a new `SocketAddrV4` instance.\n\t * @param options - The options for creating the socket address.\n\t * @param options.addr - The IPv4 address. Defaults to {@link Ipv4Addr.UNSPECIFIED}.\n\t * @param options.port - The port number.\n\t */\n\tpublic constructor({addr, port}: {addr?: Ipv4Addr; port: number}) {\n\t\tthis.address = addr ?? Ipv4Addr.UNSPECIFIED;\n\t\tthis.port = port;\n\t}\n\n\t/**\n\t * Returns an object suitable for use as options in Node.js `net.Server.listen()` method.\n\t * @returns An object containing the `port` and `host` properties.\n\t * @since v0.0.1\n\t */\n\tpublic asNodeListener(): {port: number; host: string} {\n\t\treturn {\n\t\t\tport: this.port,\n\t\t\thost: this.address.toString(),\n\t\t};\n\t}\n\n\t/**\n\t * Returns an object suitable for use as options in Node.js `dgram.Socket.bind()` method.\n\t * @returns An object containing the `port` and `address` properties.\n\t * @since v0.1.0\n\t */\n\tpublic asNodeBind(): {port: number; address: string} {\n\t\treturn {\n\t\t\tport: this.port,\n\t\t\taddress: this.address.toString(),\n\t\t};\n\t}\n\n\t/**\n\t * Returns a string representation of this socket address.\n\t * @returns The string representation in the format \"address:port\".\n\t * @since v0.0.1\n\t */\n\tpublic toString(): string {\n\t\treturn `${this.address.toString()}:${this.port}`;\n\t}\n}\n","import {Ipv6Addr} from 'net-address';\n\n/**\n * Represents an IPv6 socket address, consisting of an IPv6 address, a port number, and an optional flow label.\n * @example\n * const anySocketAddress = new SocketAddrV6(6372); // new SocketAddrV6(Ipv6Addr.UNSPECIFIED, 6372);\n * tcpServer.listen(anySocketAddress.asNodeListenerOptions(), () => {});\n * udpSocket.bind(anySocketAddress, () => {});\n * @since v0.0.1\n */\nexport class SocketAddrV6 {\n\tpublic readonly port: number;\n\tpublic readonly family = 'ipv6';\n\tpublic readonly address: Ipv6Addr;\n\tpublic flowlabel?: number;\n\n\t/**\n\t * Creates a new `SocketAddrV6` instance.\n\t * @param options - The options for creating the socket address.\n\t * @param options.address - The IPv6 address. Defaults to {@link Ipv6Addr.UNSPECIFIED}.\n\t * @param options.port - The port number.\n\t * @param options.flowlabel - The flow label.\n\t */\n\tpublic constructor({address, port, flowlabel}: {address?: Ipv6Addr; port: number; flowlabel?: number}) {\n\t\tthis.address = address ?? Ipv6Addr.UNSPECIFIED;\n\t\tthis.port = port;\n\t\tthis.flowlabel = flowlabel;\n\t}\n\n\t/**\n\t * Returns an object suitable for use as options in Node.js `net.Server.listen()` method.\n\t * @returns An object containing the `port` and `host` properties.\n\t * @since v0.0.1\n\t */\n\tpublic asNodeListener(): {port: number; host: string} {\n\t\treturn {\n\t\t\tport: this.port,\n\t\t\thost: this.address.toString(),\n\t\t};\n\t}\n\n\t/**\n\t * Returns an object suitable for use as options in Node.js `dgram.Socket.bind()` method.\n\t * @returns An object containing the `port` and `address` properties.\n\t * @since v0.1.0\n\t */\n\tpublic asNodeBind(): {port: number; address: string} {\n\t\treturn {\n\t\t\tport: this.port,\n\t\t\taddress: this.address.toString(),\n\t\t};\n\t}\n\n\t/**\n\t * Returns a string representation of this socket address.\n\t * @returns The string representation in the format \"[address]:port\".\n\t * @since v0.0.1\n\t */\n\tpublic toString(): string {\n\t\treturn `[${this.address.toString()}]:${this.port}`;\n\t}\n}\n"],"mappings":"qDAWA,IAAa,EAAb,KAA0B,CACzB,KACA,QACA,OAAyB,OAOzB,YAAmB,CAAC,OAAM,QAAwC,CACjE,KAAK,QAAU,GAAQ,EAAS,YAChC,KAAK,KAAO,CACb,CAOA,gBAAsD,CACrD,MAAO,CACN,KAAM,KAAK,KACX,KAAM,KAAK,QAAQ,SAAS,CAC7B,CACD,CAOA,YAAqD,CACpD,MAAO,CACN,KAAM,KAAK,KACX,QAAS,KAAK,QAAQ,SAAS,CAChC,CACD,CAOA,UAA0B,CACzB,MAAO,GAAG,KAAK,QAAQ,SAAS,EAAE,GAAG,KAAK,MAC3C,CACD,EChDa,EAAb,KAA0B,CACzB,KACA,OAAyB,OACzB,QACA,UASA,YAAmB,CAAC,UAAS,OAAM,aAAoE,CACtG,KAAK,QAAU,GAAW,EAAS,YACnC,KAAK,KAAO,EACZ,KAAK,UAAY,CAClB,CAOA,gBAAsD,CACrD,MAAO,CACN,KAAM,KAAK,KACX,KAAM,KAAK,QAAQ,SAAS,CAC7B,CACD,CAOA,YAAqD,CACpD,MAAO,CACN,KAAM,KAAK,KACX,QAAS,KAAK,QAAQ,SAAS,CAChC,CACD,CAOA,UAA0B,CACzB,MAAO,IAAI,KAAK,QAAQ,SAAS,EAAE,IAAI,KAAK,MAC7C,CACD"}

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "net-socket-address",
-	"version": "0.0.1",
+	"version": "0.1.0",
 	"description": "Network socket address instances",
 	"main": "./dist/index.cjs",
 	"module": "./dist/index.mjs",