react-native-pointr 9.2.0 → 9.5.0

package/prepare-distribution.sh

@@ -0,0 +1,151 @@
+#!/bin/bash
+
+# Script to prepare react-native-pointr package for distribution
+# This script cleans build artifacts, removes git history, and creates a compressed archive
+# Usage:
+#   ./prepare-distribution.sh       - Package the library
+#   ./prepare-distribution.sh demo  - Package the demo app
+
+set -e  # Exit on error
+
+MODE="${1:-library}"
+
+if [ "$MODE" = "demo" ]; then
+    echo "📱 Preparing demo app for distribution..."
+    
+    DEMO_NAME="pointr_rn_demo"
+    DEMO_VERSION=$(grep -o '"version": "[^"]*"' example/pointr_rn_demo/package.json | head -1 | sed 's/"version": "\(.*\)"/\1/')
+    OUTPUT_NAME="${DEMO_NAME}-${DEMO_VERSION}.zip"
+    TEMP_DIR="${DEMO_NAME}_temp"
+    
+    echo "🧹 Starting demo app cleanup and preparation..."
+    echo "📌 Demo version: ${DEMO_VERSION}"
+    
+    # Create a temporary copy of the demo app
+    echo "📦 Creating temporary copy of demo app..."
+    rsync -a --exclude="node_modules" \
+             --exclude="android/build" \
+             --exclude="android/.gradle" \
+             --exclude="android/app/build" \
+             --exclude="ios/build" \
+             --exclude="ios/Pods" \
+             --exclude="ios/Podfile.lock" \
+             --exclude=".DS_Store" \
+             --exclude="*.log" \
+             example/pointr_rn_demo/ "../${TEMP_DIR}/"
+    
+    cd "../${TEMP_DIR}"
+    
+    # Remove development files
+    echo "🗑️  Removing development files..."
+    rm -rf .git
+    rm -rf .vscode
+    rm -rf .idea
+    rm -f .DS_Store
+    rm -f *.log
+    rm -f npm-debug.log*
+    rm -f yarn-debug.log*
+    rm -f yarn-error.log*
+    
+    # Create the zip archive
+    echo "📦 Creating compressed archive..."
+    cd ..
+    zip -r "${OUTPUT_NAME}" "${TEMP_DIR}" -x "*.DS_Store" -q
+    
+    # Create dist directory if it doesn't exist
+    mkdir -p "react-native-pointr/dist"
+    
+    # Move the archive to dist directory
+    mv "${OUTPUT_NAME}" "react-native-pointr/dist/"
+    
+    # Clean up temporary directory
+    echo "🧼 Cleaning up temporary files..."
+    rm -rf "${TEMP_DIR}"
+    
+    cd "react-native-pointr"
+    
+    echo "✅ Demo distribution package created successfully!"
+    echo "📦 Output file: ${OUTPUT_NAME}"
+    echo "📍 Location: $(pwd)/dist/${OUTPUT_NAME}"
+    
+    exit 0
+fi
+
+# Library packaging mode
+PACKAGE_NAME="react-native-pointr"
+VERSION=$(grep -o '"version": "[^"]*"' package.json | head -1 | sed 's/"version": "\(.*\)"/\1/')
+OUTPUT_NAME="${PACKAGE_NAME}-${VERSION}.zip"
+TEMP_DIR="${PACKAGE_NAME}_temp"
+
+echo "🧹 Starting package cleanup and preparation..."
+echo "📌 Package version: ${VERSION}"
+
+# Create a temporary copy of the package
+echo "📦 Creating temporary copy..."
+rsync -a --exclude=".git" \
+         --exclude="node_modules" \
+         --exclude="example" \
+         --exclude=".DS_Store" \
+         --exclude="*.log" \
+         --exclude="prepare-distribution.sh" \
+         ./ "../${TEMP_DIR}/"
+
+cd "../${TEMP_DIR}"
+
+# Clean Android build artifacts
+echo "🤖 Cleaning Android build artifacts..."
+if [ -d "android/build" ]; then
+    rm -rf android/build
+fi
+if [ -d "android/.gradle" ]; then
+    rm -rf android/.gradle
+fi
+
+# Clean iOS build artifacts
+echo "🍎 Cleaning iOS build artifacts..."
+if [ -d "ios/build" ]; then
+    rm -rf ios/build
+fi
+if [ -d "ios/Pods" ]; then
+    rm -rf ios/Pods
+fi
+if [ -f "ios/Podfile.lock" ]; then
+    rm -f ios/Podfile.lock
+fi
+
+# Remove common development files
+echo "🗑️  Removing development files..."
+rm -rf .git
+rm -rf .gitignore
+rm -rf .github
+rm -rf node_modules
+rm -rf .vscode
+rm -rf .idea
+rm -f .DS_Store
+rm -f *.log
+rm -f npm-debug.log*
+rm -f yarn-debug.log*
+rm -f yarn-error.log*
+rm -f package-lock.json
+rm -f yarn.lock
+
+# Create the zip archive
+echo "📦 Creating compressed archive..."
+cd ..
+zip -r "${OUTPUT_NAME}" "${TEMP_DIR}" -x "*.DS_Store" -q
+
+# Create dist directory if it doesn't exist
+mkdir -p "${PACKAGE_NAME}/dist"
+
+# Move the archive to dist directory
+mv "${OUTPUT_NAME}" "${PACKAGE_NAME}/dist/"
+
+# Clean up temporary directory
+echo "🧼 Cleaning up temporary files..."
+rm -rf "${TEMP_DIR}"
+
+cd "${PACKAGE_NAME}"
+
+echo "✅ Distribution package created successfully!"
+echo "📦 Output file: ${OUTPUT_NAME}"
+echo "📍 Location: $(pwd)/dist/${OUTPUT_NAME}"

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', '9.2.0'
+  s.dependency 'PointrKit', '9.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/PTRCommand.ts

