react-native-nitro-geolocation 0.4.0 → 1.0.0

package/LICENSE

@@ -1,24 +1,24 @@
-MIT License
+This is free and unencumbered software released into the public domain.
 
-This project is a Nitro Modules port of @react-native-community/geolocation
+Anyone is free to copy, modify, publish, use, compile, sell, or
+distribute this software, either in source code form or as a compiled
+binary, for any purpose, commercial or non-commercial, and by any
+means.
 
-Original work Copyright (c) 2022-present, React Native Community
-Modified work Copyright (c) 2025, jingjing2222
+In jurisdictions that recognize copyright laws, the author or authors
+of this software dedicate any and all copyright interest in the
+software to the public domain. We make this dedication for the benefit
+of the public at large and to the detriment of our heirs and
+successors. We intend this dedication to be an overt act of
+relinquishment in perpetuity of all present and future rights to this
+software under copyright law.
 
-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 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 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.
 
-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.
+For more information, please refer to <http://unlicense.org/>

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "react-native-nitro-geolocation",
-  "version": "0.4.0",
+  "version": "1.0.0",
   "description": "⚡🚀Blazing-fast geolocation for React Native powered by Nitro Modules",
   "main": "src/index",
   "source": "src/index",
@@ -23,7 +23,7 @@
     "typecheck": "tsc --noEmit"
   },
   "author": "jingjing2222",
