@flomentumsolutions/capacitor-health-extended 0.0.1

package/android/src/main/java/com/flomentum/health/capacitor/PermissionsRationaleActivity.kt

@@ -0,0 +1,86 @@
+/**
+ * ──────────────────────────────────────────────────────────────────────────────
+ *  IMPORTANT SETUP NOTICE FOR HEALTH CONNECT PERMISSIONS RATIONALE ACTIVITY
+ * ──────────────────────────────────────────────────────────────────────────────
+ *
+ * This `PermissionsRationaleActivity` class must be copied into your **end-user app**
+ * (typically at: `android/app/src/main/java/<your-app-package>/PermissionsRationaleActivity.kt`)
+ * and registered in your app's `AndroidManifest.xml`.
+ *
+ * WHY THIS IS NECESSARY:
+ * Health Connect requires this Activity to be declared in the final **merged manifest**.
+ * Android will not recognize it if it's only inside a Capacitor plugin or library module.
+ * If this class is not present in the main app project, the following issues will occur:
+ *
+ *   - `Health Connect rationale screen not found` warnings
+ *   - The Health Connect permissions dialog may silently fail to appear
+ *   - Permissions will never be granted, breaking health data access on Android
+ *
+ * ──────────────────────────────────────────────────────────────────────────────
+ * TO FIX:
+ * 1. Copy this file to your app's native Android directory.
+ * 2. Add the `<activity>` and `<activity-alias>` declarations for this class
+ *    into your AndroidManifest.xml file (in the app module). --> You can find an example manifest block in the plugin README.
+ * 3. Rebuild and re-deploy your app.
+ *
+ */
+
+// package com.[YOUR_ORGANIZATION].[YOUR_APP...]
+
+import android.os.Bundle
+import android.util.Log
+import android.webkit.WebChromeClient
+import android.webkit.WebView
+import android.webkit.WebViewClient
+import androidx.activity.addCallback
+import androidx.appcompat.app.AppCompatActivity
+
+class PermissionsRationaleActivity : AppCompatActivity() {
+    private lateinit var webView: WebView
+
+    override fun onCreate(savedInstanceState: Bundle?) {
+        super.onCreate(savedInstanceState)
+
+        supportActionBar?.apply {
+            title = "Privacy Policy"
+            setDisplayHomeAsUpEnabled(true)
+        }
+
+        webView = WebView(this).apply {
+            settings.apply {
+                javaScriptEnabled = true
+                domStorageEnabled = true
+                useWideViewPort = true
+                loadWithOverviewMode = true
+            }
+            webChromeClient = WebChromeClient()
+            webViewClient = object : WebViewClient() {
+                override fun shouldOverrideUrlLoading(view: WebView, request: android.webkit.WebResourceRequest) = false
+                override fun onReceivedError(
+                    view: WebView,
+                    request: android.webkit.WebResourceRequest,
+                    error: android.webkit.WebResourceError
+                ) {
+                    Log.e("WebView", "Failed to load: ${error.description}")
+                }
+                override fun onPageFinished(view: WebView, url: String) {
+                    Log.d("WebView", "Loaded: $url")
+                }
+            }
+            loadUrl("https://flomentumsolutions.com/privacy-policy")
+        }
+
+        setContentView(webView)
+
+        // Device back button behavior
+        onBackPressedDispatcher.addCallback(this) {
+            finish()
+        }
+    }
+
+    // Toolbar Up button behavior
+    override fun onSupportNavigateUp(): Boolean {
+        finish()
+        return true
+    }
+}

package/dist/esm/definitions.d.ts

