@kafitra/react-native-live-tracking 0.1.0

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,YAAY,MAAM,gBAAgB,CAAC;AAE1C,eAAe,YAAY,CAAC;AAC5B,OAAO,EAAE,OAAO,IAAI,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAGzD,OAAO,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AACxC,YAAY,EACV,UAAU,EACV,kBAAkB,EAClB,gBAAgB,EAChB,yBAAyB,EACzB,qBAAqB,EACrB,cAAc,EACd,cAAc,EACd,YAAY,EACZ,aAAa,EACb,cAAc,EACd,WAAW,EACX,sBAAsB,EACtB,YAAY,EACZ,kBAAkB,GACnB,MAAM,SAAS,CAAC;AAGjB,OAAO,EAAE,gBAAgB,EAAE,OAAO,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AAG/E,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAG7D,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAGrD,OAAO,EAAE,oBAAoB,EAAE,MAAM,8BAA8B,CAAC;AAGpE,OAAO,EAAE,0BAA0B,EAAE,MAAM,oCAAoC,CAAC;AAChF,YAAY,EAAE,qBAAqB,EAAE,MAAM,oCAAoC,CAAC;AAGhF,OAAO,EAAE,qBAAqB,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC"}

package/lib/typescript/serialization/locationSerializer.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Location serialization for Firebase sync targets.
+ *
+ * Transforms LocationData into a generic payload suitable for any
+ * sync target, regardless of write method (set, push, update).
+ *
+ * @packageDocumentation
+ */
+import type { LocationData } from '../types';
+/**
+ * Serialized location payload for any sync target.
+ *
+ * Contains required fields (latitude, longitude, timestamp, accuracy)
+ * and optional sensor fields (speed, heading, altitude) which are
+ * included as `null` when unavailable from the device sensor.
+ * Placeholder values (0, -1) are never used for unavailable fields.
+ */
+export interface TargetLocationPayload {
+    latitude: number;
+    longitude: number;
+    timestamp: number;
+    accuracy: number;
+    speed: number | null;
+    heading: number | null;
+    altitude: number | null;
+}
+/**
+ * Serialize a LocationData object for a generic Firebase sync target.
+ *
+ * Produces a payload containing all required location fields and optional
+ * sensor fields. When optional fields (speed, heading/bearing, altitude)
+ * are unavailable from the device sensor, they are included as `null`.
+ * Default placeholder values (0, -1) are never written for unavailable fields.
+ *
+ * @param location - The location data to serialize
+ * @returns Serialized payload for the sync target
+ */
+export declare function serializeLocationForTarget(location: LocationData): TargetLocationPayload;
+//# sourceMappingURL=locationSerializer.d.ts.map

package/lib/typescript/serialization/locationSerializer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"locationSerializer.d.ts","sourceRoot":"","sources":["../../../src/serialization/locationSerializer.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAI7C;;;;;;;GAOG;AACH,MAAM,WAAW,qBAAqB;IACpC,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;CACzB;AAID;;;;;;;;;;GAUG;AACH,wBAAgB,0BAA0B,CACxC,QAAQ,EAAE,YAAY,GACrB,qBAAqB,CAUvB"}

package/lib/typescript/types.d.ts

