react-native-pointr 9.6.0 → 9.7.0

package/src/index.tsx

@@ -17,18 +17,45 @@ const PTRNativePointrLibrary = NativeModules.PTRNativePointrLibrary
       }
     );
 
-// Export the native library as default
+// Export the native library as default (backwards compatibility)
 export default PTRNativePointrLibrary;
 
-// Export POI Manager functions
-export { getPois } from './PTRPoiManager';
+// ============================================================================
+// NEW API - Recommended for new projects
+// ============================================================================
 
-// Export Map Widget utilities
-export { showMapWidget } from './PTRMapWidgetUtils';
+// Core API
+export { PointrSdk, pointrSdk } from './api/PointrSdk';
+export {
+  executeMapCommand,
+} from './api/MapWidgetApi';
 
-// Export PTR Commands
+// Constants and Enums
 export {
+  PTRLogLevel,
+  PTRState,
+  PTRAnimationType,
   PTRCommandType,
+  PTREvents,
+  PTRErrorMessages,
+} from './constants';
+
+// React Hooks
+export {
+  usePointrSdk,
+  usePointrPosition,
+  usePointrPois,
+  usePointrGeofence,
+  usePointrBuildingClick,
+  usePointrSiteClick,
+} from './hooks';
+
+// Components
+export { PTRMapWidget } from './components';
+export type { PTRMapWidgetProps } from './components';
+
+// Commands (new refactored version)
+export {
   PTRCommand,
   PTRSiteCommand,
   PTRBuildingCommand,
@@ -41,9 +68,58 @@ export {
   PTRMarkMyCarSiteCommand,
   PTRShowMyCarSiteCommand,
   PTRStartAndFocusCommand,
+  isPTRSiteCommand,
+  isPTRBuildingCommand,
+  isPTRLevelCommand,
+  isPTRPoiCommand,
+  isPTRPathCommand,
+  isPTRStaticPathCommand,
+} from './commands';
+
+// Types
+export type {
+  PTRConfiguration,
+  PTRMapWidgetConfiguration,
+  PTRStateCallback,
+  PTRPositionEvent,
+  PTRBuildingClickEvent,
+  PTRSiteClickEvent,
+  PTRGeofenceEvent,
+  PTRGeofence,
+  PTRGeofenceNotification,
+  PTRMapCommandResponse,
+} from './types';
+
+export { PTRGeofenceEventType } from './types';
+
+// ============================================================================
+// LEGACY API - Maintained for backwards compatibility
+// ============================================================================
+
+// Export POI Manager functions (legacy)
+export { getPois } from './managers/PTRPoiManager';
+
+// Export Map Widget utilities (legacy)
+export { showMapWidget } from './PTRMapWidgetUtils';
+
+// Legacy command exports (still works but new code should use ./commands)
+export {
+  PTRCommandType as LegacyPTRCommandType,
+  PTRCommand as LegacyPTRCommand,
+  PTRSiteCommand as LegacyPTRSiteCommand,
+  PTRBuildingCommand as LegacyPTRBuildingCommand,
+  PTRLevelCommand as LegacyPTRLevelCommand,
+  PTRPoiCommand as LegacyPTRPoiCommand,
+  PTRPathCommand as LegacyPTRPathCommand,
+  PTRStaticPathCommand as LegacyPTRStaticPathCommand,
+  PTRStaticWayfindingCommand as LegacyPTRStaticWayfindingCommand,
+  PTRMarkMyCarLevelCommand as LegacyPTRMarkMyCarLevelCommand,
+  PTRMarkMyCarSiteCommand as LegacyPTRMarkMyCarSiteCommand,
+  PTRShowMyCarSiteCommand as LegacyPTRShowMyCarSiteCommand,
+  PTRStartAndFocusCommand as LegacyPTRStartAndFocusCommand,
 } from './PTRCommand';
 
-// Export types
+// Export all existing types (maintained for backwards compatibility)
 export type { PTRPoi, PTRPoiAttributes } from './types/PTRPoi';
 export type { PTRPosition } from './types/PTRPosition';
 export type { PTRWayfindingEvent } from './types/PTRWayfindingEvent';
@@ -57,3 +133,7 @@ export type {
   PTRGeoMultiPolygon,
   PTRGeoCircle,
 } from './types/PTRGeometry';
+
+// Re-export native module reference
+export { PTRNativePointrLibrary };
+

package/src/{PTRPoiManager.ts → managers/PTRPoiManager.ts}

@@ -1,5 +1,5 @@
 import { NativeModules } from 'react-native';
-import { PTRPoi } from './types/PTRPoi';
+import { PTRPoi } from '../types/PTRPoi';
 
 const { PTRNativePointrLibrary } = NativeModules;
 

package/src/types/config.ts

@@ -0,0 +1,57 @@
+/**
+ * Configuration types for the Pointr SDK
+ * @module types/config
+ */
+
+import { PTRLogLevel } from '../constants';
+
+/**
+ * Configuration options for initializing the Pointr SDK
+ */
+export interface PTRConfiguration {
+  /** Client ID provided by Pointr */
+  readonly clientId: string;
+  /** License key provided by Pointr */
+  readonly licenseKey: string;
+  /** Base URL for the Pointr service */
+  readonly baseUrl: string;
+  /** Log level for SDK output (default: ERROR) */
+  readonly logLevel?: PTRLogLevel;
+}
+
+/**
+ * Map widget configuration options
+ */
+export interface PTRMapWidgetConfiguration {
+  /** Show/hide the level selector UI */
+  readonly isLevelSelectorEnabled?: boolean;
+  /** Show/hide the loading view */
+  readonly isLoadingViewEnabled?: boolean;
+  /** Show/hide the map tracking mode button */
+  readonly isMapTrackingModeButtonEnabled?: boolean;
+  /** Show/hide the exit button */
+  readonly isExitButtonEnabled?: boolean;
+  /** Show/hide the splash screen */
+  readonly isSplashScreenEnabled?: boolean;
+  /** Enable/disable the onboarding flow */
+  readonly isOnboardingEnabled?: boolean;
+  /** Show/hide the joystick control */
+  readonly isJoystickEnabled?: boolean;
+  /** Show/hide toast messages */
+  readonly isToastMessagesEnabled?: boolean;
+  /** Show/hide the info button */
+  readonly isInfoButtonEnabled?: boolean;
+  /** Show/hide the location indicator */
+  readonly isLocationIndicatorEnabled?: boolean;
+  /** Automatically pan map to first calculated user position */
+  readonly shouldFocusOnFirstUserPosition?: boolean;
+  /** Enable/disable quick access panel */
+  readonly isQuickAccessEnabled?: boolean;
+  /** Show/hide the app banner */
+  readonly isAppBannerEnabled?: boolean;
+}
+
+/**
+ * Callback function for SDK state changes
+ */
+export type PTRStateCallback = (state: string) => void;

package/src/types/events.ts

@@ -0,0 +1,106 @@
+/**
+ * Event types for the Pointr SDK
+ * @module types/events
+ */
+
+import type { PTRPosition } from './PTRPosition';
+
+/**
+ * Position event payload
+ */
+export interface PTRPositionEvent {
+  /** Geographic position */
+  readonly position: PTRPosition;
+  /** Timestamp of the position calculation */
+  readonly timestamp?: number;
+  /** Accuracy of the position in meters */
+  readonly accuracy?: number;
+}
+
+/**
+ * Building click event payload
+ */
+export interface PTRBuildingClickEvent {
+  /** Site identifier */
+  readonly siteId: string;
+  /** Building identifier */
+  readonly buildingId: string;
+  /** Building name */
+  readonly buildingName?: string;
+}
+
+/**
+ * Site click event payload
+ */
+export interface PTRSiteClickEvent {
+  /** Site identifier */
+  readonly siteId: string;
+  /** Site name */
+  readonly siteName?: string;
+}
+
+/**
+ * Geofence event types
+ */
+export enum PTRGeofenceEventType {
+  /** User entered a geofence */
+  ENTER = 'enter',
+  /** User exited a geofence */
+  EXIT = 'exit',
+  /** User is dwelling in a geofence */
+  DWELL = 'dwell',
+}
+
+/**
+ * Geofence data
+ */
+export interface PTRGeofence {
+  /** Geofence identifier */
+  readonly id: string;
+  /** External identifier */
+  readonly externalId?: string;
+  /** Geofence name */
+  readonly name: string;
+  /** Geofence type */
+  readonly geofenceType: string;
+  /** Position of the geofence */
+  readonly position: PTRPosition;
+}
+
+/**
+ * Geofence notification
+ */
+export interface PTRGeofenceNotification {
+  /** Notification identifier */
+  readonly id: string;
+  /** Notification message */
+  readonly message: string;
+  /** Notification timestamp */
+  readonly timestamp: number;
+}
+
+/**
+ * Geofence event payload
+ */
+export interface PTRGeofenceEvent {
+  /** Event type (enter/exit/dwell) */
+  readonly eventType: PTRGeofenceEventType | string;
+  /** Geofence data */
+  readonly geofence?: PTRGeofence;
+  /** Optional notification */
+  readonly geofenceNotification?: PTRGeofenceNotification;
+  /** Event timestamp (iOS only) */
+  readonly timestamp?: number;
+}
+
+/**
+ * Map command response payload
+ */
+export interface PTRMapCommandResponse {
+  /** Command type that was executed */
+  readonly command: string;
+  /** Site external identifier (for site commands) */
+  readonly siteExternalIdentifier?: string;
+  /** Error message if command failed */
+  readonly error?: string;
+}

package/src/types/index.ts

@@ -0,0 +1,35 @@
+/**
+ * Type definitions for the Pointr SDK
+ * @module types
+ */
+
+// Export configuration types
+export type { PTRConfiguration, PTRMapWidgetConfiguration, PTRStateCallback } from './config';
+
+// Export event types
+export type {
+  PTRPositionEvent,
+  PTRBuildingClickEvent,
+  PTRSiteClickEvent,
+  PTRGeofenceEvent,
+  PTRGeofence,
+  PTRGeofenceNotification,
+  PTRMapCommandResponse,
+} from './events';
+
+export { PTRGeofenceEventType } from './events';
+
+// Export existing types
+export type { PTRPoi, PTRPoiAttributes } from './PTRPoi';
+export type { PTRPosition } from './PTRPosition';
+export type { PTRWayfindingEvent } from './PTRWayfindingEvent';
+export type {
+  PTRGeometry,
+  PTRGeoPoint,
+  PTRGeoLineString,
+  PTRGeoPolygon,
+  PTRGeoMultiPoint,
+  PTRGeoMultiLineString,
+  PTRGeoMultiPolygon,
+  PTRGeoCircle,
+} from './PTRGeometry';