@cappitolian/http-local-server-swifter 0.0.25 → 0.0.26

package/dist/docs.json

@@ -39,27 +39,12 @@
         ],
         "returns": "Promise<void>",
         "tags": [],
-        "docs": "Sends a response back to the client.\nSupports status and headers to handle CORS Preflight correctly.",
+        "docs": "Sends a response back to the client.\nNow supports status and headers to handle CORS Preflight correctly.",
         "complexTypes": [
           "HttpSendResponseOptions"
         ],
         "slug": "sendresponse"
       },
-      {
-        "name": "openSettings",
-        "signature": "() => Promise<void>",
-        "parameters": [],
-        "returns": "Promise<void>",
-        "tags": [
-          {
-            "name": "example",
-            "text": "try {\n  await HttpLocalServerSwifter.connect();\n} catch (error) {\n  if (error.message === 'LOCAL_NETWORK_PERMISSION_DENIED') {\n    await HttpLocalServerSwifter.openSettings();\n  }\n}"
-          }
-        ],
-        "docs": "Opens the app's page in iOS Settings so the user can manually grant\nLocal Network permission after having denied it.\n\nOnly relevant on iOS — on Android this is a no-op.",
-        "complexTypes": [],
-        "slug": "opensettings"
-      },
       {
         "name": "addListener",
         "signature": "(eventName: 'onRequest', listenerFunc: (data: HttpRequestData) => void | Promise<void>) => Promise<PluginListenerHandle>",
@@ -145,14 +130,14 @@
         {
           "name": "status",
           "tags": [],
-          "docs": "HTTP Status code (e.g., 200, 204, 404).\nDefault is 200.",
+          "docs": "* NEW: HTTP Status code (e.g., 200, 204, 404). \nDefault is 200.",
           "complexTypes": [],
           "type": "number | undefined"
         },
         {
           "name": "headers",
           "tags": [],
-          "docs": "Custom HTTP headers.\nCrucial for fixing CORS by providing 'Access-Control-Allow-Origin'.",
+          "docs": "* NEW: Custom HTTP headers.\nCrucial for fixing CORS by providing 'Access-Control-Allow-Origin'.",
           "complexTypes": [
             "Record"
           ],

package/dist/esm/definitions.d.ts

@@ -20,13 +20,11 @@ export interface HttpSendResponseOptions {
     requestId: string;
     /** The response body (usually stringified JSON) */
     body: string;
-    /**
-     * HTTP Status code (e.g., 200, 204, 404).
+    /** * NEW: HTTP Status code (e.g., 200, 204, 404).
      * Default is 200.
      */
     status?: number;
-    /**
-     * Custom HTTP headers.
+    /** * NEW: Custom HTTP headers.
      * Crucial for fixing CORS by providing 'Access-Control-Allow-Origin'.
      */
     headers?: Record<string, string>;
@@ -36,25 +34,9 @@ export interface HttpLocalServerSwifterPlugin {
     disconnect(): Promise<void>;
     /**
      * Sends a response back to the client.
-     * Supports status and headers to handle CORS Preflight correctly.
+     * Now supports status and headers to handle CORS Preflight correctly.
      */
     sendResponse(options: HttpSendResponseOptions): Promise<void>;
-    /**
-     * Opens the app's page in iOS Settings so the user can manually grant
-     * Local Network permission after having denied it.
-     *
-     * Only relevant on iOS — on Android this is a no-op.
-     *
-     * @example
-     * try {
-     *   await HttpLocalServerSwifter.connect();
-     * } catch (error) {
-     *   if (error.message === 'LOCAL_NETWORK_PERMISSION_DENIED') {
-     *     await HttpLocalServerSwifter.openSettings();
-     *   }
-     * }
-     */
-    openSettings(): Promise<void>;
     addListener(eventName: 'onRequest', listenerFunc: (data: HttpRequestData) => void | Promise<void>): Promise<PluginListenerHandle>;
     removeAllListeners(): Promise<void>;
 }

package/dist/esm/definitions.js.map

@@ -1 +1 @@
-{"version":3,"file":"definitions.js","sourceRoot":"","sources":["../../src/definitions.ts"],"names":[],"mappings":"","sourcesContent":["import type { PluginListenerHandle } from '@capacitor/core';\n\nexport interface HttpConnectResult {\n  ip: string;\n  port: number;\n}\n\nexport interface HttpRequestData {\n  requestId: string;\n  method: string;\n  path: string;\n  body?: string;\n  headers?: Record<string, string>;\n  query?: Record<string, string>;\n}\n\n/**\n * Options for sending an HTTP response.\n * Updated to support custom status codes and headers for CORS.\n */\nexport interface HttpSendResponseOptions {\n  /** The ID received in the 'onRequest' event */\n  requestId: string;\n\n  /** The response body (usually stringified JSON) */\n  body: string;\n\n  /**\n   * HTTP Status code (e.g., 200, 204, 404).\n   * Default is 200.\n   */\n  status?: number;\n\n  /**\n   * Custom HTTP headers.\n   * Crucial for fixing CORS by providing 'Access-Control-Allow-Origin'.\n   */\n  headers?: Record<string, string>;\n}\n\nexport interface HttpLocalServerSwifterPlugin {\n  connect(): Promise<HttpConnectResult>;\n  disconnect(): Promise<void>;\n\n  /**\n   * Sends a response back to the client.\n   * Supports status and headers to handle CORS Preflight correctly.\n   */\n  sendResponse(options: HttpSendResponseOptions): Promise<void>;\n\n  /**\n   * Opens the app's page in iOS Settings so the user can manually grant\n   * Local Network permission after having denied it.\n   *\n   * Only relevant on iOS — on Android this is a no-op.\n   *\n   * @example\n   * try {\n   *   await HttpLocalServerSwifter.connect();\n   * } catch (error) {\n   *   if (error.message === 'LOCAL_NETWORK_PERMISSION_DENIED') {\n   *     await HttpLocalServerSwifter.openSettings();\n   *   }\n   * }\n   */\n  openSettings(): Promise<void>;\n\n  addListener(\n    eventName: 'onRequest',\n    listenerFunc: (data: HttpRequestData) => void | Promise<void>\n  ): Promise<PluginListenerHandle>;\n\n  removeAllListeners(): Promise<void>;\n}"]}
+{"version":3,"file":"definitions.js","sourceRoot":"","sources":["../../src/definitions.ts"],"names":[],"mappings":"","sourcesContent":["import type { PluginListenerHandle } from '@capacitor/core';\n\nexport interface HttpConnectResult {\n  ip: string;\n  port: number;\n}\n\nexport interface HttpRequestData {\n  requestId: string;\n  method: string;\n  path: string;\n  body?: string;\n  headers?: Record<string, string>;\n  query?: Record<string, string>;\n}\n\n/**\n * Options for sending an HTTP response.\n * Updated to support custom status codes and headers for CORS.\n */\nexport interface HttpSendResponseOptions {\n  /** The ID received in the 'onRequest' event */\n  requestId: string;\n\n  /** The response body (usually stringified JSON) */\n  body: string;\n\n  /** * NEW: HTTP Status code (e.g., 200, 204, 404). \n   * Default is 200.\n   */\n  status?: number;\n\n  /** * NEW: Custom HTTP headers.\n   * Crucial for fixing CORS by providing 'Access-Control-Allow-Origin'.\n   */\n  headers?: Record<string, string>;\n}\n\nexport interface HttpLocalServerSwifterPlugin {\n  connect(): Promise<HttpConnectResult>;\n  disconnect(): Promise<void>;\n\n  /**\n   * Sends a response back to the client.\n   * Now supports status and headers to handle CORS Preflight correctly.\n   */\n  sendResponse(options: HttpSendResponseOptions): Promise<void>;\n\n  addListener(\n    eventName: 'onRequest',\n    listenerFunc: (data: HttpRequestData) => void | Promise<void>\n  ): Promise<PluginListenerHandle>;\n\n  removeAllListeners(): Promise<void>;\n}"]}

package/dist/esm/web.d.ts

@@ -5,8 +5,4 @@ export declare class HttpLocalServerSwifterWeb extends WebPlugin implements Http
     connect(): Promise<HttpConnectResult>;
     disconnect(): Promise<void>;
     sendResponse(options: HttpSendResponseOptions): Promise<void>;
-    /**
-     * No-op on web and Android — Local Network permission dialogs only exist on iOS.
-     */
-    openSettings(): Promise<void>;
 }

package/dist/esm/web.js

@@ -17,13 +17,7 @@ export class HttpLocalServerSwifterWeb extends WebPlugin {
         if (!this.isRunning)
             throw new Error('Server not running');
         const { requestId, body, status, headers } = options;
-        console.log('[HttpLocalServerSwifter Web] Mock Response:', { requestId, status: status !== null && status !== void 0 ? status : 200, headers: headers !== null && headers !== void 0 ? headers : {}, bodyLength: body.length });
-    }
-    /**
-     * No-op on web and Android — Local Network permission dialogs only exist on iOS.
-     */
-    async openSettings() {
-        console.warn('[HttpLocalServerSwifter Web] openSettings() is only available on iOS.');
+        console.log(`[HttpLocalServerSwifter Web] Mock Response:`, { requestId, status: status !== null && status !== void 0 ? status : 200, headers: headers !== null && headers !== void 0 ? headers : {}, bodyLength: body.length });
     }
 }
 //# 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,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAO5C,MAAM,OAAO,yBAA0B,SAAQ,SAAS;IAAxD;;QACU,cAAS,GAAG,KAAK,CAAC;IA4B5B,CAAC;IA1BC,KAAK,CAAC,OAAO;QACX,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC;QACtB,OAAO,CAAC,IAAI,CAAC,oEAAoE,CAAC,CAAC;QACnF,OAAO,EAAE,EAAE,EAAE,WAAW,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;IACzC,CAAC;IAED,KAAK,CAAC,UAAU;QACd,IAAI,CAAC,SAAS,GAAG,KAAK,CAAC;QACvB,OAAO,CAAC,GAAG,CAAC,mDAAmD,CAAC,CAAC;IACnE,CAAC;IAED,KAAK,CAAC,YAAY,CAAC,OAAgC;QACjD,IAAI,CAAC,IAAI,CAAC,SAAS;YAAE,MAAM,IAAI,KAAK,CAAC,oBAAoB,CAAC,CAAC;QAC3D,MAAM,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC;QACrD,OAAO,CAAC,GAAG,CACT,6CAA6C,EAC7C,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,aAAN,MAAM,cAAN,MAAM,GAAI,GAAG,EAAE,OAAO,EAAE,OAAO,aAAP,OAAO,cAAP,OAAO,GAAI,EAAE,EAAE,UAAU,EAAE,IAAI,CAAC,MAAM,EAAE,CACtF,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,YAAY;QAChB,OAAO,CAAC,IAAI,CAAC,uEAAuE,CAAC,CAAC;IACxF,CAAC;CACF","sourcesContent":["import { WebPlugin } from '@capacitor/core';\nimport type {\n  HttpLocalServerSwifterPlugin,\n  HttpConnectResult,\n  HttpSendResponseOptions\n} from './definitions';\n\nexport class HttpLocalServerSwifterWeb extends WebPlugin implements HttpLocalServerSwifterPlugin {\n  private isRunning = false;\n\n  async connect(): Promise<HttpConnectResult> {\n    this.isRunning = true;\n    console.warn('[HttpLocalServerSwifter Web] Mock server started at 127.0.0.1:8080');\n    return { ip: '127.0.0.1', port: 8080 };\n  }\n\n  async disconnect(): Promise<void> {\n    this.isRunning = false;\n    console.log('[HttpLocalServerSwifter Web] Mock server stopped.');\n  }\n\n  async sendResponse(options: HttpSendResponseOptions): Promise<void> {\n    if (!this.isRunning) throw new Error('Server not running');\n    const { requestId, body, status, headers } = options;\n    console.log(\n      '[HttpLocalServerSwifter Web] Mock Response:',\n      { requestId, status: status ?? 200, headers: headers ?? {}, bodyLength: body.length }\n    );\n  }\n\n  /**\n   * No-op on web and Android — Local Network permission dialogs only exist on iOS.\n   */\n  async openSettings(): Promise<void> {\n    console.warn('[HttpLocalServerSwifter Web] openSettings() is only available on iOS.');\n  }\n}"]}
+{"version":3,"file":"web.js","sourceRoot":"","sources":["../../src/web.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAO5C,MAAM,OAAO,yBAA0B,SAAQ,SAAS;IAAxD;;QACU,cAAS,GAAG,KAAK,CAAC;IAuB5B,CAAC;IArBC,KAAK,CAAC,OAAO;QACX,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC;QACtB,OAAO,CAAC,IAAI,CAAC,oEAAoE,CAAC,CAAC;QACnF,OAAO,EAAE,EAAE,EAAE,WAAW,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;IACzC,CAAC;IAED,KAAK,CAAC,UAAU;QACd,IAAI,CAAC,SAAS,GAAG,KAAK,CAAC;QACvB,OAAO,CAAC,GAAG,CAAC,mDAAmD,CAAC,CAAC;IACnE,CAAC;IAED,KAAK,CAAC,YAAY,CAAC,OAAgC;QACjD,IAAI,CAAC,IAAI,CAAC,SAAS;YAAE,MAAM,IAAI,KAAK,CAAC,oBAAoB,CAAC,CAAC;QAE3D,MAAM,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC;QAErD,OAAO,CAAC,GAAG,CACT,6CAA6C,EAC7C,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,aAAN,MAAM,cAAN,MAAM,GAAI,GAAG,EAAE,OAAO,EAAE,OAAO,aAAP,OAAO,cAAP,OAAO,GAAI,EAAE,EAAE,UAAU,EAAE,IAAI,CAAC,MAAM,EAAE,CACtF,CAAC;IACJ,CAAC;CACF","sourcesContent":["import { WebPlugin } from '@capacitor/core';\nimport type {\n  HttpLocalServerSwifterPlugin,\n  HttpConnectResult,\n  HttpSendResponseOptions\n} from './definitions';\n\nexport class HttpLocalServerSwifterWeb extends WebPlugin implements HttpLocalServerSwifterPlugin {\n  private isRunning = false;\n\n  async connect(): Promise<HttpConnectResult> {\n    this.isRunning = true;\n    console.warn('[HttpLocalServerSwifter Web] Mock server started at 127.0.0.1:8080');\n    return { ip: '127.0.0.1', port: 8080 };\n  }\n\n  async disconnect(): Promise<void> {\n    this.isRunning = false;\n    console.log('[HttpLocalServerSwifter Web] Mock server stopped.');\n  }\n\n  async sendResponse(options: HttpSendResponseOptions): Promise<void> {\n    if (!this.isRunning) throw new Error('Server not running');\n\n    const { requestId, body, status, headers } = options;\n\n    console.log(\n      `[HttpLocalServerSwifter Web] Mock Response:`,\n      { requestId, status: status ?? 200, headers: headers ?? {}, bodyLength: body.length }\n    );\n  }\n}"]}

package/dist/plugin.cjs.js

@@ -31,13 +31,7 @@ class HttpLocalServerSwifterWeb extends core.WebPlugin {
         if (!this.isRunning)
             throw new Error('Server not running');
         const { requestId, body, status, headers } = options;
-        console.log('[HttpLocalServerSwifter Web] Mock Response:', { requestId, status: status !== null && status !== void 0 ? status : 200, headers: headers !== null && headers !== void 0 ? headers : {}, bodyLength: body.length });
-    }
-    /**
-     * No-op on web and Android — Local Network permission dialogs only exist on iOS.
-     */
-    async openSettings() {
-        console.warn('[HttpLocalServerSwifter Web] openSettings() is only available on iOS.');
+        console.log(`[HttpLocalServerSwifter Web] Mock Response:`, { requestId, status: status !== null && status !== void 0 ? status : 200, headers: headers !== null && headers !== void 0 ? headers : {}, bodyLength: body.length });
     }
 }
 

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';\n/**\n * Local HTTP server plugin for Android and iOS.\n * * Allows creating an HTTP server on the device that can receive\n * requests from other devices on the same local network or\n * from the app's own WebView (fixing CORS issues).\n */\nconst HttpLocalServerSwifter = registerPlugin('HttpLocalServerSwifter', {\n    // We point to the web mock for browser development\n    web: () => import('./web').then(m => new m.HttpLocalServerSwifterWeb()),\n});\n// Re-export everything from definitions so they are available to the app\nexport * from './definitions';\nexport { HttpLocalServerSwifter };\n//# sourceMappingURL=index.js.map","import { WebPlugin } from '@capacitor/core';\nexport class HttpLocalServerSwifterWeb extends WebPlugin {\n    constructor() {\n        super(...arguments);\n        this.isRunning = false;\n    }\n    async connect() {\n        this.isRunning = true;\n        console.warn('[HttpLocalServerSwifter Web] Mock server started at 127.0.0.1:8080');\n        return { ip: '127.0.0.1', port: 8080 };\n    }\n    async disconnect() {\n        this.isRunning = false;\n        console.log('[HttpLocalServerSwifter Web] Mock server stopped.');\n    }\n    async sendResponse(options) {\n        if (!this.isRunning)\n            throw new Error('Server not running');\n        const { requestId, body, status, headers } = options;\n        console.log('[HttpLocalServerSwifter Web] Mock Response:', { requestId, status: status !== null && status !== void 0 ? status : 200, headers: headers !== null && headers !== void 0 ? headers : {}, bodyLength: body.length });\n    }\n    /**\n     * No-op on web and Android — Local Network permission dialogs only exist on iOS.\n     */\n    async openSettings() {\n        console.warn('[HttpLocalServerSwifter Web] openSettings() is only available on iOS.');\n    }\n}\n//# sourceMappingURL=web.js.map"],"names":["registerPlugin","WebPlugin"],"mappings":";;;;AACA;AACA;AACA;AACA;AACA;AACA;AACK,MAAC,sBAAsB,GAAGA,mBAAc,CAAC,wBAAwB,EAAE;AACxE;AACA,IAAI,GAAG,EAAE,MAAM,mDAAe,CAAC,IAAI,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,yBAAyB,EAAE,CAAC;AAC3E,CAAC;;ACTM,MAAM,yBAAyB,SAASC,cAAS,CAAC;AACzD,IAAI,WAAW,GAAG;AAClB,QAAQ,KAAK,CAAC,GAAG,SAAS,CAAC;AAC3B,QAAQ,IAAI,CAAC,SAAS,GAAG,KAAK;AAC9B,IAAI;AACJ,IAAI,MAAM,OAAO,GAAG;AACpB,QAAQ,IAAI,CAAC,SAAS,GAAG,IAAI;AAC7B,QAAQ,OAAO,CAAC,IAAI,CAAC,oEAAoE,CAAC;AAC1F,QAAQ,OAAO,EAAE,EAAE,EAAE,WAAW,EAAE,IAAI,EAAE,IAAI,EAAE;AAC9C,IAAI;AACJ,IAAI,MAAM,UAAU,GAAG;AACvB,QAAQ,IAAI,CAAC,SAAS,GAAG,KAAK;AAC9B,QAAQ,OAAO,CAAC,GAAG,CAAC,mDAAmD,CAAC;AACxE,IAAI;AACJ,IAAI,MAAM,YAAY,CAAC,OAAO,EAAE;AAChC,QAAQ,IAAI,CAAC,IAAI,CAAC,SAAS;AAC3B,YAAY,MAAM,IAAI,KAAK,CAAC,oBAAoB,CAAC;AACjD,QAAQ,MAAM,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,OAAO;AAC5D,QAAQ,OAAO,CAAC,GAAG,CAAC,6CAA6C,EAAE,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,KAAK,IAAI,IAAI,MAAM,KAAK,MAAM,GAAG,MAAM,GAAG,GAAG,EAAE,OAAO,EAAE,OAAO,KAAK,IAAI,IAAI,OAAO,KAAK,MAAM,GAAG,OAAO,GAAG,EAAE,EAAE,UAAU,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC;AACvO,IAAI;AACJ;AACA;AACA;AACA,IAAI,MAAM,YAAY,GAAG;AACzB,QAAQ,OAAO,CAAC,IAAI,CAAC,uEAAuE,CAAC;AAC7F,IAAI;AACJ;;;;;;;;;"}
+{"version":3,"file":"plugin.cjs.js","sources":["esm/index.js","esm/web.js"],"sourcesContent":["import { registerPlugin } from '@capacitor/core';\n/**\n * Local HTTP server plugin for Android and iOS.\n * * Allows creating an HTTP server on the device that can receive\n * requests from other devices on the same local network or\n * from the app's own WebView (fixing CORS issues).\n */\nconst HttpLocalServerSwifter = registerPlugin('HttpLocalServerSwifter', {\n    // We point to the web mock for browser development\n    web: () => import('./web').then(m => new m.HttpLocalServerSwifterWeb()),\n});\n// Re-export everything from definitions so they are available to the app\nexport * from './definitions';\nexport { HttpLocalServerSwifter };\n//# sourceMappingURL=index.js.map","import { WebPlugin } from '@capacitor/core';\nexport class HttpLocalServerSwifterWeb extends WebPlugin {\n    constructor() {\n        super(...arguments);\n        this.isRunning = false;\n    }\n    async connect() {\n        this.isRunning = true;\n        console.warn('[HttpLocalServerSwifter Web] Mock server started at 127.0.0.1:8080');\n        return { ip: '127.0.0.1', port: 8080 };\n    }\n    async disconnect() {\n        this.isRunning = false;\n        console.log('[HttpLocalServerSwifter Web] Mock server stopped.');\n    }\n    async sendResponse(options) {\n        if (!this.isRunning)\n            throw new Error('Server not running');\n        const { requestId, body, status, headers } = options;\n        console.log(`[HttpLocalServerSwifter Web] Mock Response:`, { requestId, status: status !== null && status !== void 0 ? status : 200, headers: headers !== null && headers !== void 0 ? headers : {}, bodyLength: body.length });\n    }\n}\n//# sourceMappingURL=web.js.map"],"names":["registerPlugin","WebPlugin"],"mappings":";;;;AACA;AACA;AACA;AACA;AACA;AACA;AACK,MAAC,sBAAsB,GAAGA,mBAAc,CAAC,wBAAwB,EAAE;AACxE;AACA,IAAI,GAAG,EAAE,MAAM,mDAAe,CAAC,IAAI,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,yBAAyB,EAAE,CAAC;AAC3E,CAAC;;ACTM,MAAM,yBAAyB,SAASC,cAAS,CAAC;AACzD,IAAI,WAAW,GAAG;AAClB,QAAQ,KAAK,CAAC,GAAG,SAAS,CAAC;AAC3B,QAAQ,IAAI,CAAC,SAAS,GAAG,KAAK;AAC9B,IAAI;AACJ,IAAI,MAAM,OAAO,GAAG;AACpB,QAAQ,IAAI,CAAC,SAAS,GAAG,IAAI;AAC7B,QAAQ,OAAO,CAAC,IAAI,CAAC,oEAAoE,CAAC;AAC1F,QAAQ,OAAO,EAAE,EAAE,EAAE,WAAW,EAAE,IAAI,EAAE,IAAI,EAAE;AAC9C,IAAI;AACJ,IAAI,MAAM,UAAU,GAAG;AACvB,QAAQ,IAAI,CAAC,SAAS,GAAG,KAAK;AAC9B,QAAQ,OAAO,CAAC,GAAG,CAAC,mDAAmD,CAAC;AACxE,IAAI;AACJ,IAAI,MAAM,YAAY,CAAC,OAAO,EAAE;AAChC,QAAQ,IAAI,CAAC,IAAI,CAAC,SAAS;AAC3B,YAAY,MAAM,IAAI,KAAK,CAAC,oBAAoB,CAAC;AACjD,QAAQ,MAAM,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,OAAO;AAC5D,QAAQ,OAAO,CAAC,GAAG,CAAC,CAAC,2CAA2C,CAAC,EAAE,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,KAAK,IAAI,IAAI,MAAM,KAAK,MAAM,GAAG,MAAM,GAAG,GAAG,EAAE,OAAO,EAAE,OAAO,KAAK,IAAI,IAAI,OAAO,KAAK,MAAM,GAAG,OAAO,GAAG,EAAE,EAAE,UAAU,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC;AACvO,IAAI;AACJ;;;;;;;;;"}

package/dist/plugin.js

@@ -30,13 +30,7 @@ var capacitorHttpLocalServerSwifter = (function (exports, core) {
             if (!this.isRunning)
                 throw new Error('Server not running');
             const { requestId, body, status, headers } = options;
-            console.log('[HttpLocalServerSwifter Web] Mock Response:', { requestId, status: status !== null && status !== void 0 ? status : 200, headers: headers !== null && headers !== void 0 ? headers : {}, bodyLength: body.length });
-        }
-        /**
-         * No-op on web and Android — Local Network permission dialogs only exist on iOS.
-         */
-        async openSettings() {
-            console.warn('[HttpLocalServerSwifter Web] openSettings() is only available on iOS.');
+            console.log(`[HttpLocalServerSwifter Web] Mock Response:`, { requestId, status: status !== null && status !== void 0 ? status : 200, headers: headers !== null && headers !== void 0 ? headers : {}, bodyLength: body.length });
         }
     }
 

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';\n/**\n * Local HTTP server plugin for Android and iOS.\n * * Allows creating an HTTP server on the device that can receive\n * requests from other devices on the same local network or\n * from the app's own WebView (fixing CORS issues).\n */\nconst HttpLocalServerSwifter = registerPlugin('HttpLocalServerSwifter', {\n    // We point to the web mock for browser development\n    web: () => import('./web').then(m => new m.HttpLocalServerSwifterWeb()),\n});\n// Re-export everything from definitions so they are available to the app\nexport * from './definitions';\nexport { HttpLocalServerSwifter };\n//# sourceMappingURL=index.js.map","import { WebPlugin } from '@capacitor/core';\nexport class HttpLocalServerSwifterWeb extends WebPlugin {\n    constructor() {\n        super(...arguments);\n        this.isRunning = false;\n    }\n    async connect() {\n        this.isRunning = true;\n        console.warn('[HttpLocalServerSwifter Web] Mock server started at 127.0.0.1:8080');\n        return { ip: '127.0.0.1', port: 8080 };\n    }\n    async disconnect() {\n        this.isRunning = false;\n        console.log('[HttpLocalServerSwifter Web] Mock server stopped.');\n    }\n    async sendResponse(options) {\n        if (!this.isRunning)\n            throw new Error('Server not running');\n        const { requestId, body, status, headers } = options;\n        console.log('[HttpLocalServerSwifter Web] Mock Response:', { requestId, status: status !== null && status !== void 0 ? status : 200, headers: headers !== null && headers !== void 0 ? headers : {}, bodyLength: body.length });\n    }\n    /**\n     * No-op on web and Android — Local Network permission dialogs only exist on iOS.\n     */\n    async openSettings() {\n        console.warn('[HttpLocalServerSwifter Web] openSettings() is only available on iOS.');\n    }\n}\n//# sourceMappingURL=web.js.map"],"names":["registerPlugin","WebPlugin"],"mappings":";;;IACA;IACA;IACA;IACA;IACA;IACA;AACK,UAAC,sBAAsB,GAAGA,mBAAc,CAAC,wBAAwB,EAAE;IACxE;IACA,IAAI,GAAG,EAAE,MAAM,mDAAe,CAAC,IAAI,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,yBAAyB,EAAE,CAAC;IAC3E,CAAC;;ICTM,MAAM,yBAAyB,SAASC,cAAS,CAAC;IACzD,IAAI,WAAW,GAAG;IAClB,QAAQ,KAAK,CAAC,GAAG,SAAS,CAAC;IAC3B,QAAQ,IAAI,CAAC,SAAS,GAAG,KAAK;IAC9B,IAAI;IACJ,IAAI,MAAM,OAAO,GAAG;IACpB,QAAQ,IAAI,CAAC,SAAS,GAAG,IAAI;IAC7B,QAAQ,OAAO,CAAC,IAAI,CAAC,oEAAoE,CAAC;IAC1F,QAAQ,OAAO,EAAE,EAAE,EAAE,WAAW,EAAE,IAAI,EAAE,IAAI,EAAE;IAC9C,IAAI;IACJ,IAAI,MAAM,UAAU,GAAG;IACvB,QAAQ,IAAI,CAAC,SAAS,GAAG,KAAK;IAC9B,QAAQ,OAAO,CAAC,GAAG,CAAC,mDAAmD,CAAC;IACxE,IAAI;IACJ,IAAI,MAAM,YAAY,CAAC,OAAO,EAAE;IAChC,QAAQ,IAAI,CAAC,IAAI,CAAC,SAAS;IAC3B,YAAY,MAAM,IAAI,KAAK,CAAC,oBAAoB,CAAC;IACjD,QAAQ,MAAM,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,OAAO;IAC5D,QAAQ,OAAO,CAAC,GAAG,CAAC,6CAA6C,EAAE,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,KAAK,IAAI,IAAI,MAAM,KAAK,MAAM,GAAG,MAAM,GAAG,GAAG,EAAE,OAAO,EAAE,OAAO,KAAK,IAAI,IAAI,OAAO,KAAK,MAAM,GAAG,OAAO,GAAG,EAAE,EAAE,UAAU,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC;IACvO,IAAI;IACJ;IACA;IACA;IACA,IAAI,MAAM,YAAY,GAAG;IACzB,QAAQ,OAAO,CAAC,IAAI,CAAC,uEAAuE,CAAC;IAC7F,IAAI;IACJ;;;;;;;;;;;;;;;"}
+{"version":3,"file":"plugin.js","sources":["esm/index.js","esm/web.js"],"sourcesContent":["import { registerPlugin } from '@capacitor/core';\n/**\n * Local HTTP server plugin for Android and iOS.\n * * Allows creating an HTTP server on the device that can receive\n * requests from other devices on the same local network or\n * from the app's own WebView (fixing CORS issues).\n */\nconst HttpLocalServerSwifter = registerPlugin('HttpLocalServerSwifter', {\n    // We point to the web mock for browser development\n    web: () => import('./web').then(m => new m.HttpLocalServerSwifterWeb()),\n});\n// Re-export everything from definitions so they are available to the app\nexport * from './definitions';\nexport { HttpLocalServerSwifter };\n//# sourceMappingURL=index.js.map","import { WebPlugin } from '@capacitor/core';\nexport class HttpLocalServerSwifterWeb extends WebPlugin {\n    constructor() {\n        super(...arguments);\n        this.isRunning = false;\n    }\n    async connect() {\n        this.isRunning = true;\n        console.warn('[HttpLocalServerSwifter Web] Mock server started at 127.0.0.1:8080');\n        return { ip: '127.0.0.1', port: 8080 };\n    }\n    async disconnect() {\n        this.isRunning = false;\n        console.log('[HttpLocalServerSwifter Web] Mock server stopped.');\n    }\n    async sendResponse(options) {\n        if (!this.isRunning)\n            throw new Error('Server not running');\n        const { requestId, body, status, headers } = options;\n        console.log(`[HttpLocalServerSwifter Web] Mock Response:`, { requestId, status: status !== null && status !== void 0 ? status : 200, headers: headers !== null && headers !== void 0 ? headers : {}, bodyLength: body.length });\n    }\n}\n//# sourceMappingURL=web.js.map"],"names":["registerPlugin","WebPlugin"],"mappings":";;;IACA;IACA;IACA;IACA;IACA;IACA;AACK,UAAC,sBAAsB,GAAGA,mBAAc,CAAC,wBAAwB,EAAE;IACxE;IACA,IAAI,GAAG,EAAE,MAAM,mDAAe,CAAC,IAAI,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,yBAAyB,EAAE,CAAC;IAC3E,CAAC;;ICTM,MAAM,yBAAyB,SAASC,cAAS,CAAC;IACzD,IAAI,WAAW,GAAG;IAClB,QAAQ,KAAK,CAAC,GAAG,SAAS,CAAC;IAC3B,QAAQ,IAAI,CAAC,SAAS,GAAG,KAAK;IAC9B,IAAI;IACJ,IAAI,MAAM,OAAO,GAAG;IACpB,QAAQ,IAAI,CAAC,SAAS,GAAG,IAAI;IAC7B,QAAQ,OAAO,CAAC,IAAI,CAAC,oEAAoE,CAAC;IAC1F,QAAQ,OAAO,EAAE,EAAE,EAAE,WAAW,EAAE,IAAI,EAAE,IAAI,EAAE;IAC9C,IAAI;IACJ,IAAI,MAAM,UAAU,GAAG;IACvB,QAAQ,IAAI,CAAC,SAAS,GAAG,KAAK;IAC9B,QAAQ,OAAO,CAAC,GAAG,CAAC,mDAAmD,CAAC;IACxE,IAAI;IACJ,IAAI,MAAM,YAAY,CAAC,OAAO,EAAE;IAChC,QAAQ,IAAI,CAAC,IAAI,CAAC,SAAS;IAC3B,YAAY,MAAM,IAAI,KAAK,CAAC,oBAAoB,CAAC;IACjD,QAAQ,MAAM,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,OAAO;IAC5D,QAAQ,OAAO,CAAC,GAAG,CAAC,CAAC,2CAA2C,CAAC,EAAE,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,KAAK,IAAI,IAAI,MAAM,KAAK,MAAM,GAAG,MAAM,GAAG,GAAG,EAAE,OAAO,EAAE,OAAO,KAAK,IAAI,IAAI,OAAO,KAAK,MAAM,GAAG,OAAO,GAAG,EAAE,EAAE,UAAU,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC;IACvO,IAAI;IACJ;;;;;;;;;;;;;;;"}

package/ios/Sources/HttpLocalServerSwifterPlugin/HttpLocalServerSwifter.swift

@@ -9,46 +9,55 @@ public protocol HttpLocalServerSwifterDelegate: AnyObject {
 @objc public class HttpLocalServerSwifter: NSObject {
     private var webServer: HttpServer?
     private weak var delegate: HttpLocalServerSwifterDelegate?
-
+    
     private static var pendingResponses = [String: (String) -> Void]()
     private static let queue = DispatchQueue(label: "com.cappitolian.HttpLocalServerSwifter.pendingResponses", qos: .userInitiated)
-
+    
     private let defaultTimeout: TimeInterval = 10.0
     private let defaultPort: UInt16 = 8080
-
-    // Handles Local Network permission dialog and denial detection.
-    private let networkPermission = LocalNetworkPermission()
-
+    
     public init(delegate: HttpLocalServerSwifterDelegate) {
         self.delegate = delegate
         super.init()
     }
-
-// En HttpLocalServerSwifter.swift — connect() sin checkPermission
+    
     @objc public func connect(_ call: CAPPluginCall) {
+        // IMPORTANT: Move execution to a background thread immediately
         DispatchQueue.global(qos: .userInitiated).async { [weak self] in
             guard let self = self else { return }
+            
             self.disconnect()
             let server = HttpServer()
             self.webServer = server
+            
+            // Use middleware to catch ALL requests and avoid route misses
             server.middleware.append { [weak self] request in
                 if request.method == "OPTIONS" {
                     return self?.corsResponse() ?? .raw(204, "No Content", nil, nil)
                 }
                 return self?.processRequest(request) ?? .raw(500, "Internal Server Error", nil, nil)
             }
+            
             do {
+                // We start the server. This call is non-blocking in Swifter but 
+                // it's safer to do it here.
                 try server.start(self.defaultPort, forceIPv4: true)
                 let ip = Self.getWiFiAddress() ?? "127.0.0.1"
+                
                 print("🚀 SWIFTER: Server running on http://\(ip):\(self.defaultPort)")
-                call.resolve(["ip": ip, "port": Int(self.defaultPort)])
+                
+                // Resolve back to Angular
+                call.resolve([
+                    "ip": ip,
+                    "port": Int(self.defaultPort)
+                ])
             } catch {
                 print("❌ SWIFTER ERROR: \(error)")
                 call.reject("Could not start server")
             }
         }
     }
-
+    
     @objc public func disconnect(_ call: CAPPluginCall? = nil) {
         webServer?.stop()
         webServer = nil
@@ -56,28 +65,18 @@ public protocol HttpLocalServerSwifterDelegate: AnyObject {
         call?.resolve()
     }
 
-    // MARK: - Settings redirect
-
-    /// Opens the app's page in iOS Settings so the user can grant Local Network access.
-    /// Called from the plugin when the JS layer requests it after a permission denial.
-    @objc public func openSettings() {
-        networkPermission.openAppSettings()
-    }
-
-    // MARK: - Request handling
-
     private func processRequest(_ request: HttpRequest) -> HttpResponse {
         let requestId = UUID().uuidString
         var responseString: String?
         let semaphore = DispatchSemaphore(value: 0)
-
+        
         Self.queue.async {
             Self.pendingResponses[requestId] = { jsResponse in
                 responseString = jsResponse
                 semaphore.signal()
             }
         }
-
+        
         let requestData: [String: Any] = [
             "requestId": requestId,
             "method": request.method,
@@ -86,25 +85,26 @@ public protocol HttpLocalServerSwifterDelegate: AnyObject {
             "query": request.queryParams,
             "body": String(bytes: request.body, encoding: .utf8) ?? ""
         ]
-
-        // notifyListeners MUST be called from the Main Thread.
+        
+        // CRITICAL: notifyListeners MUST be called from the Main Thread
         DispatchQueue.main.async {
             self.delegate?.httpLocalServerSwifterDidReceiveRequest(requestData)
         }
-
+        
         let result = semaphore.wait(timeout: .now() + defaultTimeout)
-
+        
         if result == .timedOut {
             Self.queue.async { Self.pendingResponses.removeValue(forKey: requestId) }
             return .raw(408, "Request Timeout", nil, nil)
         }
-
+        
         return createDynamicResponse(responseString ?? "")
     }
 
     static func handleJsResponse(requestId: String, responseData: [String: Any]) {
         queue.async {
             if let callback = pendingResponses[requestId] {
+                // Extract body, status and headers to pass as a JSON string to the semaphore
                 if let jsonData = try? JSONSerialization.data(withJSONObject: responseData),
                    let jsonString = String(data: jsonData, encoding: .utf8) {
                     callback(jsonString)
@@ -114,8 +114,6 @@ public protocol HttpLocalServerSwifterDelegate: AnyObject {
         }
     }
 
-    // MARK: - Response helpers
-
     private func createDynamicResponse(_ jsonResponse: String) -> HttpResponse {
         var finalStatus = 200
         var finalBody = jsonResponse
@@ -125,7 +123,7 @@ public protocol HttpLocalServerSwifterDelegate: AnyObject {
             "Access-Control-Allow-Methods": "GET, POST, PUT, PATCH, DELETE, OPTIONS",
             "Access-Control-Allow-Headers": "Origin, Content-Type, Accept, Authorization, X-Requested-With"
         ]
-
+        
         if let data = jsonResponse.data(using: .utf8),
            let dict = try? JSONSerialization.jsonObject(with: data) as? [String: Any] {
             finalBody = dict["body"] as? String ?? ""
@@ -134,7 +132,7 @@ public protocol HttpLocalServerSwifterDelegate: AnyObject {
                 for (key, value) in customHeaders { headers[key] = value }
             }
         }
-
+        
         return .raw(finalStatus, "OK", headers) { try $0.write([UInt8](finalBody.utf8)) }
     }
 
@@ -147,8 +145,6 @@ public protocol HttpLocalServerSwifterDelegate: AnyObject {
         ], nil)
     }
 
-    // MARK: - Network utilities
-
     static func getWiFiAddress() -> String? {
         var address: String?
         var ifaddr: UnsafeMutablePointer<ifaddrs>?

package/ios/Sources/HttpLocalServerSwifterPlugin/HttpLocalServerSwifterPlugin.swift

@@ -8,48 +8,37 @@ public class HttpLocalServerSwifterPlugin: CAPPlugin, CAPBridgedPlugin, HttpLoca
     public let pluginMethods: [CAPPluginMethod] = [
         CAPPluginMethod(name: "connect", returnType: CAPPluginReturnPromise),
         CAPPluginMethod(name: "disconnect", returnType: CAPPluginReturnPromise),
-        CAPPluginMethod(name: "sendResponse", returnType: CAPPluginReturnPromise),
-        // Redirects the user to Settings so they can grant Local Network permission manually.
-        CAPPluginMethod(name: "openSettings", returnType: CAPPluginReturnPromise)
+        CAPPluginMethod(name: "sendResponse", returnType: CAPPluginReturnPromise)
     ]
-
+    
     private var localServer: HttpLocalServerSwifter?
-
+    
     @objc func connect(_ call: CAPPluginCall) {
         if localServer == nil { localServer = HttpLocalServerSwifter(delegate: self) }
         localServer?.connect(call)
     }
-
+    
     @objc func disconnect(_ call: CAPPluginCall) {
         localServer?.disconnect(call)
         localServer = nil
     }
-
-    @objc func sendResponse(_ call: CAPPluginCall) {
-        guard let requestId = call.getString("requestId") else {
-            call.reject("Missing requestId")
-            return
-        }
-
-        if let responseData = call.dictionaryRepresentation as? [String: Any] {
-            HttpLocalServerSwifter.handleJsResponse(requestId: requestId, responseData: responseData)
-            call.resolve()
-        } else {
-            call.reject("Could not parse response data")
-        }
-    }
-
-    /// Opens the app page in iOS Settings so the user can grant Local Network permission.
-    ///
-    /// Call this from JavaScript after catching a `LOCAL_NETWORK_PERMISSION_DENIED` rejection
-    /// from `connect()`. There is no programmatic way to re-prompt the system dialog —
-    /// redirecting to Settings is the only available recovery path.
-    @objc func openSettings(_ call: CAPPluginCall) {
-        localServer?.openSettings()
-        call.resolve()
-    }
-
+    
+  @objc func sendResponse(_ call: CAPPluginCall) {
+      guard let requestId = call.getString("requestId") else {
+          call.reject("Missing requestId")
+          return
+      }
+      
+      // Cast dictionaryRepresentation explicitly to [String: Any]
+      if let responseData = call.dictionaryRepresentation as? [String: Any] {
+          HttpLocalServerSwifter.handleJsResponse(requestId: requestId, responseData: responseData)
+          call.resolve()
+      } else {
+          call.reject("Could not parse response data")
+      }
+  }
+    
     public func httpLocalServerSwifterDidReceiveRequest(_ data: [String: Any]) {
         notifyListeners("onRequest", data: data)
     }
-}
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cappitolian/http-local-server-swifter",
-  "version": "0.0.25",
+  "version": "0.0.26",
   "description": "Runs a local HTTP server on your device, accessible over LAN. Supports connect, disconnect, GET, and POST methods with IP and port discovery.",
   "main": "dist/plugin.cjs.js",
   "module": "dist/esm/index.js",

package/ios/Sources/HttpLocalServerSwifterPlugin/LocalNetworkPermission.swift

@@ -1,154 +0,0 @@
-import Foundation
-import Network
-import UIKit
-
-/// Handles Local Network permission lifecycle on iOS.
-///
-/// IMPORTANT: iOS Local Network permission does NOT block TCP sockets.
-/// It only blocks mDNS/Bonjour service discovery. This means Swifter's
-/// server.start() will always succeed regardless of permission status.
-///
-/// Detection strategy — NWListener with serviceRegistrationUpdateHandler:
-///   The PolicyDenied error for a revoked Local Network permission surfaces
-///   in NWListener.serviceRegistrationUpdateHandler, not in stateUpdateHandler.
-///   A connection handler must also be set or NWListener fails with error 22
-///   before iOS even evaluates the permission.
-@objc public class LocalNetworkPermission: NSObject {
-
-    // MARK: - Types
-
-    public enum PermissionStatus {
-        case granted
-        case denied
-        case unknown
-    }
-
-    // MARK: - Constants
-
-    /// Must match the NSBonjourServices entry in Info.plist exactly.
-    private static let bonjourServiceType = "_ssspos._tcp"
-
-    // MARK: - Private state
-
-    private var listener: NWListener?
-
-    // MARK: - Permission check
-
-    /// Checks Local Network permission by advertising a Bonjour service via NWListener.
-    ///
-    /// The permission denial for a revoked permission surfaces in
-    /// serviceRegistrationUpdateHandler — not in stateUpdateHandler.
-    /// A dummy connection handler is required to prevent error 22 (Invalid argument).
-    ///
-    /// - Parameter completion: Called on the main thread with the permission status.
-    public func checkPermission(completion: @escaping (PermissionStatus) -> Void) {
-        var completed = false
-
-        let finish: (PermissionStatus) -> Void = { [weak self] status in
-            guard !completed else { return }
-            completed = true
-            self?.listener?.cancel()
-            self?.listener = nil
-            DispatchQueue.main.async {
-                print("✅ LocalNetworkPermission resolved: \(status)")
-                completion(status)
-            }
-        }
-
-        let timeout = DispatchWorkItem {
-            print("⚠️ LocalNetworkPermission: timeout — resolving as .unknown")
-            finish(.unknown)
-        }
-        DispatchQueue.main.asyncAfter(deadline: .now() + 5.0, execute: timeout)
-
-        let params = NWParameters.tcp
-        params.includePeerToPeer = true
-
-        guard let listener = try? NWListener(using: params) else {
-            print("⚠️ LocalNetworkPermission: could not create NWListener")
-            timeout.cancel()
-            finish(.unknown)
-            return
-        }
-
-        listener.service = NWListener.Service(type: Self.bonjourServiceType)
-        self.listener = listener
-
-        // Required: NWListener fails with error 22 (Invalid argument) if no
-        // connection handler is set. This dummy handler satisfies the requirement.
-        listener.newConnectionHandler = { connection in
-            connection.cancel()
-        }
-
-        // This is where iOS reports PolicyDenied for a revoked Local Network permission.
-        // stateUpdateHandler only reports generic listener errors, not Bonjour policy errors.
-        listener.serviceRegistrationUpdateHandler = { change in
-            print("🔍 LocalNetworkPermission serviceRegistration: \(change)")
-            switch change {
-            case .add:
-                // Service registered successfully — permission is granted.
-                timeout.cancel()
-                finish(.granted)
-
-            case .remove:
-                // Service was removed. On permission denial this fires immediately
-                // after the _NWAdvertiser PolicyDenied error in the system logs.
-                // We treat an immediate remove (before .add) as denied.
-                timeout.cancel()
-                finish(.denied)
-
-            @unknown default:
-                break
-            }
-        }
-
-        // stateUpdateHandler still needed to catch non-permission listener failures.
-        listener.stateUpdateHandler = { state in
-            print("🔍 LocalNetworkPermission NWListener state: \(state)")
-            switch state {
-            case .failed(let error):
-                let code = (error as NSError).code
-                print("🔍 LocalNetworkPermission NWListener error: \(code) — \(error.localizedDescription)")
-                // Only treat explicit policy errors as denied; other failures are unknown.
-                timeout.cancel()
-                finish(Self.isPolicyDenied(error) ? .denied : .unknown)
-
-            case .cancelled:
-                break
-
-            default:
-                break
-            }
-        }
-
-        listener.start(queue: .main)
-    }
-
-    // MARK: - Recovery
-
-    /// Opens the app's page in iOS Settings so the user can manually grant Local Network access.
-    ///
-    /// - Note: This is the only recovery path after denial — iOS cannot re-prompt.
-    /// - Warning: On iOS 17, a device restart may be needed after granting the permission.
-    public func openAppSettings() {
-        guard let url = URL(string: UIApplication.openSettingsURLString) else { return }
-        DispatchQueue.main.async {
-            UIApplication.shared.open(url)
-        }
-    }
-
-    // MARK: - Private helpers
-
-    /// Returns true if the NWError indicates a Local Network policy denial.
-    ///
-    /// Known denial codes:
-    ///   kDNSServiceErr_PolicyDenied = -65570
-    ///   kDNSServiceErr_NoAuth       = -65555
-    private static func isPolicyDenied(_ error: NWError) -> Bool {
-        let nsError = error as NSError
-        if nsError.code == -65570 || nsError.code == -65555 { return true }
-
-        let desc = error.localizedDescription.lowercased()
-        return desc.contains("policy") || desc.contains("denied") || desc.contains("noauth")
-    }
-}