@@ -0,0 +1,217 @@
+/**
+ * TypeScript type definitions for react-native-live-tracking.
+ *
+ * @packageDocumentation
+ */
+/**
+ * Internal state machine for tracking lifecycle.
+ */
+export declare enum TrackingState {
+    IDLE = "idle",
+    CONFIGURED = "configured",
+    TRACKING = "tracking",
+    MOTION_SLEEP = "motion_sleep",
+    PAUSED_GPS = "paused_gps"
+}
+/**
+ * Strategy used by the distance/time filter.
+ * - 'interval': accept when enough time has elapsed
+ * - 'distance': accept when enough distance has been covered
+ * - 'both': accept only when both conditions are met (default)
+ */
+export type OptimizationMode = 'interval' | 'distance' | 'both';
+/**
+ * Optimization parameters for location tracking.
+ */
+export interface OptimizationConfig {
+    /** Minimum time interval between location updates in milliseconds. Default: 10000 */
+    intervalMs?: number;
+    /** Minimum distance change in meters to trigger an update. Default: 10 */
+    distanceFilterMeters?: number;
+    /** Whether to reduce GPS accuracy when device is still. Default: true */
+    stopWhenStill?: boolean;
+    /** Filter strategy: 'interval', 'distance', or 'both'. Default: 'both' */
+    mode?: OptimizationMode;
+}
+/**
+ * Android foreground service notification configuration.
+ */
+export interface AndroidNotificationConfig {
+    /** Whether to show the foreground service notification. Default: true */
+    enabled?: boolean;
+    /** Notification title */
+    title: string;
+    /** Notification body text */
+    text: string;
+    /** Notification icon resource name */
+    icon?: string;
+    /** Notification channel ID */
+    channelId?: string;
+    /** Notification channel name */
+    channelName?: string;
+}
+/**
+ * iOS persistent notification configuration.
+ * Shows a local notification while tracking is active (similar to Android's foreground service notification).
+ */
+export interface IOSNotificationConfig {
+    /** Whether to show the persistent local notification. Default: true */
+    enabled?: boolean;
+    /** Notification title */
+    title: string;
+    /** Notification body text */
+    text: string;
+}
+/**
+ * A user-defined sync target specifying a Firebase path, write method,
+ * and optional batching/offline queue settings.
+ */
+export interface SyncTarget {
+    /** Firebase path to write to */
+    path: string;
+    /** Write method: 'set' (overwrite), 'push' (append), 'update' (merge) */
+    method: 'set' | 'push' | 'update';
+    /** Number of points to accumulate before writing. Default: 1 (immediate) */
+    batchSize?: number;
+    /** Whether to persist data offline when device has no connectivity */
+    offlineQueue?: boolean;
+}
+/**
+ * Firebase connection and sync target configuration.
+ */
+export interface FirebaseConfig {
+    /** Firebase service type: Realtime Database or Firestore */
+    service: 'RTDB' | 'Firestore';
+    /** Array of sync targets (at least one required) */
+    targets: [SyncTarget, ...SyncTarget[]];
+}
+/**
+ * Main configuration object passed to `configure()`.
+ */
+export interface TrackingConfig {
+    /** Optimization settings for battery and update frequency */
+    optimization: OptimizationConfig;
+    /** Android foreground service notification settings (Android only) */
+    androidNotification?: AndroidNotificationConfig;
+    /** iOS persistent notification settings (iOS only) */
+    iosNotification?: IOSNotificationConfig;
+    /** Firebase connection and path configuration */
+    firebase: FirebaseConfig;
+}
+/**
+ * Location data emitted by the library on each valid location update.
+ */
+export interface LocationData {
+    /** Latitude in degrees (-90 to 90) */
+    latitude: number;
+    /** Longitude in degrees (-180 to 180) */
+    longitude: number;
+    /** Unix timestamp in milliseconds */
+    timestamp: number;
+    /** Horizontal accuracy in meters */
+    accuracy: number;
+    /** Speed in meters per second, or null if unavailable */
+    speed: number | null;
+    /** Altitude in meters above sea level, or null if unavailable */
+    altitude: number | null;
+    /** Bearing/heading in degrees (0-360), or null if unavailable */
+    bearing: number | null;
+}
+/**
+ * Error object emitted by the library when tracking issues occur.
+ */
+export interface TrackingError {
+    /** Error code identifier (e.g., 'PERMISSION_DENIED', 'GPS_DISABLED') */
+    code: string;
+    /** Human-readable error message */
+    message: string;
+    /** Whether the error is recoverable (auto-retry or user action can fix) */
+    recoverable: boolean;
+    /** Additional error context */
+    details?: Record<string, unknown>;
+}
+/**
+ * Current tracking status snapshot.
+ */
+export interface TrackingStatus {
+    /** Current state of the tracking lifecycle */
+    state: TrackingState;
+    /** Whether the device currently has network connectivity */
+    isOnline: boolean;
+    /** Number of locations waiting in the offline queue */
+    queuedLocations: number;
+    /** Last known location, or null if no location has been received */
+    lastLocation: LocationData | null;
+    /** Current battery optimization mode */
+    batteryOptimization: 'full_accuracy' | 'low_power' | 'disabled';
+}
+/**
+ * Single configuration validation error.
+ */
+export interface ConfigError {
+    /** Dot-notation path to the invalid field (e.g., 'firebase.service') */
+    field: string;
+    /** Human-readable description of the validation error */
+    message: string;
+    /** Machine-readable error code */
+    code: string;
+}
+/**
+ * Result of configuration validation.
+ */
+export interface ConfigValidationResult {
+    /** Whether the configuration is valid */
+    valid: boolean;
+    /** List of validation errors (empty if valid) */
+    errors: ConfigError[];
+}
+/**
+ * Subscription handle returned by event listener registrations.
+ * Call `remove()` to unsubscribe from the event.
+ */
+export interface Subscription {
+    /** Unsubscribe from the event */
+    remove(): void;
+}
+/**
+ * Main public API interface for the react-native-live-tracking library.
+ */
+export interface LiveTrackingModule {
+    /**
+     * Configure the tracking library with the given parameters.
+     * Must be called before `start()`.
+     */
+    configure(config: TrackingConfig): Promise<void>;
+    /**
+     * Start location tracking. Requires `configure()` to have been called first.
+     */
+    start(): Promise<void>;
+    /**
+     * Stop location tracking and clean up resources.
+     */
+    stop(): Promise<void>;
+    /**
+     * Register a callback for location updates.
+     * Returns a Subscription that can be used to unsubscribe.
+     */
+    onLocationUpdate(callback: (location: LocationData) => void): Subscription;
+    /**
+     * Register a callback for tracking errors.
+     * Returns a Subscription that can be used to unsubscribe.
+     */
+    onError(callback: (error: TrackingError) => void): Subscription;
+    /**
+     * Get the current tracking status.
+     */
+    getStatus(): Promise<TrackingStatus>;
+    /**
+     * Get the number of locations currently queued for sync.
+     */
+    getQueuedLocations(): Promise<number>;
+    /**
+     * Get the number of queued locations per target path.
+     * Returns a record mapping each configured target path to its queued location count.
+     */
+    getQueuedLocationsByTarget(): Promise<Record<string, number>>;
+}
+//# sourceMappingURL=types.d.ts.map

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

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

