@wniu/react-native-local-network-permission 0.1.0

package/LICENSE

@@ -0,0 +1,20 @@
+MIT License
+
+Copyright (c) 2026 zephyr
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/LocalNetworkPermission.podspec

@@ -0,0 +1,22 @@
+require "json"
+
+package = JSON.parse(File.read(File.join(__dir__, "package.json")))
+
+Pod::Spec.new do |s|
+  s.name         = "LocalNetworkPermission"
+  s.version      = package["version"]
+  s.summary      = package["description"]
+  s.homepage     = package["homepage"]
+  s.license      = package["license"]
+  s.authors      = package["author"]
+
+  s.platforms    = { :ios => min_ios_version_supported }
+  s.source       = { :git => "https://github.com/voyageh/react-native-local-network-permission.git", :tag => "#{s.version}" }
+
+  s.source_files = "ios/**/*.{h,m,mm,swift,cpp}"
+  s.private_header_files = "ios/**/*.h"
+
+  s.frameworks = "Network"
+
+  install_modules_dependencies(s)
+end

package/README.md

@@ -0,0 +1,147 @@
+# react-native-local-network-permission
+
+A React Native library for handling **iOS Local Network permission**, built on TurboModule architecture.
+
+> **This is a React Native library, not an Expo-only module.** It works in bare React Native projects and can also be used in Expo projects via prebuild (`npx expo prebuild`).
+
+## Installation
+
+```sh
+npm install react-native-local-network-permission
+# or
+yarn add react-native-local-network-permission
+```
+
+### iOS Setup
+
+```sh
+cd ios && pod install
+```
+
+#### Required Info.plist Configuration
+
+You **must** add the following keys to your `ios/<YourApp>/Info.plist`:
+
+```xml
+<key>NSLocalNetworkUsageDescription</key>
+<string>This app needs access to the local network to discover nearby devices.</string>
+
+<key>NSBonjourServices</key>
+<array>
+    <string>_lnp_check._tcp</string>
+</array>
+```
+
+- **`NSLocalNetworkUsageDescription`**: The message shown to the user in the permission dialog. Customize this to explain why your app needs local network access.
+- **`NSBonjourServices`**: Must include `_lnp_check._tcp` — this is the Bonjour service type used internally by this library to detect permission status.
+
+> If your app also browses for other Bonjour services, add those to the array as well.
+
+### Expo Setup
+
+This library is **not** an Expo Module — it uses React Native TurboModule architecture. To use it in an Expo managed project:
+
+1. Install the library as above.
+2. Run `npx expo prebuild` to generate native projects.
+3. Add the Info.plist keys manually, or create a [config plugin](https://docs.expo.dev/guides/config-plugins/) to automate it.
+
+The library is fully compatible with Expo projects that use prebuild (Continuous Native Generation).
+
+## Usage
+
+```ts
+import {
+  requestPermission,
+  isAvailable,
+} from 'react-native-local-network-permission';
+
+// Request / check permission (may show system dialog on first call)
+const { status, granted, canAskAgain } = await requestPermission();
+
+// Check if local network permission is available on this platform
+const available = await isAvailable(); // true on iOS 14+, false on Android
+```
+
+## API Reference
+
+### `requestPermission()`
+
+```ts
+requestPermission(): Promise<LocalNetworkPermissionResponse>
+```
+
+Requests local network permission. On iOS, this triggers a detection mechanism that:
+- Shows the system permission dialog if the user has not yet made a choice.
+- Returns the current status without a dialog if already granted or denied.
+
+On Android, always returns `{ status: 'granted', granted: true, canAskAgain: false }` since Android does not restrict local network access.
+
+#### Why only one method instead of separate "get" and "request"?
+
+Apple provides **no API to silently query** local network permission status. Any detection attempt is itself a local network operation that may trigger the system dialog. Providing separate `getPermission()` and `requestPermission()` methods would be misleading — they would do exactly the same thing.
+
+### `isAvailable()`
+
+```ts
+isAvailable(): Promise<boolean>
+```
+
+Returns `true` on iOS 14+, `false` on Android and older iOS versions.
+
+### Types
+
+```ts
+type PermissionStatus = 'granted' | 'denied';
+
+type LocalNetworkPermissionResponse = {
+  status: PermissionStatus;
+  granted: boolean;    // true when status === 'granted'
+  canAskAgain: boolean; // false — iOS only shows the dialog once
+};
+```
+
+## How It Works
+
+### The iOS Local Network Permission Challenge
+
+Unlike Camera, Location, or Microphone permissions, **Apple does not provide any public API** to directly query or request local network permission. There is no equivalent of `AVCaptureDevice.authorizationStatus` for local network access. This is true across all iOS versions including iOS 18.
+
+### Detection Mechanism
+
+This library uses the widely-adopted **NWBrowser/NWListener self-discovery technique**:
+
+1. A Bonjour `NWListener` is started on the device, advertising a custom service (`_lnp_check._tcp`).
+2. A `NWBrowser` is started to search for that same service.
+3. **If permission is granted:** The browser discovers the listener -> returns `"granted"`.
+4. **If permission is denied:** The browser receives a DNS policy error -> returns `"denied"`.
+5. **If permission is undetermined:** The system shows the permission dialog, then the result is determined.
+
+### Limitations
+
+- **No silent query**: `requestPermission()` may trigger the system dialog on first call. This is an iOS platform limitation, not a library design choice.
+- **One-time dialog**: iOS shows the local network permission dialog only once. After the user makes a choice, they must go to **Settings > Privacy & Security > Local Network** to change it.
+- **`canAskAgain` is always `false`**: Since we cannot determine whether the dialog has been shown before, and it can only be shown once, this field is always `false`.
+- **iOS 14+ only**: Local network permission was introduced in iOS 14. On older versions, the library returns `"granted"` (unrestricted access).
+- **Android**: Local network access is not restricted on Android. `requestPermission()` returns granted, and `isAvailable()` returns `false`.
+
+## Platform Support
+
+| Platform | Supported | Notes |
+|----------|-----------|-------|
+| iOS 14+  | Yes       | Full support via NWBrowser/NWListener |
+| iOS < 14 | Partial   | Always returns granted (no restriction) |
+| Android  | N/A       | Returns granted; `isAvailable()` returns false |
+
+## Contributing
+
+- [Development workflow](CONTRIBUTING.md#development-workflow)
+- [Sending a pull request](CONTRIBUTING.md#sending-a-pull-request)
+- [Code of conduct](CODE_OF_CONDUCT.md)
+
+## License
+
+MIT
+
+---
+
+Made with [create-react-native-library](https://github.com/callstack/react-native-builder-bob)

package/ios/LocalNetworkPermission.h

@@ -0,0 +1,5 @@
+#import <LocalNetworkPermissionSpec/LocalNetworkPermissionSpec.h>
+
+@interface LocalNetworkPermission : NSObject <NativeLocalNetworkPermissionSpec>
+
+@end

package/ios/LocalNetworkPermission.mm

@@ -0,0 +1,129 @@
+#import "LocalNetworkPermission.h"
+#import <Network/Network.h>
+
+static NSString *const kServiceType = @"_preflight_check._tcp";
+
+@implementation LocalNetworkPermission
+
+- (void)requestPermission:(RCTPromiseResolveBlock)resolve
+                   reject:(RCTPromiseRejectBlock)reject
+{
+    if (@available(iOS 14.0, *)) {
+        [self checkWithResolve:resolve];
+    } else {
+        resolve(@(YES));
+    }
+}
+
+- (void)checkWithResolve:(RCTPromiseResolveBlock)resolve API_AVAILABLE(ios(14.0))
+{
+    __block nw_listener_t listener = nil;
+    __block nw_browser_t browser = nil;
+    __block BOOL didResolve = NO;
+
+    void (^finish)(BOOL) = ^(BOOL granted) {
+        if (didResolve) return;
+        didResolve = YES;
+
+        if (listener) {
+            nw_listener_set_state_changed_handler(listener, NULL);
+            nw_listener_set_new_connection_handler(listener, NULL);
+            nw_listener_cancel(listener);
+            listener = nil;
+        }
+        if (browser) {
+            nw_browser_set_state_changed_handler(browser, NULL);
+            nw_browser_set_browse_results_changed_handler(browser, NULL);
+            nw_browser_cancel(browser);
+            browser = nil;
+        }
+
+        resolve(@(granted));
+    };
+
+    // --- Listener ---
+    nw_parameters_t listenerParams = nw_parameters_create_secure_tcp(
+        NW_PARAMETERS_DISABLE_PROTOCOL,
+        NW_PARAMETERS_DEFAULT_CONFIGURATION
+    );
+
+    listener = nw_listener_create(listenerParams);
+    if (!listener) {
+        finish(NO);
+        return;
+    }
+
+    NSString *serviceName = [[NSUUID UUID] UUIDString];
+    nw_advertise_descriptor_t ad = nw_advertise_descriptor_create_bonjour_service(
+        serviceName.UTF8String, kServiceType.UTF8String, NULL
+    );
+    nw_listener_set_advertise_descriptor(listener, ad);
+    nw_listener_set_new_connection_handler(listener, ^(nw_connection_t connection) {});
+
+    nw_listener_set_state_changed_handler(listener, ^(nw_listener_state_t state, nw_error_t error) {
+        switch (state) {
+            case nw_listener_state_ready:
+                break;
+            case nw_listener_state_failed:
+            case nw_listener_state_waiting:
+                finish(NO);
+                break;
+            default:
+                break;
+        }
+    });
+
+    nw_listener_set_queue(listener, dispatch_get_main_queue());
+    nw_listener_start(listener);
+
+    // --- Browser ---
+    nw_browse_descriptor_t desc = nw_browse_descriptor_create_bonjour_service(
+        kServiceType.UTF8String, NULL
+    );
+    nw_parameters_t browserParams = nw_parameters_create();
+    nw_parameters_set_include_peer_to_peer(browserParams, true);
+
+    browser = nw_browser_create(desc, browserParams);
+
+    nw_browser_set_state_changed_handler(browser, ^(nw_browser_state_t state, nw_error_t error) {
+        switch (state) {
+            case nw_browser_state_ready:
+                break;
+            case nw_browser_state_waiting:
+            case nw_browser_state_failed:
+                finish(NO);
+                break;
+            default:
+                break;
+        }
+    });
+
+    nw_browser_set_browse_results_changed_handler(browser, ^(
+        nw_browse_result_t oldResult,
+        nw_browse_result_t newResult,
+        bool batchComplete
+    ) {
+        nw_browse_result_change_t changes = nw_browse_result_get_changes(oldResult, newResult);
+        if (changes & nw_browse_result_change_result_added) {
+            finish(YES);
+        }
+    });
+
+    nw_browser_set_queue(browser, dispatch_get_main_queue());
+    nw_browser_start(browser);
+}
+
+#pragma mark - TurboModule
+
+- (std::shared_ptr<facebook::react::TurboModule>)getTurboModule:
+    (const facebook::react::ObjCTurboModule::InitParams &)params
+{
+    return std::make_shared<facebook::react::NativeLocalNetworkPermissionSpecJSI>(params);
+}
+
++ (NSString *)moduleName
+{
+    return @"LocalNetworkPermission";
+}
+
+@end

package/lib/module/LocalNetworkPermission.android.js

@@ -0,0 +1,10 @@
+"use strict";
+
+/**
+ * Android does not restrict local network access.
+ * Always returns `true`.
+ */
+export async function requestPermission() {
+  return true;
+}
+//# sourceMappingURL=LocalNetworkPermission.android.js.map

package/lib/module/LocalNetworkPermission.android.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["requestPermission"],"sourceRoot":"../../src","sources":["LocalNetworkPermission.android.ts"],"mappings":";;AAAA;AACA;AACA;AACA;AACA,OAAO,eAAeA,iBAAiBA,CAAA,EAAqB;EAC1D,OAAO,IAAI;AACb","ignoreList":[]}

package/lib/module/LocalNetworkPermission.ios.js

@@ -0,0 +1,18 @@
+"use strict";
+
+import NativeModule from "./NativeLocalNetworkPermission.js";
+
+/**
+ * Request / check local network permission on iOS.
+ *
+ * On iOS 14+, this triggers the NWBrowser/NWListener detection mechanism:
+ * - If the user has not yet made a choice, the system permission dialog will appear.
+ * - If permission has already been granted or denied, the current status is returned
+ *   without showing a dialog.
+ *
+ * @returns `true` if granted, `false` if denied.
+ */
+export async function requestPermission() {
+  return NativeModule.requestPermission();
+}
+//# sourceMappingURL=LocalNetworkPermission.ios.js.map

package/lib/module/LocalNetworkPermission.ios.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["NativeModule","requestPermission"],"sourceRoot":"../../src","sources":["LocalNetworkPermission.ios.ts"],"mappings":";;AAAA,OAAOA,YAAY,MAAM,mCAAgC;;AAEzD;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,eAAeC,iBAAiBA,CAAA,EAAqB;EAC1D,OAAOD,YAAY,CAACC,iBAAiB,CAAC,CAAC;AACzC","ignoreList":[]}

package/lib/module/LocalNetworkPermission.js

@@ -0,0 +1,10 @@
+"use strict";
+
+/**
+ * Default fallback (web and other platforms).
+ * Always returns `true`.
+ */
+export async function requestPermission() {
+  return true;
+}
+//# sourceMappingURL=LocalNetworkPermission.js.map

package/lib/module/LocalNetworkPermission.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["requestPermission"],"sourceRoot":"../../src","sources":["LocalNetworkPermission.ts"],"mappings":";;AAAA;AACA;AACA;AACA;AACA,OAAO,eAAeA,iBAAiBA,CAAA,EAAqB;EAC1D,OAAO,IAAI;AACb","ignoreList":[]}

package/lib/module/NativeLocalNetworkPermission.js

@@ -0,0 +1,13 @@
+"use strict";
+
+import { TurboModuleRegistry } from 'react-native';
+
+/**
+ * Native module spec for codegen.
+ *
+ * The return type uses inline object shapes because TurboModule codegen
+ * does not support importing custom TypeScript types.
+ */
+
+export default TurboModuleRegistry.getEnforcing('LocalNetworkPermission');
+//# sourceMappingURL=NativeLocalNetworkPermission.js.map

package/lib/module/NativeLocalNetworkPermission.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["TurboModuleRegistry","getEnforcing"],"sourceRoot":"../../src","sources":["NativeLocalNetworkPermission.ts"],"mappings":";;AAAA,SAASA,mBAAmB,QAA0B,cAAc;;AAEpE;AACA;AACA;AACA;AACA;AACA;;AAYA,eAAeA,mBAAmB,CAACC,YAAY,CAC7C,wBACF,CAAC","ignoreList":[]}

