@gjsify/dgram 0.3.12 → 0.3.14

package/lib/esm/index.js

@@ -3,440 +3,450 @@ import GLib from "@girs/glib-2.0";
 import { EventEmitter } from "node:events";
 import { Buffer } from "node:buffer";
 import { deferEmit, ensureMainLoop } from "@gjsify/utils";
-const _activeSockets = /* @__PURE__ */ new Set();
-class Socket extends EventEmitter {
-  type;
-  _socket = null;
-  _bound = false;
-  _closed = false;
-  _receiving = false;
-  _address = { address: "0.0.0.0", family: "IPv4", port: 0 };
-  _cancellable = new Gio.Cancellable();
-  // Strong JS ref to the GSocketSource so SM GC cannot finalize the
-  // BoxedInstance while GLib's main context still holds it.
-  _readSource = null;
-  _reuseAddr;
-  _connected = false;
-  _remoteAddress = null;
-  constructor(options) {
-    super();
-    if (typeof options === "string") {
-      this.type = options;
-      this._reuseAddr = false;
-    } else {
-      this.type = options.type;
-      this._reuseAddr = options.reuseAddr ?? false;
-    }
-    const family = this.type === "udp6" ? Gio.SocketFamily.IPV6 : Gio.SocketFamily.IPV4;
-    try {
-      this._socket = Gio.Socket.new(family, Gio.SocketType.DATAGRAM, Gio.SocketProtocol.UDP);
-      this._socket.set_blocking(false);
-    } catch (err) {
-      this._socket = null;
-      deferEmit(this, "error", err);
-    }
-  }
-  /**
-   * Bind the socket to a port and optional address.
-   */
-  bind(port, address, callback) {
-    if (this._closed || !this._socket) return this;
-    let bindPort = 0;
-    let bindAddress = this.type === "udp6" ? "::" : "0.0.0.0";
-    if (typeof port === "object") {
-      const opts = port;
-      bindPort = opts.port || 0;
-      bindAddress = opts.address || bindAddress;
-      if (typeof address === "function") callback = address;
-    } else if (typeof port === "number") {
-      bindPort = port;
-      if (typeof address === "string") bindAddress = address;
-      else if (typeof address === "function") callback = address;
-    } else if (typeof port === "function") {
-      callback = port;
-    }
-    if (callback) this.once("listening", callback);
-    try {
-      const family = this.type === "udp6" ? Gio.SocketFamily.IPV6 : Gio.SocketFamily.IPV4;
-      const inetAddr = Gio.InetAddress.new_from_string(bindAddress) || (family === Gio.SocketFamily.IPV6 ? Gio.InetAddress.new_any(Gio.SocketFamily.IPV6) : Gio.InetAddress.new_any(Gio.SocketFamily.IPV4));
-      const sockAddr = new Gio.InetSocketAddress({ address: inetAddr, port: bindPort });
-      this._socket.bind(sockAddr, this._reuseAddr);
-      this._bound = true;
-      _activeSockets.add(this);
-      ensureMainLoop();
-      const localAddr = this._socket.get_local_address();
-      if (localAddr) {
-        this._address = {
-          address: localAddr.get_address().to_string(),
-          family: this.type === "udp6" ? "IPv6" : "IPv4",
-          port: localAddr.get_port()
-        };
-      }
-      setTimeout(() => {
-        this.emit("listening");
-        this._startReceiving();
-      }, 0);
-    } catch (err) {
-      deferEmit(this, "error", err);
-    }
-    return this;
-  }
-  /**
-   * Send a message.
-   */
-  send(msg, offset, length, port, address, callback) {
-    if (this._closed || !this._socket) return;
-    let buf;
-    let destPort;
-    let destAddress;
-    let cb;
-    if (typeof offset === "function") {
-      cb = offset;
-      buf = this._toBuffer(msg);
-      destPort = this._address.port;
-      destAddress = this._address.address;
-    } else if (typeof offset === "number" && typeof length === "string") {
-      destPort = offset;
-      destAddress = length;
-      cb = port;
-      buf = this._toBuffer(msg);
-    } else if (typeof offset === "number" && typeof length === "number" && typeof address === "function") {
-      cb = address;
-      destPort = port;
-      destAddress = this.type === "udp6" ? "::1" : "127.0.0.1";
-      buf = this._toBufferSlice(msg, offset, length);
-    } else if (typeof offset === "number" && typeof length === "number") {
-      destPort = port;
-      destAddress = address || (this.type === "udp6" ? "::1" : "127.0.0.1");
-      cb = callback;
-      buf = this._toBufferSlice(msg, offset, length);
-    } else {
-      destPort = Number(offset) || 0;
-      destAddress = this.type === "udp6" ? "::1" : "127.0.0.1";
-      buf = this._toBuffer(msg);
-    }
-    this._resolveAndSend(destAddress, destPort, buf, cb);
-  }
-  _autoBind() {
-    if (this._bound || !this._socket) return;
-    const anyAddr = this.type === "udp6" ? Gio.InetAddress.new_any(Gio.SocketFamily.IPV6) : Gio.InetAddress.new_any(Gio.SocketFamily.IPV4);
-    const anySockAddr = new Gio.InetSocketAddress({ address: anyAddr, port: 0 });
-    this._socket.bind(anySockAddr, false);
-    this._bound = true;
-    _activeSockets.add(this);
-    ensureMainLoop();
-  }
-  /** Socket family that matches `this.type` (udp4 → IPv4, udp6 → IPv6). */
-  _socketFamily() {
-    return this.type === "udp6" ? Gio.SocketFamily.IPV6 : Gio.SocketFamily.IPV4;
-  }
-  /** True when `addr` can be sent to from a socket bound with `this._socketFamily()`. */
-  _isAddressCompatible(addr) {
-    return addr.get_family() === this._socketFamily();
-  }
-  /** Build an EINVAL error for a destination whose family doesn't match the socket.
-   *  Matches Node.js dgram behavior (node reports EINVAL from sendto(2) when the
-   *  destination address family is incompatible with the bound socket). */
-  _mismatchError(destAddress) {
-    const want = this.type === "udp6" ? "IPv6" : "IPv4";
-    const err = new Error(
-      `EINVAL: cannot send to ${destAddress} from a ${want} socket (address-family mismatch)`
-    );
-    err.code = "EINVAL";
-    err.syscall = "send";
-    return err;
-  }
-  _resolveAndSend(destAddress, destPort, buf, cb) {
-    if (this._closed || !this._socket) {
-      if (cb) cb(new Error("Socket is closed"), 0);
-      return;
-    }
-    let inetAddr = Gio.InetAddress.new_from_string(destAddress);
-    const doSend = (addr) => {
-      if (!this._isAddressCompatible(addr)) {
-        const err = this._mismatchError(destAddress);
-        if (cb) cb(err, 0);
-        else this.emit("error", err);
-        return;
-      }
-      try {
-        this._autoBind();
-        const sockAddr = new Gio.InetSocketAddress({ address: addr, port: destPort });
-        const bytesSent = this._socket.send_to(sockAddr, buf, this._cancellable);
-        if (cb) cb(null, bytesSent);
-      } catch (err) {
-        if (cb) cb(err instanceof Error ? err : new Error(String(err)), 0);
-        else this.emit("error", err);
-      }
-    };
-    if (inetAddr) {
-      doSend(inetAddr);
-      return;
-    }
-    const resolver = Gio.Resolver.get_default();
-    resolver.lookup_by_name_async(destAddress, this._cancellable, (_obj, res) => {
-      try {
-        const addresses = resolver.lookup_by_name_finish(res);
-        if (!addresses || addresses.length === 0) {
-          const err = new Error(`ENOTFOUND ${destAddress}`);
-          err.code = "ENOTFOUND";
-          if (cb) cb(err, 0);
-          else this.emit("error", err);
-          return;
-        }
-        const compatible = addresses.find((a) => this._isAddressCompatible(a));
-        if (!compatible) {
-          const err = this._mismatchError(destAddress);
-          if (cb) cb(err, 0);
-          else this.emit("error", err);
-          return;
-        }
-        doSend(compatible);
-      } catch (err) {
-        if (cb) cb(err instanceof Error ? err : new Error(String(err)), 0);
-        else this.emit("error", err);
-      }
-    });
-  }
-  _toBuffer(msg) {
-    if (Array.isArray(msg)) {
-      return Buffer.concat(msg.map((m) => typeof m === "string" ? Buffer.from(m) : Buffer.from(m)));
-    }
-    return typeof msg === "string" ? Buffer.from(msg) : Buffer.from(msg);
-  }
-  _toBufferSlice(msg, offset, length) {
-    const buf = this._toBuffer(msg);
-    return Buffer.from(buf.buffer, buf.byteOffset + offset, length);
-  }
-  /**
-   * Close the socket.
-   */
-  close(callback) {
-    if (this._closed) {
-      throw new Error("Not running");
-    }
-    this._closed = true;
-    _activeSockets.delete(this);
-    if (callback) this.once("close", callback);
-    if (this._readSource) {
-      try {
-        this._readSource.destroy();
-      } catch (_e) {
-      }
-      this._readSource = null;
-    }
-    this._cancellable.cancel();
-    if (this._socket) {
-      try {
-        this._socket.close();
-      } catch (_e) {
-      }
-      this._socket = null;
-    }
-    deferEmit(this, "close");
-    return this;
-  }
-  /**
-   * Associate the socket with a remote address/port (connected UDP).
-   * After connect(), send() can omit address and port.
-   */
-  connect(port, address, callback) {
-    if (this._connected) {
-      const err = new Error("Already connected");
-      err.code = "ERR_SOCKET_DGRAM_IS_CONNECTED";
-      throw err;
-    }
-    if (!port || port <= 0 || port >= 65536) {
-      const err = new RangeError(`Port should be > 0 and < 65536. Received ${port}.`);
-      err.code = "ERR_SOCKET_BAD_PORT";
-      throw err;
-    }
-    let resolvedAddr;
-    let cb;
-    if (typeof address === "function") {
-      cb = address;
-      resolvedAddr = this.type === "udp6" ? "::1" : "127.0.0.1";
-    } else {
-      resolvedAddr = address || (this.type === "udp6" ? "::1" : "127.0.0.1");
-      cb = callback;
-    }
-    this._connected = true;
-    this._remoteAddress = {
-      address: resolvedAddr,
-      family: this.type === "udp6" ? "IPv6" : "IPv4",
-      port
-    };
-    if (cb) {
-      Promise.resolve().then(() => {
-        this.emit("connect");
-        cb();
-      });
-    } else {
-      Promise.resolve().then(() => this.emit("connect"));
-    }
-  }
-  /**
-   * Dissociate a connected socket from its remote address.
-   */
-  disconnect() {
-    if (!this._connected) {
-      const err = new Error("Not connected");
-      err.code = "ERR_SOCKET_DGRAM_NOT_CONNECTED";
-      throw err;
-    }
-    this._connected = false;
-    this._remoteAddress = null;
-  }
-  /**
-   * Returns the remote address of a connected socket.
-   * Throws ERR_SOCKET_DGRAM_NOT_CONNECTED if not connected.
-   */
-  remoteAddress() {
-    if (!this._connected || !this._remoteAddress) {
-      const err = new Error("Not connected");
-      err.code = "ERR_SOCKET_DGRAM_NOT_CONNECTED";
-      throw err;
-    }
-    return { ...this._remoteAddress };
-  }
-  /**
-   * Get the bound address info.
-   */
-  address() {
-    return { ...this._address };
-  }
-  /**
-   * Set the broadcast flag.
-   */
-  setBroadcast(flag) {
-    if (this._socket) {
-      this._socket.set_broadcast(flag);
-    }
-  }
-  /**
-   * Set the TTL.
-   */
-  setTTL(ttl) {
-    if (this._socket) {
-      this._socket.set_ttl(ttl);
-    }
-    return ttl;
-  }
-  /**
-   * Set multicast TTL.
-   */
-  setMulticastTTL(ttl) {
-    if (this._socket) {
-      this._socket.set_multicast_ttl(ttl);
-    }
-    return ttl;
-  }
-  /**
-   * Set multicast loopback.
-   */
-  setMulticastLoopback(flag) {
-    if (this._socket) {
-      this._socket.set_multicast_loopback(flag);
-    }
-    return flag;
-  }
-  /**
-   * Add multicast group membership.
-   */
-  addMembership(multicastAddress, multicastInterface) {
-    if (!this._socket) return;
-    try {
-      const mcastAddr = Gio.InetAddress.new_from_string(multicastAddress);
-      this._socket.join_multicast_group(mcastAddr, false, multicastInterface || null);
-    } catch (err) {
-      this.emit("error", err);
-    }
-  }
-  /**
-   * Drop multicast group membership.
-   */
-  dropMembership(multicastAddress, multicastInterface) {
-    if (!this._socket) return;
-    try {
-      const mcastAddr = Gio.InetAddress.new_from_string(multicastAddress);
-      this._socket.leave_multicast_group(mcastAddr, false, multicastInterface || null);
-    } catch (err) {
-      this.emit("error", err);
-    }
-  }
-  /**
-   * Set multicast interface.
-   */
-  setMulticastInterface(_interfaceAddress) {
-  }
-  /** Ref the socket (keep event loop alive). */
-  ref() {
-    return this;
-  }
-  /** Unref the socket (allow event loop to exit). */
-  unref() {
-    return this;
-  }
-  /** Get/Set receive buffer size. */
-  getRecvBufferSize() {
-    return 65536;
-  }
-  setRecvBufferSize(_size) {
-  }
-  /** Get/Set send buffer size. */
-  getSendBufferSize() {
-    return 65536;
-  }
-  setSendBufferSize(_size) {
-  }
-  /**
-   * Start receiving messages in background.
-   */
-  _startReceiving() {
-    if (this._receiving || this._closed || !this._socket) return;
-    this._receiving = true;
-    this._receiveLoop();
-  }
-  _receiveLoop() {
-    if (this._closed || !this._socket || this._readSource) return;
-    const source = this._socket.create_source(GLib.IOCondition.IN, this._cancellable);
-    this._readSource = source;
-    source.set_callback(() => {
-      if (this._closed || !this._socket) return GLib.SOURCE_REMOVE;
-      try {
-        const [bytes, srcAddr] = this._socket.receive_bytes_from(65536, 0, this._cancellable);
-        if (bytes && srcAddr) {
-          const data = Buffer.from(bytes.get_data());
-          const inetSockAddr = srcAddr;
-          const rinfo = {
-            address: inetSockAddr.get_address().to_string(),
-            family: this.type === "udp6" ? "IPv6" : "IPv4",
-            port: inetSockAddr.get_port()
-          };
-          if (data.length > 0) this.emit("message", data, rinfo);
-        }
-      } catch (err) {
-        const errObj = err;
-        if (!this._closed && errObj.code !== Gio.IOErrorEnum.CANCELLED) {
-          this.emit("error", err);
-        }
-      }
-      return GLib.SOURCE_CONTINUE;
-    });
-    source.attach(null);
-  }
-}
+
+//#region src/index.ts
+const _activeSockets = new Set();
+var Socket = class extends EventEmitter {
+	type;
+	_socket = null;
+	_bound = false;
+	_closed = false;
+	_receiving = false;
+	_address = {
+		address: "0.0.0.0",
+		family: "IPv4",
+		port: 0
+	};
+	_cancellable = new Gio.Cancellable();
+	_readSource = null;
+	_reuseAddr;
+	_connected = false;
+	_remoteAddress = null;
+	constructor(options) {
+		super();
+		if (typeof options === "string") {
+			this.type = options;
+			this._reuseAddr = false;
+		} else {
+			this.type = options.type;
+			this._reuseAddr = options.reuseAddr ?? false;
+		}
+		const family = this.type === "udp6" ? Gio.SocketFamily.IPV6 : Gio.SocketFamily.IPV4;
+		try {
+			this._socket = Gio.Socket.new(family, Gio.SocketType.DATAGRAM, Gio.SocketProtocol.UDP);
+			this._socket.set_blocking(false);
+		} catch (err) {
+			this._socket = null;
+			deferEmit(this, "error", err);
+		}
+	}
+	/**
+	* Bind the socket to a port and optional address.
+	*/
+	bind(port, address, callback) {
+		if (this._closed || !this._socket) return this;
+		let bindPort = 0;
+		let bindAddress = this.type === "udp6" ? "::" : "0.0.0.0";
+		if (typeof port === "object") {
+			const opts = port;
+			bindPort = opts.port || 0;
+			bindAddress = opts.address || bindAddress;
+			if (typeof address === "function") callback = address;
+		} else if (typeof port === "number") {
+			bindPort = port;
+			if (typeof address === "string") bindAddress = address;
+			else if (typeof address === "function") callback = address;
+		} else if (typeof port === "function") {
+			callback = port;
+		}
+		if (callback) this.once("listening", callback);
+		try {
+			const family = this.type === "udp6" ? Gio.SocketFamily.IPV6 : Gio.SocketFamily.IPV4;
+			const inetAddr = Gio.InetAddress.new_from_string(bindAddress) || (family === Gio.SocketFamily.IPV6 ? Gio.InetAddress.new_any(Gio.SocketFamily.IPV6) : Gio.InetAddress.new_any(Gio.SocketFamily.IPV4));
+			const sockAddr = new Gio.InetSocketAddress({
+				address: inetAddr,
+				port: bindPort
+			});
+			this._socket.bind(sockAddr, this._reuseAddr);
+			this._bound = true;
+			_activeSockets.add(this);
+			ensureMainLoop();
+			const localAddr = this._socket.get_local_address();
+			if (localAddr) {
+				this._address = {
+					address: localAddr.get_address().to_string(),
+					family: this.type === "udp6" ? "IPv6" : "IPv4",
+					port: localAddr.get_port()
+				};
+			}
+			setTimeout(() => {
+				this.emit("listening");
+				this._startReceiving();
+			}, 0);
+		} catch (err) {
+			deferEmit(this, "error", err);
+		}
+		return this;
+	}
+	/**
+	* Send a message.
+	*/
+	send(msg, offset, length, port, address, callback) {
+		if (this._closed || !this._socket) return;
+		let buf;
+		let destPort;
+		let destAddress;
+		let cb;
+		if (typeof offset === "function") {
+			cb = offset;
+			buf = this._toBuffer(msg);
+			destPort = this._address.port;
+			destAddress = this._address.address;
+		} else if (typeof offset === "number" && typeof length === "string") {
+			destPort = offset;
+			destAddress = length;
+			cb = port;
+			buf = this._toBuffer(msg);
+		} else if (typeof offset === "number" && typeof length === "number" && typeof address === "function") {
+			cb = address;
+			destPort = port;
+			destAddress = this.type === "udp6" ? "::1" : "127.0.0.1";
+			buf = this._toBufferSlice(msg, offset, length);
+		} else if (typeof offset === "number" && typeof length === "number") {
+			destPort = port;
+			destAddress = address || (this.type === "udp6" ? "::1" : "127.0.0.1");
+			cb = callback;
+			buf = this._toBufferSlice(msg, offset, length);
+		} else {
+			destPort = Number(offset) || 0;
+			destAddress = this.type === "udp6" ? "::1" : "127.0.0.1";
+			buf = this._toBuffer(msg);
+		}
+		this._resolveAndSend(destAddress, destPort, buf, cb);
+	}
+	_autoBind() {
+		if (this._bound || !this._socket) return;
+		const anyAddr = this.type === "udp6" ? Gio.InetAddress.new_any(Gio.SocketFamily.IPV6) : Gio.InetAddress.new_any(Gio.SocketFamily.IPV4);
+		const anySockAddr = new Gio.InetSocketAddress({
+			address: anyAddr,
+			port: 0
+		});
+		this._socket.bind(anySockAddr, false);
+		this._bound = true;
+		_activeSockets.add(this);
+		ensureMainLoop();
+	}
+	/** Socket family that matches `this.type` (udp4 → IPv4, udp6 → IPv6). */
+	_socketFamily() {
+		return this.type === "udp6" ? Gio.SocketFamily.IPV6 : Gio.SocketFamily.IPV4;
+	}
+	/** True when `addr` can be sent to from a socket bound with `this._socketFamily()`. */
+	_isAddressCompatible(addr) {
+		return addr.get_family() === this._socketFamily();
+	}
+	/** Build an EINVAL error for a destination whose family doesn't match the socket.
+	*  Matches Node.js dgram behavior (node reports EINVAL from sendto(2) when the
+	*  destination address family is incompatible with the bound socket). */
+	_mismatchError(destAddress) {
+		const want = this.type === "udp6" ? "IPv6" : "IPv4";
+		const err = new Error(`EINVAL: cannot send to ${destAddress} from a ${want} socket (address-family mismatch)`);
+		err.code = "EINVAL";
+		err.syscall = "send";
+		return err;
+	}
+	_resolveAndSend(destAddress, destPort, buf, cb) {
+		if (this._closed || !this._socket) {
+			if (cb) cb(new Error("Socket is closed"), 0);
+			return;
+		}
+		let inetAddr = Gio.InetAddress.new_from_string(destAddress);
+		const doSend = (addr) => {
+			if (!this._isAddressCompatible(addr)) {
+				const err = this._mismatchError(destAddress);
+				if (cb) cb(err, 0);
+				else this.emit("error", err);
+				return;
+			}
+			try {
+				this._autoBind();
+				const sockAddr = new Gio.InetSocketAddress({
+					address: addr,
+					port: destPort
+				});
+				const bytesSent = this._socket.send_to(sockAddr, buf, this._cancellable);
+				if (cb) cb(null, bytesSent);
+			} catch (err) {
+				if (cb) cb(err instanceof Error ? err : new Error(String(err)), 0);
+				else this.emit("error", err);
+			}
+		};
+		if (inetAddr) {
+			doSend(inetAddr);
+			return;
+		}
+		const resolver = Gio.Resolver.get_default();
+		resolver.lookup_by_name_async(destAddress, this._cancellable, (_obj, res) => {
+			try {
+				const addresses = resolver.lookup_by_name_finish(res);
+				if (!addresses || addresses.length === 0) {
+					const err = new Error(`ENOTFOUND ${destAddress}`);
+					err.code = "ENOTFOUND";
+					if (cb) cb(err, 0);
+					else this.emit("error", err);
+					return;
+				}
+				const compatible = addresses.find((a) => this._isAddressCompatible(a));
+				if (!compatible) {
+					const err = this._mismatchError(destAddress);
+					if (cb) cb(err, 0);
+					else this.emit("error", err);
+					return;
+				}
+				doSend(compatible);
+			} catch (err) {
+				if (cb) cb(err instanceof Error ? err : new Error(String(err)), 0);
+				else this.emit("error", err);
+			}
+		});
+	}
+	_toBuffer(msg) {
+		if (Array.isArray(msg)) {
+			return Buffer.concat(msg.map((m) => typeof m === "string" ? Buffer.from(m) : Buffer.from(m)));
+		}
+		return typeof msg === "string" ? Buffer.from(msg) : Buffer.from(msg);
+	}
+	_toBufferSlice(msg, offset, length) {
+		const buf = this._toBuffer(msg);
+		return Buffer.from(buf.buffer, buf.byteOffset + offset, length);
+	}
+	/**
+	* Close the socket.
+	*/
+	close(callback) {
+		if (this._closed) {
+			throw new Error("Not running");
+		}
+		this._closed = true;
+		_activeSockets.delete(this);
+		if (callback) this.once("close", callback);
+		if (this._readSource) {
+			try {
+				this._readSource.destroy();
+			} catch (_e) {}
+			this._readSource = null;
+		}
+		this._cancellable.cancel();
+		if (this._socket) {
+			try {
+				this._socket.close();
+			} catch (_e) {}
+			this._socket = null;
+		}
+		deferEmit(this, "close");
+		return this;
+	}
+	/**
+	* Associate the socket with a remote address/port (connected UDP).
+	* After connect(), send() can omit address and port.
+	*/
+	connect(port, address, callback) {
+		if (this._connected) {
+			const err = new Error("Already connected");
+			err.code = "ERR_SOCKET_DGRAM_IS_CONNECTED";
+			throw err;
+		}
+		if (!port || port <= 0 || port >= 65536) {
+			const err = new RangeError(`Port should be > 0 and < 65536. Received ${port}.`);
+			err.code = "ERR_SOCKET_BAD_PORT";
+			throw err;
+		}
+		let resolvedAddr;
+		let cb;
+		if (typeof address === "function") {
+			cb = address;
+			resolvedAddr = this.type === "udp6" ? "::1" : "127.0.0.1";
+		} else {
+			resolvedAddr = address || (this.type === "udp6" ? "::1" : "127.0.0.1");
+			cb = callback;
+		}
+		this._connected = true;
+		this._remoteAddress = {
+			address: resolvedAddr,
+			family: this.type === "udp6" ? "IPv6" : "IPv4",
+			port
+		};
+		if (cb) {
+			Promise.resolve().then(() => {
+				this.emit("connect");
+				cb();
+			});
+		} else {
+			Promise.resolve().then(() => this.emit("connect"));
+		}
+	}
+	/**
+	* Dissociate a connected socket from its remote address.
+	*/
+	disconnect() {
+		if (!this._connected) {
+			const err = new Error("Not connected");
+			err.code = "ERR_SOCKET_DGRAM_NOT_CONNECTED";
+			throw err;
+		}
+		this._connected = false;
+		this._remoteAddress = null;
+	}
+	/**
+	* Returns the remote address of a connected socket.
+	* Throws ERR_SOCKET_DGRAM_NOT_CONNECTED if not connected.
+	*/
+	remoteAddress() {
+		if (!this._connected || !this._remoteAddress) {
+			const err = new Error("Not connected");
+			err.code = "ERR_SOCKET_DGRAM_NOT_CONNECTED";
+			throw err;
+		}
+		return { ...this._remoteAddress };
+	}
+	/**
+	* Get the bound address info.
+	*/
+	address() {
+		return { ...this._address };
+	}
+	/**
+	* Set the broadcast flag.
+	*/
+	setBroadcast(flag) {
+		if (this._socket) {
+			this._socket.set_broadcast(flag);
+		}
+	}
+	/**
+	* Set the TTL.
+	*/
+	setTTL(ttl) {
+		if (this._socket) {
+			this._socket.set_ttl(ttl);
+		}
+		return ttl;
+	}
+	/**
+	* Set multicast TTL.
+	*/
+	setMulticastTTL(ttl) {
+		if (this._socket) {
+			this._socket.set_multicast_ttl(ttl);
+		}
+		return ttl;
+	}
+	/**
+	* Set multicast loopback.
+	*/
+	setMulticastLoopback(flag) {
+		if (this._socket) {
+			this._socket.set_multicast_loopback(flag);
+		}
+		return flag;
+	}
+	/**
+	* Add multicast group membership.
+	*/
+	addMembership(multicastAddress, multicastInterface) {
+		if (!this._socket) return;
+		try {
+			const mcastAddr = Gio.InetAddress.new_from_string(multicastAddress);
+			this._socket.join_multicast_group(mcastAddr, false, multicastInterface || null);
+		} catch (err) {
+			this.emit("error", err);
+		}
+	}
+	/**
+	* Drop multicast group membership.
+	*/
+	dropMembership(multicastAddress, multicastInterface) {
+		if (!this._socket) return;
+		try {
+			const mcastAddr = Gio.InetAddress.new_from_string(multicastAddress);
+			this._socket.leave_multicast_group(mcastAddr, false, multicastInterface || null);
+		} catch (err) {
+			this.emit("error", err);
+		}
+	}
+	/**
+	* Set multicast interface.
+	*/
+	setMulticastInterface(_interfaceAddress) {}
+	/** Ref the socket (keep event loop alive). */
+	ref() {
+		return this;
+	}
+	/** Unref the socket (allow event loop to exit). */
+	unref() {
+		return this;
+	}
+	/** Get/Set receive buffer size. */
+	getRecvBufferSize() {
+		return 65536;
+	}
+	setRecvBufferSize(_size) {}
+	/** Get/Set send buffer size. */
+	getSendBufferSize() {
+		return 65536;
+	}
+	setSendBufferSize(_size) {}
+	/**
+	* Start receiving messages in background.
+	*/
+	_startReceiving() {
+		if (this._receiving || this._closed || !this._socket) return;
+		this._receiving = true;
+		this._receiveLoop();
+	}
+	_receiveLoop() {
+		if (this._closed || !this._socket || this._readSource) return;
+		const source = this._socket.create_source(GLib.IOCondition.IN, this._cancellable);
+		this._readSource = source;
+		source.set_callback(() => {
+			if (this._closed || !this._socket) return GLib.SOURCE_REMOVE;
+			try {
+				const [bytes, srcAddr] = this._socket.receive_bytes_from(65536, 0, this._cancellable);
+				if (bytes && srcAddr) {
+					const data = Buffer.from(bytes.get_data());
+					const inetSockAddr = srcAddr;
+					const rinfo = {
+						address: inetSockAddr.get_address().to_string(),
+						family: this.type === "udp6" ? "IPv6" : "IPv4",
+						port: inetSockAddr.get_port()
+					};
+					if (data.length > 0) this.emit("message", data, rinfo);
+				}
+			} catch (err) {
+				const errObj = err;
+				if (!this._closed && errObj.code !== Gio.IOErrorEnum.CANCELLED) {
+					this.emit("error", err);
+				}
+			}
+			return GLib.SOURCE_CONTINUE;
+		});
+		source.attach(null);
+	}
+};
+/**
+* Create a UDP socket.
+*/
 function createSocket(type, callback) {
-  const opts = typeof type === "string" ? { type } : type;
-  const socket = new Socket(opts);
-  if (callback) {
-    socket.on("message", callback);
-  }
-  return socket;
+	const opts = typeof type === "string" ? { type } : type;
+	const socket = new Socket(opts);
+	if (callback) {
+		socket.on("message", callback);
+	}
+	return socket;
 }
