@appeeky/expo-healthkit 0.1.0 → 0.1.1

package/.releaserc.json

@@ -0,0 +1,22 @@
+{
+  "branches": ["main"],
+  "plugins": [
+    "@semantic-release/commit-analyzer",
+    "@semantic-release/release-notes-generator",
+    [
+      "@semantic-release/changelog",
+      {
+        "changelogFile": "CHANGELOG.md"
+      }
+    ],
+    "@semantic-release/npm",
+    "@semantic-release/github",
+    [
+      "@semantic-release/git",
+      {
+        "assets": ["CHANGELOG.md", "package.json", "package-lock.json"],
+        "message": "chore(release): ${nextRelease.version} [skip ci]\n\n${nextRelease.notes}"
+      }
+    ]
+  ]
+}

package/CHANGELOG.md

@@ -1,3 +1,10 @@
+## [0.1.1](https://github.com/appeeky/expo-healthkit/compare/v0.1.0...v0.1.1) (2026-09-05)
+
+
+### Bug Fixes
+
+* use local datetime for Health Connect daily statistics ([d01e776](https://github.com/appeeky/expo-healthkit/commit/d01e776398fb7f45b2b4c0401593a871f03bb700))
+
 # Changelog
 
 ## 0.1.0
@@ -22,5 +29,5 @@
 - Published as [`@appeeky/expo-healthkit`](https://www.npmjs.com/package/@appeeky/expo-healthkit)
 - npm-ready `exports`, `.npmignore`, and `prepublishOnly` build
 - App Store privacy manifest (`PrivacyInfo.xcprivacy`)
-- GitHub Actions for lint, typecheck, tests with coverage thresholds, and pack contents
+- GitHub Actions for lint, typecheck, tests with coverage thresholds, pack contents, and automated semver releases to npm
 - [PolyForm Shield 1.0.0](./LICENSE) (source-available; apps may use the SDK, competing SDKs may not)

package/README.md

@@ -1,4 +1,5 @@
-![HealthKit and Health Connect for Expo](https://raw.githubusercontent.com/appeeky/expo-healthkit/main/docs/banner.jpg)
+<img width="1024" height="725" alt="image" src="https://github.com/user-attachments/assets/fadcd831-4187-42b1-b03b-3228ab2d8f32" />
+
 
 # @appeeky/expo-healthkit
 
@@ -395,6 +396,21 @@ Copy [`.cursor/skills/expo-healthkit/`](https://github.com/appeeky/expo-healthki
 
 The skill tells the agent to pass Apple identifier strings through one query/save API on iOS and Android, request every type in `toRead`, and rebuild native code after Swift, Kotlin, or plugin changes.
 
+## 🚀 Releases
+
+Versions follow [semver](https://semver.org/). Pushing to `main` with a [Conventional Commit](https://www.conventionalcommits.org/) runs `.github/workflows/release.yml`: bump `package.json`, update `CHANGELOG.md`, GitHub Release, and `npm publish`.
+
+| Commit | npm bump |
+| --- | --- |
+| `fix: …` | patch (`0.1.0` → `0.1.1`) |
+| `feat: …` | minor (`0.1.0` → `0.2.0`) |
+| `feat!: …` or `BREAKING CHANGE:` in the body | major (`0.1.0` → `1.0.0`) |
+| `docs:`, `chore:`, `ci:`, `test:` | no release |
+
+Squash-merge PRs so the merge commit (or PR title) starts with `fix:` / `feat:`. `chore:` and `ci:` do not publish.
+
+npm publishes from GitHub Actions via [trusted publishing](https://docs.npmjs.com/trusted-publishers) (no `NPM_TOKEN`). One-time setup: package Settings → Trusted Publisher → GitHub Actions, repository `appeeky/expo-healthkit`, workflow filename `release.yml`, and allow **`npm publish`** (not only staged publish).
+
 ## 🤝 Contributing
 
 Issues and pull requests are welcome. Contributions are licensed under [PolyForm Shield 1.0.0](./LICENSE).
@@ -438,7 +454,7 @@ npx expo run:android
 
 ### Docs
 
-If the public API or Android mapping changes, update `README.md`, `CHANGELOG.md`, and `.cursor/skills/expo-healthkit/` (`SKILL.md`, `reference.md`, `examples.md`) in the same PR.
+If the public API or Android mapping changes, update `README.md` and `.cursor/skills/expo-healthkit/` (`SKILL.md`, `reference.md`, `examples.md`) in the same PR. `CHANGELOG.md` is generated on release from conventional commits.
 
 ## 🔒 Privacy
 
@@ -450,4 +466,4 @@ Health data stays on-device unless your app uploads it. Request only the types y
 
 You **can** install and use this SDK inside your own Expo / React Native apps, including commercial products.
 
-You **cannot** copy this SDK and sell, publish, or otherwise offer a competing HealthKit / Health Connect library based on it.
+You **cannot** copy this SDK and sell, publish, or otherwise offer a competing HealthKit / Health Connect library based on it.

package/android/src/main/java/expo/modules/healthkit/HealthConnectService.kt

@@ -47,6 +47,7 @@ import androidx.health.connect.client.units.Temperature
 import androidx.health.connect.client.units.Volume
 import java.time.Duration
 import java.time.Instant
+import java.time.LocalDateTime
 import java.time.Period
 import java.time.ZoneId
 import java.time.ZoneOffset
@@ -126,7 +127,7 @@ internal class HealthConnectService(
         val samples = sessions.flatMap { session -> sleepSamples(session) }
         applyLimit(if (ascending) samples else samples.reversed(), limit)
       }
-      else -> throw InvalidIdentifierException(type)
+      else -> throw HealthConnectUnsupportedException(type)
     }
   }
 
@@ -205,7 +206,7 @@ internal class HealthConnectService(
           correlation(record.metadata, type, record.startTime, record.endTime, objects)
         }
       }
-      else -> throw InvalidIdentifierException(type)
+      else -> unmappedType(type)
     }
   }
 
@@ -255,7 +256,7 @@ internal class HealthConnectService(
         else -> Period.ofDays(1)
       }
       client().aggregateGroupByPeriod(
-        AggregateGroupByPeriodRequest(metrics, filter, period)
+        AggregateGroupByPeriodRequest(metrics, localTimeFilter(options), period)
       ).map { result ->
         val start = result.startTime.atZone(ZoneId.systemDefault()).toInstant()
         val end = result.endTime.atZone(ZoneId.systemDefault()).toInstant()
@@ -268,7 +269,7 @@ internal class HealthConnectService(
     assertAvailable()
     val type = requiredString(options, "type")
     val unit = options["unit"] as? String ?: ""
-    val recordClass = HealthConnectMapping.recordClass(type) ?: throw InvalidIdentifierException(type)
+    val recordClass = HealthConnectMapping.recordClass(type) ?: unmappedType(type)
     val anchor = options["anchor"] as? String
     val client = client()
     if (anchor.isNullOrBlank()) {
@@ -433,7 +434,7 @@ internal class HealthConnectService(
         val range = ensureRange(start, end)
         HealthConnectNutrition.build(range.first, range.second, zoneOffset(range.first), zoneOffset(range.second), metadata(), values)
       }
-      else -> throw InvalidIdentifierException(type)
+      else -> unmappedType(type)
     }
     return client().insertRecords(listOf(record)).recordIdsList.first()
   }
@@ -441,7 +442,7 @@ internal class HealthConnectService(
   suspend fun deleteObjects(options: Map<String, Any?>): Int {
     assertAvailable()
     val type = options["type"] as? String ?: throw MissingDeleteTypeException()
-    val recordClass = HealthConnectMapping.recordClass(type) ?: throw InvalidIdentifierException(type)
+    val recordClass = HealthConnectMapping.recordClass(type) ?: unmappedType(type)
     val uuid = options["uuid"] as? String
     val client = client()
     if (!uuid.isNullOrBlank()) {
@@ -485,7 +486,7 @@ internal class HealthConnectService(
       }
       HealthConnectMapping.BASAL_ENERGY -> emptyList()
       else -> {
-        val recordClass = HealthConnectMapping.recordClass(type) ?: throw InvalidIdentifierException(type)
+        val recordClass = HealthConnectMapping.recordClass(type) ?: unmappedType(type)
         readAll(recordClass, filter, ascending, 0).flatMap { record ->
           quantitySamplesFromRecord(type, unit, record)
         }
@@ -1002,6 +1003,19 @@ internal class HealthConnectService(
     }
   }
 
+  private fun localTimeFilter(options: Map<String, Any?>): TimeRangeFilter {
+    val zone = ZoneId.systemDefault()
+    val from = (options["from"] as? String)?.let { parseInstant(it).atZone(zone).toLocalDateTime() }
+    val to = (options["to"] as? String)?.let { parseInstant(it).atZone(zone).toLocalDateTime() }
+    return when {
+      from != null && to != null ->
+        TimeRangeFilter.between(from, if (to.isAfter(from)) to else from.plusSeconds(1))
+      from != null -> TimeRangeFilter.after(from)
+      to != null -> TimeRangeFilter.before(to)
+      else -> TimeRangeFilter.after(LocalDateTime.ofInstant(Instant.EPOCH, zone))
+    }
+  }
+
   private fun filterStart(options: Map<String, Any?>): Instant =
     (options["from"] as? String)?.let { parseInstant(it) } ?: Instant.EPOCH
 
@@ -1026,6 +1040,13 @@ internal class HealthConnectService(
     return start to end
   }
 
+  private fun unmappedType(type: String): Nothing {
+    if (type.startsWith("HK")) {
+      throw HealthConnectUnsupportedException(type)
+    }
+    throw InvalidIdentifierException(type)
+  }
+
   private fun requiredString(options: Map<String, Any?>, key: String): String =
     options[key] as? String ?: throw InvalidIdentifierException(key)
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@appeeky/expo-healthkit",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "Apple HealthKit and Android Health Connect for Expo. One identifier-based JavaScript API on iOS and Android.",
   "main": "build/index.js",
   "types": "build/index.d.ts",
@@ -23,6 +23,7 @@
     "test:coverage": "node internal/module_scripts/test.js --coverage --watchAll=false",
     "prepare": "node internal/module_scripts/prepare.js",
     "prepublishOnly": "node internal/module_scripts/prepare.js",
+    "release": "semantic-release",
     "open:ios": "node internal/module_scripts/open-ios.js",
     "open:android": "node internal/module_scripts/open-android.js"
   },
@@ -55,6 +56,8 @@
   },
   "devDependencies": {
     "@babel/core": "^7.26.0",
+    "@semantic-release/changelog": "^7.0.0",
+    "@semantic-release/git": "^11.0.1",
     "@types/jest": "^29.2.1",
     "@types/react": "~19.1.1",
     "babel-preset-expo": "~57.0.10",
@@ -64,6 +67,7 @@
     "jest": "^29.7.0",
     "prettier": "^3.0.0",
     "react-native": "0.82.1",
+    "semantic-release": "^25.0.9",
     "typescript": "^5.9.2"
   },
   "jest": {