@devioarts/capacitor-mdns 0.0.2

package/dist/esm/definitions.d.ts

@@ -0,0 +1,190 @@
+/**
+ * Key–value map for TXT records of a Bonjour/mDNS service.
+ * Values are UTF-8 strings; binary payloads are not supported by this API.
+ * @public
+ */
+export declare type MdnsTxt = Record<string, string>;
+/**
+ * Normalized description of a discovered Bonjour/mDNS service.
+ * Returned from {@link mDNSPlugin.discover}.
+ *
+ * @remarks
+ * - `hosts` contains resolved IPv4/IPv6 numeric addresses (no DNS names).
+ * - iOS returns `txt` when present. Android (NSD) does not expose TXT records via public APIs,
+ *   so `txt` is usually omitted on Android.
+ * - `domain` is typically `"local."`.
+ *
+ * @public
+ */
+export interface MdnsService {
+    /** Instance name of the service (may be uniqued by the OS, e.g. "My App (2)"). */
+    name: string;
+    /** Full service type including the trailing dot, e.g. `"_http._tcp."`. */
+    type: string;
+    /** Service domain; typically `"local."`. */
+    domain: string;
+    /** TCP port the service advertises. */
+    port: number;
+    /**
+     * Resolved numeric IP addresses (IPv4/IPv6).
+     * @example
+     * `["192.168.1.42", "fe80::1234:abcd:..."]`
+     */
+    hosts: string[];
+    /**
+     * TXT dictionary (key → value). Usually present on iOS; Android NSD does not populate this.
+     * @remarks Not all services publish TXT data.
+     */
+    txt?: MdnsTxt;
+}
+/**
+ * Options for starting a Bonjour/mDNS advertisement.
+ *
+ * @remarks
+ * - 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.
+ *
+ * @public
+ */
+export interface MdnsBroadcastOptions {
+    /**
+     * Service type (including the trailing dot).
+     * @defaultValue `"_http._tcp."`
+     * @example `"_myapp._tcp."`
+     */
+    type?: string;
+    /**
+     * Service instance name.
+     */
+    name: string;
+    /**
+     * TCP port to advertise.
+     * @remarks Must be a positive integer (1–65535).
+     */
+    port: number;
+    /**
+     * Optional TXT key–value pairs (UTF-8 strings).
+     * @remarks May be ignored on Android due to platform limitations.
+     */
+    txt?: MdnsTxt;
+}
+/**
+ * Options for Bonjour/mDNS discovery.
+ *
+ * @remarks
+ * - The `id` 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.
+ *
+ * @public
+ */
+export interface MdnsDiscoverOptions {
+    /**
+     * Service type (including the trailing dot).
+     * @defaultValue `"_http._tcp."`
+     * @example `"_comm._tcp."`
+     */
+    type?: string;
+    /**
+     * Optional instance name filter (prefix-safe).
+     * @example `"MyAppName"`
+     */
+    name?: string;
+    /**
+     * Discovery timeout in milliseconds.
+     * @defaultValue `3000`
+     */
+    timeout?: number;
+    /**
+     * iOS-only hint to use `NWBrowser` instead of `NetServiceBrowser`.
+     * @defaultValue `true`
+     */
+    useNW?: boolean;
+}
+/**
+ * Result of startBroadcast(). Indicates whether advertising is active
+ * and the final service name. On failure, `error` is true and `errorMessage`
+ * describes the issue.
+ * @public
+ */
+export interface MdnsBroadcastResult {
+    /** True if the operation failed. */
+    error: boolean;
+    /** Error description or null on success. */
+    errorMessage: string | null;
+    /** Final (possibly uniquified) service instance name. Empty on failure. */
+    name: string;
+    /** Whether the advertiser is currently active. */
+    publishing: boolean;
+}
+/**
+ * Result of discover(). Contains normalized services and error information.
+ * @public
+ */
+export interface MdnsDiscoverResult {
+    /** True if discovery encountered an error (partial results may still be present). */
+    error: boolean;
+    /** Error description or null when no error occurred. */
+    errorMessage: string | null;
+    /** Convenience count equal to services.length. */
+    servicesFound: number;
+    /** Normalized list of discovered services. */
+    services: MdnsService[];
+}
+/**
+ * Result of stopBroadcast(). Indicates whether the advertiser is active
+ * after the call (normally false) and includes error information.
+ * @public
+ */
+export interface MdnsStopResult {
+    /** True if an error occurred while stopping. */
+    error: boolean;
+    /** Error description or null on success. */
+    errorMessage: string | null;
+    /** Whether the advertiser remains active (should be false on success). */
+    publishing: boolean;
+}
+/**
+ * Public API surface of the Capacitor mDNS plugin.
+ *
+ * @example
+ * ```ts
+ * import { mDNS } from 'capacitor-mdns';
+ *
+ * // Start advertising
+ * await mDNS.startBroadcast({ type: '_http._tcp.', name: 'my.app.id', port: 9235 });
+ *
+ * // Discover services
+ * const { services } = await mDNS.discover({ type: '_http._tcp.', timeout: 3000 });
+ *
+ * // Stop advertising
+ * await mDNS.stopBroadcast();
+ * ```
+ *
+ * @public
+ */
+export interface mDNSPlugin {
+    /**
+     * Start advertising a Bonjour/mDNS service.
+     *
+     * @param options - {@link MdnsBroadcastOptions}
+     * @returns Promise resolving to `MdnsBroadcastResult` (`true` on success).
+     */
+    startBroadcast(options: MdnsBroadcastOptions): Promise<MdnsBroadcastResult>;
+    /**
+     * Stop advertising the currently registered service (no-op if none).
+     *
+     * @returns Promise resolving to `MdnsStopResult`.
+     * @remarks The `publishing` flag may be `false` after a successful stop.
+     */
+    stopBroadcast(): Promise<MdnsStopResult>;
+    /**
+     * Discover services of a given type and optionally filter by instance name.
+     *
+     * @param options - {@link MdnsDiscoverOptions}
+     * @returns Promise resolving to `MdnsDiscoverResult`.
+     * @remarks The result list is normalized across platforms. On Android, `txt` is typically absent.
+     */
+    discover(options?: MdnsDiscoverOptions): Promise<MdnsDiscoverResult>;
+}

