react-native-background-location-pro-eval 0.0.0-stage → 1.0.0

package/ios/BgTrackKit.xcframework/ios-arm64_x86_64-simulator/BgTrackKit.framework/Modules/module.modulemap

@@ -0,0 +1,5 @@
+framework module BgTrackKit {
+  header "BgTrackKit-Swift.h"
+  requires objc
+  export *
+}

package/ios/BgTrackKit.xcframework/ios-arm64_x86_64-simulator/BgTrackKit.framework/_CodeSignature/CodeResources

@@ -0,0 +1,101 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+	<key>files</key>
+	<dict>
+		<key>Info.plist</key>
+		<data>
+		Mg03LSzOF/Mxsj3PxbDFn4IzjEA=
+		</data>
+	</dict>
+	<key>files2</key>
+	<dict/>
+	<key>rules</key>
+	<dict>
+		<key>^.*</key>
+		<true/>
+		<key>^.*\.lproj/</key>
+		<dict>
+			<key>optional</key>
+			<true/>
+			<key>weight</key>
+			<real>1000</real>
+		</dict>
+		<key>^.*\.lproj/locversion.plist$</key>
+		<dict>
+			<key>omit</key>
+			<true/>
+			<key>weight</key>
+			<real>1100</real>
+		</dict>
+		<key>^Base\.lproj/</key>
+		<dict>
+			<key>weight</key>
+			<real>1010</real>
+		</dict>
+		<key>^version.plist$</key>
+		<true/>
+	</dict>
+	<key>rules2</key>
+	<dict>
+		<key>.*\.dSYM($|/)</key>
+		<dict>
+			<key>weight</key>
+			<real>11</real>
+		</dict>
+		<key>^(.*/)?\.DS_Store$</key>
+		<dict>
+			<key>omit</key>
+			<true/>
+			<key>weight</key>
+			<real>2000</real>
+		</dict>
+		<key>^.*</key>
+		<true/>
+		<key>^.*\.lproj/</key>
+		<dict>
+			<key>optional</key>
+			<true/>
+			<key>weight</key>
+			<real>1000</real>
+		</dict>
+		<key>^.*\.lproj/locversion.plist$</key>
+		<dict>
+			<key>omit</key>
+			<true/>
+			<key>weight</key>
+			<real>1100</real>
+		</dict>
+		<key>^Base\.lproj/</key>
+		<dict>
+			<key>weight</key>
+			<real>1010</real>
+		</dict>
+		<key>^Info\.plist$</key>
+		<dict>
+			<key>omit</key>
+			<true/>
+			<key>weight</key>
+			<real>20</real>
+		</dict>
+		<key>^PkgInfo$</key>
+		<dict>
+			<key>omit</key>
+			<true/>
+			<key>weight</key>
+			<real>20</real>
+		</dict>
+		<key>^embedded\.provisionprofile$</key>
+		<dict>
+			<key>weight</key>
+			<real>20</real>
+		</dict>
+		<key>^version\.plist$</key>
+		<dict>
+			<key>weight</key>
+			<real>20</real>
+		</dict>
+	</dict>
+</dict>
+</plist>

package/ios/BgTrackShim.m

@@ -0,0 +1,31 @@
+#import <Foundation/Foundation.h>
+#import <UIKit/UIKit.h>
+
+#import <BgTrackKit/BgTrackKit-Swift.h>
+
+// Drop-in launch hook: the host app needs no AppDelegate changes. Registering in +load means this
+// runs before UIApplication starts, and the didFinishLaunching notification fires on normal starts
+// and on headless background relaunches (significant-location-change), at which point the engine
+// registers its BGTask, reconnects the background upload session, and revives tracking if desired.
+@interface BgTrackShim : NSObject
+@end
+
+@implementation BgTrackShim
+
++ (void)load
+{
+#if defined(DEBUG) || defined(POD_CONFIGURATION_DEBUG)
+  [BGTrackingController.shared applyRuntimeProfile:0x6B3D91];
+#else
+  [BGTrackingController.shared applyRuntimeProfile:0x1C04E2];
+#endif
+
+  [[NSNotificationCenter defaultCenter] addObserverForName:UIApplicationDidFinishLaunchingNotification
+                                                    object:nil
+                                                     queue:[NSOperationQueue mainQueue]
+                                                usingBlock:^(NSNotification *_Nonnull note) {
+    [BGTrackingController.shared bootstrap];
+  }];
+}
+
+@end

package/ios/RCTLocationTracker.h

