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

package/nitrogen/generated/ios/swift/HybridLocationGeocoderSpec_cxx.swift

@@ -0,0 +1,145 @@
+///
+/// HybridLocationGeocoderSpec_cxx.swift
+/// This file was generated by nitrogen. DO NOT MODIFY THIS FILE.
+/// https://github.com/mrousavy/nitro
+/// Copyright © Marc Rousavy @ Margelo
+///
+
+import NitroModules
+
+/**
+ * A class implementation that bridges HybridLocationGeocoderSpec over to C++.
+ * In C++, we cannot use Swift protocols - so we need to wrap it in a class to make it strongly defined.
+ *
+ * Also, some Swift types need to be bridged with special handling:
+ * - Enums need to be wrapped in Structs, otherwise they cannot be accessed bi-directionally (Swift bug: https://github.com/swiftlang/swift/issues/75330)
+ * - Other HybridObjects need to be wrapped/unwrapped from the Swift TCxx wrapper
+ * - Throwing methods need to be wrapped with a Result<T, Error> type, as exceptions cannot be propagated to C++
+ */
+open class HybridLocationGeocoderSpec_cxx {
+  /**
+   * The Swift <> C++ bridge's namespace (`margelo::nitro::locationgeocoder::bridge::swift`)
+   * from `NitroLocationGeocoder-Swift-Cxx-Bridge.hpp`.
+   * This contains specialized C++ templates, and C++ helper functions that can be accessed from Swift.
+   */
+  public typealias bridge = margelo.nitro.locationgeocoder.bridge.swift
+
+  /**
+   * Holds an instance of the `HybridLocationGeocoderSpec` Swift protocol.
+   */
+  private var __implementation: any HybridLocationGeocoderSpec
+
+  /**
+   * Holds a weak pointer to the C++ class that wraps the Swift class.
+   */
+  private var __cxxPart: bridge.std__weak_ptr_HybridLocationGeocoderSpec_
+
+  /**
+   * Create a new `HybridLocationGeocoderSpec_cxx` that wraps the given `HybridLocationGeocoderSpec`.
+   * All properties and methods bridge to C++ types.
+   */
+  public init(_ implementation: any HybridLocationGeocoderSpec) {
+    self.__implementation = implementation
+    self.__cxxPart = .init()
+    /* no base class */
+  }
+
+  /**
+   * Get the actual `HybridLocationGeocoderSpec` instance this class wraps.
+   */
+  @inline(__always)
+  public func getHybridLocationGeocoderSpec() -> any HybridLocationGeocoderSpec {
+    return __implementation
+  }
+
+  /**
+   * Casts this instance to a retained unsafe raw pointer.
+   * This acquires one additional strong reference on the object!
+   */
+  public func toUnsafe() -> UnsafeMutableRawPointer {
+    return Unmanaged.passRetained(self).toOpaque()
+  }
+
+  /**
+   * Casts an unsafe pointer to a `HybridLocationGeocoderSpec_cxx`.
+   * The pointer has to be a retained opaque `Unmanaged<HybridLocationGeocoderSpec_cxx>`.
+   * This removes one strong reference from the object!
+   */
+  public class func fromUnsafe(_ pointer: UnsafeMutableRawPointer) -> HybridLocationGeocoderSpec_cxx {
+    return Unmanaged<HybridLocationGeocoderSpec_cxx>.fromOpaque(pointer).takeRetainedValue()
+  }
+
+  /**
+   * Gets (or creates) the C++ part of this Hybrid Object.
+   * The C++ part is a `std::shared_ptr<HybridLocationGeocoderSpec>`.
+   */
+  public func getCxxPart() -> bridge.std__shared_ptr_HybridLocationGeocoderSpec_ {
+    let cachedCxxPart = self.__cxxPart.lock()
+    if Bool(fromCxx: cachedCxxPart) {
+      return cachedCxxPart
+    } else {
+      let newCxxPart = bridge.create_std__shared_ptr_HybridLocationGeocoderSpec_(self.toUnsafe())
+      __cxxPart = bridge.weakify_std__shared_ptr_HybridLocationGeocoderSpec_(newCxxPart)
+      return newCxxPart
+    }
+  }
+
+  
+
+  /**
+   * Get the memory size of the Swift class (plus size of any other allocations)
+   * so the JS VM can properly track it and garbage-collect the JS object if needed.
+   */
+  @inline(__always)
+  public var memorySize: Int {
+    return MemoryHelper.getSizeOf(self.__implementation) + self.__implementation.memorySize
+  }
+
+  /**
+   * Compares this object with the given [other] object for reference equality.
+   */
+  @inline(__always)
+  public func equals(other: HybridLocationGeocoderSpec_cxx) -> Bool {
+    return self.__implementation === other.__implementation
+  }
+
+  /**
+   * Call dispose() on the Swift class.
+   * This _may_ be called manually from JS.
+   */
+  @inline(__always)
+  public func dispose() {
+    self.__implementation.dispose()
+  }
+
+  /**
+   * Call toString() on the Swift class.
+   */
+  @inline(__always)
+  public func toString() -> String {
+    return self.__implementation.toString()
+  }
+
+  // Properties
+  
+
+  // Methods
+  @inline(__always)
+  public final func reverseGeocode(latitude: Double, longitude: Double, locale: std.string) -> bridge.Result_std__shared_ptr_Promise_LocationGeocoderResult___ {
+    do {
+      let __result = try self.__implementation.reverseGeocode(latitude: latitude, longitude: longitude, locale: String(locale))
+      let __resultCpp = { () -> bridge.std__shared_ptr_Promise_LocationGeocoderResult__ in
+        let __promise = bridge.create_std__shared_ptr_Promise_LocationGeocoderResult__()
+        let __promiseHolder = bridge.wrap_std__shared_ptr_Promise_LocationGeocoderResult__(__promise)
+        __result
+          .then({ __result in __promiseHolder.resolve(__result) })
+          .catch({ __error in __promiseHolder.reject(__error.toCpp()) })
+        return __promise
+      }()
+      return bridge.create_Result_std__shared_ptr_Promise_LocationGeocoderResult___(__resultCpp)
+    } catch (let __error) {
+      let __exceptionPtr = __error.toCpp()
+      return bridge.create_Result_std__shared_ptr_Promise_LocationGeocoderResult___(__exceptionPtr)
+    }
+  }
+}