package/dist/esm/definitions.js

@@ -0,0 +1,3 @@
+// src/definitions.ts
+export {};
+//# sourceMappingURL=definitions.js.map

package/dist/esm/definitions.js.map

@@ -0,0 +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"]}

package/dist/esm/index.d.ts

@@ -0,0 +1,4 @@
+import type { mDNSPlugin } from './definitions';
+declare const mDNS: mDNSPlugin;
+export * from './definitions';
+export { mDNS };

package/dist/esm/index.js

@@ -0,0 +1,7 @@
+import { registerPlugin } from '@capacitor/core';
+const mDNS = registerPlugin('mDNS', {
+    web: () => import('./web').then((m) => new m.mDNSWeb()),
+});
+export * from './definitions';
+export { mDNS };
+//# sourceMappingURL=index.js.map

package/dist/esm/index.js.map

@@ -0,0 +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"]}

package/dist/esm/web.d.ts

@@ -0,0 +1,17 @@
+import { WebPlugin } from '@capacitor/core';
+import type { mDNSPlugin, MdnsBroadcastOptions, MdnsDiscoverOptions, MdnsBroadcastResult, MdnsStopResult, MdnsDiscoverResult } from './definitions';
+/**
+ * Web implementation of the mDNS plugin.
+ *
+ * This class behaves as a thin proxy:
+ * - In Electron (when a preload exposes window.mDNS/window.mdns), calls are forwarded over IPC.
+ * - In a regular browser, mDNS is not available; methods resolve with well-shaped stub values
+ *   and log a console message with the [WEB_NOT_SUPPORTED] tag.
+ */
+export declare class mDNSWeb extends WebPlugin implements mDNSPlugin {
+    /** Electron preload bridge (if present). */
+    private get electronApi();
+    startBroadcast(options: MdnsBroadcastOptions): Promise<MdnsBroadcastResult>;
+    stopBroadcast(): Promise<MdnsStopResult>;
+    discover(options?: MdnsDiscoverOptions): Promise<MdnsDiscoverResult>;
+}

