pakstr 0.22.0 → 0.23.0

package/README.md

@@ -49,7 +49,7 @@ build:
 #   apiBase: https://api.example.com  # Optional packaged /api/* proxy target.
 ```
 
-`runtime.apiBase` must be an absolute HTTPS URL. It is public APK metadata, not a secret. When omitted, Pakstr generates an empty runtime config and keeps `/api/*` disabled; when set, `/api/x` forwards to `<apiBase>/api/x`.
+`runtime.apiBase` must be an absolute HTTPS URL. It is the immutable packaged/default proxy target and public APK metadata, not a secret. The effective target precedence is persistent runtime override, then packaged default, then disabled. A web app may call `window.PakstrBridge.setApiBaseUrl(url)` to validate and synchronously persist an HTTPS override, and `window.PakstrBridge.getApiBaseUrl()` to read the effective URL. Developer Tools uses the same setting. Reset removes the override and restores the packaged default; without a packaged default it disables `/api/*`. Changes affect the next proxy request without an app restart, LocalServer restart, or WebView reload.
 
 ### 3. Build, sign, and publish
 ```bash

package/android-template/app/src/main/java/com/pakstr/app/LocalServer.kt

@@ -80,6 +80,11 @@ internal fun localRequestUrl(
             if (query.isNullOrEmpty()) "" else "?$query"
 )
 
+internal fun proxyApiUrl(
+    apiBase: String,
+    uri: String
+): URL = URL(apiBase + uri)
+
 internal data class ProxyHttpResponse(
     val code: Int,
     val contentType: String?,
@@ -258,7 +263,8 @@ class LocalServer(
         )
         if (uri.startsWith("/api/")) {
 
-            if (!RuntimeConfig.apiEnabled(context)) {
+            val apiBase = RuntimeConfig.apiBase(context)
+            if (apiBase == null) {
 
                 AppDebugLogger.network(
 
@@ -283,7 +289,7 @@ class LocalServer(
                 )
             }
 
-            return proxyApi(session, uri)
+            return proxyApi(session, uri, apiBase)
 
         }
 
@@ -370,7 +376,7 @@ class LocalServer(
     }
 
     private fun proxyApi(
-        session: IHTTPSession?, uri: String
+        session: IHTTPSession?, uri: String, apiBase: String
     ): Response {
 
         if (AppDebugLogger.isNetworkLoggingEnabled(context)) {
@@ -386,29 +392,7 @@ class LocalServer(
 
         return try {
 
-            val config = RuntimeConfig.load(context)
-
-            val apiBase = config.optString("apiBase")
-
-            if (apiBase.isBlank()) {
-                AppDebugLogger.error(
-
-                    context,
-
-                    "API",
-
-                    "apiBase missing"
-
-                )
-                return newFixedLengthResponse(
-                    Response.Status.INTERNAL_ERROR,
-                    "application/json",
-                    """{"error":"apiBase missing"}"""
-                )
-            }
-
-            val finalUrl = apiBase.removeSuffix("/") + uri
-            val url = URL(finalUrl)
+            val url = proxyApiUrl(apiBase, uri)
             val method = session?.method?.name ?: "GET"
             val requestHeaders = session?.headers ?: emptyMap()
             val localRequestUrl = localRequestUrl(
@@ -438,7 +422,7 @@ class LocalServer(
                 if (AppDebugLogger.isNetworkLoggingEnabled(context)) {
                     AppDebugLogger.network(
                         context,
-                        "Response: ${response.code} $finalUrl"
+                        "Proxy response: ${response.code}"
                     )
                 }
                 return newFixedLengthResponse(
@@ -498,7 +482,7 @@ class LocalServer(
                 AppDebugLogger.network(
 
                     context,
-                    "Response: $code $finalUrl"
+                    "Proxy response: $code"
 
                 )
 

package/android-template/app/src/main/java/com/pakstr/app/PakstrBridge.kt

@@ -2,10 +2,22 @@ package com.pakstr.app
 
 import android.webkit.JavascriptInterface
 
-class PakstrBridge {
+class PakstrBridge(
+    private val runtimeApiBaseSettings: RuntimeApiBaseSettings
+) {
 
     @JavascriptInterface
     fun getNip55CallbackUrl(): String {
         return Nip55Callback.callbackPrefix
     }
+
+    @JavascriptInterface
+    fun setApiBaseUrl(url: String): Boolean {
+        return runtimeApiBaseSettings.setOverride(url)
+    }
+
+    @JavascriptInterface
+    fun getApiBaseUrl(): String? {
+        return runtimeApiBaseSettings.current().url
+    }
 }

package/android-template/app/src/main/java/com/pakstr/app/RuntimeApiBaseSettings.kt

@@ -0,0 +1,98 @@
+package com.pakstr.app
+
+import android.content.Context
+import android.content.SharedPreferences
+
+class RuntimeApiBaseSettings private constructor(
+    private val preferences: Preferences,
+    private val packagedValueProvider: () -> String?
+) {
+    enum class Source {
+        RUNTIME_OVERRIDE,
+        PACKAGED_DEFAULT,
+        DISABLED
+    }
+
+    data class Value(
+        val url: String?,
+        val source: Source
+    )
+
+    fun current(): Value = resolveEffectiveValue(
+        persistedOverride = preferences.getString(API_BASE_OVERRIDE_KEY),
+        packagedDefault = packagedValueProvider()
+    )
+
+    fun setOverride(value: String): Boolean {
+        val canonical = RuntimeApiBaseValidator.validateAndCanonicalize(value)
+            ?: return false
+        return preferences.putString(API_BASE_OVERRIDE_KEY, canonical)
+    }
+
+    fun reset(): Boolean = preferences.remove(API_BASE_OVERRIDE_KEY)
+
+    internal interface Preferences {
+        fun getString(key: String): String?
+        fun putString(key: String, value: String): Boolean
+        fun remove(key: String): Boolean
+    }
+
+    private class SharedPreferencesAdapter(
+        private val preferences: SharedPreferences
+    ) : Preferences {
+        override fun getString(key: String): String? = preferences.getString(key, null)
+
+        override fun putString(key: String, value: String): Boolean =
+            preferences.edit().putString(key, value).commit()
+
+        override fun remove(key: String): Boolean =
+            preferences.edit().remove(key).commit()
+    }
+
+    companion object {
+        internal const val PREFERENCES_FILE = "pakstr_runtime_api_base"
+        internal const val API_BASE_OVERRIDE_KEY = "api_base_override"
+
+        fun from(context: Context): RuntimeApiBaseSettings {
+            val applicationContext = context.applicationContext
+            val preferences = applicationContext.getSharedPreferences(
+                PREFERENCES_FILE,
+                Context.MODE_PRIVATE
+            )
+            return RuntimeApiBaseSettings(
+                SharedPreferencesAdapter(preferences)
+            ) {
+                RuntimeConfig.packagedApiBase(applicationContext)
+            }
+        }
+
+        internal fun resolveEffectiveValue(
+            persistedOverride: String?,
+            packagedDefault: String?
+        ): Value {
+            val override = RuntimeApiBaseValidator.validateAndCanonicalize(
+                persistedOverride
+            )
+            if (override != null) {
+                return Value(override, Source.RUNTIME_OVERRIDE)
+            }
+
+            val packaged = RuntimeApiBaseValidator.validateAndCanonicalize(
+                packagedDefault
+            )
+            return if (packaged != null) {
+                Value(packaged, Source.PACKAGED_DEFAULT)
+            } else {
+                Value(null, Source.DISABLED)
+            }
+        }
+
+        internal fun createForTesting(
+            preferences: Preferences,
+            packagedValueProvider: () -> String?
+        ): RuntimeApiBaseSettings = RuntimeApiBaseSettings(
+            preferences,
+            packagedValueProvider
+        )
+    }
+}

package/android-template/app/src/main/java/com/pakstr/app/RuntimeApiBaseValidator.kt

@@ -0,0 +1,30 @@
+package com.pakstr.app
+
+import java.net.URI
+
+object RuntimeApiBaseValidator {
+    const val MAX_LENGTH = 2048
+
+    fun validateAndCanonicalize(value: String?): String? {
+        if (
+            value == null ||
+            value.isEmpty() ||
+            value.length > MAX_LENGTH ||
+            value != value.trim()
+        ) {
+            return null
+        }
+
+        val uri = runCatching { URI(value) }.getOrNull() ?: return null
+        if (!uri.isAbsolute || !uri.scheme.equals("https", ignoreCase = true)) return null
+        if (uri.host.isNullOrBlank()) return null
+        if (uri.rawUserInfo != null || uri.rawQuery != null || uri.rawFragment != null) return null
+
+        val host = uri.host.lowercase().let {
+            if (it.contains(':') && !it.startsWith("[")) "[$it]" else it
+        }
+        val port = if (uri.port == -1) "" else ":${uri.port}"
+        val path = uri.rawPath.orEmpty().trimEnd('/')
+        return "https://$host$port$path"
+    }
+}

package/android-template/app/src/main/java/com/pakstr/app/RuntimeConfig.kt

@@ -58,19 +58,14 @@ object RuntimeConfig {
      */
     fun apiBase(
         context: Context
-    ): String? {
+    ): String? = RuntimeApiBaseSettings.from(context).current().url
 
