@inoxialabs/react-native-nitro-location-geocoder 0.1.0 → 1.0.1

package/package.json

@@ -1,65 +1,65 @@
-{
-  "name": "@inoxialabs/react-native-nitro-location-geocoder",
-  "version": "0.1.0",
-  "description": "React Native Nitro module for reverse geocoding coordinates into country and locality context.",
-  "license": "Apache-2.0",
-  "author": "Inoxia Labs",
-  "main": "src/index",
-  "source": "src/index",
-  "types": "src/index.ts",
-  "react-native": "src/index",
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/inoxIALabs/react-native-nitro-location-geocoder.git"
-  },
-  "homepage": "https://github.com/inoxIALabs/react-native-nitro-location-geocoder#readme",
-  "bugs": {
-    "url": "https://github.com/inoxIALabs/react-native-nitro-location-geocoder/issues"
-  },
-  "publishConfig": {
-    "access": "public"
-  },
-  "keywords": [
-    "react-native",
-    "nitro",
-    "geocoder",
-    "location",
-    "country",
-    "locality",
-    "reverse-geocoding",
-    "ios",
-    "android"
-  ],
-  "files": [
-    "src",
-    "react-native.config.js",
-    "nitro.json",
-    "nitrogen",
-    "android/build.gradle",
-    "android/fix-prefab.gradle",
-    "android/gradle.properties",
-    "android/CMakeLists.txt",
-    "android/src/**/*",
-    "ios/**/*.h",
-    "ios/**/*.m",
-    "ios/**/*.mm",
-    "ios/**/*.cpp",
-    "ios/**/*.swift",
-    "*.podspec",
-    "README.md",
-    "LICENSE"
-  ],
-  "scripts": {
-    "specs": "nitrogen --logLevel=debug",
-    "test": "vitest run"
-  },
-  "peerDependencies": {
-    "react": "*",
-    "react-native": "*",
-    "react-native-nitro-modules": "^0.35.0"
-  },
-  "devDependencies": {
-    "nitrogen": "^0.35.0",
-    "vitest": "^3.2.4"
-  }
-}
+{
+  "name": "@inoxialabs/react-native-nitro-location-geocoder",
+  "version": "1.0.1",
+  "description": "React Native Nitro module for reverse geocoding coordinates into country and locality context.",
+  "license": "Apache-2.0",
+  "author": "Inoxia Labs",
+  "main": "src/index",
+  "source": "src/index",
+  "types": "src/index.ts",
+  "react-native": "src/index",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/inoxIALabs/react-native-nitro-location-geocoder.git"
+  },
+  "homepage": "https://github.com/inoxIALabs/react-native-nitro-location-geocoder#readme",
+  "bugs": {
+    "url": "https://github.com/inoxIALabs/react-native-nitro-location-geocoder/issues"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "keywords": [
+    "react-native",
+    "nitro",
+    "geocoder",
+    "location",
+    "country",
+    "locality",
+    "reverse-geocoding",
+    "ios",
+    "android"
+  ],
+  "files": [
+    "src",
+    "react-native.config.js",
+    "nitro.json",
+    "nitrogen",
+    "android/build.gradle",
+    "android/fix-prefab.gradle",
+    "android/gradle.properties",
+    "android/CMakeLists.txt",
+    "android/src/**/*",
+    "ios/**/*.h",
+    "ios/**/*.m",
+    "ios/**/*.mm",
+    "ios/**/*.cpp",
+    "ios/**/*.swift",
+    "*.podspec",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "specs": "nitrogen --logLevel=debug",
+    "test": "vitest run"
+  },
+  "peerDependencies": {
+    "react": "*",
+    "react-native": "*",
+    "react-native-nitro-modules": "^0.35.0 || ^0.36.0"
+  },
+  "devDependencies": {
+    "nitrogen": "^0.36.1",
+    "vitest": "^3.2.4"
+  }
+}

package/react-native.config.js

@@ -1,8 +1,8 @@
-module.exports = {
-  dependency: {
-    platforms: {
-      ios: {},
-      android: {},
-    },
-  },
-};
+module.exports = {
+  dependency: {
+    platforms: {
+      ios: {},
+      android: {},
+    },
+  },
+};

