therms-device-tracker 1.0.0-rc.1

package/android/src/main/java/expo/modules/thermsdevicetracker/ThermsDeviceTrackerModuleSharedObject.kt

@@ -0,0 +1,23 @@
+package expo.modules.thermsdevicetracker
+
+import expo.modules.kotlin.AppContext
+import expo.modules.kotlin.sharedobjects.SharedObject
+
+/**
+ * Legacy + compatibility placeholder only.
+ * Real ThermsTracker live state handle + Class registration lives inside ThermsDeviceTrackerModule.kt.
+ * This class is not registered/used by current implementation.
+ * Consumers should import via JS: useThermsTracker from 'therms-device-tracker'.
+ */
+class ThermsDeviceTrackerModuleSharedObject(appContext: AppContext) : SharedObject(appContext) {
+  // Unused legacy field retained only for historical/compat reasons.
+  @Deprecated("Legacy placeholder; not used. ThermsTracker proxies module state directly.")
+  var count: Int = 0
+
+  override fun sharedObjectDidRelease() {
+    super.sharedObjectDidRelease()
+  }
+}
+
+// typealias removed to avoid package-level redeclaration conflict with ThermsTracker class defined in ThermsDeviceTrackerModule.kt
+// (legacy compatibility placeholder only)

package/android/src/main/java/expo/modules/thermsdevicetracker/ThermsLocationService.kt

@@ -0,0 +1,129 @@
+package expo.modules.thermsdevicetracker
+
+import android.app.Notification
+import android.app.NotificationChannel
+import android.app.NotificationManager
+import android.app.PendingIntent
+import android.app.Service
+import android.content.Context
+import android.content.Intent
+import android.os.Build
+import android.os.IBinder
+import android.os.Looper
+import androidx.core.app.NotificationCompat
+import com.google.android.gms.location.*
+
+/**
+ * Foreground service used for background location + activity tracking.
+ * Started by ThermsDeviceTrackerModule when enableBackground = true.
+ */
+class ThermsLocationService : Service() {
+
+  private lateinit var fusedClient: FusedLocationProviderClient
+  private var locationCallback: LocationCallback? = null
+
+  companion object {
+    const val CHANNEL_ID = "therms_tracking_channel"
+    const val NOTIFICATION_ID = 4242
+    const val ACTION_START = "expo.modules.thermsdevicetracker.START_TRACKING"
+    const val ACTION_STOP = "expo.modules.thermsdevicetracker.STOP_TRACKING"
+
+    // For notifying the JS module (broadcast based)
+    const val BROADCAST_ACTION = "expo.modules.thermsdevicetracker.LOCATION_UPDATE"
+    const val EXTRA_LAT = "lat"
+    const val EXTRA_LON = "lon"
+    const val EXTRA_ACCURACY = "accuracy"
+    const val EXTRA_SPEED = "speed"
+    const val EXTRA_TIMESTAMP = "ts"
+  }
+
+  override fun onCreate() {
+    super.onCreate()
+    fusedClient = LocationServices.getFusedLocationProviderClient(this)
+  }
+
+  override fun onStartCommand(intent: Intent?, flags: Int, startId: Int): Int {
+    when (intent?.action) {
+      ACTION_STOP -> {
+        stopTracking()
+        stopSelf()
+        return START_NOT_STICKY
+      }
+      else -> startTracking()
+    }
+    return START_STICKY
+  }
+
+  private fun startTracking() {
+    startForeground(NOTIFICATION_ID, createNotification())
+
+    val request = LocationRequest.Builder(Priority.PRIORITY_BALANCED_POWER_ACCURACY, 10000L)
+      .setMinUpdateDistanceMeters(5f)
+      .build()
+
+    locationCallback = object : LocationCallback() {
+      override fun onLocationResult(result: LocationResult) {
+        result.lastLocation?.let { loc ->
+          val i = Intent(BROADCAST_ACTION).apply {
+            putExtra(EXTRA_LAT, loc.latitude)
+            putExtra(EXTRA_LON, loc.longitude)
+            putExtra(EXTRA_ACCURACY, if (loc.hasAccuracy()) loc.accuracy else -1f)
+            putExtra(EXTRA_SPEED, if (loc.hasSpeed()) loc.speed else -1f)
+            putExtra(EXTRA_TIMESTAMP, loc.time)
+          }
+          sendBroadcast(i)
+        }
+      }
+    }
+
+    try {
+      fusedClient.requestLocationUpdates(request, locationCallback!!, Looper.getMainLooper())
+    } catch (e: SecurityException) {
+      // permission lost
+    }
+  }
+
+  private fun stopTracking() {
+    locationCallback?.let { fusedClient.removeLocationUpdates(it) }
+    locationCallback = null
+    if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.N) {
+      stopForeground(STOP_FOREGROUND_REMOVE)
+    } else {
+      @Suppress("DEPRECATION")
+      stopForeground(true)
+    }
+  }
+
+  private fun createNotification(): Notification {
+    val manager = getSystemService(Context.NOTIFICATION_SERVICE) as NotificationManager
+    if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.O) {
+      val channel = NotificationChannel(
+        CHANNEL_ID,
+        "THERMS Tracking",
+        NotificationManager.IMPORTANCE_LOW
+      )
+      manager.createNotificationChannel(channel)
+    }
+
+    val notificationIntent = packageManager.getLaunchIntentForPackage(packageName)
+    val pending = PendingIntent.getActivity(
+      this, 0, notificationIntent,
+      PendingIntent.FLAG_IMMUTABLE or PendingIntent.FLAG_UPDATE_CURRENT
+    )
+
+    return NotificationCompat.Builder(this, CHANNEL_ID)
+      .setContentTitle("THERMS Tracking")
+      .setContentText("Tracking your location and activity")
+      .setSmallIcon(android.R.drawable.ic_menu_mylocation)
+      .setContentIntent(pending)
+      .setOngoing(true)
+      .build()
+  }
+
+  override fun onBind(intent: Intent?): IBinder? = null
+
+  override fun onDestroy() {
+    stopTracking()
+    super.onDestroy()
+  }
+}