package/lib/module/index.js

@@ -0,0 +1,4 @@
+"use strict";
+
+export { requestPermission } from './LocalNetworkPermission';
+//# sourceMappingURL=index.js.map

package/lib/module/index.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["requestPermission"],"sourceRoot":"../../src","sources":["index.tsx"],"mappings":";;AAAA,SAASA,iBAAiB,QAAQ,0BAA0B","ignoreList":[]}

package/lib/module/package.json

@@ -0,0 +1 @@
+{"type":"module"}

package/lib/typescript/package.json

@@ -0,0 +1 @@
+{"type":"module"}

package/lib/typescript/src/LocalNetworkPermission.android.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Android does not restrict local network access.
+ * Always returns `true`.
+ */
+export declare function requestPermission(): Promise<boolean>;
+//# sourceMappingURL=LocalNetworkPermission.android.d.ts.map

package/lib/typescript/src/LocalNetworkPermission.android.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"LocalNetworkPermission.android.d.ts","sourceRoot":"","sources":["../../../src/LocalNetworkPermission.android.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,wBAAsB,iBAAiB,IAAI,OAAO,CAAC,OAAO,CAAC,CAE1D"}

package/lib/typescript/src/LocalNetworkPermission.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Default fallback (web and other platforms).
+ * Always returns `true`.
+ */
+export declare function requestPermission(): Promise<boolean>;
+//# sourceMappingURL=LocalNetworkPermission.d.ts.map

