@cariva-dev/exercise-sdk 2.0.0

package/package.json

@@ -0,0 +1,127 @@
+{
+  "name": "@cariva-dev/exercise-sdk",
+  "version": "2.0.0",
+  "description": "Cariva exercise SDK",
+  "main": "./lib/module/index.js",
+  "types": "./lib/typescript/src/index.d.ts",
+  "exports": {
+    ".": {
+      "source": "./src/index.tsx",
+      "types": "./lib/typescript/src/index.d.ts",
+      "default": "./lib/module/index.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "src",
+    "lib",
+    "android",
+    "ios",
+    "cpp",
+    "*.podspec",
+    "react-native.config.js",
+    "!ios/build",
+    "!android/build",
+    "!android/gradle",
+    "!android/gradlew",
+    "!android/gradlew.bat",
+    "!android/local.properties",
+    "!**/__tests__",
+    "!**/__fixtures__",
+    "!**/__mocks__",
+    "!**/.*"
+  ],
+  "scripts": {
+    "example": "yarn workspace cariva-exercise-sdk-example",
+    "clean": "del-cli android/build example/android/build example/android/app/build example/ios/build lib",
+    "prepare": "bob build",
+    "typecheck": "tsc",
+    "lint": "eslint \"**/*.{js,ts,tsx}\""
+  },
+  "keywords": [
+    "react-native",
+    "ios",
+    "android"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/cariva/cariva-exercise-sdk.git"
+  },
+  "author": "Cariva <dev@cariva.com> (https://cariva.com)",
+  "license": "MIT",
+  "bugs": {
+    "url": "https://github.com/cariva/cariva-exercise-sdk/issues"
+  },
+  "homepage": "https://github.com/cariva/cariva-exercise-sdk#readme",
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org/",
+    "access": "public"
+  },
+  "devDependencies": {
+    "@eslint/compat": "^1.3.2",
+    "@eslint/eslintrc": "^3.3.1",
+    "@eslint/js": "^9.35.0",
+    "@react-native/babel-preset": "0.83.0",
+    "@react-native/eslint-config": "0.83.0",
+    "@types/react": "^19.2.0",
+    "del-cli": "^6.0.0",
+    "eslint": "^9.35.0",
+    "eslint-config-prettier": "^10.1.8",
+    "eslint-plugin-prettier": "^5.5.4",
+    "prettier": "^2.8.8",
+    "react": "19.2.0",
+    "react-native": "0.83.0",
+    "react-native-builder-bob": "^0.40.18",
+    "turbo": "^2.5.6",
+    "typescript": "^5.9.2"
+  },
+  "peerDependencies": {
+    "react": "*",
+    "react-native": "*"
+  },
+  "workspaces": [
+    "example"
+  ],
+  "packageManager": "yarn@4.11.0",
+  "react-native-builder-bob": {
+    "source": "src",
+    "output": "lib",
+    "targets": [
+      [
+        "module",
+        {
+          "esm": true
+        }
+      ],
+      [
+        "typescript",
+        {
+          "project": "tsconfig.build.json"
+        }
+      ]
+    ]
+  },
+  "codegenConfig": {
+    "name": "CarivaExerciseSdkSpec",
+    "type": "modules",
+    "jsSrcsDir": "src",
+    "android": {
+      "javaPackageName": "com.carivaexercisesdk"
+    }
+  },
+  "prettier": {
+    "quoteProps": "consistent",
+    "singleQuote": true,
+    "tabWidth": 2,
+    "trailingComma": "es5",
+    "useTabs": false
+  },
+  "create-react-native-library": {
+    "type": "turbo-module",
+    "languages": "kotlin-objc",
+    "tools": [
+      "eslint"
+    ],
+    "version": "0.57.2"
+  }
+}

package/src/connect/index.ts

@@ -0,0 +1,34 @@
+import { getHealthConnectModule } from '../native/module';
+
+export type PermissionScope =
+  | 'steps'
+  | 'activetimes'
+  | 'calories'
+  | 'distances';
+
+export type ConnectOptions = {
+  onMissingApp?: 'status' | 'open';
+  requestPermission?: boolean;
+  permissionScope?: PermissionScope[];
+};
+
+export type ConnectResult = {
+  ready: boolean;
+  healthConnectInstalled: boolean;
+  healthConnectStatus:
+    | 'AVAILABLE'
+    | 'PROVIDER_UPDATE_REQUIRED'
+    | 'UNAVAILABLE'
+    | 'UNKNOWN';
+  hasPermissions: boolean;
+  nextAction:
+    | 'INSTALL_HEALTH_CONNECT'
+    | 'UPDATE_HEALTH_CONNECT'
+    | 'REQUEST_PERMISSION'
+    | 'NONE';
+  requestedPermissions?: string[];
+};
+
+export function connect(options: ConnectOptions = {}): Promise<ConnectResult> {
+  return getHealthConnectModule().connect(JSON.stringify(options));
+}