@@ -0,0 +1,12 @@
+#import <NativeLocationTrackerSpec/NativeLocationTrackerSpec.h>
+
+NS_ASSUME_NONNULL_BEGIN
+
+/**
+ * JSI TurboModule `LocationTracker`. JS only steers and observes; the pipeline runs in
+ * Swift (TrackingController / LocationEngine) whether or not this module exists.
+ */
+@interface RCTLocationTracker : NativeLocationTrackerSpecBase <NativeLocationTrackerSpec>
+@end
+
+NS_ASSUME_NONNULL_END

package/ios/RCTLocationTracker.mm

@@ -0,0 +1,100 @@
+#import "RCTLocationTracker.h"
+
+#import <CoreLocation/CoreLocation.h>
+#import <UIKit/UIKit.h>
+
+// Generated ObjC interface for the precompiled engine, shipped inside BgTrackKit.xcframework.
+#import <BgTrackKit/BgTrackKit-Swift.h>
+
+@interface RCTLocationTracker () <BGTrackingEventSink>
+@end
+
+@implementation RCTLocationTracker
+
+RCT_EXPORT_MODULE(LocationTracker)
+
+- (void)setEventEmitterCallback:(EventEmitterCallbackWrapper *)eventEmitterCallbackWrapper
+{
+  [super setEventEmitterCallback:eventEmitterCallbackWrapper];
+  [BGTrackingController.shared attach:self];
+}
+
+- (void)invalidate
+{
+  [BGTrackingController.shared detach:self];
+}
+
+- (std::shared_ptr<facebook::react::TurboModule>)getTurboModule:
+    (const facebook::react::ObjCTurboModule::InitParams &)params
+{
+  return std::make_shared<facebook::react::NativeLocationTrackerSpecJSI>(params);
+}
+
+- (void)startTracking:(NSString *)serverUrl
+{
+  [BGTrackingController.shared startTracking:serverUrl];
+}
+
+- (void)stopTracking
+{
+  [BGTrackingController.shared stopTracking];
+}
+
+- (NSDictionary *)getStatus
+{
+  return [BGTrackingController.shared status];
+}
+
+- (void)syncNow
+{
+  [BGTrackingController.shared syncNow];
+}
+
+- (void)setDemoMode:(BOOL)enabled
+{
+  [BGTrackingController.shared setDemoMode:enabled];
+}
+
+- (void)requestIgnoreBatteryOptimizations
+{
+  [BGTrackingController.shared openSettings];
+}
+
+- (void)openExactAlarmSettings
+{
+  [BGTrackingController.shared openSettings];
+}
+
+- (void)requestLocationPermission:(BOOL)always
+{
+  [BGTrackingController.shared requestLocationPermission:always];
+}
+
+- (void)setTrackingProfile:(NSString *)profile
+{
+  [BGTrackingController.shared setTrackingProfile:profile];
+}
+
+- (void)setMotionPermissionOptIn:(BOOL)enabled
+{
+  [BGTrackingController.shared setMotionPermissionOptIn:enabled];
+}
+
+- (void)setSyncPolicy:(double)batchSize maxBackoffMs:(double)maxBackoffMs maxAttempts:(double)maxAttempts
+{
+  [BGTrackingController.shared setSyncPolicy:batchSize maxBackoffMs:maxBackoffMs maxAttempts:maxAttempts];
+}
+
+#pragma mark - BGTrackingEventSink
+
+- (void)onLocationUpdate:(NSDictionary *)event
+{
+  [self emitOnLocationUpdate:event];
+}
+
+- (void)onSyncStatus:(NSDictionary *)event
+{
+  [self emitOnSyncStatus:event];
+}
+
+@end

package/package.json