package/lib/typescript/src/LocalNetworkPermission.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"LocalNetworkPermission.d.ts","sourceRoot":"","sources":["../../../src/LocalNetworkPermission.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,wBAAsB,iBAAiB,IAAI,OAAO,CAAC,OAAO,CAAC,CAE1D"}

package/lib/typescript/src/LocalNetworkPermission.ios.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Request / check local network permission on iOS.
+ *
+ * On iOS 14+, this triggers the NWBrowser/NWListener detection mechanism:
+ * - If the user has not yet made a choice, the system permission dialog will appear.
+ * - If permission has already been granted or denied, the current status is returned
+ *   without showing a dialog.
+ *
+ * @returns `true` if granted, `false` if denied.
+ */
+export declare function requestPermission(): Promise<boolean>;
+//# sourceMappingURL=LocalNetworkPermission.ios.d.ts.map

package/lib/typescript/src/LocalNetworkPermission.ios.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"LocalNetworkPermission.ios.d.ts","sourceRoot":"","sources":["../../../src/LocalNetworkPermission.ios.ts"],"names":[],"mappings":"AAEA;;;;;;;;;GASG;AACH,wBAAsB,iBAAiB,IAAI,OAAO,CAAC,OAAO,CAAC,CAE1D"}

package/lib/typescript/src/NativeLocalNetworkPermission.d.ts

