react-native-nitro-background-geolocation 0.1.0

package/lib/typescript/src/NitroBackgroundGeolocation.nitro.d.ts

@@ -0,0 +1,616 @@
+import type { AnyMap, HybridObject } from 'react-native-nitro-modules';
+/**
+ * Selects which native location provider strategy should be used.
+ *
+ * - **Default:** `LocationProvider.DISTANCE_FILTER`
+ */
+export declare enum LocationProvider {
+    /**
+     * Uses the classic distance-filter provider with Stationary API and an elastic
+     * distance filter for optimal battery and data usage.
+     */
+    DISTANCE_FILTER = 0,
+    /**
+     * Uses activity recognition together with fused location updates.
+     * Best suited for foreground-style tracking.
+     */
+    ACTIVITY = 1,
+    /**
+     * Returns raw sensor/device locations without additional provider-side processing.
+     */
+    RAW = 2
+}
+/**
+ * Operational mode used by the original Cordova plugin's iOS `switchMode()`.
+ * Kept for parity in the type surface, but not currently consumed by the Nitro API.
+ *
+ * - **Platform:** iOS concept
+ */
+export declare enum ServiceMode {
+    /**
+     * Background mode.
+     */
+    BACKGROUND = 0,
+    /**
+     * Foreground mode.
+     */
+    FOREGROUND = 1
+}
+/**
+ * Authorization status reported by the native layer.
+ */
+export declare enum AuthorizationStatus {
+    /**
+     * Location access is not authorized.
+     */
+    NOT_AUTHORIZED = 0,
+    /**
+     * Authorized to run in background and foreground.
+     */
+    AUTHORIZED = 1,
+    /**
+     * Foreground-only authorization.
+     * Reserved for platforms that expose this distinction.
+     *
+     * - **Platform:** iOS-only in the underlying Cordova model
+     */
+    AUTHORIZED_FOREGROUND = 2
+}
+/**
+ * Desired location accuracy in meters.
+ * Lower accuracy generally means lower power drain.
+ *
+ * - **Default:** `LocationAccuracy.MEDIUM`
+ */
+export declare enum LocationAccuracy {
+    /**
+     * Highest accuracy.
+     */
+    HIGH = 0,
+    /**
+     * Medium accuracy.
+     */
+    MEDIUM = 100,
+    /**
+     * Low accuracy.
+     */
+    LOW = 1000,
+    /**
+     * Passive accuracy.
+     */
+    PASSIVE = 10000
+}
+/**
+ * Minimum log severity for log retrieval.
+ * Use this to filter native log records from most verbose (`TRACE`) to least verbose (`ERROR`).
+ */
+export declare enum NativeLogLevel {
+    /** Most verbose diagnostic logging. */
+    TraceValue = 0,
+    /** Debug-level logging for development and investigation. */
+    DebugValue = 1,
+    /** General informational logging. */
+    InfoValue = 2,
+    /** Warning-level logging for recoverable problems. */
+    WarnValue = 3,
+    /** Error-level logging for failures. */
+    ErrorValue = 4
+}
+/**
+ * Error codes returned by `getCurrentLocation()`.
+ */
+export declare enum LocationErrorCode {
+    /**
+     * Request failed due to missing permissions.
+     */
+    PERMISSION_DENIED = 1,
+    /**
+     * The internal location source returned an error.
+     */
+    LOCATION_UNAVAILABLE = 2,
+    /**
+     * The request exceeded the configured timeout.
+     */
+    TIMEOUT = 3
+}
+export type NullableString = string | null;
+export type NullableNumber = number | null;
+export type NullableBoolean = boolean | null;
+export type NullableHeaders = Record<string, string> | null;
+export type NullableAnyMap = AnyMap | null;
+export type NullableLocationProvider = LocationProvider | null;
+export type NullableLocationAccuracy = LocationAccuracy | null;
+/**
+ * Configuration applied to the background geolocation engine.
+ * Later calls may provide only a subset of fields; omitted fields stay unchanged.
+ * Pass `null` to restore a supported field to its native default.
+ */
+export interface ConfigureOptions {
+    /**
+     * Which native provider strategy should be used.
+     *
+     * - **Default:** `LocationProvider.DISTANCE_FILTER`
+     * - **Platform:** all
+     */
+    locationProvider?: NullableLocationProvider;
+    /**
+     * Desired accuracy in meters. Lower accuracy usually reduces power drain.
+     * See `LocationAccuracy` for the available accuracy tiers.
+     *
+     * - **Default:** `LocationAccuracy.MEDIUM`
+     * - **Platform:** all
+     */
+    desiredAccuracy?: NullableLocationAccuracy;
+    /**
+     * Stationary radius in meters.
+     * When stopped, the device must move beyond this radius before aggressive tracking resumes.
+     *
+     * - **Default:** `50`
+     * - **Platform:** all
+     */
+    stationaryRadius?: NullableNumber;
+    /**
+     * When enabled, the plugin emits debugging sounds for lifecycle events.
+     *
+     * - **Default:** `false`
+     * - **Platform:** all
+     */
+    debug?: NullableBoolean;
+    /**
+     * Minimum horizontal distance in meters the device must move before an update is generated.
+     *
+     * - **Default:** `500`
+     * - **Platform:** all
+     */
+    distanceFilter?: NullableNumber;
+    /**
+     * Force tracking to stop when the application is terminated.
+     *
+     * - **Default:** `true`
+     * - **Platform:** all
+     */
+    stopOnTerminate?: NullableBoolean;
+    /**
+     * Start the background service when the device boots.
+     *
+     * - **Default:** `false`
+     * - **Platform:** Android
+     */
+    startOnBoot?: NullableBoolean;
+    /**
+     * Minimum time interval between location updates, in milliseconds.
+     *
+     * - **Default:** `600000`
+     * - **Platform:** Android
+     */
+    interval?: NullableNumber;
+    /**
+     * Fastest rate, in milliseconds, at which the app can handle location updates.
+     *
+     * - **Default:** `120000`
+     * - **Platform:** Android
+     */
+    fastestInterval?: NullableNumber;
+    /**
+     * Rate, in milliseconds, at which activity recognition occurs.
+     * Larger values improve battery life but reduce detection frequency.
+     *
+     * - **Default:** `10000`
+     * - **Platform:** Android
+     */
+    activitiesInterval?: NullableNumber;
+    /**
+     * Deprecated upstream Android option that stops location updates when STILL is detected.
+     *
+     * - **Default:** `true`
+     * - **Platform:** Android
+     */
+    stopOnStillActivity?: NullableBoolean;
+    /**
+     * Enable or disable local notifications while tracking and syncing locations.
+     *
+     * - **Default:** `true`
+     * - **Platform:** Android
+     */
+    notificationsEnabled?: NullableBoolean;
+    /**
+     * Allow the location service to run in foreground state.
+     * Foreground mode requires a visible notification.
+     *
+     * - **Default:** `true`
+     * - **Platform:** Android
+     */
+    startForeground?: NullableBoolean;
+    /**
+     * Custom notification title shown in the drawer.
+     *
+     * - **Default:** `"Background tracking"`
+     * - **Platform:** Android
+     */
+    notificationTitle?: NullableString;
+    /**
+     * Custom notification text shown in the drawer.
+     *
+     * - **Default:** `"ENABLED"`
+     * - **Platform:** Android
+     */
+    notificationText?: NullableString;
+    /**
+     * Accent color used for the notification, for example `#4CAF50`.
+     *
+     * - **Default:** `""`
+     * - **Platform:** Android
+     */
+    notificationIconColor?: NullableString;
+    /**
+     * Resource name of a custom large notification icon.
+     *
+     * - **Default:** `""`
+     * - **Platform:** Android
+     */
+    notificationIconLarge?: NullableString;
+    /**
+     * Resource name of a custom small notification icon.
+     *
+     * - **Default:** `""`
+     * - **Platform:** Android
+     */
+    notificationIconSmall?: NullableString;
+    /**
+     * iOS activity type hint.
+     *
+     * - **Default:** native platform default
+     * - **Platform:** iOS
+     */
+    activityType?: NullableString;
+    /**
+     * Allow the system to pause location updates automatically on iOS.
+     *
+     * - **Default:** platform default / not used on Android
+     * - **Platform:** iOS
+     */
+    pauseLocationUpdates?: NullableBoolean;
+    /**
+     * Reduce accuracy in the background to save battery on iOS.
+     *
+     * - **Default:** platform default / not used on Android
+     * - **Platform:** iOS
+     */
+    saveBatteryOnBackground?: NullableBoolean;
+    /**
+     * Server URL that receives immediate HTTP POSTs for recorded locations.
+     *
+     * - **Default:** `""`
+     * - **Platform:** all
+     */
+    url?: NullableString;
+    /**
+     * Server URL that receives batched retries for locations that previously failed to post.
+     *
+     * - **Default:** `""`
+     * - **Platform:** all
+     */
+    syncUrl?: NullableString;
+    /**
+     * Number of failed locations to batch together before syncing.
+     *
+     * - **Default:** `100`
+     * - **Platform:** all
+     */
+    syncThreshold?: NullableNumber;
+    /**
+     * Optional HTTP headers sent with location POST requests.
+     *
+     * - **Default:** `undefined`
+     * - **Platform:** all
+     */
+    httpHeaders?: NullableHeaders;
+    /**
+     * Maximum number of locations stored in the local database.
+     *
+     * - **Default:** `10000`
+     * - **Platform:** all
+     */
+    maxLocations?: NullableNumber;
+    /**
+     * Custom POST template for `url` and `syncUrl`.
+     * Supports object or array shapes and may include location placeholders such as `@latitude`.
+     *
+     * - **Default:** native template behavior
+     * - **Platform:** all
+     */
+    postTemplate?: NullableAnyMap;
+}
+/**
+ * A recorded location fix.
+ */
+export interface Location {
+    /**
+     * Location identifier as stored in the database.
+     */
+    id: number;
+    /**
+     * Native provider name, such as `gps`, `network`, `passive`, or `fused`.
+     */
+    provider: string;
+    /**
+     * Numeric location provider code.
+     */
+    locationProvider: number;
+    /**
+     * UTC timestamp of this fix in milliseconds since January 1, 1970.
+     */
+    time: number;
+    /**
+     * Latitude in degrees.
+     */
+    latitude: number;
+    /**
+     * Longitude in degrees.
+     */
+    longitude: number;
+    /**
+     * Estimated accuracy of this location in meters.
+     */
+    accuracy: number;
+    /**
+     * Speed in meters per second over ground.
+     */
+    speed: number;
+    /**
+     * Altitude in meters above the WGS 84 reference ellipsoid.
+     */
+    altitude: number;
+    /**
+     * Estimated altitude accuracy in meters.
+     */
+    altitudeAccuracy: number;
+    /**
+     * Bearing in degrees.
+     */
+    bearing: number;
+    /**
+     * Android only. True when the location was recorded by a mock provider.
+     */
+    isFromMockProvider: boolean;
+    /**
+     * Android only. True when mock locations are enabled on the device.
+     */
+    mockLocationsEnabled: boolean;
+}
+/**
+ * A stationary location fix with an additional stationary radius.
+ */
+export interface StationaryLocation {
+    id: number;
+    provider: string;
+    locationProvider: number;
+    time: number;
+    latitude: number;
+    longitude: number;
+    accuracy: number;
+    speed: number;
+    altitude: number;
+    altitudeAccuracy: number;
+    bearing: number;
+    isFromMockProvider: boolean;
+    mockLocationsEnabled: boolean;
+    /**
+     * Radius in meters that defines the stationary region.
+     */
+    radius: number;
+}
+/**
+ * Activity recognition payload reported by the Android activity provider.
+ */
+export interface Activity {
+    /**
+     * Percentage indicating the likelihood the user is performing this activity.
+     */
+    confidence: number;
+    /**
+     * Activity type such as `IN_VEHICLE`, `ON_BICYCLE`, `ON_FOOT`, `RUNNING`,
+     * `STILL`, `TILTING`, `UNKNOWN`, or `WALKING`.
+     */
+    type: string;
+}
+/**
+ * Current runtime status of the service and device location state.
+ */
+export interface ServiceStatus {
+    /**
+     * True when the background geolocation service is running.
+     */
+    isRunning: boolean;
+    /**
+     * True when device location services are enabled.
+     */
+    locationServicesEnabled: boolean;
+    /**
+     * Current authorization status.
+     */
+    authorization: AuthorizationStatus;
+}
+/**
+ * Single log entry returned from the native logger database.
+ */
+export interface LogEntry {
+    id: number;
+    timestamp: number;
+    level: string;
+    message: string;
+    stackTrace: string;
+}
+/**
+ * Options for a one-time current location request.
+ */
+export interface LocationOptions {
+    /**
+     * Maximum time in milliseconds to wait for a location fix.
+     *
+     * - **Default:** `30000`
+     */
+    timeout?: number;
+    /**
+     * Maximum age in milliseconds of a cached location that is acceptable to return.
+     *
+     * - **Default:** `0`
+     */
+    maximumAge?: number;
+    /**
+     * If true, request the most accurate position the device can provide.
+     *
+     * - **Default:** `false`
+     */
+    enableHighAccuracy?: boolean;
+}
+/**
+ * Error payload returned by the native plugin.
+ */
+export interface BackgroundGeolocationError {
+    /**
+     * Numeric error code.
+     */
+    code: number;
+    /**
+     * Human-readable error message.
+     */
+    message: string;
+}
+/**
+ * Nitro bridge for the background geolocation engine.
+ */
+export interface NitroBackgroundGeolocation extends HybridObject<{
+    ios: 'swift';
+    android: 'kotlin';
+}> {
+    /**
+     * Configure the plugin.
+     * Omitted fields keep their previous values.
+     * Pass `null` to restore a field to its native default.
+     */
+    configure(options: ConfigureOptions): Promise<void>;
+    /**
+     * Start background geolocation.
+     */
+    start(): Promise<void>;
+    /**
+     * Stop background geolocation.
+     */
+    stop(): Promise<void>;
+    /**
+     * Perform a one-time location check for the device's current position.
+     */
+    getCurrentLocation(options: LocationOptions): Promise<Location>;
+    /**
+     * Return the current stationary location, if one exists.
+     */
+    getStationaryLocation(): Promise<StationaryLocation | undefined>;
+    /**
+     * Check whether the service is running, whether location services are enabled,
+     * and what authorization state is currently reported.
+     */
+    checkStatus(): Promise<ServiceStatus>;
+    /**
+     * Return the fully applied configuration after native merging/defaulting.
+     * Useful when `configure()` was called with only a subset of fields.
+     */
+    getConfig(): Promise<ConfigureOptions>;
+    /**
+     * Open the app settings screen so the user can change location permissions.
+     *
+     * - **Platform:** Android
+     */
+    showAppSettings(): void;
+    /**
+     * Open the system location settings screen.
+     *
+     * - **Platform:** Android
+     */
+    showLocationSettings(): void;
+    /**
+     * Return all stored locations.
+     * Useful for initial rendering immediately after app launch.
+     */
+    getLocations(): Promise<Location[]>;
+    /**
+     * Return locations that have not yet been posted to the server.
+     */
+    getValidLocations(): Promise<Location[]>;
+    /**
+     * Return valid locations and mark them deleted so they are not returned again.
+     */
+    getValidLocationsAndDelete(): Promise<Location[]>;
+    /**
+     * Delete a location by its database id.
+     */
+    deleteLocation(locationId: number): Promise<void>;
+    /**
+     * Delete all stored locations.
+     * Native storage keeps ids monotonic by marking rows deleted rather than removing them outright.
+     */
+    deleteAllLocations(): Promise<void>;
+    /**
+     * Force synchronization of stored locations to the configured server.
+     */
+    forceSync(): Promise<void>;
+    /**
+     * Return log entries filtered by limit, starting id, and minimum level.
+     */
+    getLogEntries(limit: number, fromId: number, minLevel: NativeLogLevel): Promise<LogEntry[]>;
+    /**
+     * Subscribe to location updates.
+     */
+    onLocation(callback: (location: Location) => void): () => void;
+    /**
+     * Subscribe to the device entering stationary mode.
+     */
+    onStationary(callback: (location: StationaryLocation) => void): () => void;
+    /**
+     * Subscribe to activity detection changes.
+     *
+     * - **Platform:** Android
+     */
+    onActivity(callback: (activity: Activity) => void): () => void;
+    /**
+     * Subscribe to tracking start events.
+     */
+    onStart(callback: () => void): () => void;
+    /**
+     * Subscribe to tracking stop events.
+     */
+    onStop(callback: () => void): () => void;
+    /**
+     * Subscribe to plugin errors.
+     */
+    onError(callback: (error: BackgroundGeolocationError) => void): () => void;
+    /**
+     * Subscribe to authorization status changes.
+     */
+    onAuthorization(callback: (status: AuthorizationStatus) => void): () => void;
+    /**
+     * Subscribe to app foreground transitions.
+     *
+     * - **Platform:** Android
+     */
+    onForeground(callback: () => void): () => void;
+    /**
+     * Subscribe to app background transitions.
+     *
+     * - **Platform:** Android
+     */
+    onBackground(callback: () => void): () => void;
+    /**
+     * Subscribe to server responses indicating updates are not required.
+     */
+    onAbortRequested(callback: () => void): () => void;
+    /**
+     * Subscribe to server responses indicating HTTP authorization is required.
+     */
+    onHttpAuthorization(callback: () => void): () => void;
+    /**
+     * Remove all registered event listeners.
+     */
+    removeAllListeners(): void;
+}
+//# sourceMappingURL=NitroBackgroundGeolocation.nitro.d.ts.map

