cordova.plugins.diagnostic 7.3.0 → 7.3.1

package/.specstory/.project.json

@@ -0,0 +1,7 @@
+{
+  "workspace_id": "9239-48e1-c1cc-6754",
+  "workspace_id_at": "2026-06-25T11:53:58Z",
+  "git_id": "ea53-a02a-03d4-cd1b",
+  "git_id_at": "2026-06-25T11:53:58Z",
+  "project_name": "cordova-diagnostic-plugin"
+}

package/.specstory/cli/config.toml

@@ -0,0 +1,82 @@
+# SpecStory CLI Configuration
+#
+# This is the project-level config file for SpecStory CLI.
+# All settings here apply to this project unless overridden by CLI flags.
+#
+# Uncomment (remove the #) the line and edit any setting below to change the default behavior.
+# For more information, see: https://docs.specstory.com/integrations/terminal-coding-agents/usage
+
+[local_sync]
+# Write markdown files locally. (default: true)
+# enabled = false # equivalent to --only-cloud-sync
+
+# Custom output directory for markdown files.
+# Default: ./.specstory/history (relative to the project directory)
+# output_dir = "~/.specstory/history" # equivalent to --output-dir "~/.specstory/history"
+
+# Use local timezone for file name and content timestamps (default: false, UTC)
+# local_time_zone = true # equivalent to --local-time-zone
+
+[cloud_sync]
+# Sync session data to SpecStory Cloud. (default: true, when logged in to SpecStory Cloud)
+# enabled = false # equivalent to --no-cloud-sync
+
+[logging]
+# Write logs to .specstory/debug/debug.log (default: false)
+# log = true # equivalent to --log        
+
+# Debug-level output, requires console or log (default: false)
+# debug = true # equivalent to --debug 
+
+# Custom output directory for debug data.
+# Default: ./.specstory/debug (relative to the project directory)
+# debug_dir = "~/.specstory/debug" # equivalent to --debug-dir "~/.specstory/debug"
+
+# Error/warn/info output to stdout (default: false)
+# console = true # equivalent to --console
+
+# Suppress all non-error output (default: false)
+# silent = true	# equivalent to --silent
+
+[version_check]
+# Check for new versions of the CLI on startup.
+# Default: true
+# enabled = false # equivalent to --no-version-check
+
+[analytics]
+# Send anonymous product usage analytics to help improve SpecStory.
+# Default: true
+# enabled = false # equivalent to --no-usage-analytics
+
+[telemetry]
+# OTLP gRPC collector endpoint (e.g., "localhost:4317" or "http://localhost:4317")
+# endpoint = "localhost:4317"
+
+# Override the default service name (default: "specstory-cli")
+# service_name = "my-service-name"
+
+# Include user prompt text in telemetry spans (default: true)
+# prompts = false
+
+[providers]
+# Agent execution commands by provider (used by specstory run)
+# Pass custom flags (e.g. claude_cmd = "claude --allow-dangerously-skip-permissions")
+# Use of these is equivalent to -c "custom command"
+
+# Claude Code command
+# claude_cmd = "claude"
+
+# Codex CLI command
+# codex_cmd = "codex"
+
+# Cursor CLI command
+# cursor_cmd = "cursor-agent"
+
+# Droid CLI command
+# droid_cmd = "droid"
+
+# Gemini CLI command
+# gemini_cmd = "gemini"
+
+# DeepSeek TUI command
+# deepseek_cmd = "deepseek"

package/.specstory/history/2026-05-08_15-16-55Z-implement-device-power-mode-features.md