@@ -0,0 +1,20 @@
+import { type TurboModule } from 'react-native';
+/**
+ * Native module spec for codegen.
+ *
+ * The return type uses inline object shapes because TurboModule codegen
+ * does not support importing custom TypeScript types.
+ */
+export interface Spec extends TurboModule {
+    /**
+     * Request (or check) local network permission.
+     * On iOS this uses the NWBrowser/NWListener trick and may trigger the
+     * system permission dialog if the user has not yet made a choice.
+     *
+     * Resolves with `true` if granted, `false` if denied.
+     */
+    requestPermission(): Promise<boolean>;
+}
+declare const _default: Spec;
+export default _default;
+//# sourceMappingURL=NativeLocalNetworkPermission.d.ts.map

package/lib/typescript/src/NativeLocalNetworkPermission.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"NativeLocalNetworkPermission.d.ts","sourceRoot":"","sources":["../../../src/NativeLocalNetworkPermission.ts"],"names":[],"mappings":"AAAA,OAAO,EAAuB,KAAK,WAAW,EAAE,MAAM,cAAc,CAAC;AAErE;;;;;GAKG;AACH,MAAM,WAAW,IAAK,SAAQ,WAAW;IACvC;;;;;;OAMG;IACH,iBAAiB,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;CACvC;;AAED,wBAEE"}

