react-native-pointr 9.1.0 → 9.3.1

package/example/pointr_rn_demo/App.tsx

@@ -0,0 +1,323 @@
+import React, { useRef, useEffect, useState } from 'react';
+import {
+  requireNativeComponent,
+  findNodeHandle,
+  Button,
+  View,
+  ScrollView,
+  NativeSyntheticEvent,
+  NativeModules,
+  NativeEventEmitter
+} from 'react-native';
+import { useSafeAreaInsets } from 'react-native-safe-area-context';
+import {
+  getPois,
+  showMapWidget,
+  PTRSiteCommand,
+  PTRBuildingCommand,
+  PTRLevelCommand,
+  PTRPoiCommand,
+  PTRPathCommand,
+  PTRStaticPathCommand,
+  PTRMarkMyCarLevelCommand,
+  PTRMarkMyCarSiteCommand,
+  PTRShowMyCarSiteCommand,
+  PTRStartAndFocusCommand,
+  type PTRPoi,
+  type PTRWayfindingEvent,
+} from 'react-native-pointr';
+
+interface PTRMapWidgetProps {
+  style?: any;
+  onMapWidgetDidEndLoading?: (event: NativeSyntheticEvent<any>) => void;
+  onWayfindingEvent?: (event: NativeSyntheticEvent<PTRWayfindingEvent>) => void;
+}
+const PTRMapWidget = requireNativeComponent<PTRMapWidgetProps>('PTRMapWidget');
+
+// Create event emitter for Pointr events
+const PTREventEmitter = new NativeEventEmitter(NativeModules.PTRNativePointrLibrary);
+
+function App(): React.JSX.Element {
+  const ref = useRef<any>(null);
+  const [isInitialized, setIsInitialized] = useState(false);
+  const insets = useSafeAreaInsets();
+  
+  // Initialize Pointr library when component mounts
+  useEffect(() => {
+    // Use setTimeout to defer initialization to next tick, preventing blocking
+    const timer = setTimeout(() => {
+      try {
+        console.log('Initializing Pointr library...');
+        
+        // Initialize the Pointr library
+        NativeModules.PTRNativePointrLibrary.initialize(
+          "1ee58e56-fc35-4ec4-b32e-5d49e65fb52d",
+          "af5d9431-56a3-46a9-ae0a-65d9757528d1",
+          "https://sample-app-v9.pointr.cloud",
+          0
+        );
+
+        // Start the Pointr SDK
+        NativeModules.PTRNativePointrLibrary.start((state: string) => {
+          console.log(`Pointr state: ${state}`);
+          setIsInitialized(true);
+        });
+
+      } catch (error) {
+        console.error('Error initializing Pointr:', error);
+        setIsInitialized(true); // Set to true anyway to prevent blocking UI
+      }
+    }, 100);
+
+    return () => clearTimeout(timer);
+  }, []);
+  
+  // Set up geofence event listener
+  useEffect(() => {
+    if (!isInitialized) return;
+    // Subscribe to OnGeofenceEvent
+    const geofenceSubscription = PTREventEmitter.addListener(
+      'OnGeofenceEvent',
+      (geofenceEvent) => {
+        console.log('=== Geofence Event Received ===');
+        // Log the event type
+        console.log(`Event Type: ${geofenceEvent.eventType}`);
+        
+        // Log timestamp if available (iOS only)
+        if (geofenceEvent.timestamp) {
+          console.log(`Timestamp: ${new Date(geofenceEvent.timestamp).toISOString()}`);
+        }
+        
+        // Log geofence information
+        if (geofenceEvent.geofence) {
+          console.log('Geofence Information:');
+          console.log(`  - ID: ${geofenceEvent.geofence.id}`);
+          console.log(`  - External ID: ${geofenceEvent.geofence.externalId}`);
+          console.log(`  - Name: ${geofenceEvent.geofence.name}`);
+          console.log(`  - Type: ${geofenceEvent.geofence.geofenceType}`);
+          console.log(`  - Location: ${geofenceEvent.geofence.position.latitude}, ${geofenceEvent.geofence.position.longitude}`);
+        }
+        
+        // Log notification information if available
+        if (geofenceEvent.geofenceNotification) {
+          console.log('Notification:');
+          console.log(`  - ID: ${geofenceEvent.geofenceNotification.id}`);
+          console.log(`  - Message: ${geofenceEvent.geofenceNotification.message}`);
+          console.log(`  - Timestamp: ${geofenceEvent.geofenceNotification.timestamp}`);
+        }
+        
+        console.log('================================');
+      }
+    );
+
+    const positionSubscription = PTREventEmitter.addListener("OnPositionManagerCalculatedLocation", (location) => {
+      // console.log("Calculated Location: ", location);
+    });
+    
+    // Clean up the subscription when component unmounts
+    return () => {
+      geofenceSubscription.remove();
+      positionSubscription.remove();
+    };
+  }, [isInitialized]);
+
+  const handleWayfindingEvent = (event: NativeSyntheticEvent<PTRWayfindingEvent>) => {
+    const wayfindingEvent = event.nativeEvent;
+    
+    // Determine event type name
+    let eventTypeName: string;
+    switch (wayfindingEvent.type) {
+      case -1:
+        eventTypeName = 'Cancelled';
+        break;
+      case 0:
+        eventTypeName = 'Started';
+        break;
+      case 1:
+        eventTypeName = 'Ended';
+        break;
+      default:
+        eventTypeName = 'Unknown';
+    }
+    
+    console.log('=== Wayfinding Event ===');
+    console.log(`Event Type: ${eventTypeName} (${wayfindingEvent.type})`);
+    console.log('Destination POI:');
+    console.log(`  - Name: ${wayfindingEvent.poi.name}`);
+    console.log(`  - Identifier: ${wayfindingEvent.poi.identifier}`);
+    console.log(`  - External ID: ${wayfindingEvent.poi.externalIdentifier}`);
+    console.log(`  - Type Code: ${wayfindingEvent.poi.typeCode}`);
+    console.log(`  - Position: lat ${wayfindingEvent.poi.position.lat}, lon ${wayfindingEvent.poi.position.lon}, level ${wayfindingEvent.poi.position.lvl}`);
+    console.log('========================');
+  };
+
+  const handleMapWidgetDidEndLoading = (event: NativeSyntheticEvent<any>) => {
+    const ptrCommandResponse = event.nativeEvent;
+    if (ptrCommandResponse.command === "site") {
+      console.log("Map did end loading:", ptrCommandResponse.command, ptrCommandResponse.siteExternalIdentifier, ptrCommandResponse.error);
+      
+      getPois(ptrCommandResponse.siteExternalIdentifier)
+        .then((pois: PTRPoi[]) => {
+          console.log(`POIs fetched: ${pois.length} items`);
+          // Example: Log first POI details
+          if (pois.length > 0) {
+            const firstPoi = pois[0];
+            console.log('First POI:', {
+              name: firstPoi.name,
+              identifier: firstPoi.identifier,
+              typeCode: firstPoi.typeCode,
+              position: firstPoi.position,
+            });
+          }
+        })
+        .catch((error) => {
+          console.error("Error fetching POIs:", error);
+        });
+    } else {
+      console.log("Map did end loading with unknown parameters:", ptrCommandResponse);
+    }
+  };
+
+  const showSite = () => {
+    const reactTag = findNodeHandle(ref.current);
+    if (reactTag) {
+      let command = new PTRSiteCommand("workplace-portland");
+      showMapWidget(reactTag, command);
+    } else {
+      console.error("Failed to find node handle for ref");
+    }
+  };
+
+  const showBuilding = () => {
+    const reactTag = findNodeHandle(ref.current);
+    if (reactTag) {
+      let command = new PTRBuildingCommand("workplace-portland", "office-east");
+      showMapWidget(reactTag, command);
+    } else {
+      console.error("Failed to find node handle for ref");
+    }
+  };
+
+  const showLevel = () => {
+    const reactTag = findNodeHandle(ref.current);
+    if (reactTag) {
+      let command = new PTRLevelCommand("workplace-portland", "office-east", 2);
+      showMapWidget(reactTag, command);
+    } else {
+      console.error("Failed to find node handle for ref");
+    }
+  };
+
+  const showPoi = () => {
+    const reactTag = findNodeHandle(ref.current);
+    if (reactTag) {
+      let command = new PTRPoiCommand("workplace-portland", "Lobby");
+      showMapWidget(reactTag, command);
+    } else {
+      console.error("Failed to find node handle for ref");
+    }
+  };
+
+  const showPath = () => {
+    const reactTag = findNodeHandle(ref.current);
+    if (reactTag) {
+      let command = new PTRPathCommand("workplace-portland", "Lobby");
+      showMapWidget(reactTag, command);
+    } else {
+      console.error("Failed to find node handle for ref");
+    }
+  };
+
+  const showStaticPath = () => {
+    const reactTag = findNodeHandle(ref.current);
+    if (reactTag) {
+      let command = new PTRStaticPathCommand("workplace-portland", "Accessories", "Lobby");
+      showMapWidget(reactTag, command);
+    } else {
+      console.error("Failed to find node handle for ref");
+    }
+  };
+
+  const markMyCarLevel = () => {
+    const reactTag = findNodeHandle(ref.current);
+    if (reactTag) {
+      let command = new PTRMarkMyCarLevelCommand("workplace-portland", "office-east", 1, true);
+      showMapWidget(reactTag, command);
+    } else {
+      console.error("Failed to find node handle for ref");
+    }
+  };
+
+  const markMyCarSite = () => {
+    const reactTag = findNodeHandle(ref.current);
+    if (reactTag) {
+      let command = new PTRMarkMyCarSiteCommand("workplace-portland", true);
+      showMapWidget(reactTag, command);
+    } else {
+      console.error("Failed to find node handle for ref");
+    }
+  };
+
+  const showMyCarSite = () => {
+    const reactTag = findNodeHandle(ref.current);
+    if (reactTag) {
+      let command = new PTRShowMyCarSiteCommand("workplace-portland", true);
+      showMapWidget(reactTag, command);
+    } else {
+      console.error("Failed to find node handle for ref");
+    }
+  };
+
+  const startAndFocusSite = () => {
+    const reactTag = findNodeHandle(ref.current);
+    if (reactTag) {
+      const siteCommand = new PTRSiteCommand("workplace-portland");
+      const command = new PTRStartAndFocusCommand(
+        "1ee58e56-fc35-4ec4-b32e-5d49e65fb52d",
+        "af5d9431-56a3-46a9-ae0a-65d9757528d1",
+        "https://sample-app-v9.pointr.cloud",
+        0,
+        siteCommand
+      );
+      showMapWidget(reactTag, command);
+    } else {
+      console.error("Failed to find node handle for ref");
+    }
+  };
+
+  return (
+    <View style={{ flex: 1 }}>
+      <View style={{ flex: 1, paddingTop: insets.top, paddingLeft: insets.left, paddingRight: insets.right }}>
+        <ScrollView style={{ flex: 1 }} contentContainerStyle={{ padding: 16 }}>
+          <Button title="Show Site" onPress={showSite} />
+          <View style={{ height: 12 }} />
+          <Button title="Show Building" onPress={showBuilding} />
+          <View style={{ height: 12 }} />
+          <Button title="Show Level" onPress={showLevel} />
+          <View style={{ height: 12 }} />
+          <Button title="Show POI" onPress={showPoi} />
+          <View style={{ height: 12 }} />
+          <Button title="Show Path" onPress={showPath} />
+          <View style={{ height: 12 }} />
+          <Button title="Show Static Path" onPress={showStaticPath} />
+          <View style={{ height: 12 }} />
+          <Button title="Mark My Car Level" onPress={markMyCarLevel} />
+          <View style={{ height: 12 }} />
+          <Button title="Mark My Car Site" onPress={markMyCarSite} />
+          <View style={{ height: 12 }} />
+          <Button title="Show My Car Site" onPress={showMyCarSite} />
+          <View style={{ height: 12 }} />
+          <Button title="Start & Focus Site" onPress={startAndFocusSite} />
+        </ScrollView>
+      </View>
+      <PTRMapWidget 
+        ref={ref} 
+        style={{ flex: 4 }} 
+        onMapWidgetDidEndLoading={handleMapWidgetDidEndLoading} 
+        onWayfindingEvent={handleWayfindingEvent}
+      />
+    </View>
+  );
+}
+
+export default App;