package/lib/typescript/utils/distance.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Distance calculation utility using the Haversine formula.
+ *
+ * The Haversine formula determines the great-circle distance between two points
+ * on a sphere given their longitudes and latitudes. This is used by the
+ * Distance/Time Matrix filter to determine if a new location update has moved
+ * far enough from the last known position.
+ *
+ * @packageDocumentation
+ */
+/**
+ * Earth's mean radius in meters.
+ * Used as the sphere radius in the Haversine formula.
+ */
+export declare const EARTH_RADIUS_METERS = 6371000;
+/**
+ * Calculates the distance in meters between two geographic coordinates
+ * using the Haversine formula.
+ *
+ * The Haversine formula accounts for the curvature of the Earth and provides
+ * accurate results for short and medium distances. It assumes a spherical Earth
+ * with a mean radius of 6,371,000 meters.
+ *
+ * @param lat1 - Latitude of the first point in degrees (-90 to 90)
+ * @param lng1 - Longitude of the first point in degrees (-180 to 180)
+ * @param lat2 - Latitude of the second point in degrees (-90 to 90)
+ * @param lng2 - Longitude of the second point in degrees (-180 to 180)
+ * @returns Distance between the two points in meters
+ *
+ * @example
+ * ```typescript
+ * // Distance between Jakarta and Bandung (approximately 120 km)
+ * const distance = calculateDistance(-6.2088, 106.8456, -6.9175, 107.6191);
+ * console.log(distance); // ~120,000 meters
+ * ```
+ */
+export declare function calculateDistance(lat1: number, lng1: number, lat2: number, lng2: number): number;
+//# sourceMappingURL=distance.d.ts.map

package/lib/typescript/utils/distance.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"distance.d.ts","sourceRoot":"","sources":["../../../src/utils/distance.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH;;;GAGG;AACH,eAAO,MAAM,mBAAmB,UAAU,CAAC;AAY3C;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,GACX,MAAM,CAcR"}

package/lib/typescript/utils/retry.d.ts