package/nitrogen/generated/ios/swift/LocationGeocoderResult.swift

@@ -0,0 +1,54 @@
+///
+/// LocationGeocoderResult.swift
+/// This file was generated by nitrogen. DO NOT MODIFY THIS FILE.
+/// https://github.com/mrousavy/nitro
+/// Copyright © Marc Rousavy @ Margelo
+///
+
+import NitroModules
+
+/**
+ * Represents an instance of `LocationGeocoderResult`, backed by a C++ struct.
+ */
+public typealias LocationGeocoderResult = margelo.nitro.locationgeocoder.LocationGeocoderResult
+
+public extension LocationGeocoderResult {
+  private typealias bridge = margelo.nitro.locationgeocoder.bridge.swift
+
+  /**
+   * Create a new instance of `LocationGeocoderResult`.
+   */
+  init(countryCode: String, country: String, locality: String, administrativeArea: String, subAdministrativeArea: String, subLocality: String) {
+    self.init(std.string(countryCode), std.string(country), std.string(locality), std.string(administrativeArea), std.string(subAdministrativeArea), std.string(subLocality))
+  }
+
+  @inline(__always)
+  var countryCode: String {
+    return String(self.__countryCode)
+  }
+  
+  @inline(__always)
+  var country: String {
+    return String(self.__country)
+  }
+  
+  @inline(__always)
+  var locality: String {
+    return String(self.__locality)
+  }
+  
+  @inline(__always)
+  var administrativeArea: String {
+    return String(self.__administrativeArea)
+  }
+  
+  @inline(__always)
+  var subAdministrativeArea: String {
+    return String(self.__subAdministrativeArea)
+  }
+  
+  @inline(__always)
+  var subLocality: String {
+    return String(self.__subLocality)
+  }
+}

package/nitrogen/generated/shared/c++/HybridLocationGeocoderSpec.cpp

@@ -0,0 +1,21 @@
+///
+/// HybridLocationGeocoderSpec.cpp
+/// This file was generated by nitrogen. DO NOT MODIFY THIS FILE.
+/// https://github.com/mrousavy/nitro
+/// Copyright © Marc Rousavy @ Margelo
+///
+
+#include "HybridLocationGeocoderSpec.hpp"
+
+namespace margelo::nitro::locationgeocoder {
+
+  void HybridLocationGeocoderSpec::loadHybridMethods() {
+    // load base methods/properties
+    HybridObject::loadHybridMethods();
+    // load custom methods/properties
+    registerHybrids(this, [](Prototype& prototype) {
+      prototype.registerHybridMethod("reverseGeocode", &HybridLocationGeocoderSpec::reverseGeocode);
+    });
+  }
+
+} // namespace margelo::nitro::locationgeocoder

