react-native-pointr 10.4.0 → 10.5.0

package/API_REFERENCE.md

@@ -79,6 +79,7 @@ pointrSdk.initialize({
   licenseKey: '<LICENSE_KEY>',
   baseUrl: 'https://<your-instance>.pointr.cloud',
   logLevel: PTRLogLevel.WARNING, // optional, defaults to ERROR
+  personaId: '<PERSONA_ID>',     // optional persona selection
 });
 ```
 
@@ -152,7 +153,7 @@ const config = pointrSdk.getConfig();
 
 #### `getCurrentLocation()`
 
-Returns a `Promise<any | null>` with the last known calculated position, or `null` if unavailable.
+Returns a `Promise<PTRPosition | null>` with the last known calculated position, or `null` if unavailable.
 
 The resolved object contains the raw native payload with these fields:
 
@@ -257,6 +258,142 @@ const geofences = await pointrSdk.getGeofences('<SITE_ID>');
 
 ---
 
+#### `shouldRequestPermissionsAtStartup(should)`
+
+Controls whether the SDK automatically requests location (and motion) permissions at startup. Call before `start()` to take effect.
+
+**Parameters:**
+- `should` (`boolean`): `true` to request permissions automatically, `false` to handle them manually.
+
+```typescript
+pointrSdk.shouldRequestPermissionsAtStartup(false);
+```
+
+---
+
+#### `requestPermissions()`
+
+Manually requests the required location (and motion) permissions. Use when `shouldRequestPermissionsAtStartup(false)` was set.
+
+```typescript
+pointrSdk.requestPermissions();
+```
+
+---
+
+#### `getPois(siteId)`
+
+Returns a `Promise<PTRPoi[]>` with all POIs for the given site.
+
+**Parameters:**
+- `siteId` (`string`): External site identifier.
+
+```typescript
+const pois = await pointrSdk.getPois('<SITE_ID>');
+```
+
+---
+
+#### `searchPois(siteId, query)`
+
+Returns a `Promise<PTRPoi[]>` with POIs whose name or external identifier matches the case-insensitive `query`.
+
+**Parameters:**
+- `siteId` (`string`): External site identifier.
+- `query` (`string`): Case-insensitive search term.
+
+```typescript
+const results = await pointrSdk.searchPois('<SITE_ID>', 'cafe');
+```
+
+---
+
+#### `getSites()`
+
+Returns a `Promise<PTRSite[]>` with all sites available to the client.
+
+```typescript
+const sites = await pointrSdk.getSites();
+```
+
+---
+
+#### `getBuildings(siteId)`
+
+Returns a `Promise<PTRBuilding[]>` with all buildings for the given site.
+
+**Parameters:**
+- `siteId` (`string`): External site identifier.
+
+```typescript
+const buildings = await pointrSdk.getBuildings('<SITE_ID>');
+```
+
+---
+
+#### `getSiteByExternalId(externalId)`
+
+Returns a `Promise<PTRSite | null>` with the site matching the given external identifier, or `null` if not found.
+
+**Parameters:**
+- `externalId` (`string`): External site identifier.
+
+```typescript
+const site = await pointrSdk.getSiteByExternalId('<SITE_ID>');
+```
+
+---
+
+#### `getClientName()`
+
+Returns a `Promise<string>` with the configured client identifier.
+
+```typescript
+const clientName = await pointrSdk.getClientName();
+```
+
+---
+
+#### `isWayfindingReady(siteId)`
+
+Returns a `Promise<boolean>` indicating whether wayfinding data is ready for the given site.
+
+**Parameters:**
+- `siteId` (`string`): External site identifier.
+
+```typescript
+const ready = await pointrSdk.isWayfindingReady('<SITE_ID>');
+```
+
+---
+
+#### `calculateDistance(from, to)`
+
+Returns a `Promise<number>` with the straight-line distance in metres between two coordinates.
+
+**Parameters:**
+- `from` (`{ lat: number; lon: number }`): Origin coordinate.
+- `to` (`{ lat: number; lon: number }`): Destination coordinate.
+
+```typescript
+const metres = await pointrSdk.calculateDistance(
+  { lat: 47.4979, lon: 19.0402 },
+  { lat: 47.4985, lon: 19.0410 }
+);
+```
+
+---
+
+#### `isMyCarMarked()`
+
+Returns a `Promise<boolean>` indicating whether the user's car location has been marked/saved.
+
+```typescript
+const marked = await pointrSdk.isMyCarMarked();
+```
+
+---
+
 #### `getEventEmitter()`
 
 Returns the underlying `NativeEventEmitter` for advanced subscription use cases.
@@ -269,11 +406,10 @@ const emitter = pointrSdk.getEventEmitter();
 
 #### `getNativeModule()`
 
-Returns the raw `NativeModules.PTRNativeLibrary` reference for advanced use cases not covered by the `PointrSdk` wrapper (e.g. `getPois`, `searchPois`, `isWayfindingReady`, `calculateDistance`).
+Returns the raw `NativeModules.PTRNativeLibrary` reference for advanced use cases not covered by the `PointrSdk` wrapper.
 
 ```typescript
 const native = pointrSdk.getNativeModule();