@@ -0,0 +1,67 @@
+<!-- Generated by SpecStory, Markdown v2.1.0 -->
+
+# 2026-05-08 15:16:59Z
+
+<!-- VS Code Copilot IDE Session 922bf8ba-7963-4797-8a44-61255bede17d (2026-05-08 15:16:59Z) -->
+
+_**User (2026-05-08 15:16:59Z)**_
+
+Implement the following features in `cordova-diagnostic-plugin/` and commit the changes for each feature with an appropriate commit message.
+Then update `cordova-diagnostic-plugin-example/` to demonstrate/validate the new features and commit those changes as well.
+
+# Device power mode
+
+Add cross-platform plugin API methods to the core Diagnostic module to query and listen for changes in device power mode.
+
+`Diagnostic.isLowPowerModeEnabled()` - Returns a boolean indicating whether the device is currently in low power mode.
+`Diagnostic.onLowPowerModeChange(callback)` - Registers a callback function that will be called whenever the device's low power mode status changes. The callback receives a boolean parameter indicating the new low power mode status.
+
+Files to modify:
+- `www/android/diagnostic.js` (add the JS implementation for Android)
+- `www/ios/diagnostic.js` (add the JS implementation for iOS)
+- `cordova.plugins.diagnostic.d.ts` (add TypeScript definitions for the new methods)
+- `README.md` (add documentation for the new methods)
+- `src/android/Diagnostic.java` (add native implementation for Android)
+- `src/ios/Diagnostic.m` and `src/ios/Diagnostic.h` (add native implementation for iOS)
+
+iOS Implementation notes:
+```swift
+// Check current status
+let isLowPowerEnabled = ProcessInfo.processInfo.isLowPowerModeEnabled
+
+// Listen for changes
+NotificationCenter.default.addObserver(
+    forName: .NSProcessInfoPowerStateDidChange,
+    object: nil,
+    queue: .main
+) { _ in
+    let newValue = ProcessInfo.processInfo.isLowPowerModeEnabled
+    print("Low Power Mode is now \(newValue)")
+}
+```
+
+Android Implementation notes:
+```kotlin
+val powerManager = context.getSystemService(Context.POWER_SERVICE) as PowerManager
+
+// Check current status
+val isBatterySaverOn = powerManager.isPowerSaveMode
+
+// Listen for changes (via BroadcastReceiver)
+// Filter for Intent.ACTION_POWER_SAVE_MODE_CHANGED
+```
+
+# Android ignore battery optimization
+
+Specifically for Android, only add:
+
+`Diagnostic.isIgnoringBatteryOptimizations()` - Use `PowerManager.isIgnoringBatteryOptimizations()` to check if the app is currently ignoring battery optimizations.
+`Diagnostic.requestIgnoreBatteryOptimizations()` - Use `Intent.ACTION_REQUEST_IGNORE_BATTERY_OPTIMIZATIONS` to prompt the user to allow the app to ignore battery optimizations. This will require the `REQUEST_IGNORE_BATTERY_OPTIMIZATIONS` permission in the Android manifest.
+
+Update the appropriate files to include these methods and their documentation.
+
+---
+
+_**Agent (copilot/gpt-5.4)**_
+
+I’m locating the existing core Diagnostic API patterns and the closest Android/iOS permission or event implementations so I can mirror them with minimal surface change.

package/.specstory/statistics.json

@@ -0,0 +1,13 @@
+{
+  "sessions": {
+    "922bf8ba-7963-4797-8a44-61255bede17d": {
+      "user_message_count": 1,
+      "agent_message_count": 1,
+      "start_timestamp": "2026-05-08T16:16:59+01:00",
+      "end_timestamp": "1970-01-01T01:00:00+01:00",
+      "markdown_size_bytes": 2928,
+      "provider": "copilotide",
+      "last_updated": "2026-06-25T11:53:59Z"
+    }
+  }
+}

package/CHANGELOG.md

@@ -1,5 +1,8 @@
 # CHANGELOG
 
+**v7.3.1**
+* (android) add explicit support for runtime permissions up to API 37
+
 **v7.3.0**
 * (ios & android) feat: add `isLowPowerModeEnabled()` and `onLowPowerModeChange()` to core module to check if low power mode is enabled on the device.
 * (android) feat: add `isIgnoringBatteryOptimizations()` and `requestIgnoreBatteryOptimizations()` to core module to check if the app is ignoring battery optimizations and request to be added to the ignore list.

package/README.md

