foreground-location 0.0.1

package/ios/Sources/ForeGroundLocationPlugin/ForeGroundLocation.swift

@@ -0,0 +1,75 @@
+import Foundation
+import CoreLocation
+
+@objc public class ForeGroundLocation: NSObject, CLLocationManagerDelegate {
+    private var locationManager: CLLocationManager?
+    private var locationCompletion: ((Result<CLLocation, Error>) -> Void)?
+    
+    public func getCurrentLocation(completion: @escaping (Result<CLLocation, Error>) -> Void) {
+        locationManager = CLLocationManager()
+        locationManager?.delegate = self
+        self.locationCompletion = completion
+        
+        guard CLLocationManager.locationServicesEnabled() else {
+            completion(.failure(LocationError.locationServicesDisabled))
+            return
+        }
+        
+        let authStatus = CLLocationManager.authorizationStatus()
+        guard authStatus == .authorizedWhenInUse || authStatus == .authorizedAlways else {
+            completion(.failure(LocationError.permissionDenied))
+            return
+        }
+        
+        locationManager?.desiredAccuracy = kCLLocationAccuracyBest
+        locationManager?.requestLocation()
+    }
+    
+    // MARK: - CLLocationManagerDelegate
+    public func locationManager(_ manager: CLLocationManager, didUpdateLocations locations: [CLLocation]) {
+        guard let location = locations.first else { return }
+        locationCompletion?(.success(location))
+        locationCompletion = nil
+        
+        // Clean up
+        locationManager?.delegate = nil
+        locationManager = nil
+    }
+    
+    public func locationManager(_ manager: CLLocationManager, didFailWithError error: Error) {
+        locationCompletion?(.failure(error))
+        locationCompletion = nil
+        
+        // Clean up
+        locationManager?.delegate = nil
+        locationManager = nil
+    }
+    
+    public func locationManager(_ manager: CLLocationManager, didChangeAuthorization status: CLAuthorizationStatus) {
+        // Handle authorization changes if needed
+        switch status {
+        case .denied, .restricted:
+            locationCompletion?(.failure(LocationError.permissionDenied))
+            locationCompletion = nil
+        default:
+            break
+        }
+    }
+}
+
+enum LocationError: Error {
+    case locationServicesDisabled
+    case permissionDenied
+    case locationUnavailable
+    
+    var localizedDescription: String {
+        switch self {
+        case .locationServicesDisabled:
+            return "Location services are disabled"
+        case .permissionDenied:
+            return "Location permission denied"
+        case .locationUnavailable:
+            return "Location unavailable"
+        }
+    }
+}

package/ios/Sources/ForeGroundLocationPlugin/ForeGroundLocationPlugin.swift