package/lib/typescript/src/NitroBackgroundGeolocation.nitro.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"NitroBackgroundGeolocation.nitro.d.ts","sourceRoot":"","sources":["../../../src/NitroBackgroundGeolocation.nitro.ts"],"names":[],"mappings":"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"}

package/lib/typescript/src/headless.d.ts

@@ -0,0 +1,40 @@
+import type { Location, StationaryLocation, Activity } from './NitroBackgroundGeolocation.nitro';
+/**
+ * Internal name of the library-owned headless task. Must match
+ * [`LIB_TASK_NAME`](../android/src/main/java/com/margelo/nitro/nitrobackgroundgeolocation/NitroBackgroundGeolocation.kt)
+ * on the Android side. Users do not interact with this string.
+ */
+export declare const HEADLESS_TASK_NAME = "__rn-nitro-bg-geo-headless__";
+/**
+ * Typed payload delivered to the headless handler. The `event` field
+ * is a discriminant — narrow on it to access the correct payload.
+ */
+export type HeadlessEvent = {
+    event: 'location';
+    location: Location;
+} | {
+    event: 'stationary';
+    location: StationaryLocation;
+} | {
+    event: 'activity';
+    activity: Activity;
+};
+export type HeadlessHandler = (event: HeadlessEvent) => void | Promise<void>;
+/**
+ * Register a handler that fires on background geolocation events when
+ * the app process is no longer running.
+ *
+ * **Must be called at module load time** — top-level in your entry
+ * file (e.g. `index.js`), before `registerRootComponent`. The native
+ * service spawns a fresh JS context per event and re-runs your entry
+ * file to find this registration; if the call is gated behind a React
+ * effect or any async work, registration arrives too late.
+ *
+ * Calling this function more than once replaces the previous handler.
+ *
+ * iOS does not support killed-state JS execution. On iOS this is a
+ * no-op. Use `getLocations()` or `getValidLocationsAndDelete()` on
+ * the next app launch instead.
+ */
+export declare function registerHeadlessHandler(handler: HeadlessHandler): void;
+//# sourceMappingURL=headless.d.ts.map