package/app.plugin.js

@@ -0,0 +1 @@
+module.exports = require('./build/plugin').default;

package/build/DeviceSettings.d.ts

@@ -0,0 +1,14 @@
+/**
+ * DeviceSettings - handles OS-level device settings (battery optimization, etc.)
+ * Directly inspired by the reference library's DeviceSettings module.
+ *
+ * This provides a place to surface power-saving warnings, request ignoring battery optimizations, etc.
+ */
+export declare class DeviceSettings {
+    isIgnoringBatteryOptimizations(): Promise<boolean>;
+    requestIgnoreBatteryOptimizations(): Promise<void>;
+    getDeviceInfo(): Promise<any>;
+}
+export declare const deviceSettings: DeviceSettings;
+export default deviceSettings;
+//# sourceMappingURL=DeviceSettings.d.ts.map

package/build/DeviceSettings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DeviceSettings.d.ts","sourceRoot":"","sources":["../src/DeviceSettings.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,qBAAa,cAAc;IACnB,8BAA8B,IAAI,OAAO,CAAC,OAAO,CAAC;IAMlD,iCAAiC,IAAI,OAAO,CAAC,IAAI,CAAC;IAOlD,aAAa,IAAI,OAAO,CAAC,GAAG,CAAC;CAIpC;AAED,eAAO,MAAM,cAAc,gBAAuB,CAAC;AAEnD,eAAe,cAAc,CAAC"}

package/build/DeviceSettings.js

@@ -0,0 +1,24 @@
+/**
+ * DeviceSettings - handles OS-level device settings (battery optimization, etc.)
+ * Directly inspired by the reference library's DeviceSettings module.
+ *
+ * This provides a place to surface power-saving warnings, request ignoring battery optimizations, etc.
+ */
+export class DeviceSettings {
+    async isIgnoringBatteryOptimizations() {
+        // On Android this would call native. On iOS usually not relevant.
+        // For now, stub.
+        return true;
+    }
+    async requestIgnoreBatteryOptimizations() {
+        console.warn('[ThermsDeviceTracker] requestIgnoreBatteryOptimizations is a no-op on this platform or needs native implementation.');
+        // TODO: implement via native module when adding full DeviceSettings support
+    }
+    async getDeviceInfo() {
+        // Could delegate to native
+        return { platform: 'unknown' };
+    }
+}
+export const deviceSettings = new DeviceSettings();
+export default deviceSettings;
+//# sourceMappingURL=DeviceSettings.js.map

package/build/DeviceSettings.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"DeviceSettings.js","sourceRoot":"","sources":["../src/DeviceSettings.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,OAAO,cAAc;IACzB,KAAK,CAAC,8BAA8B;QAClC,kEAAkE;QAClE,iBAAiB;QACjB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,KAAK,CAAC,iCAAiC;QACrC,OAAO,CAAC,IAAI,CACV,qHAAqH,CACtH,CAAC;QACF,4EAA4E;IAC9E,CAAC;IAED,KAAK,CAAC,aAAa;QACjB,2BAA2B;QAC3B,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,CAAC;IACjC,CAAC;CACF;AAED,MAAM,CAAC,MAAM,cAAc,GAAG,IAAI,cAAc,EAAE,CAAC;AAEnD,eAAe,cAAc,CAAC","sourcesContent":["/**\n * DeviceSettings - handles OS-level device settings (battery optimization, etc.)\n * Directly inspired by the reference library's DeviceSettings module.\n *\n * This provides a place to surface power-saving warnings, request ignoring battery optimizations, etc.\n */\n\nexport class DeviceSettings {\n  async isIgnoringBatteryOptimizations(): Promise<boolean> {\n    // On Android this would call native. On iOS usually not relevant.\n    // For now, stub.\n    return true;\n  }\n\n  async requestIgnoreBatteryOptimizations(): Promise<void> {\n    console.warn(\n      '[ThermsDeviceTracker] requestIgnoreBatteryOptimizations is a no-op on this platform or needs native implementation.'\n    );\n    // TODO: implement via native module when adding full DeviceSettings support\n  }\n\n  async getDeviceInfo(): Promise<any> {\n    // Could delegate to native\n    return { platform: 'unknown' };\n  }\n}\n\nexport const deviceSettings = new DeviceSettings();\n\nexport default deviceSettings;\n"]}