@@ -4231,6 +4231,7 @@ The plugin defines all [dangerous permissions](http://developer.android.com/guid
 - `cordova.plugins.diagnostic.permission.ACCESS_BACKGROUND_LOCATION`
 - `cordova.plugins.diagnostic.permission.ACCESS_COARSE_LOCATION`
 - `cordova.plugins.diagnostic.permission.ACCESS_FINE_LOCATION`
+- `cordova.plugins.diagnostic.permission.ACCESS_LOCAL_NETWORK`
 - `cordova.plugins.diagnostic.permission.ACCESS_MEDIA_LOCATION`
 - `cordova.plugins.diagnostic.permission.ACTIVITY_RECOGNITION`
 - `cordova.plugins.diagnostic.permission.ADD_VOICEMAIL`
@@ -4246,6 +4247,7 @@ The plugin defines all [dangerous permissions](http://developer.android.com/guid
 - `cordova.plugins.diagnostic.permission.NEARBY_WIFI_DEVICES`
 - `cordova.plugins.diagnostic.permission.POST_NOTIFICATIONS`
 - `cordova.plugins.diagnostic.permission.PROCESS_OUTGOING_CALLS`
+- `cordova.plugins.diagnostic.permission.RANGING`
 - `cordova.plugins.diagnostic.permission.READ_CALENDAR`
 - `cordova.plugins.diagnostic.permission.READ_CALL_LOG`
 - `cordova.plugins.diagnostic.permission.READ_CONTACTS`
@@ -4253,6 +4255,7 @@ The plugin defines all [dangerous permissions](http://developer.android.com/guid
 - `cordova.plugins.diagnostic.permission.READ_MEDIA_AUDIO`
 - `cordova.plugins.diagnostic.permission.READ_MEDIA_IMAGES`
 - `cordova.plugins.diagnostic.permission.READ_MEDIA_VIDEO`
+- `cordova.plugins.diagnostic.permission.READ_MEDIA_VISUAL_USER_SELECTED`
 - `cordova.plugins.diagnostic.permission.READ_PHONE_NUMBERS`
 - `cordova.plugins.diagnostic.permission.READ_PHONE_STATE`
 - `cordova.plugins.diagnostic.permission.READ_SMS`

package/cordova.plugins.diagnostic.d.ts

@@ -21,6 +21,7 @@ interface Diagnostic {
         "ACCESS_BACKGROUND_LOCATION": "ACCESS_BACKGROUND_LOCATION";
         "ACCESS_COARSE_LOCATION": "ACCESS_COARSE_LOCATION";
         "ACCESS_FINE_LOCATION": "ACCESS_FINE_LOCATION";
+        "ACCESS_LOCAL_NETWORK": "ACCESS_LOCAL_NETWORK";
         "ACCESS_MEDIA_LOCATION": "ACCESS_MEDIA_LOCATION";
         "ACTIVITY_RECOGNITION": "ACTIVITY_RECOGNITION";
         "ADD_VOICEMAIL": "ADD_VOICEMAIL";
@@ -36,6 +37,7 @@ interface Diagnostic {
         "NEARBY_WIFI_DEVICES": "NEARBY_WIFI_DEVICES";
         "POST_NOTIFICATIONS": "POST_NOTIFICATIONS";
         "PROCESS_OUTGOING_CALLS": "PROCESS_OUTGOING_CALLS";
+        "RANGING": "RANGING";
         "READ_CALENDAR": "READ_CALENDAR";
         "READ_CALL_LOG": "READ_CALL_LOG";
         "READ_CONTACTS": "READ_CONTACTS";
@@ -43,6 +45,7 @@ interface Diagnostic {
         "READ_MEDIA_AUDIO": "READ_MEDIA_AUDIO";
         "READ_MEDIA_IMAGES": "READ_MEDIA_IMAGES";
         "READ_MEDIA_VIDEO": "READ_MEDIA_VIDEO";
+        "READ_MEDIA_VISUAL_USER_SELECTED": "READ_MEDIA_VISUAL_USER_SELECTED";
         "READ_PHONE_NUMBERS": "READ_PHONE_NUMBERS";
         "READ_PHONE_STATE": "READ_PHONE_STATE";
         "READ_SMS": "READ_SMS";

package/package.json

@@ -1,5 +1,5 @@
 {
-    "version": "7.3.0",
+    "version": "7.3.1",
     "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.3.0">
+    version="7.3.1">
 
     <name>Diagnostic</name>
     <description>Cordova/Phonegap plugin to check the state of Location/WiFi/Camera/Bluetooth device settings.</description>

package/src/android/Diagnostic.java

@@ -149,6 +149,12 @@ public class Diagnostic extends CordovaPlugin{
         // API 34+
         Diagnostic.addBiDirMapEntry(_permissionsMap, "READ_MEDIA_VISUAL_USER_SELECTED", "android.permission.READ_MEDIA_VISUAL_USER_SELECTED");
 
+        // API 36+
+        Diagnostic.addBiDirMapEntry(_permissionsMap, "RANGING", "android.permission.RANGING");
+
+        // API 37+
+        Diagnostic.addBiDirMapEntry(_permissionsMap, "ACCESS_LOCAL_NETWORK", "android.permission.ACCESS_LOCAL_NETWORK");
+
         permissionsMap = Collections.unmodifiableMap(_permissionsMap);
     }
 

package/www/android/diagnostic.js

@@ -32,6 +32,7 @@ var Diagnostic = (function(){
         "ACCESS_BACKGROUND_LOCATION": "ACCESS_BACKGROUND_LOCATION",
         "ACCESS_COARSE_LOCATION": "ACCESS_COARSE_LOCATION",
         "ACCESS_FINE_LOCATION": "ACCESS_FINE_LOCATION",
+        "ACCESS_LOCAL_NETWORK": "ACCESS_LOCAL_NETWORK",
         "ACCESS_MEDIA_LOCATION": "ACCESS_MEDIA_LOCATION",
         "ACTIVITY_RECOGNITION": "ACTIVITY_RECOGNITION",
         "ADD_VOICEMAIL": "ADD_VOICEMAIL",
@@ -47,6 +48,7 @@ var Diagnostic = (function(){
         "NEARBY_WIFI_DEVICES": "NEARBY_WIFI_DEVICES",
         "POST_NOTIFICATIONS": "POST_NOTIFICATIONS",
         "PROCESS_OUTGOING_CALLS": "PROCESS_OUTGOING_CALLS",
+        "RANGING": "RANGING",
         "READ_CALENDAR": "READ_CALENDAR",
         "READ_CALL_LOG": "READ_CALL_LOG",
         "READ_CONTACTS": "READ_CONTACTS",
@@ -54,6 +56,7 @@ var Diagnostic = (function(){
         "READ_MEDIA_AUDIO": "READ_MEDIA_AUDIO",
         "READ_MEDIA_IMAGES": "READ_MEDIA_IMAGES",
         "READ_MEDIA_VIDEO": "READ_MEDIA_VIDEO",
+        "READ_MEDIA_VISUAL_USER_SELECTED": "READ_MEDIA_VISUAL_USER_SELECTED",
         "READ_PHONE_NUMBERS": "READ_PHONE_NUMBERS",
         "READ_PHONE_STATE": "READ_PHONE_STATE",
         "READ_SMS": "READ_SMS",