@kafitra/react-native-live-tracking 0.1.0

package/lib/module/validation.js

@@ -0,0 +1,456 @@
+/**
+ * Configuration validation and default value application for react-native-live-tracking.
+ *
+ * @packageDocumentation
+ */
+
+// ─── Default Values ──────────────────────────────────────────────────────────
+
+const DEFAULT_INTERVAL_MS = 10000;
+const DEFAULT_DISTANCE_FILTER_METERS = 10;
+const DEFAULT_STOP_WHEN_STILL = true;
+const DEFAULT_MODE = 'both';
+const VALID_OPTIMIZATION_MODES = ['interval', 'distance', 'both'];
+
+// ─── Validation Constants ────────────────────────────────────────────────────
+
+const MAX_TARGETS = 20;
+const MAX_PATH_LENGTH = 768;
+const MAX_BATCH_SIZE = 1000;
+const VALID_METHODS = ['set', 'push', 'update'];
+
+// ─── Validation ──────────────────────────────────────────────────────────────
+
+/**
+ * Validates a raw configuration object and returns a structured result
+ * indicating whether the config is valid or contains errors.
+ *
+ * @param config - The raw configuration object to validate (unknown type for safety)
+ * @returns A ConfigValidationResult with validity status and any errors found
+ */
+export function validateConfig(config) {
+  const errors = [];
+
+  // Check that config is an object
+  if (config === null || config === undefined || typeof config !== 'object') {
+    errors.push({
+      field: 'config',
+      message: 'Configuration must be a non-null object',
+      code: 'INVALID_TYPE'
+    });
+    return {
+      valid: false,
+      errors
+    };
+  }
+  const cfg = config;
+
+  // Validate optimization
+  validateOptimization(cfg['optimization'], errors);
+
+  // Validate firebase
+  validateFirebase(cfg['firebase'], errors);
+
+  // Validate androidNotification (optional)
+  if (cfg['androidNotification'] !== undefined) {
+    validateAndroidNotification(cfg['androidNotification'], errors);
+  }
+
+  // Validate iosNotification (optional)
+  if (cfg['iosNotification'] !== undefined) {
+    validateIOSNotification(cfg['iosNotification'], errors);
+  }
+  return {
+    valid: errors.length === 0,
+    errors
+  };
+}
+
+/**
+ * Applies default values to a valid TrackingConfig object.
+ * Should only be called after validateConfig returns valid: true.
+ *
+ * Note: Sync target defaults (batchSize, offlineQueue) are handled per-target
+ * at the native layer. Targets pass through without modification here.
+ *
+ * @param config - A valid TrackingConfig object
+ * @returns A new TrackingConfig with all defaults applied
+ */
+export function applyDefaults(config) {
+  return {
+    ...config,
+    optimization: {
+      intervalMs: config.optimization.intervalMs ?? DEFAULT_INTERVAL_MS,
+      distanceFilterMeters: config.optimization.distanceFilterMeters ?? DEFAULT_DISTANCE_FILTER_METERS,
+      stopWhenStill: config.optimization.stopWhenStill ?? DEFAULT_STOP_WHEN_STILL,
+      mode: config.optimization.mode ?? DEFAULT_MODE
+    },
+    firebase: {
+      service: config.firebase.service,
+      targets: config.firebase.targets
+    }
+  };
+}
+
+// ─── Internal Validation Helpers ─────────────────────────────────────────────
+
+function validateOptimization(optimization, errors) {
+  if (optimization === undefined || optimization === null) {
+    errors.push({
+      field: 'optimization',
+      message: 'optimization is required and must be an object',
+      code: 'REQUIRED_FIELD'
+    });
+    return;
+  }
+  if (typeof optimization !== 'object') {
+    errors.push({
+      field: 'optimization',
+      message: 'optimization must be an object',
+      code: 'INVALID_TYPE'
+    });
+    return;
+  }
+  const opt = optimization;
+
+  // intervalMs (optional, but if provided must be positive number)
+  if (opt['intervalMs'] !== undefined) {
+    if (typeof opt['intervalMs'] !== 'number' || !isFinite(opt['intervalMs'])) {
+      errors.push({
+        field: 'optimization.intervalMs',
+        message: 'intervalMs must be a finite number',
+        code: 'INVALID_TYPE'
+      });
+    } else if (opt['intervalMs'] <= 0) {
+      errors.push({
+        field: 'optimization.intervalMs',
+        message: 'intervalMs must be greater than 0',
+        code: 'OUT_OF_RANGE'
+      });
+    }
+  }
+
+  // distanceFilterMeters (optional, but if provided must be positive number)
+  if (opt['distanceFilterMeters'] !== undefined) {
+    if (typeof opt['distanceFilterMeters'] !== 'number' || !isFinite(opt['distanceFilterMeters'])) {
+      errors.push({
+        field: 'optimization.distanceFilterMeters',
+        message: 'distanceFilterMeters must be a finite number',
+        code: 'INVALID_TYPE'
+      });
+    } else if (opt['distanceFilterMeters'] <= 0) {
+      errors.push({
+        field: 'optimization.distanceFilterMeters',
+        message: 'distanceFilterMeters must be greater than 0',
+        code: 'OUT_OF_RANGE'
+      });
+    }
+  }
+
+  // stopWhenStill (optional, but if provided must be boolean)
+  if (opt['stopWhenStill'] !== undefined) {
+    if (typeof opt['stopWhenStill'] !== 'boolean') {
+      errors.push({
+        field: 'optimization.stopWhenStill',
+        message: 'stopWhenStill must be a boolean',
+        code: 'INVALID_TYPE'
+      });
+    }
+  }
+
+  // mode (optional, but if provided must be 'interval', 'distance', or 'both')
+  if (opt['mode'] !== undefined) {
+    if (typeof opt['mode'] !== 'string' || !VALID_OPTIMIZATION_MODES.includes(opt['mode'])) {
+      errors.push({
+        field: 'optimization.mode',
+        message: `optimization.mode must be 'interval', 'distance', or 'both'`,
+        code: 'INVALID_VALUE'
+      });
+    }
+  }
+}
+function validateFirebase(firebase, errors) {
+  if (firebase === undefined || firebase === null) {
+    errors.push({
+      field: 'firebase',
+      message: 'firebase is required and must be an object',
+      code: 'REQUIRED_FIELD'
+    });
+    return;
+  }
+  if (typeof firebase !== 'object') {
+    errors.push({
+      field: 'firebase',
+      message: 'firebase must be an object',
+      code: 'INVALID_TYPE'
+    });
+    return;
+  }
+  const fb = firebase;
+
+  // Detect deprecated fields
+  validateDeprecatedFields(fb, errors);
+
+  // service (required, must be 'RTDB' or 'Firestore')
+  if (fb['service'] === undefined || fb['service'] === null) {
+    errors.push({
+      field: 'firebase.service',
+      message: "firebase.service is required and must be 'RTDB' or 'Firestore'",
+      code: 'REQUIRED_FIELD'
+    });
+  } else if (fb['service'] !== 'RTDB' && fb['service'] !== 'Firestore') {
+    errors.push({
+      field: 'firebase.service',
+      message: `firebase.service must be 'RTDB' or 'Firestore', got '${String(fb['service'])}'`,
+      code: 'INVALID_VALUE'
+    });
+  }
+
+  // Validate targets array
+  validateTargets(fb['targets'], errors);
+}
+function validateDeprecatedFields(fb, errors) {
+  if (fb['currentLocationPath'] !== undefined) {
+    errors.push({
+      field: 'firebase.currentLocationPath',
+      message: 'currentLocationPath is deprecated. Migrate to the targets array by adding a SyncTarget with method \'set\'',
+      code: 'DEPRECATED_FIELD'
+    });
+  }
+  if (fb['historyPath'] !== undefined) {
+    errors.push({
+      field: 'firebase.historyPath',
+      message: 'historyPath is deprecated. Migrate to the targets array by adding a SyncTarget with method \'push\'',
+      code: 'DEPRECATED_FIELD'
+    });
+  }
+  if (fb['historyBatchSize'] !== undefined) {
+    errors.push({
+      field: 'firebase.historyBatchSize',
+      message: 'historyBatchSize is deprecated. Migrate to per-target batchSize in the targets array',
+      code: 'DEPRECATED_FIELD'
+    });
+  }
+}
+function validateTargets(targets, errors) {
+  if (targets === undefined || targets === null || !Array.isArray(targets)) {
+    errors.push({
+      field: 'firebase.targets',
+      message: 'firebase.targets is required and must be an array',
+      code: 'REQUIRED_FIELD'
+    });
+    return;
+  }
+  if (targets.length === 0) {
+    errors.push({
+      field: 'firebase.targets',
+      message: 'firebase.targets must contain at least 1 sync target',
+      code: 'INVALID_VALUE'
+    });
+    return;
+  }
+  if (targets.length > MAX_TARGETS) {
+    errors.push({
+      field: 'firebase.targets',
+      message: `firebase.targets must contain at most ${MAX_TARGETS} sync targets, got ${targets.length}`,
+      code: 'INVALID_VALUE'
+    });
+  }
+
+  // Validate each target
+  const seenPaths = new Set();
+  for (let i = 0; i < targets.length; i++) {
+    const target = targets[i];
+    const prefix = `firebase.targets[${i}]`;
+    if (target === null || target === undefined || typeof target !== 'object') {
+      errors.push({
+        field: prefix,
+        message: `${prefix} must be an object`,
+        code: 'INVALID_TYPE'
+      });
+      continue;
+    }
+    const t = target;
+
+    // Validate path
+    validateTargetPath(t['path'], i, prefix, errors, seenPaths);
+
+    // Validate method
+    validateTargetMethod(t['method'], i, prefix, errors);
+
+    // Validate batchSize (optional)
+    if (t['batchSize'] !== undefined) {
+      validateTargetBatchSize(t['batchSize'], i, prefix, errors);
+    }
+
+    // Validate offlineQueue (optional)
+    if (t['offlineQueue'] !== undefined) {
+      validateTargetOfflineQueue(t['offlineQueue'], i, prefix, errors);
+    }
+  }
+}
+function validateTargetPath(path, _index, prefix, errors, seenPaths) {
+  if (path === undefined || path === null || typeof path !== 'string') {
+    errors.push({
+      field: `${prefix}.path`,
+      message: `${prefix}.path is required and must be a string`,
+      code: 'REQUIRED_FIELD'
+    });
+    return;
+  }
+  if (path.trim().length === 0) {
+    errors.push({
+      field: `${prefix}.path`,
+      message: `${prefix}.path must not be empty or whitespace-only`,
+      code: 'INVALID_VALUE'
+    });
+    return;
+  }
+  if (path.length > MAX_PATH_LENGTH) {
+    errors.push({
+      field: `${prefix}.path`,
+      message: `${prefix}.path must not exceed ${MAX_PATH_LENGTH} characters, got ${path.length}`,
+      code: 'INVALID_VALUE'
+    });
+    return;
+  }
+
+  // Check for duplicate paths (case-sensitive)
+  if (seenPaths.has(path)) {
+    errors.push({
+      field: `${prefix}.path`,
+      message: `${prefix}.path '${path}' is a duplicate; each target must have a unique path`,
+      code: 'DUPLICATE_VALUE'
+    });
+  } else {
+    seenPaths.add(path);
+  }
+}
+function validateTargetMethod(method, _index, prefix, errors) {
+  if (method === undefined || method === null) {
+    errors.push({
+      field: `${prefix}.method`,
+      message: `${prefix}.method is required and must be 'set', 'push', or 'update'`,
+      code: 'REQUIRED_FIELD'
+    });
+    return;
+  }
+  if (typeof method !== 'string' || !VALID_METHODS.includes(method)) {
+    errors.push({
+      field: `${prefix}.method`,
+      message: `${prefix}.method must be 'set', 'push', or 'update', got '${String(method)}'`,
+      code: 'INVALID_VALUE'
+    });
+  }
+}
+function validateTargetBatchSize(batchSize, _index, prefix, errors) {
+  if (typeof batchSize !== 'number' || !isFinite(batchSize) || !Number.isInteger(batchSize)) {
+    errors.push({
+      field: `${prefix}.batchSize`,
+      message: `${prefix}.batchSize must be a positive integer between 1 and ${MAX_BATCH_SIZE}`,
+      code: 'INVALID_VALUE'
+    });
+    return;
+  }
+  if (batchSize < 1 || batchSize > MAX_BATCH_SIZE) {
+    errors.push({
+      field: `${prefix}.batchSize`,
+      message: `${prefix}.batchSize must be between 1 and ${MAX_BATCH_SIZE}, got ${batchSize}`,
+      code: 'OUT_OF_RANGE'
+    });
+  }
+}
+function validateTargetOfflineQueue(offlineQueue, _index, prefix, errors) {
+  if (typeof offlineQueue !== 'boolean') {
+    errors.push({
+      field: `${prefix}.offlineQueue`,
+      message: `${prefix}.offlineQueue must be a boolean`,
+      code: 'INVALID_TYPE'
+    });
+  }
+}
+function validateAndroidNotification(notification, errors) {
+  if (typeof notification !== 'object' || notification === null) {
+    errors.push({
+      field: 'androidNotification',
+      message: 'androidNotification must be an object',
+      code: 'INVALID_TYPE'
+    });
+    return;
+  }
+  const notif = notification;
+
+  // enabled (optional, but if provided must be boolean)
+  if (notif['enabled'] !== undefined && typeof notif['enabled'] !== 'boolean') {
+    errors.push({
+      field: 'androidNotification.enabled',
+      message: 'androidNotification.enabled must be a boolean',
+      code: 'INVALID_TYPE'
+    });
+  }
+  const isEnabled = notif['enabled'] !== false;
+
+  // title and text are only required when notification is enabled
+  if (isEnabled) {
+    // title (required, non-empty string)
+    if (typeof notif['title'] !== 'string' || notif['title'].trim().length === 0) {
+      errors.push({
+        field: 'androidNotification.title',
+        message: 'androidNotification.title must be a non-empty string',
+        code: 'REQUIRED_FIELD'
+      });
+    }
+
+    // text (required, non-empty string)
+    if (typeof notif['text'] !== 'string' || notif['text'].trim().length === 0) {
+      errors.push({
+        field: 'androidNotification.text',
+        message: 'androidNotification.text must be a non-empty string',
+        code: 'REQUIRED_FIELD'
+      });
+    }
+  }
+}
+function validateIOSNotification(notification, errors) {
+  if (typeof notification !== 'object' || notification === null) {
+    errors.push({
+      field: 'iosNotification',
+      message: 'iosNotification must be an object',
+      code: 'INVALID_TYPE'
+    });
+    return;
+  }
+  const notif = notification;
+
+  // enabled (optional, but if provided must be boolean)
+  if (notif['enabled'] !== undefined && typeof notif['enabled'] !== 'boolean') {
+    errors.push({
+      field: 'iosNotification.enabled',
+      message: 'iosNotification.enabled must be a boolean',
+      code: 'INVALID_TYPE'
+    });
+  }
+  const isEnabled = notif['enabled'] !== false;
+
+  // title and text are only required when notification is enabled
+  if (isEnabled) {
+    // title (required, non-empty string)
+    if (typeof notif['title'] !== 'string' || notif['title'].trim().length === 0) {
+      errors.push({
+        field: 'iosNotification.title',
+        message: 'iosNotification.title must be a non-empty string',
+        code: 'REQUIRED_FIELD'
+      });
+    }
+
+    // text (required, non-empty string)
+    if (typeof notif['text'] !== 'string' || notif['text'].trim().length === 0) {
+      errors.push({
+        field: 'iosNotification.text',
+        message: 'iosNotification.text must be a non-empty string',
+        code: 'REQUIRED_FIELD'
+      });
+    }
+  }
+}
+//# sourceMappingURL=validation.js.map

