react-native-nitro-geolocation 1.2.0 → 1.2.1

package/README.md

@@ -291,7 +291,29 @@ Geolocation.clearWatch(watchId);
 
 ## 🔄 Migration from `@react-native-community/geolocation`
 
-Change the import to use `/compat` — 100% API compatible:
+For Modern API migration, install the Agent Skills-compatible migration
+playbook from this repository. It is migration assistance for coding agents, not
+a fully automatic migration. The skill first runs a package-manager-aware
+compat bootstrap script that installs the Nitro packages, rewrites legacy import
+sources to `/compat`, and removes `@react-native-community/geolocation`. After
+that safe mechanical step, it guides the agent to refactor compat call sites to
+Modern API best practices using explicit criteria for permission timing, React
+lifecycle ownership, watch cleanup, cache-vs-fresh location reads, accuracy, and
+Android provider/settings handling.
+
+With the Vercel Labs `skills` CLI:
+
+```bash
+npx skills add jingjing2222/react-native-nitro-geolocation --skill react-native-nitro-geolocation-modern-migration
+```
+
+The skill source is
+[`skills/react-native-nitro-geolocation-modern-migration/SKILL.md`](https://github.com/jingjing2222/react-native-nitro-geolocation/tree/main/skills/react-native-nitro-geolocation-modern-migration).
+The bundled bootstrap script is
+[`skills/react-native-nitro-geolocation-modern-migration/scripts/migrate-to-compat.mjs`](https://github.com/jingjing2222/react-native-nitro-geolocation/tree/main/skills/react-native-nitro-geolocation-modern-migration/scripts/migrate-to-compat.mjs).
+
+For a drop-in compatibility migration, change the import to use `/compat`:
+
 ```diff
 - import Geolocation from '@react-native-community/geolocation';
 + import Geolocation from 'react-native-nitro-geolocation/compat';

package/android/src/main/java/com/margelo/nitro/nitrogeolocation/NitroGeolocation.kt

@@ -747,6 +747,8 @@ class NitroGeolocation(
     // MARK: - Helper Functions - Provider Selection
 
     private fun requiresPlayServices(): Boolean {
+        // TODO: Switch auto/default Android provider selection to prefer
+        // Google Play Services when available.
         return configuration?.locationProvider == LocationProvider.PLAYSERVICES
     }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "react-native-nitro-geolocation",
-  "version": "1.2.0",
+  "version": "1.2.1",
   "description": "⚡🚀Blazing-fast geolocation for React Native powered by Nitro Modules",
   "main": "src/index",
   "source": "src/index",

package/src/NitroGeolocation.nitro.ts

@@ -67,7 +67,7 @@ export interface GeolocationConfiguration {
    * Android: Location provider
    * - 'playServices': Use Google Play Services (fused location)
    * - 'android_platform': Use Android platform LocationManager
-   * - 'auto': Auto-select (prefer Play Services if available)
+   * - 'auto': Use Android platform LocationManager by default
    */
   locationProvider?: LocationProvider;
 }

package/src/publicTypes.ts

@@ -79,6 +79,12 @@ export type GeolocationConfiguration = Omit<
    */
   autoRequestPermission?: boolean;
 
+  /**
+   * Android location provider.
+   *
+   * `auto` currently uses Android's platform `LocationManager` by default.
+   * Set `playServices` explicitly to use Google Play Services fused location.
+   */
   locationProvider?: LocationProvider;
 };
 
@@ -92,5 +98,11 @@ export type CompatGeolocationConfiguration = Omit<
   CompatGeolocationConfigurationInternal,
   "locationProvider"
 > & {
+  /**
+   * Android location provider.
+   *
+   * `auto` currently uses Android's platform `LocationManager` by default.
+   * Set `playServices` explicitly to use Google Play Services fused location.
+   */
   locationProvider?: LocationProvider;
 };