-        val value = load(context).optString(
-                "apiBase", ""
-            )
-
-
-        debug("apiBase=$value")
-
-
-        return value.takeIf {
-            it.isNotBlank()
-        }
+    internal fun packagedApiBase(
+        context: Context
+    ): String? = load(context).optString(
+        "apiBase", ""
+    ).takeIf {
+        it.isNotBlank()
     }
 
     /**

package/android-template/app/src/main/java/com/pakstr/app/WebViewController.kt

@@ -339,7 +339,7 @@ class WebViewController(
 
         )
         webView.addJavascriptInterface(
-            PakstrBridge(),
+            PakstrBridge(RuntimeApiBaseSettings.from(context)),
             "PakstrBridge"
         )
 

package/android-template/app/src/main/java/com/pakstr/app/debug/DeveloperToolsActivity.kt

@@ -15,13 +15,18 @@ import android.widget.TextView
 import android.widget.Toast
 import androidx.activity.enableEdgeToEdge
 import androidx.appcompat.app.AppCompatActivity
+import androidx.core.view.ViewCompat
+import androidx.core.view.WindowInsetsCompat
+import androidx.core.view.updatePadding
 import com.google.android.material.appbar.MaterialToolbar
 import com.google.android.material.button.MaterialButton
 import com.google.android.material.dialog.MaterialAlertDialogBuilder
 import com.google.android.material.switchmaterial.SwitchMaterial
+import com.google.android.material.textfield.TextInputEditText
+import com.google.android.material.textfield.TextInputLayout
 import com.pakstr.app.BuildConfig
 import com.pakstr.app.R
-import com.pakstr.app.RuntimeConfig
+import com.pakstr.app.RuntimeApiBaseSettings
 
 class DeveloperToolsActivity : AppCompatActivity() {
 
@@ -30,8 +35,12 @@ class DeveloperToolsActivity : AppCompatActivity() {
     private lateinit var uptimeValue: TextView
     private lateinit var debugModeSwitch: SwitchMaterial
     private lateinit var apiSwitch: SwitchMaterial
+    private lateinit var apiBaseInputLayout: TextInputLayout
+    private lateinit var apiBaseInput: TextInputEditText
+    private lateinit var apiBaseSource: TextView
     private lateinit var debugWebViewStatus: TextView
     private lateinit var webViewStatus: TextView
+    private lateinit var runtimeApiBaseSettings: RuntimeApiBaseSettings
 
     private val uptimeUpdater = object : Runnable {
         override fun run() {
@@ -50,11 +59,14 @@ class DeveloperToolsActivity : AppCompatActivity() {
         }
 
         setContentView(R.layout.activity_developer_tools)
+        runtimeApiBaseSettings = RuntimeApiBaseSettings.from(this)
 
+        setupWindowInsets()
         setupToolbar()
         bindViews()
         populateRuntimeDetails()
         setupDebugControls()
+        setupApiBaseControls()
         setupLogActions()
         setupCrashTesting()
         setupWebViewActions()
@@ -71,6 +83,18 @@ class DeveloperToolsActivity : AppCompatActivity() {
         super.onStop()
     }
 
+    private fun setupWindowInsets() {
+        ViewCompat.setOnApplyWindowInsetsListener(
+            findViewById(R.id.developerToolsRoot)
+        ) { view, insets ->
+            val bars = insets.getInsets(
+                WindowInsetsCompat.Type.systemBars()
+            )
+            view.updatePadding(top = bars.top)
+            insets
+        }
+    }
+
     private fun setupToolbar() {
         findViewById<MaterialToolbar>(R.id.developerToolsToolbar).setNavigationOnClickListener {
             finish()
@@ -81,6 +105,9 @@ class DeveloperToolsActivity : AppCompatActivity() {
         uptimeValue = findViewById(R.id.runtimeUptimeValue)
         debugModeSwitch = findViewById(R.id.debugModeSwitch)
         apiSwitch = findViewById(R.id.apiEnabledSwitch)
+        apiBaseInputLayout = findViewById(R.id.apiBaseInputLayout)
+        apiBaseInput = findViewById(R.id.apiBaseInput)
+        apiBaseSource = findViewById(R.id.apiBaseSource)
         debugWebViewStatus = findViewById(R.id.debugWebViewStatus)
         webViewStatus = findViewById(R.id.webViewStatus)
     }
@@ -101,8 +128,6 @@ class DeveloperToolsActivity : AppCompatActivity() {
     }
 
     private fun setupDebugControls() {
-        apiSwitch.isChecked = RuntimeConfig.apiEnabled(this)
-
         debugModeSwitch.setOnCheckedChangeListener { _, isChecked ->
             if (isChecked) {
                 DeveloperToolsManager.enableDebug(this)
@@ -115,9 +140,50 @@ class DeveloperToolsActivity : AppCompatActivity() {
         }
     }
 
+    private fun setupApiBaseControls() {
+        findViewById<MaterialButton>(R.id.saveApiBaseButton).setOnClickListener {
+            val value = apiBaseInput.text?.toString().orEmpty()
+            if (runtimeApiBaseSettings.setOverride(value)) {
+                apiBaseInputLayout.error = null
+                refreshApiBase()
+                showMessage(R.string.developer_tools_api_base_saved)
+            } else {
+                apiBaseInputLayout.error = getString(
+                    R.string.developer_tools_api_base_invalid
+                )
+            }
+        }
+        findViewById<MaterialButton>(R.id.resetApiBaseButton).setOnClickListener {
+            if (runtimeApiBaseSettings.reset()) {
+                apiBaseInputLayout.error = null
+                refreshApiBase()
+                showMessage(R.string.developer_tools_api_base_reset)
+            } else {
+                showMessage(R.string.developer_tools_api_base_save_failed)
+            }
+        }
+        refreshApiBase()
+    }
+
+    private fun refreshApiBase() {
+        val current = runtimeApiBaseSettings.current()
+        apiSwitch.isChecked = current.url != null
+        apiBaseInput.setText(current.url.orEmpty())
+        apiBaseSource.setText(
+            when (current.source) {
+                RuntimeApiBaseSettings.Source.RUNTIME_OVERRIDE ->
+                    R.string.developer_tools_api_base_runtime_override
+                RuntimeApiBaseSettings.Source.PACKAGED_DEFAULT ->
+                    R.string.developer_tools_api_base_packaged_default
+                RuntimeApiBaseSettings.Source.DISABLED ->
+                    R.string.developer_tools_api_base_not_configured
+            }
+        )
+    }
+
     private fun refreshStatuses() {
         debugModeSwitch.isChecked = DeveloperToolsManager.isEnabled(this)
-        apiSwitch.isChecked = RuntimeConfig.apiEnabled(this)
+        refreshApiBase()
 
         val status = if (isWebViewDebugEnabled()) {
             R.string.developer_tools_enabled

package/android-template/app/src/main/res/layout/activity_developer_tools.xml

@@ -1,18 +1,18 @@
 <?xml version="1.0" encoding="utf-8"?>
 <LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
     xmlns:app="http://schemas.android.com/apk/res-auto"
+    android:id="@+id/developerToolsRoot"
     android:layout_width="match_parent"
     android:layout_height="match_parent"
-    android:paddingBottom="56dp"
     android:background="?android:attr/colorBackground"
-    android:orientation="vertical">
+    android:orientation="vertical"
+    android:paddingBottom="56dp">
 
     <com.google.android.material.appbar.MaterialToolbar
         android:id="@+id/developerToolsToolbar"
         android:layout_width="match_parent"
         android:layout_height="?attr/actionBarSize"
         android:background="?attr/colorSurface"
-        android:elevation="4dp"
         app:navigationIcon="?attr/homeAsUpIndicator"
         app:title="@string/developer_tools_title" />
 
@@ -20,98 +20,132 @@
         android:layout_width="match_parent"
         android:layout_height="0dp"
         android:layout_weight="1"
+        android:clipToPadding="false"
         android:fillViewport="true">
 
         <LinearLayout
             android:layout_width="match_parent"
             android:layout_height="wrap_content"
             android:orientation="vertical"
-            android:padding="16dp">
+            android:paddingStart="16dp"
+            android:paddingTop="12dp"
+            android:paddingEnd="16dp"
+            android:paddingBottom="24dp">
+
+            <TextView
+                style="@style/TextAppearance.MaterialComponents.Body2"
+                android:layout_width="match_parent"
+                android:layout_height="wrap_content"
+                android:layout_marginStart="4dp"
+                android:layout_marginEnd="4dp"
+                android:layout_marginBottom="20dp"
+                android:text="@string/developer_tools_description"
+                android:textColor="?android:attr/textColorSecondary" />
 
             <com.google.android.material.card.MaterialCardView
                 android:layout_width="match_parent"
                 android:layout_height="wrap_content"
                 android:layout_marginBottom="16dp"
-                app:cardCornerRadius="12dp"
-                app:cardElevation="1dp">
+                app:cardCornerRadius="16dp"
+                app:cardElevation="0dp"
+                app:strokeColor="?attr/colorControlNormal"
+                app:strokeWidth="1dp">
 
                 <LinearLayout
                     android:layout_width="match_parent"
                     android:layout_height="wrap_content"
                     android:orientation="vertical"
-                    android:padding="16dp">
+                    android:padding="20dp">
 
                     <TextView
                         style="@style/TextAppearance.MaterialComponents.Headline6"
                         android:layout_width="wrap_content"
                         android:layout_height="wrap_content"
-                        android:layout_marginBottom="16dp"
                         android:text="@string/developer_tools_runtime" />
 
+                    <TextView
+                        style="@style/TextAppearance.MaterialComponents.Caption"
+                        android:layout_width="match_parent"
+                        android:layout_height="wrap_content"
+                        android:layout_marginTop="2dp"
+                        android:layout_marginBottom="20dp"
+                        android:text="@string/developer_tools_runtime_description"
+                        android:textColor="?android:attr/textColorSecondary" />
+
                     <TextView
                         style="@style/TextAppearance.MaterialComponents.Caption"
                         android:layout_width="wrap_content"
                         android:layout_height="wrap_content"
-                        android:text="@string/developer_tools_session_id" />
+                        android:text="@string/developer_tools_session_id"
+                        android:textColor="?android:attr/textColorSecondary" />
 
                     <TextView
                         android:id="@+id/runtimeSessionIdValue"
                         style="@style/TextAppearance.MaterialComponents.Body2"
                         android:layout_width="match_parent"
                         android:layout_height="wrap_content"
-                        android:layout_marginBottom="12dp"
+                        android:layout_marginTop="2dp"
+                        android:layout_marginBottom="14dp"
                         android:textIsSelectable="true" />
 
                     <TextView
                         style="@style/TextAppearance.MaterialComponents.Caption"
                         android:layout_width="wrap_content"
                         android:layout_height="wrap_content"
-                        android:text="@string/developer_tools_app_version" />
+                        android:text="@string/developer_tools_app_version"
+                        android:textColor="?android:attr/textColorSecondary" />
 
                     <TextView
                         android:id="@+id/runtimeAppVersionValue"
                         style="@style/TextAppearance.MaterialComponents.Body2"
                         android:layout_width="match_parent"
                         android:layout_height="wrap_content"
-                        android:layout_marginBottom="12dp" />
+                        android:layout_marginTop="2dp"
+                        android:layout_marginBottom="14dp" />
 
                     <TextView
                         style="@style/TextAppearance.MaterialComponents.Caption"
                         android:layout_width="wrap_content"
                         android:layout_height="wrap_content"
-                        android:text="@string/developer_tools_android_version" />
+                        android:text="@string/developer_tools_android_version"
+                        android:textColor="?android:attr/textColorSecondary" />
 
                     <TextView
                         android:id="@+id/runtimeAndroidVersionValue"
                         style="@style/TextAppearance.MaterialComponents.Body2"
                         android:layout_width="match_parent"
                         android:layout_height="wrap_content"
-                        android:layout_marginBottom="12dp" />
+                        android:layout_marginTop="2dp"
+                        android:layout_marginBottom="14dp" />
 
                     <TextView
                         style="@style/TextAppearance.MaterialComponents.Caption"
                         android:layout_width="wrap_content"
                         android:layout_height="wrap_content"
-                        android:text="@string/developer_tools_device_model" />
+                        android:text="@string/developer_tools_device_model"
+                        android:textColor="?android:attr/textColorSecondary" />
 
                     <TextView
                         android:id="@+id/runtimeDeviceModelValue"
                         style="@style/TextAppearance.MaterialComponents.Body2"
                         android:layout_width="match_parent"
                         android:layout_height="wrap_content"
-                        android:layout_marginBottom="12dp" />
+                        android:layout_marginTop="2dp"
+                        android:layout_marginBottom="14dp" />
 
                     <TextView
                         style="@style/TextAppearance.MaterialComponents.Caption"
                         android:layout_width="wrap_content"
                         android:layout_height="wrap_content"
-                        android:text="@string/developer_tools_app_uptime" />
+                        android:text="@string/developer_tools_app_uptime"
+                        android:textColor="?android:attr/textColorSecondary" />
 
                     <TextView
                         android:id="@+id/runtimeUptimeValue"
                         style="@style/TextAppearance.MaterialComponents.Body2"
                         android:layout_width="match_parent"
-                        android:layout_height="wrap_content" />
+                        android:layout_height="wrap_content"
+                        android:layout_marginTop="2dp" />
                 </LinearLayout>
             </com.google.android.material.card.MaterialCardView>
 
@@ -119,33 +153,100 @@
                 android:layout_width="match_parent"
                 android:layout_height="wrap_content"
                 android:layout_marginBottom="16dp"
-                app:cardCornerRadius="12dp"
-                app:cardElevation="1dp">
+                app:cardCornerRadius="16dp"
+                app:cardElevation="0dp"
+                app:strokeColor="?attr/colorControlNormal"
+                app:strokeWidth="1dp">
 
                 <LinearLayout
                     android:layout_width="match_parent"
                     android:layout_height="wrap_content"
                     android:orientation="vertical"
-                    android:padding="16dp">
+                    android:padding="20dp">
 
                     <TextView
                         style="@style/TextAppearance.MaterialComponents.Headline6"
                         android:layout_width="wrap_content"
                         android:layout_height="wrap_content"
-                        android:layout_marginBottom="8dp"
                         android:text="@string/developer_tools_debug" />
 
+                    <TextView
+                        style="@style/TextAppearance.MaterialComponents.Caption"
+                        android:layout_width="match_parent"
+                        android:layout_height="wrap_content"
+                        android:layout_marginTop="2dp"
+                        android:layout_marginBottom="12dp"
+                        android:text="@string/developer_tools_debug_description"
+                        android:textColor="?android:attr/textColorSecondary" />
+
                     <com.google.android.material.switchmaterial.SwitchMaterial
                         android:id="@+id/debugModeSwitch"
                         android:layout_width="match_parent"
                         android:layout_height="wrap_content"
+                        android:minHeight="48dp"
                         android:text="@string/developer_tools_enable_debug_mode" />
 
+                    <LinearLayout
+                        android:layout_width="match_parent"
+                        android:layout_height="wrap_content"
+                        android:layout_marginTop="8dp"
+                        android:gravity="center_vertical"
+                        android:minHeight="48dp"
+                        android:orientation="horizontal">
+
+                        <TextView
+                            style="@style/TextAppearance.MaterialComponents.Body1"
+                            android:layout_width="0dp"
+                            android:layout_height="wrap_content"
+                            android:layout_weight="1"
+                            android:text="@string/developer_tools_webview_debug" />
+
+                        <TextView
+                            android:id="@+id/debugWebViewStatus"
+                            style="@style/TextAppearance.MaterialComponents.Body2"
+                            android:layout_width="wrap_content"
+                            android:layout_height="wrap_content"
+                            android:textColor="?android:attr/textColorSecondary" />
+                    </LinearLayout>
+                </LinearLayout>
+            </com.google.android.material.card.MaterialCardView>
+
+            <com.google.android.material.card.MaterialCardView
+                android:layout_width="match_parent"
+                android:layout_height="wrap_content"
+                android:layout_marginBottom="16dp"
+                app:cardCornerRadius="16dp"
+                app:cardElevation="0dp"
+                app:strokeColor="?attr/colorControlNormal"
+                app:strokeWidth="1dp">
+
+                <LinearLayout
+                    android:layout_width="match_parent"
+                    android:layout_height="wrap_content"
+                    android:orientation="vertical"
+                    android:padding="20dp">
+
+                    <TextView
+                        style="@style/TextAppearance.MaterialComponents.Headline6"
+                        android:layout_width="wrap_content"
+                        android:layout_height="wrap_content"
+                        android:text="@string/developer_tools_api_proxy" />
+
+                    <TextView
+                        style="@style/TextAppearance.MaterialComponents.Caption"
+                        android:layout_width="match_parent"
+                        android:layout_height="wrap_content"
+                        android:layout_marginTop="2dp"
+                        android:layout_marginBottom="8dp"
+                        android:text="@string/developer_tools_api_proxy_description"
+                        android:textColor="?android:attr/textColorSecondary" />
+
                     <com.google.android.material.switchmaterial.SwitchMaterial
                         android:id="@+id/apiEnabledSwitch"
                         android:layout_width="match_parent"
                         android:layout_height="wrap_content"
                         android:enabled="false"
+                        android:minHeight="48dp"
                         android:text="@string/developer_tools_enable_api" />
 
                     <TextView
@@ -154,7 +255,58 @@
                         android:layout_height="wrap_content"
                         android:layout_marginStart="4dp"
                         android:layout_marginBottom="16dp"
-                        android:text="@string/developer_tools_api_read_only" />
+                        android:text="@string/developer_tools_api_effective_status"
+                        android:textColor="?android:attr/textColorSecondary" />
+
+                    <TextView
+                        style="@style/TextAppearance.MaterialComponents.Overline"
+                        android:layout_width="match_parent"
+                        android:layout_height="wrap_content"
+                        android:layout_marginBottom="8dp"
+                        android:text="@string/developer_tools_api_effective_configuration"
+                        android:textColor="?android:attr/textColorSecondary" />
+
+                    <com.google.android.material.card.MaterialCardView
+                        android:layout_width="match_parent"
+                        android:layout_height="wrap_content"
+                        android:layout_marginBottom="16dp"
+                        app:cardCornerRadius="12dp"
+                        app:cardElevation="0dp"
+                        app:strokeColor="?attr/colorControlNormal"
+                        app:strokeWidth="1dp">
+
+                        <LinearLayout
+                            android:layout_width="match_parent"
+                            android:layout_height="wrap_content"
+                            android:orientation="vertical"
+                            android:padding="16dp">
+
+                            <com.google.android.material.textfield.TextInputLayout
+                                android:id="@+id/apiBaseInputLayout"
+                                style="@style/Widget.MaterialComponents.TextInputLayout.OutlinedBox"
+                                android:layout_width="match_parent"
+                                android:layout_height="wrap_content"
+                                android:hint="@string/developer_tools_api_base_url">
+
+                                <com.google.android.material.textfield.TextInputEditText
+                                    android:id="@+id/apiBaseInput"
+                                    android:layout_width="match_parent"
+                                    android:layout_height="wrap_content"
+                                    android:inputType="textUri"
+                                    android:maxLength="2048"
+                                    android:singleLine="true" />
+                            </com.google.android.material.textfield.TextInputLayout>
+
+                            <TextView
+                                android:id="@+id/apiBaseSource"
+                                style="@style/TextAppearance.MaterialComponents.Body2"
+                                android:layout_width="match_parent"
+                                android:layout_height="wrap_content"
+                                android:layout_marginStart="4dp"
+                                android:layout_marginTop="8dp"
+                                android:textColor="?android:attr/textColorSecondary" />
+                        </LinearLayout>
+                    </com.google.android.material.card.MaterialCardView>
 
                     <LinearLayout
                         android:layout_width="match_parent"
@@ -162,18 +314,21 @@
                         android:gravity="center_vertical"
                         android:orientation="horizontal">
 
-                        <TextView
-                            style="@style/TextAppearance.MaterialComponents.Body1"
+                        <com.google.android.material.button.MaterialButton
+                            android:id="@+id/saveApiBaseButton"
                             android:layout_width="0dp"
-                            android:layout_height="wrap_content"
+                            android:layout_height="match_parent"
                             android:layout_weight="1"
-                            android:text="@string/developer_tools_webview_debug" />
+                            android:text="@string/developer_tools_api_base_save" />
 
-                        <TextView
-                            android:id="@+id/debugWebViewStatus"
-                            style="@style/TextAppearance.MaterialComponents.Body2"
-                            android:layout_width="wrap_content"
-                            android:layout_height="wrap_content" />
+                        <com.google.android.material.button.MaterialButton
+                            android:id="@+id/resetApiBaseButton"
+                            style="@style/Widget.MaterialComponents.Button.OutlinedButton"
+                            android:layout_width="0dp"
+                            android:layout_height="match_parent"
+                            android:layout_marginStart="8dp"
+                            android:layout_weight="1"
+                            android:text="@string/developer_tools_api_base_reset_button" />
                     </LinearLayout>
                 </LinearLayout>
             </com.google.android.material.card.MaterialCardView>
@@ -182,22 +337,32 @@
                 android:layout_width="match_parent"
                 android:layout_height="wrap_content"
                 android:layout_marginBottom="16dp"
-                app:cardCornerRadius="12dp"
-                app:cardElevation="1dp">
+                app:cardCornerRadius="16dp"
+                app:cardElevation="0dp"
+                app:strokeColor="?attr/colorControlNormal"
+                app:strokeWidth="1dp">
 
                 <LinearLayout
                     android:layout_width="match_parent"
                     android:layout_height="wrap_content"
                     android:orientation="vertical"
-                    android:padding="16dp">
+                    android:padding="20dp">
 
                     <TextView
                         style="@style/TextAppearance.MaterialComponents.Headline6"
                         android:layout_width="wrap_content"
                         android:layout_height="wrap_content"
-                        android:layout_marginBottom="8dp"
                         android:text="@string/developer_tools_logs" />
 
+                    <TextView
+                        style="@style/TextAppearance.MaterialComponents.Caption"
+                        android:layout_width="match_parent"
+                        android:layout_height="wrap_content"
+                        android:layout_marginTop="2dp"
+                        android:layout_marginBottom="16dp"
+                        android:text="@string/developer_tools_logs_description"
+                        android:textColor="?android:attr/textColorSecondary" />
+
                     <com.google.android.material.button.MaterialButton
                         android:id="@+id/viewLogsButton"
                         style="@style/Widget.MaterialComponents.Button.OutlinedButton"
@@ -210,18 +375,22 @@
                         style="@style/Widget.MaterialComponents.Button.OutlinedButton"
                         android:layout_width="match_parent"
                         android:layout_height="wrap_content"
+                        android:layout_marginTop="4dp"
                         android:text="@string/developer_tools_clear_logs" />
 
                     <com.google.android.material.button.MaterialButton
                         android:id="@+id/exportDebugReportButton"
                         android:layout_width="match_parent"
                         android:layout_height="wrap_content"
+                        android:layout_marginTop="12dp"
                         android:text="@string/developer_tools_export_debug_report" />
 
                     <com.google.android.material.button.MaterialButton
                         android:id="@+id/shareReportButton"
+                        style="@style/Widget.MaterialComponents.Button.OutlinedButton"
                         android:layout_width="match_parent"
                         android:layout_height="wrap_content"
+                        android:layout_marginTop="4dp"
                         android:text="@string/developer_tools_share_report" />
                 </LinearLayout>
             </com.google.android.material.card.MaterialCardView>
@@ -230,55 +399,38 @@
                 android:layout_width="match_parent"
                 android:layout_height="wrap_content"
                 android:layout_marginBottom="16dp"
-                app:cardCornerRadius="12dp"
-                app:cardElevation="1dp">
+                app:cardCornerRadius="16dp"
+                app:cardElevation="0dp"
+                app:strokeColor="?attr/colorControlNormal"
+                app:strokeWidth="1dp">
 
                 <LinearLayout
                     android:layout_width="match_parent"
                     android:layout_height="wrap_content"
                     android:orientation="vertical"
-                    android:padding="16dp">
+                    android:padding="20dp">
 
                     <TextView
                         style="@style/TextAppearance.MaterialComponents.Headline6"
                         android:layout_width="wrap_content"
                         android:layout_height="wrap_content"
-                        android:layout_marginBottom="8dp"
-                        android:text="@string/developer_tools_crash_testing" />
-
-                    <com.google.android.material.button.MaterialButton
-                        android:id="@+id/throwTestExceptionButton"
-                        style="@style/Widget.MaterialComponents.Button.OutlinedButton"
-                        android:layout_width="match_parent"
-                        android:layout_height="wrap_content"
-                        android:text="@string/developer_tools_throw_test_exception" />
-                </LinearLayout>
-            </com.google.android.material.card.MaterialCardView>
-
-            <com.google.android.material.card.MaterialCardView
-                android:layout_width="match_parent"
-                android:layout_height="wrap_content"
-                app:cardCornerRadius="12dp"
-                app:cardElevation="1dp">
-
-                <LinearLayout
-                    android:layout_width="match_parent"
-                    android:layout_height="wrap_content"
-                    android:orientation="vertical"
-                    android:padding="16dp">
+                        android:text="@string/developer_tools_webview" />
 
                     <TextView
-                        style="@style/TextAppearance.MaterialComponents.Headline6"
-                        android:layout_width="wrap_content"
+                        style="@style/TextAppearance.MaterialComponents.Caption"
+                        android:layout_width="match_parent"
                         android:layout_height="wrap_content"
+                        android:layout_marginTop="2dp"
                         android:layout_marginBottom="12dp"
-                        android:text="@string/developer_tools_webview" />
+                        android:text="@string/developer_tools_webview_description"
+                        android:textColor="?android:attr/textColorSecondary" />
 
                     <LinearLayout
                         android:layout_width="match_parent"
                         android:layout_height="wrap_content"
                         android:layout_marginBottom="12dp"
                         android:gravity="center_vertical"
+                        android:minHeight="48dp"
                         android:orientation="horizontal">
 
                         <TextView
@@ -292,7 +444,8 @@
                             android:id="@+id/webViewStatus"
                             style="@style/TextAppearance.MaterialComponents.Body2"
                             android:layout_width="wrap_content"
-                            android:layout_height="wrap_content" />
+                            android:layout_height="wrap_content"
+                            android:textColor="?android:attr/textColorSecondary" />
                     </LinearLayout>
 
                     <com.google.android.material.button.MaterialButton
@@ -303,6 +456,44 @@
                         android:text="@string/developer_tools_open_chrome_inspect_docs" />
                 </LinearLayout>
             </com.google.android.material.card.MaterialCardView>
+
+            <com.google.android.material.card.MaterialCardView
+                android:layout_width="match_parent"
+                android:layout_height="wrap_content"
+                app:cardCornerRadius="16dp"
+                app:cardElevation="0dp"
+                app:strokeColor="?attr/colorControlNormal"
+                app:strokeWidth="1dp">
+
+                <LinearLayout
+                    android:layout_width="match_parent"
+                    android:layout_height="wrap_content"
+                    android:orientation="vertical"
+                    android:padding="20dp">
+
+                    <TextView
+                        style="@style/TextAppearance.MaterialComponents.Headline6"
+                        android:layout_width="wrap_content"
+                        android:layout_height="wrap_content"
+                        android:text="@string/developer_tools_crash_testing" />
+
+                    <TextView
+                        style="@style/TextAppearance.MaterialComponents.Caption"
+                        android:layout_width="match_parent"
+                        android:layout_height="wrap_content"
+                        android:layout_marginTop="2dp"
+                        android:layout_marginBottom="16dp"
+                        android:text="@string/developer_tools_crash_testing_description"
+                        android:textColor="?android:attr/textColorSecondary" />
+
+                    <com.google.android.material.button.MaterialButton
+                        android:id="@+id/throwTestExceptionButton"
+                        style="@style/Widget.MaterialComponents.Button.OutlinedButton"
+                        android:layout_width="match_parent"
+                        android:layout_height="wrap_content"
+                        android:text="@string/developer_tools_throw_test_exception" />
+                </LinearLayout>
+            </com.google.android.material.card.MaterialCardView>
         </LinearLayout>
     </androidx.core.widget.NestedScrollView>
 </LinearLayout>

package/android-template/app/src/main/res/values/strings.xml

@@ -2,7 +2,9 @@
     <string name="app_name">Pakstr</string>
 
     <string name="developer_tools_title">Developer Tools</string>
+    <string name="developer_tools_description">Inspect the app runtime, configure diagnostics, and collect information for troubleshooting.</string>
     <string name="developer_tools_runtime">Runtime</string>
+    <string name="developer_tools_runtime_description">App, device, and session details</string>
     <string name="developer_tools_session_id">Session ID</string>
     <string name="developer_tools_app_version">App version</string>
     <string name="developer_tools_android_version">Android version</string>
@@ -12,14 +14,29 @@
     <string name="developer_tools_device_value">%1$s %2$s</string>
 
     <string name="developer_tools_debug">Debug</string>
+    <string name="developer_tools_debug_description">Control diagnostic logging and inspection</string>
     <string name="developer_tools_enable_debug_mode">Enable Debug Mode</string>
-    <string name="developer_tools_enable_api">Enable API</string>
-    <string name="developer_tools_api_read_only">Controlled by the packaged runtime configuration.</string>
+    <string name="developer_tools_api_proxy">API Proxy</string>
+    <string name="developer_tools_api_proxy_description">Configure the backend used for same-origin /api/* requests.</string>
+    <string name="developer_tools_enable_api">API proxy enabled</string>
+    <string name="developer_tools_api_effective_status">Read-only status based on the effective API Base URL.</string>
+    <string name="developer_tools_api_effective_configuration">Effective configuration</string>
+    <string name="developer_tools_api_base_url">API Base URL</string>
+    <string name="developer_tools_api_base_runtime_override">Source: runtime override</string>
+    <string name="developer_tools_api_base_packaged_default">Source: packaged default</string>
+    <string name="developer_tools_api_base_not_configured">Source: not configured; API proxy disabled</string>
+    <string name="developer_tools_api_base_save">Save / Apply</string>
+    <string name="developer_tools_api_base_reset_button">Reset to default</string>
+    <string name="developer_tools_api_base_saved">API Base URL override applied.</string>
+    <string name="developer_tools_api_base_reset">Runtime override removed.</string>
+    <string name="developer_tools_api_base_save_failed">Unable to persist the API Base URL setting.</string>
+    <string name="developer_tools_api_base_invalid">Enter an absolute HTTPS URL without credentials, query, or fragment.</string>
     <string name="developer_tools_webview_debug">WebView Debug</string>
     <string name="developer_tools_enabled">Enabled</string>
     <string name="developer_tools_disabled">Disabled</string>
 
-    <string name="developer_tools_logs">Logs</string>
+    <string name="developer_tools_logs">Logs &amp; Reports</string>
+    <string name="developer_tools_logs_description">Review local diagnostics or export them for support</string>
     <string name="developer_tools_view_logs">View Logs</string>
     <string name="developer_tools_clear_logs">Clear Logs</string>
     <string name="developer_tools_export_debug_report">Export Debug Report</string>
@@ -32,13 +49,15 @@
     <string name="developer_tools_report_export_failed">Unable to export the debug report.</string>
 
     <string name="developer_tools_crash_testing">Crash Testing</string>
+    <string name="developer_tools_crash_testing_description">Verify that uncaught errors are captured correctly</string>
     <string name="developer_tools_throw_test_exception">Throw Test Exception</string>
     <string name="developer_tools_crash_confirmation_title">Crash Pakstr?</string>
     <string name="developer_tools_crash_confirmation_message">This intentionally throws an uncaught RuntimeException and closes the app so CrashHandler can capture it.</string>
     <string name="developer_tools_crash">Crash</string>
 
-    <string name="developer_tools_webview">WebView</string>
-    <string name="developer_tools_current_status">Current WebView Debug status</string>
+    <string name="developer_tools_webview">WebView Inspection</string>
+    <string name="developer_tools_webview_description">Inspect rendered web content with Chrome DevTools</string>
+    <string name="developer_tools_current_status">Inspection status</string>
     <string name="developer_tools_open_chrome_inspect_docs">Open Chrome Inspect documentation</string>
     <string name="developer_tools_browser_unavailable">No browser is available.</string>
 

package/android-template/app/src/test/java/com/pakstr/app/PakstrBridgeRuntimeApiBaseTest.kt

@@ -0,0 +1,52 @@
+package com.pakstr.app
+
+import org.junit.Assert.assertEquals
+import org.junit.Assert.assertFalse
+import org.junit.Assert.assertTrue
+import org.junit.Test
+
+class PakstrBridgeRuntimeApiBaseTest {
+    @Test
+    fun setterPersistsValidatedOverrideAndGetterReturnsEffectiveValue() {
+        val preferences = FakePreferences()
+        val bridge = PakstrBridge(
+            RuntimeApiBaseSettings.createForTesting(preferences) {
+                "https://default.example.com"
+            }
+        )
+
+        assertTrue(bridge.setApiBaseUrl("https://override.example.com/"))
+        assertEquals("https://override.example.com", bridge.getApiBaseUrl())
+        assertFalse(bridge.setApiBaseUrl("http://unsafe.example.com"))
+        assertEquals("https://override.example.com", bridge.getApiBaseUrl())
+    }
+
+    @Test
+    fun setterReportsPersistenceFailure() {
+        val bridge = PakstrBridge(
+            RuntimeApiBaseSettings.createForTesting(FakePreferences(commitResult = false)) {
+                null
+            }
+        )
+
+        assertFalse(bridge.setApiBaseUrl("https://api.example.com"))
+    }
+
+    private class FakePreferences(
+        private val commitResult: Boolean = true
+    ) : RuntimeApiBaseSettings.Preferences {
+        private val values = mutableMapOf<String, String>()
+
+        override fun getString(key: String): String? = values[key]
+
+        override fun putString(key: String, value: String): Boolean {
+            if (commitResult) values[key] = value
+            return commitResult
+        }
+
+        override fun remove(key: String): Boolean {
+            if (commitResult) values.remove(key)
+            return commitResult
+        }
+    }
+}

package/android-template/app/src/test/java/com/pakstr/app/RuntimeApiBaseProxyTest.kt

@@ -0,0 +1,49 @@
+package com.pakstr.app
+
+import org.junit.Assert.assertEquals
+import org.junit.Assert.assertTrue
+import org.junit.Test
+
+class RuntimeApiBaseProxyTest {
+    @Test
+    fun proxyUsesUpdatedEffectiveValueOnSubsequentRequest() {
+        val preferences = FakePreferences()
+        val settings = RuntimeApiBaseSettings.createForTesting(preferences) {
+            "https://default.example.com"
+        }
+
+        val firstRequestApiBase = settings.current().url!!
+        assertEquals(
+            "https://default.example.com/api/items",
+            proxyApiUrl(firstRequestApiBase, "/api/items").toString()
+        )
+
+        assertTrue(settings.setOverride("https://updated.example.com/base/"))
+
+        val secondRequestApiBase = settings.current().url!!
+        assertEquals(
+            "https://updated.example.com/base/api/items",
+            proxyApiUrl(secondRequestApiBase, "/api/items").toString()
+        )
+        assertEquals(
+            "https://default.example.com/api/items",
+            proxyApiUrl(firstRequestApiBase, "/api/items").toString()
+        )
+    }
+
+    private class FakePreferences : RuntimeApiBaseSettings.Preferences {
+        private val values = mutableMapOf<String, String>()
+
+        override fun getString(key: String): String? = values[key]
+
+        override fun putString(key: String, value: String): Boolean {
+            values[key] = value
+            return true
+        }
+
+        override fun remove(key: String): Boolean {
+            values.remove(key)
+            return true
+        }
+    }
+}

package/android-template/app/src/test/java/com/pakstr/app/RuntimeApiBaseSettingsTest.kt

@@ -0,0 +1,107 @@
+package com.pakstr.app
+
+import org.junit.Assert.assertEquals
+import org.junit.Assert.assertFalse
+import org.junit.Assert.assertNull
+import org.junit.Assert.assertTrue
+import org.junit.Test
+
+class RuntimeApiBaseSettingsTest {
+    @Test
+    fun persistedOverrideTakesPrecedenceOverPackagedDefault() {
+        val preferences = FakePreferences()
+        val settings = settings(preferences, "https://default.example.com")
+
+        assertTrue(settings.setOverride("https://override.example.com/"))
+        assertEquals(
+            "https://override.example.com",
+            preferences.values[RuntimeApiBaseSettings.API_BASE_OVERRIDE_KEY]
+        )
+        assertEquals(
+            RuntimeApiBaseSettings.Value(
+                "https://override.example.com",
+                RuntimeApiBaseSettings.Source.RUNTIME_OVERRIDE
+            ),
+            settings.current()
+        )
+    }
+
+    @Test
+    fun resetRemovesOverrideAndRestoresPackagedDefault() {
+        val preferences = FakePreferences()
+        val settings = settings(preferences, "https://default.example.com/")
+        settings.setOverride("https://override.example.com")
+
+        assertTrue(settings.reset())
+        assertFalse(preferences.values.containsKey(RuntimeApiBaseSettings.API_BASE_OVERRIDE_KEY))
+        assertEquals(
+            RuntimeApiBaseSettings.Value(
+                "https://default.example.com",
+                RuntimeApiBaseSettings.Source.PACKAGED_DEFAULT
+            ),
+            settings.current()
+        )
+    }
+
+    @Test
+    fun noConfiguredDefaultDisablesApiProxy() {
+        val settings = settings(FakePreferences(), null)
+
+        assertEquals(
+            RuntimeApiBaseSettings.Value(
+                null,
+                RuntimeApiBaseSettings.Source.DISABLED
+            ),
+            settings.current()
+        )
+    }
+
+    @Test
+    fun invalidPersistedValueIsIgnored() {
+        val preferences = FakePreferences(
+            mutableMapOf(
+                RuntimeApiBaseSettings.API_BASE_OVERRIDE_KEY to "http://unsafe.example.com"
+            )
+        )
+
+        assertEquals(
+            "https://default.example.com",
+            settings(preferences, "https://default.example.com").current().url
+        )
+        assertNull(settings(preferences, null).current().url)
+    }
+
+    @Test
+    fun invalidOverrideDoesNotPersist() {
+        val preferences = FakePreferences()
+        val settings = settings(preferences, "https://default.example.com")
+
+        assertFalse(settings.setOverride("https://user@example.com"))
+        assertTrue(preferences.values.isEmpty())
+    }
+
+    private fun settings(
+        preferences: FakePreferences,
+        packagedDefault: String?
+    ): RuntimeApiBaseSettings = RuntimeApiBaseSettings.createForTesting(
+        preferences
+    ) {
+        packagedDefault
+    }
+
+    private class FakePreferences(
+        val values: MutableMap<String, String> = mutableMapOf()
+    ) : RuntimeApiBaseSettings.Preferences {
+        override fun getString(key: String): String? = values[key]
+
+        override fun putString(key: String, value: String): Boolean {
+            values[key] = value
+            return true
+        }
+
+        override fun remove(key: String): Boolean {
+            values.remove(key)
+            return true
+        }
+    }
+}

package/android-template/app/src/test/java/com/pakstr/app/RuntimeApiBaseValidatorTest.kt

@@ -0,0 +1,50 @@
+package com.pakstr.app
+
+import org.junit.Assert.assertEquals
+import org.junit.Assert.assertNull
+import org.junit.Test
+
+class RuntimeApiBaseValidatorTest {
+    @Test
+    fun acceptsAbsoluteHttpsUrlWithHostname() {
+        assertEquals(
+            "https://api.example.com/v1",
+            RuntimeApiBaseValidator.validateAndCanonicalize(
+                "https://api.example.com/v1"
+            )
+        )
+    }
+
+    @Test
+    fun normalizesTrailingSlashesAndHostCase() {
+        assertEquals(
+            "https://api.example.com/v1",
+            RuntimeApiBaseValidator.validateAndCanonicalize(
+                "HTTPS://API.Example.COM/v1///"
+            )
+        )
+        assertEquals(
+            "https://api.example.com",
+            RuntimeApiBaseValidator.validateAndCanonicalize(
+                "https://api.example.com/"
+            )
+        )
+    }
+
+    @Test
+    fun rejectsInvalidOrUnsafeUrls() {
+        listOf(
+            "",
+            " https://api.example.com",
+            "http://api.example.com",
+            "api.example.com",
+            "https:///v1",
+            "https://user:password@api.example.com",
+            "https://api.example.com?v=1",
+            "https://api.example.com#fragment",
+            "https://api.example.com/${"a".repeat(RuntimeApiBaseValidator.MAX_LENGTH)}"
+        ).forEach { value ->
+            assertNull(value, RuntimeApiBaseValidator.validateAndCanonicalize(value))
+        }
+    }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pakstr",
-  "version": "0.22.0",
+  "version": "0.23.0",
   "description": "CLI for packaging Nostr web apps into Android APKs",
   "type": "commonjs",
   "main": "dist/index.js",