package/lib/module/validation.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["DEFAULT_INTERVAL_MS","DEFAULT_DISTANCE_FILTER_METERS","DEFAULT_STOP_WHEN_STILL","DEFAULT_MODE","VALID_OPTIMIZATION_MODES","MAX_TARGETS","MAX_PATH_LENGTH","MAX_BATCH_SIZE","VALID_METHODS","validateConfig","config","errors","undefined","push","field","message","code","valid","cfg","validateOptimization","validateFirebase","validateAndroidNotification","validateIOSNotification","length","applyDefaults","optimization","intervalMs","distanceFilterMeters","stopWhenStill","mode","firebase","service","targets","opt","isFinite","includes","fb","validateDeprecatedFields","String","validateTargets","Array","isArray","seenPaths","Set","i","target","prefix","t","validateTargetPath","validateTargetMethod","validateTargetBatchSize","validateTargetOfflineQueue","path","_index","trim","has","add","method","batchSize","Number","isInteger","offlineQueue","notification","notif","isEnabled"],"sourceRoot":"../../src","sources":["validation.ts"],"mappings":"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","ignoreList":[]}

package/lib/typescript/EventEmitter.d.ts

@@ -0,0 +1,65 @@
+/**
+ * Event listener system for react-native-live-tracking.
+ *
+ * Wraps NativeEventEmitter to provide typed event subscriptions
+ * for location updates and tracking errors.
+ *
+ * @packageDocumentation
+ */
+import type { LocationData, TrackingError, Subscription } from './types';
+/**
+ * Directly use the global device event emitter.
+ *
+ * NativeEventEmitter's constructor accesses Platform.OS, which requires the
+ * PlatformConstants native module. In a broken or partially-initialised binary
+ * that module can be missing and crash the app before we can even report that
+ * LiveTracking is unavailable. DeviceEventEmitter avoids that dependency
+ * entirely while still delivering native events emitted by the LiveTracking
+ * RCTEventEmitter.
+ */
+/**
+ * Register a callback for location updates.
+ *
+ * The callback is invoked each time a valid location update is emitted
+ * from the native layer after passing the Distance/Time Matrix filter.
+ *
+ * @param callback - Function called with LocationData on each update
+ * @returns Subscription with `remove()` method to unsubscribe
+ *
+ * @example
+ * ```ts
+ * const subscription = onLocationUpdate((location) => {
+ *   console.log(location.latitude, location.longitude);
+ * });
+ * // Later: unsubscribe
+ * subscription.remove();
+ * ```
+ */
+export declare function onLocationUpdate(callback: (location: LocationData) => void): Subscription;
+/**
+ * Register a callback for tracking errors.
+ *
+ * The callback is invoked when an error occurs during tracking
+ * (e.g., permission denied, GPS disabled, Firebase write failure).
+ *
+ * @param callback - Function called with TrackingError on each error event
+ * @returns Subscription with `remove()` method to unsubscribe
+ *
+ * @example
+ * ```ts
+ * const subscription = onError((error) => {
+ *   console.error(`[${error.code}] ${error.message}`);
+ * });
+ * // Later: unsubscribe
+ * subscription.remove();
+ * ```
+ */
+export declare function onError(callback: (error: TrackingError) => void): Subscription;
+/**
+ * Remove all event listeners registered through this module.
+ *
+ * Useful for cleanup when the tracking module is being torn down
+ * or when all subscriptions need to be cleared at once.
+ */
+export declare function removeAllListeners(): void;
+//# sourceMappingURL=EventEmitter.d.ts.map