package/example/pointr_rn_demo/Gemfile

@@ -0,0 +1,16 @@
+source 'https://rubygems.org'
+
+# You may use http://rbenv.org/ or https://rvm.io/ to install and use this version
+ruby ">= 2.6.10"
+
+# Exclude problematic versions of cocoapods and activesupport that causes build failures.
+gem 'cocoapods', '>= 1.13', '!= 1.15.0', '!= 1.15.1'
+gem 'activesupport', '>= 6.1.7.5', '!= 7.1.0'
+gem 'xcodeproj', '< 1.26.0'
+gem 'concurrent-ruby', '< 1.3.4'
+
+# Ruby 3.4.0 has removed some libraries from the standard library.
+gem 'bigdecimal'
+gem 'logger'
+gem 'benchmark'
+gem 'mutex_m'

package/example/pointr_rn_demo/Gemfile.lock

@@ -0,0 +1,111 @@
+GEM
+  remote: https://rubygems.org/
+  specs:
+    CFPropertyList (3.0.8)
+    activesupport (6.1.7.10)
+      concurrent-ruby (~> 1.0, >= 1.0.2)
+      i18n (>= 1.6, < 2)
+      minitest (>= 5.1)
+      tzinfo (~> 2.0)
+      zeitwerk (~> 2.3)
+    addressable (2.8.7)
+      public_suffix (>= 2.0.2, < 7.0)
+    algoliasearch (1.27.5)
+      httpclient (~> 2.8, >= 2.8.3)
+      json (>= 1.5.1)
+    atomos (0.1.3)
+    benchmark (0.5.0)
+    bigdecimal (3.3.1)
+    claide (1.1.0)
+    cocoapods (1.15.2)
+      addressable (~> 2.8)
+      claide (>= 1.0.2, < 2.0)
+      cocoapods-core (= 1.15.2)
+      cocoapods-deintegrate (>= 1.0.3, < 2.0)
+      cocoapods-downloader (>= 2.1, < 3.0)
+      cocoapods-plugins (>= 1.0.0, < 2.0)
+      cocoapods-search (>= 1.0.0, < 2.0)
+      cocoapods-trunk (>= 1.6.0, < 2.0)
+      cocoapods-try (>= 1.1.0, < 2.0)
+      colored2 (~> 3.1)
+      escape (~> 0.0.4)
+      fourflusher (>= 2.3.0, < 3.0)
+      gh_inspector (~> 1.0)
+      molinillo (~> 0.8.0)
+      nap (~> 1.0)
+      ruby-macho (>= 2.3.0, < 3.0)
+      xcodeproj (>= 1.23.0, < 2.0)
+    cocoapods-core (1.15.2)
+      activesupport (>= 5.0, < 8)
+      addressable (~> 2.8)
+      algoliasearch (~> 1.0)
+      concurrent-ruby (~> 1.1)
+      fuzzy_match (~> 2.0.4)
+      nap (~> 1.0)
+      netrc (~> 0.11)
+      public_suffix (~> 4.0)
+      typhoeus (~> 1.0)
+    cocoapods-deintegrate (1.0.5)
+    cocoapods-downloader (2.1)
+    cocoapods-plugins (1.0.0)
+      nap
+    cocoapods-search (1.0.1)
+    cocoapods-trunk (1.6.0)
+      nap (>= 0.8, < 2.0)
+      netrc (~> 0.11)
+    cocoapods-try (1.2.0)
+    colored2 (3.1.2)
+    concurrent-ruby (1.3.3)
+    escape (0.0.4)
+    ethon (0.15.0)
+      ffi (>= 1.15.0)
+    ffi (1.17.2)
+    fourflusher (2.3.1)
+    fuzzy_match (2.0.4)
+    gh_inspector (1.1.3)
+    httpclient (2.9.0)
+      mutex_m
+    i18n (1.14.7)
+      concurrent-ruby (~> 1.0)
+    json (2.7.6)
+    logger (1.7.0)
+    minitest (5.25.4)
+    molinillo (0.8.0)
+    mutex_m (0.3.0)
+    nanaimo (0.3.0)
+    nap (1.1.0)
+    netrc (0.11.0)
+    public_suffix (4.0.7)
+    rexml (3.4.4)
+    ruby-macho (2.5.1)
+    typhoeus (1.5.0)
+      ethon (>= 0.9.0, < 0.16.0)
+    tzinfo (2.0.6)
+      concurrent-ruby (~> 1.0)
+    xcodeproj (1.25.1)
+      CFPropertyList (>= 2.3.3, < 4.0)
+      atomos (~> 0.1.3)
+      claide (>= 1.0.2, < 2.0)
+      colored2 (~> 3.1)
+      nanaimo (~> 0.3.0)
+      rexml (>= 3.3.6, < 4.0)
+    zeitwerk (2.6.18)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  activesupport (>= 6.1.7.5, != 7.1.0)
+  benchmark
+  bigdecimal
+  cocoapods (>= 1.13, != 1.15.1, != 1.15.0)
+  concurrent-ruby (< 1.3.4)
+  logger
+  mutex_m
+  xcodeproj (< 1.26.0)
+
+RUBY VERSION
+   ruby 2.6.10p210
+
+BUNDLED WITH
+   2.4.22

