react-native-radar 4.0.0 → 4.1.0

package/ios/RadarSDK.xcframework/ios-arm64/RadarSDK.framework/Headers/RadarTrackingOptions.h

@@ -43,7 +43,19 @@ typedef NS_ENUM(NSInteger, RadarTrackingOptionsSyncLocations) {
     /// Syncs only stops and exits to the server
     RadarTrackingOptionsSyncStopsAndExits,
     /// Syncs no location updates to the server
-    RadarTrackingOptionsSyncNone
+    RadarTrackingOptionsSyncNone,
+    /// Syncs only on detected events (geofence, place, beacon changes)
+    RadarTrackingOptionsSyncEvents
+};
+
+/**
+ The type of tracking options.
+ */
+typedef NS_ENUM(NSInteger, RadarTrackingOptionsType) {
+    RadarTrackingOptionsTypeDefault,
+    RadarTrackingOptionsTypeOnTrip,
+    RadarTrackingOptionsTypeInGeofence,
+    RadarTrackingOptionsTypeIsUser
 };
 
 /**
@@ -169,6 +181,11 @@ typedef NS_ENUM(NSInteger, RadarTrackingOptionsSyncLocations) {
  */
 @property (nonatomic, assign) BOOL usePressure;
 
+/**
+ The type of tracking options.
+ */
+@property (nonatomic, assign) RadarTrackingOptionsType type;
+
 /**
  Updates about every 30 seconds while moving or stopped. Moderate battery usage. Shows the flashing blue status bar during tracking.
  @see https://developer.apple.com/documentation/corelocation/cllocationmanager/2923541-showsbackgroundlocationindicator
@@ -197,6 +214,8 @@ typedef NS_ENUM(NSInteger, RadarTrackingOptionsSyncLocations) {
 + (NSString *)stringForSyncLocations:(RadarTrackingOptionsSyncLocations)syncLocations;
 + (RadarTrackingOptionsSyncLocations)syncLocationsForString:(NSString *)str;
 + (RadarTrackingOptions *_Nullable)trackingOptionsFromDictionary:(NSDictionary *_Nonnull)dictionary;
++ (NSString *)stringForType:(RadarTrackingOptionsType)type;
++ (RadarTrackingOptionsType)typeForString:(NSString *)str;
 - (NSDictionary *)dictionaryValue;
 
 @end

package/ios/RadarSDK.xcframework/ios-arm64/RadarSDK.framework/Headers/RadarTrip.h

@@ -7,6 +7,7 @@
 
 #import "RadarCoordinate.h"
 #import "RadarRouteMode.h"
+#import "RadarTripLeg.h"
 #import "RadarTripOrder.h"
 #import <Foundation/Foundation.h>
 
@@ -92,6 +93,20 @@ typedef NS_ENUM(NSInteger, RadarTripStatus) {
  */
 @property (nullable, copy, nonatomic, readonly) NSArray<RadarTripOrder *> *orders;
 
+/**
+ For multi-destination trips, the array of trip legs.
+ Each leg contains destination info, status, and metadata.
+ Use leg._id when calling updateTripLeg.
+ */
+@property (nullable, copy, nonatomic, readonly) NSArray<RadarTripLeg *> *legs;
+
+/**
+ For multi-destination trips, the ID of the current active leg.
+ */
+@property (nullable, copy, nonatomic, readonly) NSString *currentLegId;
+
 - (NSDictionary *_Nonnull)dictionaryValue;
 
+- (instancetype _Nullable)initWithObject:(id _Nonnull)object;
+
 @end

package/ios/RadarSDK.xcframework/ios-arm64/RadarSDK.framework/Headers/RadarTripLeg.h