package/nitrogen/generated/shared/c++/HybridLocationGeocoderSpec.hpp

@@ -0,0 +1,65 @@
+///
+/// HybridLocationGeocoderSpec.hpp
+/// This file was generated by nitrogen. DO NOT MODIFY THIS FILE.
+/// https://github.com/mrousavy/nitro
+/// Copyright © Marc Rousavy @ Margelo
+///
+
+#pragma once
+
+#if __has_include(<NitroModules/HybridObject.hpp>)
+#include <NitroModules/HybridObject.hpp>
+#else
+#error NitroModules cannot be found! Are you sure you installed NitroModules properly?
+#endif
+
+// Forward declaration of `LocationGeocoderResult` to properly resolve imports.
+namespace margelo::nitro::locationgeocoder { struct LocationGeocoderResult; }
+
+#include "LocationGeocoderResult.hpp"
+#include <NitroModules/Promise.hpp>
+#include <string>
+
+namespace margelo::nitro::locationgeocoder {
+
+  using namespace margelo::nitro;
+
+  /**
+   * An abstract base class for `LocationGeocoder`
+   * Inherit this class to create instances of `HybridLocationGeocoderSpec` in C++.
+   * You must explicitly call `HybridObject`'s constructor yourself, because it is virtual.
+   * @example
+   * ```cpp
+   * class HybridLocationGeocoder: public HybridLocationGeocoderSpec {
+   * public:
+   *   HybridLocationGeocoder(...): HybridObject(TAG) { ... }
+   *   // ...
+   * };
+   * ```
+   */
+  class HybridLocationGeocoderSpec: public virtual HybridObject {
+    public:
+      // Constructor
+      explicit HybridLocationGeocoderSpec(): HybridObject(TAG) { }
+
+      // Destructor
+      ~HybridLocationGeocoderSpec() override = default;
+
+    public:
+      // Properties
+      
+
+    public:
+      // Methods
+      virtual std::shared_ptr<Promise<LocationGeocoderResult>> reverseGeocode(double latitude, double longitude, const std::string& locale) = 0;
+
+    protected:
+      // Hybrid Setup
+      void loadHybridMethods() override;
+
+    protected:
+      // Tag for logging
+      static constexpr auto TAG = "LocationGeocoder";
+  };
+
+} // namespace margelo::nitro::locationgeocoder

package/nitrogen/generated/shared/c++/LocationGeocoderResult.hpp