@@ -8,6 +8,7 @@ export enum PTRCommandType {
     POI = "poi",
     PATH = "path",
     STATIC_PATH = "staticPath",
+    STATIC_WAYFINDING = "staticWayfinding",
     MARK_MY_CAR_LEVEL = "markMyCarForLevel",
     MARK_MY_CAR_SITE = "markMyCarForSite",
     SHOW_MY_CAR_SITE = "showMyCarForSite",
@@ -82,6 +83,18 @@ export class PTRStaticPathCommand extends PTRCommand {
     }
 }
 
+/**
+ * Command to show static wayfinding using PTRMapWidgetStaticWayfindingAction
+ * @param site - the site that has the POIs
+ * @param sourcePoi - the source POI location to start the path from
+ * @param destinationPoi - the destination POI location to end the path at
+ */
+export class PTRStaticWayfindingCommand extends PTRCommand {
+    constructor(public site: string, public sourcePoi: string, public destinationPoi: string) {
+        super(PTRCommandType.STATIC_WAYFINDING);
+    }
+}
+
 /**
  * Command to show mark my car details
  * @param site - the site to show mark my car details

package/src/PTRMapWidgetUtils.ts

@@ -1,5 +1,5 @@
 import { UIManager } from 'react-native';
-import { PTRSiteCommand, PTRBuildingCommand, PTRLevelCommand, PTRPoiCommand, PTRPathCommand, PTRStaticPathCommand, PTRCommand, PTRCommandType, PTRMarkMyCarLevelCommand, PTRMarkMyCarSiteCommand, PTRShowMyCarSiteCommand, PTRStartAndFocusCommand } from 'react-native-pointr/src/PTRCommand';
+import { PTRSiteCommand, PTRBuildingCommand, PTRLevelCommand, PTRPoiCommand, PTRPathCommand, PTRStaticPathCommand, PTRStaticWayfindingCommand, PTRCommand, PTRCommandType, PTRMarkMyCarLevelCommand, PTRMarkMyCarSiteCommand, PTRShowMyCarSiteCommand, PTRStartAndFocusCommand } from 'react-native-pointr/src/PTRCommand';
 /**
  * Handle PTRStartAndFocusCommand specifically
  * @param reactTag view tag of the map widget
@@ -153,6 +153,15 @@ export const showMapWidget = (reactTag: number, ptrCommand: PTRCommand | PTRStar
       );
       break;
     }
+    case PTRCommandType.STATIC_WAYFINDING: {
+      const staticWayfindingCommand = ptrCommand as PTRStaticWayfindingCommand;
+      UIManager.dispatchViewManagerCommand(
+        reactTag,
+        'staticWayfinding',
+        [staticWayfindingCommand.site, staticWayfindingCommand.sourcePoi, staticWayfindingCommand.destinationPoi],
+      );
+      break;
+    }
     case PTRCommandType.MARK_MY_CAR_LEVEL: {
       const markMyCarCommand = ptrCommand as PTRMarkMyCarLevelCommand;
       UIManager.dispatchViewManagerCommand(

package/src/PTRPoiManager.ts

@@ -0,0 +1,20 @@
+import { NativeModules } from 'react-native';
+import { PTRPoi } from './types/PTRPoi';
+
+const { PTRNativePointrLibrary } = NativeModules;
+
+/**
+ * Get all Points of Interest (POIs) for a specific site
+ * @param siteId - The external identifier of the site
+ * @returns Promise that resolves with an array of POIs
+ * @throws Error if the site is not found or if the operation fails
+ */
+export async function getPois(siteId: string): Promise<PTRPoi[]> {
+  try {
+    const pois = await PTRNativePointrLibrary.getPois(siteId);
+    return pois as PTRPoi[];
+  } catch (error) {
+    console.error('Failed to get POIs:', error);
+    throw error;
+  }
+}