-const pois = await native.getPois('<SITE_ID>');
 ```
 
 ---
@@ -654,36 +790,6 @@ enum PTRWayfindingMode {
 
 ---
 
-### `PTRMapTrackingMode`
-
-Controls how the map follows the user's position.
-
-```typescript
-enum PTRMapTrackingMode {
-  NONE                  = 'none',
-  TRACKING              = 'tracking',
-  TRACKING_WITH_HEADING = 'trackingWithHeading',
-}
-```
-
----
-
-### `PTRMapWidgetLayoutState`
-
-Represents the active panel state of the map widget.
-
-```typescript
-enum PTRMapWidgetLayoutState {
-  IDLE             = 'idle',
-  POI_DETAILS      = 'poiDetails',
-  WAYFINDING       = 'wayfinding',
-  STATIC_WAYFINDING= 'staticWayfinding',
-  ROUTE_SUMMARY    = 'routeSummary',
-}
-```
-
----
-
 ### `PTRWayfindingEventType`
 
 Lifecycle states of a navigation session, used as `PTRWayfindingEvent.type`.
@@ -878,6 +984,7 @@ interface PTRConfiguration {
   readonly licenseKey: string;
   readonly baseUrl: string;
   readonly logLevel?: PTRLogLevel; // default: PTRLogLevel.ERROR
+  readonly personaId?: string;     // optional persona id for the selected SDK persona
 }
 ```
 