package/example/pointr_rn_demo/README.md

@@ -0,0 +1,188 @@
+# Pointr React Native Demo
+
+This is a demo [**React Native**](https://reactnative.dev) project showcasing the Pointr SDK integration, bootstrapped using [`@react-native-community/cli`](https://github.com/react-native-community/cli).
+
+# Getting Started
+
+> **Note**: Make sure you have completed the [Set Up Your Environment](https://reactnative.dev/docs/set-up-your-environment) guide before proceeding.
+
+## Prerequisites
+
+- Node.js >= 20
+- React Native 0.82.1
+- Xcode (for iOS development)
+- Android Studio (for Android development)
+
+## Setup Instructions
+
+### Step 1: Install React Native Pointr Package
+
+This demo requires the `react-native-pointr` package. You have two options:
+
+#### Option A: Local Package (Recommended for Testing)
+
+1. Place the `react-native-pointr` package in the parent directory structure
+2. The demo expects the package at: `../../../react-native-pointr` (relative to the demo folder)
+3. Verify the path in `package.json` under dependencies:
+   ```json
+   "react-native-pointr": "file:../../../react-native-pointr"
+   ```
+
+#### Option B: Published Package
+
+If the package is published to npm, update `package.json` to reference it:
+
+```json
+"react-native-pointr": "^9.3.1"
+```
+
+### Step 2: Configure Pointr Credentials
+
+Before installing dependencies, you need to configure your Pointr credentials:
+
+#### Android (android/build.gradle)
+
+Replace the Maven credentials in `android/build.gradle`:
+
+```gradle
+credentials {
+    username 'YOUR_MAVEN_USERNAME'    // Replace with your Maven username
+    password 'YOUR_MAVEN_PASSWORD'    // Replace with your Maven password
+}
+```
+
+#### iOS (ios/Podfile)
+
+Replace the Pointr SDK token in `ios/Podfile` (line 4):
+
+```ruby
+ENV['POINTR_SDK_TOKEN'] = 'YOUR_POINTR_SDK_TOKEN'  // Replace with your SDK token
+```
+
+#### App Configuration (App.tsx)
+
+Replace the Pointr SDK credentials in `App.tsx` (lines 54-56 and 276-278):
+
+```typescript
+NativeModules.PTRNativePointrLibrary.initialize(
+  "YOUR_CLIENT_ID",        // Replace with your client ID
+  "YOUR_LICENSE_KEY",      // Replace with your license key
+  "https://your-instance.pointr.cloud",  // Replace with your instance URL
+  0
+);
+```
+
+### Step 3: Install Dependencies
+
+```bash
+npm install
+cd ios && pod install && cd ..
+```
+
+Or use the reset script for a complete setup:
+
+```bash
+npm run reset
+```
+
+### Step 4: Start Metro
+
+First, you will need to run **Metro**, the JavaScript build tool for React Native.
+
+To start the Metro dev server, run the following command from the root of your React Native project:
+
+```sh
+# Using npm
+npm start
+
+# OR using Yarn
+yarn start
+```
+
+### Step 5: Build and Run Your App
+
+With Metro running, open a new terminal window/pane from the root of your React Native project, and use one of the following commands to build and run your Android or iOS app:
+
+### For Android
+
+```sh
+# Using npm
+npm run android
+
+# OR using Yarn
+yarn android
+```
+
+### For iOS
+
+```sh
+# Using npm
+npm run ios
+
+# OR using Yarn
+yarn ios
+```
+
+If everything is set up correctly, you should see your new app running in the Android Emulator, iOS Simulator, or your connected device.
+
+This is one way to run your app — you can also build it directly from Android Studio or Xcode.
+
+## Features Demonstrated
+
+This demo showcases the following Pointr SDK capabilities:
+
+- **Map Widget Integration**: Shows how to integrate and display the Pointr map
+- **POI Management**: Demonstrates fetching and displaying Points of Interest
+- **Navigation Commands**: Examples of various map commands (site, building, level, POI, path)
+- **Geofence Events**: Listening to geofence enter/exit events
+- **Wayfinding Events**: Tracking wayfinding navigation state
+- **My Car Feature**: Marking and showing saved car locations
+
+## Available Scripts
+
+- `npm start` - Start Metro bundler
+- `npm run android` - Run on Android
+- `npm run ios` - Run on iOS
+- `npm run clean` - Clean build artifacts and caches
+- `npm run reset` - Complete reset (clean + install + pod install)
+- `npm run lint` - Run ESLint
+- `npm test` - Run tests
+- `npm run prepare-dist` - Create distribution package
+
+## Modifying the App
+
+Now that you have successfully run the app, let's make changes!
+
+Open `App.tsx` in your text editor of choice and make some changes. When you save, your app will automatically update and reflect these changes — this is powered by [Fast Refresh](https://reactnative.dev/docs/fast-refresh).
+
+When you want to forcefully reload, for example to reset the state of your app, you can perform a full reload:
+
+- **Android**: Press the <kbd>R</kbd> key twice or select **"Reload"** from the **Dev Menu**, accessed via <kbd>Ctrl</kbd> + <kbd>M</kbd> (Windows/Linux) or <kbd>Cmd ⌘</kbd> + <kbd>M</kbd> (macOS).
+- **iOS**: Press <kbd>R</kbd> in iOS Simulator.
+
+# Pointr SDK Documentation
+
+For more information about the Pointr React Native SDK, please refer to the main package documentation.
+
+## Congratulations! :tada:
+
+You've successfully run and modified your React Native App. :partying_face:
+
+### Now what?
+
+- If you want to add this new React Native code to an existing application, check out the [Integration guide](https://reactnative.dev/docs/integration-with-existing-apps).
+- If you're curious to learn more about React Native, check out the [docs](https://reactnative.dev/docs/getting-started).
+
+# Troubleshooting
+
+If you're having issues getting the above steps to work, see the [Troubleshooting](https://reactnative.dev/docs/troubleshooting) page.
+
+# Learn More
+
+To learn more about React Native, take a look at the following resources:
+
+- [React Native Website](https://reactnative.dev) - learn more about React Native.
+- [Getting Started](https://reactnative.dev/docs/environment-setup) - an **overview** of React Native and how setup your environment.
+- [Learn the Basics](https://reactnative.dev/docs/getting-started) - a **guided tour** of the React Native **basics**.
+- [Blog](https://reactnative.dev/blog) - read the latest official React Native **Blog** posts.
+- [`@facebook/react-native`](https://github.com/facebook/react-native) - the Open Source; GitHub **repository** for React Native.

package/example/pointr_rn_demo/__tests__/App.test.tsx

@@ -0,0 +1,13 @@
+/**
+ * @format
+ */
+
+import React from 'react';
+import ReactTestRenderer from 'react-test-renderer';
+import App from '../App';
+
+test('renders correctly', async () => {
+  await ReactTestRenderer.act(() => {
+    ReactTestRenderer.create(<App />);
+  });
+});