-  "license": "MIT",
+  "license": "Unlicense",
   "homepage": "https://react-native-nitro-geolocation.pages.dev",
   "repository": "https://github.com/jingjing2222/react-native-nitro-geolocation",
   "files": [

package/src/api/getCurrentPosition.ts

@@ -1,5 +1,7 @@
 import type { LocationRequestOptions } from "../NitroGeolocation.nitro";
 import { NitroGeolocationHybridObject } from "../NitroGeolocationModule";
+import { isDevtoolsEnabled } from "../devtools";
+import { getDevtoolsCurrentPosition } from "../devtools/getCurrentPosition";
 import type { GeolocationResponse } from "../types";
 
 /**
@@ -31,5 +33,11 @@ import type { GeolocationResponse } from "../types";
 export function getCurrentPosition(
   options?: LocationRequestOptions
 ): Promise<GeolocationResponse> {
+  if (isDevtoolsEnabled()) {
+    const devtoolsResult = getDevtoolsCurrentPosition();
+    if (devtoolsResult) {
+      return devtoolsResult;
+    }
+  }
   return NitroGeolocationHybridObject.getCurrentPosition(options);
 }

package/src/api/unwatch.ts

@@ -1,4 +1,5 @@
 import { NitroGeolocationHybridObject } from "../NitroGeolocationModule";
+import { devtoolsUnwatch } from "../devtools/watchPosition";
 
 /**
  * Stop a specific watch subscription.
@@ -14,5 +15,8 @@ import { NitroGeolocationHybridObject } from "../NitroGeolocationModule";
  * ```
  */
 export function unwatch(token: string): void {
+  if (devtoolsUnwatch(token)) {
+    return;
+  }
   NitroGeolocationHybridObject.unwatch(token);
 }

package/src/api/watchPosition.ts

@@ -3,6 +3,8 @@ import type {
   LocationRequestOptions
 } from "../NitroGeolocation.nitro";
 import { NitroGeolocationHybridObject } from "../NitroGeolocationModule";
+import { isDevtoolsEnabled } from "../devtools";
+import { devtoolsWatchPosition } from "../devtools/watchPosition";
 import type { GeolocationResponse } from "../types";
 
 /**
@@ -34,5 +36,8 @@ export function watchPosition(
   error?: (error: LocationError) => void,
   options?: LocationRequestOptions
 ): string {
+  if (isDevtoolsEnabled()) {
+    return devtoolsWatchPosition(success, error);
+  }
   return NitroGeolocationHybridObject.watchPosition(success, error, options);
 }

package/src/devtools/getCurrentPosition.ts

@@ -0,0 +1,15 @@
+import type { GeolocationResponse } from "../types";
+import { getDevtoolsState } from "./index";
+
+export function getDevtoolsCurrentPosition(): Promise<GeolocationResponse> | null {
+  const devtools = getDevtoolsState();
+  if (devtools.position) {
+    return Promise.resolve(devtools.position);
+  }
+  // Devtools not connected - throw error
+  return Promise.reject(
+    new Error(
+      "Geolocation devtools not connected. Press 'j' in Metro to open devtools and enable the geolocation plugin."
+    )
+  );
+}

package/src/devtools/index.ts

@@ -0,0 +1,23 @@
+import type { GeolocationResponse } from "../types";
+
+declare global {
+  var __geolocationDevToolsEnabled: boolean | undefined;
+  var __geolocationDevtools: DevtoolsState | undefined;
+}
+
+interface DevtoolsState {
+  position: GeolocationResponse | null;
+}
+
+export function getDevtoolsState(): DevtoolsState {
+  if (!globalThis.__geolocationDevtools) {
+    globalThis.__geolocationDevtools = {
+      position: null
+    };
+  }
+  return globalThis.__geolocationDevtools;
+}
+
+export function isDevtoolsEnabled(): boolean {
+  return globalThis.__geolocationDevToolsEnabled === true;
+}

package/src/devtools/watchPosition.ts

@@ -0,0 +1,66 @@
+import type { GeolocationError, GeolocationResponse } from "../types";
+import { getDevtoolsState } from "./index";
+
+export function devtoolsWatchPosition(
+  success: (position: GeolocationResponse) => void,
+  error?: (error: GeolocationError) => void
+): string {
+  const devtools = getDevtoolsState();
+
+  // Check if devtools has position at all
+  if (!devtools.position) {
+    // Call error callback immediately if provided
+    if (error) {
+      error({
+        code: 2, // POSITION_UNAVAILABLE
+        message:
+          "Geolocation devtools not connected. Press 'j' in Metro to open devtools and enable the geolocation plugin.",
+        PERMISSION_DENIED: 1,
+        POSITION_UNAVAILABLE: 2,
+        TIMEOUT: 3
+      });
+    }
+    // Return a dummy token that does nothing
+    return `devtools-error-${Date.now()}`;
+  }
+
+  let previousPosition = devtools.position;
+
+  // Send initial position immediately if available
+  success(devtools.position);
+
+  const interval = setInterval(() => {
+    if (devtools.position && devtools.position !== previousPosition) {
+      previousPosition = devtools.position;
+      success(devtools.position);
+    }
+  }, 100);
+
+  // Return a cleanup token
+  const token = `devtools-${Date.now()}`;
+  (globalThis as any).__devtoolsWatchers =
+    (globalThis as any).__devtoolsWatchers || {};
+  (globalThis as any).__devtoolsWatchers[token] = interval;
+
+  return token;
+}
+
+export function devtoolsUnwatch(token: string): boolean {
+  if (!token.startsWith("devtools-")) {
+    return false;
+  }
+
+  // Handle error tokens (no cleanup needed)
+  if (token.startsWith("devtools-error-")) {
+    return true;
+  }
+
+  const watchers = (globalThis as any).__devtoolsWatchers;
+  if (watchers?.[token]) {
+    clearInterval(watchers[token]);
+    delete watchers[token];
+    return true;
+  }
+
+  return false;
+}

package/src/hooks/useWatchPosition.ts

@@ -3,7 +3,7 @@ import type {
   LocationError,
   LocationRequestOptions
 } from "../NitroGeolocation.nitro";
-import { NitroGeolocationHybridObject } from "../NitroGeolocationModule";
+import { unwatch, watchPosition } from "../api";
 import type { GeolocationResponse } from "../types";
 
 /**
@@ -76,7 +76,7 @@ export function useWatchPosition(options?: UseWatchPositionOptions) {
     if (!enabled) {
       // Not enabled, ensure cleanup
       if (tokenRef.current) {
-        NitroGeolocationHybridObject.unwatch(tokenRef.current);
+        unwatch(tokenRef.current);
         tokenRef.current = null;
       }
       setIsWatching(false);
@@ -87,7 +87,7 @@ export function useWatchPosition(options?: UseWatchPositionOptions) {
     setIsWatching(true);
     setError(null);
 
-    const token = NitroGeolocationHybridObject.watchPosition(
+    const token = watchPosition(
       (result: GeolocationResponse) => {
         // Success callback
         if (!isMountedRef.current) return;
@@ -107,7 +107,7 @@ export function useWatchPosition(options?: UseWatchPositionOptions) {
     // Cleanup function
     return () => {
       if (token) {
-        NitroGeolocationHybridObject.unwatch(token);
+        unwatch(token);
       }
     };
   }, [enabled]); // Only re-subscribe when enabled changes