package/lib/typescript/src/index.d.ts

@@ -0,0 +1,2 @@
+export { requestPermission } from './LocalNetworkPermission';
+//# sourceMappingURL=index.d.ts.map

package/lib/typescript/src/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/index.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC"}

package/package.json

@@ -0,0 +1,160 @@
+{
+  "name": "@wniu/react-native-local-network-permission",
+  "version": "0.1.0",
+  "description": "Handles iOS local network permission requests.",
+  "main": "./lib/module/index.js",
+  "types": "./lib/typescript/src/index.d.ts",
+  "exports": {
+    ".": {
+      "source": "./src/index.tsx",
+      "types": "./lib/typescript/src/index.d.ts",
+      "default": "./lib/module/index.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "src",
+    "lib",
+    "ios",
+    "*.podspec",
+    "!ios/build",
+    "!**/__tests__",
+    "!**/__fixtures__",
+    "!**/__mocks__",
+    "!**/.*"
+  ],
+  "scripts": {
+    "example": "yarn workspace react-native-local-network-permission-example",
+    "clean": "del-cli lib",
+    "prepare": "bob build",
+    "typecheck": "tsc",
+    "lint": "eslint \"**/*.{js,ts,tsx}\"",
+    "test": "jest",
+    "release": "release-it --only-version"
+  },
+  "keywords": [
+    "react-native",
+    "ios",
+    "android"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/voyageh/react-native-local-network-permission.git"
+  },
+  "author": "zephyr <zephyr.d@qq.com> (https://github.com/voyageh)",
+  "license": "MIT",
+  "bugs": {
+    "url": "https://github.com/voyageh/react-native-local-network-permission/issues"
+  },
+  "homepage": "https://github.com/voyageh/react-native-local-network-permission#readme",
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org/"
+  },
+  "devDependencies": {
+    "@commitlint/config-conventional": "^20.5.0",
+    "@eslint/compat": "^2.0.3",
+    "@eslint/eslintrc": "^3.3.5",
+    "@eslint/js": "^10.0.1",
+    "@jest/globals": "^30.0.0",
+    "@react-native/babel-preset": "0.85.0",
+    "@react-native/eslint-config": "0.85.0",
+    "@react-native/jest-preset": "0.85.0",
+    "@release-it/conventional-changelog": "^10.0.6",
+    "@types/react": "^19.2.0",
+    "commitlint": "^20.5.0",
+    "del-cli": "^7.0.0",
+    "eslint": "^9.39.4",
+    "eslint-config-prettier": "^10.1.8",
+    "eslint-plugin-ft-flow": "^3.0.11",
+    "eslint-plugin-prettier": "^5.5.5",
+    "jest": "^30.3.0",
+    "lefthook": "^2.1.4",
+    "prettier": "^3.8.1",
+    "react": "19.2.0",
+    "react-native": "0.83.4",
+    "react-native-builder-bob": "^0.41.0",
+    "release-it": "^19.2.4",
+    "turbo": "^2.8.21",
+    "typescript": "^6.0.2"
+  },
+  "peerDependencies": {
+    "react": "*",
+    "react-native": "*"
+  },
+  "workspaces": [
+    "example"
+  ],
+  "packageManager": "yarn@4.11.0",
+  "react-native-builder-bob": {
+    "source": "src",
+    "output": "lib",
+    "targets": [
+      [
+        "module",
+        {
+          "esm": true
+        }
+      ],
+      [
+        "typescript",
+        {
+          "project": "tsconfig.build.json"
+        }
+      ]
+    ]
+  },
+  "codegenConfig": {
+    "name": "LocalNetworkPermissionSpec",
+    "type": "modules",
+    "jsSrcsDir": "src"
+  },
+  "prettier": {
+    "quoteProps": "consistent",
+    "singleQuote": true,
+    "tabWidth": 2,
+    "trailingComma": "es5",
+    "useTabs": false
+  },
+  "jest": {
+    "preset": "@react-native/jest-preset",
+    "modulePathIgnorePatterns": [
+      "<rootDir>/example/node_modules",
+      "<rootDir>/lib/"
+    ]
+  },
+  "commitlint": {
+    "extends": [
+      "@commitlint/config-conventional"
+    ]
+  },
+  "release-it": {
+    "git": {
+      "commitMessage": "chore: release ${version}",
+      "tagName": "v${version}"
+    },
+    "npm": {
+      "publish": true
+    },
+    "github": {
+      "release": true
+    },
+    "plugins": {
+      "@release-it/conventional-changelog": {
+        "preset": {
+          "name": "angular"
+        }
+      }
+    }
+  },
+  "create-react-native-library": {
+    "type": "turbo-module",
+    "languages": "kotlin-objc",
+    "tools": [
+      "eslint",
+      "jest",
+      "lefthook",
+      "release-it"
+    ],
+    "version": "0.62.0"
+  }
+}