package/src/index.tsx

@@ -17,4 +17,43 @@ const PTRNativePointrLibrary = NativeModules.PTRNativePointrLibrary
       }
     );
 
-module.exports = PTRNativePointrLibrary;
+// Export the native library as default
+export default PTRNativePointrLibrary;
+
+// Export POI Manager functions
+export { getPois } from './PTRPoiManager';
+
+// Export Map Widget utilities
+export { showMapWidget } from './PTRMapWidgetUtils';
+
+// Export PTR Commands
+export {
+  PTRCommandType,
+  PTRCommand,
+  PTRSiteCommand,
+  PTRBuildingCommand,
+  PTRLevelCommand,
+  PTRPoiCommand,
+  PTRPathCommand,
+  PTRStaticPathCommand,
+  PTRStaticWayfindingCommand,
+  PTRMarkMyCarLevelCommand,
+  PTRMarkMyCarSiteCommand,
+  PTRShowMyCarSiteCommand,
+  PTRStartAndFocusCommand,
+} from './PTRCommand';
+
+// Export types
+export type { PTRPoi, PTRPoiAttributes } from './types/PTRPoi';
+export type { PTRPosition } from './types/PTRPosition';
+export type { PTRWayfindingEvent } from './types/PTRWayfindingEvent';
+export type {
+  PTRGeometry,
+  PTRGeoPoint,
+  PTRGeoPolygon,
+  PTRGeoMultiPoint,
+  PTRGeoLineString,
+  PTRGeoMultiLineString,
+  PTRGeoMultiPolygon,
+  PTRGeoCircle,
+} from './types/PTRGeometry';

package/src/types/PTRGeometry.ts