@@ -0,0 +1,103 @@
+///
+/// LocationGeocoderResult.hpp
+/// This file was generated by nitrogen. DO NOT MODIFY THIS FILE.
+/// https://github.com/mrousavy/nitro
+/// Copyright © Marc Rousavy @ Margelo
+///
+
+#pragma once
+
+#if __has_include(<NitroModules/JSIConverter.hpp>)
+#include <NitroModules/JSIConverter.hpp>
+#else
+#error NitroModules cannot be found! Are you sure you installed NitroModules properly?
+#endif
+#if __has_include(<NitroModules/NitroDefines.hpp>)
+#include <NitroModules/NitroDefines.hpp>
+#else
+#error NitroModules cannot be found! Are you sure you installed NitroModules properly?
+#endif
+#if __has_include(<NitroModules/JSIHelpers.hpp>)
+#include <NitroModules/JSIHelpers.hpp>
+#else
+#error NitroModules cannot be found! Are you sure you installed NitroModules properly?
+#endif
+#if __has_include(<NitroModules/PropNameIDCache.hpp>)
+#include <NitroModules/PropNameIDCache.hpp>
+#else
+#error NitroModules cannot be found! Are you sure you installed NitroModules properly?
+#endif
+
+
+
+#include <string>
+
+namespace margelo::nitro::locationgeocoder {
+
+  /**
+   * A struct which can be represented as a JavaScript object (LocationGeocoderResult).
+   */
+  struct LocationGeocoderResult final {
+  public:
+    std::string countryCode     SWIFT_PRIVATE;
+    std::string country     SWIFT_PRIVATE;
+    std::string locality     SWIFT_PRIVATE;
+    std::string administrativeArea     SWIFT_PRIVATE;
+    std::string subAdministrativeArea     SWIFT_PRIVATE;
+    std::string subLocality     SWIFT_PRIVATE;
+
+  public:
+    LocationGeocoderResult() = default;
+    explicit LocationGeocoderResult(std::string countryCode, std::string country, std::string locality, std::string administrativeArea, std::string subAdministrativeArea, std::string subLocality): countryCode(countryCode), country(country), locality(locality), administrativeArea(administrativeArea), subAdministrativeArea(subAdministrativeArea), subLocality(subLocality) {}
+
+  public:
+    friend bool operator==(const LocationGeocoderResult& lhs, const LocationGeocoderResult& rhs) = default;
+  };
+
+} // namespace margelo::nitro::locationgeocoder
+
+namespace margelo::nitro {
+
+  // C++ LocationGeocoderResult <> JS LocationGeocoderResult (object)
+  template <>
+  struct JSIConverter<margelo::nitro::locationgeocoder::LocationGeocoderResult> final {
+    static inline margelo::nitro::locationgeocoder::LocationGeocoderResult fromJSI(jsi::Runtime& runtime, const jsi::Value& arg) {
+      jsi::Object obj = arg.asObject(runtime);
+      return margelo::nitro::locationgeocoder::LocationGeocoderResult(
+        JSIConverter<std::string>::fromJSI(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "countryCode"))),
+        JSIConverter<std::string>::fromJSI(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "country"))),
+        JSIConverter<std::string>::fromJSI(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "locality"))),
+        JSIConverter<std::string>::fromJSI(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "administrativeArea"))),
+        JSIConverter<std::string>::fromJSI(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "subAdministrativeArea"))),
+        JSIConverter<std::string>::fromJSI(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "subLocality")))
+      );
+    }
+    static inline jsi::Value toJSI(jsi::Runtime& runtime, const margelo::nitro::locationgeocoder::LocationGeocoderResult& arg) {
+      jsi::Object obj(runtime);
+      obj.setProperty(runtime, PropNameIDCache::get(runtime, "countryCode"), JSIConverter<std::string>::toJSI(runtime, arg.countryCode));
+      obj.setProperty(runtime, PropNameIDCache::get(runtime, "country"), JSIConverter<std::string>::toJSI(runtime, arg.country));
+      obj.setProperty(runtime, PropNameIDCache::get(runtime, "locality"), JSIConverter<std::string>::toJSI(runtime, arg.locality));
+      obj.setProperty(runtime, PropNameIDCache::get(runtime, "administrativeArea"), JSIConverter<std::string>::toJSI(runtime, arg.administrativeArea));
+      obj.setProperty(runtime, PropNameIDCache::get(runtime, "subAdministrativeArea"), JSIConverter<std::string>::toJSI(runtime, arg.subAdministrativeArea));
+      obj.setProperty(runtime, PropNameIDCache::get(runtime, "subLocality"), JSIConverter<std::string>::toJSI(runtime, arg.subLocality));
+      return obj;
+    }
+    static inline bool canConvert(jsi::Runtime& runtime, const jsi::Value& value) {
+      if (!value.isObject()) {
+        return false;
+      }
+      jsi::Object obj = value.getObject(runtime);
+      if (!nitro::isPlainObject(runtime, obj)) {
+        return false;
+      }
+      if (!JSIConverter<std::string>::canConvert(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "countryCode")))) return false;
+      if (!JSIConverter<std::string>::canConvert(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "country")))) return false;
+      if (!JSIConverter<std::string>::canConvert(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "locality")))) return false;
+      if (!JSIConverter<std::string>::canConvert(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "administrativeArea")))) return false;
+      if (!JSIConverter<std::string>::canConvert(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "subAdministrativeArea")))) return false;
+      if (!JSIConverter<std::string>::canConvert(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "subLocality")))) return false;
+      return true;
+    }
+  };
+
+} // namespace margelo::nitro

package/package.json

@@ -0,0 +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"
+  }
+}

package/react-native.config.js

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

package/src/index.ts

@@ -0,0 +1,21 @@
+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;

package/src/specs/LocationGeocoder.nitro.ts

@@ -0,0 +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>;
+}