v1.2.11

Author: valentingomy

CHANGELOG.md

@@ -13,6 +13,78 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 ## [Unreleased]
 
 
+***
+
+## [1.2.11] - 2026-02-16
+
+### Added
+- ⌨️ **Keyboard Emulation API**: Full keyboard input simulation via REST API ([#keyboard](https://github.com/FreeKiosk/FreeKiosk/issues))
+  - **Single key press** (`GET|POST /api/remote/keyboard/{key}`): Send any keyboard key
+    - Supports: a-z, 0-9, F1-F12, space, tab, enter, escape, backspace, delete, arrows, symbols, media keys
+    - Over 80 named keys + single character support
+  - **Keyboard shortcuts** (`GET|POST /api/remote/keyboard?map=ctrl+c`): Send key combinations with modifiers
+    - Supports: ctrl, alt, shift, meta (Windows/Cmd key)
+    - Examples: `ctrl+c`, `ctrl+v`, `alt+f4`, `ctrl+shift+a`
+  - **Text input** (`POST /api/remote/text`): Type full text strings into focused input fields
+    - Body: `{"text": "Hello World!"}`
+    - Uses `Instrumentation.sendStringSync()` for natural text input
+  - All keyboard operations handled natively (no JS bridge — fast and reliable)
+- 📍 **GPS Location API** (`GET /api/location`): New endpoint for device GPS coordinates
+  - Returns: latitude, longitude, accuracy, altitude, speed, bearing, provider, timestamp
+  - Uses GPS, Network, and Passive location providers (best accuracy wins)
+  - Permissions already declared in manifest (`ACCESS_FINE_LOCATION` + `ACCESS_COARSE_LOCATION`)
+- 🔋 **Enriched Battery API**: `GET /api/battery` now returns additional data
+  - New fields: `temperature` (°C), `voltage` (V), `health` (good/overheat/dead/etc.), `technology` (Li-ion/etc.)
+  - Backward compatible: existing `level`, `charging`, `plugged` fields unchanged
+- 🔒 **Lock Device API** (`GET|POST /api/lock`): New endpoint to lock the device screen
+  - Uses `DevicePolicyManager.lockNow()` for a true screen lock (Device Owner required)
+  - Returns clear error message if Device Owner mode is not active
+- 🔄 **Restart UI API** (`GET|POST /api/restart-ui`): New endpoint to restart the app UI
+  - Calls `activity.recreate()` to fully restart the React Native activity
+  - Useful for remote troubleshooting without rebooting the device
+- 🗣️ **Text-to-Speech (TTS)**: Fully implemented native TTS via Android `TextToSpeech` engine
+  - TTS engine is initialized when the HTTP server starts
+  - Handled natively (no JS bridge dependency — works even if React Native is unresponsive)
+  - Auto-retries if TTS engine is not ready on first call
+- 📊 **Volume Read API** (`GET /api/volume`): New endpoint to read current volume level
+  - Returns `{ level: 0-100, maxLevel: 100 }` for easy integration with Home Assistant sensors
+
+### Fixed
+- 🐛 **Screen Sleep Scheduler - Black Screen & Navigation Lockout**: Fixed 4 critical bugs causing scheduler to malfunction
+  - **Feedback loop**: Scheduler re-entered sleep immediately after wake due to `isScheduledSleep` in useEffect dependency array
+  - **Navigation lockout**: Scheduler interval kept running while on PIN/Settings screen, calling `lockNow()` and locking user out
+  - **Wake-on-touch broken**: Touch events during sleep did nothing — never restored brightness or called `exitScheduledSleep()`
+  - **Stale closure**: `checkScreenSchedule()` used outdated state variable instead of ref
+  - **N-tap during sleep**: 5-tap for settings now properly exits scheduled sleep before navigating to PIN
+  - **Activity null after lockNow()**: `turnScreenOn()` now acquires WakeLock before checking for activity availability
+  - Fixes black screen issue on Android 8.1+ and impossible settings access during sleep windows
+- 🐛 **Power menu dismissed immediately on some devices (TECNO/HiOS)**: Fixed GlobalActions (power menu) being closed ~900ms after appearing when "Allow Power Button" is enabled in Lock Mode
+  - Root cause: `onWindowFocusChanged` aggressively re-applied immersive mode, stealing focus back from the system power menu window
+  - Additionally, `onResume` would re-trigger `startLockTask()` during the brief focus transition, compounding the issue
+  - Fix: debounced `hideSystemUI()` by 600ms on focus regain, and deferred `startLockTask()` re-lock when power button is allowed and focus was recently lost
+  - No security impact: Lock Task Mode remains fully active throughout — only the cosmetic immersive mode re-application is delayed
+  - Affects TECNO, Infinix, itel (HiOS) and potentially other OEMs with aggressive WindowManager behavior on Android 14+
+- 🐛 **Device Owner Status Hardcoded `false` in API**: Fixed `/api/info` and `/api/status` always reporting `isDeviceOwner: false`
+  - Was hardcoded to `false` in `HttpServerModule.getDeviceStatus()`
+  - Now performs a real `DevicePolicyManager.isDeviceOwnerApp()` check
+  - This caused external dashboards to incorrectly show Device Owner as inactive
+- 📺 **Screen On Not Working After lockNow()**: Fixed `GET /api/screen/on` failing when screen was off
+  - `reactContext.currentActivity` was `null` after `lockNow()` and the code silently did nothing
+  - WakeLock is now acquired **before** checking for activity (WakeLock works without activity)
+  - Added keyguard dismissal to properly wake from locked state
+  - Screen now reliably turns on whether activity is available or not
+- 🧹 **Clear Cache Now Actually Clears**: Fixed `/api/clearCache` which only reloaded the WebView
+  - Now performs a full native cache clear: WebView HTTP cache, cookies, Web Storage (localStorage/sessionStorage), form data
+  - Then forces a WebView remount on the JS side for a complete fresh start
+- 🔄 **In-App Update 404 Error**: Fixed update download failing with 404 error
+  - Now retrieves actual APK download URL from GitHub release assets instead of constructing it
+  - Eliminates filename case sensitivity issues (FreeKiosk vs freeKiosk)
+  - More robust: works regardless of APK naming convention changes
+  - Fallback to constructed URL if asset parsing fails
+- 📸 **Screenshot Race Condition**: Fixed `/api/screenshot` returning 503 intermittently
+  - Replaced `Thread.sleep(100)` with a proper `CountDownLatch` to wait for the UI thread
+  - Screenshot capture now waits up to 5 seconds for the UI thread to complete
+
 ***
 
 ## [1.2.10] - 2026-02-11

README.md

@@ -11,7 +11,7 @@
   </p>
 
   <p>
-    <img src="https://img.shields.io/badge/Version-1.2.10-blue.svg" alt="Version 1.2.9">
+    <img src="https://img.shields.io/badge/Version-1.2.11-blue.svg" alt="Version 1.2.9">
     <a href="https://github.com/rushb-fr/freekiosk/releases"><img src="https://img.shields.io/github/downloads/rushb-fr/freekiosk/total.svg" alt="Downloads"></a>
     <img src="https://img.shields.io/badge/License-MIT-blue.svg" alt="License: MIT">
     <img src="https://img.shields.io/badge/Android-8.0%2B-green.svg" alt="Android 8.0+">
@@ -261,7 +261,19 @@ Done! Your tablet is now in kiosk mode.
 
 ## 🗺️ Roadmap
 
-### ✅ v1.2.10 (Feb 2026) - URL Filtering, NFC Fix & Scroll to Top 🆕
+### ✅ v1.2.11 (Feb 2026) - Keyboard API, GPS, TTS & Major Fixes 🆕
+- ⌨️ **Keyboard Emulation API**: Full keyboard input, shortcuts & text typing via REST
+- 📍 **GPS Location API**: Device coordinates via `/api/location`
+- 🔋 **Enriched Battery API**: Temperature, voltage, health & technology fields
+- 🔒 **Lock Device API** & 🔄 **Restart UI API**: New remote control endpoints
+- 🗣️ **Text-to-Speech (TTS)**: Native Android TTS via REST API
+- 📊 **Volume Read API**: Current volume level via `/api/volume`
+- 🐛 **Screen Sleep Scheduler Fix**: Fixed black screen, lockout & wake-on-touch bugs
+- 🐛 **Power Menu Fix (TECNO/HiOS)**: Fixed power menu dismissed immediately
+- 🧹 **Clear Cache Fix**: Now performs full native cache clear
+- 🔄 **Update 404 Fix**: Retrieves actual APK URL from GitHub assets
+
+### ✅ v1.2.10 (Feb 2026) - URL Filtering, NFC Fix & Scroll to Top
 - ⏱️ **Inactivity Return - Scroll to Top**: Smoothly scrolls to top when already on start page
 - 🔗 **URL Filtering (Blacklist / Whitelist)**: Control allowed URLs with wildcard patterns
 - 🔗 **URL Filtering Form Fix**: Fixed form submissions blocked in whitelist mode

android/app/build.gradle

@@ -90,8 +90,8 @@ android {
         applicationId "com.freekiosk"
         minSdkVersion rootProject.ext.minSdkVersion
         targetSdkVersion rootProject.ext.targetSdkVersion
-        versionCode 25
-        versionName "1.2.10"
+        versionCode 26
+        versionName "1.2.11"
 
         manifestPlaceholders = [usesCleartextTraffic: "true"]
     }

android/app/src/main/java/com/freekiosk/AppLauncherModule.kt

@@ -58,15 +58,22 @@ class AppLauncherModule(reactContext: ReactApplicationContext) : ReactContextBas
                                         val cursor2 = db.rawQuery("SELECT value FROM catalystLocalStorage WHERE key = ?", arrayOf("@kiosk_allow_notifications"))
                                         val allowNotifications = if (cursor2.moveToFirst()) cursor2.getString(0) == "true" else false
                                         cursor2.close()
+                                        
+                                        val cursor3 = db.rawQuery("SELECT value FROM catalystLocalStorage WHERE key = ?", arrayOf("@kiosk_allow_system_info"))
+                                        val allowSystemInfo = if (cursor3.moveToFirst()) cursor3.getString(0) == "true" else false
+                                        cursor3.close()
                                         db.close()
 
+                                        if (allowSystemInfo) {
+                                            lockTaskFeatures = lockTaskFeatures or android.app.admin.DevicePolicyManager.LOCK_TASK_FEATURE_SYSTEM_INFO
+                                        }
                                         if (allowPowerButton) {
                                             lockTaskFeatures = lockTaskFeatures or android.app.admin.DevicePolicyManager.LOCK_TASK_FEATURE_GLOBAL_ACTIONS
                                         }
                                         if (allowNotifications) {
                                             lockTaskFeatures = lockTaskFeatures or android.app.admin.DevicePolicyManager.LOCK_TASK_FEATURE_NOTIFICATIONS
                                         }
-                                        DebugLog.d("AppLauncherModule", "Lock task features: powerButton=$allowPowerButton, notifications=$allowNotifications (flags=$lockTaskFeatures)")
+                                        DebugLog.d("AppLauncherModule", "Lock task features: powerButton=$allowPowerButton, notifications=$allowNotifications, systemInfo=$allowSystemInfo (flags=$lockTaskFeatures)")
                                     } catch (e: Exception) {
                                         DebugLog.d("AppLauncherModule", "Could not read settings, using LOCK_TASK_FEATURE_NONE: ${e.message}")
                                     }

android/app/src/main/java/com/freekiosk/KioskModule.kt

@@ -85,7 +85,7 @@ class KioskModule(reactContext: ReactApplicationContext) : ReactContextBaseJavaM
     }
 
     @ReactMethod