package/lib/typescript/EventEmitter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"EventEmitter.d.ts","sourceRoot":"","sources":["../../src/EventEmitter.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,KAAK,EAAE,YAAY,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAEzE;;;;;;;;;GASG;AAEH;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,gBAAgB,CAC9B,QAAQ,EAAE,CAAC,QAAQ,EAAE,YAAY,KAAK,IAAI,GACzC,YAAY,CAsBd;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,OAAO,CACrB,QAAQ,EAAE,CAAC,KAAK,EAAE,aAAa,KAAK,IAAI,GACvC,YAAY,CAmBd;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,IAAI,IAAI,CAGzC"}

package/lib/typescript/LiveTracking.d.ts

@@ -0,0 +1,23 @@
+/**
+ * JavaScript LiveTracking module that wraps NativeModule calls.
+ *
+ * Provides the public API for configuring, starting, and stopping
+ * location tracking, with validation and state management.
+ *
+ * @packageDocumentation
+ */
+import type { LiveTrackingModule } from './types';
+/**
+ * Resets the configured state. Only for use in tests.
+ * @internal
+ */
+export declare function _resetConfiguredStateForTesting(): void;
+/**
+ * LiveTracking module implementation.
+ *
+ * Wraps native module calls with validation, serialization,
+ * and state management on the JavaScript side.
+ */
+declare const LiveTracking: LiveTrackingModule;
+export default LiveTracking;
+//# sourceMappingURL=LiveTracking.d.ts.map