@@ -900,14 +1007,6 @@ interface PTRMapWidgetConfiguration {
   readonly shouldFocusOnFirstUserPosition?: boolean;
   readonly isQuickAccessEnabled?: boolean;
   readonly isAppBannerEnabled?: boolean;
-  /** Position of the exit button. Accepted values: 'topLeft' | 'topRight' | 'bottomLeft' | 'bottomRight' */
-  readonly exitButtonPosition?: string;
-  /** Routing mode. Defaults to PTRWayfindingMode.NORMAL. */
-  readonly wayfindingMode?: PTRWayfindingMode;
-  /** Initial map tracking mode. Defaults to PTRMapTrackingMode.NONE. */
-  readonly initialMapTrackingMode?: PTRMapTrackingMode;
-  /** Search panel layout. Accepted values: 'default' | 'minimal' */
-  readonly searchLayout?: string;
 }
 ```
 

package/CHANGELOG.md

@@ -4,10 +4,16 @@ 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.4.0] - 2026-07-07
+## [10.5.0] - 2026-07-17
 
 ### Changed
-- Mobile SDK 10.4.0 integration.
+- Mobile SDK 10.5.0 integration.
+
+
+## [Unreleased]
+
+### Added
+- **`PointrSdk` methods** exposing previously native-only capabilities: `shouldRequestPermissionsAtStartup`, `requestPermissions`, `getPois`, `searchPois`, `getSites`, `getBuildings`, `getSiteByExternalId`, `getClientName`, `isWayfindingReady`, `calculateDistance`, `isMyCarMarked`.
 
 
 ## [10.3.0] - 2026-06-30

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:10.4.0")
+  implementation("com.pointrlabs:pointr:10.5.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/PTRMapWidgetManager.kt

@@ -105,8 +105,12 @@ class PTRMapWidgetManager(private val reactContext: ReactApplicationContext) :
             val clientId = obj.optString("clientId")
             val licenseKey = obj.optString("licenseKey")
             val baseUrl = obj.optString("baseUrl")
+            val personaId = obj.optString("personaId", "")
             if (clientId.isNotEmpty() && licenseKey.isNotEmpty() && baseUrl.isNotEmpty()) {
                 val params = PTRParams(clientId, licenseKey, baseUrl)
+                if (personaId.isNotEmpty()) {
+                    params.personaId = personaId
+                }
                 val logLevel = obj.optInt("logLevel", Plog.LogLevel.ERROR.ordinal)
                 params.logLevel = try {
                     Plog.LogLevel.entries[logLevel]

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

@@ -117,14 +117,16 @@ class PTRNativeLibrary(reactContext: ReactApplicationContext) :
         clientId: String,
         licenceKey: String,
         baseUrl: String,
-        logLevel: Int = 0
+        logLevel: Int = 0,
+        personaId: String = ""
     ) {
         initialize(
             reactApplicationContext,
             clientId,
             licenceKey,
             baseUrl,
-            logLevel
+            logLevel,
+            personaId
         )
     }
 
@@ -513,9 +515,11 @@ class PTRNativeLibrary(reactContext: ReactApplicationContext) :
         clientId: String,
         licenceKey: String,
         baseUrl: String,
-        logLevel: Int = 0
+        logLevel: Int = 0,
+        personaId: String
     ) {
         val ptrParams = PTRParams(clientId, licenceKey, baseUrl)
+        ptrParams.personaId = personaId
         try {
             val ptrLogLevel = Plog.LogLevel.entries[logLevel]
             ptrParams.logLevel = ptrLogLevel

package/ios/PTRNativeLibrary-Bridging.m

@@ -17,7 +17,7 @@ RCT_EXTERN_METHOD(stopObserving)
 // Core methods
 RCT_EXTERN_METHOD(shouldRequestPermissionsAtStartup:(BOOL)shouldRequestPermissionsAtStartup)
 
-RCT_EXTERN_METHOD(initialize:(NSString *)clientIdentifier licenseKey:(NSString *)licenseKey baseUrl:(NSString *)baseUrl logLevel:(int)logLevel)
+RCT_EXTERN_METHOD(initialize:(NSString *)clientIdentifier licenseKey:(NSString *)licenseKey baseUrl:(NSString *)baseUrl logLevel:(int)logLevel personaId:(NSString *)personaId)
 
 RCT_EXTERN_METHOD(start:(RCTPromiseResolveBlock)resolve rejecter:(RCTPromiseRejectBlock)reject)
 

package/ios/PTRNativeLibrary.swift

@@ -213,10 +213,12 @@ class PTRNativeLibrary: RCTEventEmitter, PTREventManagerDelegate {
     @objc func initialize(_ clientIdentifier: String,
                           licenseKey: String,
                           baseUrl: String,
-                         logLevel: Int) {
+                         logLevel: Int,
+                         personaId: String) {
         guard let presentedViewController = RCTPresentedViewController() else { return }
         self.rootViewController = presentedViewController
         PTRNativeLibrary.params.mode = PointrDebugMode()
+        PTRNativeLibrary.params.personaIdentifier = personaId
         PTRNativeLibrary.params.loggerLevel = PTRLoggerLevel.init(rawValue: Int32(logLevel)) ?? .error
         PTRNativeLibrary.params.licenseKey = licenseKey
         PTRNativeLibrary.params.baseUrl = baseUrl

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "react-native-pointr",
-  "version": "10.4.0",
+  "version": "10.5.0",
   "description": "Pointr React-Native Module",
   "main": "src/index",
   "files": [
@@ -39,7 +39,7 @@
   "devDependencies": {
     "@types/node": ">=20",
     "@types/react": "^19.2.15",
-    "react": "^19.2.6",
+    "react": "19.2.3",
     "react-native": "0.85.3",
     "typescript": "^5.8.3"
   },

package/react-native-pointr.podspec

@@ -16,7 +16,7 @@ Pod::Spec.new do |s|
 
   s.source_files = "ios/**/*.{h,m,mm,swift}"
 
-  s.dependency 'PointrKit', '10.4.0'
+  s.dependency 'PointrKit', '10.5.0'
 
   # Use install_modules_dependencies helper to install the dependencies if React Native version >=0.71.0.
   # See https://github.com/facebook/react-native/blob/febf6b7f33fdb4904669f99d795eba4c0f95d7bf/scripts/cocoapods/new_architecture.rb#L79.

package/src/NativePointrModule.ts

@@ -20,7 +20,8 @@ export interface Spec extends TurboModule {
     clientId: string,
     licenseKey: string,
     baseUrl: string,
-    logLevel: number
+    logLevel: number,
+    personaId: string
   ): void;
   start(): Promise<void>;
   stop(): void;

package/src/api/PointrSdk.ts

@@ -7,6 +7,8 @@
 import { NativeModules, NativeEventEmitter, Platform } from 'react-native';
 import type { PTRConfiguration, PTRMapWidgetConfiguration } from '../types/config';
 import type { PTRPosition } from '../types/PTRPosition';
+import type { PTRPoi } from '../types/PTRPoi';
+import type { PTRSite, PTRBuilding } from '../types/PTRSite';
 import type { PTRGeofence } from '../types/events';
 import { PTRState, PTRLogLevel, PTRErrorMessages, PTREvents } from '../constants';
 
@@ -70,7 +72,8 @@ export class PointrSdk {
         config.clientId,
         config.licenseKey,
         config.baseUrl,
-        logLevel
+        logLevel,
+        config.personaId ?? ''
       );
       this.state = PTRState.INITIALIZED;
     } catch (error) {
@@ -107,6 +110,21 @@ export class PointrSdk {
     }
   }
 
+  // ─── Permissions ─────────────────────────────────────────────────────────────
+
+  /**
+   * Control whether the SDK requests location (and motion) permissions
+   * automatically at startup. Call before `start()` to take effect.
+   */
+  public shouldRequestPermissionsAtStartup(should: boolean): void {
+    PTRNativeLibrary.shouldRequestPermissionsAtStartup(should);
+  }
+
+  /** Manually request the required location (and motion) permissions. */
+  public requestPermissions(): void {
+    PTRNativeLibrary.requestPermissions();
+  }
+
   /** Get the current SDK state */
   public getState(): PTRState {
     return this.state;
@@ -190,6 +208,90 @@ export class PointrSdk {
     return PTRNativeLibrary.getGeofences(siteId);
   }
 
+  // ─── POIs ──────────────────────────────────────────────────────────────────
+
+  /**
+   * Get all POIs for a site.
+   * @param siteId - External site identifier
+   */
+  public getPois(siteId: string): Promise<PTRPoi[]> {
+    return PTRNativeLibrary.getPois(siteId);
+  }
+
+  /**
+   * Search POIs within a site by name or external identifier.
+   * @param siteId - External site identifier
+   * @param query - Case-insensitive search term
+   */
+  public searchPois(siteId: string, query: string): Promise<PTRPoi[]> {
+    return PTRNativeLibrary.searchPois(siteId, query);
+  }
+
+  // ─── Sites & Buildings ───────────────────────────────────────────────────────
+
+  /** Get all sites available to the client. */
+  public getSites(): Promise<PTRSite[]> {
+    return PTRNativeLibrary.getSites();
+  }
+
+  /**
+   * Get all buildings for a site.
+   * @param siteId - External site identifier
+   */
+  public getBuildings(siteId: string): Promise<PTRBuilding[]> {
+    return PTRNativeLibrary.getBuildings(siteId);
+  }
+
+  /**
+   * Get a single site by its external identifier.
+   * Resolves with the site or null if not found.
+   * @param externalId - External site identifier
+   */
+  public getSiteByExternalId(externalId: string): Promise<PTRSite | null> {
+    return PTRNativeLibrary.getSiteByExternalId(externalId);
+  }
+
+  /** Get the configured client identifier. */
+  public getClientName(): Promise<string> {
+    return PTRNativeLibrary.getClientName();
+  }
+
+  // ─── Wayfinding ──────────────────────────────────────────────────────────────
+
+  /**
+   * Whether wayfinding data is ready for the given site.
+   * @param siteId - External site identifier
+   */
+  public isWayfindingReady(siteId: string): Promise<boolean> {
+    return PTRNativeLibrary.isWayfindingReady(siteId);
+  }
+
+  /**
+   * Calculate the straight-line distance (in metres) between two coordinates.
+   * @param from - Origin coordinate
+   * @param to - Destination coordinate
+   */
+  public calculateDistance(
+    from: { lat: number; lon: number },
+    to: { lat: number; lon: number }
+  ): Promise<number> {
+    return PTRNativeLibrary.calculateDistance(
+      JSON.stringify(from),
+      JSON.stringify(to)
+    );
+  }
+
+  // ─── My Car ──────────────────────────────────────────────────────────────────
+
+  /** Whether the user's car location has been marked/saved. */
+  public isMyCarMarked(): Promise<boolean> {
+    return new Promise((resolve) => {
+      PTRNativeLibrary.isMyCarMarked((result: any) => {
+        resolve(result == null);
+      });
+    });
+  }
+
   /** Get native module reference (for advanced use cases) */
   public getNativeModule() {
     return PTRNativeLibrary;

package/src/types/config.ts

@@ -17,6 +17,8 @@ export interface PTRConfiguration {
   readonly baseUrl: string;
   /** Log level for SDK output (default: ERROR) */
   readonly logLevel?: PTRLogLevel;
+  /** Persona id for the selected persona of the SDK */
+  readonly personaId?: string;
 }
 
 /**