@devioarts/capacitor-mdns 0.0.2 → 0.1.0

package/android/src/main/java/com/devioarts/capacitor/mdns/mDNSPlugin.kt

@@ -26,7 +26,7 @@ import org.json.JSONObject
  * - discover       -> {
  *       error: boolean, errorMessage: string|null,
  *       servicesFound: number,
- *       services: Array<{ name, type, domain: "local.", port, hosts?: string[] }>
+ *       services: Array<{ name, type, domain: "local.", port, hosts: string[] }>
  *   }
  */
 @CapacitorPlugin(name = "mDNS")
@@ -52,6 +52,14 @@ class mDNSPlugin : Plugin() {
 
     private fun jnull(msg: String?): Any = msg ?: JSONObject.NULL
 
+    private fun normalizeType(raw: String?): String {
+        val type = raw?.trim()?.takeIf { it.isNotEmpty() } ?: "_http._tcp."
+        return if (type.endsWith(".")) type else "$type."
+    }
+
+    private fun normalizeName(raw: String?): String =
+        raw?.trim()?.takeIf { it.isNotEmpty() } ?: (context?.packageName ?: "DevIOArtsMDNS")
+
     private fun jsResultBroadcast(publishing: Boolean, name: String, error: Boolean, msg: String?): JSObject =
         JSObject().put("publishing", publishing)
             .put("name", name)
@@ -72,6 +80,11 @@ class mDNSPlugin : Plugin() {
 
     // ----------------------- API -----------------------
 
+    @PluginMethod
+    fun getPluginPlatform(call: PluginCall) {
+        call.resolve(JSObject().put("platform", "android"))
+    }
+
     /**
      * Start advertising a Bonjour/mDNS service.
      * - type: default "_http._tcp."
@@ -80,11 +93,11 @@ class mDNSPlugin : Plugin() {
      */
     @PluginMethod
     fun startBroadcast(call: PluginCall) {
-        val type = call.getString("type") ?: "_http._tcp."
-        val name = call.getString("name") ?: (context?.packageName ?: "DevIOArtsMDNS")
+        val type = normalizeType(call.getString("type"))
+        val name = normalizeName(call.getString("name"))
         val port = call.getInt("port") ?: 0
 
-        if (port <= 0) {
+        if (port !in 1..65535) {
             call.resolve(jsResultBroadcast(false, "", true, "Missing/invalid port"))
             return
         }
@@ -127,8 +140,8 @@ class mDNSPlugin : Plugin() {
      */
     @PluginMethod
     fun discover(call: PluginCall) {
-        val type = call.getString("type") ?: "_http._tcp."
-        val targetName = call.getString("name")
+        val type = normalizeType(call.getString("type"))
+        val targetName = call.getString("name")?.trim()?.takeIf { it.isNotEmpty() }
         val timeout = call.getInt("timeout") ?: 3000
 
         scope.launch {
@@ -139,10 +152,8 @@ class mDNSPlugin : Plugin() {
                         put("name", s.name)
                         put("type", s.type)         // Android returns full type with dot
                         put("domain", "local.")     // NSD is mDNS only
-                        // normalize hosts to [] or [addr]
                         val hosts = JSONArray()
-                        val addr = s.host
-                        if (!addr.isNullOrEmpty()) hosts.put(addr)
+                        s.hosts.forEach { hosts.put(it) }
                         put("hosts", hosts)
                         put("port", s.port)
                         // TXT not available via NSD -> omitted on Android

package/dist/docs.json

@@ -13,6 +13,23 @@
       }
     ],
     "methods": [
+      {
+        "name": "getPluginPlatform",
+        "signature": "() => Promise<MdnsPluginPlatformResult>",
+        "parameters": [],
+        "returns": "Promise<MdnsPluginPlatformResult>",
+        "tags": [
+          {
+            "name": "returns",
+            "text": "Promise resolving to `MdnsPluginPlatformResult`."
+          }
+        ],
+        "docs": "Return the platform implementation currently serving plugin calls.",
+        "complexTypes": [
+          "MdnsPluginPlatformResult"
+        ],
+        "slug": "getpluginplatform"
+      },
       {
         "name": "startBroadcast",
         "signature": "(options: MdnsBroadcastOptions) => Promise<MdnsBroadcastResult>",
@@ -53,7 +70,7 @@
           },
           {
             "name": "remarks",
-            "text": "The `publishing` flag may be `false` after a successful stop."
+            "text": "The `publishing` flag may be `false` after a successful stop.\nStopping is idempotent and is safe to call even if publishing never fully started."
           }
         ],
         "docs": "Stop advertising the currently registered service (no-op if none).",
@@ -98,6 +115,28 @@
     "properties": []
   },
   "interfaces": [
+    {
+      "name": "MdnsPluginPlatformResult",
+      "slug": "mdnspluginplatformresult",
+      "docs": "Result of getPluginPlatform(). Useful for validating that calls are routed\nthrough the expected platform bridge.",
+      "tags": [
+        {
+          "name": "public"
+        }
+      ],
+      "methods": [],
+      "properties": [
+        {
+          "name": "platform",
+          "tags": [],
+          "docs": "Platform implementation that produced this result.",
+          "complexTypes": [
+            "MdnsPluginPlatform"
+          ],
+          "type": "MdnsPluginPlatform"
+        }
+      ]
+    },
     {
       "name": "MdnsBroadcastResult",
       "slug": "mdnsbroadcastresult",
@@ -145,7 +184,7 @@
       "docs": "Options for starting a Bonjour/mDNS advertisement.",
       "tags": [
         {
-          "text": "- The `type` **must** end with a dot (`.`). If omitted, the implementation appends it.\n- Instance `name` should be short and human-readable; the OS may append `\" (n)\"` to ensure uniqueness.\n- Android NSD does not expose TXT records to other apps; advertising TXT is supported on iOS.",
+          "text": "- The `type` **must** end with a dot (`.`). If omitted, the implementation appends it.\n- Instance `name` should be short and human-readable; the OS may append `\" (n)\"` to ensure uniqueness.\n- Android NSD does not expose TXT records to other apps; advertising TXT is supported on iOS.\n- Native implementations guard publish with a timeout and return `error: true` instead of\n  leaving the Promise pending when the OS does not deliver a publish callback.\n- Only one advertisement is active at a time. Starting a new one stops the previous one first.",
           "name": "remarks"
         },
         {
@@ -359,7 +398,7 @@
       "docs": "Options for Bonjour/mDNS discovery.",
       "tags": [
         {
-          "text": "- The `id` filter matches the normalized name and also accepts prefix matches\n  (to handle OS-added `\" (n)\"` suffixes).\n- When `useNW` is `true` on iOS, discovery uses `NWBrowser` for better P2P behavior.",
+          "text": "- The `name` filter matches the normalized name and also accepts prefix matches\n  (to handle OS-added `\" (n)\"` suffixes).\n- When `useNW` is `true` on iOS, discovery uses `NWBrowser` for better P2P behavior.\n- Discovery is timeboxed. Concurrent discovery requests are serialized or safely replace\n  the previous native session so old callbacks cannot complete a newer request.",
           "name": "remarks"
         },
         {
@@ -425,6 +464,29 @@
   ],
   "enums": [],
   "typeAliases": [
+    {
+      "name": "MdnsPluginPlatform",
+      "slug": "mdnspluginplatform",
+      "docs": "Runtime implementation that handled a plugin call.",
+      "types": [
+        {
+          "text": "'ios'",
+          "complexTypes": []
+        },
+        {
+          "text": "'android'",
+          "complexTypes": []
+        },
+        {
+          "text": "'electron'",
+          "complexTypes": []
+        },
+        {
+          "text": "'web'",
+          "complexTypes": []
+        }
+      ]
+    },
     {
       "name": "MdnsTxt",
       "slug": "mdnstxt",

package/dist/esm/definitions.d.ts

@@ -3,7 +3,21 @@
  * Values are UTF-8 strings; binary payloads are not supported by this API.
  * @public
  */
-export declare type MdnsTxt = Record<string, string>;
+export type MdnsTxt = Record<string, string>;
+/**
+ * Runtime implementation that handled a plugin call.
+ * @public
+ */
+export type MdnsPluginPlatform = 'ios' | 'android' | 'electron' | 'web';
+/**
+ * Result of getPluginPlatform(). Useful for validating that calls are routed
+ * through the expected platform bridge.
+ * @public
+ */
+export interface MdnsPluginPlatformResult {
+    /** Platform implementation that produced this result. */
+    platform: MdnsPluginPlatform;
+}
 /**
  * Normalized description of a discovered Bonjour/mDNS service.
  * Returned from {@link mDNSPlugin.discover}.
@@ -44,6 +58,9 @@ export interface MdnsService {
  * - The `type` **must** end with a dot (`.`). If omitted, the implementation appends it.
  * - Instance `name` should be short and human-readable; the OS may append `" (n)"` to ensure uniqueness.
  * - Android NSD does not expose TXT records to other apps; advertising TXT is supported on iOS.
+ * - Native implementations guard publish with a timeout and return `error: true` instead of
+ *   leaving the Promise pending when the OS does not deliver a publish callback.
+ * - Only one advertisement is active at a time. Starting a new one stops the previous one first.
  *
  * @public
  */
@@ -73,9 +90,11 @@ export interface MdnsBroadcastOptions {
  * Options for Bonjour/mDNS discovery.
  *
  * @remarks
- * - The `id` filter matches the normalized name and also accepts prefix matches
+ * - The `name` filter matches the normalized name and also accepts prefix matches
  *   (to handle OS-added `" (n)"` suffixes).
  * - When `useNW` is `true` on iOS, discovery uses `NWBrowser` for better P2P behavior.
+ * - Discovery is timeboxed. Concurrent discovery requests are serialized or safely replace
+ *   the previous native session so old callbacks cannot complete a newer request.
  *
  * @public
  */
@@ -165,6 +184,12 @@ export interface MdnsStopResult {
  * @public
  */
 export interface mDNSPlugin {
+    /**
+     * Return the platform implementation currently serving plugin calls.
+     *
+     * @returns Promise resolving to `MdnsPluginPlatformResult`.
+     */
+    getPluginPlatform(): Promise<MdnsPluginPlatformResult>;
     /**
      * Start advertising a Bonjour/mDNS service.
      *
@@ -177,6 +202,7 @@ export interface mDNSPlugin {
      *
      * @returns Promise resolving to `MdnsStopResult`.
      * @remarks The `publishing` flag may be `false` after a successful stop.
+     * Stopping is idempotent and is safe to call even if publishing never fully started.
      */
     stopBroadcast(): Promise<MdnsStopResult>;
     /**

package/dist/esm/definitions.js.map

@@ -1 +1 @@
-{"version":3,"file":"definitions.js","sourceRoot":"","sources":["../../src/definitions.ts"],"names":[],"mappings":"AAAA,qBAAqB","sourcesContent":["// src/definitions.ts\n\n/**\n * Key–value map for TXT records of a Bonjour/mDNS service.\n * Values are UTF-8 strings; binary payloads are not supported by this API.\n * @public\n */\nexport type MdnsTxt = Record<string, string>;\n\n/**\n * Normalized description of a discovered Bonjour/mDNS service.\n * Returned from {@link mDNSPlugin.discover}.\n *\n * @remarks\n * - `hosts` contains resolved IPv4/IPv6 numeric addresses (no DNS names).\n * - iOS returns `txt` when present. Android (NSD) does not expose TXT records via public APIs,\n *   so `txt` is usually omitted on Android.\n * - `domain` is typically `\"local.\"`.\n *\n * @public\n */\nexport interface MdnsService {\n  /** Instance name of the service (may be uniqued by the OS, e.g. \"My App (2)\"). */\n  name: string;\n\n  /** Full service type including the trailing dot, e.g. `\"_http._tcp.\"`. */\n  type: string;\n\n  /** Service domain; typically `\"local.\"`. */\n  domain: string;\n\n  /** TCP port the service advertises. */\n  port: number;\n\n  /**\n   * Resolved numeric IP addresses (IPv4/IPv6).\n   * @example\n   * `[\"192.168.1.42\", \"fe80::1234:abcd:...\"]`\n   */\n  hosts: string[];\n\n  /**\n   * TXT dictionary (key → value). Usually present on iOS; Android NSD does not populate this.\n   * @remarks Not all services publish TXT data.\n   */\n  txt?: MdnsTxt;\n}\n\n/**\n * Options for starting a Bonjour/mDNS advertisement.\n *\n * @remarks\n * - The `type` **must** end with a dot (`.`). If omitted, the implementation appends it.\n * - Instance `name` should be short and human-readable; the OS may append `\" (n)\"` to ensure uniqueness.\n * - Android NSD does not expose TXT records to other apps; advertising TXT is supported on iOS.\n *\n * @public\n */\nexport interface MdnsBroadcastOptions {\n  /**\n   * Service type (including the trailing dot).\n   * @defaultValue `\"_http._tcp.\"`\n   * @example `\"_myapp._tcp.\"`\n   */\n  type?: string;\n\n  /**\n   * Service instance name.\n   */\n  name: string;\n\n  /**\n   * TCP port to advertise.\n   * @remarks Must be a positive integer (1–65535).\n   */\n  port: number;\n\n  /**\n   * Optional TXT key–value pairs (UTF-8 strings).\n   * @remarks May be ignored on Android due to platform limitations.\n   */\n  txt?: MdnsTxt;\n}\n\n/**\n * Options for Bonjour/mDNS discovery.\n *\n * @remarks\n * - The `id` filter matches the normalized name and also accepts prefix matches\n *   (to handle OS-added `\" (n)\"` suffixes).\n * - When `useNW` is `true` on iOS, discovery uses `NWBrowser` for better P2P behavior.\n *\n * @public\n */\nexport interface MdnsDiscoverOptions {\n  /**\n   * Service type (including the trailing dot).\n   * @defaultValue `\"_http._tcp.\"`\n   * @example `\"_comm._tcp.\"`\n   */\n  type?: string;\n\n  /**\n   * Optional instance name filter (prefix-safe).\n   * @example `\"MyAppName\"`\n   */\n  name?: string;\n\n  /**\n   * Discovery timeout in milliseconds.\n   * @defaultValue `3000`\n   */\n  timeout?: number;\n\n  /**\n   * iOS-only hint to use `NWBrowser` instead of `NetServiceBrowser`.\n   * @defaultValue `true`\n   */\n  useNW?: boolean;\n}\n\n/**\n * Result of startBroadcast(). Indicates whether advertising is active\n * and the final service name. On failure, `error` is true and `errorMessage`\n * describes the issue.\n * @public\n */\nexport interface MdnsBroadcastResult {\n  /** True if the operation failed. */\n  error: boolean;\n  /** Error description or null on success. */\n  errorMessage: string | null;\n  /** Final (possibly uniquified) service instance name. Empty on failure. */\n  name: string;\n  /** Whether the advertiser is currently active. */\n  publishing: boolean;\n}\n\n/**\n * Result of discover(). Contains normalized services and error information.\n * @public\n */\nexport interface MdnsDiscoverResult {\n  /** True if discovery encountered an error (partial results may still be present). */\n  error: boolean;\n  /** Error description or null when no error occurred. */\n  errorMessage: string | null;\n  /** Convenience count equal to services.length. */\n  servicesFound: number;\n  /** Normalized list of discovered services. */\n  services: MdnsService[];\n}\n\n/**\n * Result of stopBroadcast(). Indicates whether the advertiser is active\n * after the call (normally false) and includes error information.\n * @public\n */\nexport interface MdnsStopResult {\n  /** True if an error occurred while stopping. */\n  error: boolean;\n  /** Error description or null on success. */\n  errorMessage: string | null;\n  /** Whether the advertiser remains active (should be false on success). */\n  publishing: boolean;\n}\n\n/**\n * Public API surface of the Capacitor mDNS plugin.\n *\n * @example\n * ```ts\n * import { mDNS } from 'capacitor-mdns';\n *\n * // Start advertising\n * await mDNS.startBroadcast({ type: '_http._tcp.', name: 'my.app.id', port: 9235 });\n *\n * // Discover services\n * const { services } = await mDNS.discover({ type: '_http._tcp.', timeout: 3000 });\n *\n * // Stop advertising\n * await mDNS.stopBroadcast();\n * ```\n *\n * @public\n */\nexport interface mDNSPlugin {\n  /**\n   * Start advertising a Bonjour/mDNS service.\n   *\n   * @param options - {@link MdnsBroadcastOptions}\n   * @returns Promise resolving to `MdnsBroadcastResult` (`true` on success).\n   */\n  startBroadcast(options: MdnsBroadcastOptions): Promise<MdnsBroadcastResult>;\n\n  /**\n   * Stop advertising the currently registered service (no-op if none).\n   *\n   * @returns Promise resolving to `MdnsStopResult`.\n   * @remarks The `publishing` flag may be `false` after a successful stop.\n   */\n  stopBroadcast(): Promise<MdnsStopResult>;\n\n  /**\n   * Discover services of a given type and optionally filter by instance name.\n   *\n   * @param options - {@link MdnsDiscoverOptions}\n   * @returns Promise resolving to `MdnsDiscoverResult`.\n   * @remarks The result list is normalized across platforms. On Android, `txt` is typically absent.\n   */\n  discover(options?: MdnsDiscoverOptions): Promise<MdnsDiscoverResult>;\n}\n"]}
+{"version":3,"file":"definitions.js","sourceRoot":"","sources":["../../src/definitions.ts"],"names":[],"mappings":"AAAA,qBAAqB","sourcesContent":["// src/definitions.ts\n\n/**\n * Key–value map for TXT records of a Bonjour/mDNS service.\n * Values are UTF-8 strings; binary payloads are not supported by this API.\n * @public\n */\nexport type MdnsTxt = Record<string, string>;\n\n/**\n * Runtime implementation that handled a plugin call.\n * @public\n */\nexport type MdnsPluginPlatform = 'ios' | 'android' | 'electron' | 'web';\n\n/**\n * Result of getPluginPlatform(). Useful for validating that calls are routed\n * through the expected platform bridge.\n * @public\n */\nexport interface MdnsPluginPlatformResult {\n  /** Platform implementation that produced this result. */\n  platform: MdnsPluginPlatform;\n}\n\n/**\n * Normalized description of a discovered Bonjour/mDNS service.\n * Returned from {@link mDNSPlugin.discover}.\n *\n * @remarks\n * - `hosts` contains resolved IPv4/IPv6 numeric addresses (no DNS names).\n * - iOS returns `txt` when present. Android (NSD) does not expose TXT records via public APIs,\n *   so `txt` is usually omitted on Android.\n * - `domain` is typically `\"local.\"`.\n *\n * @public\n */\nexport interface MdnsService {\n  /** Instance name of the service (may be uniqued by the OS, e.g. \"My App (2)\"). */\n  name: string;\n\n  /** Full service type including the trailing dot, e.g. `\"_http._tcp.\"`. */\n  type: string;\n\n  /** Service domain; typically `\"local.\"`. */\n  domain: string;\n\n  /** TCP port the service advertises. */\n  port: number;\n\n  /**\n   * Resolved numeric IP addresses (IPv4/IPv6).\n   * @example\n   * `[\"192.168.1.42\", \"fe80::1234:abcd:...\"]`\n   */\n  hosts: string[];\n\n  /**\n   * TXT dictionary (key → value). Usually present on iOS; Android NSD does not populate this.\n   * @remarks Not all services publish TXT data.\n   */\n  txt?: MdnsTxt;\n}\n\n/**\n * Options for starting a Bonjour/mDNS advertisement.\n *\n * @remarks\n * - The `type` **must** end with a dot (`.`). If omitted, the implementation appends it.\n * - Instance `name` should be short and human-readable; the OS may append `\" (n)\"` to ensure uniqueness.\n * - Android NSD does not expose TXT records to other apps; advertising TXT is supported on iOS.\n * - Native implementations guard publish with a timeout and return `error: true` instead of\n *   leaving the Promise pending when the OS does not deliver a publish callback.\n * - Only one advertisement is active at a time. Starting a new one stops the previous one first.\n *\n * @public\n */\nexport interface MdnsBroadcastOptions {\n  /**\n   * Service type (including the trailing dot).\n   * @defaultValue `\"_http._tcp.\"`\n   * @example `\"_myapp._tcp.\"`\n   */\n  type?: string;\n\n  /**\n   * Service instance name.\n   */\n  name: string;\n\n  /**\n   * TCP port to advertise.\n   * @remarks Must be a positive integer (1–65535).\n   */\n  port: number;\n\n  /**\n   * Optional TXT key–value pairs (UTF-8 strings).\n   * @remarks May be ignored on Android due to platform limitations.\n   */\n  txt?: MdnsTxt;\n}\n\n/**\n * Options for Bonjour/mDNS discovery.\n *\n * @remarks\n * - The `name` filter matches the normalized name and also accepts prefix matches\n *   (to handle OS-added `\" (n)\"` suffixes).\n * - When `useNW` is `true` on iOS, discovery uses `NWBrowser` for better P2P behavior.\n * - Discovery is timeboxed. Concurrent discovery requests are serialized or safely replace\n *   the previous native session so old callbacks cannot complete a newer request.\n *\n * @public\n */\nexport interface MdnsDiscoverOptions {\n  /**\n   * Service type (including the trailing dot).\n   * @defaultValue `\"_http._tcp.\"`\n   * @example `\"_comm._tcp.\"`\n   */\n  type?: string;\n\n  /**\n   * Optional instance name filter (prefix-safe).\n   * @example `\"MyAppName\"`\n   */\n  name?: string;\n\n  /**\n   * Discovery timeout in milliseconds.\n   * @defaultValue `3000`\n   */\n  timeout?: number;\n\n  /**\n   * iOS-only hint to use `NWBrowser` instead of `NetServiceBrowser`.\n   * @defaultValue `true`\n   */\n  useNW?: boolean;\n}\n\n/**\n * Result of startBroadcast(). Indicates whether advertising is active\n * and the final service name. On failure, `error` is true and `errorMessage`\n * describes the issue.\n * @public\n */\nexport interface MdnsBroadcastResult {\n  /** True if the operation failed. */\n  error: boolean;\n  /** Error description or null on success. */\n  errorMessage: string | null;\n  /** Final (possibly uniquified) service instance name. Empty on failure. */\n  name: string;\n  /** Whether the advertiser is currently active. */\n  publishing: boolean;\n}\n\n/**\n * Result of discover(). Contains normalized services and error information.\n * @public\n */\nexport interface MdnsDiscoverResult {\n  /** True if discovery encountered an error (partial results may still be present). */\n  error: boolean;\n  /** Error description or null when no error occurred. */\n  errorMessage: string | null;\n  /** Convenience count equal to services.length. */\n  servicesFound: number;\n  /** Normalized list of discovered services. */\n  services: MdnsService[];\n}\n\n/**\n * Result of stopBroadcast(). Indicates whether the advertiser is active\n * after the call (normally false) and includes error information.\n * @public\n */\nexport interface MdnsStopResult {\n  /** True if an error occurred while stopping. */\n  error: boolean;\n  /** Error description or null on success. */\n  errorMessage: string | null;\n  /** Whether the advertiser remains active (should be false on success). */\n  publishing: boolean;\n}\n\n/**\n * Public API surface of the Capacitor mDNS plugin.\n *\n * @example\n * ```ts\n * import { mDNS } from 'capacitor-mdns';\n *\n * // Start advertising\n * await mDNS.startBroadcast({ type: '_http._tcp.', name: 'my.app.id', port: 9235 });\n *\n * // Discover services\n * const { services } = await mDNS.discover({ type: '_http._tcp.', timeout: 3000 });\n *\n * // Stop advertising\n * await mDNS.stopBroadcast();\n * ```\n *\n * @public\n */\nexport interface mDNSPlugin {\n  /**\n   * Return the platform implementation currently serving plugin calls.\n   *\n   * @returns Promise resolving to `MdnsPluginPlatformResult`.\n   */\n  getPluginPlatform(): Promise<MdnsPluginPlatformResult>;\n\n  /**\n   * Start advertising a Bonjour/mDNS service.\n   *\n   * @param options - {@link MdnsBroadcastOptions}\n   * @returns Promise resolving to `MdnsBroadcastResult` (`true` on success).\n   */\n  startBroadcast(options: MdnsBroadcastOptions): Promise<MdnsBroadcastResult>;\n\n  /**\n   * Stop advertising the currently registered service (no-op if none).\n   *\n   * @returns Promise resolving to `MdnsStopResult`.\n   * @remarks The `publishing` flag may be `false` after a successful stop.\n   * Stopping is idempotent and is safe to call even if publishing never fully started.\n   */\n  stopBroadcast(): Promise<MdnsStopResult>;\n\n  /**\n   * Discover services of a given type and optionally filter by instance name.\n   *\n   * @param options - {@link MdnsDiscoverOptions}\n   * @returns Promise resolving to `MdnsDiscoverResult`.\n   * @remarks The result list is normalized across platforms. On Android, `txt` is typically absent.\n   */\n  discover(options?: MdnsDiscoverOptions): Promise<MdnsDiscoverResult>;\n}\n"]}

package/dist/esm/index.js

@@ -1,6 +1,7 @@
 import { registerPlugin } from '@capacitor/core';
 const mDNS = registerPlugin('mDNS', {
     web: () => import('./web').then((m) => new m.mDNSWeb()),
+    electron: () => Promise.resolve(window.CapacitorCustomPlatform.plugins.mDNS),
 });
 export * from './definitions';
 export { mDNS };

package/dist/esm/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAIjD,MAAM,IAAI,GAAG,cAAc,CAAa,MAAM,EAAE;IAC9C,GAAG,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,CAAC;CACxD,CAAC,CAAC;AAEH,cAAc,eAAe,CAAC;AAC9B,OAAO,EAAE,IAAI,EAAE,CAAC","sourcesContent":["import { registerPlugin } from '@capacitor/core';\n\nimport type { mDNSPlugin } from './definitions';\n\nconst mDNS = registerPlugin<mDNSPlugin>('mDNS', {\n  web: () => import('./web').then((m) => new m.mDNSWeb()),\n});\n\nexport * from './definitions';\nexport { mDNS };\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAIjD,MAAM,IAAI,GAAG,cAAc,CAAa,MAAM,EAAE;IAC9C,GAAG,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,CAAC;IACvD,QAAQ,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,OAAO,CAAE,MAAc,CAAC,uBAAuB,CAAC,OAAO,CAAC,IAAkB,CAAC;CACpG,CAAC,CAAC;AAEH,cAAc,eAAe,CAAC;AAC9B,OAAO,EAAE,IAAI,EAAE,CAAC","sourcesContent":["import { registerPlugin } from '@capacitor/core';\n\nimport type { mDNSPlugin } from './definitions';\n\nconst mDNS = registerPlugin<mDNSPlugin>('mDNS', {\n  web: () => import('./web').then((m) => new m.mDNSWeb()),\n  electron: () => Promise.resolve((window as any).CapacitorCustomPlatform.plugins.mDNS as mDNSPlugin),\n});\n\nexport * from './definitions';\nexport { mDNS };\n"]}

package/dist/esm/web.d.ts

@@ -1,5 +1,5 @@
 import { WebPlugin } from '@capacitor/core';
-import type { mDNSPlugin, MdnsBroadcastOptions, MdnsDiscoverOptions, MdnsBroadcastResult, MdnsStopResult, MdnsDiscoverResult } from './definitions';
+import type { mDNSPlugin, MdnsBroadcastOptions, MdnsDiscoverOptions, MdnsBroadcastResult, MdnsStopResult, MdnsDiscoverResult, MdnsPluginPlatformResult } from './definitions';
 /**
  * Web implementation of the mDNS plugin.
  *
@@ -9,8 +9,10 @@ import type { mDNSPlugin, MdnsBroadcastOptions, MdnsDiscoverOptions, MdnsBroadca
  *   and log a console message with the [WEB_NOT_SUPPORTED] tag.
  */
 export declare class mDNSWeb extends WebPlugin implements mDNSPlugin {
+    private readonly unsupportedMessage;
     /** Electron preload bridge (if present). */
     private get electronApi();
+    getPluginPlatform(): Promise<MdnsPluginPlatformResult>;
     startBroadcast(options: MdnsBroadcastOptions): Promise<MdnsBroadcastResult>;
     stopBroadcast(): Promise<MdnsStopResult>;
     discover(options?: MdnsDiscoverOptions): Promise<MdnsDiscoverResult>;

package/dist/esm/web.js

@@ -9,19 +9,28 @@ import { WebPlugin } from '@capacitor/core';
  *   and log a console message with the [WEB_NOT_SUPPORTED] tag.
  */
 export class mDNSWeb extends WebPlugin {
+    constructor() {
+        super(...arguments);
+        this.unsupportedMessage = 'mDNS is not supported in this browser runtime';
+    }
     /** Electron preload bridge (if present). */
     get electronApi() {
         if (typeof window === 'undefined')
             return undefined;
         return window.mDNS || window.mdns;
     }
+    async getPluginPlatform() {
+        const api = this.electronApi;
+        if (api === null || api === void 0 ? void 0 : api.getPluginPlatform)
+            return api.getPluginPlatform();
+        return { platform: 'web' };
+    }
     async startBroadcast(options) {
         const api = this.electronApi;
         if (api === null || api === void 0 ? void 0 : api.startBroadcast)
             return api.startBroadcast(options);
         console.log('[WEB_NOT_SUPPORTED] startBroadcast', options);
-        // Keep the shape consistent even when not supported
-        return { publishing: true, name: '', error: false, errorMessage: null };
+        return { publishing: false, name: '', error: true, errorMessage: this.unsupportedMessage };
     }
     async stopBroadcast() {
         const api = this.electronApi;
@@ -35,7 +44,7 @@ export class mDNSWeb extends WebPlugin {
         if (api === null || api === void 0 ? void 0 : api.discover)
             return api.discover(options);
         console.log('[WEB_NOT_SUPPORTED] discover', options);
-        return { services: [], error: false, errorMessage: null, servicesFound: 0 };
+        return { services: [], error: true, errorMessage: this.unsupportedMessage, servicesFound: 0 };
     }
 }
 //# sourceMappingURL=web.js.map

package/dist/esm/web.js.map

@@ -1 +1 @@
-{"version":3,"file":"web.js","sourceRoot":"","sources":["../../src/web.ts"],"names":[],"mappings":"AAAA,aAAa;AACb,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAW5C;;;;;;;GAOG;AACH,MAAM,OAAO,OAAQ,SAAQ,SAAS;IACpC,4CAA4C;IAC5C,IAAY,WAAW;QAOrB,IAAI,OAAO,MAAM,KAAK,WAAW;YAAE,OAAO,SAAS,CAAC;QACpD,OAAQ,MAAc,CAAC,IAAI,IAAK,MAAc,CAAC,IAAI,CAAC;IACtD,CAAC;IAED,KAAK,CAAC,cAAc,CAAC,OAA6B;QAChD,MAAM,GAAG,GAAG,IAAI,CAAC,WAAW,CAAC;QAC7B,IAAI,GAAG,aAAH,GAAG,uBAAH,GAAG,CAAE,cAAc;YAAE,OAAO,GAAG,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC;QAC5D,OAAO,CAAC,GAAG,CAAC,oCAAoC,EAAE,OAAO,CAAC,CAAC;QAC3D,oDAAoD;QACpD,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,YAAY,EAAE,IAAI,EAAE,CAAC;IAC1E,CAAC;IAED,KAAK,CAAC,aAAa;QACjB,MAAM,GAAG,GAAG,IAAI,CAAC,WAAW,CAAC;QAC7B,IAAI,GAAG,aAAH,GAAG,uBAAH,GAAG,CAAE,aAAa;YAAE,OAAO,GAAG,CAAC,aAAa,EAAE,CAAC;QACnD,OAAO,CAAC,GAAG,CAAC,mCAAmC,CAAC,CAAC;QACjD,OAAO,EAAE,UAAU,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,YAAY,EAAE,IAAI,EAAE,CAAC;IACjE,CAAC;IAED,KAAK,CAAC,QAAQ,CAAC,UAA+B,EAAE;QAC9C,MAAM,GAAG,GAAG,IAAI,CAAC,WAAW,CAAC;QAC7B,IAAI,GAAG,aAAH,GAAG,uBAAH,GAAG,CAAE,QAAQ;YAAE,OAAO,GAAG,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;QAChD,OAAO,CAAC,GAAG,CAAC,8BAA8B,EAAE,OAAO,CAAC,CAAC;QACrD,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,YAAY,EAAE,IAAI,EAAE,aAAa,EAAE,CAAC,EAAE,CAAC;IAC9E,CAAC;CACF","sourcesContent":["// src/web.ts\nimport { WebPlugin } from '@capacitor/core';\n\nimport type {\n  mDNSPlugin,\n  MdnsBroadcastOptions,\n  MdnsDiscoverOptions,\n  MdnsBroadcastResult,\n  MdnsStopResult,\n  MdnsDiscoverResult,\n} from './definitions';\n\n/**\n * Web implementation of the mDNS plugin.\n *\n * This class behaves as a thin proxy:\n * - In Electron (when a preload exposes window.mDNS/window.mdns), calls are forwarded over IPC.\n * - In a regular browser, mDNS is not available; methods resolve with well-shaped stub values\n *   and log a console message with the [WEB_NOT_SUPPORTED] tag.\n */\nexport class mDNSWeb extends WebPlugin implements mDNSPlugin {\n  /** Electron preload bridge (if present). */\n  private get electronApi():\n    | undefined\n    | {\n        startBroadcast(o: MdnsBroadcastOptions): Promise<MdnsBroadcastResult>;\n        stopBroadcast(): Promise<MdnsStopResult>;\n        discover(o?: MdnsDiscoverOptions): Promise<MdnsDiscoverResult>;\n      } {\n    if (typeof window === 'undefined') return undefined;\n    return (window as any).mDNS || (window as any).mdns;\n  }\n\n  async startBroadcast(options: MdnsBroadcastOptions): Promise<MdnsBroadcastResult> {\n    const api = this.electronApi;\n    if (api?.startBroadcast) return api.startBroadcast(options);\n    console.log('[WEB_NOT_SUPPORTED] startBroadcast', options);\n    // Keep the shape consistent even when not supported\n    return { publishing: true, name: '', error: false, errorMessage: null };\n  }\n\n  async stopBroadcast(): Promise<MdnsStopResult> {\n    const api = this.electronApi;\n    if (api?.stopBroadcast) return api.stopBroadcast();\n    console.log('[WEB_NOT_SUPPORTED] stopBroadcast');\n    return { publishing: false, error: false, errorMessage: null };\n  }\n\n  async discover(options: MdnsDiscoverOptions = {}): Promise<MdnsDiscoverResult> {\n    const api = this.electronApi;\n    if (api?.discover) return api.discover(options);\n    console.log('[WEB_NOT_SUPPORTED] discover', options);\n    return { services: [], error: false, errorMessage: null, servicesFound: 0 };\n  }\n}\n"]}
+{"version":3,"file":"web.js","sourceRoot":"","sources":["../../src/web.ts"],"names":[],"mappings":"AAAA,aAAa;AACb,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAY5C;;;;;;;GAOG;AACH,MAAM,OAAO,OAAQ,SAAQ,SAAS;IAAtC;;QACmB,uBAAkB,GAAG,+CAA+C,CAAC;IAyCxF,CAAC;IAvCC,4CAA4C;IAC5C,IAAY,WAAW;QAQrB,IAAI,OAAO,MAAM,KAAK,WAAW;YAAE,OAAO,SAAS,CAAC;QACpD,OAAQ,MAAc,CAAC,IAAI,IAAK,MAAc,CAAC,IAAI,CAAC;IACtD,CAAC;IAED,KAAK,CAAC,iBAAiB;QACrB,MAAM,GAAG,GAAG,IAAI,CAAC,WAAW,CAAC;QAC7B,IAAI,GAAG,aAAH,GAAG,uBAAH,GAAG,CAAE,iBAAiB;YAAE,OAAO,GAAG,CAAC,iBAAiB,EAAE,CAAC;QAC3D,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC;IAC7B,CAAC;IAED,KAAK,CAAC,cAAc,CAAC,OAA6B;QAChD,MAAM,GAAG,GAAG,IAAI,CAAC,WAAW,CAAC;QAC7B,IAAI,GAAG,aAAH,GAAG,uBAAH,GAAG,CAAE,cAAc;YAAE,OAAO,GAAG,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC;QAC5D,OAAO,CAAC,GAAG,CAAC,oCAAoC,EAAE,OAAO,CAAC,CAAC;QAC3D,OAAO,EAAE,UAAU,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,YAAY,EAAE,IAAI,CAAC,kBAAkB,EAAE,CAAC;IAC7F,CAAC;IAED,KAAK,CAAC,aAAa;QACjB,MAAM,GAAG,GAAG,IAAI,CAAC,WAAW,CAAC;QAC7B,IAAI,GAAG,aAAH,GAAG,uBAAH,GAAG,CAAE,aAAa;YAAE,OAAO,GAAG,CAAC,aAAa,EAAE,CAAC;QACnD,OAAO,CAAC,GAAG,CAAC,mCAAmC,CAAC,CAAC;QACjD,OAAO,EAAE,UAAU,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,YAAY,EAAE,IAAI,EAAE,CAAC;IACjE,CAAC;IAED,KAAK,CAAC,QAAQ,CAAC,UAA+B,EAAE;QAC9C,MAAM,GAAG,GAAG,IAAI,CAAC,WAAW,CAAC;QAC7B,IAAI,GAAG,aAAH,GAAG,uBAAH,GAAG,CAAE,QAAQ;YAAE,OAAO,GAAG,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;QAChD,OAAO,CAAC,GAAG,CAAC,8BAA8B,EAAE,OAAO,CAAC,CAAC;QACrD,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,YAAY,EAAE,IAAI,CAAC,kBAAkB,EAAE,aAAa,EAAE,CAAC,EAAE,CAAC;IAChG,CAAC;CACF","sourcesContent":["// src/web.ts\nimport { WebPlugin } from '@capacitor/core';\n\nimport type {\n  mDNSPlugin,\n  MdnsBroadcastOptions,\n  MdnsDiscoverOptions,\n  MdnsBroadcastResult,\n  MdnsStopResult,\n  MdnsDiscoverResult,\n  MdnsPluginPlatformResult,\n} from './definitions';\n\n/**\n * Web implementation of the mDNS plugin.\n *\n * This class behaves as a thin proxy:\n * - In Electron (when a preload exposes window.mDNS/window.mdns), calls are forwarded over IPC.\n * - In a regular browser, mDNS is not available; methods resolve with well-shaped stub values\n *   and log a console message with the [WEB_NOT_SUPPORTED] tag.\n */\nexport class mDNSWeb extends WebPlugin implements mDNSPlugin {\n  private readonly unsupportedMessage = 'mDNS is not supported in this browser runtime';\n\n  /** Electron preload bridge (if present). */\n  private get electronApi():\n    | undefined\n    | {\n        startBroadcast(o: MdnsBroadcastOptions): Promise<MdnsBroadcastResult>;\n        stopBroadcast(): Promise<MdnsStopResult>;\n        discover(o?: MdnsDiscoverOptions): Promise<MdnsDiscoverResult>;\n        getPluginPlatform?(): Promise<MdnsPluginPlatformResult>;\n      } {\n    if (typeof window === 'undefined') return undefined;\n    return (window as any).mDNS || (window as any).mdns;\n  }\n\n  async getPluginPlatform(): Promise<MdnsPluginPlatformResult> {\n    const api = this.electronApi;\n    if (api?.getPluginPlatform) return api.getPluginPlatform();\n    return { platform: 'web' };\n  }\n\n  async startBroadcast(options: MdnsBroadcastOptions): Promise<MdnsBroadcastResult> {\n    const api = this.electronApi;\n    if (api?.startBroadcast) return api.startBroadcast(options);\n    console.log('[WEB_NOT_SUPPORTED] startBroadcast', options);\n    return { publishing: false, name: '', error: true, errorMessage: this.unsupportedMessage };\n  }\n\n  async stopBroadcast(): Promise<MdnsStopResult> {\n    const api = this.electronApi;\n    if (api?.stopBroadcast) return api.stopBroadcast();\n    console.log('[WEB_NOT_SUPPORTED] stopBroadcast');\n    return { publishing: false, error: false, errorMessage: null };\n  }\n\n  async discover(options: MdnsDiscoverOptions = {}): Promise<MdnsDiscoverResult> {\n    const api = this.electronApi;\n    if (api?.discover) return api.discover(options);\n    console.log('[WEB_NOT_SUPPORTED] discover', options);\n    return { services: [], error: true, errorMessage: this.unsupportedMessage, servicesFound: 0 };\n  }\n}\n"]}

package/dist/plugin.cjs.js

@@ -4,6 +4,7 @@ var core = require('@capacitor/core');
 
 const mDNS = core.registerPlugin('mDNS', {
     web: () => Promise.resolve().then(function () { return web; }).then((m) => new m.mDNSWeb()),
+    electron: () => Promise.resolve(window.CapacitorCustomPlatform.plugins.mDNS),
 });
 
 // src/web.ts
@@ -16,19 +17,28 @@ const mDNS = core.registerPlugin('mDNS', {
  *   and log a console message with the [WEB_NOT_SUPPORTED] tag.
  */
 class mDNSWeb extends core.WebPlugin {
+    constructor() {
+        super(...arguments);
+        this.unsupportedMessage = 'mDNS is not supported in this browser runtime';
+    }
     /** Electron preload bridge (if present). */
     get electronApi() {
         if (typeof window === 'undefined')
             return undefined;
         return window.mDNS || window.mdns;
     }
+    async getPluginPlatform() {
+        const api = this.electronApi;
+        if (api === null || api === void 0 ? void 0 : api.getPluginPlatform)
+            return api.getPluginPlatform();
+        return { platform: 'web' };
+    }
     async startBroadcast(options) {
         const api = this.electronApi;
         if (api === null || api === void 0 ? void 0 : api.startBroadcast)
             return api.startBroadcast(options);
         console.log('[WEB_NOT_SUPPORTED] startBroadcast', options);
-        // Keep the shape consistent even when not supported
-        return { publishing: true, name: '', error: false, errorMessage: null };
+        return { publishing: false, name: '', error: true, errorMessage: this.unsupportedMessage };
     }
     async stopBroadcast() {
         const api = this.electronApi;
@@ -42,7 +52,7 @@ class mDNSWeb extends core.WebPlugin {
         if (api === null || api === void 0 ? void 0 : api.discover)
             return api.discover(options);
         console.log('[WEB_NOT_SUPPORTED] discover', options);
-        return { services: [], error: false, errorMessage: null, servicesFound: 0 };
+        return { services: [], error: true, errorMessage: this.unsupportedMessage, servicesFound: 0 };
     }
 }
 

package/dist/plugin.cjs.js.map

@@ -1 +1 @@
-{"version":3,"file":"plugin.cjs.js","sources":["esm/index.js","esm/web.js"],"sourcesContent":["import { registerPlugin } from '@capacitor/core';\nconst mDNS = registerPlugin('mDNS', {\n    web: () => import('./web').then((m) => new m.mDNSWeb()),\n});\nexport * from './definitions';\nexport { mDNS };\n//# sourceMappingURL=index.js.map","// src/web.ts\nimport { WebPlugin } from '@capacitor/core';\n/**\n * Web implementation of the mDNS plugin.\n *\n * This class behaves as a thin proxy:\n * - In Electron (when a preload exposes window.mDNS/window.mdns), calls are forwarded over IPC.\n * - In a regular browser, mDNS is not available; methods resolve with well-shaped stub values\n *   and log a console message with the [WEB_NOT_SUPPORTED] tag.\n */\nexport class mDNSWeb extends WebPlugin {\n    /** Electron preload bridge (if present). */\n    get electronApi() {\n        if (typeof window === 'undefined')\n            return undefined;\n        return window.mDNS || window.mdns;\n    }\n    async startBroadcast(options) {\n        const api = this.electronApi;\n        if (api === null || api === void 0 ? void 0 : api.startBroadcast)\n            return api.startBroadcast(options);\n        console.log('[WEB_NOT_SUPPORTED] startBroadcast', options);\n        // Keep the shape consistent even when not supported\n        return { publishing: true, name: '', error: false, errorMessage: null };\n    }\n    async stopBroadcast() {\n        const api = this.electronApi;\n        if (api === null || api === void 0 ? void 0 : api.stopBroadcast)\n            return api.stopBroadcast();\n        console.log('[WEB_NOT_SUPPORTED] stopBroadcast');\n        return { publishing: false, error: false, errorMessage: null };\n    }\n    async discover(options = {}) {\n        const api = this.electronApi;\n        if (api === null || api === void 0 ? void 0 : api.discover)\n            return api.discover(options);\n        console.log('[WEB_NOT_SUPPORTED] discover', options);\n        return { services: [], error: false, errorMessage: null, servicesFound: 0 };\n    }\n}\n//# sourceMappingURL=web.js.map"],"names":["registerPlugin","WebPlugin"],"mappings":";;;;AACK,MAAC,IAAI,GAAGA,mBAAc,CAAC,MAAM,EAAE;AACpC,IAAI,GAAG,EAAE,MAAM,mDAAe,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,OAAO,EAAE,CAAC;AAC3D,CAAC;;ACHD;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,MAAM,OAAO,SAASC,cAAS,CAAC;AACvC;AACA,IAAI,IAAI,WAAW,GAAG;AACtB,QAAQ,IAAI,OAAO,MAAM,KAAK,WAAW;AACzC,YAAY,OAAO,SAAS;AAC5B,QAAQ,OAAO,MAAM,CAAC,IAAI,IAAI,MAAM,CAAC,IAAI;AACzC,IAAI;AACJ,IAAI,MAAM,cAAc,CAAC,OAAO,EAAE;AAClC,QAAQ,MAAM,GAAG,GAAG,IAAI,CAAC,WAAW;AACpC,QAAQ,IAAI,GAAG,KAAK,IAAI,IAAI,GAAG,KAAK,MAAM,GAAG,MAAM,GAAG,GAAG,CAAC,cAAc;AACxE,YAAY,OAAO,GAAG,CAAC,cAAc,CAAC,OAAO,CAAC;AAC9C,QAAQ,OAAO,CAAC,GAAG,CAAC,oCAAoC,EAAE,OAAO,CAAC;AAClE;AACA,QAAQ,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,YAAY,EAAE,IAAI,EAAE;AAC/E,IAAI;AACJ,IAAI,MAAM,aAAa,GAAG;AAC1B,QAAQ,MAAM,GAAG,GAAG,IAAI,CAAC,WAAW;AACpC,QAAQ,IAAI,GAAG,KAAK,IAAI,IAAI,GAAG,KAAK,MAAM,GAAG,MAAM,GAAG,GAAG,CAAC,aAAa;AACvE,YAAY,OAAO,GAAG,CAAC,aAAa,EAAE;AACtC,QAAQ,OAAO,CAAC,GAAG,CAAC,mCAAmC,CAAC;AACxD,QAAQ,OAAO,EAAE,UAAU,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,YAAY,EAAE,IAAI,EAAE;AACtE,IAAI;AACJ,IAAI,MAAM,QAAQ,CAAC,OAAO,GAAG,EAAE,EAAE;AACjC,QAAQ,MAAM,GAAG,GAAG,IAAI,CAAC,WAAW;AACpC,QAAQ,IAAI,GAAG,KAAK,IAAI,IAAI,GAAG,KAAK,MAAM,GAAG,MAAM,GAAG,GAAG,CAAC,QAAQ;AAClE,YAAY,OAAO,GAAG,CAAC,QAAQ,CAAC,OAAO,CAAC;AACxC,QAAQ,OAAO,CAAC,GAAG,CAAC,8BAA8B,EAAE,OAAO,CAAC;AAC5D,QAAQ,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,YAAY,EAAE,IAAI,EAAE,aAAa,EAAE,CAAC,EAAE;AACnF,IAAI;AACJ;;;;;;;;;"}
+{"version":3,"file":"plugin.cjs.js","sources":["esm/index.js","esm/web.js"],"sourcesContent":["import { registerPlugin } from '@capacitor/core';\nconst mDNS = registerPlugin('mDNS', {\n    web: () => import('./web').then((m) => new m.mDNSWeb()),\n    electron: () => Promise.resolve(window.CapacitorCustomPlatform.plugins.mDNS),\n});\nexport * from './definitions';\nexport { mDNS };\n//# sourceMappingURL=index.js.map","// src/web.ts\nimport { WebPlugin } from '@capacitor/core';\n/**\n * Web implementation of the mDNS plugin.\n *\n * This class behaves as a thin proxy:\n * - In Electron (when a preload exposes window.mDNS/window.mdns), calls are forwarded over IPC.\n * - In a regular browser, mDNS is not available; methods resolve with well-shaped stub values\n *   and log a console message with the [WEB_NOT_SUPPORTED] tag.\n */\nexport class mDNSWeb extends WebPlugin {\n    constructor() {\n        super(...arguments);\n        this.unsupportedMessage = 'mDNS is not supported in this browser runtime';\n    }\n    /** Electron preload bridge (if present). */\n    get electronApi() {\n        if (typeof window === 'undefined')\n            return undefined;\n        return window.mDNS || window.mdns;\n    }\n    async getPluginPlatform() {\n        const api = this.electronApi;\n        if (api === null || api === void 0 ? void 0 : api.getPluginPlatform)\n            return api.getPluginPlatform();\n        return { platform: 'web' };\n    }\n    async startBroadcast(options) {\n        const api = this.electronApi;\n        if (api === null || api === void 0 ? void 0 : api.startBroadcast)\n            return api.startBroadcast(options);\n        console.log('[WEB_NOT_SUPPORTED] startBroadcast', options);\n        return { publishing: false, name: '', error: true, errorMessage: this.unsupportedMessage };\n    }\n    async stopBroadcast() {\n        const api = this.electronApi;\n        if (api === null || api === void 0 ? void 0 : api.stopBroadcast)\n            return api.stopBroadcast();\n        console.log('[WEB_NOT_SUPPORTED] stopBroadcast');\n        return { publishing: false, error: false, errorMessage: null };\n    }\n    async discover(options = {}) {\n        const api = this.electronApi;\n        if (api === null || api === void 0 ? void 0 : api.discover)\n            return api.discover(options);\n        console.log('[WEB_NOT_SUPPORTED] discover', options);\n        return { services: [], error: true, errorMessage: this.unsupportedMessage, servicesFound: 0 };\n    }\n}\n//# sourceMappingURL=web.js.map"],"names":["registerPlugin","WebPlugin"],"mappings":";;;;AACK,MAAC,IAAI,GAAGA,mBAAc,CAAC,MAAM,EAAE;AACpC,IAAI,GAAG,EAAE,MAAM,mDAAe,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,OAAO,EAAE,CAAC;AAC3D,IAAI,QAAQ,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,uBAAuB,CAAC,OAAO,CAAC,IAAI,CAAC;AAChF,CAAC;;ACJD;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,MAAM,OAAO,SAASC,cAAS,CAAC;AACvC,IAAI,WAAW,GAAG;AAClB,QAAQ,KAAK,CAAC,GAAG,SAAS,CAAC;AAC3B,QAAQ,IAAI,CAAC,kBAAkB,GAAG,+CAA+C;AACjF,IAAI;AACJ;AACA,IAAI,IAAI,WAAW,GAAG;AACtB,QAAQ,IAAI,OAAO,MAAM,KAAK,WAAW;AACzC,YAAY,OAAO,SAAS;AAC5B,QAAQ,OAAO,MAAM,CAAC,IAAI,IAAI,MAAM,CAAC,IAAI;AACzC,IAAI;AACJ,IAAI,MAAM,iBAAiB,GAAG;AAC9B,QAAQ,MAAM,GAAG,GAAG,IAAI,CAAC,WAAW;AACpC,QAAQ,IAAI,GAAG,KAAK,IAAI,IAAI,GAAG,KAAK,MAAM,GAAG,MAAM,GAAG,GAAG,CAAC,iBAAiB;AAC3E,YAAY,OAAO,GAAG,CAAC,iBAAiB,EAAE;AAC1C,QAAQ,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE;AAClC,IAAI;AACJ,IAAI,MAAM,cAAc,CAAC,OAAO,EAAE;AAClC,QAAQ,MAAM,GAAG,GAAG,IAAI,CAAC,WAAW;AACpC,QAAQ,IAAI,GAAG,KAAK,IAAI,IAAI,GAAG,KAAK,MAAM,GAAG,MAAM,GAAG,GAAG,CAAC,cAAc;AACxE,YAAY,OAAO,GAAG,CAAC,cAAc,CAAC,OAAO,CAAC;AAC9C,QAAQ,OAAO,CAAC,GAAG,CAAC,oCAAoC,EAAE,OAAO,CAAC;AAClE,QAAQ,OAAO,EAAE,UAAU,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,YAAY,EAAE,IAAI,CAAC,kBAAkB,EAAE;AAClG,IAAI;AACJ,IAAI,MAAM,aAAa,GAAG;AAC1B,QAAQ,MAAM,GAAG,GAAG,IAAI,CAAC,WAAW;AACpC,QAAQ,IAAI,GAAG,KAAK,IAAI,IAAI,GAAG,KAAK,MAAM,GAAG,MAAM,GAAG,GAAG,CAAC,aAAa;AACvE,YAAY,OAAO,GAAG,CAAC,aAAa,EAAE;AACtC,QAAQ,OAAO,CAAC,GAAG,CAAC,mCAAmC,CAAC;AACxD,QAAQ,OAAO,EAAE,UAAU,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,YAAY,EAAE,IAAI,EAAE;AACtE,IAAI;AACJ,IAAI,MAAM,QAAQ,CAAC,OAAO,GAAG,EAAE,EAAE;AACjC,QAAQ,MAAM,GAAG,GAAG,IAAI,CAAC,WAAW;AACpC,QAAQ,IAAI,GAAG,KAAK,IAAI,IAAI,GAAG,KAAK,MAAM,GAAG,MAAM,GAAG,GAAG,CAAC,QAAQ;AAClE,YAAY,OAAO,GAAG,CAAC,QAAQ,CAAC,OAAO,CAAC;AACxC,QAAQ,OAAO,CAAC,GAAG,CAAC,8BAA8B,EAAE,OAAO,CAAC;AAC5D,QAAQ,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,YAAY,EAAE,IAAI,CAAC,kBAAkB,EAAE,aAAa,EAAE,CAAC,EAAE;AACrG,IAAI;AACJ;;;;;;;;;"}

package/dist/plugin.js

@@ -3,6 +3,7 @@ var capacitormDNS = (function (exports, core) {
 
     const mDNS = core.registerPlugin('mDNS', {
         web: () => Promise.resolve().then(function () { return web; }).then((m) => new m.mDNSWeb()),
+        electron: () => Promise.resolve(window.CapacitorCustomPlatform.plugins.mDNS),
     });
 
     // src/web.ts
@@ -15,19 +16,28 @@ var capacitormDNS = (function (exports, core) {
      *   and log a console message with the [WEB_NOT_SUPPORTED] tag.
      */
     class mDNSWeb extends core.WebPlugin {
+        constructor() {
+            super(...arguments);
+            this.unsupportedMessage = 'mDNS is not supported in this browser runtime';
+        }
         /** Electron preload bridge (if present). */
         get electronApi() {
             if (typeof window === 'undefined')
                 return undefined;
             return window.mDNS || window.mdns;
         }
+        async getPluginPlatform() {
+            const api = this.electronApi;
+            if (api === null || api === void 0 ? void 0 : api.getPluginPlatform)
+                return api.getPluginPlatform();
+            return { platform: 'web' };
+        }
         async startBroadcast(options) {
             const api = this.electronApi;
             if (api === null || api === void 0 ? void 0 : api.startBroadcast)
                 return api.startBroadcast(options);
             console.log('[WEB_NOT_SUPPORTED] startBroadcast', options);
-            // Keep the shape consistent even when not supported
-            return { publishing: true, name: '', error: false, errorMessage: null };
+            return { publishing: false, name: '', error: true, errorMessage: this.unsupportedMessage };
         }
         async stopBroadcast() {
             const api = this.electronApi;
@@ -41,7 +51,7 @@ var capacitormDNS = (function (exports, core) {
             if (api === null || api === void 0 ? void 0 : api.discover)
                 return api.discover(options);
             console.log('[WEB_NOT_SUPPORTED] discover', options);
-            return { services: [], error: false, errorMessage: null, servicesFound: 0 };
+            return { services: [], error: true, errorMessage: this.unsupportedMessage, servicesFound: 0 };
         }
     }
 

package/dist/plugin.js.map

@@ -1 +1 @@
-{"version":3,"file":"plugin.js","sources":["esm/index.js","esm/web.js"],"sourcesContent":["import { registerPlugin } from '@capacitor/core';\nconst mDNS = registerPlugin('mDNS', {\n    web: () => import('./web').then((m) => new m.mDNSWeb()),\n});\nexport * from './definitions';\nexport { mDNS };\n//# sourceMappingURL=index.js.map","// src/web.ts\nimport { WebPlugin } from '@capacitor/core';\n/**\n * Web implementation of the mDNS plugin.\n *\n * This class behaves as a thin proxy:\n * - In Electron (when a preload exposes window.mDNS/window.mdns), calls are forwarded over IPC.\n * - In a regular browser, mDNS is not available; methods resolve with well-shaped stub values\n *   and log a console message with the [WEB_NOT_SUPPORTED] tag.\n */\nexport class mDNSWeb extends WebPlugin {\n    /** Electron preload bridge (if present). */\n    get electronApi() {\n        if (typeof window === 'undefined')\n            return undefined;\n        return window.mDNS || window.mdns;\n    }\n    async startBroadcast(options) {\n        const api = this.electronApi;\n        if (api === null || api === void 0 ? void 0 : api.startBroadcast)\n            return api.startBroadcast(options);\n        console.log('[WEB_NOT_SUPPORTED] startBroadcast', options);\n        // Keep the shape consistent even when not supported\n        return { publishing: true, name: '', error: false, errorMessage: null };\n    }\n    async stopBroadcast() {\n        const api = this.electronApi;\n        if (api === null || api === void 0 ? void 0 : api.stopBroadcast)\n            return api.stopBroadcast();\n        console.log('[WEB_NOT_SUPPORTED] stopBroadcast');\n        return { publishing: false, error: false, errorMessage: null };\n    }\n    async discover(options = {}) {\n        const api = this.electronApi;\n        if (api === null || api === void 0 ? void 0 : api.discover)\n            return api.discover(options);\n        console.log('[WEB_NOT_SUPPORTED] discover', options);\n        return { services: [], error: false, errorMessage: null, servicesFound: 0 };\n    }\n}\n//# sourceMappingURL=web.js.map"],"names":["registerPlugin","WebPlugin"],"mappings":";;;AACK,UAAC,IAAI,GAAGA,mBAAc,CAAC,MAAM,EAAE;IACpC,IAAI,GAAG,EAAE,MAAM,mDAAe,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,OAAO,EAAE,CAAC;IAC3D,CAAC;;ICHD;IAEA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACO,MAAM,OAAO,SAASC,cAAS,CAAC;IACvC;IACA,IAAI,IAAI,WAAW,GAAG;IACtB,QAAQ,IAAI,OAAO,MAAM,KAAK,WAAW;IACzC,YAAY,OAAO,SAAS;IAC5B,QAAQ,OAAO,MAAM,CAAC,IAAI,IAAI,MAAM,CAAC,IAAI;IACzC,IAAI;IACJ,IAAI,MAAM,cAAc,CAAC,OAAO,EAAE;IAClC,QAAQ,MAAM,GAAG,GAAG,IAAI,CAAC,WAAW;IACpC,QAAQ,IAAI,GAAG,KAAK,IAAI,IAAI,GAAG,KAAK,MAAM,GAAG,MAAM,GAAG,GAAG,CAAC,cAAc;IACxE,YAAY,OAAO,GAAG,CAAC,cAAc,CAAC,OAAO,CAAC;IAC9C,QAAQ,OAAO,CAAC,GAAG,CAAC,oCAAoC,EAAE,OAAO,CAAC;IAClE;IACA,QAAQ,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,YAAY,EAAE,IAAI,EAAE;IAC/E,IAAI;IACJ,IAAI,MAAM,aAAa,GAAG;IAC1B,QAAQ,MAAM,GAAG,GAAG,IAAI,CAAC,WAAW;IACpC,QAAQ,IAAI,GAAG,KAAK,IAAI,IAAI,GAAG,KAAK,MAAM,GAAG,MAAM,GAAG,GAAG,CAAC,aAAa;IACvE,YAAY,OAAO,GAAG,CAAC,aAAa,EAAE;IACtC,QAAQ,OAAO,CAAC,GAAG,CAAC,mCAAmC,CAAC;IACxD,QAAQ,OAAO,EAAE,UAAU,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,YAAY,EAAE,IAAI,EAAE;IACtE,IAAI;IACJ,IAAI,MAAM,QAAQ,CAAC,OAAO,GAAG,EAAE,EAAE;IACjC,QAAQ,MAAM,GAAG,GAAG,IAAI,CAAC,WAAW;IACpC,QAAQ,IAAI,GAAG,KAAK,IAAI,IAAI,GAAG,KAAK,MAAM,GAAG,MAAM,GAAG,GAAG,CAAC,QAAQ;IAClE,YAAY,OAAO,GAAG,CAAC,QAAQ,CAAC,OAAO,CAAC;IACxC,QAAQ,OAAO,CAAC,GAAG,CAAC,8BAA8B,EAAE,OAAO,CAAC;IAC5D,QAAQ,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,YAAY,EAAE,IAAI,EAAE,aAAa,EAAE,CAAC,EAAE;IACnF,IAAI;IACJ;;;;;;;;;;;;;;;"}
+{"version":3,"file":"plugin.js","sources":["esm/index.js","esm/web.js"],"sourcesContent":["import { registerPlugin } from '@capacitor/core';\nconst mDNS = registerPlugin('mDNS', {\n    web: () => import('./web').then((m) => new m.mDNSWeb()),\n    electron: () => Promise.resolve(window.CapacitorCustomPlatform.plugins.mDNS),\n});\nexport * from './definitions';\nexport { mDNS };\n//# sourceMappingURL=index.js.map","// src/web.ts\nimport { WebPlugin } from '@capacitor/core';\n/**\n * Web implementation of the mDNS plugin.\n *\n * This class behaves as a thin proxy:\n * - In Electron (when a preload exposes window.mDNS/window.mdns), calls are forwarded over IPC.\n * - In a regular browser, mDNS is not available; methods resolve with well-shaped stub values\n *   and log a console message with the [WEB_NOT_SUPPORTED] tag.\n */\nexport class mDNSWeb extends WebPlugin {\n    constructor() {\n        super(...arguments);\n        this.unsupportedMessage = 'mDNS is not supported in this browser runtime';\n    }\n    /** Electron preload bridge (if present). */\n    get electronApi() {\n        if (typeof window === 'undefined')\n            return undefined;\n        return window.mDNS || window.mdns;\n    }\n    async getPluginPlatform() {\n        const api = this.electronApi;\n        if (api === null || api === void 0 ? void 0 : api.getPluginPlatform)\n            return api.getPluginPlatform();\n        return { platform: 'web' };\n    }\n    async startBroadcast(options) {\n        const api = this.electronApi;\n        if (api === null || api === void 0 ? void 0 : api.startBroadcast)\n            return api.startBroadcast(options);\n        console.log('[WEB_NOT_SUPPORTED] startBroadcast', options);\n        return { publishing: false, name: '', error: true, errorMessage: this.unsupportedMessage };\n    }\n    async stopBroadcast() {\n        const api = this.electronApi;\n        if (api === null || api === void 0 ? void 0 : api.stopBroadcast)\n            return api.stopBroadcast();\n        console.log('[WEB_NOT_SUPPORTED] stopBroadcast');\n        return { publishing: false, error: false, errorMessage: null };\n    }\n    async discover(options = {}) {\n        const api = this.electronApi;\n        if (api === null || api === void 0 ? void 0 : api.discover)\n            return api.discover(options);\n        console.log('[WEB_NOT_SUPPORTED] discover', options);\n        return { services: [], error: true, errorMessage: this.unsupportedMessage, servicesFound: 0 };\n    }\n}\n//# sourceMappingURL=web.js.map"],"names":["registerPlugin","WebPlugin"],"mappings":";;;AACK,UAAC,IAAI,GAAGA,mBAAc,CAAC,MAAM,EAAE;IACpC,IAAI,GAAG,EAAE,MAAM,mDAAe,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,OAAO,EAAE,CAAC;IAC3D,IAAI,QAAQ,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,uBAAuB,CAAC,OAAO,CAAC,IAAI,CAAC;IAChF,CAAC;;ICJD;IAEA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACO,MAAM,OAAO,SAASC,cAAS,CAAC;IACvC,IAAI,WAAW,GAAG;IAClB,QAAQ,KAAK,CAAC,GAAG,SAAS,CAAC;IAC3B,QAAQ,IAAI,CAAC,kBAAkB,GAAG,+CAA+C;IACjF,IAAI;IACJ;IACA,IAAI,IAAI,WAAW,GAAG;IACtB,QAAQ,IAAI,OAAO,MAAM,KAAK,WAAW;IACzC,YAAY,OAAO,SAAS;IAC5B,QAAQ,OAAO,MAAM,CAAC,IAAI,IAAI,MAAM,CAAC,IAAI;IACzC,IAAI;IACJ,IAAI,MAAM,iBAAiB,GAAG;IAC9B,QAAQ,MAAM,GAAG,GAAG,IAAI,CAAC,WAAW;IACpC,QAAQ,IAAI,GAAG,KAAK,IAAI,IAAI,GAAG,KAAK,MAAM,GAAG,MAAM,GAAG,GAAG,CAAC,iBAAiB;IAC3E,YAAY,OAAO,GAAG,CAAC,iBAAiB,EAAE;IAC1C,QAAQ,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE;IAClC,IAAI;IACJ,IAAI,MAAM,cAAc,CAAC,OAAO,EAAE;IAClC,QAAQ,MAAM,GAAG,GAAG,IAAI,CAAC,WAAW;IACpC,QAAQ,IAAI,GAAG,KAAK,IAAI,IAAI,GAAG,KAAK,MAAM,GAAG,MAAM,GAAG,GAAG,CAAC,cAAc;IACxE,YAAY,OAAO,GAAG,CAAC,cAAc,CAAC,OAAO,CAAC;IAC9C,QAAQ,OAAO,CAAC,GAAG,CAAC,oCAAoC,EAAE,OAAO,CAAC;IAClE,QAAQ,OAAO,EAAE,UAAU,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,YAAY,EAAE,IAAI,CAAC,kBAAkB,EAAE;IAClG,IAAI;IACJ,IAAI,MAAM,aAAa,GAAG;IAC1B,QAAQ,MAAM,GAAG,GAAG,IAAI,CAAC,WAAW;IACpC,QAAQ,IAAI,GAAG,KAAK,IAAI,IAAI,GAAG,KAAK,MAAM,GAAG,MAAM,GAAG,GAAG,CAAC,aAAa;IACvE,YAAY,OAAO,GAAG,CAAC,aAAa,EAAE;IACtC,QAAQ,OAAO,CAAC,GAAG,CAAC,mCAAmC,CAAC;IACxD,QAAQ,OAAO,EAAE,UAAU,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,YAAY,EAAE,IAAI,EAAE;IACtE,IAAI;IACJ,IAAI,MAAM,QAAQ,CAAC,OAAO,GAAG,EAAE,EAAE;IACjC,QAAQ,MAAM,GAAG,GAAG,IAAI,CAAC,WAAW;IACpC,QAAQ,IAAI,GAAG,KAAK,IAAI,IAAI,GAAG,KAAK,MAAM,GAAG,MAAM,GAAG,GAAG,CAAC,QAAQ;IAClE,YAAY,OAAO,GAAG,CAAC,QAAQ,CAAC,OAAO,CAAC;IACxC,QAAQ,OAAO,CAAC,GAAG,CAAC,8BAA8B,EAAE,OAAO,CAAC;IAC5D,QAAQ,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,YAAY,EAAE,IAAI,CAAC,kBAAkB,EAAE,aAAa,EAAE,CAAC,EAAE;IACrG,IAAI;IACJ;;;;;;;;;;;;;;;"}

package/docs/electron.md

@@ -0,0 +1,65 @@
+# Electron setup
+
+Electron support is maintained for
+[`devioarts/capacitor-electron`](https://github.com/devioarts/capacitor-electron).
+
+## Capacitor Electron
+
+Use the root package API in application code, the same as iOS and Android:
+
+```ts
+import { mDNS } from '@devioarts/capacitor-mdns';
+
+await mDNS.startBroadcast({ type: '_http._tcp.', name: 'MyService', port: 9100 });
+const platform = await mDNS.getPluginPlatform();
+```
+
+The Electron runtime generator reads plugin metadata from:
+
+```ts
+import { pluginSettings } from '@devioarts/capacitor-mdns/electron/settings';
+```
+
+The Electron main-process plugin class is exported from:
+
+```ts
+import { mDNS } from '@devioarts/capacitor-mdns/electron';
+```
+
+## Manual bridge
+
+The older manual bridge remains available for apps that do not use
+`devioarts/capacitor-electron`.
+
+Install the runtime Bonjour dependency in the Electron app:
+
+```shell
+npm i bonjour-service@1.4.0
+```
+
+### Main process
+
+```ts
+import { app } from 'electron';
+import { mDNS } from '@devioarts/capacitor-mdns/electron';
+
+const mdns = new mDNS();
+
+app.whenReady().then(() => {
+  mdns.init();
+});
+
+app.on('before-quit', async () => {
+  await mdns.destroy();
+});
+```
+
+### Preload
+
+```js
+const { contextBridge, ipcRenderer } = require('electron');
+const { createMDNSAPI } = require('@devioarts/capacitor-mdns/electron/mdns-bridge.cjs');
+
+contextBridge.exposeInMainWorld('mDNS', createMDNSAPI({ ipcRenderer }));
+contextBridge.exposeInMainWorld('mdns', createMDNSAPI({ ipcRenderer }));
+```

package/docs/platform-setup.md

@@ -0,0 +1,52 @@
+# Platform setup
+
+## Android
+
+Add the mDNS/network permissions to your Android manifest.
+
+`android/app/src/main/AndroidManifest.xml`
+
+```xml
+<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" />
+
+  <application>
+    <!-- Your app configuration -->
+  </application>
+</manifest>
+```
+
+The plugin also declares these permissions in its own Android manifest, so they
+are merged into your app during `npx cap sync`. Keeping them in your app
+manifest is still useful when you want the native project to show the network
+requirements explicitly.
+
+On some devices, mDNS discovery can still return no results if multicast traffic is blocked by the
+network, router, VPN, or device policy.
+
+The plugin does not request location or `NEARBY_WIFI_DEVICES` by default. Add
+those only if your app has separate Wi-Fi scanning or nearby-device features
+that require them.
+
+## iOS
+
+Add the local network permissions and every Bonjour service type your app uses to
+`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>
+```
+
+For a custom service such as `_capmdnse2e._tcp.`, add `_capmdnse2e._tcp` to
+`NSBonjourServices`.