package/lib/typescript/LiveTracking.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"LiveTracking.d.ts","sourceRoot":"","sources":["../../src/LiveTracking.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAOH,OAAO,KAAK,EAMV,kBAAkB,EACnB,MAAM,SAAS,CAAC;AAwBjB;;;GAGG;AACH,wBAAgB,+BAA+B,IAAI,IAAI,CAEtD;AAED;;;;;GAKG;AACH,QAAA,MAAM,YAAY,EAAE,kBAiGnB,CAAC;AAEF,eAAe,YAAY,CAAC"}

package/lib/typescript/NativeLiveTracking.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Codegen spec for react-native-live-tracking.
+ *
+ * Uses TurboModuleRegistry.get (not getEnforcing) so that a missing or
+ * not-yet-registered module returns null instead of throwing synchronously.
+ * A top-level throw would corrupt the module graph and leave upstream
+ * importers (TrackingProvider, AppNavigator) with undefined module records.
+ *
+ * File must be named Native*.ts and live in the codegenConfig.jsSrcsDir
+ * for RN's codegen to pick it up.
+ */
+import type { TurboModule } from 'react-native';
+export interface Spec extends TurboModule {
+    configure(config: string): Promise<void>;
+    start(): Promise<void>;
+    stop(): Promise<void>;
+    getStatus(): Promise<string>;
+    getQueuedLocations(): Promise<number>;
+    getQueuedLocationsByTarget(): Promise<string>;
+    addListener(eventName: string): void;
+    removeListeners(count: number): void;
+}
+declare const _default: Spec | null;
+export default _default;
+//# sourceMappingURL=NativeLiveTracking.d.ts.map

