craft-native 0.0.245 → 0.0.247

package/dist/android/src/index.d.ts

@@ -11,6 +11,20 @@ export type { AndroidMapProvider } from './native-map.js';
  * route's file. Stacks asks for route bundles only when this is true.
  */
 export declare const nativeRouteBundles = true;
+/**
+ * The app evaluates stx's shared runtime (`__runtime.js`, stx's
+ * `sharedRuntime`) in each screen's context before the route's own file.
+ * Stacks asks stx for it only when this is true: a route file built so
+ * refuses to run without it.
+ */
+export declare const nativeRouteRuntime = true;
+/**
+ * The app gives a screen its messages a language at a time (stx's
+ * `messages`, `native-screens/__messages/`): the areas its route uses,
+ * evaluated ahead of it (an isolate cannot read a file when asked). Stacks leaves the languages
+ * out of the screens' code only when this is true.
+ */
+export declare const nativeMessages = true;
 /** Providers this published builder can generate as real Android map views. */
 export declare const nativeMapProviders: readonly ['google', 'maplibre'];
 export { runKotlinFixture } from './testing.js';
@@ -46,6 +60,15 @@ export interface CraftAndroidConfig {
     enableGeolocation?: boolean;
     enableBackgroundLocation?: boolean;
     enableBluetooth?: boolean;
+    /**
+     * A Bluetooth heart-rate strap, or a watch broadcasting its heart rate (the
+     * standard Heart Rate Service), through `craft.heartRate` on a page and the
+     * `HeartRate` module on a native screen (CraftHeartRate.kt): scan, connect,
+     * live readings as `craftHeartRate` events, and a recording kept natively,
+     * in the foreground (a connectedDevice service) while it runs. The iOS
+     * builder's flag of the same name.
+     */
+    enableHeartRate?: boolean;
     enableHealthConnect?: boolean;
     /**
      * The Health Connect data the app reads and writes, by the shared type

package/dist/android/src/index.js

@@ -360,6 +360,8 @@ async function createAndroidEmulator(options) {
 
 // ../android/src/index.ts
 var nativeRouteBundles = true;
+var nativeRouteRuntime = true;
+var nativeMessages = true;
 var nativeMapProviders = ["google", "maplibre"];
 function syncNativeFonts(fonts, output) {
   const destination = join3(output, "app/src/main/assets/NativeFonts");
@@ -496,6 +498,7 @@ var DEFAULT_CONFIG = {
   enableGeolocation: false,
   enableBackgroundLocation: false,
   enableBluetooth: false,
+  enableHeartRate: false,
   enableHealthConnect: false,
   enableKeepAwake: false,
   enableDeepLinks: false,
@@ -788,7 +791,11 @@ function renderAndroidPermissions(config) {
     healthConnectPermissions(config).forEach((permission) => permissions.add(permission));
   if (config.renderer === "native" && config.backgroundRefresh?.enabled)
     permissions.add("android.permission.RECEIVE_BOOT_COMPLETED");
-  const bluetooth = config.enableBluetooth ? [
+  if (config.enableHeartRate) {
+    permissions.add("android.permission.FOREGROUND_SERVICE");
+    permissions.add("android.permission.FOREGROUND_SERVICE_CONNECTED_DEVICE");
+  }
+  const bluetooth = config.enableBluetooth || config.enableHeartRate ? [
     '    <uses-permission android:name="android.permission.BLUETOOTH" android:maxSdkVersion="30" />',
     '    <uses-permission android:name="android.permission.BLUETOOTH_ADMIN" android:maxSdkVersion="30" />',
     '    <uses-permission android:name="android.permission.BLUETOOTH_SCAN" android:usesPermissionFlags="neverForLocation" />',
@@ -1017,7 +1024,7 @@ async function init(options) {
     writeNativeShellSources(output, packagePath, finalPackageName, config);
   }
   const craftBridgeTemplate = readFileSync2(join3(TEMPLATES_DIR, "CraftBridge.kt.template"), "utf-8");
-  const craftBridge = craftBridgeTemplate.replace(/\{\{PROMISE_RUNTIME\}\}/g, () => renderAndroidPromiseRuntime("            ")).replace(/\{\{PACKAGE_NAME\}\}/g, finalPackageName).replace(/\{\{ENABLE_SPEECH\}\}/g, String(Boolean(config.enableSpeechRecognition))).replace(/\{\{ENABLE_HAPTICS\}\}/g, String(Boolean(config.enableHaptics))).replace(/\{\{ENABLE_SHARE\}\}/g, String(Boolean(config.enableShare))).replace(/\{\{ENABLE_CAMERA\}\}/g, String(Boolean(config.enableCamera))).replace(/\{\{ENABLE_BIOMETRIC\}\}/g, String(Boolean(config.enableBiometric))).replace(/\{\{ENABLE_PUSH\}\}/g, String(Boolean(config.enablePushNotifications))).replace(/\{\{ENABLE_SECURE_STORAGE\}\}/g, String(Boolean(config.enableSecureStorage))).replace(/\{\{ENABLE_GEOLOCATION\}\}/g, String(Boolean(config.enableGeolocation))).replace(/\{\{ENABLE_BACKGROUND_LOCATION\}\}/g, String(Boolean(config.enableBackgroundLocation))).replace(/\{\{ENABLE_KEEP_AWAKE\}\}/g, String(Boolean(config.enableKeepAwake))).replace(/\{\{ENABLE_DEEP_LINKS\}\}/g, String(Boolean(config.enableDeepLinks))).replace(/\{\{ENABLE_HEALTH_CONNECT\}\}/g, String(Boolean(config.enableHealthConnect))).replace(/\{\{FIREBASE_IMPORT\}\}/g, config.enablePushNotifications ? "import com.google.firebase.messaging.FirebaseMessaging" : "").replace(/\{\{REGISTER_PUSH_IMPLEMENTATION\}\}/g, config.enablePushNotifications ? `activity.runOnUiThread {
+  const craftBridge = craftBridgeTemplate.replace(/\{\{PROMISE_RUNTIME\}\}/g, () => renderAndroidPromiseRuntime("            ")).replace(/\{\{PACKAGE_NAME\}\}/g, finalPackageName).replace(/\{\{ENABLE_SPEECH\}\}/g, String(Boolean(config.enableSpeechRecognition))).replace(/\{\{ENABLE_HAPTICS\}\}/g, String(Boolean(config.enableHaptics))).replace(/\{\{ENABLE_SHARE\}\}/g, String(Boolean(config.enableShare))).replace(/\{\{ENABLE_CAMERA\}\}/g, String(Boolean(config.enableCamera))).replace(/\{\{ENABLE_BIOMETRIC\}\}/g, String(Boolean(config.enableBiometric))).replace(/\{\{ENABLE_PUSH\}\}/g, String(Boolean(config.enablePushNotifications))).replace(/\{\{ENABLE_SECURE_STORAGE\}\}/g, String(Boolean(config.enableSecureStorage))).replace(/\{\{ENABLE_GEOLOCATION\}\}/g, String(Boolean(config.enableGeolocation))).replace(/\{\{ENABLE_BACKGROUND_LOCATION\}\}/g, String(Boolean(config.enableBackgroundLocation))).replace(/\{\{ENABLE_KEEP_AWAKE\}\}/g, String(Boolean(config.enableKeepAwake))).replace(/\{\{ENABLE_DEEP_LINKS\}\}/g, String(Boolean(config.enableDeepLinks))).replace(/\{\{ENABLE_HEALTH_CONNECT\}\}/g, String(Boolean(config.enableHealthConnect))).replace(/\{\{ENABLE_HEART_RATE\}\}/g, String(Boolean(config.enableHeartRate))).replace(/\{\{FIREBASE_IMPORT\}\}/g, config.enablePushNotifications ? "import com.google.firebase.messaging.FirebaseMessaging" : "").replace(/\{\{REGISTER_PUSH_IMPLEMENTATION\}\}/g, config.enablePushNotifications ? `activity.runOnUiThread {
             if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.TIRAMISU
                 && ContextCompat.checkSelfPermission(activity, Manifest.permission.POST_NOTIFICATIONS) != PackageManager.PERMISSION_GRANTED) {
                 ActivityCompat.requestPermissions(activity, arrayOf(Manifest.permission.POST_NOTIFICATIONS), 4204)
@@ -1045,8 +1052,11 @@ async function init(options) {
   writeFileSync(join3(nativeDir, "LocationRecordingService.kt"), serviceTemplate.replace(/\{\{PACKAGE_NAME\}\}/g, finalPackageName));
   const healthTemplate = readFileSync2(join3(TEMPLATES_DIR, config.enableHealthConnect ? "CraftHealthConnect.kt.template" : "CraftHealthConnectStub.kt.template"), "utf-8");
   writeFileSync(join3(output, "app/src/main/java", packagePath, "CraftHealthConnect.kt"), healthTemplate.replace(/\{\{PACKAGE_NAME\}\}/g, finalPackageName));
+  for (const [template, file] of [["CraftHeartRateCore.kt.template", "CraftHeartRateCore.kt"], ["CraftHeartRate.kt.template", "CraftHeartRate.kt"]]) {
+    writeFileSync(join3(output, "app/src/main/java", packagePath, file), readFileSync2(join3(TEMPLATES_DIR, template), "utf8").replace(/\{\{PACKAGE_NAME\}\}/g, finalPackageName));
+  }
   const manifestTemplate = readFileSync2(join3(TEMPLATES_DIR, "AndroidManifest.xml.template"), "utf-8");
-  const manifest = manifestTemplate.replace(/\{\{PACKAGE_NAME\}\}/g, finalPackageName).replace(/\{\{APP_NAME\}\}/g, name).replace(/\{\{PERMISSIONS\}\}/g, renderAndroidPermissions(config)).replace(/\{\{USES_CLEARTEXT\}\}/g, config.devServerURL?.startsWith("http://") || config.enableLocalNetwork ? "true" : "false").replace(/\{\{DEEP_LINK_INTENT_FILTERS\}\}/g, renderAndroidDeepLinks(config)).replace(/\{\{BACKGROUND_SERVICE\}\}/g, config.enableBackgroundLocation ? '        <service android:name="com.craft.runtime.LocationRecordingService" android:exported="false" android:foregroundServiceType="location" android:stopWithTask="false" />' : "").replace(/\{\{NATIVE_NOTIFICATION_RECEIVER\}\}/g, config.renderer === "native" ? renderNativeShellManifest(config) : "").replace(/\{\{CRASH_REPORTER_PROVIDER\}\}/g, `        <provider android:name=".CraftCrashReporterInit" android:authorities="\${applicationId}.craft-crash" android:exported="false" android:initOrder="1000" />`).replace(/\{\{GOOGLE_MAPS_API_KEY\}\}/g, config.mapProvider !== "maplibre" && config.mapsApiKey ? `        <meta-data android:name="com.google.android.geo.API_KEY" android:value="${escapeXml(config.mapsApiKey)}" />` : "").replace(/\{\{HEALTH_CONNECT_QUERIES\}\}/g, config.enableHealthConnect ? `    <queries>
+  const manifest = manifestTemplate.replace(/\{\{PACKAGE_NAME\}\}/g, finalPackageName).replace(/\{\{APP_NAME\}\}/g, name).replace(/\{\{PERMISSIONS\}\}/g, renderAndroidPermissions(config)).replace(/\{\{USES_CLEARTEXT\}\}/g, config.devServerURL?.startsWith("http://") || config.enableLocalNetwork ? "true" : "false").replace(/\{\{DEEP_LINK_INTENT_FILTERS\}\}/g, renderAndroidDeepLinks(config)).replace(/\{\{BACKGROUND_SERVICE\}\}/g, config.enableBackgroundLocation ? '        <service android:name="com.craft.runtime.LocationRecordingService" android:exported="false" android:foregroundServiceType="location" android:stopWithTask="false" />' : "").replace(/\{\{HEART_RATE_SERVICE\}\}/g, config.enableHeartRate ? '        <service android:name=".CraftHeartRateService" android:exported="false" android:foregroundServiceType="connectedDevice" />' : "").replace(/\{\{NATIVE_NOTIFICATION_RECEIVER\}\}/g, config.renderer === "native" ? renderNativeShellManifest(config) : "").replace(/\{\{CRASH_REPORTER_PROVIDER\}\}/g, `        <provider android:name=".CraftCrashReporterInit" android:authorities="\${applicationId}.craft-crash" android:exported="false" android:initOrder="1000" />`).replace(/\{\{GOOGLE_MAPS_API_KEY\}\}/g, config.mapProvider !== "maplibre" && config.mapsApiKey ? `        <meta-data android:name="com.google.android.geo.API_KEY" android:value="${escapeXml(config.mapsApiKey)}" />` : "").replace(/\{\{HEALTH_CONNECT_QUERIES\}\}/g, config.enableHealthConnect ? `    <queries>
         <package android:name="com.google.android.apps.healthdata" />
     </queries>` : "").replace(/\{\{HEALTH_CONNECT_RATIONALE\}\}/g, config.enableHealthConnect ? `            <intent-filter>
                 <action android:name="androidx.health.ACTION_SHOW_PERMISSIONS_RATIONALE" />
@@ -1380,7 +1390,9 @@ export {
   renderAndroidPermissions,
   renderAndroidDeepLinks,
   open,
+  nativeRouteRuntime,
   nativeRouteBundles,
+  nativeMessages,
   nativeMapProviders,
   installRuntime,
   init,

package/dist/android/templates/AndroidManifest.xml.template

@@ -55,6 +55,7 @@
         </activity>
 
 {{BACKGROUND_SERVICE}}
+{{HEART_RATE_SERVICE}}
 {{NATIVE_NOTIFICATION_RECEIVER}}
 {{CRASH_REPORTER_PROVIDER}}
 

package/dist/android/templates/CraftBridge.kt.template

@@ -444,6 +444,9 @@ class CraftBridge(
                     bluetooth: false,
                     nfc: false,
                     health: {{ENABLE_HEALTH_CONNECT}},
+                    heartRate: {{ENABLE_HEART_RATE}},
+                    heartRateRecordingOwnership: {{ENABLE_HEART_RATE}},
+                    heartRateRecordingIntentIdentity: {{ENABLE_HEART_RATE}},
                     screenCapture: false
                 },
 
@@ -1808,6 +1811,85 @@ class CraftBridge(
                     readRecording: function(options) { return recordingCall('readRecording', options); },
                     acknowledgeRecording: function(options) { return recordingCall('acknowledgeRecording', options); }
                 };
+                // A Bluetooth heart-rate strap, or a watch broadcasting its
+                // heart rate (CraftHeartRate.kt), in the iOS page's names.
+                // Readings, devices found by scan() and connection changes
+                // arrive as craftHeartRate events ({type: 'reading' | 'device'
+                // | 'state'}); startRecording() keeps every reading natively,
+                // screen locked or app closed, until stopRecording(). Calls
+                // that wait on Android's Nearby devices prompt have no deadline.
+                var heartRateSequence = 0;
+                var heartRateRequests = Object.create(null);
+                var heartRateClosed = false;
+                window.__craftHeartRateResult = function(id, value) {
+                    var pending = heartRateRequests[id];
+                    if (!pending) return;
+                    delete heartRateRequests[id];
+                    pending.resolve(value);
+                };
+                window.__craftHeartRateError = function(id, message, code) {
+                    var pending = heartRateRequests[id];
+                    if (!pending) return;
+                    delete heartRateRequests[id];
+                    var error = new Error(message);
+                    error.code = code || 'CRAFT_ERROR';
+                    error.bridge = true;
+                    pending.reject(error);
+                };
+                window.__craftRejectHeartRateRequests = function(message) {
+                    heartRateClosed = true;
+                    Object.keys(heartRateRequests).forEach(function(id) {
+                        var pending = heartRateRequests[id];
+                        delete heartRateRequests[id];
+                        pending.reject(new Error(message || 'Android bridge closed'));
+                    });
+                };
+                function heartRate(method, options) {
+                    options = options || {};
+                    if (['startRecording', 'pauseRecording', 'resumeRecording', 'stopRecording', 'readRecording', 'getRecordingState', 'acknowledgeRecording'].indexOf(method) !== -1) {
+                        if (Object.prototype.hasOwnProperty.call(options, 'recordingId') &&
+                            (typeof options.recordingId !== 'string' || !options.recordingId.trim())) {
+                            var invalidStart = new Error('recordingId must be a nonempty recording ID');
+                            invalidStart.code = 'INVALID_ARGUMENT';
+                            return Promise.reject(invalidStart);
+                        }
+                        if (Object.prototype.hasOwnProperty.call(options, 'expectedId') &&
+                            (typeof options.expectedId !== 'string' || !options.expectedId.trim())) {
+                            var invalid = new Error('expectedId must be a nonempty recording ID');
+                            invalid.code = 'INVALID_ARGUMENT';
+                            return Promise.reject(invalid);
+                        }
+                    }
+                    if (heartRateClosed) return Promise.reject(new Error('Android bridge is closed'));
+                    return new Promise(function(resolve, reject) {
+                        heartRateSequence += 1;
+                        var id = heartRateSequence;
+                        heartRateRequests[id] = {resolve: resolve, reject: reject};
+                        try {
+                            CraftAndroid.heartRate(method, JSON.stringify(options), id);
+                        } catch (error) {
+                            delete heartRateRequests[id];
+                            reject(error);
+                        }
+                    });
+                }
+                craft.heartRate = {
+                    getState: function() { return heartRate('getState'); },
+                    requestAuthorization: function() { return heartRate('requestAuthorization'); },
+                    scan: function(options) { return heartRate('scan', {timeout: options && typeof options.timeout === 'number' ? options.timeout : null}); },
+                    stopScan: function() { return heartRate('stopScan'); },
+                    getDevices: function() { return heartRate('getDevices'); },
+                    connect: function(id) { return heartRate('connect', {id: typeof id === 'string' ? id : id && id.id}); },
+                    reconnect: function() { return heartRate('reconnect'); },
+                    disconnect: function(options) { return heartRate('disconnect', {forget: !!(options && options.forget)}); },
+                    startRecording: function(options) { return heartRate('startRecording', options); },
+                    pauseRecording: function(options) { return heartRate('pauseRecording', options); },
+                    resumeRecording: function(options) { return heartRate('resumeRecording', options); },
+                    stopRecording: function(options) { return heartRate('stopRecording', options); },
+                    getRecordingState: function(options) { return heartRate('getRecordingState', options); },
+                    acknowledgeRecording: function(options) { return heartRate('acknowledgeRecording', options); },
+                    readRecording: function(options) { return heartRate('readRecording', options); }
+                };
                 var shareApi = function(text, title) { return legacyShare(text, title); };
                 shareApi.share = function(options) {
                     options = options || {};
@@ -2537,6 +2619,7 @@ class CraftBridge(
     }
 
     fun onRequestPermissionsResult(requestCode: Int): Boolean {
+        if (heartRateEnabled && CraftHeartRate.get(activity).onPermissions(requestCode)) return true
         if (closed) return requestCode in PERMISSION_REQUEST_START..PERMISSION_REQUEST_END
         // startListening asked for the microphone and is waiting on this.
         if (requestCode == REQUEST_SPEECH) {
@@ -2820,6 +2903,54 @@ class CraftBridge(
         return legacyRecordingAction("readRecording")
     }
 
+    // ==================== Heart rate (CraftHeartRate.kt) ====================
+
+    private val heartRateEnabled = {{ENABLE_HEART_RATE}}
+
+    /** The strap's events, to this page as `craftHeartRate`. */
+    private val heartRateSink: (JSONObject) -> Unit = { detail ->
+        evaluateJavascriptUnlessClosed("window.dispatchEvent(new CustomEvent('craftHeartRate', {detail: $detail}));")
+    }
+
+    init {
+        if (heartRateEnabled) CraftHeartRate.get(activity).sinks["page"] = heartRateSink
+    }
+
+    /**
+     * One `craft.heartRate` call, by method name, answered through
+     * `__craftHeartRateResult` / `__craftHeartRateError` with its id. An
+     * answer for a page that has since navigated away is dropped.
+     */
+    @JavascriptInterface
+    fun heartRate(method: String, optionsJson: String, callbackId: Int) {
+        activity.runOnUiThread {
+            if (closed) return@runOnUiThread
+            if (!heartRateEnabled) return@runOnUiThread rejectHeartRate(callbackId, navigationGeneration, "Heart rate is disabled", "CAPABILITY_DISABLED")
+            val generation = navigationGeneration
+            val options = runCatching { JSONObject(optionsJson) }.getOrNull()
+                ?: return@runOnUiThread rejectHeartRate(callbackId, generation, "Invalid heart-rate options", "INVALID_ARGUMENT")
+            CraftHeartRate.get(activity).perform(method, options, activity) { result ->
+                result.fold(
+                    onSuccess = { value ->
+                        if (generation != navigationGeneration) return@fold
+                        val json = if (value is String) JSONObject.quote(value) else value.toString()
+                        evaluateJavascriptUnlessClosed("window.__craftHeartRateResult && window.__craftHeartRateResult($callbackId, $json)")
+                    },
+                    onFailure = { error ->
+                        rejectHeartRate(callbackId, generation, error.message ?: "Heart rate failed", (error as? CraftHeartRateException)?.code ?: "CRAFT_ERROR")
+                    },
+                )
+            }
+        }
+    }
+
+    private fun rejectHeartRate(callbackId: Int, generation: Int, message: String, code: String) {
+        if (generation != navigationGeneration) return
+        evaluateJavascriptUnlessClosed(
+            "window.__craftHeartRateError && window.__craftHeartRateError($callbackId, ${jsQuote(message)}, ${jsQuote(code)})"
+        )
+    }
+
     // ==================== Clipboard ====================
 
     @JavascriptInterface
@@ -4473,13 +4604,17 @@ class CraftBridge(
                 webView.evaluateJavascript(
                     "window.__craftRejectPendingPromises && window.__craftRejectPendingPromises('Android bridge closed');" +
                         "window.__craftRejectPermissionRequests && window.__craftRejectPermissionRequests('Android bridge closed');" +
-                        "window.__craftRejectSpeechRequests && window.__craftRejectSpeechRequests('Android bridge closed')",
+                        "window.__craftRejectSpeechRequests && window.__craftRejectSpeechRequests('Android bridge closed');" +
+                        "window.__craftRejectHeartRateRequests && window.__craftRejectHeartRateRequests('Android bridge closed')",
                     null
                 )
             }
         }
         CraftNative.close(activity)
         healthConnect.close()
+        // The strap and its recording carry on (the service is the
+        // process's); only this page stops hearing them.
+        if (heartRateEnabled) CraftHeartRate.get(activity).sinks.remove("page", heartRateSink)
 
         if (shareReceiverRegistered) {
             runCatching { activity.unregisterReceiver(shareChosenReceiver) }