@@ -0,0 +1,125 @@
+import Foundation
+import Capacitor
+import CoreLocation
+
+/**
+ * Foreground Location Plugin for iOS
+ * Limited iOS implementation - Foreground service pattern not available
+ */
+@objc(ForeGroundLocationPlugin)
+public class ForeGroundLocationPlugin: CAPPlugin, CAPBridgedPlugin {
+    public let identifier = "ForeGroundLocationPlugin"
+    public let jsName = "ForeGroundLocation"
+    public let pluginMethods: [CAPPluginMethod] = [
+        CAPPluginMethod(name: "checkPermissions", returnType: CAPPluginReturnPromise),
+        CAPPluginMethod(name: "requestPermissions", returnType: CAPPluginReturnPromise),
+        CAPPluginMethod(name: "startForegroundLocationService", returnType: CAPPluginReturnPromise),
+        CAPPluginMethod(name: "stopForegroundLocationService", returnType: CAPPluginReturnPromise),
+        CAPPluginMethod(name: "isServiceRunning", returnType: CAPPluginReturnPromise),
+        CAPPluginMethod(name: "getCurrentLocation", returnType: CAPPluginReturnPromise),
+        CAPPluginMethod(name: "updateLocationSettings", returnType: CAPPluginReturnPromise)
+    ]
+    
+    private let implementation = ForeGroundLocation()
+
+    @objc override public func checkPermissions(_ call: CAPPluginCall) {
+        let locationManager = CLLocationManager()
+        let authStatus = locationManager.authorizationStatus
+        
+        let permissionState: String
+        switch authStatus {
+        case .notDetermined:
+            permissionState = "prompt"
+        case .denied, .restricted:
+            permissionState = "denied"
+        case .authorizedWhenInUse, .authorizedAlways:
+            permissionState = "granted"
+        @unknown default:
+            permissionState = "prompt"
+        }
+        
+        call.resolve([
+            "location": permissionState,
+            "backgroundLocation": permissionState == "granted" && authStatus == .authorizedAlways ? "granted" : "denied",
+            "notifications": "denied"
+        ])
+    }
+
+    @objc override public func requestPermissions(_ call: CAPPluginCall) {
+        let locationManager = CLLocationManager()
+        
+        switch locationManager.authorizationStatus {
+        case .notDetermined:
+            // For iOS, we can only request when-in-use permission
+            // Background location requires additional setup in Info.plist
+            locationManager.requestWhenInUseAuthorization()
+            
+            // Since we can't easily wait for the delegate callback in this context,
+            // we'll return the current state and recommend checking again
+            call.resolve([
+                "location": "prompt",
+                "backgroundLocation": "denied", 
+                "notifications": "denied"
+            ])
+        case .denied, .restricted:
+            call.resolve([
+                "location": "denied",
+                "backgroundLocation": "denied",
+                "notifications": "denied"
+            ])
+        case .authorizedWhenInUse:
+            call.resolve([
+                "location": "granted",
+                "backgroundLocation": "denied", // Would need always authorization
+                "notifications": "denied"
+            ])
+        case .authorizedAlways:
+            call.resolve([
+                "location": "granted",
+                "backgroundLocation": "granted",
+                "notifications": "denied"
+            ])
+        @unknown default:
+            call.resolve([
+                "location": "prompt",
+                "backgroundLocation": "denied",
+                "notifications": "denied"
+            ])
+        }
+    }
+
+    @objc func startForegroundLocationService(_ call: CAPPluginCall) {
+        call.unimplemented("Foreground location service pattern not available on iOS. Use iOS background location modes instead.")
+    }
+
+    @objc func stopForegroundLocationService(_ call: CAPPluginCall) {
+        call.unimplemented("Foreground location service pattern not available on iOS.")
+    }
+
+    @objc func isServiceRunning(_ call: CAPPluginCall) {
+        call.resolve(["isRunning": false])
+    }
+
+    @objc func getCurrentLocation(_ call: CAPPluginCall) {
+        implementation.getCurrentLocation { result in
+            switch result {
+            case .success(let location):
+                call.resolve([
+                    "latitude": location.coordinate.latitude,
+                    "longitude": location.coordinate.longitude,
+                    "accuracy": location.horizontalAccuracy,
+                    "altitude": location.altitude,
+                    "bearing": location.course >= 0 ? location.course : nil,
+                    "speed": location.speed >= 0 ? location.speed : nil,
+                    "timestamp": ISO8601DateFormatter().string(from: location.timestamp)
+                ])
+            case .failure(let error):
+                call.reject("Location error: \(error.localizedDescription)")
+            }
+        }
+    }
+
+    @objc func updateLocationSettings(_ call: CAPPluginCall) {
+        call.unimplemented("Location service settings not supported on iOS.")
+    }
+}

package/ios/Tests/ForeGroundLocationPluginTests/ForeGroundLocationPluginTests.swift