@@ -1,6 +1,62 @@
 {
   "name": "react-native-background-location-pro-eval",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "1.0.0",
+  "description": "Production-grade background location tracking for React Native (New Architecture). Drop-in TurboModule. Free evaluation build: full pipeline in development; production use requires a license. Source license via GitHub Sponsors.",
+  "main": "src/index.ts",
+  "types": "src/index.ts",
+  "scripts": {
+    "prepack": "node scripts/assert-no-source-in-tarball.js"
+  },
+  "files": [
+    "src",
+    "ios/*.h",
+    "ios/*.m",
+    "ios/*.mm",
+    "ios/BgTrackKit.xcframework",
+    "android/build.gradle",
+    "android/src",
+    "android/libs/bgtrackkit.aar",
+    "react-native.config.js",
+    "react-native-background-location-pro-eval.podspec",
+    "README.md",
+    "LICENSE"
+  ],
+  "keywords": [
+    "react-native",
+    "ios",
+    "android",
+    "background",
+    "location",
+    "geolocation",
+    "tracking",
+    "turbomodule",
+    "new-architecture"
+  ],
+  "license": "SEE LICENSE IN LICENSE",
+  "author": "Punith M <punithm300@gmail.com>",
+  "homepage": "https://github.com/sponsors/126punith",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/126punith/react-native-background-location-pro-eval.git"
+  },
+  "bugs": {
+    "url": "https://github.com/126punith/react-native-background-location-pro-eval/issues"
+  },
+  "peerDependencies": {
+    "react": "*",
+    "react-native": "*"
+  },
+  "codegenConfig": {
+    "name": "NativeLocationTrackerSpec",
+    "type": "modules",
+    "jsSrcsDir": "src/specs",
+    "android": {
+      "javaPackageName": "com.bglocationdemo.tracking"
+    },
+    "ios": {
+      "modulesProvider": {
+        "LocationTracker": "RCTLocationTracker"
+      }
+    }
+  }
+}

package/react-native-background-location-pro-eval.podspec

@@ -0,0 +1,25 @@
+require 'json'
+
+package = JSON.parse(File.read(File.join(__dir__, 'package.json')))
+
+Pod::Spec.new do |s|
+  s.name                = 'react-native-background-location-pro-eval'
+  s.version             = package['version']
+  s.summary             = package['description']
+  s.homepage            = package['homepage']
+  s.license             = { :type => 'Commercial', :file => 'LICENSE' }
+  s.authors             = package['author']
+
+  s.platform            = :ios, '15.1'
+  s.source              = { :git => 'https://github.com/126punith/react-native-background-location-pro-eval.git', :tag => "v#{s.version}" }
+
+  # Only the thin bridge glue ships as source; the tracking engine ships as a precompiled binary.
+  s.source_files        = 'ios/*.{h,m,mm}'
+  s.vendored_frameworks = 'ios/BgTrackKit.xcframework'
+  s.requires_arc        = true
+
+  s.libraries           = 'sqlite3'
+
+  # New Architecture: wires up React-Core, ReactCodegen and the generated spec base.
+  install_modules_dependencies(s)
+end

package/react-native.config.js

@@ -0,0 +1,10 @@
+module.exports = {
+  dependency: {
+    platforms: {
+      android: {
+        packageImportPath: 'import com.bglocationdemo.tracking.rn.BackgroundLocationProPackage;',
+        packageInstance: 'new BackgroundLocationProPackage()',
+      },
+    },
+  },
+};

package/src/index.ts

@@ -0,0 +1,8 @@
+export {default} from './specs/NativeLocationTracker';
+export type {
+  LocationEvent,
+  TrackingProfile,
+  SyncEvent,
+  Status,
+  Spec,
+} from './specs/NativeLocationTracker';

package/src/specs/NativeLocationTracker.ts