package/dist/esm/web.js

@@ -0,0 +1,41 @@
+// src/web.ts
+import { WebPlugin } from '@capacitor/core';
+/**
+ * Web implementation of the mDNS plugin.
+ *
+ * This class behaves as a thin proxy:
+ * - In Electron (when a preload exposes window.mDNS/window.mdns), calls are forwarded over IPC.
+ * - In a regular browser, mDNS is not available; methods resolve with well-shaped stub values
+ *   and log a console message with the [WEB_NOT_SUPPORTED] tag.
+ */
+export class mDNSWeb extends WebPlugin {
+    /** Electron preload bridge (if present). */
+    get electronApi() {
+        if (typeof window === 'undefined')
+            return undefined;
+        return window.mDNS || window.mdns;
+    }
+    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 };
+    }
+    async stopBroadcast() {
+        const api = this.electronApi;
+        if (api === null || api === void 0 ? void 0 : api.stopBroadcast)
+            return api.stopBroadcast();
+        console.log('[WEB_NOT_SUPPORTED] stopBroadcast');
+        return { publishing: false, error: false, errorMessage: null };
+    }
+    async discover(options = {}) {
+        const api = this.electronApi;
+        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 };
+    }
+}
+//# sourceMappingURL=web.js.map

package/dist/esm/web.js.map

@@ -0,0 +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"]}

package/dist/plugin.cjs.js

@@ -0,0 +1,55 @@
+'use strict';
+
+var core = require('@capacitor/core');
+
+const mDNS = core.registerPlugin('mDNS', {
+    web: () => Promise.resolve().then(function () { return web; }).then((m) => new m.mDNSWeb()),
+});
+
+// src/web.ts
+/**
+ * Web implementation of the mDNS plugin.
+ *
+ * This class behaves as a thin proxy:
+ * - In Electron (when a preload exposes window.mDNS/window.mdns), calls are forwarded over IPC.
+ * - In a regular browser, mDNS is not available; methods resolve with well-shaped stub values
+ *   and log a console message with the [WEB_NOT_SUPPORTED] tag.
+ */
+class mDNSWeb extends core.WebPlugin {
+    /** Electron preload bridge (if present). */
+    get electronApi() {
+        if (typeof window === 'undefined')
+            return undefined;
+        return window.mDNS || window.mdns;
+    }
+    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 };
+    }
+    async stopBroadcast() {
+        const api = this.electronApi;
+        if (api === null || api === void 0 ? void 0 : api.stopBroadcast)
+            return api.stopBroadcast();
+        console.log('[WEB_NOT_SUPPORTED] stopBroadcast');
+        return { publishing: false, error: false, errorMessage: null };
+    }
+    async discover(options = {}) {
+        const api = this.electronApi;
+        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 };
+    }
+}
+
+var web = /*#__PURE__*/Object.freeze({
+    __proto__: null,
+    mDNSWeb: mDNSWeb
+});
+
+exports.mDNS = mDNS;
+//# sourceMappingURL=plugin.cjs.js.map

package/dist/plugin.cjs.js.map

@@ -0,0 +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;;;;;;;;;"}

package/dist/plugin.js

