@kingstinct/react-native-healthkit 9.0.0 → 9.0.2

package/package.json

@@ -1,16 +1,28 @@
 {
   "name": "@kingstinct/react-native-healthkit",
-  "version": "9.0.0",
+  "version": "9.0.2",
   "description": "React Native bindings for HealthKit",
-  "main": "lib/index",
-  "module": "lib/index",
-  "types": "lib/index.d.ts",
-  "react-native": "src/index",
-  "source": "src/index",
+  "type": "module",
+  "main": "lib/commonjs/index.js",
+  "module": "lib/module/index.js",
+  "types": "lib/typescript/index.d.ts",
+  "react-native": "src/index.ts",
+  "source": "src/index.ts",
+  "exports": {
+    ".": {
+      "types": "./lib/typescript/index.d.ts",
+      "import": "./lib/module/index.js",
+      "require": "./lib/commonjs/index.js",
+      "react-native": "./src/index.ts"
+    },
+    "./package.json": "./package.json"
+  },
   "files": [
     "src",
     "react-native.config.js",
-    "lib",
+    "lib/commonjs",
+    "lib/module",
+    "lib/typescript",
     "nitrogen/**/*",
     "android/build.gradle",
     "android/gradle.properties",
@@ -26,13 +38,24 @@
     "README.md"
   ],
   "scripts": {
-    "typecheck": "tsc --noEmit",
+    "clean": "rm -rf lib",
+    "build:cjs": "tsc -p tsconfig.cjs.json",
+    "build:esm": "tsc -p tsconfig.esm.json",
+    "build:types": "tsc -p tsconfig.declarations.json",
+    "build": "bun run clean && bun run build:cjs && bun run build:esm && bun run build:types",
+    "typecheck": "tsc --noEmit -p tsconfig.json",
     "lint": "bunx @biomejs/biome format --write",
-    "typescript": "tsc",
-    "codegen": "tsc && nitro-codegen --logLevel=\"debug\"",
-    "test": "bun test"
+    "codegen": "bun run build && nitro-codegen --logLevel=\"debug\"",
+    "test": "bun test",
+    "prepublishOnly": "bun run build && bun run codegen"
   },
-  "keywords": ["react-native", "nitro", "healthkit", "ios", "typescript"],
+  "keywords": [
+    "react-native",
+    "nitro",
+    "healthkit",
+    "ios",
+    "typescript"
+  ],
   "funding": {
     "type": "github",
     "url": "https://github.com/sponsors/kingstinct"

package/src/hooks/useCategorySampleById.ts

@@ -0,0 +1,41 @@
+import { useCallback, useState } from 'react'
+
+import type { CategorySampleTyped } from '../types/CategoryType'
+import type { CategoryTypeIdentifier } from '../types/CategoryTypeIdentifier'
+import getCategorySampleById from '../utils/getCategorySampleById'
+import useSubscribeToChanges from './useSubscribeToChanges'
+
+/**
+ * @returns the most recent sample for the given category type.
+ */
+export function useCategorySampleById<T extends CategoryTypeIdentifier>(
+  identifier: T,
+  uuid: string,
+) {
+  const [sample, setSample] = useState<CategorySampleTyped<T>>()
+  const [isLoading, setIsLoading] = useState(true)
+  const [error, setError] = useState<Error | null>(null)
+
+  const updater = useCallback(async () => {
+    setIsLoading(true)
+    setError(null)
+    try {
+      const fetchedSample = await getCategorySampleById(identifier, uuid)
+      setSample(fetchedSample)
+    } catch (err) {
+      setError(
+        err instanceof Error
+          ? err
+          : new Error('Unknown error fetching category sample by ID'),
+      )
+    } finally {
+      setIsLoading(false)
+    }
+  }, [identifier, uuid])
+
+  useSubscribeToChanges(identifier, updater)
+
+  return { sample, isLoading, error }
+}
+
+export default useCategorySampleById

package/src/hooks/useQuantitySampleById.ts

@@ -0,0 +1,44 @@
+import { useCallback, useState } from 'react'
+import type { QuantitySample } from '../types/QuantitySample'
+import type { QuantityTypeIdentifier } from '../types/QuantityTypeIdentifier'
+import getQuantitySampleById from '../utils/getQuantitySampleById'
+import useSubscribeToChanges from './useSubscribeToChanges'
+
+/**
+ * @returns the most recent sample for the given quantity type.
+ */
+export function useQuantitySampleById(
+  identifier: QuantityTypeIdentifier,
+  uuid: string,
+  options: {
+    /** The unit to use for the sample. */
+    unit?: string
+  } = {},
+) {
+  const [sample, setSample] = useState<QuantitySample>()
+  const [isLoading, setIsLoading] = useState(true)
+  const [error, setError] = useState<Error | null>(null)
+
+  const fetchMostRecentSample = useCallback(async () => {
+    setIsLoading(true)
+    try {
+      const sample = await getQuantitySampleById(
+        identifier,
+        uuid,
+        options?.unit,
+      )
+      setSample(sample)
+      setError(null)
+    } catch (err) {
+      setError(err instanceof Error ? err : new Error('Unknown error'))
+    } finally {
+      setIsLoading(false)
+    }
+  }, [identifier, uuid, options.unit])
+
+  useSubscribeToChanges(identifier, fetchMostRecentSample)
+
+  return { sample, isLoading, error }
+}
+
+export default useQuantitySampleById

package/src/hooks/useWorkoutById.ts

@@ -0,0 +1,55 @@
+import { useCallback, useEffect, useRef, useState } from 'react'
+import type { WorkoutProxy } from '../specs/WorkoutProxy.nitro'
+import getWorkoutById from '../utils/getWorkoutById'
+import useSubscribeToChanges from './useSubscribeToChanges'
+
+/**
+ * @returns the most recent workout sample.
+ */
+export function useWorkoutById(
+  uuid: string,
+  options?: {
+    readonly energyUnit?: string
+    readonly distanceUnit?: string
+  },
+) {
+  const [workout, setWorkout] = useState<WorkoutProxy>()
+  const [isLoading, setIsLoading] = useState(true)
+  const [error, setError] = useState<Error | null>(null)
+
+  const optionsRef = useRef(options)
+
+  useEffect(() => {
+    optionsRef.current = options
+  }, [options])
+
+  const update = useCallback(async () => {
+    setIsLoading(true)
+    setError(null)
+    try {
+      const fetchedWorkout = await getWorkoutById(uuid, {
+        energyUnit: optionsRef.current?.energyUnit,
+        distanceUnit: optionsRef.current?.distanceUnit,
+      })
+      setWorkout(fetchedWorkout)
+    } catch (err) {
+      setError(
+        err instanceof Error
+          ? err
+          : new Error('Unknown error fetching workout by ID'),
+      )
+    } finally {
+      setIsLoading(false)
+    }
+  }, [uuid])
+
+  useEffect(() => {
+    void update()
+  }, [update])
+
+  useSubscribeToChanges('HKWorkoutTypeIdentifier', update)
+
+  return { workout, isLoading, error }
+}
+
+export default useWorkoutById

package/src/index.ios.ts

@@ -211,15 +211,7 @@ export default {
   isProtectedDataAvailable,
   queryStateOfMindSamples,
   saveStateOfMindSample,
-  // Modules
-  // Core,
-  // Workouts,
-  // Characteristics,
-  // QuantityTypes,
-  // CategoryTypes,
-  // CorrelationTypes,
-  // HeartbeatSeries,
-  // StateOfMind,
+
   // hooks
   useMostRecentCategorySample,
   useMostRecentQuantitySample,

package/src/index.ts

@@ -32,26 +32,12 @@ import type {
   QueryStatisticsResponse,
 } from './types/QuantityType'
 import type { StateOfMindSample } from './types/StateOfMind'
-import type { IdentifierWithUnit } from './types/Units'
 import type { QueryWorkoutSamplesWithAnchorResponse } from './types/Workouts'
 
 const notAvailableError = `[@kingstinct/react-native-healthkit] Platform "${Platform.OS}" not supported. HealthKit is only available on iOS.`
 
 let hasWarned = false
 
-// @ts-ignore
-// biome-ignore lint/complexity/noBannedTypes: <explanation>
-function UnavailableFnNew<T extends Function>(defaultValue: ReturnType<T>): T {
-  // @ts-ignore
-  return () => {
-    if (Platform.OS !== 'ios' && !hasWarned) {
-      console.warn(notAvailableError)
-      hasWarned = true
-    }
-    return defaultValue
-  }
-}
-
 // @ts-ignore
 function UnavailableFnFromModule<
   TKey extends keyof typeof ReactNativeHealthkit,
@@ -294,11 +280,13 @@ export function getMostRecentCategorySample<T extends CategoryTypeIdentifier>(
 
 export const getMostRecentQuantitySample = UnavailableFnFromModule(
   'getMostRecentQuantitySample',
-  Promise.resolve(undefined),
+  // biome-ignore lint/suspicious/noExplicitAny: <explanation>
+  Promise.resolve(undefined as any as QuantitySample),
 )
 export const getMostRecentWorkout = UnavailableFnFromModule(
   'getMostRecentWorkout',
-  Promise.resolve(undefined),
+  // biome-ignore lint/suspicious/noExplicitAny: <explanation>
+  Promise.resolve(undefined as any as WorkoutProxy),
 )
 export const getPreferredUnit = UnavailableFnFromModule(
   'getPreferredUnit',

package/src/utils/getCategorySampleById.ts

@@ -0,0 +1,16 @@
+import { CategoryTypes } from '../modules'
+import type { CategoryTypeIdentifier } from '../types/CategoryTypeIdentifier'
+
+export async function getCategorySampleById<T extends CategoryTypeIdentifier>(
+  identifier: T,
+  uuid: string,
+) {
+  const samples = await CategoryTypes.queryCategorySamples(identifier, {
+    limit: 1,
+    filter: { uuid: uuid },
+  })
+
+  return samples[0]
+}
+
+export default getCategorySampleById

package/src/utils/getQuantitySampleById.ts

@@ -0,0 +1,20 @@
+import { QuantityTypes } from '../modules'
+import type { QuantityTypeIdentifier } from '../types/QuantityTypeIdentifier'
+
+async function getQuantitySampleById(
+  identifier: QuantityTypeIdentifier,
+  uuid: string,
+  unit?: string,
+) {
+  const samples = await QuantityTypes.queryQuantitySamples(identifier, {
+    limit: 1,
+    unit,
+    filter: {
+      uuid: uuid,
+    },
+  })
+
+  return samples[0]
+}
+
+export default getQuantitySampleById

package/src/utils/getWorkoutById.ts

@@ -0,0 +1,20 @@
+import { Workouts } from '../modules'
+import type { WorkoutQueryOptions } from '../types/Workouts'
+
+const getWorkoutById = async (
+  uuid: string,
+  options: Pick<WorkoutQueryOptions, 'distanceUnit' | 'energyUnit'>,
+) => {
+  const workouts = await Workouts.queryWorkoutSamples({
+    limit: 1,
+    filter: {
+      uuid: uuid,
+    },
+    energyUnit: options?.energyUnit,
+    distanceUnit: options?.distanceUnit,
+  })
+
+  return workouts[0]
+}
+
+export default getWorkoutById