@kafitra/react-native-live-tracking 0.1.0

package/lib/commonjs/validation.js

@@ -0,0 +1,463 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.applyDefaults = applyDefaults;
+exports.validateConfig = validateConfig;
+/**
+ * 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
+ */
+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
+ */
+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/commonjs/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/module/EventEmitter.js

@@ -0,0 +1,105 @@
+/**
+ * Event listener system for react-native-live-tracking.
+ *
+ * Wraps NativeEventEmitter to provide typed event subscriptions
+ * for location updates and tracking errors.
+ *
+ * @packageDocumentation
+ */
+
+import { DeviceEventEmitter } from 'react-native';
+/**
+ * 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 function onLocationUpdate(callback) {
+  const nativeSubscription = DeviceEventEmitter.addListener('onLocationUpdate', event => {
+    const location = {
+      latitude: event.latitude,
+      longitude: event.longitude,
+      timestamp: event.timestamp,
+      accuracy: event.accuracy,
+      speed: event.speed ?? null,
+      altitude: event.altitude ?? null,
+      bearing: event.bearing ?? null
+    };
+    callback(location);
+  });
+  return {
+    remove: () => {
+      nativeSubscription.remove();
+    }
+  };
+}
+
+/**
+ * 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 function onError(callback) {
+  const nativeSubscription = DeviceEventEmitter.addListener('onTrackingError', event => {
+    const error = {
+      code: event.code,
+      message: event.message,
+      recoverable: event.recoverable ?? true,
+      details: event.details ?? undefined
+    };
+    callback(error);
+  });
+  return {
+    remove: () => {
+      nativeSubscription.remove();
+    }
+  };
+}
+
+/**
+ * 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 function removeAllListeners() {
+  DeviceEventEmitter.removeAllListeners('onLocationUpdate');
+  DeviceEventEmitter.removeAllListeners('onTrackingError');
+}
+//# sourceMappingURL=EventEmitter.js.map

package/lib/module/EventEmitter.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["DeviceEventEmitter","onLocationUpdate","callback","nativeSubscription","addListener","event","location","latitude","longitude","timestamp","accuracy","speed","altitude","bearing","remove","onError","error","code","message","recoverable","details","undefined","removeAllListeners"],"sourceRoot":"../../src","sources":["EventEmitter.ts"],"mappings":"AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAEA,SAASA,kBAAkB,QAAQ,cAAc;AAGjD;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASC,gBAAgBA,CAC9BC,QAA0C,EAC5B;EACd,MAAMC,kBAAkB,GAAGH,kBAAkB,CAACI,WAAW,CACvD,kBAAkB,EACjBC,KAA8B,IAAK;IAClC,MAAMC,QAAsB,GAAG;MAC7BC,QAAQ,EAAEF,KAAK,CAACE,QAAkB;MAClCC,SAAS,EAAEH,KAAK,CAACG,SAAmB;MACpCC,SAAS,EAAEJ,KAAK,CAACI,SAAmB;MACpCC,QAAQ,EAAEL,KAAK,CAACK,QAAkB;MAClCC,KAAK,EAAGN,KAAK,CAACM,KAAK,IAAsB,IAAI;MAC7CC,QAAQ,EAAGP,KAAK,CAACO,QAAQ,IAAsB,IAAI;MACnDC,OAAO,EAAGR,KAAK,CAACQ,OAAO,IAAsB;IAC/C,CAAC;IACDX,QAAQ,CAACI,QAAQ,CAAC;EACpB,CACF,CAAC;EAED,OAAO;IACLQ,MAAM,EAAEA,CAAA,KAAM;MACZX,kBAAkB,CAACW,MAAM,CAAC,CAAC;IAC7B;EACF,CAAC;AACH;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASC,OAAOA,CACrBb,QAAwC,EAC1B;EACd,MAAMC,kBAAkB,GAAGH,kBAAkB,CAACI,WAAW,CACvD,iBAAiB,EAChBC,KAA8B,IAAK;IAClC,MAAMW,KAAoB,GAAG;MAC3BC,IAAI,EAAEZ,KAAK,CAACY,IAAc;MAC1BC,OAAO,EAAEb,KAAK,CAACa,OAAiB;MAChCC,WAAW,EAAGd,KAAK,CAACc,WAAW,IAAgB,IAAI;MACnDC,OAAO,EAAGf,KAAK,CAACe,OAAO,IAAgCC;IACzD,CAAC;IACDnB,QAAQ,CAACc,KAAK,CAAC;EACjB,CACF,CAAC;EAED,OAAO;IACLF,MAAM,EAAEA,CAAA,KAAM;MACZX,kBAAkB,CAACW,MAAM,CAAC,CAAC;IAC7B;EACF,CAAC;AACH;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASQ,kBAAkBA,CAAA,EAAS;EACzCtB,kBAAkB,CAACsB,kBAAkB,CAAC,kBAAkB,CAAC;EACzDtB,kBAAkB,CAACsB,kBAAkB,CAAC,iBAAiB,CAAC;AAC1D","ignoreList":[]}