package/lib/typescript/src/headless.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"headless.d.ts","sourceRoot":"","sources":["../../../src/headless.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,QAAQ,EACR,kBAAkB,EAClB,QAAQ,EACT,MAAM,oCAAoC,CAAC;AAE5C;;;;GAIG;AACH,eAAO,MAAM,kBAAkB,iCAAiC,CAAC;AAEjE;;;GAGG;AACH,MAAM,MAAM,aAAa,GACrB;IAAE,KAAK,EAAE,UAAU,CAAC;IAAC,QAAQ,EAAE,QAAQ,CAAA;CAAE,GACzC;IAAE,KAAK,EAAE,YAAY,CAAC;IAAC,QAAQ,EAAE,kBAAkB,CAAA;CAAE,GACrD;IAAE,KAAK,EAAE,UAAU,CAAC;IAAC,QAAQ,EAAE,QAAQ,CAAA;CAAE,CAAC;AAE9C,MAAM,MAAM,eAAe,GAAG,CAAC,KAAK,EAAE,aAAa,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;AAkC7E;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,eAAe,GAAG,IAAI,CAiBtE"}

package/lib/typescript/src/index.d.ts

@@ -0,0 +1,8 @@
+import type { NitroBackgroundGeolocation } from './NitroBackgroundGeolocation.nitro';
+export { registerHeadlessHandler, type HeadlessEvent, type HeadlessHandler, } from './headless';
+export { LocationProvider, ServiceMode, AuthorizationStatus, LocationAccuracy, NativeLogLevel as LogLevel, LocationErrorCode, } from './NitroBackgroundGeolocation.nitro';
+export type { ConfigureOptions, Location, StationaryLocation, Activity, ServiceStatus, LogEntry, LocationOptions, BackgroundGeolocationError, } from './NitroBackgroundGeolocation.nitro';
+type OwnMethods = Omit<NitroBackgroundGeolocation, 'name' | 'toString' | 'equals' | 'dispose' | '__type'>;
+declare const BackgroundGeolocation: OwnMethods;
+export default BackgroundGeolocation;
+//# sourceMappingURL=index.d.ts.map

package/lib/typescript/src/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/index.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,oCAAoC,CAAC;AAErF,OAAO,EACL,uBAAuB,EACvB,KAAK,aAAa,EAClB,KAAK,eAAe,GACrB,MAAM,YAAY,CAAC;AAGpB,OAAO,EACL,gBAAgB,EAChB,WAAW,EACX,mBAAmB,EACnB,gBAAgB,EAChB,cAAc,IAAI,QAAQ,EAC1B,iBAAiB,GAClB,MAAM,oCAAoC,CAAC;AAE5C,YAAY,EACV,gBAAgB,EAChB,QAAQ,EACR,kBAAkB,EAClB,QAAQ,EACR,aAAa,EACb,QAAQ,EACR,eAAe,EACf,0BAA0B,GAC3B,MAAM,oCAAoC,CAAC;AAa5C,KAAK,UAAU,GAAG,IAAI,CACpB,0BAA0B,EAC1B,MAAM,GAAG,UAAU,GAAG,QAAQ,GAAG,SAAS,GAAG,QAAQ,CACtD,CAAC;AASF,QAAA,MAAM,qBAAqB,EAAE,UA4C5B,CAAC;AAEF,eAAe,qBAAqB,CAAC"}