package/build/Logger.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Logger - dedicated cross-cutting concern.
+ * Inspired by the rich logger in react-native-background-geolocation.
+ */
+export declare const Logger: {
+    error(msg: string, ...args: any[]): void;
+    warn(msg: string, ...args: any[]): void;
+    info(msg: string, ...args: any[]): void;
+    debug(msg: string, ...args: any[]): void;
+    verbose(msg: string, ...args: any[]): void;
+};
+export default Logger;
+//# sourceMappingURL=Logger.d.ts.map

package/build/Logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Logger.d.ts","sourceRoot":"","sources":["../src/Logger.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,eAAO,MAAM,MAAM;eACN,MAAM,WAAW,GAAG,EAAE;cAIvB,MAAM,WAAW,GAAG,EAAE;cAGtB,MAAM,WAAW,GAAG,EAAE;eAGrB,MAAM,WAAW,GAAG,EAAE;iBAGpB,MAAM,WAAW,GAAG,EAAE;CAGpC,CAAC;AAEF,eAAe,MAAM,CAAC"}

package/build/Logger.js

@@ -0,0 +1,27 @@
+/**
+ * Logger - dedicated cross-cutting concern.
+ * Inspired by the rich logger in react-native-background-geolocation.
+ */
+const TAG = 'ThermsDeviceTracker';
+export const Logger = {
+    error(msg, ...args) {
+        console.error(`[${TAG}] ERROR:`, msg, ...args);
+        // Could delegate to native log later
+    },
+    warn(msg, ...args) {
+        console.warn(`[${TAG}] WARN:`, msg, ...args);
+    },
+    info(msg, ...args) {
+        console.log(`[${TAG}] INFO:`, msg, ...args);
+    },
+    debug(msg, ...args) {
+        if (__DEV__)
+            console.log(`[${TAG}] DEBUG:`, msg, ...args);
+    },
+    verbose(msg, ...args) {
+        if (__DEV__)
+            console.log(`[${TAG}] VERBOSE:`, msg, ...args);
+    },
+};
+export default Logger;
+//# sourceMappingURL=Logger.js.map