@@ -0,0 +1,110 @@
+export interface HealthPlugin {
+    /**
+     * Checks if health API is available.
+     * Android: If false is returned, the Google Health Connect app is probably not installed.
+     * See showHealthConnectInPlayStore()
+     *
+     */
+    isHealthAvailable(): Promise<{
+        available: boolean;
+    }>;
+    /**
+     * Android only: Returns for each given permission, if it was granted by the underlying health API
+     * @param permissions permissions to query
+     */
+    checkHealthPermissions(permissions: PermissionsRequest): Promise<PermissionResponse>;
+    /**
+     * Requests the permissions from the user.
+     *
+     * Android: Apps can ask only a few times for permissions, after that the user has to grant them manually in
+     * the Health Connect app. See openHealthConnectSettings()
+     *
+     * iOS: If the permissions are already granted or denied, this method will just return without asking the user. In iOS
+     * we can't really detect if a user granted or denied a permission. The return value reflects the assumption that all
+     * permissions were granted.
+     *
+     * @param permissions permissions to request
+     */
+    requestHealthPermissions(permissions: PermissionsRequest): Promise<PermissionResponse>;
+    /**
+     * Opens the apps settings, which is kind of wrong, because health permissions are configured under:
+     * Settings > Apps > (Apple) Health > Access and Devices > [app-name]
+     * But we can't go there directly.
+     */
+    openAppleHealthSettings(): Promise<void>;
+    /**
+     * Opens the Google Health Connect app
+     */
+    openHealthConnectSettings(): Promise<void>;
+    /**
+     * Opens the Google Health Connect app in PlayStore
+     */
+    showHealthConnectInPlayStore(): Promise<void>;
+    /**
+     * Query aggregated data
+     * @param request
+     */
+    queryAggregated(request: QueryAggregatedRequest): Promise<QueryAggregatedResponse>;
+    /**
+     * Query workouts
+     * @param request
+     */
+    queryWorkouts(request: QueryWorkoutRequest): Promise<QueryWorkoutResponse>;
+}
+export declare type HealthPermission = 'READ_STEPS' | 'READ_WORKOUTS' | 'READ_ACTIVE_CALORIES' | 'READ_TOTAL_CALORIES' | 'READ_DISTANCE' | 'READ_HEART_RATE' | 'READ_ROUTE' | 'READ_MINDFULNESS';
+export interface PermissionsRequest {
+    permissions: HealthPermission[];
+}
+export interface PermissionResponse {
+    permissions: {
+        [key: string]: boolean;
+    }[];
+}
+export interface QueryWorkoutRequest {
+    startDate: string;
+    endDate: string;
+    includeHeartRate: boolean;
+    includeRoute: boolean;
+    includeSteps: boolean;
+}
+export interface HeartRateSample {
+    timestamp: string;
+    bpm: number;
+}
+export interface RouteSample {
+    timestamp: string;
+    lat: number;
+    lng: number;
+    alt?: number;
+}
+export interface QueryWorkoutResponse {
+    workouts: Workout[];
+}
+export interface Workout {
+    startDate: string;
+    endDate: string;
+    workoutType: string;
+    sourceName: string;
+    id?: string;
+    duration: number;
+    distance?: number;
+    steps?: number;
+    calories: number;
+    sourceBundleId: string;
+    route?: RouteSample[];
+    heartRate?: HeartRateSample[];
+}
+export interface QueryAggregatedRequest {
+    startDate: string;
+    endDate: string;
+    dataType: 'steps' | 'active-calories' | 'mindfulness';
+    bucket: string;
+}
+export interface QueryAggregatedResponse {
+    aggregatedData: AggregatedSample[];
+}
+export interface AggregatedSample {
+    startDate: string;
+    endDate: string;
+    value: number;
+}

package/dist/esm/definitions.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=definitions.js.map

package/dist/esm/definitions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"definitions.js","sourceRoot":"","sources":["../../src/definitions.ts"],"names":[],"mappings":"","sourcesContent":["export interface HealthPlugin {\n  /**\n   * Checks if health API is available.\n   * Android: If false is returned, the Google Health Connect app is probably not installed.\n   * See showHealthConnectInPlayStore()\n   *\n   */\n  isHealthAvailable(): Promise<{ available: boolean }>;\n\n  /**\n   * Android only: Returns for each given permission, if it was granted by the underlying health API\n   * @param permissions permissions to query\n   */\n  checkHealthPermissions(permissions: PermissionsRequest): Promise<PermissionResponse>;\n\n  /**\n   * Requests the permissions from the user.\n   *\n   * Android: Apps can ask only a few times for permissions, after that the user has to grant them manually in\n   * the Health Connect app. See openHealthConnectSettings()\n   *\n   * iOS: If the permissions are already granted or denied, this method will just return without asking the user. In iOS\n   * we can't really detect if a user granted or denied a permission. The return value reflects the assumption that all\n   * permissions were granted.\n   *\n   * @param permissions permissions to request\n   */\n  requestHealthPermissions(permissions: PermissionsRequest): Promise<PermissionResponse>;\n\n  /**\n   * Opens the apps settings, which is kind of wrong, because health permissions are configured under:\n   * Settings > Apps > (Apple) Health > Access and Devices > [app-name]\n   * But we can't go there directly.\n   */\n  openAppleHealthSettings(): Promise<void>;\n\n  /**\n   * Opens the Google Health Connect app\n   */\n  openHealthConnectSettings(): Promise<void>;\n\n  /**\n   * Opens the Google Health Connect app in PlayStore\n   */\n  showHealthConnectInPlayStore(): Promise<void>;\n\n  /**\n   * Query aggregated data\n   * @param request\n   */\n  queryAggregated(request: QueryAggregatedRequest): Promise<QueryAggregatedResponse>;\n\n  /**\n   * Query workouts\n   * @param request\n   */\n  queryWorkouts(request: QueryWorkoutRequest): Promise<QueryWorkoutResponse>;\n}\n\nexport declare type HealthPermission =\n  | 'READ_STEPS'\n  | 'READ_WORKOUTS'\n  | 'READ_ACTIVE_CALORIES'\n  | 'READ_TOTAL_CALORIES'\n  | 'READ_DISTANCE'\n  | 'READ_HEART_RATE'\n  | 'READ_ROUTE'\n  | 'READ_MINDFULNESS';\n\nexport interface PermissionsRequest {\n  permissions: HealthPermission[];\n}\n\nexport interface PermissionResponse {\n  permissions: { [key: string]: boolean }[];\n}\n\nexport interface QueryWorkoutRequest {\n  startDate: string;\n  endDate: string;\n  includeHeartRate: boolean;\n  includeRoute: boolean;\n  includeSteps: boolean;\n}\n\nexport interface HeartRateSample {\n  timestamp: string;\n  bpm: number;\n}\n\nexport interface RouteSample {\n  timestamp: string;\n  lat: number;\n  lng: number;\n  alt?: number;\n}\n\nexport interface QueryWorkoutResponse {\n  workouts: Workout[];\n}\n\nexport interface Workout {\n  startDate: string;\n  endDate: string;\n  workoutType: string;\n  sourceName: string;\n  id?: string;\n  duration: number;\n  distance?: number;\n  steps?: number;\n  calories: number;\n  sourceBundleId: string;\n  route?: RouteSample[];\n  heartRate?: HeartRateSample[];\n}\n\nexport interface QueryAggregatedRequest {\n  startDate: string;\n  endDate: string;\n  dataType: 'steps' | 'active-calories' | 'mindfulness';\n  bucket: string;\n}\n\nexport interface QueryAggregatedResponse {\n  aggregatedData: AggregatedSample[];\n}\n\nexport interface AggregatedSample {\n  startDate: string;\n  endDate: string;\n  value: number;\n}\n"]}