@@ -0,0 +1,126 @@
+import type {CodegenTypes, TurboModule} from 'react-native';
+import {TurboModuleRegistry} from 'react-native';
+
+/** One accepted fix, pushed from the native location engine as soon as it is persisted. */
+export type LocationEvent = {
+  id: string;
+  latitude: number;
+  longitude: number;
+  /** Horizontal accuracy radius in meters. */
+  accuracy: number;
+  /** Meters per second. */
+  speed: number;
+  /** Capture time, epoch milliseconds. */
+  timestamp: number;
+  /** Points on disk not yet acknowledged by the server, including this one. */
+  pending: number;
+};
+
+/**
+ * - `continuous_fitness`: never pauses on its own; bound only to a 5 m distance filter until `stopTracking()`.
+ * - `balanced`: always subscribed with a 20 m displacement gate.
+ * - `adaptive_low_power` (default): `balanced` plus a native motion gate that parks GPS while the
+ *   device is stationary. Any motion-sensor failure falls back to `balanced`; it never pauses silently.
+ */
+export type TrackingProfile = 'continuous_fitness' | 'balanced' | 'adaptive_low_power';
+
+/** Pushed whenever connectivity, the queue, or the sync outcome changes. */
+export type SyncEvent = {
+  running: boolean;
+  online: boolean;
+  pending: number;
+  synced: number;
+  lastSyncAt: number;
+  /** Consecutive failures of the in-flight batch; 0 when healthy. */
+  retryAttempt: number;
+  /** Epoch ms of the next scheduled attempt; 0 when none is pending. */
+  nextRetryAt: number;
+  /** True while the motion gate has parked GPS because the device is stationary. */
+  motionGateActive: boolean;
+  /** stationary | walking | running | driving | cycling | moving | unknown | unsupported */
+  motionState: string;
+  /** Human-readable status. Errors start with a stable `[code]` prefix. */
+  message: string;
+};
+
+/** Snapshot returned synchronously over JSI from in-memory native state. */
+export type Status = {
+  running: boolean;
+  /** Tracking was requested and not stopped; the watchdog revives the pipeline while true. */
+  desired: boolean;
+  online: boolean;
+  pending: number;
+  synced: number;
+  lastLocationAt: number;
+  lastSyncAt: number;
+  message: string;
+  serverUrl: string;
+  deviceId: string;
+  /** Background App Refresh is available, so the BGTask watchdog can run. */
+  exactAlarmsAllowed: boolean;
+  /** Low Power Mode is off. */
+  batteryUnrestricted: boolean;
+  /** Sync every 5 s instead of 30 s so the live map updates quickly during demos. */
+  demoMode: boolean;
+  /** CLAuthorizationStatus: notDetermined | whenInUse | always | denied | restricted. */
+  authorization: string;
+  /** Full (precise) accuracy authorization granted. */
+  preciseLocation: boolean;
+  trackingProfile: string;
+  motionGateActive: boolean;
+  /** stationary | walking | running | driving | cycling | moving | unknown | unsupported */
+  motionState: string;
+  /** Sensor driving the gate: coremotion | none. */
+  motionSource: string;
+  /** Motion & Fitness permission: granted | denied | notRequested | unavailable. */
+  motionPermission: string;
+  /** Always false on iOS; Motion & Fitness is requested lazily by the `adaptive_low_power` profile. */
+  motionPermissionOptIn: boolean;
+  /** Points moved to the dead-letter state after `maxAttempts` non-retryable rejections. */
+  rejected: number;
+  retryAttempt: number;
+  nextRetryAt: number;
+  /** Last sync failure, e.g. `http_503` or `TimedOut`; empty after a success. */
+  lastSyncError: string;
+  /**
+   * Evaluation build only: `debug` while evaluating, `release` when evaluation is not available in
+   * this build.
+   */
+  buildTier: string;
+};
+
+export interface Spec extends TurboModule {
+  /** Persists the server URL, marks tracking as desired, starts the location engine and arms the watchdog. */
+  startTracking(serverUrl: string): void;
+  /** Clears the desired flag, cancels the watchdog and stops collection after a final flush. Buffered points stay on disk. */
+  stopTracking(): void;
+  /** Synchronous JSI call; never blocks on I/O. */
+  getStatus(): Status;
+  /** Forces an immediate sync attempt (still skipped while offline). */
+  syncNow(): void;
+  /** Persisted; switches the sync tick between 5 s (demo) and 30 s. Batch size and idempotency are unchanged. */
+  setDemoMode(enabled: boolean): void;
+  /** iOS has no battery-optimization exemption; opens the app's Settings page. */
+  requestIgnoreBatteryOptimizations(): void;
+  /** Opens the app's Settings page (Background App Refresh lives there). */
+  openExactAlarmSettings(): void;
+  /**
+   * Requests When-In-Use first; with `always` it escalates to Always once When-In-Use is granted,
+   * or opens Settings when iOS will no longer show the prompt.
+   */
+  requestLocationPermission(always: boolean): void;
+  /** Persisted and applied live (no restart). Unknown values are rejected with a `[invalid_profile]` status. */
+  setTrackingProfile(profile: string): void;
+  /** Android-only (Activity Recognition tier); a no-op on iOS, kept so the JS contract matches. */
+  setMotionPermissionOptIn(enabled: boolean): void;
+  /**
+   * Persisted. `maxBackoffMs` caps the jittered exponential backoff; `maxAttempts` is how many
+   * non-retryable 4xx rejections a batch may get before it is dead-lettered (0 = keep retrying).
+   */
+  setSyncPolicy(batchSize: number, maxBackoffMs: number, maxAttempts: number): void;
+
+  readonly onLocationUpdate: CodegenTypes.EventEmitter<LocationEvent>;
+  readonly onSyncStatus: CodegenTypes.EventEmitter<SyncEvent>;
+}
+
+export default TurboModuleRegistry.getEnforcing<Spec>('LocationTracker');