package/build/Logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Logger.js","sourceRoot":"","sources":["../src/Logger.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,GAAG,GAAG,qBAAqB,CAAC;AAElC,MAAM,CAAC,MAAM,MAAM,GAAG;IACpB,KAAK,CAAC,GAAW,EAAE,GAAG,IAAW;QAC/B,OAAO,CAAC,KAAK,CAAC,IAAI,GAAG,UAAU,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC,CAAC;QAC/C,qCAAqC;IACvC,CAAC;IACD,IAAI,CAAC,GAAW,EAAE,GAAG,IAAW;QAC9B,OAAO,CAAC,IAAI,CAAC,IAAI,GAAG,SAAS,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC,CAAC;IAC/C,CAAC;IACD,IAAI,CAAC,GAAW,EAAE,GAAG,IAAW;QAC9B,OAAO,CAAC,GAAG,CAAC,IAAI,GAAG,SAAS,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC,CAAC;IAC9C,CAAC;IACD,KAAK,CAAC,GAAW,EAAE,GAAG,IAAW;QAC/B,IAAI,OAAO;YAAE,OAAO,CAAC,GAAG,CAAC,IAAI,GAAG,UAAU,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC,CAAC;IAC5D,CAAC;IACD,OAAO,CAAC,GAAW,EAAE,GAAG,IAAW;QACjC,IAAI,OAAO;YAAE,OAAO,CAAC,GAAG,CAAC,IAAI,GAAG,YAAY,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC,CAAC;IAC9D,CAAC;CACF,CAAC;AAEF,eAAe,MAAM,CAAC","sourcesContent":["/**\n * Logger - dedicated cross-cutting concern.\n * Inspired by the rich logger in react-native-background-geolocation.\n */\n\nconst TAG = 'ThermsDeviceTracker';\n\nexport const Logger = {\n  error(msg: string, ...args: any[]) {\n    console.error(`[${TAG}] ERROR:`, msg, ...args);\n    // Could delegate to native log later\n  },\n  warn(msg: string, ...args: any[]) {\n    console.warn(`[${TAG}] WARN:`, msg, ...args);\n  },\n  info(msg: string, ...args: any[]) {\n    console.log(`[${TAG}] INFO:`, msg, ...args);\n  },\n  debug(msg: string, ...args: any[]) {\n    if (__DEV__) console.log(`[${TAG}] DEBUG:`, msg, ...args);\n  },\n  verbose(msg: string, ...args: any[]) {\n    if (__DEV__) console.log(`[${TAG}] VERBOSE:`, msg, ...args);\n  },\n};\n\nexport default Logger;\n"]}

package/build/NativeModule.d.ts

@@ -0,0 +1,51 @@
+/**
+ * NativeModule abstraction layer.
+ *
+ * Inspired by the excellent separation in react-native-background-geolocation's NativeModule.js.
+ *
+ * Responsibilities:
+ * - Wrap the raw Expo native module
+ * - Handle event subscriptions with validation and cleanup
+ * - Config normalization / validation
+ * - Bridge concerns isolated from the public facade
+ */
+import { ThermsConfig, Geofence } from './ThermsDeviceTracker.types';
+export declare class NativeModuleWrapper {
+    private subscriptions;
+    private validateEvent;
+    addListener(event: string, listener: (data: any) => void): any;
+    removeAllListeners(): void;
+    ready(config?: ThermsConfig): Promise<any>;
+    start(config?: ThermsConfig): Promise<any>;
+    stop(): Promise<any>;
+    getState(): any;
+    getCurrentLocationAsync(): any;
+    getProviderState(): any;
+    addGeofence(geofence: Geofence): any;
+    addGeofences(geofences: Geofence[]): any;
+    removeGeofence(identifier: string): any;
+    removeGeofences(identifiers?: string[]): any;
+    getGeofences(): Promise<Geofence[]>;
+    startGeofences(): any;
+    getLocations(): any;
+    getCount(): any;
+    destroyLocations(): any;
+    destroyLocation(uuid?: string): any;
+    insertLocation(location: any): any;
+    startSchedule(): any;
+    stopSchedule(): any;
+    startSync(): any;
+    stopSync(): any;
+}
+/**
+ * Lightweight normalizer for compound config (especially the opt-in `sync` section).
+ * Provides early, clear validation and sensible defaults before crossing the bridge.
+ * This improves DX and reduces silent fallbacks in native code.
+ *
+ * Note on sync.interval: platform-enforced mins apply (Android WorkManager >=15min for periodic).
+ */
+export declare function normalizeConfig(config?: any): any;
+export declare const NativeModuleInstance: NativeModuleWrapper;
+export { NativeModuleInstance as NativeModule };
+export default NativeModuleInstance;
+//# sourceMappingURL=NativeModule.d.ts.map

package/build/NativeModule.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"NativeModule.d.ts","sourceRoot":"","sources":["../src/NativeModule.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAIH,OAAO,EAAE,YAAY,EAAS,QAAQ,EAAE,MAAM,6BAA6B,CAAC;AAoB5E,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,aAAa,CAAa;IAElC,OAAO,CAAC,aAAa;IAMrB,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,IAAI,EAAE,GAAG,KAAK,IAAI;IAUxD,kBAAkB;IAaZ,KAAK,CAAC,MAAM,CAAC,EAAE,YAAY;IAS3B,KAAK,CAAC,MAAM,CAAC,EAAE,YAAY;IAS3B,IAAI;IAKV,QAAQ;IAIR,uBAAuB;IAIvB,gBAAgB;IAMhB,WAAW,CAAC,QAAQ,EAAE,QAAQ;IAI9B,YAAY,CAAC,SAAS,EAAE,QAAQ,EAAE;IAIlC,cAAc,CAAC,UAAU,EAAE,MAAM;IAIjC,eAAe,CAAC,WAAW,CAAC,EAAE,MAAM,EAAE;IAItC,YAAY,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC;IAInC,cAAc;IAKd,YAAY;IAKZ,QAAQ;IAIR,gBAAgB;IAIhB,eAAe,CAAC,IAAI,CAAC,EAAE,MAAM;IAI7B,cAAc,CAAC,QAAQ,EAAE,GAAG;IAK5B,aAAa;IAIb,YAAY;IAMZ,SAAS;IAIT,QAAQ;CAGT;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,MAAM,CAAC,EAAE,GAAG,OAgB3C;AAED,eAAO,MAAM,oBAAoB,qBAA4B,CAAC;AAC9D,OAAO,EAAE,oBAAoB,IAAI,YAAY,EAAE,CAAC;AAChD,eAAe,oBAAoB,CAAC"}

package/build/NativeModule.js

@@ -0,0 +1,159 @@
+/**
+ * NativeModule abstraction layer.
+ *
+ * Inspired by the excellent separation in react-native-background-geolocation's NativeModule.js.
+ *
+ * Responsibilities:
+ * - Wrap the raw Expo native module
+ * - Handle event subscriptions with validation and cleanup
+ * - Config normalization / validation
+ * - Bridge concerns isolated from the public facade
+ */
+import { requireNativeModule } from 'expo';
+import { Event } from './ThermsDeviceTracker.types';
+const VALID_EVENT_NAMES = new Set(Object.values(Event));
+let _rawModule = null;
+function getRawModule() {
+    if (_rawModule)
+        return _rawModule;
+    _rawModule = requireNativeModule('ThermsDeviceTracker');
+    return _rawModule;
+}
+export class NativeModuleWrapper {
+    subscriptions = [];
+    validateEvent(event) {
+        if (!VALID_EVENT_NAMES.has(event)) {
+            throw new Error(`[ThermsDeviceTracker] Unknown event '${event}'`);
+        }
+    }
+    addListener(event, listener) {
+        this.validateEvent(event);
+        const module = getRawModule();
+        const sub = module.addListener?.(event, listener);
+        if (sub) {
+            this.subscriptions.push(sub);
+        }
+        return sub;
+    }
+    removeAllListeners() {
+        this.subscriptions.forEach((sub) => {
+            try {
+                sub.remove?.();
+            }
+            catch { }
+        });
+        this.subscriptions = [];
+        try {
+            getRawModule().removeAllListeners?.();
+        }
+        catch { }
+    }
+    // Config + lifecycle (reference style)
+    async ready(config) {
+        const normalized = normalizeConfig(config);
+        const module = getRawModule();
+        if (typeof module.ready === 'function') {
+            return module.ready(normalized);
+        }
+        return this.start(normalized);
+    }
+    async start(config) {
+        const normalized = normalizeConfig(config);
+        const module = getRawModule();
+        if (normalized && typeof module.setConfig === 'function') {
+            await module.setConfig(normalized);
+        }
+        return module.startTrackingAsync?.(normalized) || module.start?.();
+    }
+    async stop() {
+        const module = getRawModule();
+        return module.stopTrackingAsync?.() || module.stop?.();
+    }
+    getState() {
+        return getRawModule().getTrackingStatus?.() || getRawModule().getState?.();
+    }
+    getCurrentLocationAsync() {
+        return getRawModule().getCurrentLocationAsync?.();
+    }
+    getProviderState() {
+        const mod = getRawModule();
+        return mod.getProviderState?.() || mod.getTrackingStatus?.();
+    }
+    // Geofencing delegation
+    addGeofence(geofence) {
+        return getRawModule().addGeofence?.(geofence);
+    }
+    addGeofences(geofences) {
+        return getRawModule().addGeofences?.(geofences);
+    }
+    removeGeofence(identifier) {
+        return getRawModule().removeGeofence?.(identifier);
+    }
+    removeGeofences(identifiers) {
+        return getRawModule().removeGeofences?.(identifiers);
+    }
+    getGeofences() {
+        return getRawModule().getGeofences?.();
+    }
+    startGeofences() {
+        return getRawModule().startGeofences?.();
+    }
+    // Persistence
+    getLocations() {
+        const m = getRawModule();
+        return m.getLocations?.() || m.getCurrentSessionHistory?.();
+    }
+    getCount() {
+        return getRawModule().getCount?.();
+    }
+    destroyLocations() {
+        return getRawModule().destroyLocations?.();
+    }
+    destroyLocation(uuid) {
+        return getRawModule().destroyLocation?.(uuid);
+    }
+    insertLocation(location) {
+        return getRawModule().insertLocation?.(location);
+    }
+    // Scheduler
+    startSchedule() {
+        return getRawModule().startSchedule?.();
+    }
+    stopSchedule() {
+        return getRawModule().stopSchedule?.();
+    }
+    // Background sync (delegation to native impl: SyncManager on iOS, SyncProvider on Android).
+    // See ThermsConfig.sync + onSync for details (opt-in, config-driven or explicit start/stopSync).
+    startSync() {
+        return getRawModule().startSync?.();
+    }
+    stopSync() {
+        return getRawModule().stopSync?.();
+    }
+}
+/**
+ * Lightweight normalizer for compound config (especially the opt-in `sync` section).
+ * Provides early, clear validation and sensible defaults before crossing the bridge.
+ * This improves DX and reduces silent fallbacks in native code.
+ *
+ * Note on sync.interval: platform-enforced mins apply (Android WorkManager >=15min for periodic).
+ */
+export function normalizeConfig(config) {
+    if (!config)
+        return config;
+    const out = { ...config };
+    if (out.sync) {
+        const s = { ...out.sync };
+        // url is required for enabled sync (native gracefully handles missing, but we surface it early)
+        if (s.enabled && !s.url) {
+            // Non-fatal in case someone disables later; native will emit disabled.
+        }
+        s.batch = s.batch ?? true; // match native default
+        out.sync = s;
+    }
+    return out;
+}
+export const NativeModuleInstance = new NativeModuleWrapper();
+export { NativeModuleInstance as NativeModule };
+export default NativeModuleInstance;
+//# sourceMappingURL=NativeModule.js.map

package/build/NativeModule.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"NativeModule.js","sourceRoot":"","sources":["../src/NativeModule.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,mBAAmB,EAAE,MAAM,MAAM,CAAC;AAE3C,OAAO,EAAgB,KAAK,EAAY,MAAM,6BAA6B,CAAC;AAE5E,MAAM,iBAAiB,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;AAUxD,IAAI,UAAU,GAAqB,IAAI,CAAC;AAExC,SAAS,YAAY;IACnB,IAAI,UAAU;QAAE,OAAO,UAAU,CAAC;IAClC,UAAU,GAAG,mBAAmB,CAAY,qBAAqB,CAAC,CAAC;IACnE,OAAO,UAAU,CAAC;AACpB,CAAC;AAED,MAAM,OAAO,mBAAmB;IACtB,aAAa,GAAU,EAAE,CAAC;IAE1B,aAAa,CAAC,KAAa;QACjC,IAAI,CAAC,iBAAiB,CAAC,GAAG,CAAC,KAAY,CAAC,EAAE,CAAC;YACzC,MAAM,IAAI,KAAK,CAAC,wCAAwC,KAAK,GAAG,CAAC,CAAC;QACpE,CAAC;IACH,CAAC;IAED,WAAW,CAAC,KAAa,EAAE,QAA6B;QACtD,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC;QAC1B,MAAM,MAAM,GAAG,YAAY,EAAE,CAAC;QAC9B,MAAM,GAAG,GAAI,MAAc,CAAC,WAAW,EAAE,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;QAC3D,IAAI,GAAG,EAAE,CAAC;YACR,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAC/B,CAAC;QACD,OAAO,GAAG,CAAC;IACb,CAAC;IAED,kBAAkB;QAChB,IAAI,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC,GAAG,EAAE,EAAE;YACjC,IAAI,CAAC;gBACH,GAAG,CAAC,MAAM,EAAE,EAAE,CAAC;YACjB,CAAC;YAAC,MAAM,CAAC,CAAA,CAAC;QACZ,CAAC,CAAC,CAAC;QACH,IAAI,CAAC,aAAa,GAAG,EAAE,CAAC;QACxB,IAAI,CAAC;YACF,YAAY,EAAU,CAAC,kBAAkB,EAAE,EAAE,CAAC;QACjD,CAAC;QAAC,MAAM,CAAC,CAAA,CAAC;IACZ,CAAC;IAED,uCAAuC;IACvC,KAAK,CAAC,KAAK,CAAC,MAAqB;QAC/B,MAAM,UAAU,GAAG,eAAe,CAAC,MAAM,CAAC,CAAC;QAC3C,MAAM,MAAM,GAAG,YAAY,EAAE,CAAC;QAC9B,IAAI,OAAQ,MAAc,CAAC,KAAK,KAAK,UAAU,EAAE,CAAC;YAChD,OAAQ,MAAc,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;QAC3C,CAAC;QACD,OAAO,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;IAChC,CAAC;IAED,KAAK,CAAC,KAAK,CAAC,MAAqB;QAC/B,MAAM,UAAU,GAAG,eAAe,CAAC,MAAM,CAAC,CAAC;QAC3C,MAAM,MAAM,GAAG,YAAY,EAAE,CAAC;QAC9B,IAAI,UAAU,IAAI,OAAQ,MAAc,CAAC,SAAS,KAAK,UAAU,EAAE,CAAC;YAClE,MAAO,MAAc,CAAC,SAAS,CAAC,UAAU,CAAC,CAAC;QAC9C,CAAC;QACD,OAAQ,MAAc,CAAC,kBAAkB,EAAE,CAAC,UAAU,CAAC,IAAK,MAAc,CAAC,KAAK,EAAE,EAAE,CAAC;IACvF,CAAC;IAED,KAAK,CAAC,IAAI;QACR,MAAM,MAAM,GAAG,YAAY,EAAE,CAAC;QAC9B,OAAQ,MAAc,CAAC,iBAAiB,EAAE,EAAE,IAAK,MAAc,CAAC,IAAI,EAAE,EAAE,CAAC;IAC3E,CAAC;IAED,QAAQ;QACN,OAAQ,YAAY,EAAU,CAAC,iBAAiB,EAAE,EAAE,IAAK,YAAY,EAAU,CAAC,QAAQ,EAAE,EAAE,CAAC;IAC/F,CAAC;IAED,uBAAuB;QACrB,OAAQ,YAAY,EAAU,CAAC,uBAAuB,EAAE,EAAE,CAAC;IAC7D,CAAC;IAED,gBAAgB;QACd,MAAM,GAAG,GAAG,YAAY,EAAE,CAAC;QAC3B,OAAQ,GAAW,CAAC,gBAAgB,EAAE,EAAE,IAAK,GAAW,CAAC,iBAAiB,EAAE,EAAE,CAAC;IACjF,CAAC;IAED,wBAAwB;IACxB,WAAW,CAAC,QAAkB;QAC5B,OAAQ,YAAY,EAAU,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,CAAC;IACzD,CAAC;IAED,YAAY,CAAC,SAAqB;QAChC,OAAQ,YAAY,EAAU,CAAC,YAAY,EAAE,CAAC,SAAS,CAAC,CAAC;IAC3D,CAAC;IAED,cAAc,CAAC,UAAkB;QAC/B,OAAQ,YAAY,EAAU,CAAC,cAAc,EAAE,CAAC,UAAU,CAAC,CAAC;IAC9D,CAAC;IAED,eAAe,CAAC,WAAsB;QACpC,OAAQ,YAAY,EAAU,CAAC,eAAe,EAAE,CAAC,WAAW,CAAC,CAAC;IAChE,CAAC;IAED,YAAY;QACV,OAAQ,YAAY,EAAU,CAAC,YAAY,EAAE,EAAE,CAAC;IAClD,CAAC;IAED,cAAc;QACZ,OAAQ,YAAY,EAAU,CAAC,cAAc,EAAE,EAAE,CAAC;IACpD,CAAC;IAED,cAAc;IACd,YAAY;QACV,MAAM,CAAC,GAAG,YAAY,EAAS,CAAC;QAChC,OAAO,CAAC,CAAC,YAAY,EAAE,EAAE,IAAI,CAAC,CAAC,wBAAwB,EAAE,EAAE,CAAC;IAC9D,CAAC;IAED,QAAQ;QACN,OAAQ,YAAY,EAAU,CAAC,QAAQ,EAAE,EAAE,CAAC;IAC9C,CAAC;IAED,gBAAgB;QACd,OAAQ,YAAY,EAAU,CAAC,gBAAgB,EAAE,EAAE,CAAC;IACtD,CAAC;IAED,eAAe,CAAC,IAAa;QAC3B,OAAQ,YAAY,EAAU,CAAC,eAAe,EAAE,CAAC,IAAI,CAAC,CAAC;IACzD,CAAC;IAED,cAAc,CAAC,QAAa;QAC1B,OAAQ,YAAY,EAAU,CAAC,cAAc,EAAE,CAAC,QAAQ,CAAC,CAAC;IAC5D,CAAC;IAED,YAAY;IACZ,aAAa;QACX,OAAQ,YAAY,EAAU,CAAC,aAAa,EAAE,EAAE,CAAC;IACnD,CAAC;IAED,YAAY;QACV,OAAQ,YAAY,EAAU,CAAC,YAAY,EAAE,EAAE,CAAC;IAClD,CAAC;IAED,4FAA4F;IAC5F,iGAAiG;IACjG,SAAS;QACP,OAAQ,YAAY,EAAU,CAAC,SAAS,EAAE,EAAE,CAAC;IAC/C,CAAC;IAED,QAAQ;QACN,OAAQ,YAAY,EAAU,CAAC,QAAQ,EAAE,EAAE,CAAC;IAC9C,CAAC;CACF;AAED;;;;;;GAMG;AACH,MAAM,UAAU,eAAe,CAAC,MAAY;IAC1C,IAAI,CAAC,MAAM;QAAE,OAAO,MAAM,CAAC;IAE3B,MAAM,GAAG,GAAG,EAAE,GAAG,MAAM,EAAE,CAAC;IAE1B,IAAI,GAAG,CAAC,IAAI,EAAE,CAAC;QACb,MAAM,CAAC,GAAG,EAAE,GAAG,GAAG,CAAC,IAAI,EAAE,CAAC;QAC1B,gGAAgG;QAChG,IAAI,CAAC,CAAC,OAAO,IAAI,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC;YACxB,uEAAuE;QACzE,CAAC;QACD,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,IAAI,IAAI,CAAC,CAAC,uBAAuB;QAClD,GAAG,CAAC,IAAI,GAAG,CAAC,CAAC;IACf,CAAC;IAED,OAAO,GAAG,CAAC;AACb,CAAC;AAED,MAAM,CAAC,MAAM,oBAAoB,GAAG,IAAI,mBAAmB,EAAE,CAAC;AAC9D,OAAO,EAAE,oBAAoB,IAAI,YAAY,EAAE,CAAC;AAChD,eAAe,oBAAoB,CAAC","sourcesContent":["/**\n * NativeModule abstraction layer.\n *\n * Inspired by the excellent separation in react-native-background-geolocation's NativeModule.js.\n *\n * Responsibilities:\n * - Wrap the raw Expo native module\n * - Handle event subscriptions with validation and cleanup\n * - Config normalization / validation\n * - Bridge concerns isolated from the public facade\n */\n\nimport { requireNativeModule } from 'expo';\n\nimport { ThermsConfig, Event, Geofence } from './ThermsDeviceTracker.types';\n\nconst VALID_EVENT_NAMES = new Set(Object.values(Event));\n\ntype RawModule = any & {\n  ready?: (config?: ThermsConfig) => Promise<any>;\n  start?: () => Promise<void>;\n  stop?: () => Promise<void>;\n  getState?: () => any;\n  // ... other raw methods exposed by the Swift/Kotlin module\n};\n\nlet _rawModule: RawModule | null = null;\n\nfunction getRawModule(): RawModule {\n  if (_rawModule) return _rawModule;\n  _rawModule = requireNativeModule<RawModule>('ThermsDeviceTracker');\n  return _rawModule;\n}\n\nexport class NativeModuleWrapper {\n  private subscriptions: any[] = [];\n\n  private validateEvent(event: string) {\n    if (!VALID_EVENT_NAMES.has(event as any)) {\n      throw new Error(`[ThermsDeviceTracker] Unknown event '${event}'`);\n    }\n  }\n\n  addListener(event: string, listener: (data: any) => void) {\n    this.validateEvent(event);\n    const module = getRawModule();\n    const sub = (module as any).addListener?.(event, listener);\n    if (sub) {\n      this.subscriptions.push(sub);\n    }\n    return sub;\n  }\n\n  removeAllListeners() {\n    this.subscriptions.forEach((sub) => {\n      try {\n        sub.remove?.();\n      } catch {}\n    });\n    this.subscriptions = [];\n    try {\n      (getRawModule() as any).removeAllListeners?.();\n    } catch {}\n  }\n\n  // Config + lifecycle (reference style)\n  async ready(config?: ThermsConfig) {\n    const normalized = normalizeConfig(config);\n    const module = getRawModule();\n    if (typeof (module as any).ready === 'function') {\n      return (module as any).ready(normalized);\n    }\n    return this.start(normalized);\n  }\n\n  async start(config?: ThermsConfig) {\n    const normalized = normalizeConfig(config);\n    const module = getRawModule();\n    if (normalized && typeof (module as any).setConfig === 'function') {\n      await (module as any).setConfig(normalized);\n    }\n    return (module as any).startTrackingAsync?.(normalized) || (module as any).start?.();\n  }\n\n  async stop() {\n    const module = getRawModule();\n    return (module as any).stopTrackingAsync?.() || (module as any).stop?.();\n  }\n\n  getState() {\n    return (getRawModule() as any).getTrackingStatus?.() || (getRawModule() as any).getState?.();\n  }\n\n  getCurrentLocationAsync() {\n    return (getRawModule() as any).getCurrentLocationAsync?.();\n  }\n\n  getProviderState() {\n    const mod = getRawModule();\n    return (mod as any).getProviderState?.() || (mod as any).getTrackingStatus?.();\n  }\n\n  // Geofencing delegation\n  addGeofence(geofence: Geofence) {\n    return (getRawModule() as any).addGeofence?.(geofence);\n  }\n\n  addGeofences(geofences: Geofence[]) {\n    return (getRawModule() as any).addGeofences?.(geofences);\n  }\n\n  removeGeofence(identifier: string) {\n    return (getRawModule() as any).removeGeofence?.(identifier);\n  }\n\n  removeGeofences(identifiers?: string[]) {\n    return (getRawModule() as any).removeGeofences?.(identifiers);\n  }\n\n  getGeofences(): Promise<Geofence[]> {\n    return (getRawModule() as any).getGeofences?.();\n  }\n\n  startGeofences() {\n    return (getRawModule() as any).startGeofences?.();\n  }\n\n  // Persistence\n  getLocations() {\n    const m = getRawModule() as any;\n    return m.getLocations?.() || m.getCurrentSessionHistory?.();\n  }\n\n  getCount() {\n    return (getRawModule() as any).getCount?.();\n  }\n\n  destroyLocations() {\n    return (getRawModule() as any).destroyLocations?.();\n  }\n\n  destroyLocation(uuid?: string) {\n    return (getRawModule() as any).destroyLocation?.(uuid);\n  }\n\n  insertLocation(location: any) {\n    return (getRawModule() as any).insertLocation?.(location);\n  }\n\n  // Scheduler\n  startSchedule() {\n    return (getRawModule() as any).startSchedule?.();\n  }\n\n  stopSchedule() {\n    return (getRawModule() as any).stopSchedule?.();\n  }\n\n  // Background sync (delegation to native impl: SyncManager on iOS, SyncProvider on Android).\n  // See ThermsConfig.sync + onSync for details (opt-in, config-driven or explicit start/stopSync).\n  startSync() {\n    return (getRawModule() as any).startSync?.();\n  }\n\n  stopSync() {\n    return (getRawModule() as any).stopSync?.();\n  }\n}\n\n/**\n * Lightweight normalizer for compound config (especially the opt-in `sync` section).\n * Provides early, clear validation and sensible defaults before crossing the bridge.\n * This improves DX and reduces silent fallbacks in native code.\n *\n * Note on sync.interval: platform-enforced mins apply (Android WorkManager >=15min for periodic).\n */\nexport function normalizeConfig(config?: any) {\n  if (!config) return config;\n\n  const out = { ...config };\n\n  if (out.sync) {\n    const s = { ...out.sync };\n    // url is required for enabled sync (native gracefully handles missing, but we surface it early)\n    if (s.enabled && !s.url) {\n      // Non-fatal in case someone disables later; native will emit disabled.\n    }\n    s.batch = s.batch ?? true; // match native default\n    out.sync = s;\n  }\n\n  return out;\n}\n\nexport const NativeModuleInstance = new NativeModuleWrapper();\nexport { NativeModuleInstance as NativeModule };\nexport default NativeModuleInstance;\n"]}