@@ -0,0 +1,268 @@
+//
+//  RadarTripLeg.h
+//  RadarSDK
+//
+//  Created by Alan Charles on 2/23/26.
+//  Copyright © 2026 Radar Labs, Inc. All rights reserved.
+//
+
+#import <Foundation/Foundation.h>
+#import <CoreLocation/CoreLocation.h>
+
+NS_ASSUME_NONNULL_BEGIN
+
+/**
+ The status values for trip legs.
+ */
+typedef NS_ENUM(NSInteger, RadarTripLegStatus) {
+    /// Unknown
+    RadarTripLegStatusUnknown NS_SWIFT_NAME(unknown),
+    /// Pending
+    RadarTripLegStatusPending NS_SWIFT_NAME(pending),
+    /// Started
+    RadarTripLegStatusStarted NS_SWIFT_NAME(started),
+    /// Approaching
+    RadarTripLegStatusApproaching NS_SWIFT_NAME(approaching),
+    /// Arrived
+    RadarTripLegStatusArrived NS_SWIFT_NAME(arrived),
+    /// Completed
+    RadarTripLegStatusCompleted NS_SWIFT_NAME(completed),
+    /// Canceled
+    RadarTripLegStatusCanceled NS_SWIFT_NAME(canceled),
+    /// Expired
+    RadarTripLegStatusExpired NS_SWIFT_NAME(expired)
+};
+
+/**
+ The destination type values for trip legs.
+ */
+typedef NS_ENUM(NSInteger, RadarTripLegDestinationType) {
+    /// Unknown
+    RadarTripLegDestinationTypeUnknown NS_SWIFT_NAME(unknown),
+    /// Geofence
+    RadarTripLegDestinationTypeGeofence NS_SWIFT_NAME(geofence),
+    /// Address
+    RadarTripLegDestinationTypeAddress NS_SWIFT_NAME(address),
+    /// Coordinates
+    RadarTripLegDestinationTypeCoordinates NS_SWIFT_NAME(coordinates)
+};
+
+/**
+ Represents a leg of a multi-destination trip.
+
+ @see https://radar.com/documentation/trip-tracking
+ */
+@interface RadarTripLeg : NSObject
+
+#pragma mark - Response Properties (populated from server response)
+
+/**
+ The Radar ID of the leg. Set from server response.
+ Use this when calling updateTripLeg.
+ */
+@property (nullable, nonatomic, copy, readonly) NSString *_id;
+
+/**
+ The status of the leg. Set from server response.
+ */
+@property (nonatomic, assign, readonly) RadarTripLegStatus status;
+
+/**
+ The destination type for this leg.
+ When parsed from a server response, reflects the server's `destination.type`.
+ Otherwise, inferred from which properties are set (geofence > address > coordinates).
+ */
+@property (nonatomic, assign, readonly) RadarTripLegDestinationType destinationType;
+
+/**
+ The date when the leg was created. Set from server response.
+ */
+@property (nullable, nonatomic, copy, readonly) NSDate *createdAt;
+
+/**
+ The date when the leg was last updated. Set from server response.
+ */
+@property (nullable, nonatomic, copy, readonly) NSDate *updatedAt;
+
+/**
+ The ETA duration in minutes to this leg's destination. Set from server response.
+ */
+@property (nonatomic, assign, readonly) float etaDuration;
+
+/**
+ The ETA distance in meters to this leg's destination. Set from server response.
+ */
+@property (nonatomic, assign, readonly) float etaDistance;
+
+#pragma mark - Geofence Destination Properties
+
+/**
+ The tag of the destination geofence for this leg.
+ Use with destinationGeofenceExternalId for geofence-based destinations.
+ */
+@property (nullable, nonatomic, copy) NSString *destinationGeofenceTag;
+
+/**
+ The external ID of the destination geofence for this leg.
+ Use with destinationGeofenceTag for geofence-based destinations.
+ */
+@property (nullable, nonatomic, copy) NSString *destinationGeofenceExternalId;
+
+/**
+ The Radar ID of the destination geofence for this leg.
+ Alternative to using destinationGeofenceTag + destinationGeofenceExternalId.
+ */
+@property (nullable, nonatomic, copy) NSString *destinationGeofenceId;
+
+#pragma mark - Address Destination Properties
+
+/**
+ The address string for the destination of this leg.
+ Use for address-based destinations.
+ */
+@property (nullable, nonatomic, copy) NSString *address;
+
+#pragma mark - Coordinate Destination Properties
+
+/**
+ The coordinates for the destination of this leg.
+ Use for coordinate-based destinations. Set latitude and longitude.
+ */
+@property (nonatomic, assign) CLLocationCoordinate2D coordinates;
+
+/**
+ Whether coordinates have been explicitly set.
+ */
+@property (nonatomic, assign, readonly) BOOL hasCoordinates;
+
+/**
+ The arrival radius in meters for coordinate-based destinations.
+ Only used when coordinates are set.
+ */
+@property (nonatomic, assign) NSInteger arrivalRadius;
+
+#pragma mark - Common Properties
+
+/**
+ The stop duration in minutes for this leg.
+ */
+@property (nonatomic, assign) NSInteger stopDuration;
+
+/**
+ An optional set of custom key-value pairs for this leg.
+ */
+@property (nullable, nonatomic, copy) NSDictionary *metadata;
+
+#pragma mark - Initializers
+
+/**
+ Initializes a RadarTripLeg with the specified destination geofence tag and external ID.
+
+ @param destinationGeofenceTag The tag of the destination geofence.
+ @param destinationGeofenceExternalId The external ID of the destination geofence.
+
+ @return A new RadarTripLeg instance.
+ */
+- (instancetype)initWithDestinationGeofenceTag:(NSString *_Nullable)destinationGeofenceTag
+                 destinationGeofenceExternalId:(NSString *_Nullable)destinationGeofenceExternalId;
+
+/**
+ Initializes a RadarTripLeg with the specified destination geofence ID.
+
+ @param destinationGeofenceId The Radar ID of the destination geofence.
+
+ @return A new RadarTripLeg instance.
+ */
+- (instancetype)initWithDestinationGeofenceId:(NSString *_Nonnull)destinationGeofenceId;
+
+/**
+ Initializes a RadarTripLeg with the specified address.
+
+ @param address The address string for the destination.
+
+ @return A new RadarTripLeg instance.
+ */
+- (instancetype)initWithAddress:(NSString *_Nonnull)address;
+
+/**
+ Initializes a RadarTripLeg with the specified coordinates.
+
+ @param coordinates The coordinates for the destination.
+
+ @return A new RadarTripLeg instance.
+ */
+- (instancetype)initWithCoordinates:(CLLocationCoordinate2D)coordinates;
+
+/**
+ Creates a RadarTripLeg from a dictionary representation.
+
+ @param dict The dictionary containing leg data.
+
+ @return A new RadarTripLeg instance, or nil if the dictionary is invalid.
+ */
++ (RadarTripLeg *_Nullable)legFromDictionary:(NSDictionary *_Nullable)dict;
+
+/**
+ Creates an array of RadarTripLeg objects from an array of dictionaries.
+
+ @param array The array of dictionaries containing leg data.
+
+ @return An array of RadarTripLeg instances, or nil if the array is invalid.
+ */
++ (NSArray<RadarTripLeg *> *_Nullable)legsFromArray:(NSArray *_Nullable)array;
+
+/**
+ Converts the leg to a dictionary representation for API serialization.
+
+ @return A dictionary representation of the leg.
+ */
+- (NSDictionary *)dictionaryValue;
+
+/**
+ Converts an array of legs to an array of dictionaries.
+
+ @param legs The array of RadarTripLeg instances.
+
+ @return An array of dictionary representations.
+ */
++ (NSArray<NSDictionary *> *_Nullable)arrayForLegs:(NSArray<RadarTripLeg *> *_Nullable)legs;
+
+/**
+ Returns the string representation of a trip leg status.
+
+ @param status The trip leg status.
+
+ @return The string representation.
+ */
++ (NSString *)stringForStatus:(RadarTripLegStatus)status;
+
+/**
+ Returns the trip leg status for a string representation.
+
+ @param string The string representation.
+
+ @return The trip leg status.
+ */
++ (RadarTripLegStatus)statusForString:(NSString *)string;
+
+/**
+ Returns the string representation of a trip leg destination type.
+
+ @param destinationType The trip leg destination type.
+
+ @return The string representation.
+ */
++ (NSString *)stringForDestinationType:(RadarTripLegDestinationType)destinationType;
+
+/**
+ Returns the trip leg destination type for a string representation.
+
+ @param string The string representation.
+
+ @return The trip leg destination type.
+ */
++ (RadarTripLegDestinationType)destinationTypeForString:(NSString *)string;
+
+@end
+
+NS_ASSUME_NONNULL_END

