cordova.plugins.diagnostic 7.2.9 → 7.3.0

package/cordova.plugins.diagnostic.d.ts

@@ -110,8 +110,22 @@ interface Diagnostic {
      * @type {Object}
      */
     locationAccuracyAuthorization: {
+        /** Alias for BEST. Sets kCLLocationAccuracyBest on iOS. */
         "FULL": "full";
+        /** Sets kCLLocationAccuracyReduced on iOS - approximate location, no GPS. */
         "REDUCED": "reduced";
+        /** Sets kCLLocationAccuracyBest on iOS - may engage GPS hardware. */
+        "BEST": "best";
+        /** Sets kCLLocationAccuracyBestForNavigation on iOS - highest accuracy with additional sensors. */
+        "BEST_FOR_NAVIGATION": "bestForNavigation";
+        /** Sets kCLLocationAccuracyNearestTenMeters on iOS. */
+        "NEAREST_TEN_METERS": "nearestTenMeters";
+        /** Sets kCLLocationAccuracyHundredMeters on iOS. */
+        "HUNDRED_METERS": "hundredMeters";
+        /** Sets kCLLocationAccuracyKilometer on iOS. */
+        "KILOMETER": "kilometer";
+        /** Sets kCLLocationAccuracyThreeKilometers on iOS. */
+        "THREE_KILOMETERS": "threeKilometers";
     };
 
 
@@ -464,7 +478,17 @@ interface Diagnostic {
      * @param successCallback
      * @param errorCallback
      * @param mode - (optional / iOS & Android >= 10) location authorization mode specified as a locationAuthorizationMode constant. If not specified, defaults to WHEN_IN_USE.
-     * @param accuracy
+     * @param accuracy - (optional / iOS & Android 12+) desired location accuracy as a locationAccuracyAuthorization constant.
+     * If not specified, defaults to FULL.
+     * On iOS, this sets the CLLocationManager's desiredAccuracy:
+     * - FULL / BEST - kCLLocationAccuracyBest (may engage GPS hardware)
+     * - REDUCED - kCLLocationAccuracyReduced (approximate location, no GPS)
+     * - BEST_FOR_NAVIGATION - kCLLocationAccuracyBestForNavigation
+     * - NEAREST_TEN_METERS - kCLLocationAccuracyNearestTenMeters
+     * - HUNDRED_METERS - kCLLocationAccuracyHundredMeters
+     * - KILOMETER - kCLLocationAccuracyKilometer
+     * - THREE_KILOMETERS - kCLLocationAccuracyThreeKilometers
+     * On Android < 12, has no effect.
      */
     requestLocationAuthorization?: (
         successCallback: (status: string) => void,
@@ -717,6 +741,46 @@ interface Diagnostic {
         errorCallback: (error: string) => void
     ) => void;
 
+    /**
+     * Checks if low power mode is currently enabled on the device.
+     * @param successCallback
+     * @param errorCallback
+     */
+    isLowPowerModeEnabled?: (
+        successCallback: (enabled: boolean) => void,
+        errorCallback: (error: string) => void
+    ) => void;
+
+    /**
+     * Registers a function to be called when low power mode changes.
+     * @param successCallback
+     */
+    onLowPowerModeChange?: (
+        successCallback: (enabled: boolean) => void
+    ) => void;
+
+    /**
+     * ANDROID ONLY
+     * Checks if the app is currently ignoring battery optimizations.
+     * @param successCallback
+     * @param errorCallback
+     */
+    isIgnoringBatteryOptimizations?: (
+        successCallback: (enabled: boolean) => void,
+        errorCallback: (error: string) => void
+    ) => void;
+
+    /**
+     * ANDROID ONLY
+     * Prompts the user to allow the app to ignore battery optimizations.
+     * @param successCallback
+     * @param errorCallback
+     */
+    requestIgnoreBatteryOptimizations?: (
+        successCallback: () => void,
+        errorCallback: (error: string) => void
+    ) => void;
+
     /**
      * ANDROID ONLY
      * Checks if high-accuracy locations are available to the app from GPS hardware.

package/package.json

@@ -1,5 +1,5 @@
 {
-    "version": "7.2.9",
+    "version": "7.3.0",
     "name": "cordova.plugins.diagnostic",
     "cordova_name": "Diagnostic",
     "description": "Cordova/Phonegap plugin to check the state of Location/WiFi/Camera/Bluetooth device settings.",

package/plugin.xml

@@ -2,7 +2,7 @@
 <plugin xmlns="http://www.phonegap.com/ns/plugins/1.0"
     xmlns:android="http://schemas.android.com/apk/res/android"
     id="cordova.plugins.diagnostic"
-    version="7.2.9">
+    version="7.3.0">
 
     <name>Diagnostic</name>
     <description>Cordova/Phonegap plugin to check the state of Location/WiFi/Camera/Bluetooth device settings.</description>

package/src/android/Diagnostic.java

@@ -46,13 +46,16 @@ import android.Manifest;
 import android.app.Activity;
 import android.app.AlarmManager;
 import android.app.PendingIntent;
+import android.content.BroadcastReceiver;
 import android.content.SharedPreferences;
+import android.content.IntentFilter;
 import android.content.pm.ApplicationInfo;
 import android.content.pm.PackageInfo;
 import android.net.ConnectivityManager;
 import android.net.Uri;
 import android.os.BatteryManager;
 import android.os.Build;
+import android.os.PowerManager;
 import android.util.Log;
 
 import android.content.Context;
@@ -263,6 +266,7 @@ public class Diagnostic extends CordovaPlugin{
 
     protected SharedPreferences sharedPref;
     protected SharedPreferences.Editor editor;
+    protected boolean currentLowPowerModeEnabled = false;
 
     /*************
      * Public API
@@ -291,10 +295,31 @@ public class Diagnostic extends CordovaPlugin{
         applicationContext = this.cordova.getActivity().getApplicationContext();
         sharedPref = cordova.getActivity().getSharedPreferences(TAG, Activity.MODE_PRIVATE);
         editor = sharedPref.edit();
+        currentLowPowerModeEnabled = isLowPowerModeEnabled();
+
+        if(Build.VERSION.SDK_INT >= Build.VERSION_CODES.LOLLIPOP){
+            try {
+                applicationContext.registerReceiver(lowPowerModeChangedReceiver, new IntentFilter(PowerManager.ACTION_POWER_SAVE_MODE_CHANGED));
+            } catch (Exception e) {
+                logWarning("Unable to register low power mode change receiver: " + e.getMessage());
+            }
+        }
 
         super.initialize(cordova, webView);
     }
 
+    @Override
+    public void onDestroy() {
+        if(Build.VERSION.SDK_INT >= Build.VERSION_CODES.LOLLIPOP){
+            try {
+                applicationContext.unregisterReceiver(lowPowerModeChangedReceiver);
+            } catch (Exception e) {
+                logWarning("Unable to unregister low power mode change receiver: " + e.getMessage());
+            }
+        }
+        super.onDestroy();
+    }
+
     /**
      * Executes the request and returns PluginResult.
      *
@@ -351,6 +376,13 @@ public class Diagnostic extends CordovaPlugin{
                 callbackContext.success(getCPUArchitecture());
             } else if(action.equals("getCurrentBatteryLevel")) {
                 callbackContext.success(getCurrentBatteryLevel());
+            } else if(action.equals("isLowPowerModeEnabled")) {
+                callbackContext.success(isLowPowerModeEnabled() ? 1 : 0);
+            } else if(action.equals("isIgnoringBatteryOptimizations")) {
+                callbackContext.success(isIgnoringBatteryOptimizations() ? 1 : 0);
+            } else if(action.equals("requestIgnoreBatteryOptimizations")) {
+                requestIgnoreBatteryOptimizations();
+                callbackContext.success();
             } else if(action.equals("isAirplaneModeEnabled")) {
                 callbackContext.success(isAirplaneModeEnabled() ? 1 : 0);
             } else if(action.equals("getDeviceOSVersion")) {
@@ -861,6 +893,17 @@ public class Diagnostic extends CordovaPlugin{
         executeGlobalJavascript("cordova.plugins.diagnostic." + jsString);
     }
 
+    protected final BroadcastReceiver lowPowerModeChangedReceiver = new BroadcastReceiver() {
+        @Override
+        public void onReceive(Context context, Intent intent) {
+            final String action = intent.getAction();
+            if(instance != null && PowerManager.ACTION_POWER_SAVE_MODE_CHANGED.equals(action)){
+                Log.v(TAG, "lowPowerModeChangedReceiver");
+                instance.notifyLowPowerModeChange();
+            }
+        }
+    };
+
     /**
      * Performs a warm app restart - restarts only Cordova main activity
      */
@@ -953,6 +996,41 @@ public class Diagnostic extends CordovaPlugin{
         return bm.getIntProperty(BatteryManager.BATTERY_PROPERTY_CAPACITY);
     }
 
+    protected boolean isLowPowerModeEnabled(){
+        if(Build.VERSION.SDK_INT < Build.VERSION_CODES.LOLLIPOP){
+            return false;
+        }
+        PowerManager powerManager = (PowerManager) cordova.getContext().getApplicationContext().getSystemService(Context.POWER_SERVICE);
+        return powerManager != null && powerManager.isPowerSaveMode();
+    }
+
+    protected boolean isIgnoringBatteryOptimizations(){
+        if(Build.VERSION.SDK_INT < Build.VERSION_CODES.M){
+            return true;
+        }
+        PowerManager powerManager = (PowerManager) cordova.getContext().getApplicationContext().getSystemService(Context.POWER_SERVICE);
+        return powerManager != null && powerManager.isIgnoringBatteryOptimizations(cordova.getActivity().getPackageName());
+    }
+
+    protected void requestIgnoreBatteryOptimizations(){
+        if(Build.VERSION.SDK_INT < Build.VERSION_CODES.M || isIgnoringBatteryOptimizations()){
+            return;
+        }
+
+        Intent intent = new Intent(Settings.ACTION_REQUEST_IGNORE_BATTERY_OPTIMIZATIONS);
+        intent.setData(Uri.parse("package:" + cordova.getActivity().getPackageName()));
+        cordova.getActivity().startActivity(intent);
+    }
+
+    protected void notifyLowPowerModeChange(){
+        boolean lowPowerModeEnabled = isLowPowerModeEnabled();
+        if(lowPowerModeEnabled != currentLowPowerModeEnabled){
+            currentLowPowerModeEnabled = lowPowerModeEnabled;
+            logDebug("Low power mode changed to: " + lowPowerModeEnabled);
+            executePluginJavascript("_onLowPowerModeChange(" + (lowPowerModeEnabled ? "true" : "false") + ");");
+        }
+    }
+
     // https://stackoverflow.com/a/18237962/777265
     protected boolean hasBuildPermission(String permission)
     {

package/src/ios/Diagnostic.h

@@ -28,6 +28,7 @@ extern NSString*const AUTHORIZATION_LIMITED;
 
 @property (nonatomic) float osVersion;
 @property (nonatomic) BOOL debugEnabled;
+@property (nonatomic, strong) id lowPowerModeChangeObserver;
 
 // Plugin API
 - (void) enableDebug: (CDVInvokedUrlCommand*)command;
@@ -35,6 +36,7 @@ extern NSString*const AUTHORIZATION_LIMITED;
 - (void) getBackgroundRefreshStatus: (CDVInvokedUrlCommand*)command;
 - (void) getArchitecture: (CDVInvokedUrlCommand*)command;
 - (void) getCurrentBatteryLevel: (CDVInvokedUrlCommand*)command;
+- (void) isLowPowerModeEnabled: (CDVInvokedUrlCommand*)command;
 - (void) getDeviceOSVersion: (CDVInvokedUrlCommand*)command;
 - (void) getBuildOSVersion: (CDVInvokedUrlCommand*)command;
 - (void) isMobileDataAuthorized: (CDVInvokedUrlCommand*)command;

package/src/ios/Diagnostic.m

@@ -41,6 +41,7 @@ static Diagnostic* diagnostic = nil;
 static CTCellularData* cellularData;
 #endif
 
+
 /********************************/
 #pragma mark - Public static functions
 /********************************/
@@ -126,6 +127,12 @@ static CTCellularData* cellularData;
     #if !TARGET_OS_MACCATALYST
         cellularData = [[CTCellularData alloc] init];
     #endif
+
+    self.lowPowerModeChangeObserver = [[NSNotificationCenter defaultCenter] addObserverForName:NSProcessInfoPowerStateDidChangeNotification object:nil queue:[NSOperationQueue mainQueue] usingBlock:^(NSNotification *notification) {
+        BOOL isLowPowerModeEnabled = [[NSProcessInfo processInfo] isLowPowerModeEnabled];
+        [self logDebug:[NSString stringWithFormat:@"Low power mode changed to: %@", isLowPowerModeEnabled ? @"true" : @"false"]];
+        [self executeGlobalJavascript:[NSString stringWithFormat:@"cordova.plugins.diagnostic._onLowPowerModeChange(%@);", isLowPowerModeEnabled ? @"true" : @"false"]];
+    }];
 }
 
 // https://stackoverflow.com/a/38441011/777265
@@ -186,6 +193,18 @@ static CTCellularData* cellularData;
     }];
 }
 