package/lib/typescript/NativeLiveTracking.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"NativeLiveTracking.d.ts","sourceRoot":"","sources":["../../src/NativeLiveTracking.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAGhD,MAAM,WAAW,IAAK,SAAQ,WAAW;IACvC,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACzC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACvB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACtB,SAAS,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;IAC7B,kBAAkB,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;IACtC,0BAA0B,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;IAC9C,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACrC,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;CACtC;wBAIgC,IAAI,GAAG,IAAI;AAD5C,wBAC6C"}

package/lib/typescript/filters/distanceTimeFilter.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Distance/Time Matrix filter for location updates.
+ *
+ * This filter implements the battery optimization strategy that accepts a new
+ * location update based on the selected mode:
+ * - 'both' (default): BOTH time and distance conditions must be met
+ * - 'interval': only the time condition must be met
+ * - 'distance': only the distance condition must be met
+ *
+ * @packageDocumentation
+ */
+import type { LocationData, OptimizationConfig } from '../types';
+/**
+ * Configuration subset required by the distance/time filter.
+ */
+export type DistanceTimeFilterConfig = Required<Pick<OptimizationConfig, 'intervalMs' | 'distanceFilterMeters'>> & {
+    /** Filter strategy. Defaults to 'both' if not provided. */
+    mode?: 'interval' | 'distance' | 'both';
+};
+/**
+ * Determines whether a new location should be accepted based on the
+ * Distance/Time Matrix filter criteria.
+ *
+ * The filtering strategy depends on `config.mode`:
+ * - 'both': accepted only if both time and distance conditions are met
+ * - 'interval': accepted only if enough time has elapsed
+ * - 'distance': accepted only if enough distance has been covered
+ *
+ * @param lastLocation - The most recently accepted location
+ * @param newLocation - The candidate location to evaluate
+ * @param config - Filter configuration with intervalMs, distanceFilterMeters, and mode
+ * @returns `true` if the new location should be accepted, `false` otherwise
+ *
+ * @example
+ * ```typescript
+ * const accepted = shouldAcceptLocation(
+ *   { latitude: -6.2088, longitude: 106.8456, timestamp: 1700000000000, accuracy: 5, speed: null, altitude: null, bearing: null },
+ *   { latitude: -6.2090, longitude: 106.8460, timestamp: 1700000015000, accuracy: 5, speed: 1.2, altitude: null, bearing: null },
+ *   { intervalMs: 10000, distanceFilterMeters: 10, mode: 'both' }
+ * );
+ * ```
+ */
+export declare function shouldAcceptLocation(lastLocation: LocationData, newLocation: LocationData, config: DistanceTimeFilterConfig): boolean;
+//# sourceMappingURL=distanceTimeFilter.d.ts.map