@@ -0,0 +1,58 @@
+var capacitormDNS = (function (exports, core) {
+    'use strict';
+
+    const mDNS = core.registerPlugin('mDNS', {
+        web: () => Promise.resolve().then(function () { return web; }).then((m) => new m.mDNSWeb()),
+    });
+
+    // src/web.ts
+    /**
+     * Web implementation of the mDNS plugin.
+     *
+     * This class behaves as a thin proxy:
+     * - In Electron (when a preload exposes window.mDNS/window.mdns), calls are forwarded over IPC.
+     * - In a regular browser, mDNS is not available; methods resolve with well-shaped stub values
+     *   and log a console message with the [WEB_NOT_SUPPORTED] tag.
+     */
+    class mDNSWeb extends core.WebPlugin {
+        /** Electron preload bridge (if present). */
+        get electronApi() {
+            if (typeof window === 'undefined')
+                return undefined;
+            return window.mDNS || window.mdns;
+        }
+        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 };
+        }
+        async stopBroadcast() {
+            const api = this.electronApi;
+            if (api === null || api === void 0 ? void 0 : api.stopBroadcast)
+                return api.stopBroadcast();
+            console.log('[WEB_NOT_SUPPORTED] stopBroadcast');
+            return { publishing: false, error: false, errorMessage: null };
+        }
+        async discover(options = {}) {
+            const api = this.electronApi;
+            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 };
+        }
+    }
+
+    var web = /*#__PURE__*/Object.freeze({
+        __proto__: null,
+        mDNSWeb: mDNSWeb
+    });
+
+    exports.mDNS = mDNS;
+
+    return exports;
+
+})({}, capacitorExports);
+//# sourceMappingURL=plugin.js.map

package/dist/plugin.js.map

@@ -0,0 +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;;;;;;;;;;;;;;;"}

package/electron/global.d.ts

@@ -0,0 +1,28 @@
+// electron/global.d.ts
+import type {
+  MdnsBroadcastOptions,
+  MdnsBroadcastResult,
+  MdnsDiscoverOptions,
+  MdnsDiscoverResult,
+  MdnsStopResult,
+} from '../src/definitions'; // Types only; no runtime import
+
+declare global {
+  interface Window {
+    /**
+     * Electron mDNS API bridge (preload). Mirrors Capacitor methods.
+     * Primary name with the same casing as iOS jsName.
+     */
+    mDNS: {
+      startBroadcast(options: MdnsBroadcastOptions): Promise<MdnsBroadcastResult>;
+      stopBroadcast(): Promise<MdnsStopResult>;
+      discover(options?: MdnsDiscoverOptions): Promise<MdnsDiscoverResult>;
+    };
+    /**
+     * Lowercase alias for convenience.
+     */
+    mdns: Window['mDNS'];
+  }
+}
+
+export {};

package/electron/mdns-bridge.cjs

@@ -0,0 +1,29 @@
+// electron/mdns-bridge.cjs
+// Usage in preload:
+//   const { createMDNSAPI } = require('.../electron/mdns-bridge.cjs')
+//   contextBridge.exposeInMainWorld('mDNS', createMDNSAPI({ ipcRenderer }))
+//   contextBridge.exposeInMainWorld('mdns', createMDNSAPI({ ipcRenderer })) // alias
+// eslint-disable-next-line no-undef
+module.exports.createMDNSAPI = ({ ipcRenderer }) => {
+  return {
+    /**
+     * Start advertising a Bonjour/mDNS service.
+     * @param {{type?: string, name: string, port: number, txt?: Record<string,string>}} options
+     * @returns {Promise<{publishing: boolean, name: string, error: boolean, errorMessage: string|null}>}
+     */
+    startBroadcast: (options) => ipcRenderer.invoke('mdns:startBroadcast', options),
+
+    /**
+     * Stop advertising (no-op if not running).
+     * @returns {Promise<{publishing: boolean}>}
+     */
+    stopBroadcast: () => ipcRenderer.invoke('mdns:stopBroadcast'),
+
+    /**
+     * Discover services of a given type, optional normalized exact/prefix name filter.
+     * @param {{type?: string, id?: string, timeoutMs?: number}} [options]
+     * @returns {Promise<{services: Array<{name:string,type:string,domain:string,port:number,hosts?:string[],txt?:Record<string,string>}>}>}
+     */
+    discover: (options) => ipcRenderer.invoke('mdns:discover', options),
+  }
+}