+- (void) isLowPowerModeEnabled: (CDVInvokedUrlCommand*)command {
+    [self.commandDelegate runInBackground:^{
+        @try {
+            BOOL isLowPowerModeEnabled = [[NSProcessInfo processInfo] isLowPowerModeEnabled];
+            [self logDebug:[NSString stringWithFormat:@"Low power mode enabled: %@", isLowPowerModeEnabled ? @"true" : @"false"]];
+            [self sendPluginResultBool:isLowPowerModeEnabled :command];
+        }@catch (NSException *exception) {
+            [self handlePluginException:exception :command];
+        }
+    }];
+}
+
 - (void) getDeviceOSVersion: (CDVInvokedUrlCommand*)command {
     [self.commandDelegate runInBackground:^{
         @try {
@@ -419,6 +438,13 @@ static CTCellularData* cellularData;
     return [[NSUserDefaults standardUserDefaults] objectForKey:key];
 }
 
+- (void)dealloc {
+    if(self.lowPowerModeChangeObserver != nil){
+        [[NSNotificationCenter defaultCenter] removeObserver:self.lowPowerModeChangeObserver];
+        self.lowPowerModeChangeObserver = nil;
+    }
+}
+
 @end
 
 

package/src/ios/Diagnostic_Bluetooth.m

@@ -156,12 +156,14 @@ static NSString*const LOG_TAG = @"Diagnostic_Bluetooth[native]";
 }
 
 - (void) ensureBluetoothManager {
-    if(![self.bluetoothManager isKindOfClass:[CBCentralManager class]]){
+    @synchronized(self) {
+      if(![self.bluetoothManager isKindOfClass:[CBCentralManager class]]){
         self.bluetoothManager = [[CBCentralManager alloc]
                                  initWithDelegate:self
                                  queue:dispatch_get_main_queue()
                                  options:@{CBCentralManagerOptionShowPowerAlertKey: @(NO)}];
         [self centralManagerDidUpdateState:self.bluetoothManager]; // Send initial state
+      }
     }
 }
 

package/src/ios/Diagnostic_Location.m

@@ -78,6 +78,41 @@ static NSString*const LOG_TAG = @"Diagnostic_Location[native]";
         @try {
             if ([CLLocationManager instancesRespondToSelector:@selector(requestWhenInUseAuthorization)])
             {
+                // Apply desired accuracy if specified (argument at index 1).
+                // Maps string values to CLLocationAccuracy constants.
+                // If not specified or unrecognised, defaults to kCLLocationAccuracyBest to maintain backward
+                // compatibility. Apps that do not require precise location (e.g. only need the Wi-Fi SSID)
+                // should pass "reduced" to avoid engaging GPS hardware and unnecessary battery drain.
+                NSString* accuracy = [command argumentAtIndex:1 withDefault:nil];
+                if(accuracy != nil){
+                    if([accuracy isEqualToString:@"reduced"]){
+                        self.locationManager.desiredAccuracy = kCLLocationAccuracyReduced;
+                        [diagnostic logDebug:@"Setting location accuracy: reduced"];
+                    }else if([accuracy isEqualToString:@"bestForNavigation"]){
+                        self.locationManager.desiredAccuracy = kCLLocationAccuracyBestForNavigation;
+                        [diagnostic logDebug:@"Setting location accuracy: bestForNavigation"];
+                    }else if([accuracy isEqualToString:@"nearestTenMeters"]){
+                        self.locationManager.desiredAccuracy = kCLLocationAccuracyNearestTenMeters;
+                        [diagnostic logDebug:@"Setting location accuracy: nearestTenMeters"];
+                    }else if([accuracy isEqualToString:@"hundredMeters"]){
+                        self.locationManager.desiredAccuracy = kCLLocationAccuracyHundredMeters;
+                        [diagnostic logDebug:@"Setting location accuracy: hundredMeters"];
+                    }else if([accuracy isEqualToString:@"kilometer"]){
+                        self.locationManager.desiredAccuracy = kCLLocationAccuracyKilometer;
+                        [diagnostic logDebug:@"Setting location accuracy: kilometer"];
+                    }else if([accuracy isEqualToString:@"threeKilometers"]){
+                        self.locationManager.desiredAccuracy = kCLLocationAccuracyThreeKilometers;
+                        [diagnostic logDebug:@"Setting location accuracy: threeKilometers"];
+                    }else{
+                        // "full", "best", or any unrecognised value
+                        self.locationManager.desiredAccuracy = kCLLocationAccuracyBest;
+                        [diagnostic logDebug:@"Setting location accuracy: best"];
+                    }
+                }else{
+                    self.locationManager.desiredAccuracy = kCLLocationAccuracyBest;
+                    [diagnostic logDebug:@"Setting location accuracy: best (default)"];
+                }
+
                 BOOL always = [[command argumentAtIndex:0] boolValue];
                 if(always){
                     NSAssert([[[NSBundle mainBundle] infoDictionary] valueForKey:@"NSLocationAlwaysAndWhenInUseUsageDescription"], @"Your app must have a value for NSLocationAlwaysAndWhenInUseUsageDescription in its Info.plist");

package/www/android/diagnostic.js

@@ -112,7 +112,8 @@ var Diagnostic = (function(){
      *
      ****************************/
     // Placeholder listeners
-    Diagnostic._onNFCStateChange =
+    Diagnostic._onLowPowerModeChange =
+        Diagnostic._onNFCStateChange =
         Diagnostic._onPermissionRequestComplete = function(){};
 
     Diagnostic._combinePermissionStatuses = function(statuses){
@@ -484,6 +485,63 @@ var Diagnostic = (function(){
             []);
     };
 
+    /**
+     * Checks if low power mode is currently enabled on device.
+     *
+     * @param {Function} successCallback -  The callback which will be called when the operation is successful.
+     * This callback function is passed a single boolean parameter which is TRUE if low power mode is enabled.
+     * @param {Function} errorCallback -  The callback which will be called when the operation encounters an error.
+     *  This callback function is passed a single string parameter containing the error message.
+     */
+    Diagnostic.isLowPowerModeEnabled = function(successCallback, errorCallback){
+        return cordova.exec(Diagnostic._ensureBoolean(successCallback),
+            errorCallback,
+            'Diagnostic',
+            'isLowPowerModeEnabled',
+            []);
+    };
+
+    /**
+     * Checks if the app is currently ignoring battery optimizations.
+     *
+     * @param {Function} successCallback -  The callback which will be called when the operation is successful.
+     * This callback function is passed a single boolean parameter which is TRUE if the app is ignoring battery optimizations.
+     * @param {Function} errorCallback -  The callback which will be called when the operation encounters an error.
+     *  This callback function is passed a single string parameter containing the error message.
+     */
+    Diagnostic.isIgnoringBatteryOptimizations = function(successCallback, errorCallback){
+        return cordova.exec(Diagnostic._ensureBoolean(successCallback),
+            errorCallback,
+            'Diagnostic',
+            'isIgnoringBatteryOptimizations',
+            []);
+    };
+
+    /**
+     * Prompts the user to allow the app to ignore battery optimizations.
+     *
+     * @param {Function} successCallback - The callback which will be called when the request intent is opened.
+     * @param {Function} errorCallback - The callback which will be called when the operation encounters an error.
+     * This callback function is passed a single string parameter containing the error message.
+     */
+    Diagnostic.requestIgnoreBatteryOptimizations = function(successCallback, errorCallback){
+        return cordova.exec(successCallback,
+            errorCallback,
+            'Diagnostic',
+            'requestIgnoreBatteryOptimizations',
+            []);
+    };
+
+    /**
+     * Registers a function to be called when the device low power mode changes.
+     *
+     * @param {Function} successCallback - The callback which will be called when low power mode changes.
+     * This callback function is passed a single boolean parameter which is TRUE if low power mode is enabled.
+     */
+    Diagnostic.onLowPowerModeChange = function(successCallback) {
+        Diagnostic._onLowPowerModeChange = successCallback || function(){};
+    };
+
     /**
      * Checks if airplane mode is enabled on device.
      *

package/www/ios/diagnostic.js

@@ -154,6 +154,32 @@ var Diagnostic = (function(){
             []);
     };
 
+    /**
+     * Checks if low power mode is currently enabled on device.
+     *
+     * @param {Function} successCallback -  The callback which will be called when the operation is successful.
+     * This callback function is passed a single boolean parameter which is TRUE if low power mode is enabled.
+     * @param {Function} errorCallback -  The callback which will be called when the operation encounters an error.
+     *  This callback function is passed a single string parameter containing the error message.
+     */
+    Diagnostic.isLowPowerModeEnabled = function(successCallback, errorCallback){
+        return cordova.exec(Diagnostic._ensureBoolean(successCallback),
+            errorCallback,
+            'Diagnostic',
+            'isLowPowerModeEnabled',
+            []);
+    };
+
+    /**
+     * Registers a function to be called when the device low power mode changes.
+     *
+     * @param {Function} successCallback - The callback which will be called when low power mode changes.
+     * This callback function is passed a single boolean parameter which is TRUE if low power mode is enabled.
+     */
+    Diagnostic.onLowPowerModeChange = function(successCallback) {
+        Diagnostic._onLowPowerModeChange = successCallback || function(){};
+    };
+
     /**
      * Checks if mobile data is authorized for this app.
      * Returns true if the per-app Mobile Data setting is set to enabled (regardless of whether the device is currently connected to a cellular network)
@@ -371,8 +397,18 @@ var Diagnostic = (function(){
      * This callback function is passed a single string parameter containing the error message.
      * @param {String} mode - (optional) location authorization mode as a constant in `cordova.plugins.diagnostic.locationAuthorizationMode`.
      * If not specified, defaults to `cordova.plugins.diagnostic.locationAuthorizationMode.WHEN_IN_USE`.
+     * @param {String} accuracy - (optional) desired location accuracy as a constant in `cordova.plugins.diagnostic.locationAccuracyAuthorization`.
+     * If not specified, defaults to `cordova.plugins.diagnostic.locationAccuracyAuthorization.FULL`.
+     * On iOS, this sets the CLLocationManager's desiredAccuracy:
+     * - `FULL` / `BEST` - kCLLocationAccuracyBest (may engage GPS hardware)
+     * - `REDUCED` - kCLLocationAccuracyReduced (approximate location, no GPS)
+     * - `BEST_FOR_NAVIGATION` - kCLLocationAccuracyBestForNavigation (highest accuracy with additional sensors)
+     * - `NEAREST_TEN_METERS` - kCLLocationAccuracyNearestTenMeters
+     * - `HUNDRED_METERS` - kCLLocationAccuracyHundredMeters
+     * - `KILOMETER` - kCLLocationAccuracyKilometer
+     * - `THREE_KILOMETERS` - kCLLocationAccuracyThreeKilometers
      */
-    Diagnostic.requestLocationAuthorization = function(successCallback, errorCallback, mode) {
+    Diagnostic.requestLocationAuthorization = function(successCallback, errorCallback, mode, accuracy) {
         if(cordova.plugins.diagnostic.location){
             cordova.plugins.diagnostic.location.requestLocationAuthorization.apply(this, arguments);
         }else{
@@ -1218,7 +1254,7 @@ var Diagnostic = (function(){
         }
     };
 
-
+    Diagnostic._onLowPowerModeChange = function(){};
 
     return Diagnostic;
 })();

package/www/ios/diagnostic.location.js

@@ -29,7 +29,13 @@ var Diagnostic_Location = (function(){
 
     Diagnostic.locationAccuracyAuthorization = Diagnostic_Location.locationAccuracyAuthorization = {
         "FULL": "full",
-        "REDUCED": "reduced"
+        "REDUCED": "reduced",
+        "BEST": "best",
+        "BEST_FOR_NAVIGATION": "bestForNavigation",
+        "NEAREST_TEN_METERS": "nearestTenMeters",
+        "HUNDRED_METERS": "hundredMeters",
+        "KILOMETER": "kilometer",
+        "THREE_KILOMETERS": "threeKilometers"
     };
 
     /********************
@@ -161,13 +167,23 @@ var Diagnostic_Location = (function(){
      * This callback function is passed a single string parameter containing the error message.
      * @param {String} mode - (optional) location authorization mode as a constant in `cordova.plugins.diagnostic.locationAuthorizationMode`.
      * If not specified, defaults to `cordova.plugins.diagnostic.locationAuthorizationMode.WHEN_IN_USE`.
+     * @param {String} accuracy - (optional) desired location accuracy as a constant in `cordova.plugins.diagnostic.locationAccuracyAuthorization`.
+     * If not specified, defaults to `cordova.plugins.diagnostic.locationAccuracyAuthorization.FULL`.
+     * On iOS, this sets the CLLocationManager's desiredAccuracy:
+     * - `FULL` / `BEST` - kCLLocationAccuracyBest (may engage GPS hardware)
+     * - `REDUCED` - kCLLocationAccuracyReduced (approximate location, no GPS)
+     * - `BEST_FOR_NAVIGATION` - kCLLocationAccuracyBestForNavigation (highest accuracy with additional sensors)
+     * - `NEAREST_TEN_METERS` - kCLLocationAccuracyNearestTenMeters
+     * - `HUNDRED_METERS` - kCLLocationAccuracyHundredMeters
+     * - `KILOMETER` - kCLLocationAccuracyKilometer
+     * - `THREE_KILOMETERS` - kCLLocationAccuracyThreeKilometers
      */
-    Diagnostic_Location.requestLocationAuthorization = function(successCallback, errorCallback, mode) {
+    Diagnostic_Location.requestLocationAuthorization = function(successCallback, errorCallback, mode, accuracy) {
         return cordova.exec(successCallback,
             errorCallback,
             'Diagnostic_Location',
             'requestLocationAuthorization',
-            [mode && mode === Diagnostic_Location.locationAuthorizationMode.ALWAYS]);
+            [mode && mode === Diagnostic_Location.locationAuthorizationMode.ALWAYS, accuracy]);
     };
 
     /**

package/.specstory/.project.json

@@ -1,8 +0,0 @@
-{
-  "workspace_id": "3d27-7072-f841-12e1",
-  "workspace_id_at": "2026-02-24T14:03:38.792Z",
-  "project_name": "cordova-diagnostic-plugin",
-  "cloud_sync": false,
-  "git_id": "303b-c6e9-a865-86a3",
-  "git_id_at": "2026-02-24T14:03:38.810Z"
-}