package/src/datasource/index.ts

@@ -0,0 +1,20 @@
+import { getHealthConnectModule } from '../native/module';
+
+export type DatasourceType = 'manual_input' | 'device' | 'app' | 'unknown';
+
+export type DatasourceConfig = {
+  allowlist: DatasourceType[];
+  scope?: {
+    packages?: string[];
+  };
+};
+
+export function setAllowDatasource(
+  config: DatasourceConfig
+): Promise<{ success: boolean }> {
+  return getHealthConnectModule().setAllowDatasource(JSON.stringify(config));
+}
+
+export function getAllowDatasource(): Promise<DatasourceConfig> {
+  return getHealthConnectModule().getAllowDatasource();
+}

package/src/exercise/index.ts

@@ -0,0 +1,75 @@
+import { getHealthConnectModule } from '../native/module';
+
+export type TrustLevel = 'trusted' | 'low_confidence';
+
+export type UnifiedRecordMeta = {
+  source: string;
+  device: string;
+  deviceModel: string;
+  trustLevel: TrustLevel;
+};
+
+export type UnifiedIntervalRecord = {
+  steps: number;
+  activeCalories: number;
+  activeCaloriesUnit: 'kcal';
+  distance: number;
+  distanceUnit: 'km';
+  activeTime: number;
+  activeTimeUnit: 'milliseconds';
+  startDate: string;
+  endDate: string;
+  meta: UnifiedRecordMeta;
+};
+
+export type ExerciseData = {
+  totalKcal: number;
+  totalSteps: number;
+  totalActiveTimeMillis: number;
+  // Deprecated backward-compatible alias. Prefer totalActiveTimeMillis.
+  totalActiveTime?: number;
+  totalDistanceMeters: number;
+  timeZone: string;
+  records: UnifiedIntervalRecord[];
+  warnings?: string[];
+  integrity?: {
+    projectionPreserved: boolean;
+    roundingScale: number;
+  };
+  diagnostics?: {
+    fallbackUsedSegments: number;
+    fallbackSuppressedSegments: number;
+    idleGateSuppressedSegments: number;
+    basalSeedApplied: boolean;
+    seededFromBeforeSince: boolean;
+    basalSeedAgeHours?: number;
+  };
+  debug?: {
+    directActiveCaloriesKcal: number;
+    totalCaloriesKcal: number;
+    basalCaloriesKcal: number;
+    mergedActiveCaloriesKcal: number;
+    fallbackContributionKcal: number;
+    fallbackUsedSegments: number;
+    fallbackSuppressedSegments: number;
+    idleGateSuppressedSegments: number;
+    basalSeedApplied: boolean;
+    seededFromBeforeSince: boolean;
+    basalSeedAgeHours?: number;
+    basalIntervalsCount: number;
+  };
+};
+
+export type GetExerciseDataOptions = {
+  sinceMillis: number;
+  untilMillis: number;
+  type?: 'steps' | 'activetimes' | 'calories' | 'distances' | 'all';
+  bucketPeriod?: 'daily' | 'hourly';
+  debug?: boolean;
+};
+
+export function getExerciseData(
+  options: GetExerciseDataOptions
+): Promise<ExerciseData> {
+  return getHealthConnectModule().getExerciseData(JSON.stringify(options));
+}

package/src/index.tsx

@@ -0,0 +1,22 @@
+export {
+  connect,
+  type ConnectOptions,
+  type ConnectResult,
+  type PermissionScope,
+} from './connect';
+
+export {
+  getExerciseData,
+  type ExerciseData,
+  type GetExerciseDataOptions,
+  type TrustLevel,
+  type UnifiedIntervalRecord,
+  type UnifiedRecordMeta,
+} from './exercise';
+
+export {
+  getAllowDatasource,
+  setAllowDatasource,
+  type DatasourceConfig,
+  type DatasourceType,
+} from './datasource';

package/src/native/module.ts

@@ -0,0 +1,23 @@
+import { NativeModules } from 'react-native';
+
+import type { ConnectResult } from '../connect';
+import type { DatasourceConfig } from '../datasource';
+import type { ExerciseData } from '../exercise';
+
+type HealthConnectModuleSpec = {
+  connect(optionsJson: string): Promise<ConnectResult>;
+  getExerciseData(optionsJson: string): Promise<ExerciseData>;
+  setAllowDatasource(configJson: string): Promise<{ success: boolean }>;
+  getAllowDatasource(): Promise<DatasourceConfig>;
+};
+
+const { HealthConnectModule } = NativeModules as {
+  HealthConnectModule?: HealthConnectModuleSpec;
+};
+
+export function getHealthConnectModule(): HealthConnectModuleSpec {
+  if (!HealthConnectModule) {
+    throw new Error('HealthConnectModule is not linked or unavailable.');
+  }
+  return HealthConnectModule;
+}