@devioarts/capacitor-mdns 0.0.3 → 0.2.0

package/CHANGELOG.md

@@ -0,0 +1,110 @@
+# Changelog
+
+## [0.2.0] - 2026-11-07
+
+### Upgrade from 0.1.0
+
+- Existing method signatures and result shapes are retained. Continuous discovery is additive,
+  but validation, failure reporting and overlapping discovery behavior have changed as noted below.
+- iOS now declares a minimum deployment target of 15.0. Capacitor dependencies are restricted to
+  version 8; applications using another major version are not supported.
+- Service types, instance names, TXT records and timeouts are validated more strictly. Previously
+  tolerated invalid inputs can now return `error: true`.
+- A valid new `discover()` cancels the previous request with an error. On iOS, discovery without
+  a name filter now waits for the complete timeout. Check `error` before consuming results;
+  errors discard partial results, and a failed stop can return `publishing: true`.
+- Electron applications must install `bonjour-service@~1.4.0` and rerun `npx cap-electron sync`.
+  Manual IPC integrations using a custom renderer origin must configure `trustedOrigins`.
+
+### Added
+
+- Continuous multi-type discovery on iOS, Android and Electron through `watchServices()` and
+  `stopWatching()`, with `serviceFound`, `serviceLost` and `watchError` listeners. Valid replacement
+  calls stop previous watchers; stopping leaves advertisements and one-shot discovery independent.
+  Thanks to [Idrimi](https://github.com/Idrimi) for the original feature in
+  [PR #7](https://github.com/devioarts/capacitor-mdns/pull/7).
+- Full found/lost snapshots, duplicate-type normalization, stale-callback guards, native resolve
+  retries, shared Android resolver scheduling and multicast locks, and Electron TTL expiry / IPC events.
+- Resolved Android NSD TXT attributes, optional service hostnames, playground live service lists / errors / TXT publication and
+  regression tests for watcher lifecycle and both Electron integration routes.
+
+### Fixed
+
+- CocoaPods source tags now use the repository's `v` prefix. npm archives include this changelog.
+- Electron: a failed response to an incoming Bonjour query no longer permanently blocks later
+  publication, discovery or watches. Fatal transport errors still stop affected operations.
+- Electron: name conflicts fail when the probe detects them, and stopping an unpublished service
+  no longer sends goodbye records for another publisher's name. Missing generated registration
+  reports the required `npx cap-electron sync` step.
+- Electron: goodbye is preserved if an announcement has started but its send callback is still pending;
+  stopped services cannot reannounce after a late callback. Duplicate discovered addresses are removed.
+- The supported `bonjour-service` range is limited to `~1.4.0` pending verification of probe cleanup
+  behavior in later minor versions; package, playground and installation instructions use the same range.
+- Discovered addresses prefer IPv4 on all platforms while preserving native IPv6 scope suffixes.
+  Added regressions for packet failures, Bonjour teardown, address ordering, native bridge input
+  validation and Android recovery after a late unregistration confirmation.
+
+- Android: NSD callbacks (delivered on NsdManager's internal thread) are now marshalled to the main thread before touching any state, removing data races between discovery results, the timeout, and publish completion. A publish confirmation racing the publish timeout can no longer complete the call twice.
+- Android: before API 34 only one `resolveService` may be active, so concurrent resolves were silently dropped and services lost. Resolves are now queued, retried on `FAILURE_ALREADY_ACTIVE`, and individually timed out.
+- Android: stopping, replacing or timing out a pending registration cancels it immediately through its listener, allowing subsequent publication. Late callbacks cannot resurrect a cancelled service. `close()` fails pending discovery.
+- iOS: discovery waits for the entire requested timeout unless a named target resolves with an IP address, retaining late peers even after a failed or filtered resolve.
+- iOS: the `NWBrowser` duplicate check used un-normalized type/domain, so every browse update spawned new resolvers for already known services.
+- iOS: a denied Local Network permission is now reported as an error instead of an empty discovery result.
+- All platforms validate service types, UTF-8 instance/TXT lengths and string-only TXT before stopping an active advertisement. Android now publishes TXT as well.
+
+- Electron: a malformed service type (e.g. `http`, `_http._xyz.`) is now rejected with an error instead of being silently advertised/browsed as `_http._tcp.`, matching iOS and Android. An invalid type no longer stops a broadcast that is already running.
+- All platforms reject invalid timeouts, clamp valid delays and use the same default broadcast name. A new valid `discover()` replaces its predecessor; errors return empty results. Dots and hyphens compare equally in name filters.
+- Electron: transport errors fail pending publication, name conflicts are reported explicitly, and discovery handles late address records. Destroy ends pending discoveries and late callbacks cannot mutate completed results.
+- Electron: manual IPC checks trusted top-level senders and event recipients.
+- npm archives exclude local audit files while retaining SwiftPM tests. Android declares coroutines directly and lint failures block builds. iOS requires version 15, matching Capacitor 8.
+
+### Changed
+
+- `bonjour-service` is declared as an optional peer dependency (needed by Electron apps only).
+- Electron: `new mDNS(bonjour?, options?)` accepts an injectable Bonjour implementation and timeouts for tests.
+- Android: NSD access moved behind an internal `NsdBackend` seam (`AndroidNsdBackend` in production) so the logic is unit-testable on the JVM.
+- iOS: `MDNS` exposes internal factories and timers for tests.
+- Removed the unused disabled Dependabot template and Android instrumentation placeholder. Playground lint uses the installed flat React configuration and ignores generated native projects.
+
+### Tests
+
+- Added deterministic Electron regressions for validation, publication/stop failures, replacement, late addresses, TTL expiry, IPC trust and bridge subscriptions, plus real network discovery tests.
+- Added JVM and iOS simulator regressions for callbacks, timeouts, replacement, UTF-8 validation, resolver scheduling, watcher cleanup and stale events. Removed template placeholder tests.
+
+## [0.1.0]
+
+Compared with `v0.0.3`.
+
+### Added
+
+- Added `getPluginPlatform()` to the public API, returning `ios`, `android`, `electron`, or `web` from the implementation that handled the call.
+- Added Capacitor Electron package exports, public Electron type declarations, plugin metadata for `devioarts/capacitor-electron`, and a dedicated Electron build step.
+- Added Electron IPC support for `getPluginPlatform()` and kept the manual preload bridge available through `electron/mdns-bridge.cjs`.
+- Added an in-repository playground app that exercises broadcast, discovery, Electron bridge usage, logging, and runtime platform detection.
+- Added focused docs for platform setup, Electron setup, playground usage, and runtime behavior.
+- Added Electron end-to-end tests for publish/discover/stop behavior, platform detection, invalid input handling, and overlapping broadcast calls.
+- Added GitHub issue templates, pull request template, CI workflow, a disabled Dependabot template, and funding metadata.
+
+### Changed
+
+- `startBroadcast()` on iOS, Android, and Electron is now guarded by a publish timeout so native/runtime callbacks cannot leave the JavaScript promise pending forever.
+- Starting a new advertisement now stops or replaces the previous active advertisement; the plugin keeps only one active broadcast at a time.
+- Discovery sessions are now timeboxed and clean up native listeners, browsers, service-info callbacks, and resolvers more reliably.
+- Overlapping discovery calls are serialized or safely isolated from stale callbacks, depending on platform behavior.
+- Service type and name inputs are trimmed and normalized consistently across supported platforms.
+- Port validation now requires values in the `1..65535` range.
+- Android now declares `INTERNET` and `CHANGE_WIFI_MULTICAST_STATE` permissions in the plugin manifest for merge during `npx cap sync`.
+- Package exports now expose the root plugin, Electron runtime entry points, Electron settings, the manual bridge, and `package.json`.
+- Build, clean, lint, and test scripts now include the Electron runtime and e2e test pipeline.
+- README setup and API documentation were regenerated and reorganized around the maintained in-repo playground and docs.
+
+### Fixed
+
+- Fixed web fallback behavior so unsupported browser calls return shaped errors instead of success-like results.
+- Fixed pending publish promises when iOS or Android publishing is stopped, replaced, fails, or times out.
+- Fixed Android discovery cleanup and listener handling to avoid old callbacks completing a newer request.
+- Fixed Android discovery failure reporting so start failures surface through the documented error shape.
+- Fixed iOS discovery session handling so stale NWBrowser, NetServiceBrowser, or resolver callbacks cannot complete a newer request.
+- Fixed iOS discovery failures to return an error result instead of silently completing as a clean empty search.
+- Fixed TXT record normalization on iOS and Electron so discovered values are returned as strings.
+- Fixed Electron broadcast stop/destroy handling to avoid orphaned Bonjour advertisers.

package/DevioartsCapacitorMdns.podspec

@@ -9,9 +9,9 @@ Pod::Spec.new do |s|
   s.license = package['license']
   s.homepage = package['repository']['url']
   s.author = package['author']
-  s.source = { :git => package['repository']['url'], :tag => s.version.to_s }
+  s.source = { :git => package['repository']['url'], :tag => "v#{s.version}" }
   s.source_files = 'ios/Sources/**/*.{swift,h,m,c,cc,mm,cpp}'
-  s.ios.deployment_target = '14.0'
-  s.dependency 'Capacitor'
+  s.ios.deployment_target = '15.0'
+  s.dependency 'Capacitor', '~> 8.0'
   s.swift_version = '5.1'
 end

package/Package.swift

@@ -3,7 +3,7 @@ import PackageDescription
 
 let package = Package(
     name: "DevioartsCapacitorMdns",
-    platforms: [.iOS(.v14)],
+    platforms: [.iOS(.v15)],
     products: [
         .library(
             name: "DevioartsCapacitorMdns",

package/README.md

@@ -1,9 +1,13 @@
 # @devioarts/capacitor-mdns
 
-mDNS plugin for Capacitor that supports Bonjour/mDNS advertisements and discovery.
+mDNS plugin for Capacitor that supports Bonjour/mDNS advertisements and discovery on iOS,
+Android, Electron, and a safe web fallback.
 
-#### Supported platforms: ✓ iOS ✓ Android ✓ Electron
-#### Demo (sources): [application](https://github.com/devioarts/capacitor-examples/tree/main/capacitor-mdns) or directly [file](https://github.com/devioarts/capacitor-examples/blob/main/capacitor-mdns/src/Playground.tsx)
+**Supported Capacitor version: v8. iOS 15 or later is required.**
+
+#### Supported platforms: ✓ iOS ✓ Android ✓ Electron ✓ Web fallback
+
+The in-repository [`playground`](./playground) is the example app used during development.
 
 ## Install
 
@@ -12,85 +16,88 @@ npm install @devioarts/capacitor-mdns
 npx cap sync
 ```
 
-## Android
-#### /android/app/src/main/AndroidManifest.xml
-```xml
-<uses-permission android:name="android.permission.INTERNET" />
-```
+For Electron, also install `bonjour-service@~1.4.0` and run `npx cap-electron sync`.
+See the [Electron setup](./docs/electron.md) for details.
 
-## iOS
-#### /ios/App/App/Info.plist
-```xml
-<key>NSLocalNetworkUsageDescription</key>
-<string>It is needed for the correct functioning of the application</string>
-<key>NSAppTransportSecurity</key>
-<dict>
-    <key>NSAllowsLocalNetworking</key>
-    <true/>
-</dict>
-<key>NSBonjourServices</key>
-<array>
-    <string>_http._tcp</string>
-</array>
-```
+## Upgrading from 0.1.0
+
+Version 0.2.0 retains the existing method signatures and result shapes and adds continuous
+discovery. It also tightens input validation, changes overlapping discovery and error handling,
+and raises the declared iOS minimum to 15.0. Review the
+[upgrade notes](./CHANGELOG.md#020---2026-11-07) before updating an existing application.
+
+## Usage
+
+```ts
+import { mDNS } from '@devioarts/capacitor-mdns';
 
----
-## ElectronJS
+const runtime = await mDNS.getPluginPlatform();
 
-```shell
-npm i bonjour-service@1.3.0
+await mDNS.startBroadcast({ type: '_http._tcp.', name: 'MyService', port: 9100 });
+const result = await mDNS.discover({ type: '_http._tcp.', timeout: 3000 });
+await mDNS.stopBroadcast();
 ```
 
-> Implementation example was developed on [capacitor-electron](https://github.com/devioarts/capacitor-examples/tree/main/capacitor-electron)
-> base, if you run electron differently, you may need to adjust the code.
+## Continuous discovery
 
-#### /electron/main.ts
+Thank you, [Idrimi](https://github.com/Idrimi), for contributing the original continuous discovery
+feature in [PR #7](https://github.com/devioarts/capacitor-mdns/pull/7).
 
-```typescript
-// ...
-import { mDNS } from '@devioarts/capacitor-mdns/electron/mdns'
-// ...
-const mdns = new mDNS();
-// ...
-app.whenReady().then(() => {
-	//...
-	mdns.init();
-	//...
+`watchServices()` monitors multiple service types on iOS, Android and Electron until stopped.
+Register listeners before starting; a new valid call replaces the previous watch.
+
+```ts
+const found = await mDNS.addListener('serviceFound', ({ service }) => {
+  console.log('Found', service.name, service.hosts, service.port);
 });
-/* Or you can use app.on:ready (whenReady is recomended)
-app.on('ready', () => {
-	// ...
-	mdns.init();
-	// ...
+const lost = await mDNS.addListener('serviceLost', ({ service }) => {
+  console.log('Lost', service.name, service.hosts, service.port);
 });
-*/
-
-app.on('before-quit', async () => {
-	// ...
-	mdns.destroy();
-	// ...
-})
-//...
-```
-### electron/preload.cjs
-```javascript
-//...
-// THIS IS IMPORTANT FOR PLUGIN!
-const {createMDNSAPI} = require("@devioarts/capacitor-mdns/electron/mdns-bridge.cjs");
-//...
-// THIS IS IMPORTANT FOR PLUGIN!
-contextBridge.exposeInMainWorld('mDNS', createMDNSAPI({ ipcRenderer }));
-contextBridge.exposeInMainWorld('mdns', createMDNSAPI({ ipcRenderer })) // alias
+const errors = await mDNS.addListener('watchError', (event) => {
+  console.error(event.type, event.errorMessage, event.watching);
+});
+
+const result = await mDNS.watchServices({
+  types: ['_http._tcp.', '_airplay._tcp.', '_googlecast._tcp.'],
+});
+// Later, including when leaving the screen:
+await mDNS.stopWatching();
+await Promise.all([found.remove(), lost.remove(), errors.remove()]);
 ```
 
----
+Found/lost events contain the full service snapshot; `hosts` is always an array. A service
+that disappears before resolving emits neither event. Browser errors stop watching and emit
+`watchError` with `watching: false`; exhausted resolution retries emit it with `watching: true`.
+`stopWatching()` leaves broadcasting and one-shot discovery running. Browsers do not support mDNS.
+
+## Platform Setup
+
+
+Android requires mDNS/network permissions in `AndroidManifest.xml`; the plugin also declares them
+so they are merged during sync. iOS requires local network keys in `Info.plist`.
+Electron support is intended for [`devioarts/capacitor-electron`](https://github.com/devioarts/capacitor-electron)
+and uses metadata exported from `@devioarts/capacitor-mdns/electron/settings`.
+
+Detailed setup lives in:
+
+- [iOS and Android setup](./docs/platform-setup.md)
+- [Electron setup](./docs/electron.md)
+- [Playground](./docs/playground.md)
+- [Runtime behavior](./docs/runtime-behavior.md)
+
 ## API
 
 <docgen-index>
 
+* [`getPluginPlatform()`](#getpluginplatform)
 * [`startBroadcast(...)`](#startbroadcast)
 * [`stopBroadcast()`](#stopbroadcast)
 * [`discover(...)`](#discover)
+* [`watchServices(...)`](#watchservices)
+* [`stopWatching()`](#stopwatching)
+* [`addListener('serviceFound' | 'serviceLost', ...)`](#addlistenerservicefound--servicelost-)
+* [`addListener('watchError', ...)`](#addlistenerwatcherror-)
+* [`removeAllListeners()`](#removealllisteners)
 * [Interfaces](#interfaces)
 * [Type Aliases](#type-aliases)
 
@@ -101,6 +108,19 @@ contextBridge.exposeInMainWorld('mdns', createMDNSAPI({ ipcRenderer })) // alias
 
 Public API surface of the Capacitor mDNS plugin.
 
+### getPluginPlatform()
+
+```typescript
+getPluginPlatform() => Promise<MdnsPluginPlatformResult>
+```
+
+Return the platform implementation currently serving plugin calls.
+
+**Returns:** <code>Promise&lt;<a href="#mdnspluginplatformresult">MdnsPluginPlatformResult</a>&gt;</code>
+
+--------------------
+
+
 ### startBroadcast(...)
 
 ```typescript
@@ -148,33 +168,118 @@ Discover services of a given type and optionally filter by instance name.
 --------------------
 
 
+### watchServices(...)
+
+```typescript
+watchServices(options: MdnsWatchOptions) => Promise<MdnsWatchResult>
+```
+
+Continuously watch several service types. A valid call replaces the previous watch.
+Register listeners before starting. Each resolved service emits `serviceFound` once;
+disappearance emits `serviceLost` with its last snapshot. No loss is emitted for an
+unresolved service. Watching and one-shot discovery can run together.
+Thanks to Idrimi for contributing the original continuous discovery feature (PR #7).
+
+| Param         | Type                                                          |
+| ------------- | ------------------------------------------------------------- |
+| **`options`** | <code><a href="#mdnswatchoptions">MdnsWatchOptions</a></code> |
+
+**Returns:** <code>Promise&lt;<a href="#mdnswatchresult">MdnsWatchResult</a>&gt;</code>
+
+--------------------
+
+
+### stopWatching()
+
+```typescript
+stopWatching() => Promise<MdnsWatchStopResult>
+```
+
+Stop all watchers. No events from that watch are emitted after this resolves.
+
+**Returns:** <code>Promise&lt;<a href="#mdnswatchstopresult">MdnsWatchStopResult</a>&gt;</code>
+
+--------------------
+
+
+### addListener('serviceFound' | 'serviceLost', ...)
+
+```typescript
+addListener(eventName: 'serviceFound' | 'serviceLost', handler: (event: MdnsServiceEvent) => void) => Promise<PluginListenerHandle>
+```
+
+| Param           | Type                                                                              |
+| --------------- | --------------------------------------------------------------------------------- |
+| **`eventName`** | <code>'serviceFound' \| 'serviceLost'</code>                                      |
+| **`handler`**   | <code>(event: <a href="#mdnsserviceevent">MdnsServiceEvent</a>) =&gt; void</code> |
+
+**Returns:** <code>Promise&lt;<a href="#pluginlistenerhandle">PluginListenerHandle</a>&gt;</code>
+
+--------------------
+
+
+### addListener('watchError', ...)
+
+```typescript
+addListener(eventName: 'watchError', handler: (event: MdnsWatchErrorEvent) => void) => Promise<PluginListenerHandle>
+```
+
+| Param           | Type                                                                                    |
+| --------------- | --------------------------------------------------------------------------------------- |
+| **`eventName`** | <code>'watchError'</code>                                                               |
+| **`handler`**   | <code>(event: <a href="#mdnswatcherrorevent">MdnsWatchErrorEvent</a>) =&gt; void</code> |
+
+**Returns:** <code>Promise&lt;<a href="#pluginlistenerhandle">PluginListenerHandle</a>&gt;</code>
+
+--------------------
+
+
+### removeAllListeners()
+
+```typescript
+removeAllListeners() => Promise<void>
+```
+
+--------------------
+
+
 ### Interfaces
 
 
+#### MdnsPluginPlatformResult
+
+Result of getPluginPlatform(). Useful for validating that calls are routed
+through the expected platform bridge.
+
+| Prop           | Type                                                              | Description                                        |
+| -------------- | ----------------------------------------------------------------- | -------------------------------------------------- |
+| **`platform`** | <code><a href="#mdnspluginplatform">MdnsPluginPlatform</a></code> | Platform implementation that produced this result. |
+
+
 #### MdnsBroadcastResult
 
 Result of startBroadcast(). Indicates whether advertising is active
 and the final service name. On failure, `error` is true and `errorMessage`
 describes the issue.
 
-| Prop               | Type                        | Description                                                          |
-| ------------------ | --------------------------- | -------------------------------------------------------------------- |
-| **`error`**        | <code>boolean</code>        | True if the operation failed.                                        |
-| **`errorMessage`** | <code>string \| null</code> | Error description or null on success.                                |
-| **`name`**         | <code>string</code>         | Final (possibly uniquified) service instance name. Empty on failure. |
-| **`publishing`**   | <code>boolean</code>        | Whether the advertiser is currently active.                          |
+| Prop               | Type                        | Description                                                                   |
+| ------------------ | --------------------------- | ----------------------------------------------------------------------------- |
+| **`error`**        | <code>boolean</code>        | True if the operation failed.                                                 |
+| **`errorMessage`** | <code>string \| null</code> | Error description or null on success.                                         |
+| **`name`**         | <code>string</code>         | Final (possibly uniquified) service instance name. Empty on failure.          |
+| **`publishing`**   | <code>boolean</code>        | Whether an advertiser is active, or may still be active after failed cleanup. |
 
 
 #### MdnsBroadcastOptions
 
 Options for starting a Bonjour/mDNS advertisement.
 
-| Prop       | Type                                        | Description                                   |
-| ---------- | ------------------------------------------- | --------------------------------------------- |
-| **`type`** | <code>string</code>                         | Service type (including the trailing dot).    |
-| **`name`** | <code>string</code>                         | Service instance name.                        |
-| **`port`** | <code>number</code>                         | TCP port to advertise.                        |
-| **`txt`**  | <code><a href="#mdnstxt">MdnsTxt</a></code> | Optional TXT key–value pairs (UTF-8 strings). |
+| Prop       | Type                                        | Description                                                                  |
+| ---------- | ------------------------------------------- | ---------------------------------------------------------------------------- |
+| **`type`** | <code>string</code>                         | Service type (including the trailing dot).                                   |
+| **`name`** | <code>string</code>                         | Service instance name (maximum 63 UTF-8 bytes). Defaults to `DevIOArtsMDNS`. |
+| **`port`** | <code>number</code>                         | TCP port to advertise.                                                       |
+| **`txt`**  | <code><a href="#mdnstxt">MdnsTxt</a></code> | Optional TXT key–value pairs (UTF-8 strings).                                |
 
 
 #### MdnsStopResult
@@ -182,23 +287,23 @@ Options for starting a Bonjour/mDNS advertisement.
 Result of stopBroadcast(). Indicates whether the advertiser is active
 after the call (normally false) and includes error information.
 
-| Prop               | Type                        | Description                                                         |
-| ------------------ | --------------------------- | ------------------------------------------------------------------- |
-| **`error`**        | <code>boolean</code>        | True if an error occurred while stopping.                           |
-| **`errorMessage`** | <code>string \| null</code> | Error description or null on success.                               |
-| **`publishing`**   | <code>boolean</code>        | Whether the advertiser remains active (should be false on success). |
+| Prop               | Type                        | Description                                                                                   |
+| ------------------ | --------------------------- | --------------------------------------------------------------------------------------------- |
+| **`error`**        | <code>boolean</code>        | True if an error occurred while stopping.                                                     |
+| **`errorMessage`** | <code>string \| null</code> | Error description or null on success.                                                         |
+| **`publishing`**   | <code>boolean</code>        | False after confirmed stop; true when stopping failed and the advertiser may still be active. |
 
 
 #### MdnsDiscoverResult
 
 Result of discover(). Contains normalized services and error information.
 
-| Prop                | Type                        | Description                                                                    |
-| ------------------- | --------------------------- | ------------------------------------------------------------------------------ |
-| **`error`**         | <code>boolean</code>        | True if discovery encountered an error (partial results may still be present). |
-| **`errorMessage`**  | <code>string \| null</code> | Error description or null when no error occurred.                              |
-| **`servicesFound`** | <code>number</code>         | Convenience count equal to services.length.                                    |
-| **`services`**      | <code>MdnsService[]</code>  | Normalized list of discovered services.                                        |
+| Prop                | Type                        | Description                                                                              |
+| ------------------- | --------------------------- | ---------------------------------------------------------------------------------------- |
+| **`error`**         | <code>boolean</code>        | True if discovery encountered an error (partial results may still be present).           |
+| **`errorMessage`**  | <code>string \| null</code> | Error description or null when no error occurred.                                        |
+| **`servicesFound`** | <code>number</code>         | Convenience count equal to services.length.                                              |
+| **`services`**      | <code>MdnsService[]</code>  | Resolved services with numeric addresses. Empty on error; partial results are discarded. |
 
 
 #### MdnsService
@@ -206,31 +311,97 @@ Result of discover(). Contains normalized services and error information.
 Normalized description of a discovered Bonjour/mDNS service.
 Returned from {@link mDNSPlugin.discover}.
 
-| Prop         | Type                                        | Description                                                                               |
-| ------------ | ------------------------------------------- | ----------------------------------------------------------------------------------------- |
-| **`name`**   | <code>string</code>                         | Instance name of the service (may be uniqued by the OS, e.g. "My App (2)").               |
-| **`type`**   | <code>string</code>                         | Full service type including the trailing dot, e.g. `"_http._tcp."`.                       |
-| **`domain`** | <code>string</code>                         | Service domain; typically `"local."`.                                                     |
-| **`port`**   | <code>number</code>                         | TCP port the service advertises.                                                          |
-| **`hosts`**  | <code>string[]</code>                       | Resolved numeric IP addresses (IPv4/IPv6).                                                |
-| **`txt`**    | <code><a href="#mdnstxt">MdnsTxt</a></code> | TXT dictionary (key → value). Usually present on iOS; Android NSD does not populate this. |
+| Prop           | Type                                        | Description                                                                           |
+| -------------- | ------------------------------------------- | ------------------------------------------------------------------------------------- |
+| **`name`**     | <code>string</code>                         | Instance name of the service (may be uniqued by the OS, e.g. "My App (2)").           |
+| **`type`**     | <code>string</code>                         | Full service type including the trailing dot, e.g. `"_http._tcp."`.                   |
+| **`domain`**   | <code>string</code>                         | Service domain; typically `"local."`.                                                 |
+| **`port`**     | <code>number</code>                         | Port the service advertises.                                                          |
+| **`hosts`**    | <code>string[]</code>                       | Resolved numeric IP addresses, IPv4 first, then IPv6 with any available scope suffix. |
+| **`hostname`** | <code>string</code>                         | Host name when supplied by the platform, e.g. `"my-device.local."`.                   |
+| **`txt`**      | <code><a href="#mdnstxt">MdnsTxt</a></code> | TXT dictionary (key → value).                                                         |
 
 
 #### MdnsDiscoverOptions
 
 Options for Bonjour/mDNS discovery.
 
-| Prop          | Type                 | Description                                                      |
-| ------------- | -------------------- | ---------------------------------------------------------------- |
-| **`type`**    | <code>string</code>  | Service type (including the trailing dot).                       |
-| **`name`**    | <code>string</code>  | Optional instance name filter (prefix-safe).                     |
-| **`timeout`** | <code>number</code>  | Discovery timeout in milliseconds.                               |
-| **`useNW`**   | <code>boolean</code> | iOS-only hint to use `NWBrowser` instead of `NetServiceBrowser`. |
+| Prop          | Type                 | Description                                                                                                               |
+| ------------- | -------------------- | ------------------------------------------------------------------------------------------------------------------------- |
+| **`type`**    | <code>string</code>  | Service type (including the trailing dot).                                                                                |
+| **`name`**    | <code>string</code>  | Optional instance name filter (prefix-safe).                                                                              |
+| **`timeout`** | <code>number</code>  | Discovery timeout in milliseconds. Finite numbers only; fractions are truncated and the delay is clamped to 0–2147483647. |
+| **`useNW`**   | <code>boolean</code> | iOS-only hint to use `NWBrowser` instead of `NetServiceBrowser`.                                                          |
+
+
+#### MdnsWatchResult
+
+Native browsers have been requested; later failures are reported through `watchError`.
+
+| Prop                  | Type                        |
+| --------------------- | --------------------------- |
+| **`error`**           | <code>boolean</code>        |
+| **`errorMessage`**    | <code>string \| null</code> |
+| **`watchersStarted`** | <code>number</code>         |
+
+
+#### MdnsWatchOptions
+
+Options for continuous discovery on iOS, Android and Electron.
+
+| Prop        | Type                  | Description                                                                        |
+| ----------- | --------------------- | ---------------------------------------------------------------------------------- |
+| **`types`** | <code>string[]</code> | Nonempty list of service types. Trailing dots are optional; duplicates are merged. |
+
+
+#### MdnsWatchStopResult
+
+Stops watching independently of any active broadcast.
+
+| Prop               | Type                        |
+| ------------------ | --------------------------- |
+| **`error`**        | <code>boolean</code>        |
+| **`errorMessage`** | <code>string \| null</code> |
+| **`watching`**     | <code>boolean</code>        |
+
+
+#### PluginListenerHandle
+
+| Prop         | Type                                      |
+| ------------ | ----------------------------------------- |
+| **`remove`** | <code>() =&gt; Promise&lt;void&gt;</code> |
+
+
+#### MdnsServiceEvent
+
+Both found and lost events contain a complete service snapshot, including `hosts`.
+
+| Prop          | Type                                                |
+| ------------- | --------------------------------------------------- |
+| **`service`** | <code><a href="#mdnsservice">MdnsService</a></code> |
+
+
+#### MdnsWatchErrorEvent
+
+Browser failures stop the watch; exhausted service resolution retries leave it running.
+
+| Prop               | Type                 |
+| ------------------ | -------------------- |
+| **`type`**         | <code>string</code>  |
+| **`errorMessage`** | <code>string</code>  |
+| **`watching`**     | <code>boolean</code> |
 
 
 ### Type Aliases
 
 
+#### MdnsPluginPlatform
+
+Runtime implementation that handled a plugin call.
+
+<code>'ios' | 'android' | 'electron' | 'web'</code>
+
+
 #### MdnsTxt
 
 Key–value map for TXT records of a Bonjour/mDNS service.

package/android/build.gradle

@@ -1,8 +1,6 @@
 ext {
     junitVersion = project.hasProperty('junitVersion') ? rootProject.ext.junitVersion : '4.13.2'
     androidxAppCompatVersion = project.hasProperty('androidxAppCompatVersion') ? rootProject.ext.androidxAppCompatVersion : '1.7.0'
-    androidxJunitVersion = project.hasProperty('androidxJunitVersion') ? rootProject.ext.androidxJunitVersion : '1.2.1'
-    androidxEspressoCoreVersion = project.hasProperty('androidxEspressoCoreVersion') ? rootProject.ext.androidxEspressoCoreVersion : '3.6.1'
 }
 
 buildscript {
@@ -25,9 +23,6 @@ android {
     defaultConfig {
         minSdk = project.hasProperty('minSdkVersion') ? rootProject.ext.minSdkVersion : 23
         targetSdk = project.hasProperty('targetSdkVersion') ? rootProject.ext.targetSdkVersion : 36
-        versionCode = 1
-        versionName = "1.0"
-        testInstrumentationRunner = "androidx.test.runner.AndroidJUnitRunner"
     }
     buildTypes {
         release {
@@ -36,7 +31,7 @@ android {
         }
     }
     lint {
-        abortOnError = false
+        abortOnError = true
     }
     compileOptions {
         sourceCompatibility JavaVersion.VERSION_21
@@ -55,10 +50,9 @@ repositories {
 
 
 dependencies {
-    implementation fileTree(dir: 'libs', include: ['*.jar'])
+    implementation "org.jetbrains.kotlinx:kotlinx-coroutines-android:1.8.1"
     implementation project(':capacitor-android')
     implementation "androidx.appcompat:appcompat:$androidxAppCompatVersion"
     testImplementation "junit:junit:$junitVersion"
-    androidTestImplementation "androidx.test.ext:junit:$androidxJunitVersion"
-    androidTestImplementation "androidx.test.espresso:espresso-core:$androidxEspressoCoreVersion"
+    testImplementation 'org.json:json:20250517'
 }

package/android/src/main/AndroidManifest.xml

@@ -1,2 +1,4 @@
 <manifest xmlns:android="http://schemas.android.com/apk/res/android">
+    <uses-permission android:name="android.permission.INTERNET" />
+    <uses-permission android:name="android.permission.CHANGE_WIFI_MULTICAST_STATE" />
 </manifest>