@@ -0,0 +1,70 @@
+/**
+ * Base point with latitude and longitude
+ */
+export interface PTRGeoPoint {
+  type: 'Point';
+  lat: number;
+  lon: number;
+}
+
+/**
+ * Polygon geometry with outer and inner rings
+ */
+export interface PTRGeoPolygon {
+  type: 'Polygon';
+  outer: PTRGeoPoint[];
+  inners: PTRGeoPoint[][];
+}
+
+/**
+ * Multi-point geometry
+ */
+export interface PTRGeoMultiPoint {
+  type: 'MultiPoint';
+  points: PTRGeoPoint[];
+}
+
+/**
+ * Line string geometry
+ */
+export interface PTRGeoLineString {
+  type: 'LineString';
+  points: PTRGeoPoint[];
+}
+
+/**
+ * Multi-line string geometry
+ */
+export interface PTRGeoMultiLineString {
+  type: 'MultiLineString';
+  lines: PTRGeoPoint[][];
+}
+
+/**
+ * Multi-polygon geometry
+ */
+export interface PTRGeoMultiPolygon {
+  type: 'MultiPolygon';
+  polygons: PTRGeoPolygon[];
+}
+
+/**
+ * Circle geometry
+ */
+export interface PTRGeoCircle {
+  type: 'Circle';
+  center: PTRGeoPoint;
+  radius: number;
+}
+
+/**
+ * Union of all supported geometry types
+ */
+export type PTRGeometry =
+  | PTRGeoPoint
+  | PTRGeoPolygon
+  | PTRGeoMultiPoint
+  | PTRGeoLineString
+  | PTRGeoMultiLineString
+  | PTRGeoMultiPolygon
+  | PTRGeoCircle;

package/src/types/PTRPoi.ts

@@ -0,0 +1,49 @@
+import { PTRPosition } from './PTRPosition';
+import { PTRGeometry } from './PTRGeometry';
+
+/**
+ * POI attributes containing additional metadata
+ */
+export interface PTRPoiAttributes {
+  /** Logo URL */
+  logo?: string;
+  
+  /** Array of image URLs */
+  images?: string[];
+  
+  /** Description text */
+  description?: string;
+  
+  /** Extra data as key-value pairs */
+  extra?: Record<string, any>;
+  
+  /** Any other custom attributes */
+  [key: string]: any;
+}
+
+/**
+ * Point of Interest (POI) data structure
+ * Represents a feature from the Pointr SDK with location, geometry, and metadata
+ */
+export interface PTRPoi {
+  /** Internal unique identifier */
+  identifier: string;
+  
+  /** External identifier for API references */
+  externalIdentifier: string;
+  
+  /** Display name of the POI */
+  name: string;
+  
+  /** POI type code (e.g., "lobby", "room", "building-outline") */
+  typeCode: string;
+  
+  /** Geographic position with site, building, and level information */
+  position: PTRPosition;
+  
+  /** Geometry data (point, polygon, etc.) */
+  geometry: PTRGeometry;
+  
+  /** Additional POI attributes and metadata */
+  attributes: PTRPoiAttributes;
+}

package/src/types/PTRPosition.ts

@@ -0,0 +1,22 @@
+/**
+ * Geographic position with site, building, and level information
+ */
+export interface PTRPosition {
+  /** Latitude */
+  lat: number;
+  
+  /** Longitude */
+  lon: number;
+  
+  /** Whether the position is valid */
+  isValid: boolean;
+  
+  /** Site identifier */
+  sid: string;
+  
+  /** Building identifier */
+  bid: string;
+  
+  /** Level index */
+  lvl: number;
+}

package/src/types/PTRWayfindingEvent.ts

@@ -0,0 +1,18 @@
+import { PTRPoi } from './PTRPoi';
+
+/**
+ * Wayfinding event data structure
+ * Fired during wayfinding operations to track navigation state
+ */
+export interface PTRWayfindingEvent {
+  /** 
+   * Event type:
+   * -1 = Cancelled (user cancelled the navigation)
+   * 0 = Started (wayfinding navigation has started)
+   * 1 = Ended (user completed or closed the navigation)
+   */
+  type: number;
+  
+  /** Destination Point of Interest */
+  poi: PTRPoi;
+}