@@ -0,0 +1,36 @@
+import XCTest
+@testable import ForeGroundLocationPlugin
+
+class ForeGroundLocationTests: XCTestCase {
+    func testLocationErrorCases() {
+        // Test that LocationError enum has proper descriptions
+        let locationServicesDisabledError = LocationError.locationServicesDisabled
+        XCTAssertEqual(locationServicesDisabledError.localizedDescription, "Location services are disabled")
+        
+        let permissionDeniedError = LocationError.permissionDenied
+        XCTAssertEqual(permissionDeniedError.localizedDescription, "Location permission denied")
+        
+        let locationUnavailableError = LocationError.locationUnavailable
+        XCTAssertEqual(locationUnavailableError.localizedDescription, "Location unavailable")
+    }
+    
+    func testPluginMethodsRegistration() {
+        // Test that plugin has all required methods registered
+        let plugin = ForeGroundLocationPlugin()
+        let methodNames = plugin.pluginMethods.map { $0.name }
+        
+        let expectedMethods = [
+            "checkPermissions",
+            "requestPermissions", 
+            "startForegroundLocationService",
+            "stopForegroundLocationService",
+            "isServiceRunning",
+            "getCurrentLocation",
+            "updateLocationSettings"
+        ]
+        
+        for method in expectedMethods {
+            XCTAssertTrue(methodNames.contains(method), "Missing method: \(method)")
+        }
+    }
+}

package/package.json

@@ -0,0 +1,82 @@
+{
+  "name": "foreground-location",
+  "version": "0.0.1",
+  "description": "Location Tracking Using Foreground Service and Fused Location API",
+  "main": "dist/plugin.cjs.js",
+  "module": "dist/esm/index.js",
+  "types": "dist/esm/index.d.ts",
+  "unpkg": "dist/plugin.js",
+  "files": [
+    "android/src/main/",
+    "android/build.gradle",
+    "dist/",
+    "ios/Sources",
+    "ios/Tests",
+    "Package.swift",
+    "ForegroundLocation.podspec",
+    "docs/"
+  ],
+  "author": "xConcepts",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/xconcepts17/foreground-location.git"
+  },
+  "bugs": {
+    "url": "https://github.com/xconcepts17/foreground-location/issues"
+  },
+  "keywords": [
+    "capacitor",
+    "plugin",
+    "native"
+  ],
+  "scripts": {
+    "verify": "npm run verify:ios && npm run verify:android && npm run verify:web",
+    "verify:ios": "xcodebuild -scheme ForegroundLocation -destination generic/platform=iOS",
+    "verify:android": "cd android && ./gradlew clean build test && cd ..",
+    "verify:web": "npm run build",
+    "lint": "npm run eslint && npm run prettier -- --check && npm run swiftlint -- lint",
+    "fmt": "npm run eslint -- --fix && npm run prettier -- --write && npm run swiftlint -- --fix --format",
+    "eslint": "eslint . --ext ts",
+    "prettier": "prettier \"**/*.{css,html,ts,js,java}\" --plugin=prettier-plugin-java",
+    "swiftlint": "node-swiftlint",
+    "docgen": "docgen --api ForeGroundLocationPlugin --output-readme README.md --output-json dist/docs.json",
+    "build": "npm run clean && tsc && rollup -c rollup.config.mjs",
+    "build-with-docs": "npm run clean && npm run docgen && tsc && rollup -c rollup.config.mjs",
+    "clean": "rimraf ./dist",
+    "watch": "tsc --watch",
+    "prepublishOnly": "npm run build"
+  },
+  "devDependencies": {
+    "@capacitor/android": "^7.0.0",
+    "@capacitor/core": "^7.0.0",
+    "@capacitor/docgen": "^0.3.0",
+    "@capacitor/ios": "^7.0.0",
+    "@ionic/eslint-config": "^0.4.0",
+    "@ionic/prettier-config": "^4.0.0",
+    "@ionic/swiftlint-config": "^2.0.0",
+    "eslint": "^8.57.0",
+    "prettier": "^3.4.2",
+    "prettier-plugin-java": "^2.6.6",
+    "rimraf": "^6.0.1",
+    "rollup": "^4.30.1",
+    "swiftlint": "^2.0.0",
+    "typescript": "~4.1.5"
+  },
+  "peerDependencies": {
+    "@capacitor/core": ">=7.0.0"
+  },
+  "prettier": "@ionic/prettier-config",
+  "swiftlint": "@ionic/swiftlint-config",
+  "eslintConfig": {
+    "extends": "@ionic/eslint-config/recommended"
+  },
+  "capacitor": {
+    "ios": {
+      "src": "ios"
+    },
+    "android": {
+      "src": "android"
+    }
+  }
+}