package/src/LocalNetworkPermission.android.ts

@@ -0,0 +1,7 @@
+/**
+ * Android does not restrict local network access.
+ * Always returns `true`.
+ */
+export async function requestPermission(): Promise<boolean> {
+  return true;
+}

package/src/LocalNetworkPermission.ios.ts

@@ -0,0 +1,15 @@
+import NativeModule from './NativeLocalNetworkPermission';
+
+/**
+ * Request / check local network permission on iOS.
+ *
+ * On iOS 14+, this triggers the NWBrowser/NWListener detection mechanism:
+ * - If the user has not yet made a choice, the system permission dialog will appear.
+ * - If permission has already been granted or denied, the current status is returned
+ *   without showing a dialog.
+ *
+ * @returns `true` if granted, `false` if denied.
+ */
+export async function requestPermission(): Promise<boolean> {
+  return NativeModule.requestPermission();
+}

package/src/LocalNetworkPermission.ts

@@ -0,0 +1,7 @@
+/**
+ * Default fallback (web and other platforms).
+ * Always returns `true`.
+ */
+export async function requestPermission(): Promise<boolean> {
+  return true;
+}

package/src/NativeLocalNetworkPermission.ts

@@ -0,0 +1,22 @@
+import { TurboModuleRegistry, type TurboModule } from 'react-native';
+
+/**
+ * Native module spec for codegen.
+ *
+ * The return type uses inline object shapes because TurboModule codegen
+ * does not support importing custom TypeScript types.
+ */
+export interface Spec extends TurboModule {
+  /**
+   * Request (or check) local network permission.
+   * On iOS this uses the NWBrowser/NWListener trick and may trigger the
+   * system permission dialog if the user has not yet made a choice.
+   *
+   * Resolves with `true` if granted, `false` if denied.
+   */
+  requestPermission(): Promise<boolean>;
+}
+
+export default TurboModuleRegistry.getEnforcing<Spec>(
+  'LocalNetworkPermission'
+);

package/src/index.tsx

@@ -0,0 +1 @@
+export { requestPermission } from './LocalNetworkPermission';