package/ios/RadarSDK.xcframework/ios-arm64/RadarSDK.framework/Headers/RadarTripOptions.h

@@ -8,6 +8,7 @@
 #import <Foundation/Foundation.h>
 
 #import "RadarRouteMode.h"
+#import "RadarTripLeg.h"
 
 
 NS_ASSUME_NONNULL_BEGIN
@@ -67,6 +68,11 @@ NS_ASSUME_NONNULL_BEGIN
 
 @property (nonatomic, assign) BOOL startTracking;
 
+/**
+ For multi-destination trips, an optional array of trip legs.
+ */
+@property (nullable, nonatomic, copy) NSArray<RadarTripLeg *> *legs;
+
 + (RadarTripOptions *_Nullable)tripOptionsFromDictionary:(NSDictionary *)dict;
 - (NSDictionary *)dictionaryValue;
 

package/ios/RadarSDK.xcframework/ios-arm64/RadarSDK.framework/Headers/RadarTripOrder.h

@@ -88,4 +88,4 @@ typedef NS_ENUM(NSInteger, RadarTripOrderStatus) {
 + (NSArray<RadarTripOrder *> *_Nullable)ordersFromObject:(id _Nonnull)object;
 + (NSArray<NSDictionary *> *_Nullable)arrayForOrders:(NSArray<RadarTripOrder *> *_Nullable)orders;
 
-@end 
+@end 

package/ios/RadarSDK.xcframework/ios-arm64/RadarSDK.framework/Headers/RadarUser.h

@@ -161,4 +161,6 @@ typedef NS_ENUM(NSInteger, RadarActivityType);
 
 @property (assign, nonatomic, readonly) double altitude;
 
+- (instancetype _Nullable)initWithObject:(id _Nonnull)object;
+
 @end