@@ -0,0 +1,60 @@
+/**
+ * Exponential backoff retry utilities for Firebase write operations.
+ *
+ * Used by the Firebase Sync Engine to determine delay between retry attempts
+ * when writes fail due to network issues or transient errors.
+ *
+ * @module utils/retry
+ */
+/** Default base delay in milliseconds for exponential backoff */
+export declare const DEFAULT_BASE_DELAY = 1000;
+/** Default maximum jitter in milliseconds (±) to avoid thundering herd */
+export declare const DEFAULT_MAX_JITTER = 200;
+/** Maximum retry attempts for sync targets using 'set' or 'update' write methods */
+export declare const MAX_RETRIES_SET_UPDATE = 3;
+/** Maximum retry attempts for sync targets using 'push' write method */
+export declare const MAX_RETRIES_PUSH = 5;
+/**
+ * Calculates the delay before the next retry attempt using exponential backoff
+ * with random jitter.
+ *
+ * Formula: delay = baseDelay × 2^(attempt - 1) + random(-maxJitter, +maxJitter)
+ *
+ * The result is clamped to a minimum of 0 to prevent negative delays.
+ *
+ * @param attempt - The retry attempt number (1-indexed, first retry = 1)
+ * @param baseDelay - The base delay in milliseconds (default: 1000ms)
+ * @param maxJitter - The maximum jitter offset in milliseconds (default: 200ms).
+ *   A random value between -maxJitter and +maxJitter is added to the delay.
+ * @returns The calculated delay in milliseconds (never negative)
+ *
+ * @example
+ * ```typescript
+ * // First retry: ~1000ms ± 200ms
+ * const delay1 = calculateBackoffDelay(1);
+ *
+ * // Second retry: ~2000ms ± 200ms
+ * const delay2 = calculateBackoffDelay(2);
+ *
+ * // Third retry: ~4000ms ± 200ms
+ * const delay3 = calculateBackoffDelay(3);
+ * ```
+ */
+export declare function calculateBackoffDelay(attempt: number, baseDelay?: number, maxJitter?: number): number;
+/**
+ * Determines whether a retry should be attempted based on the current attempt
+ * number and the maximum allowed retries.
+ *
+ * @param attempt - The current attempt number (1-indexed)
+ * @param maxRetries - The maximum number of retries allowed
+ * @returns `true` if the attempt is within the allowed retry limit, `false` otherwise
+ *
+ * @example
+ * ```typescript
+ * shouldRetry(1, 3); // true - first retry is allowed
+ * shouldRetry(3, 3); // true - third retry is allowed
+ * shouldRetry(4, 3); // false - exceeds max retries
+ * ```
+ */
+export declare function shouldRetry(attempt: number, maxRetries: number): boolean;
+//# sourceMappingURL=retry.d.ts.map

package/lib/typescript/utils/retry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"retry.d.ts","sourceRoot":"","sources":["../../../src/utils/retry.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,iEAAiE;AACjE,eAAO,MAAM,kBAAkB,OAAO,CAAC;AAEvC,0EAA0E;AAC1E,eAAO,MAAM,kBAAkB,MAAM,CAAC;AAEtC,oFAAoF;AACpF,eAAO,MAAM,sBAAsB,IAAI,CAAC;AAExC,wEAAwE;AACxE,eAAO,MAAM,gBAAgB,IAAI,CAAC;AAElC;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,MAAM,EACf,SAAS,GAAE,MAA2B,EACtC,SAAS,GAAE,MAA2B,GACrC,MAAM,CAIR;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAExE"}