package/lib/typescript/filters/distanceTimeFilter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"distanceTimeFilter.d.ts","sourceRoot":"","sources":["../../../src/filters/distanceTimeFilter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAGH,OAAO,KAAK,EAAE,YAAY,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAC;AAEjE;;GAEG;AACH,MAAM,MAAM,wBAAwB,GAAG,QAAQ,CAC7C,IAAI,CAAC,kBAAkB,EAAE,YAAY,GAAG,sBAAsB,CAAC,CAChE,GAAG;IACF,2DAA2D;IAC3D,IAAI,CAAC,EAAE,UAAU,GAAG,UAAU,GAAG,MAAM,CAAC;CACzC,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,oBAAoB,CAClC,YAAY,EAAE,YAAY,EAC1B,WAAW,EAAE,YAAY,EACzB,MAAM,EAAE,wBAAwB,GAC/B,OAAO,CAsBT"}

package/lib/typescript/index.d.ts

@@ -0,0 +1,21 @@
+/**
+ * react-native-live-tracking
+ *
+ * Real-time location tracking library for React Native with Firebase synchronization.
+ * Supports both TurboModules (new architecture) and Bridge (old architecture).
+ *
+ * @packageDocumentation
+ */
+import LiveTracking from './LiveTracking';
+export default LiveTracking;
+export { default as LiveTracking } from './LiveTracking';
+export { TrackingState } from './types';
+export type { SyncTarget, OptimizationConfig, OptimizationMode, AndroidNotificationConfig, IOSNotificationConfig, FirebaseConfig, TrackingConfig, LocationData, TrackingError, TrackingStatus, ConfigError, ConfigValidationResult, Subscription, LiveTrackingModule, } from './types';
+export { onLocationUpdate, onError, removeAllListeners } from './EventEmitter';
+export { validateConfig, applyDefaults } from './validation';
+export { calculateDistance } from './utils/distance';
+export { shouldAcceptLocation } from './filters/distanceTimeFilter';
+export { serializeLocationForTarget } from './serialization/locationSerializer';
+export type { TargetLocationPayload } from './serialization/locationSerializer';
+export { calculateBackoffDelay, shouldRetry } from './utils/retry';
+//# sourceMappingURL=index.d.ts.map