react-native-pointr 10.8.0 → 10.10.0

package/ios/PTRNativeLibrary.swift

@@ -12,7 +12,24 @@ import React
 class PTRNativeLibrary: RCTEventEmitter, PTREventManagerDelegate {
     
     private var hasListeners = false
-    
+
+    /// Names of the events emitted to JS through the event emitter. JS reads
+    /// them from `PTREvents` in `src/constants/index.ts` and Android declares
+    /// them in `PTRNativeLibrary`'s companion object — the three must match.
+    ///
+    /// The payload keys of these events live in `PTRBridgeKeys.EventPayloadKeys`.
+    enum EventNames {
+        static let onPositionManagerCalculatedLocation = "OnPositionManagerCalculatedLocation"
+        static let onBuildingClicked = "OnBuildingClicked"
+        static let onSiteClicked = "OnSiteClicked"
+        static let onGeofenceEvent = "OnGeofenceEvent"
+        static let onDataManagerStartDataManagementForSite = "OnDataManagerStartDataManagementForSite"
+        static let onDataManagerCompleteAllForSite = "OnDataManagerCompleteAllForSite"
+        static let onDataManagerBeginProcessingDataForSite = "OnDataManagerBeginProcessingDataForSite"
+        static let onDataManagerEndProcessingDataForSite = "OnDataManagerEndProcessingDataForSite"
+        static let onDataManagerReadyForSite = "OnDataManagerReadyForSite"
+    }
+
     // PointrApp functionality moved here
     @objc public weak var eventManagerDelegate: PTREventManagerDelegate?
     @objc public static var shouldRequestPermissionsAtStartup: Bool = true
@@ -78,10 +95,15 @@ class PTRNativeLibrary: RCTEventEmitter, PTREventManagerDelegate {
     
     override func supportedEvents() -> [String]! {
         return [
-            "OnPositionManagerCalculatedLocation",
-            "OnBuildingClicked",
-            "OnSiteClicked",
-            "OnGeofenceEvent",
+            EventNames.onPositionManagerCalculatedLocation,
+            EventNames.onBuildingClicked,
+            EventNames.onSiteClicked,
+            EventNames.onGeofenceEvent,
+            EventNames.onDataManagerStartDataManagementForSite,
+            EventNames.onDataManagerCompleteAllForSite,
+            EventNames.onDataManagerBeginProcessingDataForSite,
+            EventNames.onDataManagerEndProcessingDataForSite,
+            EventNames.onDataManagerReadyForSite,
         ]
     }
     
@@ -242,6 +264,7 @@ class PTRNativeLibrary: RCTEventEmitter, PTREventManagerDelegate {
         if Pointr.shared.state == .running {
             Pointr.shared.positioningManager?.addListener(self)
             Pointr.shared.geofenceManager?.addListener(self)
+            Pointr.shared.dataManager?.addListener(self)
             resolve(nil)
         } else {
             let stateStr = self.getPointrStateStringFromPointrState(state: Pointr.shared.state)
@@ -252,6 +275,7 @@ class PTRNativeLibrary: RCTEventEmitter, PTREventManagerDelegate {
     @objc func stop() {
         Pointr.shared.positioningManager?.removeListener(self)
         Pointr.shared.geofenceManager?.removeListener(self)
+        Pointr.shared.dataManager?.removeListener(self)
         Pointr.shared.stop()
     }
     
@@ -347,6 +371,150 @@ class PTRNativeLibrary: RCTEventEmitter, PTREventManagerDelegate {
         resolve(poisData)
     }
 
+    // MARK: - Data Manager
+
+    @objc(loadDataForSite:shouldRespectCachePolicy:isExternalIdentifier:resolver:rejecter:)
+    func loadDataForSite(_ siteId: String,
+                         shouldRespectCachePolicy: Bool,
+                         isExternalIdentifier: Bool,
+                         resolver resolve: @escaping RCTPromiseResolveBlock,
+                         rejecter reject: @escaping RCTPromiseRejectBlock) {
+        guard let site = resolveSite(siteId, isExternalIdentifier: isExternalIdentifier) else {
+            reject("SITE_NOT_FOUND", "Site not found: \(siteId)", nil)
+            return
+        }
+        Pointr.shared.dataManager?.loadData(forSite: site.internalIdentifier,
+                                            shouldRespectCachePolicy: shouldRespectCachePolicy)
+        resolve(nil)
+    }
+
+    @objc(isSiteContentReady:isExternalIdentifier:resolver:rejecter:)
+    func isSiteContentReady(_ siteId: String,
+                            isExternalIdentifier: Bool,
+                            resolver resolve: @escaping RCTPromiseResolveBlock,
+                            rejecter reject: @escaping RCTPromiseRejectBlock) {
+        guard let site = resolveSite(siteId, isExternalIdentifier: isExternalIdentifier) else {
+            reject("SITE_NOT_FOUND", "Site not found: \(siteId)", nil)
+            return
+        }
+        let ready = Pointr.shared.dataManager?.isContentReady(forSite: site.internalIdentifier) ?? false
+        resolve(ready)
+    }
+
+    private func resolveSite(_ siteId: String, isExternalIdentifier: Bool) -> PTRSite? {
+        guard let siteManager = Pointr.shared.siteManager else { return nil }
+        return isExternalIdentifier
+            ? siteManager.site(withExternalIdentifier: siteId)
+            : siteManager.site(withInternalIdentifier: siteId)
+    }
+
+    // MARK: - Site Manager
+
+    @objc(getSite:isExternalIdentifier:resolver:rejecter:)
+    func getSite(_ siteId: String,
+                 isExternalIdentifier: Bool,
+                 resolver resolve: @escaping RCTPromiseResolveBlock,
+                 rejecter reject: @escaping RCTPromiseRejectBlock) {
+        if let site = resolveSite(siteId, isExternalIdentifier: isExternalIdentifier) {
+            resolve(site.dict)
+        } else {
+            resolve(NSNull())
+        }
+    }
+
+    @objc(getSiteBuildings:isExternalIdentifier:resolver:rejecter:)
+    func getSiteBuildings(_ siteId: String,
+                          isExternalIdentifier: Bool,
+                          resolver resolve: @escaping RCTPromiseResolveBlock,
+                          rejecter reject: @escaping RCTPromiseRejectBlock) {
+        guard let site = resolveSite(siteId, isExternalIdentifier: isExternalIdentifier) else {
+            reject("SITE_NOT_FOUND", "Site not found: \(siteId)", nil)
+            return
+        }
+        let buildings = Pointr.shared.siteManager?.buildings(forSiteId: site.internalIdentifier) ?? []
+        resolve(buildings.map { $0.dict })
+    }
+
+    @objc(getBuilding:buildingId:isExternalIdentifier:resolver:rejecter:)
+    func getBuilding(_ siteId: String,
+                     buildingId: String,
+                     isExternalIdentifier: Bool,
+                     resolver resolve: @escaping RCTPromiseResolveBlock,
+                     rejecter reject: @escaping RCTPromiseRejectBlock) {
+        guard let siteManager = Pointr.shared.siteManager else {
+            reject("NOT_READY", "Site manager is not available", nil)
+            return
+        }
+        // Unknown site resolves null rather than rejecting, matching Android's
+        // getBuilding, which returns null for a site it cannot find.
+        guard let site = resolveSite(siteId, isExternalIdentifier: isExternalIdentifier) else {
+            resolve(NSNull())
+            return
+        }
+        // PointrKit's sync accessors search globally, so the result has to be
+        // checked against the requested site — Android scopes the lookup itself.
+        // The site-scoped async variants are not used here: they resolve nil
+        // until the site's content is ready, which would make this return null
+        // for buildings that `getSiteBuildings` already returns.
+        let building = isExternalIdentifier
+            ? siteManager.building(withExternalIdentifier: buildingId)
+            : siteManager.building(withInternalIdentifier: buildingId)
+        if let building = building,
+           building.site.internalIdentifier == site.internalIdentifier {
+            resolve(building.dict)
+        } else {
+            resolve(NSNull())
+        }
+    }
+
+    @objc(getLevelByExternalIdentifier:levelExternalIdentifier:resolver:rejecter:)
+    func getLevelByExternalIdentifier(_ buildingExternalIdentifier: String,
+                                      levelExternalIdentifier: String,
+                                      resolver resolve: @escaping RCTPromiseResolveBlock,
+                                      rejecter reject: @escaping RCTPromiseRejectBlock) {
+        // PointrKit takes (level, building); this bridge and the Android SDK take
+        // (building, level). Keep the labels explicit so the order can't drift.
+        let level = Pointr.shared.siteManager?.level(
+            withExternalIdentifier: levelExternalIdentifier,
+            buildingExternalIdentifier: buildingExternalIdentifier
+        )
+        if let level = level {
+            typealias ModelKeys = PTRBridgeKeys.ModelKeys
+            resolve([
+                ModelKeys.identifier: level.identifier,
+                ModelKeys.externalIdentifier: level.externalIdentifier,
+                ModelKeys.name: level.name,
+                ModelKeys.index: level.index
+            ])
+        } else {
+            resolve(NSNull())
+        }
+    }
+
+    @objc(getMapUrl:isExternalIdentifier:resolver:rejecter:)
+    func getMapUrl(_ siteId: String,
+                   isExternalIdentifier: Bool,
+                   resolver resolve: @escaping RCTPromiseResolveBlock,
+                   rejecter reject: @escaping RCTPromiseRejectBlock) {
+        guard let site = resolveSite(siteId, isExternalIdentifier: isExternalIdentifier) else {
+            reject("SITE_NOT_FOUND", "Site not found: \(siteId)", nil)
+            return
+        }
+        Pointr.shared.siteManager?.mapUrl(forSite: site.internalIdentifier) { mapUrl, error in
+            if let error = error {
+                reject("ERROR", error, nil)
+            } else {
+                resolve(mapUrl?.absoluteString)
+            }
+        }
+    }
+
+    @objc(getStyleJsonUrl:rejecter:)
+    func getStyleJsonUrl(_ resolve: @escaping RCTPromiseResolveBlock,
+                         rejecter reject: @escaping RCTPromiseRejectBlock) {
+        resolve(Pointr.shared.siteManager?.styleJsonURL()?.absoluteString)
+    }
+
     // MARK: - Sites & Buildings
 
     @objc
@@ -494,22 +662,22 @@ class PTRNativeLibrary: RCTEventEmitter, PTREventManagerDelegate {
     
     func onPositionManagerCalculatedLocation(location: [String : Any]) {
         guard hasListeners else { return }
-        sendEvent(withName: "OnPositionManagerCalculatedLocation", body: location)
+        sendEvent(withName: EventNames.onPositionManagerCalculatedLocation, body: location)
     }
     
     func onGeofenceEvent(_ geofenceEvent: [String: Any]) {
         guard hasListeners else { return }
-        sendEvent(withName: "OnGeofenceEvent", body: geofenceEvent)
+        sendEvent(withName: EventNames.onGeofenceEvent, body: geofenceEvent)
     }
     
     func onBuildingClicked(_ building: [String : Any]) {
         guard hasListeners else { return }
-        sendEvent(withName: "OnBuildingClicked", body: building)
+        sendEvent(withName: EventNames.onBuildingClicked, body: building)
     }
     
     func onSiteClicked(_ site: [String : Any]) {
         guard hasListeners else { return }
-        sendEvent(withName: "OnSiteClicked", body: site)
+        sendEvent(withName: EventNames.onSiteClicked, body: site)
     }
 }
 
@@ -526,6 +694,91 @@ extension PTRNativeLibrary: PTRGeofenceManagerDelegate {
     }
 }
 
+// MARK: - PTRDataManagerDelegate
+extension PTRNativeLibrary: PTRDataManagerDelegate {
+    private typealias Keys = PTRBridgeKeys.EventPayloadKeys
+
+    @objc func onDataManagerStartDataManagement(for site: PTRSite, dataFromOnline isOnlineData: Bool) {
+        guard hasListeners else { return }
+        sendEvent(withName: EventNames.onDataManagerStartDataManagementForSite, body: [
+            Keys.site: site.dict,
+            Keys.isOnlineData: isOnlineData,
+        ])
+    }
+
+    @objc func onDataManagerCompleteAll(for site: PTRSite,
+                                        isSuccessful: Bool,
+                                        dataFromOnline isOnlineData: Bool,
+                                        errorMessages: [NSNumber: String]) {
+        guard hasListeners else { return }
+        sendEvent(withName: EventNames.onDataManagerCompleteAllForSite, body: [
+            Keys.site: site.dict,
+            Keys.isSuccessful: isSuccessful,
+            Keys.isOnlineData: isOnlineData,
+            Keys.errors: Array(errorMessages.values),
+        ])
+    }
+
+    @objc func onDataManagerBeginProcessingData(for site: PTRSite,
+                                                dataType: PTRDataType,
+                                                dataFromOnline isOnlineData: Bool) {
+        guard hasListeners else { return }
+        sendEvent(withName: EventNames.onDataManagerBeginProcessingDataForSite, body: [
+            Keys.site: site.dict,
+            Keys.dataType: dataTypeDict(dataType),
+            Keys.isOnlineData: isOnlineData,
+        ])
+    }
+
+    @objc func onDataManagerEndProcessingData(for site: PTRSite,
+                                              dataType: PTRDataType,
+                                              dataFromOnline isOnlineData: Bool,
+                                              isSuccessful: Bool,
+                                              errorMessages: [String]) {
+        guard hasListeners else { return }
+        sendEvent(withName: EventNames.onDataManagerEndProcessingDataForSite, body: [
+            Keys.site: site.dict,
+            Keys.dataType: dataTypeDict(dataType),
+            Keys.isOnlineData: isOnlineData,
+            Keys.isSuccessful: isSuccessful,
+            Keys.errors: errorMessages,
+        ])
+    }
+
+    @objc func onDataManagerReady(for site: PTRSite) {
+        guard hasListeners else { return }
+        sendEvent(withName: EventNames.onDataManagerReadyForSite, body: [
+            Keys.site: site.dict,
+        ])
+    }
+
+    private func dataTypeDict(_ dataType: PTRDataType) -> [String: Any] {
+        return [
+            Keys.dataTypeValue: dataType.rawValue,
+            Keys.dataTypeName: dataTypeName(dataType),
+        ]
+    }
+
+    private func dataTypeName(_ dataType: PTRDataType) -> String {
+        switch dataType {
+        case .poi: return "Poi"
+        case .beacon: return "Beacon"
+        case .obstacle: return "Obstacle"
+        case .configuration: return "Config"
+        case .graph: return "Graph"
+        case .versions: return "Versions"
+        case .geofence: return "Geofence"
+        case .sites: return "Sites"
+        case .featureType: return "FeatureType"
+        case .beaconUuid: return "BeaconUuid"
+        case .client: return "Client"
+        case .buildings: return "Buildings"
+        case .mapContent: return "MapContent"
+        default: return "Unknown"
+        }
+    }
+}
+
 // MARK: - PTRExitButtonEventsListener
 extension PTRNativeLibrary: PTRExitButtonEventsListener {
     func exitButtonDidTap() {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "react-native-pointr",
-  "version": "10.8.0",
+  "version": "10.10.0",
   "description": "Pointr React-Native Module",
   "main": "src/index",
   "files": [

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.8.0'
+  s.dependency 'PointrKit', '10.10.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

@@ -36,10 +36,39 @@ export interface Spec extends TurboModule {
   // ─── Config ─────────────────────────────────────────────────────────────────
   setPointrMapWidgetConfiguration(configJson: string): void;
 
+  // ─── Data Manager ─────────────────────────────────────────────────────────────
+  loadDataForSite(
+    siteId: string,
+    shouldRespectCachePolicy: boolean,
+    isExternalIdentifier: boolean
+  ): Promise<void>;
+  isSiteContentReady(
+    siteId: string,
+    isExternalIdentifier: boolean
+  ): Promise<boolean>;
+
   // ─── POIs ───────────────────────────────────────────────────────────────────
   getPois(siteId: string): Promise<Object[]>;
   searchPois(siteId: string, query: string): Promise<Object[]>;
 
+  // ─── Site Manager ─────────────────────────────────────────────────────────────
+  getSite(siteId: string, isExternalIdentifier: boolean): Promise<Object | null>;
+  getSiteBuildings(
+    siteId: string,
+    isExternalIdentifier: boolean
+  ): Promise<Object[]>;
+  getBuilding(
+    siteId: string,
+    buildingId: string,
+    isExternalIdentifier: boolean
+  ): Promise<Object | null>;
+  getLevelByExternalIdentifier(
+    buildingExternalIdentifier: string,
+    levelExternalIdentifier: string
+  ): Promise<Object | null>;
+  getMapUrl(siteId: string, isExternalIdentifier: boolean): Promise<string | null>;
+  getStyleJsonUrl(): Promise<string | null>;
+
   // ─── Sites & Buildings ──────────────────────────────────────────────────────
   getSites(): Promise<Object[]>;
   getBuildings(siteId: string): Promise<Object[]>;

package/src/api/PointrSdk.ts

@@ -8,8 +8,15 @@ 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 type { PTRSite, PTRBuilding, PTRLevel } from '../types/PTRSite';
+import type {
+  PTRGeofence,
+  PTRDataManagerStartEvent,
+  PTRDataManagerCompleteAllEvent,
+  PTRDataManagerBeginProcessingEvent,
+  PTRDataManagerEndProcessingEvent,
+  PTRDataManagerReadyEvent,
+} from '../types/events';
 import { PTRState, PTRLogLevel, PTRErrorMessages, PTREvents } from '../constants';
 
 const LINKING_ERROR =
@@ -172,6 +179,45 @@ export class PointrSdk {
     return this.eventEmitter.addListener(PTREvents.ON_GEOFENCE_EVENT, callback);
   }
 
+  // ─── Data manager events ─────────────────────────────────────────────────────
+
+  /** Subscribe to data-management-start events. */
+  public onDataManagerStart(callback: (event: PTRDataManagerStartEvent) => void) {
+    return this.eventEmitter.addListener(PTREvents.ON_DATA_MANAGER_START, callback);
+  }
+
+  /** Subscribe to data-management-complete-all events. */
+  public onDataManagerCompleteAll(
+    callback: (event: PTRDataManagerCompleteAllEvent) => void
+  ) {
+    return this.eventEmitter.addListener(PTREvents.ON_DATA_MANAGER_COMPLETE_ALL, callback);
+  }
+
+  /** Subscribe to begin-processing events for a specific data type. */
+  public onDataManagerBeginProcessing(
+    callback: (event: PTRDataManagerBeginProcessingEvent) => void
+  ) {
+    return this.eventEmitter.addListener(
+      PTREvents.ON_DATA_MANAGER_BEGIN_PROCESSING,
+      callback
+    );
+  }
+
+  /** Subscribe to end-processing events for a specific data type. */
+  public onDataManagerEndProcessing(
+    callback: (event: PTRDataManagerEndProcessingEvent) => void
+  ) {
+    return this.eventEmitter.addListener(
+      PTREvents.ON_DATA_MANAGER_END_PROCESSING,
+      callback
+    );
+  }
+
+  /** Subscribe to site-ready events (all data available to display a site). */
+  public onDataManagerReady(callback: (event: PTRDataManagerReadyEvent) => void) {
+    return this.eventEmitter.addListener(PTREvents.ON_DATA_MANAGER_READY, callback);
+  }
+
   // ─── Map widget ────────────────────────────────────────────────────────────
 
   /**
@@ -208,6 +254,42 @@ export class PointrSdk {
     return PTRNativeLibrary.getGeofences(siteId);
   }
 
+  // ─── Data Manager ────────────────────────────────────────────────────────────
+
+  /**
+   * Start data management for a site if the data is not already present.
+   * @param siteId - Site identifier
+   * @param shouldRespectCachePolicy - When `true` (default), waits until the
+   * cache expires if data is already present. When `false`, ignores the internal
+   * cache and triggers a data update immediately.
+   * @param isExternalIdentifier - When `false` (default), `siteId` is the site's
+   * internal identifier. When `true`, it is the external identifier.
+   */
+  public loadDataForSite(
+    siteId: string,
+    shouldRespectCachePolicy: boolean = true,
+    isExternalIdentifier: boolean = false
+  ): Promise<void> {
+    return PTRNativeLibrary.loadDataForSite(
+      siteId,
+      shouldRespectCachePolicy,
+      isExternalIdentifier
+    );
+  }
+
+  /**
+   * Whether all data is ready for use for the given site.
+   * @param siteId - Site identifier
+   * @param isExternalIdentifier - When `false` (default), `siteId` is the site's
+   * internal identifier. When `true`, it is the external identifier.
+   */
+  public isSiteContentReady(
+    siteId: string,
+    isExternalIdentifier: boolean = false
+  ): Promise<boolean> {
+    return PTRNativeLibrary.isSiteContentReady(siteId, isExternalIdentifier);
+  }
+
   // ─── POIs ──────────────────────────────────────────────────────────────────
 
   /**
@@ -256,6 +338,85 @@ export class PointrSdk {
     return PTRNativeLibrary.getClientName();
   }
 
+  // ─── Site Manager ──────────────────────────────────────────────────────────────
+
+  /**
+   * Get a single site by its identifier.
+   * @param siteId - Site identifier
+   * @param isExternalIdentifier - When `false` (default), `siteId` is the
+   * internal identifier; when `true`, it is the external identifier.
+   */
+  public getSite(
+    siteId: string,
+    isExternalIdentifier: boolean = false
+  ): Promise<PTRSite | null> {
+    return PTRNativeLibrary.getSite(siteId, isExternalIdentifier);
+  }
+
+  /**
+   * Get all buildings for a site, resolving the site by internal or external id.
+   * @param siteId - Site identifier
+   * @param isExternalIdentifier - When `false` (default), `siteId` is the
+   * internal identifier; when `true`, it is the external identifier.
+   */
+  public getSiteBuildings(
+    siteId: string,
+    isExternalIdentifier: boolean = false
+  ): Promise<PTRBuilding[]> {
+    return PTRNativeLibrary.getSiteBuildings(siteId, isExternalIdentifier);
+  }
+
+  /**
+   * Get a single building within a site by its identifier.
+   * @param siteId - Site identifier
+   * @param buildingId - Building identifier
+   * @param isExternalIdentifier - When `false` (default), both ids are internal;
+   * when `true`, both are external.
+   */
+  public getBuilding(
+    siteId: string,
+    buildingId: string,
+    isExternalIdentifier: boolean = false
+  ): Promise<PTRBuilding | null> {
+    return PTRNativeLibrary.getBuilding(siteId, buildingId, isExternalIdentifier);
+  }
+
+  /**
+   * Get a level by its external identifier within a building.
+   * Resolves with the level or null if not found.
+   * Level ids are only unique within a building, so the building scopes the
+   * lookup. Both SDKs expose this by external identifier only.
+   * @param buildingExternalIdentifier - External identifier of the building
+   * @param levelExternalIdentifier - External identifier of the level
+   */
+  public getLevelByExternalIdentifier(
+    buildingExternalIdentifier: string,
+    levelExternalIdentifier: string
+  ): Promise<PTRLevel | null> {
+    return PTRNativeLibrary.getLevelByExternalIdentifier(
+      buildingExternalIdentifier,
+      levelExternalIdentifier
+    );
+  }
+
+  /**
+   * Get the map data URL for a site.
+   * @param siteId - Site identifier
+   * @param isExternalIdentifier - When `false` (default), `siteId` is the
+   * internal identifier; when `true`, it is the external identifier.
+   */
+  public getMapUrl(
+    siteId: string,
+    isExternalIdentifier: boolean = false
+  ): Promise<string | null> {
+    return PTRNativeLibrary.getMapUrl(siteId, isExternalIdentifier);
+  }
+
+  /** Get the URL for the map style JSON, or null if unavailable. */
+  public getStyleJsonUrl(): Promise<string | null> {
+    return PTRNativeLibrary.getStyleJsonUrl();
+  }
+
   // ─── Wayfinding ──────────────────────────────────────────────────────────────
 
   /**

package/src/constants/bridgeKeys.ts

@@ -1,7 +1,8 @@
 /**
- * Every string that crosses the JS <-> native boundary when an action is sent
- * to the map widget: action type discriminators, `action` / `sdkConfig` payload
- * keys and view-manager command names.
+ * Every string that crosses the JS <-> native boundary: action type
+ * discriminators, `action` / `sdkConfig` payload keys and view-manager command
+ * names on the JS -> native path, plus the payload keys of the events native
+ * emits back to JS.
  *
  * Nothing here may be hard-coded anywhere else — a key renamed on one side only
  * fails silently (the native side reads an empty string), so all three sides
@@ -125,3 +126,50 @@ export const PTRCommandNames = {
 
 export type PTRCommandName =
   (typeof PTRCommandNames)[keyof typeof PTRCommandNames];
+
+/**
+ * Field names of the event payloads native emits to JS through the event
+ * emitter. Native writes them, JS reads them back through the typed interfaces
+ * in `src/types/events.ts` — the interface field names must match these values.
+ *
+ * Event *names* are not listed here: they live in {@link PTREvents} on the JS
+ * side, in `PTRNativeLibrary`'s companion object on Android and in
+ * `PTRNativeLibrary.EventNames` on iOS.
+ */
+export const PTREventPayloadKeys = {
+  /** Site the event refers to, serialized by {@link PTRModelKeys} */
+  SITE: 'site',
+  /** Whether the data came from the server (online) or a local bundle */
+  IS_ONLINE_DATA: 'isOnlineData',
+  /** Whether the reported operation succeeded */
+  IS_SUCCESSFUL: 'isSuccessful',
+  /** Error messages collected during the operation */
+  ERRORS: 'errors',
+  /** Data type being processed */
+  DATA_TYPE: 'dataType',
+  /** Numeric value of `dataType` */
+  DATA_TYPE_VALUE: 'value',
+  /** Human-readable name of `dataType` */
+  DATA_TYPE_NAME: 'name',
+} as const;
+
+export type PTREventPayloadKey =
+  (typeof PTREventPayloadKeys)[keyof typeof PTREventPayloadKeys];
+
+/**
+ * Field names shared by the site, building and level objects native serializes
+ * for JS — both as promise results and inside event payloads. They match the
+ * interfaces in `src/types/PTRSite.ts`.
+ */
+export const PTRModelKeys = {
+  /** Internal identifier */
+  IDENTIFIER: 'identifier',
+  /** External (customer-facing) identifier */
+  EXTERNAL_IDENTIFIER: 'externalIdentifier',
+  /** Human-readable name */
+  NAME: 'name',
+  /** Zero-based level index */
+  INDEX: 'index',
+} as const;
+
+export type PTRModelKey = (typeof PTRModelKeys)[keyof typeof PTRModelKeys];

package/src/constants/index.ts

@@ -11,11 +11,15 @@ export {
   PTRActionParamKeys,
   PTRSdkConfigKeys,
   PTRCommandNames,
+  PTREventPayloadKeys,
+  PTRModelKeys,
 } from './bridgeKeys';
 export type {
   PTRActionParamKey,
   PTRSdkConfigKey,
   PTRCommandName,
+  PTREventPayloadKey,
+  PTRModelKey,
 } from './bridgeKeys';
 
 /**
@@ -86,6 +90,16 @@ export const PTREvents = {
   ON_WAYFINDING_EVENT: 'onWayfindingEvent',
   /** Fired when map widget finishes loading */
   ON_MAP_WIDGET_DID_END_LOADING: 'onMapWidgetDidEndLoading',
+  /** Fired when the data manager starts data management for a site */
+  ON_DATA_MANAGER_START: 'OnDataManagerStartDataManagementForSite',
+  /** Fired when the data manager completes all processing for a site */
+  ON_DATA_MANAGER_COMPLETE_ALL: 'OnDataManagerCompleteAllForSite',
+  /** Fired when the data manager begins processing a specific data type */
+  ON_DATA_MANAGER_BEGIN_PROCESSING: 'OnDataManagerBeginProcessingDataForSite',
+  /** Fired when the data manager ends processing a specific data type */
+  ON_DATA_MANAGER_END_PROCESSING: 'OnDataManagerEndProcessingDataForSite',
+  /** Fired when all data needed to display a site is available */
+  ON_DATA_MANAGER_READY: 'OnDataManagerReadyForSite',
 } as const;
 
 /**