@woosmap/react-native-plugin-geofencing 0.13.2 → 1.0.0-beta.1

package/CHANGELOG.md

@@ -1,3 +1,11 @@
+## 1.0.0
+- Enhancement: Introduced the `WoosmapGeofencingTurbo` TurboModule (New Architecture). 
+— The region-CRUD and key/radius methods  `addRegion`, `removeRegions`, `getRegions`, `setPoiRadius`, `setWoosmapApiKey` now dispatch through the generated codegen path. All other methods continue to flow through the legacy `PluginGeofencing` module. Public JS API is unchanged.
+
+## 0.14.0
+- Breaking: Raised minimum supported React Native to `0.85.x`; React `19.2.3`.
+- Breaking: Android requires JDK 17, Kotlin `2.1.x`, AGP `8.10.x`, Gradle `8.14.x`, `compileSdk`/`targetSdk` `36`.
+- Breaking: Node.js `>=22` required by the app toolchain.
 ## 0.13.2
 - Patch: Internal refinement
 

package/README.md

@@ -12,3 +12,19 @@ The SDK simplifies the integration of the location context in your mobile applic
 All feature descriptions and guides to implement the Woosmap Geofencing Android & iOS SDK are available on the [Woosmap developers documentation](https://developers.woosmap.com/products/geofencing-sdk/get-started/).
 
 If you are looking for the Woosmap Geofencing React Native plugin documentation, [we have a dedicated section for it](https://developers.woosmap.com/products/geofencing-sdk/react-native-plugin/guides/setup/).
+
+### Requirements
+
+- React Native `>=0.85.0` and React `>=19.2.3`
+- iOS `>=15.1`
+- Android: JDK 17, `minSdk` 24, `compileSdk`/`targetSdk` 36
+- Node.js `>=22`
+
+### React Native architectures
+
+This release supports both the legacy bridge and the New Architecture (Fabric / TurboModules):
+
+- **Legacy bridge** (`newArchEnabled=false` on Android, `RCT_NEW_ARCH_ENABLED=0` on iOS): the plugin is loaded natively as before.
+- **New Architecture** (`newArchEnabled=true` / `RCT_NEW_ARCH_ENABLED=1`): the plugin is loaded through React Native's **interop layer**. No additional setup is required in your app — the plugin's native modules and event emitters are automatically wrapped as TurboModule-compatible instances at runtime.
+
+A full TurboModule / Fabric-native rewrite is planned for a future major release. Until then, consumer apps can opt into the New Architecture without any changes to how they consume this plugin.

package/android/build.gradle

@@ -5,7 +5,7 @@ buildscript {
   }
 
   dependencies {
-    classpath "com.android.tools.build:gradle:8.7.2"
+    classpath "com.android.tools.build:gradle:8.10.0"
   }
 }
 
@@ -17,6 +17,16 @@ apply plugin: "com.android.library"
 
 if (isNewArchitectureEnabled()) {
   apply plugin: "com.facebook.react"
+
+  // Drives TurboModule codegen for the WoosmapGeofencingTurbo spec
+  // (src/NativeWoosmapGeofencingTurbo.ts). Generates the abstract
+  // `NativeWoosmapGeofencingTurboSpec` class under `codegenJavaPackageName`,
+  // which WoosmapGeofencingTurboModule extends.
+  react {
+    jsRootDir = file("../src/")
+    libraryName = "WoosmapGeofencingTurbo"
+    codegenJavaPackageName = "com.woosmap.reactnativeplugingeofencing"
+  }
 }
 
 def getExtOrDefault(name) {
@@ -66,8 +76,8 @@ android {
   }
 
   compileOptions {
-    sourceCompatibility JavaVersion.VERSION_1_8
-    targetCompatibility JavaVersion.VERSION_1_8
+    sourceCompatibility JavaVersion.VERSION_17
+    targetCompatibility JavaVersion.VERSION_17
   }
 }
 

package/android/gradle.properties

@@ -1,5 +1,5 @@
-PluginGeofencing_kotlinVersion=1.8.0
-PluginGeofencing_minSdkVersion=21
-PluginGeofencing_targetSdkVersion=35
-PluginGeofencing_compileSdkVersion=35
-PluginGeofencing_ndkversion=25.1.8937393
+PluginGeofencing_kotlinVersion=2.1.20
+PluginGeofencing_minSdkVersion=24
+PluginGeofencing_targetSdkVersion=36
+PluginGeofencing_compileSdkVersion=36
+PluginGeofencing_ndkversion=27.1.12297006

package/android/src/main/java/com/reactnativeplugingeofencing/PluginGeofencingModule.java

@@ -70,14 +70,6 @@ public class PluginGeofencingModule extends ReactContextBaseJavaModule implement
   }
 
 