-    fun startLockTask(externalAppPackage: String?, allowPowerButton: Boolean, allowNotifications: Boolean, promise: Promise) {
+    fun startLockTask(externalAppPackage: String?, allowPowerButton: Boolean, allowNotifications: Boolean, allowSystemInfo: Boolean, promise: Promise) {
         try {
             val activity = reactApplicationContext.currentActivity
             if (activity != null && activity is MainActivity) {
@@ -113,6 +113,11 @@ class KioskModule(reactContext: ReactApplicationContext) : ReactContextBaseJavaM
                             if (android.os.Build.VERSION.SDK_INT >= android.os.Build.VERSION_CODES.P) {
                                 var lockTaskFeatures = DevicePolicyManager.LOCK_TASK_FEATURE_NONE
 
+                                // SYSTEM_INFO: shows non-interactive status bar info (time, battery)
+                                // Fixes Samsung/OneUI devices muting audio in lock task mode
+                                if (allowSystemInfo) {
+                                    lockTaskFeatures = lockTaskFeatures or DevicePolicyManager.LOCK_TASK_FEATURE_SYSTEM_INFO
+                                }
                                 if (allowPowerButton) {
                                     lockTaskFeatures = lockTaskFeatures or DevicePolicyManager.LOCK_TASK_FEATURE_GLOBAL_ACTIONS
                                 }
@@ -122,7 +127,7 @@ class KioskModule(reactContext: ReactApplicationContext) : ReactContextBaseJavaM
                                     lockTaskFeatures = lockTaskFeatures or DevicePolicyManager.LOCK_TASK_FEATURE_HOME
                                 }
                                 dpm.setLockTaskFeatures(adminComponent, lockTaskFeatures)
-                                android.util.Log.d("KioskModule", "Lock task features set: powerButton=$allowPowerButton, notifications=$allowNotifications (flags=$lockTaskFeatures)")
+                                android.util.Log.d("KioskModule", "Lock task features set: powerButton=$allowPowerButton, notifications=$allowNotifications, systemInfo=$allowSystemInfo (flags=$lockTaskFeatures)")
                             }
 
                             dpm.setLockTaskPackages(adminComponent, whitelist.toTypedArray())
@@ -375,25 +380,29 @@ class KioskModule(reactContext: ReactApplicationContext) : ReactContextBaseJavaM
     @ReactMethod
     fun turnScreenOn(promise: Promise) {
         try {
+            val powerManager = reactApplicationContext.getSystemService(Context.POWER_SERVICE) as PowerManager
+            
+            // IMPORTANT: Acquire WakeLock FIRST, before checking for activity
+            // After lockNow(), activity may be null, but WakeLock still works
+            
+            // Release old wakeLock if exists
+            wakeLock?.release()
+            
+            // Create WakeLock to turn on screen
+            @Suppress("DEPRECATION")
+            wakeLock = powerManager.newWakeLock(
+                PowerManager.FULL_WAKE_LOCK or 
+                PowerManager.ACQUIRE_CAUSES_WAKEUP or 
+                PowerManager.ON_AFTER_RELEASE,
+                "FreeKiosk:ScreenOn"
+            )
+            wakeLock?.acquire(10*60*1000L) // 10 minutes timeout
+            android.util.Log.d("KioskModule", "WakeLock acquired to turn screen ON")
+            
             val activity = reactApplicationContext.currentActivity
             if (activity != null) {
                 activity.runOnUiThread {
                     try {
-                        val powerManager = reactApplicationContext.getSystemService(Context.POWER_SERVICE) as PowerManager
-                        
-                        // Release old wakeLock if exists
-                        wakeLock?.release()
-                        
-                        // Create WakeLock to turn on screen
-                        @Suppress("DEPRECATION")
-                        wakeLock = powerManager.newWakeLock(
-                            PowerManager.FULL_WAKE_LOCK or 
-                            PowerManager.ACQUIRE_CAUSES_WAKEUP or 
-                            PowerManager.ON_AFTER_RELEASE,
-                            "FreeKiosk:ScreenOn"
-                        )
-                        wakeLock?.acquire(10*60*1000L) // 10 minutes timeout
-                        
                         // Show over lock screen and dismiss keyguard (in case PIN is set)
                         if (android.os.Build.VERSION.SDK_INT >= android.os.Build.VERSION_CODES.O_MR1) {
                             activity.setShowWhenLocked(true)
@@ -417,17 +426,19 @@ class KioskModule(reactContext: ReactApplicationContext) : ReactContextBaseJavaM
                         layoutParams.screenBrightness = WindowManager.LayoutParams.BRIGHTNESS_OVERRIDE_NONE
                         activity.window.attributes = layoutParams
 
-                        android.util.Log.d("KioskModule", "Screen turned ON via WakeLock + keyguard dismissed")
-                        promise.resolve(true)
+                        android.util.Log.d("KioskModule", "Screen turned ON via WakeLock + activity flags")
                     } catch (e: Exception) {
-                        android.util.Log.e("KioskModule", "Failed to turn screen on: ${e.message}")
-                        promise.reject("ERROR", "Failed to turn screen on: ${e.message}")
+                        android.util.Log.e("KioskModule", "Failed to set activity flags: ${e.message}")
                     }
                 }
             } else {
-                promise.reject("ERROR", "Activity not available")
+                android.util.Log.w("KioskModule", "Activity is null after lockNow() — WakeLock alone will wake screen")
             }
+            
+            // Resolve immediately - WakeLock handles the wake even if activity is null
+            promise.resolve(true)
         } catch (e: Exception) {
+            android.util.Log.e("KioskModule", "Failed to turn screen on: ${e.message}")
             promise.reject("ERROR", "Failed to turn screen on: ${e.message}")
         }
     }