package/lib/typescript/validation.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Configuration validation and default value application for react-native-live-tracking.
+ *
+ * @packageDocumentation
+ */
+import type { ConfigValidationResult, TrackingConfig } from './types';
+/**
+ * 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 declare function validateConfig(config: unknown): ConfigValidationResult;
+/**
+ * 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 declare function applyDefaults(config: TrackingConfig): TrackingConfig;
+//# sourceMappingURL=validation.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../../src/validation.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAEV,sBAAsB,EACtB,cAAc,EACf,MAAM,SAAS,CAAC;AAoBjB;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,OAAO,GAAG,sBAAsB,CAmCtE;AAED;;;;;;;;;GASG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,cAAc,GAAG,cAAc,CAgBpE"}

package/package.json

@@ -0,0 +1,126 @@
+{
+  "name": "@kafitra/react-native-live-tracking",
+  "version": "0.1.0",
+  "description": "Real-time location tracking library for React Native with Firebase synchronization",
+  "main": "lib/commonjs/index",
+  "module": "lib/module/index",
+  "types": "lib/typescript/index.d.ts",
+  "react-native": "src/index",
+  "source": "src/index",
+  "files": [
+    "src",
+    "lib",
+    "android",
+    "ios",
+    "cpp",
+    "*.podspec",
+    "!ios/build",
+    "!android/build",
+    "!android/gradle",
+    "!android/gradlew",
+    "!android/gradlew.bat",
+    "!android/local.properties",
+    "!**/__tests__",
+    "!**/__fixtures__",
+    "!**/__mocks__",
+    "!**/.*"
+  ],
+  "scripts": {
+    "test": "jest",
+    "typecheck": "tsc --noEmit",
+    "lint": "eslint \"**/*.{js,ts,tsx}\"",
+    "clean": "del-cli lib",
+    "prepare": "bob build",
+    "release": "release-it"
+  },
+  "keywords": [
+    "react-native",
+    "ios",
+    "android",
+    "location",
+    "tracking",
+    "firebase",
+    "background",
+    "gps",
+    "live-tracking"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/kafitramarna/react-native-live-tracking.git"
+  },
+  "author": "kafitramarna",
+  "license": "MIT",
+  "bugs": {
+    "url": "https://github.com/kafitramarna/react-native-live-tracking/issues"
+  },
+  "homepage": "https://github.com/kafitramarna/react-native-live-tracking#readme",
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org/",
+    "access": "public"
+  },
+  "devDependencies": {
+    "@react-native/eslint-config": "^0.73.0",
+    "@types/jest": "^29.5.5",
+    "@types/react": "^18.2.0",
+    "del-cli": "^5.1.0",
+    "eslint": "^8.51.0",
+    "fast-check": "^3.13.0",
+    "jest": "^29.7.0",
+    "react": "18.2.0",
+    "react-native": "0.73.0",
+    "react-native-builder-bob": "^0.23.0",
+    "ts-jest": "^29.1.1",
+    "typescript": "^5.2.2"
+  },
+  "peerDependencies": {
+    "react": "*",
+    "react-native": ">=0.70.0"
+  },
+  "engines": {
+    "node": ">= 18.0.0"
+  },
+  "codegenConfig": {
+    "name": "RNLiveTrackingSpec",
+    "type": "modules",
+    "jsSrcsDir": "src",
+    "ios": {
+      "componentProvider": {}
+    }
+  },
+  "react-native-builder-bob": {
+    "source": "src",
+    "output": "lib",
+    "targets": [
+      "commonjs",
+      "module",
+      [
+        "typescript",
+        {
+          "project": "tsconfig.build.json"
+        }
+      ]
+    ]
+  },
+  "jest": {
+    "preset": "ts-jest",
+    "testEnvironment": "node",
+    "setupFiles": [
+      "./__tests__/setup.ts"
+    ],
+    "moduleFileExtensions": [
+      "ts",
+      "tsx",
+      "js",
+      "jsx",
+      "json"
+    ],
+    "testMatch": [
+      "**/__tests__/**/*.test.ts"
+    ],
+    "testPathIgnorePatterns": [
+      "/node_modules/",
+      "/lib/",
+      "/example/"
+    ]
+  }
+}

package/react-native-live-tracking.podspec

@@ -0,0 +1,47 @@
+require "json"
+
+package = JSON.parse(File.read(File.join(__dir__, "package.json")))
+
+folly_compiler_flags = '-DFOLLY_NO_CONFIG -DFOLLY_MOBILE=1 -DFOLLY_USE_LIBCPP=1 -Wno-comma -Wno-shorten-64-to-32'
+
+Pod::Spec.new do |s|
+  s.name         = "react-native-live-tracking"
+  s.version      = package["version"]
+  s.summary      = package["description"]
+  s.homepage     = package["homepage"]
+  s.license      = package["license"]
+  s.authors      = package["author"]
+
+  s.platforms    = { :ios => min_ios_version_supported }
+  s.source       = { :git => package["repository"]["url"], :tag => "#{s.version}" }
+
+  s.source_files = "ios/*.{h,m,mm,swift}"
+
+  # Use install_modules_dependencies helper to install the dependencies if React Native version >=0.71.0.
+  # See https://github.com/facebook/react-native/blob/febf6b7f33fdb4904669f99d795ebb4c80f770e3/scripts/cocoapods/new_architecture.rb#L79.
+  if respond_to?(:install_modules_dependencies, true)
+    install_modules_dependencies(s)
+  else
+    s.dependency "React-Core"
+
+    # Don't install the dependencies when we run `pod install` in the old architecture.
+    if ENV['RCT_NEW_ARCH_ENABLED'] == '1' then
+      s.compiler_flags = folly_compiler_flags + " -DRCT_NEW_ARCH_ENABLED=1"
+      s.pod_target_xcconfig    = {
+          "HEADER_SEARCH_PATHS" => "\"$(PODS_ROOT)/boost\"",
+          "OTHER_CPLUSPLUSFLAGS" => "-DFOLLY_NO_CONFIG -DFOLLY_MOBILE=1 -DFOLLY_USE_LIBCPP=1",
+          "CLANG_CXX_LANGUAGE_STANDARD" => "c++17"
+      }
+      s.dependency "React-Codegen"
+      s.dependency "RCT-Folly"
+      s.dependency "RCTRequired"
+      s.dependency "RCTTypeSafety"
+      s.dependency "ReactCommon/turbomodule/core"
+    end
+  end
+
+  s.swift_version = "5.0"
+
+  s.dependency "FirebaseDatabase"
+  s.dependency "FirebaseFirestore"
+end