-  // Example method
-  // See https://reactnative.dev/docs/native-modules-android
-  @ReactMethod
-  public void multiply(int a, int b, Promise promise) {
-    promise.resolve(a * b);
-  }
-
-
   /***
    * Initializes Woosmap object with given parameters.
    * @param map     ReadableMap may contain privateKeyWoosmapAPI with Woosmap API key,
@@ -468,6 +460,8 @@ public class PluginGeofencingModule extends ReactContextBaseJavaModule implement
    * @param data accepts Woosmap API key in a Readable array.
    * @param promise React native callback context.
    */
+  // implemented in turbo (WoosmapGeofencingTurbo)
+  @Deprecated
   @ReactMethod
   public void setWoosmapApiKey(ReadableArray data, Promise promise) {
     try {
@@ -682,6 +676,8 @@ public class PluginGeofencingModule extends ReactContextBaseJavaModule implement
    * @param radius  A string containing POI radius value in number,string,double format.
    * @param promise React native callback context.
    */
+  // implemented in turbo (WoosmapGeofencingTurbo)
+  @Deprecated
   @ReactMethod
   public void setPoiRadius(String radius, Promise promise) {
     try {
@@ -741,6 +737,8 @@ public class PluginGeofencingModule extends ReactContextBaseJavaModule implement
    * @param map Readable map with region detail.
    * @param promise React native callback context.
    */
+  // implemented in turbo (WoosmapGeofencingTurbo)
+  @Deprecated
   @RequiresApi(api = Build.VERSION_CODES.N)
   @ReactMethod
   public void addRegion(ReadableMap map, Promise promise) {
@@ -772,6 +770,8 @@ public class PluginGeofencingModule extends ReactContextBaseJavaModule implement
    * @param regionid A string unique value for region.
    * @param promise React native callback context.
    */
+  // implemented in turbo (WoosmapGeofencingTurbo)
+  @Deprecated
   @RequiresApi(api = Build.VERSION_CODES.N)
   @ReactMethod
   public void getRegions(String regionid, Promise promise){
@@ -797,6 +797,8 @@ public class PluginGeofencingModule extends ReactContextBaseJavaModule implement
    * Gets all saved region from the database.
    * @param promise React native callback context.
    */
+  // implemented in turbo (WoosmapGeofencingTurbo — getRegions handles all + single)
+  @Deprecated
   @RequiresApi(api = Build.VERSION_CODES.N)
   @ReactMethod
   public void getAllRegions(Promise promise){
@@ -817,6 +819,8 @@ public class PluginGeofencingModule extends ReactContextBaseJavaModule implement
    * @param regionid A unique string region id which is to be removed.
    * @param promise React native callback context.
    */
+  // implemented in turbo (WoosmapGeofencingTurbo)
+  @Deprecated
   @RequiresApi(api = Build.VERSION_CODES.N)
   @ReactMethod
   private void removeRegion(String regionid, Promise promise){
@@ -840,6 +844,8 @@ public class PluginGeofencingModule extends ReactContextBaseJavaModule implement
    * Removes all region from saved database.
    * @param promise React native callback context.
    */
+  // implemented in turbo (WoosmapGeofencingTurbo)
+  @Deprecated
   @RequiresApi(api = Build.VERSION_CODES.N)
   @ReactMethod
   private void removeAllRegions(Promise promise){

package/android/src/main/java/com/reactnativeplugingeofencing/WoosmapGeofencingTurboModule.java

@@ -0,0 +1,185 @@
+package com.reactnativeplugingeofencing;
+
+import android.os.Build;
+
+import androidx.annotation.NonNull;
+import androidx.annotation.Nullable;
+import androidx.annotation.RequiresApi;
+
+import com.facebook.react.bridge.Promise;
+import com.facebook.react.bridge.ReactApplicationContext;
+import com.facebook.react.bridge.ReadableMap;
+import com.facebook.react.module.annotations.ReactModule;
+import com.woosmap.reactnativeplugingeofencing.NativeWoosmapGeofencingTurboSpec;
+import com.webgeoservices.woosmapgeofencing.Woosmap;
+import com.webgeoservices.woosmapgeofencing.WoosmapSettings;
+import com.webgeoservices.woosmapgeofencingcore.database.Region;
+
+/**
+ * TurboModule implementation for the region-CRUD + key/radius slice migrated
+ * Extends the codegen-generated
+ * {@code NativeWoosmapGeofencingTurboSpec} abstract class.
+ *
+ * <p>This is a thin adapter over the shared {@link WoosmapTask} /
+ * {@link WoosmapSettings} layer — the same layer the legacy
+ * {@code PluginGeofencingModule} talks to — so the two modules stay
+ * independent without duplicating business logic. The SDK singleton
+ * ({@link Woosmap#getInstance()}) is shared, so a region added here lands in
+ * the same store that {@code initialize()} (still on the legacy module) set up.
+ */
+@ReactModule(name = WoosmapGeofencingTurboModule.NAME)
+public class WoosmapGeofencingTurboModule extends NativeWoosmapGeofencingTurboSpec {
+  public static final String NAME = "WoosmapGeofencingTurbo";
+
+  private final ReactApplicationContext reactContext;
+
+  public WoosmapGeofencingTurboModule(ReactApplicationContext reactContext) {
+    super(reactContext);
+    this.reactContext = reactContext;
+  }
+
+  @Override
+  @NonNull
+  public String getName() {
+    return NAME;
+  }
+
+  /**
+   * The Woosmap SDK is a process singleton initialised by the legacy module's
+   * {@code initialize()}. We can't see that module's private field, so we use
+   * the singleton's presence as the readiness proxy for this sprint.
+   */
+  private boolean isWoosmapInitialized() {
+    return Woosmap.getInstance() != null;
+  }
+
+  private boolean onlyContainsNumbers(String text) {
+    try {
+      Long.parseLong(text);
+      return true;
+    } catch (NumberFormatException ex) {
+      return false;
+    }
+  }
+
+  private boolean onlyContainsDouble(String text) {
+    try {
+      Double.parseDouble(text);
+      return true;
+    } catch (NumberFormatException ex) {
+      return false;
+    }
+  }
+
+  @Override
+  public void setWoosmapApiKey(String apiKey, Promise promise) {
+    try {
+      if (!isWoosmapInitialized()) {
+        promise.reject(WoosmapMessageAndKey.errorCode, WoosmapMessageAndKey.woosmapNotInitialized);
+        return;
+      }
+      if (apiKey == null || apiKey.isEmpty()) {
+        promise.reject(WoosmapMessageAndKey.errorCode, WoosmapMessageAndKey.woosmapKeyNotProvide);
+        return;
+      }
+      WoosmapSettings.privateKeyWoosmapAPI = apiKey;
+      promise.resolve(WoosmapMessageAndKey.successMessage);
+    } catch (Exception ex) {
+      promise.reject(WoosmapMessageAndKey.errorCode, ex.getMessage());
+    }
+  }
+
+  @Override
+  public void setPoiRadius(String radius, Promise promise) {
+    try {
+      if (!isWoosmapInitialized()) {
+        promise.reject(WoosmapMessageAndKey.errorCode, WoosmapMessageAndKey.woosmapNotInitialized);
+        return;
+      }
+      if (radius == null || radius.isEmpty()) {
+        throw new Exception(WoosmapMessageAndKey.radiusEmptyMessage);
+      }
+      if (onlyContainsNumbers(radius)) {
+        WoosmapSettings.poiRadius = Integer.parseInt(radius);
+      } else if (onlyContainsDouble(radius)) {
+        WoosmapSettings.poiRadius = (int) Math.round(Double.parseDouble(radius));
+      } else {
+        WoosmapSettings.poiRadiusNameFromResponse = radius;
+      }
+      promise.resolve(WoosmapMessageAndKey.successMessage);
+    } catch (Exception ex) {
+      promise.reject(WoosmapMessageAndKey.errorCode, ex.getMessage());
+    }
+  }
+
+  @RequiresApi(api = Build.VERSION_CODES.N)
+  @Override
+  public void addRegion(ReadableMap region, Promise promise) {
+    try {
+      if (!isWoosmapInitialized()) {
+        promise.reject(WoosmapMessageAndKey.errorCode, WoosmapMessageAndKey.woosmapNotInitialized);
+        return;
+      }
+      if (region == null || region.toHashMap().isEmpty()) {
+        throw new Exception(WoosmapMessageAndKey.regionInfoEmptyMessage);
+      }
+      Region woosRegion = new Region();
+      woosRegion.identifier = region.getString("regionId");
+      woosRegion.idStore = region.hasKey("idStore") ? region.getString("idStore") : "";
+      woosRegion.lat = region.getDouble("lat");
+      woosRegion.lng = region.getDouble("lng");
+      woosRegion.type = region.hasKey("type") ? region.getString("type") : "";
+      woosRegion.radius = region.getDouble("radius");
+
+      WoosmapTask.getInstance(reactContext).addRegion(woosRegion, promise);
+    } catch (Exception ex) {
+      promise.reject(WoosmapMessageAndKey.errorCode, ex.getMessage());
+    }
+  }
+
+  @RequiresApi(api = Build.VERSION_CODES.N)
+  @Override
+  public void getRegions(@Nullable String regionId, Promise promise) {
+    try {
+      if (!isWoosmapInitialized()) {
+        promise.reject(WoosmapMessageAndKey.errorCode, WoosmapMessageAndKey.woosmapNotInitialized);
+        return;
+      }
+      WoosmapTask.getInstance(reactContext).enqueGetRegionsAsArrayRequest(regionId, promise);
+    } catch (Exception ex) {
+      promise.reject(WoosmapMessageAndKey.errorCode, ex.getMessage());
+    }
+  }
+
+  @RequiresApi(api = Build.VERSION_CODES.N)
+  @Override
+  public void removeRegion(String regionId, Promise promise) {
+    try {
+      if (!isWoosmapInitialized()) {
+        promise.reject(WoosmapMessageAndKey.errorCode, WoosmapMessageAndKey.woosmapNotInitialized);
+        return;
+      }
+      if (regionId == null || regionId.isEmpty()) {
+        promise.reject(WoosmapMessageAndKey.errorCode, WoosmapMessageAndKey.requiredRegionid);
+        return;
+      }
+      WoosmapTask.getInstance(reactContext).removeRegion(regionId, promise);
+    } catch (Exception ex) {
+      promise.reject(WoosmapMessageAndKey.errorCode, ex.getMessage());
+    }
+  }
+
+  @RequiresApi(api = Build.VERSION_CODES.N)
+  @Override
+  public void removeAllRegions(Promise promise) {
+    try {
+      if (!isWoosmapInitialized()) {
+        promise.reject(WoosmapMessageAndKey.errorCode, WoosmapMessageAndKey.woosmapNotInitialized);
+        return;
+      }
+      WoosmapTask.getInstance(reactContext).removeRegion("", promise);
+    } catch (Exception ex) {
+      promise.reject(WoosmapMessageAndKey.errorCode, ex.getMessage());
+    }
+  }
+}

package/android/src/main/java/com/reactnativeplugingeofencing/WoosmapGeofencingTurboPackage.java

@@ -0,0 +1,51 @@
+package com.reactnativeplugingeofencing;
+
+import androidx.annotation.Nullable;
+
+import com.facebook.react.TurboReactPackage;
+import com.facebook.react.bridge.NativeModule;
+import com.facebook.react.bridge.ReactApplicationContext;
+import com.facebook.react.module.model.ReactModuleInfo;
+import com.facebook.react.module.model.ReactModuleInfoProvider;
+
+import java.util.HashMap;
+import java.util.Map;
+
+/**
+ * TurboReactPackage that registers {@link WoosmapGeofencingTurboModule}.
+ *
+ * <p>Kept separate from {@code PluginGeofencingPackage} so the New-Architecture
+ * module and the legacy module load independently. To avoid the startup-race
+ * register this package <em>before</em> the legacy one
+ * in the host app's {@code MainApplication} package list.
+ */
+public class WoosmapGeofencingTurboPackage extends TurboReactPackage {
+
+  @Nullable
+  @Override
+  public NativeModule getModule(String name, ReactApplicationContext reactContext) {
+    if (WoosmapGeofencingTurboModule.NAME.equals(name)) {
+      return new WoosmapGeofencingTurboModule(reactContext);
+    }
+    return null;
+  }
+
+  @Override
+  public ReactModuleInfoProvider getReactModuleInfoProvider() {
+    return () -> {
+      Map<String, ReactModuleInfo> moduleInfos = new HashMap<>();
+      moduleInfos.put(
+        WoosmapGeofencingTurboModule.NAME,
+        new ReactModuleInfo(
+          WoosmapGeofencingTurboModule.NAME,
+          WoosmapGeofencingTurboModule.NAME,
+          false, // canOverrideExistingModule
+          false, // needsEagerInit
+          false, // isCxxModule
+          true   // isTurboModule
+        )
+      );
+      return moduleInfos;
+    };
+  }
+}

package/android/src/main/java/com/reactnativeplugingeofencing/WoosmapTask.java

@@ -117,6 +117,45 @@ public class WoosmapTask {
       }
     });
   }
+
+  /**
+   * Resolves regions as a {@link WritableArray} in all cases. Used by the
+   * WoosmapGeofencingTurbo module, whose getRegions spec always returns a
+   * collection (the legacy getRegions(id) resolved a single object instead).
+   * A null/empty regionID returns every saved region.
+   * @param regionID region id to fetch, or null/empty for all regions.
+   * @param promise React native callback context.
+   */
+  @RequiresApi(api = Build.VERSION_CODES.N)
+  public void enqueGetRegionsAsArrayRequest(String regionID, Promise promise) {
+    CompletableFuture.supplyAsync(() -> {
+      try {
+        WritableArray array = Arguments.createArray();
+        if (regionID == null || regionID.isEmpty()) {
+          Region[] regions = WoosmapDb.getInstance(context).getRegionsDAO().getAllRegions();
+          for (Region region : regions) {
+            array.pushMap(WoosmapUtil.getRegionWritableMap(region));
+          }
+        } else {
+          Region region = WoosmapDb.getInstance(context).getRegionsDAO().getRegionFromId(regionID);
+          if (region == null) {
+            throw new Exception(WoosmapMessageAndKey.invalidRegionid);
+          }
+          array.pushMap(WoosmapUtil.getRegionWritableMap(region));
+        }
+        return array;
+      } catch (Exception ex) {
+        throw new CompletionException(ex);
+      }
+    }).whenComplete((data, throwable) -> {
+      if (throwable == null) {
+        promise.resolve(data);
+      } else {
+        promise.reject(WoosmapMessageAndKey.errorCode, throwable.getMessage());
+      }
+    });
+  }
+
   @RequiresApi(api = Build.VERSION_CODES.N)
   public void removeRegion(String regionId, final Promise promise){
     CompletableFuture.supplyAsync((Supplier<Void>) () -> {

package/ios/PluginGeofencing.mm

@@ -2,10 +2,6 @@
 
 @interface RCT_EXTERN_MODULE(PluginGeofencing, NSObject)
 
-RCT_EXTERN_METHOD(multiply:(float)a withB:(float)b
-                 withResolver:(RCTPromiseResolveBlock)resolve
-                 withRejecter:(RCTPromiseRejectBlock)reject)
-
 RCT_EXTERN_METHOD(initialize:(NSDictionary *)options
                  withResolver:(RCTPromiseResolveBlock)resolve
                  withRejecter:(RCTPromiseRejectBlock)reject)

package/ios/PluginGeofencing.swift

@@ -69,12 +69,6 @@ class PluginGeofencing: RCTEventEmitter {
         return resultError
     }
     
-    @objc(multiply:withB:withResolver:withRejecter:)
-    func multiply(a: Float, b: Float, resolve:RCTPromiseResolveBlock,reject:RCTPromiseRejectBlock) -> Void {
-        resolve(a*b)
-    }
-    
-    
     @objc(initialize:withResolver:withRejecter:)
     func initialize(command: NSDictionary, resolve:RCTPromiseResolveBlock,reject:RCTPromiseRejectBlock) -> Void{
         
@@ -165,6 +159,8 @@ class PluginGeofencing: RCTEventEmitter {
     
     /// Updating new woosmap key
     /// - Parameter command: -
+    // implemented in turbo (WoosmapGeofencingTurbo)
+    @available(*, deprecated, message: "Implemented in the WoosmapGeofencingTurbo TurboModule")
     @objc(setWoosmapApiKey:withResolver:withRejecter:)
     func setWoosmapApiKey(command: NSArray, resolve:RCTPromiseResolveBlock,reject:RCTPromiseRejectBlock) -> Void{
         
@@ -457,6 +453,8 @@ class PluginGeofencing: RCTEventEmitter {
     ///   - regioninfo: regioninfo description
     ///   - resolve: return Reference watchid  on successfully call
     ///   - reject: return error info
+    // implemented in turbo (WoosmapGeofencingTurbo)
+    @available(*, deprecated, message: "Implemented in the WoosmapGeofencingTurbo TurboModule")
     @objc(addRegion:withResolver:withRejecter:)
     func addRegion(regioninfo:NSDictionary, resolve:RCTPromiseResolveBlock,reject:RCTPromiseRejectBlock) {
         if let woosService = WoosmapGeofenceService.shared {
@@ -570,6 +568,8 @@ class PluginGeofencing: RCTEventEmitter {
     ///   - radius: radius enum or number in meters
     ///   - resolve:  return Ok  on successfully call
     ///   - reject: return error info
+    // implemented in turbo (WoosmapGeofencingTurbo)
+    @available(*, deprecated, message: "Implemented in the WoosmapGeofencingTurbo TurboModule")
     @objc(setPoiRadius:withResolver:withRejecter:)
     func setPoiRadius (radius: String, resolve:RCTPromiseResolveBlock,reject:RCTPromiseRejectBlock) {
         if WoosmapGeofenceService.shared != nil {
@@ -604,6 +604,8 @@ class PluginGeofencing: RCTEventEmitter {
     /// - Parameters:
     ///   - resolve: return list of Array with region info
     ///   - reject: return error info
+    // implemented in turbo (WoosmapGeofencingTurbo — getRegions handles all + single)
+    @available(*, deprecated, message: "Implemented in the WoosmapGeofencingTurbo TurboModule")
     @objc(getAllRegions:withRejecter:)
     func getAllRegions(resolve:RCTPromiseResolveBlock,reject:RCTPromiseRejectBlock) {
         if let objWoos = WoosmapGeofenceService.shared  {
@@ -626,6 +628,8 @@ class PluginGeofencing: RCTEventEmitter {
     ///   - regionid: regionid to fetch
     ///   - resolve: return  region info
     ///   - reject: error info
+    // implemented in turbo (WoosmapGeofencingTurbo)
+    @available(*, deprecated, message: "Implemented in the WoosmapGeofencingTurbo TurboModule")
     @objc(getRegions:withResolver:withRejecter:)
     func getRegions(regionid:String, resolve:RCTPromiseResolveBlock,reject:RCTPromiseRejectBlock) {
         if let objWoos = WoosmapGeofenceService.shared  {
@@ -656,6 +660,8 @@ class PluginGeofencing: RCTEventEmitter {
     /// - Parameters:
     ///   - resolve: return regionDeleted
     ///   - reject: error info
+    // implemented in turbo (WoosmapGeofencingTurbo)
+    @available(*, deprecated, message: "Implemented in the WoosmapGeofencingTurbo TurboModule")
     @objc(removeAllRegions:withRejecter:)
     func removeAllRegions(resolve:RCTPromiseResolveBlock,reject:RCTPromiseRejectBlock) {
         if let objWoos = WoosmapGeofenceService.shared  {
@@ -673,6 +679,8 @@ class PluginGeofencing: RCTEventEmitter {
     ///   - regionid: region id
     ///   - resolve:  return regionDeleted
     ///   - reject: error info
+    // implemented in turbo (WoosmapGeofencingTurbo)
+    @available(*, deprecated, message: "Implemented in the WoosmapGeofencingTurbo TurboModule")
     @objc(removeRegion:withResolver:withRejecter:)
     func removeRegion(regionid:String, resolve:RCTPromiseResolveBlock,reject:RCTPromiseRejectBlock) {
         if let objWoos = WoosmapGeofenceService.shared  {

package/ios/WoosmapGeofenceService.swift

@@ -247,8 +247,12 @@ extension CLRegion {
     airshipTrackingEnable: Bool = false,
     protectedRegionSlot: Int = -1
   ) {
-    //TODO: Check This
-    Task { @MainActor in
+    // Initialize synchronously so the native module's `initialize` promise
+    // does not resolve before `_shared` has actually been assigned.
+    // Native module methods run on a background dispatch queue, so we hop to
+    // the main thread (where `WoosmapGeofenceService.init` is MainActor-isolated)
+    // and block until the assignment completes.
+    runOnMainSync {
       _shared = WoosmapGeofenceService.init(
         woosmapKey,
         configurationProfile,
@@ -260,12 +264,25 @@ extension CLRegion {
 
   /// Creating instance for woosGeofencing service
   @objc public static func setup() {
-    //TODO: Check This
-    Task { @MainActor in
+    runOnMainSync {
       _shared = WoosmapGeofenceService.init("", "")
     }
   }
 
+  /// Runs the given MainActor-isolated work synchronously, dispatching to the
+  /// main thread when called from a background queue. Safe to call from either
+  /// the main thread or any other thread — avoids the `DispatchQueue.main.sync`
+  /// deadlock when already on main.
+  private static func runOnMainSync(_ work: @MainActor () -> Void) {
+    if Thread.isMainThread {
+      MainActor.assumeIsolated { work() }
+    } else {
+      DispatchQueue.main.sync {
+        MainActor.assumeIsolated { work() }
+      }
+    }
+  }
+
   /// Setting up woosmap key
   /// - Parameter key: woosmap key
   /// - Throws: WoosGeofenceError incase of no key pass or empty

package/ios/WoosmapGeofencingTurbo.mm

@@ -0,0 +1,66 @@
+#import <React/RCTBridgeModule.h>
+
+#ifdef RCT_NEW_ARCH_ENABLED
+// Generated by codegen from src/NativeWoosmapGeofencingTurbo.ts via the
+// `WoosmapGeofencingTurboSpec` codegenConfig entry in package.json. Provides
+// the RCTNativeWoosmapGeofencingTurboSpec protocol and the
+// NativeWoosmapGeofencingTurboSpecJSI C++ TurboModule.
+#import <WoosmapGeofencingTurboSpec/WoosmapGeofencingTurboSpec.h>
+#endif
+
+// Bridges the Swift `WoosmapGeofencingTurbo` implementation to React Native.
+// The selectors below must match the @objc(...) selectors declared in
+// WoosmapGeofencingTurbo.swift.
+@interface RCT_EXTERN_MODULE(WoosmapGeofencingTurbo, NSObject)
+
+// Selectors follow the React Native codegen Promise convention
+// (`<method>:resolve:reject:`, or `<method>:reject:` for no-arg methods) so the
+// generated NativeWoosmapGeofencingTurboSpecJSI bindings dispatch correctly.
+RCT_EXTERN_METHOD(setWoosmapApiKey:(NSString *)apiKey
+                  resolve:(RCTPromiseResolveBlock)resolve
+                  reject:(RCTPromiseRejectBlock)reject)
+
+RCT_EXTERN_METHOD(setPoiRadius:(NSString *)radius
+                  resolve:(RCTPromiseResolveBlock)resolve
+                  reject:(RCTPromiseRejectBlock)reject)
+
+RCT_EXTERN_METHOD(addRegion:(NSDictionary *)region
+                  resolve:(RCTPromiseResolveBlock)resolve
+                  reject:(RCTPromiseRejectBlock)reject)
+
+RCT_EXTERN_METHOD(getRegions:(NSString *)regionId
+                  resolve:(RCTPromiseResolveBlock)resolve
+                  reject:(RCTPromiseRejectBlock)reject)
+
+RCT_EXTERN_METHOD(removeAllRegions:(RCTPromiseResolveBlock)resolve
+                  reject:(RCTPromiseRejectBlock)reject)
+
+RCT_EXTERN_METHOD(removeRegion:(NSString *)regionId
+                  resolve:(RCTPromiseResolveBlock)resolve
+                  reject:(RCTPromiseRejectBlock)reject)
+
++ (BOOL)requiresMainQueueSetup
+{
+  return YES;
+}
+
+@end
+
+#ifdef RCT_NEW_ARCH_ENABLED
+// Vends the JSI TurboModule so the 6 methods dispatch through the generated
+// codegen path (no ObjCTurboModule reflection fallback). Implemented as a
+// category on the Swift class because getTurboModule: returns a C++ type that
+// cannot be expressed in Swift.
+@interface WoosmapGeofencingTurbo (TurboModule) <RCTTurboModule>
+@end
+
+@implementation WoosmapGeofencingTurbo (TurboModule)
+
+- (std::shared_ptr<facebook::react::TurboModule>)getTurboModule:
+    (const facebook::react::ObjCTurboModule::InitParams &)params
+{
+  return std::make_shared<facebook::react::NativeWoosmapGeofencingTurboSpecJSI>(params);
+}
+
+@end
+#endif