package/src/index.ts

@@ -1,21 +1,53 @@
-import { NitroModules } from 'react-native-nitro-modules';
-import type { LocationGeocoder, LocationGeocoderResult } from './specs/LocationGeocoder.nitro';
-
-const createGeocoder = (): LocationGeocoder => {
-  return NitroModules.createHybridObject<LocationGeocoder>('LocationGeocoder');
-};
-
-const Geocoder = createGeocoder();
-
-export const reverseGeocode = (
-  latitude: number,
-  longitude: number,
-  locale: string,
-): Promise<LocationGeocoderResult> => {
-  return Geocoder.reverseGeocode(latitude, longitude, locale);
-};
-
-export { Geocoder };
-export type { LocationGeocoder, LocationGeocoderResult };
-
-export default Geocoder;
+import { NitroModules } from 'react-native-nitro-modules';
+import type { LocationGeocoder, LocationGeocoderResult } from './specs/LocationGeocoder.nitro';
+
+const KNOWN_ERROR_MESSAGES = [
+  'GEOCODER_FAILED',
+  'GEOCODER_TIMEOUT',
+  'INVALID_COORDINATES',
+  'NO_RESULTS',
+  'UNAVAILABLE',
+] as const;
+
+const createGeocoder = (): LocationGeocoder => {
+  return NitroModules.createHybridObject<LocationGeocoder>('LocationGeocoder');
+};
+
+const Geocoder = createGeocoder();
+
+const isValidLatitude = (latitude: number): boolean =>
+  Number.isFinite(latitude) && latitude >= -90 && latitude <= 90;
+
+const isValidLongitude = (longitude: number): boolean =>
+  Number.isFinite(longitude) && longitude >= -180 && longitude <= 180;
+
+const normalizeGeocoderError = (error: unknown): Error => {
+  const message = error instanceof Error
+    ? error.message
+    : String((error as { message?: unknown } | null)?.message ?? error ?? '');
+
+  if (KNOWN_ERROR_MESSAGES.some((known) => message.startsWith(known))) {
+    return error instanceof Error ? error : new Error(message);
+  }
+
+  return new Error(`GEOCODER_FAILED${message ? `: ${message}` : ''}`);
+};
+
+export const reverseGeocode = (
+  latitude: number,
+  longitude: number,
+  locale: string,
+): Promise<LocationGeocoderResult> => {
+  if (!isValidLatitude(latitude) || !isValidLongitude(longitude)) {
+    return Promise.reject(new Error('INVALID_COORDINATES'));
+  }
+
+  return Geocoder.reverseGeocode(latitude, longitude, locale).catch((error: unknown) => {
+    throw normalizeGeocoderError(error);
+  });
+};
+
+export { Geocoder };
+export type { LocationGeocoder, LocationGeocoderResult };
+
+export default Geocoder;

package/src/specs/LocationGeocoder.nitro.ts

@@ -1,14 +1,14 @@
-import type { HybridObject } from 'react-native-nitro-modules';
-
-export interface LocationGeocoderResult {
-  countryCode: string;
-  country: string;
-  locality: string;
-  administrativeArea: string;
-  subAdministrativeArea: string;
-  subLocality: string;
-}
-
-export interface LocationGeocoder extends HybridObject<{ ios: 'swift'; android: 'kotlin' }> {
-  reverseGeocode(latitude: number, longitude: number, locale: string): Promise<LocationGeocoderResult>;
-}
+import type { HybridObject } from 'react-native-nitro-modules';
+
+export interface LocationGeocoderResult {
+  countryCode: string;
+  country: string;
+  locality: string;
+  administrativeArea: string;
+  subAdministrativeArea: string;
+  subLocality: string;
+}
+
+export interface LocationGeocoder extends HybridObject<{ ios: 'swift'; android: 'kotlin' }> {
+  reverseGeocode(latitude: number, longitude: number, locale: string): Promise<LocationGeocoderResult>;
+}