react-native-pointr 9.8.0 → 10.0.0

package/CHANGELOG.md

@@ -4,6 +4,48 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [10.0.0] - 2026-05-22
+
+### Added
+- **New actions**: `PTRFocusCoordinateAction` (focus map to a geographic coordinate), `PTRCategoryFilterAction` / `PTRHighlightCategoryAction` (filter visible POIs by category IDs).
+- **New hook**: `usePointrGeofences(siteId)` — fetches geofences for a site with loading/error/refresh state.
+- **New types**: `PTRSite`, `PTRBuilding`, `PTRLevel`.
+- **New enums**: `PTRWayfindingMode`, `PTRMapTrackingMode`, `PTRMapWidgetLayoutState`.
+- **New Architecture support**: TurboModule interop spec (`NativePointrModule`) added for React Native New Architecture compatibility.
+- **`PTRPosition` readable aliases**: `latitude`, `longitude`, `siteId`, `buildingId`, `levelIndex` added alongside the existing short names (`lat`, `lon`, `sid`, `bid`, `lvl`).
+- **`PTRMapWidgetConfiguration` new fields**: `exitButtonPosition`, `wayfindingMode`, `initialMapTrackingMode`, `searchLayout`.
+- **`MIGRATION.md`**: step-by-step migration guide from v9.x.
+- **Example app**: reworked with dedicated SDK and Events screens.
+- **Maestro UI tests**: 6 flows covering home screen, SDK initialization, map widget open/close, listen toggle, position, and map events.
+
+### Changed
+- **BREAKING**: Entire command API renamed to action API — `PTRCommand` → `PTRAction`, `PTRCommandType` → `PTRActionType`, `executeMapCommand` → `executeMapAction`, `command` prop → `action` prop on `PTRMapWidget`. All command classes renamed to action classes (see table below and [MIGRATION.md](./MIGRATION.md#1-command-api-renamed-to-action-api)).
+- **BREAKING**: `pointrSdk.start()` now returns `Promise<void>` instead of accepting a callback. See [MIGRATION.md](./MIGRATION.md#2-start-is-now-promisevoid).
+- **BREAKING**: `PTRWayfindingEvent.type` is now the typed enum `PTRWayfindingEventType` instead of `number`. See [MIGRATION.md](./MIGRATION.md#3-ptrwayfindingeventtype-is-now-ptrwayfindingeventtype).
+- Minimum React Native peer dependency bumped to `>=0.73`.
+- Mobile SDK (iOS PointrKit, Android Pointr SDK) updated to **10.0.0**.
+- `PTRWayfindingEventType` enum moved to `src/constants/index.ts` and re-exported from types.
+
+### Removed
+- `PTRStartAndFocusCommand` — use `sdkConfig` + `action` props on `PTRMapWidget` instead. See [MIGRATION.md](./MIGRATION.md#4-ptrstartandfocuscommand-removed).
+- `PTRSiteCommand`, `PTRBuildingCommand`, `PTRLevelCommand` — replaced by `PTRFocusMapAction`.
+- `PTRPoiCommand` — replaced by `PTRHighlightPoiAction`.
+- `PTRPathCommand` — replaced by `PTRStartWayfindingAction`.
+- `PTRStaticPathCommand`, `PTRStaticWayfindingCommand` — replaced by `PTRDisplayRouteAction`.
+- `PTRMarkMyCarLevelCommand`, `PTRMarkMyCarSiteCommand` — replaced by `PTRMarkMyCarAction`.
+- `PTRShowMyCarSiteCommand` — replaced by `PTRShowMyCarAction`.
+- `executeMapCommand` function — replaced by `executeMapAction`.
+- Type guard functions: `isPTRSiteCommand`, `isPTRBuildingCommand`, `isPTRLevelCommand`, `isPTRPoiCommand`, `isPTRPathCommand`, `isPTRStaticPathCommand`.
+
+### Deprecated
+- `PTRStateCallback` type — no longer needed with the Promise-based `start()`.
+
+## [9.9.0] - 2026-04-22
+
+### Changed
+- Mobile SDK 9.9.0 integration.
+
+
 ## [9.8.0] - 2026-04-16
 
 ### Changed

package/EXTENDING.md

@@ -18,7 +18,7 @@ This example shows how to add a function that retrieves all Points of Interest (
 
 #### iOS Implementation
 
-**File: `ios/PTRNativePointrLibrary.swift`**
+**File: `ios/PTRNativeLibrary.swift`**
 
 Add the following method to your native iOS module:
 
@@ -54,7 +54,7 @@ func getPois(_ siteId: String,
 }
 ```
 
-**File: `ios/PTRNativePointrLibrary.m`**
+**File: `ios/PTRNativeLibrary-Bridging.m`**
 
 Add the method declaration to the bridge:
 
@@ -66,7 +66,7 @@ RCT_EXTERN_METHOD(getPois:(NSString *)siteId
 
 #### Android Implementation
 
-**File: `android/src/main/java/com/reactnativepointr/PTRNativePointrLibraryModule.kt`**
+**File: `android/src/main/java/com/pointr/PTRNativeLibrary.kt`**
 
 Add the following method to your native Android module:
 
@@ -145,15 +145,15 @@ export interface PTRPoi {
 
 ### Step 3: Create JavaScript Wrapper
 
-**File: `src/PTRNativePointrLibrary.ts`**
+**File: `src/managers/PTRPoiManager.ts`**
 
 Create a wrapper function that provides a clean API:
 
 ```typescript
 import { NativeModules } from 'react-native';
-import { PTRPoi } from './types/PTRPoi';
+import { PTRPoi } from '../types/PTRPoi';
 
-const { PTRNativePointrLibrary } = NativeModules;
+const PTRNativeLibrary = NativeModules.PTRNativeLibrary;
 
 /**
  * Get all Points of Interest (POIs) for a specific site
@@ -163,10 +163,9 @@ const { PTRNativePointrLibrary } = NativeModules;
  */
 export async function getPois(siteId: string): Promise<PTRPoi[]> {
   try {
-    const pois = await PTRNativePointrLibrary.getPois(siteId);
+    const pois = await PTRNativeLibrary.getPois(siteId);
     return pois as PTRPoi[];
   } catch (error) {
-    console.error('Failed to get POIs:', error);
     throw error;
   }
 }
@@ -174,17 +173,13 @@ export async function getPois(siteId: string): Promise<PTRPoi[]> {
 
 ### Step 4: Export the New Functionality
 
-**File: `src/index.ts`**
+**File: `src/index.tsx`**
 
 Export the new functions and types from the main entry point:
 
 ```typescript
-// Existing exports
-export * from './PTRCommand';
-export * from './PTRMapWidgetUtils';
-
 // New exports
-export { getPois } from './PTRNativePointrLibrary';
+export { getPois } from './managers/PTRPoiManager';
 export type { PTRPoi } from './types/PTRPoi';
 ```
 
@@ -395,8 +390,8 @@ private fun sendEvent(eventName: String, params: WritableMap?) {
 ```typescript
 import { NativeEventEmitter, NativeModules } from 'react-native';
 
-const { PTRNativePointrLibrary } = NativeModules;
-const eventEmitter = new NativeEventEmitter(PTRNativePointrLibrary);
+const PTRNativeLibrary = NativeModules.PTRNativeLibrary;
+const eventEmitter = new NativeEventEmitter(PTRNativeLibrary);
 
 export function subscribeToLocationUpdates(
   callback: (location: PTRLocation) => void

package/README.md

@@ -156,11 +156,11 @@ Then run `npm install` or `yarn install` to install the dependencies.
 Import the package exports and render the map widget:
 
 ```typescript
-import { PTRMapWidget, PTRSiteCommand } from 'react-native-pointr';
+import { PTRMapWidget, PTRFocusMapAction } from 'react-native-pointr';
 import type { PTRConfiguration, PTRMapWidgetConfiguration } from 'react-native-pointr';
 ```
 
-The simplest integration passes `sdkConfig`, `mapWidgetConfig`, and `command` as props directly — the widget handles initialization automatically:
+The simplest integration passes `sdkConfig`, `mapWidgetConfig`, and `action` as props directly — the widget handles initialization automatically:
 
 ```tsx
 const SDK_CONFIG: PTRConfiguration = {
@@ -180,7 +180,7 @@ function MapScreen() {
       style={{ flex: 1 }}
       sdkConfig={SDK_CONFIG}
       mapWidgetConfig={MAP_CONFIG}
-      command={new PTRSiteCommand('<SITE_EXTERNAL_ID>')}
+      action={new PTRFocusMapAction('<SITE_EXTERNAL_ID>')}
       onMapWidgetDidEndLoading={(e) => console.log('Map loaded', e.nativeEvent)}
       onWayfindingEvent={(e) => console.log('Navigation event', e.nativeEvent)}
     />
@@ -205,18 +205,18 @@ function App() {
 }
 ```
 
-### Available Commands
+### Available Actions
 
 ```typescript
-import { PTRSiteCommand, PTRBuildingCommand, PTRLevelCommand, PTRPoiCommand,
-         PTRPathCommand, PTRStaticPathCommand, executeMapCommand } from 'react-native-pointr';
-
-executeMapCommand(mapRef, new PTRSiteCommand('site-id'));
-executeMapCommand(mapRef, new PTRBuildingCommand('site-id', 'building-id'));
-executeMapCommand(mapRef, new PTRLevelCommand('site-id', 'building-id', 2));
-executeMapCommand(mapRef, new PTRPoiCommand('site-id', 'poi-id'));
-executeMapCommand(mapRef, new PTRPathCommand('site-id', 'poi-id'));
-executeMapCommand(mapRef, new PTRStaticPathCommand('site-id', 'from-poi', 'to-poi'));
+import { PTRFocusMapAction, PTRHighlightPoiAction,
+         PTRPathCommand, PTRStaticPathCommand, executeMapAction } from 'react-native-pointr';
+
+executeMapAction(mapRef, new PTRFocusMapAction('site-id'));
+executeMapAction(mapRef, new PTRFocusMapAction('site-id', 'building-id'));
+executeMapAction(mapRef, new PTRFocusMapAction('site-id', 'building-id', 2));
+executeMapAction(mapRef, new PTRHighlightPoiAction('site-id', 'poi-id'));
+executeMapAction(mapRef, new PTRPathCommand('site-id', 'poi-id'));
+executeMapAction(mapRef, new PTRStaticPathCommand('site-id', 'from-poi', 'to-poi'));
 ```
 
 ### Available Hooks
@@ -251,7 +251,7 @@ After completing the setup, start your app by running:
     npx react-native run-android
     ```
 
-That’s it! Your package should now be installed and ready to use in your React Native project. For more details on usage and advanced configuration, refer to the [API documentation](https://docs.pointr.tech/docs/8.x/Developer%20Portal/API%20Reference/api%20ref-mobile/).
+That’s it! Your package should now be installed and ready to use in your React Native project. For more details on usage and advanced configuration, refer to the [API documentation](https://dev.pointr.tech/sdk-and-api-references/mobile-sdk-references/).
 ## 6. Run the Example App
 
 To explore the included demo app:

package/WAYFINDING_EVENTS.md

@@ -42,7 +42,8 @@ import { type PTRPoi } from 'react-native-pointr';
   identifier: string;           // Internal unique identifier
   externalIdentifier: string;   // External API reference ID
   name: string;                 // Display name
-  typeCode: string;            // POI type (e.g., "lobby", "room")
+  mainType: string;            // Main POI type (e.g., "lobby", "room")
+  subType?: string;           // Optional sub-type
   position: PTRPosition;       // Geographic position
   geometry: PTRGeometry;       // Shape data
   attributes: PTRPoiAttributes; // Additional metadata
@@ -90,7 +91,7 @@ const handleWayfindingEvent = (event: NativeSyntheticEvent<PTRWayfindingEvent>)
   
   // Access destination POI information
   console.log(`Navigation ${eventTypeName} to: ${wayfindingEvent.poi.name}`);
-  console.log(`POI Type: ${wayfindingEvent.poi.typeCode}`);
+  console.log(`POI Type: ${wayfindingEvent.poi.mainType}${wayfindingEvent.poi.subType ? '/' + wayfindingEvent.poi.subType : ''}`);
   console.log(`Location: Level ${wayfindingEvent.poi.position.lvl}`);
 };
 ```
@@ -175,7 +176,8 @@ const handleWayfindingEvent = (event: NativeSyntheticEvent<PTRWayfindingEvent>)
   analytics.track('Wayfinding Event', {
     eventType: type === -1 ? 'cancelled' : type === 0 ? 'started' : 'ended',
     destinationName: poi.name,
-    destinationType: poi.typeCode,
+    destinationType: poi.mainType,
+    destinationSubType: poi.subType,
     destinationId: poi.externalIdentifier,
   });
 };

package/android/build.gradle

@@ -93,7 +93,7 @@ dependencies {
   //noinspection GradleDynamicVersion
   implementation "com.facebook.react:react-android:0.82.1"
   implementation "org.jetbrains.kotlin:kotlin-stdlib:$kotlin_version"
-  implementation("com.pointrlabs:pointr:9.8.0")
+  implementation("com.pointrlabs:pointr:10.0.0")
   implementation ("org.jetbrains.kotlin:kotlin-reflect:$kotlin_version")
   implementation 'com.google.android.material:material:1.12.0'
   implementation 'androidx.constraintlayout:constraintlayout:2.2.1'

package/android/src/main/java/com/pointr/PTRCoreExtensions.kt

@@ -2,12 +2,15 @@ package com.pointr
 
 import com.facebook.react.bridge.Arguments
 import com.facebook.react.bridge.ReadableMap
+import com.facebook.react.bridge.WritableMap
 import com.pointrlabs.core.geojson.PTRFeature
 import com.pointrlabs.core.geometry.GeoMultiPoint
 import com.pointrlabs.core.geometry.GeoMultiPolygon
 import com.pointrlabs.core.geometry.GeoPoint
 import com.pointrlabs.core.geometry.GeoPolygon
 import com.pointrlabs.core.geometry.Geometry
+import com.pointrlabs.core.management.models.Building
+import com.pointrlabs.core.management.models.Site
 import com.pointrlabs.core.positioning.model.Position
 
 val Position.map
@@ -59,7 +62,8 @@ val PTRFeature.map
     get() = Arguments.createMap().apply {
         putString("identifier", identifier)
         putString("externalIdentifier", externalIdentifier)
-        putString("typeCode", typeCode)
+        putString("mainType", mainType)
+        subType?.let { putString("subType", it) }
         putMap("geometry", geometry.map)
         putMap("attributes", getAttributes(attributes))
         putString("name", name)
@@ -123,4 +127,31 @@ val Geometry.map
         else -> Arguments.createMap().apply {
             putString("type", type.name)
         }
-    }
+    }
+
+// ─── Site / Building / Level → WritableMap ────────────────────────────────────
+
+fun Site.toWritableMap(): WritableMap = Arguments.createMap().apply {
+    putString("identifier", identifier)
+    putString("externalIdentifier", externalIdentifier)
+    putString("name", name ?: "")
+    val buildingsArr = Arguments.createArray()
+    buildings.forEach { b -> buildingsArr.pushMap(b.toWritableMap()) }
+    putArray("buildings", buildingsArr)
+}
+
+fun Building.toWritableMap(): WritableMap = Arguments.createMap().apply {
+    putString("identifier", identifier)
+    putString("externalIdentifier", externalIdentifier)
+    putString("name", name ?: "")
+    val levelsArr = Arguments.createArray()
+    levels.forEach { lvl ->
+        levelsArr.pushMap(Arguments.createMap().apply {
+            putString("identifier", lvl.identifier)
+            putString("externalIdentifier", lvl.externalIdentifier)
+            putString("name", lvl.name ?: "")
+            putInt("index", lvl.index)
+        })
+    }
+    putArray("levels", levelsArr)
+}

package/android/src/main/java/com/pointr/PTRMapWidgetActionType.kt

@@ -0,0 +1,17 @@
+package com.pointr
+
+import androidx.annotation.StringDef
+
+@StringDef(value = [PTRMapWidgetActionType.FOCUS_MAP, PTRMapWidgetActionType.HIGHLIGHT_POI, PTRMapWidgetActionType.DISPLAY_ROUTE, PTRMapWidgetActionType.START_WAYFINDING, PTRMapWidgetActionType.MARK_MY_CAR, PTRMapWidgetActionType.SHOW_MY_CAR, PTRMapWidgetActionType.FOCUS_COORDINATE, PTRMapWidgetActionType.HIGHLIGHT_CATEGORY])
+annotation class PTRMapWidgetActionType {
+    companion object {
+        const val FOCUS_MAP = "focusMap"
+        const val HIGHLIGHT_POI = "highlightPoi"
+        const val DISPLAY_ROUTE = "displayRoute"
+        const val START_WAYFINDING = "startWayfinding"
+        const val MARK_MY_CAR = "markMyCar"
+        const val SHOW_MY_CAR = "showMyCar"
+        const val FOCUS_COORDINATE = "focusCoordinate"
+        const val HIGHLIGHT_CATEGORY = "highlightCategory"
+    }
+}