-var index_default = { Socket, createSocket };
-export {
-  Socket,
-  createSocket,
-  index_default as default
+var src_default = {
+	Socket,
+	createSocket
 };
+
+//#endregion
+export { Socket, createSocket, src_default as default };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gjsify/dgram",
-  "version": "0.3.12",
+  "version": "0.3.14",
   "description": "Node.js dgram module for Gjs",
   "type": "module",
   "module": "lib/esm/index.js",
@@ -30,15 +30,15 @@
     "dgram"
   ],
   "dependencies": {
-    "@girs/gio-2.0": "^2.88.0-4.0.0-rc.9",
-    "@girs/glib-2.0": "^2.88.0-4.0.0-rc.9",
-    "@gjsify/buffer": "^0.3.12",
-    "@gjsify/events": "^0.3.12",
-    "@gjsify/utils": "^0.3.12"
+    "@girs/gio-2.0": "2.88.0-4.0.0-rc.9",
+    "@girs/glib-2.0": "2.88.0-4.0.0-rc.9",
+    "@gjsify/buffer": "^0.3.14",
+    "@gjsify/events": "^0.3.14",
+    "@gjsify/utils": "^0.3.14"
   },
   "devDependencies": {
-    "@gjsify/cli": "^0.3.12",
-    "@gjsify/unit": "^0.3.12",
+    "@gjsify/cli": "^0.3.14",
+    "@gjsify/unit": "^0.3.14",
     "@types/node": "^25.6.0",
     "typescript": "^6.0.3"
   }