Changelog

All notable changes to this project will be documented in this file.

The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.

0.5.0 - 2026-09-07

Added
Publish DNS-SD services with Madness.publish/2 and withdraw them with Madness.unpublish/1. Publications follow an owner process, support conflict renaming and lifecycle notifications, and are withdrawn when their owner exits. Publishing has a caller-defined timeout; daemon connection loss and terminal Avahi failures end the affected publication so it can be monitored and published again explicitly.
Publish through Avahi on Linux or Apple's mDNSResponder daemon. Automatic backend selection detects a reachable daemon and reconnects after it restarts. The required rebus dependency provides Avahi's D-Bus transport.
Restrict publications by interface, with address-family scoping on Avahi. Interface-scoped publishing requires the optional inertial dependency and terminates the publication if its interface disappears or observation loses continuity.

Decode records carrying the mDNS cache-flush bit with the :in class.
Encode fully-qualified query names correctly and reject invalid DNS name lengths.
Receive multicast replies when unicast_response: false and ignore packets sent from a source port other than 5353.
Keep concurrent stream queries from consuming one another's UDP messages, and release message-mode sockets when their caller exits.
Select numeric interfaces by OS index and reject reserved publication index zero.
Drop malformed NSEC records and records whose data does not match their declared type.

Changed
GitLab build components - CI component includes now target 1.4.0 across deps, compile, test, format, credo, dialyzer, and publish jobs.

Changed
Internal publishing process - Release publishing now uses mix publisho directly. The previous expublish dependency and custom mix publish alias-based wrapper have been removed.

Source IP in response metadata - Each record's metadata now includes a :source_ip field containing the IP address of the host that sent the mDNS response. This is an :inet.ip_address() tuple (e.g., {192, 168, 1, 100} for IPv4 or {0x2001, 0xdb8, 0, 0, 0, 0, 0, 1} for IPv6). Available via record.metadata.source_ip.

IPv6 multicast now works on Linux - The IPV6_MULTICAST_IF socket option number differs between platforms (9 on macOS, 17 on Linux). The option is now determined at runtime based on the OS. Unsupported platforms will raise a FunctionClauseError.

Stream mode now properly cleans up sockets - When using Madness.request/2 in stream mode (the default), sockets are owned by the caller process. Late UDP packets could remain in the caller's mailbox as orphaned {:udp, ...} messages after the request completed. The cleanup function now sets sockets to passive mode before draining pending messages, eliminating the race window between draining and closing.

Stream mode now drains pending UDP messages on cleanup - When using Madness.request/2 in stream mode (the default), sockets are owned by the caller process. If UDP packets arrived between the last set_active call and stream termination, they would remain in the caller's mailbox as orphaned {:udp, socket, ip, port, data} messages. These could cause unexpected behavior in GenServers or other OTP processes. The cleanup function now drains any pending UDP messages before closing sockets.

Link-local IPv6 addresses now allowed for mDNS - Previously, link-local addresses (fe80::) were filtered out, but they are required for IPv6 mDNS since the multicast address ff02::fb is link-local scope.
PTR queries no longer return immediately with no results - PTR queries are excluded from the pending questions set since we don't know how many responses to expect. However, an empty pending set was incorrectly causing immediate exit. Now PTR-only queries correctly wait for the full timeout.

Refactored deeply nested functions across lib and test files to satisfy Credo checks
Replaced length/1 > 0 with empty list comparison for performance
Added underscores to large numeric literals for readability

Default :family option from :inet to :any, sending mDNS queries over both IPv4 and IPv6
Minimum Elixir version from ~> 1.19 to ~> 1.18

:any value for the :family option, which resolves interfaces and opens sockets for both address families
IPv6 mDNS demo script (scripts/demo_ipv6.exs)