package/dist/esm/index.d.ts

@@ -0,0 +1,3 @@
+import type { HealthPlugin } from './definitions';
+export declare const Health: HealthPlugin;
+export * from './definitions';

package/dist/esm/index.js

@@ -0,0 +1,4 @@
+import { registerPlugin } from '@capacitor/core';
+export const Health = registerPlugin('HealthPlugin', {});
+export * from './definitions';
+//# sourceMappingURL=index.js.map

package/dist/esm/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAIjD,MAAM,CAAC,MAAM,MAAM,GAAG,cAAc,CAAe,cAAc,EAAE,EAAE,CAAC,CAAC;AAEvE,cAAc,eAAe,CAAA","sourcesContent":["import { registerPlugin } from '@capacitor/core';\n\nimport type { HealthPlugin } from './definitions';\n\nexport const Health = registerPlugin<HealthPlugin>('HealthPlugin', {});\n\nexport * from './definitions'\n"]}

package/dist/plugin.cjs.js

@@ -0,0 +1,10 @@
+'use strict';
+
+Object.defineProperty(exports, '__esModule', { value: true });
+
+var core = require('@capacitor/core');
+
+const Health = core.registerPlugin('HealthPlugin', {});
+
+exports.Health = Health;
+//# sourceMappingURL=plugin.cjs.js.map

package/dist/plugin.cjs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.cjs.js","sources":["esm/index.js"],"sourcesContent":["import { registerPlugin } from '@capacitor/core';\nexport const Health = registerPlugin('HealthPlugin', {});\nexport * from './definitions';\n//# sourceMappingURL=index.js.map"],"names":["registerPlugin"],"mappings":";;;;;;AACY,MAAC,MAAM,GAAGA,mBAAc,CAAC,cAAc,EAAE,EAAE;;;;"}

package/dist/plugin.js

@@ -0,0 +1,13 @@
+var capacitorHealthPlugin = (function (exports, core) {
+	'use strict';
+
+	const Health = core.registerPlugin('HealthPlugin', {});
+
+	exports.Health = Health;
+
+	Object.defineProperty(exports, '__esModule', { value: true });
+
+	return exports;
+
+})({}, capacitorExports);
+//# sourceMappingURL=plugin.js.map

package/dist/plugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.js","sources":["esm/index.js"],"sourcesContent":["import { registerPlugin } from '@capacitor/core';\nexport const Health = registerPlugin('HealthPlugin', {});\nexport * from './definitions';\n//# sourceMappingURL=index.js.map"],"names":["registerPlugin"],"mappings":";;;AACY,OAAC,MAAM,GAAGA,mBAAc,CAAC,cAAc,EAAE,EAAE;;;;;;;;;;;;"}