react-native-workouts 0.2.1 → 0.2.3

package/README.md

@@ -1,42 +1,25 @@
+![react-native-workouts-banner](./public/react-native-workouts-banner.png)
+
 # react-native-workouts
 
-React Native Expo module for Apple WorkoutKit - create, preview, and sync custom
+🏋️‍♀️ React Native Expo module for Apple WorkoutKit — create, preview, and sync
 workouts to Apple Watch.
 
 ## Features
 
-- Create custom interval workouts with warmup, work/recovery intervals, and
-  cooldown
-- Create single-goal workouts (distance, time, or energy based)
-- Create pacer workouts with speed or pace targets
-- Schedule workouts to sync with Apple Watch Workout app
-- Full TypeScript support with comprehensive type definitions
-- Supports all major workout activity types
-
-## API Features
-
-### Workout Creation
-
-- **Custom Workouts** - Complex interval workouts with warmup, blocks
-  (iterations, work/recovery steps), cooldown, and alerts
-- **Single Goal Workouts** - Simple distance, time, or energy-based workouts
-- **Pacer Workouts** - Speed or pace target workouts
-- **Preview Workouts** - Present Apple’s system workout preview modal (includes
-  add/send to Apple Watch)
-
-### Scheduling
-
-- **scheduleWorkout()** - Schedule custom workouts to Apple Watch
-- **scheduleSingleGoalWorkout()** - Schedule single goal workouts
-- **schedulePacerWorkout()** - Schedule pacer workouts
-- **getScheduledWorkouts()** - List all scheduled workouts
-- **removeScheduledWorkout(id)** - Remove specific workout
-- **removeAllScheduledWorkouts()** - Clear all scheduled workouts
+- ✨ Create custom interval workouts (warmup, blocks, cooldown, alerts)
+- 🎯 Create single-goal workouts (distance / time / energy)
+- 🏃‍♂️ Create pacer workouts (pace / speed targets)
+- 🧩 Create multisport Swim / Bike / Run workouts
+- 👀 Preview with Apple’s system UI (includes “Add to Watch” / “Send to Watch”)
+- ⌚️ Schedule & sync to the Apple Watch Workout app
+- 🧠 Hooks-first API + stateful `WorkoutPlan` handle (Expo Shared Object)
+- ✅ Full TypeScript support
 
 ## Requirements
 
-- iOS 17.0+
-- Expo SDK 54+
+- iOS 17.0+ **at runtime** (WorkoutKit)
+- Tested with Expo SDK 54+
 - Apple Watch paired with iPhone (for workout sync)
 
 ## Installation
@@ -45,18 +28,8 @@ workouts to Apple Watch.
 npm install react-native-workouts
 # or
 yarn add react-native-workouts
-```
-
-### Expo Configuration
-
-Add the module to your app.json:
-
-```json
-{
-  "expo": {
-    "plugins": ["react-native-workouts"]
-  }
-}
+# or
+pnpm add react-native-workouts
 ```
 
 ### Info.plist Configuration
@@ -72,85 +45,84 @@ Add the following keys to your Info.plist for HealthKit access:
 
 ## Usage
 
-### Authorization
+### 🔐 Authorization (hook)
 
-Before scheduling workouts, you need to request authorization:
+Before previewing/scheduling, request authorization (HealthKit / WorkoutKit):
 
 ```typescript
-import ReactNativeWorkouts from "react-native-workouts";
-
-// Check current authorization status
-const status = await ReactNativeWorkouts.getAuthorizationStatus();
-// Returns: 'authorized' | 'notDetermined' | 'denied' | 'unknown'
-
-// Request authorization
-const newStatus = await ReactNativeWorkouts.requestAuthorization();
-```
-
-### Object-oriented API (WorkoutPlan + Hooks)
+import { useWorkoutAuthorization } from "react-native-workouts";
 
-This package also exposes a **stateful `WorkoutPlan` shared object** (Expo
-Shared Object) that you can keep around in JS and call methods on it:
+export function MyScreen() {
+  const { status, request, isLoading, error } = useWorkoutAuthorization();
 
-- `plan.preview()` — shows Apple's system preview modal (includes send/add to
-  Apple Watch)
-- `plan.scheduleAndSync(date)` — **schedules** the plan using Apple's
-  `WorkoutScheduler` (this is how the plan is synced to the Apple Watch Workout
-  app)
-- `plan.export()` — returns `{ id, kind, config }` so you can **persist/share**
-  the plan in your own backend
+  // status: 'authorized' | 'notDetermined' | 'denied' | 'unknown' | null
+  // request(): prompts the system dialog (if needed) and returns the new status
 
-#### What `plan.export()` means
-
-`plan.export()` does **not** export a `.workout` file or something the system
-can import.
+  return null;
+}
+```
 
-It returns a small JSON payload:
+### 🚀 Quick start (hooks-first `WorkoutPlan`)
 
-- `id`: the UUID of the `WorkoutPlan` instance
-- `kind`: `"custom" | "singleGoal" | "pacer" | "swimBikeRun"`
-- `config`: the original config used to create the plan (so you can store it and
-  recreate the plan later)
+Hooks create a **stateful `WorkoutPlan` shared object** (Expo Shared Object).
+You call methods on the plan:
 
-You typically create a plan via hooks:
+- `plan.preview()` — opens Apple’s workout preview UI (includes “Add/Send to
+  Watch”)
+- `plan.scheduleAndSync(date)` — schedules using Apple’s `WorkoutScheduler`
+  (this is what syncs it to the Watch)
+- `plan.export()` — returns `{ id, kind, config }` so you can persist/share and
+  recreate later
 
 ```typescript
-import ReactNativeWorkouts, {
+import { useMemo } from "react";
+import {
   type CustomWorkoutConfig,
   useCustomWorkout,
+  useWorkoutAuthorization,
 } from "react-native-workouts";
 
-const config: CustomWorkoutConfig = {
-  activityType: "running",
-  locationType: "outdoor",
-  displayName: "Morning Intervals",
-  blocks: [
-    {
-      iterations: 4,
-      steps: [
-        {
-          purpose: "work",
-          goal: { type: "distance", value: 400, unit: "meters" },
-        },
+export function MyWorkoutScreen() {
+  const { status, request } = useWorkoutAuthorization();
+
+  const config = useMemo<CustomWorkoutConfig>(
+    () => ({
+      activityType: "running",
+      locationType: "outdoor",
+      displayName: "Morning Intervals",
+      warmup: { goal: { type: "time", value: 5, unit: "minutes" } },
+      blocks: [
         {
-          purpose: "recovery",
-          goal: { type: "time", value: 90, unit: "seconds" },
+          iterations: 4,
+          steps: [
+            {
+              purpose: "work",
+              goal: { type: "distance", value: 400, unit: "meters" },
+              alert: { type: "pace", min: 4, max: 5, unit: "min/km" },
+            },
+            {
+              purpose: "recovery",
+              goal: { type: "time", value: 90, unit: "seconds" },
+            },
+          ],
         },
       ],
-    },
-  ],
-};
+      cooldown: { goal: { type: "time", value: 5, unit: "minutes" } },
+    }),
+    [],
+  );
 
-export function MyWorkoutScreen() {
   const { plan, isLoading, error } = useCustomWorkout(config);
 
   const preview = async () => {
     if (!plan) return;
+    if (status !== "authorized") await request();
     await plan.preview();
   };
 
-  const scheduleAndSyncTomorrow = async () => {
+  const scheduleTomorrowMorning = async () => {
     if (!plan) return;
+    if (status !== "authorized") await request();
     await plan.scheduleAndSync({
       year: 2026,
       month: 1,
@@ -164,191 +136,100 @@ export function MyWorkoutScreen() {
 }
 ```
 
-### Custom Interval Workout
-
-Create complex interval workouts with warmup, multiple blocks, and cooldown:
-
-```typescript
-import ReactNativeWorkouts from "react-native-workouts";
-import type { CustomWorkoutConfig } from "react-native-workouts";
-
-const workout: CustomWorkoutConfig = {
-  activityType: "running",
-  locationType: "outdoor",
-  displayName: "Morning Intervals",
-  warmup: {
-    goal: { type: "time", value: 5, unit: "minutes" },
-  },
-  blocks: [
-    {
-      iterations: 4,
-      steps: [
-        {
-          purpose: "work",
-          goal: { type: "distance", value: 400, unit: "meters" },
-          alert: { type: "pace", min: 4, max: 5, unit: "min/km" },
-        },
-        {
-          purpose: "recovery",
-          goal: { type: "time", value: 90, unit: "seconds" },
-        },
-      ],
-    },
-  ],
-  cooldown: {
-    goal: { type: "time", value: 5, unit: "minutes" },
-  },
-};
-
-// Validate the workout
-const result = await ReactNativeWorkouts.createCustomWorkout(workout);
-console.log(result.valid); // true
-
-// Preview (system modal with "Add to Watch"/"Send to Watch")
-await ReactNativeWorkouts.previewWorkout(workout);
-
-// Schedule for tomorrow at 7 AM
-const tomorrow = new Date();
-tomorrow.setDate(tomorrow.getDate() + 1);
-
-const scheduleResult = await ReactNativeWorkouts.scheduleWorkout(workout, {
-  year: tomorrow.getFullYear(),
-  month: tomorrow.getMonth() + 1,
-  day: tomorrow.getDate(),
-  hour: 7,
-  minute: 0,
-});
-
-console.log(scheduleResult.id); // UUID of scheduled workout
-```
-
-### Single Goal Workout
-
-Create simple goal-based workouts:
+### 🎯 Single goal workouts (hook)
 
 ```typescript
-import ReactNativeWorkouts from "react-native-workouts";
+import { useMemo } from "react";
 import type { SingleGoalWorkoutConfig } from "react-native-workouts";
-
-// 5K run
-const fiveK: SingleGoalWorkoutConfig = {
-  activityType: "running",
-  locationType: "outdoor",
-  displayName: "5K Run",
-  goal: { type: "distance", value: 5, unit: "kilometers" },
-};
-
-// 30 minute cycling session
-const cycling: SingleGoalWorkoutConfig = {
-  activityType: "cycling",
-  locationType: "indoor",
-  displayName: "30 Min Ride",
-  goal: { type: "time", value: 30, unit: "minutes" },
-};
-
-// 500 calorie workout
-const calorieBurn: SingleGoalWorkoutConfig = {
-  activityType: "highIntensityIntervalTraining",
-  displayName: "Calorie Burner",
-  goal: { type: "energy", value: 500, unit: "kilocalories" },
-};
-
-await ReactNativeWorkouts.createSingleGoalWorkout(fiveK);
-
-// Preview
-await ReactNativeWorkouts.previewSingleGoalWorkout(fiveK);
+import { useSingleGoalWorkout } from "react-native-workouts";
+
+export function FiveKScreen() {
+  const config = useMemo<SingleGoalWorkoutConfig>(
+    () => ({
+      activityType: "running",
+      locationType: "outdoor",
+      displayName: "5K Run",
+      goal: { type: "distance", value: 5, unit: "kilometers" },
+    }),
+    [],
+  );
+
+  const { plan } = useSingleGoalWorkout(config);
+  return null;
+}
 ```
 
-### Pacer Workout
-
-Create pace-based workouts:
+### 🏃‍♂️ Pacer workouts (hook)
 
 ```typescript
-import ReactNativeWorkouts from "react-native-workouts";
+import { useMemo } from "react";
 import type { PacerWorkoutConfig } from "react-native-workouts";
-
-const pacerWorkout: PacerWorkoutConfig = {
-  activityType: "running",
-  locationType: "outdoor",
-  displayName: "Tempo Run",
-  target: {
-    type: "pace",
-    value: 5, // 5 minutes per kilometer
-    unit: "min/km",
-  },
-};
-
-await ReactNativeWorkouts.createPacerWorkout(pacerWorkout);
-
-// Preview
-await ReactNativeWorkouts.previewPacerWorkout(pacerWorkout);
+import { usePacerWorkout } from "react-native-workouts";
+
+export function TempoRunScreen() {
+  const config = useMemo<PacerWorkoutConfig>(
+    () => ({
+      activityType: "running",
+      locationType: "outdoor",
+      displayName: "Tempo Run",
+      target: { type: "pace", value: 5, unit: "min/km" },
+    }),
+    [],
+  );
+
+  const { plan } = usePacerWorkout(config);
+  return null;
+}
 ```
 
-### Swim / Bike / Run (Multisport) Workout
-
-Create a multisport workout (triathlon-like) with an ordered list of activities:
+### 🧩 Swim / Bike / Run (multisport) (hook)
 
 ```typescript
+import { useMemo } from "react";
 import type { SwimBikeRunWorkoutConfig } from "react-native-workouts";
+import { useSwimBikeRunWorkout } from "react-native-workouts";
+
+export function TriathlonScreen() {
+  const config = useMemo<SwimBikeRunWorkoutConfig>(
+    () => ({
+      displayName: "Sprint Triathlon",
+      activities: [
+        { type: "swimming", locationType: "indoor" },
+        { type: "cycling", locationType: "outdoor" },
+        { type: "running", locationType: "outdoor" },
+      ],
+    }),
+    [],
+  );
 
-const triathlon: SwimBikeRunWorkoutConfig = {
-  displayName: "Sprint Triathlon",
-  activities: [
-    { type: "swimming", locationType: "indoor" },
-    { type: "cycling", locationType: "outdoor" },
-    { type: "running", locationType: "outdoor" },
-  ],
-};
-
-// Create a plan handle (recommended)
-const plan = await ReactNativeWorkouts.createSwimBikeRunWorkoutPlan(triathlon);
-
-// Preview
-await plan.preview();
+  const { plan } = useSwimBikeRunWorkout(config);
+  return null;
+}
 ```
 
-### Managing Scheduled Workouts
-
-```typescript
-// Get all scheduled workouts
-const workouts = await ReactNativeWorkouts.getScheduledWorkouts();
-
-// Remove a specific workout
-await ReactNativeWorkouts.removeScheduledWorkout(workouts[0].id);
+### 📦 Persist / share a plan (`plan.export()`)
 
-// Remove all scheduled workouts
-await ReactNativeWorkouts.removeAllScheduledWorkouts();
-```
-
-### Check Goal Support
+`plan.export()` does **not** export a `.workout` file.
 
-Verify if a goal type is supported for an activity:
+It returns a small JSON payload you can store in your backend and later
+recreate:
 
-```typescript
-const supported = await ReactNativeWorkouts.supportsGoal(
-  "swimming",
-  "indoor",
-  "distance",
-);
-```
+- `id`: UUID of the `WorkoutPlan` instance
+- `kind`: `"custom" | "singleGoal" | "pacer" | "swimBikeRun"`
+- `config`: the original config used to create the plan
 
-### Utility Functions
+### 📅 Managing scheduled workouts (hook)
 
 ```typescript
-// Get all supported activity types
-const activities = ReactNativeWorkouts.getSupportedActivityTypes();
-// ['running', 'cycling', 'walking', 'hiking', ...]
-
-// Get supported goal types
-const goals = ReactNativeWorkouts.getSupportedGoalTypes();
-// ['open', 'distance', 'time', 'energy']
+import { useScheduledWorkouts } from "react-native-workouts";
 
-// Get supported location types
-const locations = ReactNativeWorkouts.getSupportedLocationTypes();
-// ['indoor', 'outdoor']
+export function ScheduledWorkoutsScreen() {
+  const { workouts, remove, removeAll, schedule, isLoading, error } =
+    useScheduledWorkouts();
 
-// Check if HealthKit is available
-const available = ReactNativeWorkouts.isAvailable;
+  // schedule(plan, date) calls plan.scheduleAndSync(date) and reloads the list
+  return null;
+}
 ```
 
 ## API Reference
@@ -444,12 +325,23 @@ type PaceUnit = "minutesPerKilometer" | "min/km" | "minutesPerMile" | "min/mi";
 
 - Swimming workouts do not support custom intervals, use SingleGoalWorkout
   instead
-- Not all activity types support all goal types - use `supportsGoal()` to check
 - Scheduled workouts appear in the Workout app on Apple Watch and Fitness app on
   iPhone
 - Workouts display your app's icon and name in the Workout app
 - The preview APIs use Apple’s system UI (`workoutPreview`) and require iOS 17+
 
+### Deployment target note
+
+This library is built on Apple's `WorkoutKit` (introduced in iOS 17). To avoid
+forcing apps to raise their deployment target just to install the package, the
+iOS native code:
+
+- **weak-links** `WorkoutKit`
+- gates all exported APIs behind `#available(iOS 17.0, *)`
+
+On **iOS < 17**, calling any WorkoutKit API will reject/throw with an
+`Unavailable` error.
+
 ## License
 
 MIT

package/app.json

@@ -1,5 +1,3 @@
 {
-  "plugins": [
-    "expo-build-properties"
-  ]
-}
+  "plugins": []
+}

package/build/ReactNativeWorkoutsModule.d.ts

@@ -1,5 +1,5 @@
 import { NativeModule } from "expo";
-import type { ActivityType, AuthorizationStatus, CustomWorkoutConfig, DateComponents, LocationType, PacerWorkoutConfig, SwimBikeRunWorkoutConfig, ReactNativeWorkoutsModuleEvents, ScheduledWorkout, ScheduleResult, SingleGoalWorkoutConfig, WorkoutPlan, WorkoutValidationResult } from "./ReactNativeWorkouts.types";
+import type { ActivityType, AuthorizationStatus, CustomWorkoutConfig, DateComponents, LocationType, PacerWorkoutConfig, ReactNativeWorkoutsModuleEvents, ScheduledWorkout, ScheduleResult, SingleGoalWorkoutConfig, SwimBikeRunWorkoutConfig, WorkoutPlan, WorkoutValidationResult } from "./ReactNativeWorkouts.types";
 declare class ReactNativeWorkoutsModule extends NativeModule<ReactNativeWorkoutsModuleEvents> {
     /**
      * Whether Health data is available on this device.
@@ -29,7 +29,7 @@ declare class ReactNativeWorkoutsModule extends NativeModule<ReactNativeWorkouts
     /**
      * Schedules a custom workout (syncs it to the Apple Watch Workout app).
      *
-     * Prefer using `createCustomWorkoutPlan(...)` + `plan.scheduleAndSync(...)` for new code.
+     * Prefer using `useCustomWorkout(...)` + `plan.scheduleAndSync(...)` for new code.
      */
     scheduleWorkout(config: CustomWorkoutConfig, date: DateComponents): Promise<ScheduleResult>;
     /**
@@ -43,7 +43,7 @@ declare class ReactNativeWorkoutsModule extends NativeModule<ReactNativeWorkouts
     /**
      * Schedules a single-goal workout (syncs it to the Apple Watch Workout app).
      *
-     * Prefer using `createSingleGoalWorkoutPlan(...)` + `plan.scheduleAndSync(...)` for new code.
+     * Prefer using `useSingleGoalWorkout(...)` + `plan.scheduleAndSync(...)` for new code.
      */
     scheduleSingleGoalWorkout(config: SingleGoalWorkoutConfig, date: DateComponents): Promise<ScheduleResult>;
     /**
@@ -57,7 +57,7 @@ declare class ReactNativeWorkoutsModule extends NativeModule<ReactNativeWorkouts
     /**
      * Schedules a pacer workout (syncs it to the Apple Watch Workout app).
      *
-     * Prefer using `createPacerWorkoutPlan(...)` + `plan.scheduleAndSync(...)` for new code.
+     * Prefer using `usePacerWorkout(...)` + `plan.scheduleAndSync(...)` for new code.
      */
     schedulePacerWorkout(config: PacerWorkoutConfig, date: DateComponents): Promise<ScheduleResult>;
     /**

package/build/ReactNativeWorkoutsModule.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ReactNativeWorkoutsModule.d.ts","sourceRoot":"","sources":["../src/ReactNativeWorkoutsModule.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAuB,MAAM,MAAM,CAAC;AAEzD,OAAO,KAAK,EACV,YAAY,EACZ,mBAAmB,EACnB,mBAAmB,EACnB,cAAc,EACd,YAAY,EACZ,kBAAkB,EAClB,wBAAwB,EACxB,+BAA+B,EAC/B,gBAAgB,EAChB,cAAc,EACd,uBAAuB,EACvB,WAAW,EACX,uBAAuB,EACxB,MAAM,6BAA6B,CAAC;AAErC,OAAO,OAAO,yBACZ,SAAQ,YAAY,CAAC,+BAA+B,CAAC;IAErD;;;OAGG;IACH,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC;IAG9B;;OAEG;IACH,sBAAsB,IAAI,OAAO,CAAC,mBAAmB,CAAC;IACtD;;OAEG;IACH,oBAAoB,IAAI,OAAO,CAAC,mBAAmB,CAAC;IAGpD;;OAEG;IACH,YAAY,CACV,YAAY,EAAE,YAAY,EAC1B,YAAY,EAAE,YAAY,EAC1B,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,OAAO,CAAC;IAGnB;;OAEG;IACH,mBAAmB,CACjB,MAAM,EAAE,mBAAmB,GAC1B,OAAO,CAAC,uBAAuB,CAAC;IACnC;;OAEG;IACH,cAAc,CAAC,MAAM,EAAE,mBAAmB,GAAG,OAAO,CAAC,OAAO,CAAC;IAC7D;;;;OAIG;IACH,eAAe,CACb,MAAM,EAAE,mBAAmB,EAC3B,IAAI,EAAE,cAAc,GACnB,OAAO,CAAC,cAAc,CAAC;IAG1B;;OAEG;IACH,uBAAuB,CACrB,MAAM,EAAE,uBAAuB,GAC9B,OAAO,CAAC,uBAAuB,CAAC;IACnC;;OAEG;IACH,wBAAwB,CAAC,MAAM,EAAE,uBAAuB,GAAG,OAAO,CAAC,OAAO,CAAC;IAC3E;;;;OAIG;IACH,yBAAyB,CACvB,MAAM,EAAE,uBAAuB,EAC/B,IAAI,EAAE,cAAc,GACnB,OAAO,CAAC,cAAc,CAAC;IAG1B;;OAEG;IACH,kBAAkB,CAChB,MAAM,EAAE,kBAAkB,GACzB,OAAO,CAAC,uBAAuB,CAAC;IACnC;;OAEG;IACH,mBAAmB,CAAC,MAAM,EAAE,kBAAkB,GAAG,OAAO,CAAC,OAAO,CAAC;IACjE;;;;OAIG;IACH,oBAAoB,CAClB,MAAM,EAAE,kBAAkB,EAC1B,IAAI,EAAE,cAAc,GACnB,OAAO,CAAC,cAAc,CAAC;IAG1B;;OAEG;IACH,uBAAuB,CAAC,MAAM,EAAE,mBAAmB,GAAG,OAAO,CAAC,WAAW,CAAC;IAC1E;;OAEG;IACH,2BAA2B,CACzB,MAAM,EAAE,uBAAuB,GAC9B,OAAO,CAAC,WAAW,CAAC;IACvB;;OAEG;IACH,sBAAsB,CAAC,MAAM,EAAE,kBAAkB,GAAG,OAAO,CAAC,WAAW,CAAC;IACxE;;OAEG;IACH,4BAA4B,CAC1B,MAAM,EAAE,wBAAwB,GAC/B,OAAO,CAAC,WAAW,CAAC;IAGvB;;OAEG;IACH,oBAAoB,IAAI,OAAO,CAAC,gBAAgB,EAAE,CAAC;IACnD;;OAEG;IACH,sBAAsB,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IACpD;;OAEG;IACH,0BAA0B,IAAI,OAAO,CAAC,OAAO,CAAC;IAG9C,yBAAyB,IAAI,YAAY,EAAE;IAC3C,qBAAqB,IAAI,MAAM,EAAE;IACjC,yBAAyB,IAAI,YAAY,EAAE;CAC5C;;AAED,wBAEE"}
+{"version":3,"file":"ReactNativeWorkoutsModule.d.ts","sourceRoot":"","sources":["../src/ReactNativeWorkoutsModule.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAuB,MAAM,MAAM,CAAC;AAEzD,OAAO,KAAK,EACV,YAAY,EACZ,mBAAmB,EACnB,mBAAmB,EACnB,cAAc,EACd,YAAY,EACZ,kBAAkB,EAClB,+BAA+B,EAC/B,gBAAgB,EAChB,cAAc,EACd,uBAAuB,EACvB,wBAAwB,EACxB,WAAW,EACX,uBAAuB,EACxB,MAAM,6BAA6B,CAAC;AAErC,OAAO,OAAO,yBACZ,SAAQ,YAAY,CAAC,+BAA+B,CAAC;IAErD;;;OAGG;IACH,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC;IAG9B;;OAEG;IACH,sBAAsB,IAAI,OAAO,CAAC,mBAAmB,CAAC;IACtD;;OAEG;IACH,oBAAoB,IAAI,OAAO,CAAC,mBAAmB,CAAC;IAGpD;;OAEG;IACH,YAAY,CACV,YAAY,EAAE,YAAY,EAC1B,YAAY,EAAE,YAAY,EAC1B,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,OAAO,CAAC;IAGnB;;OAEG;IACH,mBAAmB,CACjB,MAAM,EAAE,mBAAmB,GAC1B,OAAO,CAAC,uBAAuB,CAAC;IACnC;;OAEG;IACH,cAAc,CAAC,MAAM,EAAE,mBAAmB,GAAG,OAAO,CAAC,OAAO,CAAC;IAC7D;;;;OAIG;IACH,eAAe,CACb,MAAM,EAAE,mBAAmB,EAC3B,IAAI,EAAE,cAAc,GACnB,OAAO,CAAC,cAAc,CAAC;IAG1B;;OAEG;IACH,uBAAuB,CACrB,MAAM,EAAE,uBAAuB,GAC9B,OAAO,CAAC,uBAAuB,CAAC;IACnC;;OAEG;IACH,wBAAwB,CAAC,MAAM,EAAE,uBAAuB,GAAG,OAAO,CAAC,OAAO,CAAC;IAC3E;;;;OAIG;IACH,yBAAyB,CACvB,MAAM,EAAE,uBAAuB,EAC/B,IAAI,EAAE,cAAc,GACnB,OAAO,CAAC,cAAc,CAAC;IAG1B;;OAEG;IACH,kBAAkB,CAChB,MAAM,EAAE,kBAAkB,GACzB,OAAO,CAAC,uBAAuB,CAAC;IACnC;;OAEG;IACH,mBAAmB,CAAC,MAAM,EAAE,kBAAkB,GAAG,OAAO,CAAC,OAAO,CAAC;IACjE;;;;OAIG;IACH,oBAAoB,CAClB,MAAM,EAAE,kBAAkB,EAC1B,IAAI,EAAE,cAAc,GACnB,OAAO,CAAC,cAAc,CAAC;IAG1B;;OAEG;IACH,uBAAuB,CAAC,MAAM,EAAE,mBAAmB,GAAG,OAAO,CAAC,WAAW,CAAC;IAC1E;;OAEG;IACH,2BAA2B,CACzB,MAAM,EAAE,uBAAuB,GAC9B,OAAO,CAAC,WAAW,CAAC;IACvB;;OAEG;IACH,sBAAsB,CAAC,MAAM,EAAE,kBAAkB,GAAG,OAAO,CAAC,WAAW,CAAC;IACxE;;OAEG;IACH,4BAA4B,CAC1B,MAAM,EAAE,wBAAwB,GAC/B,OAAO,CAAC,WAAW,CAAC;IAGvB;;OAEG;IACH,oBAAoB,IAAI,OAAO,CAAC,gBAAgB,EAAE,CAAC;IACnD;;OAEG;IACH,sBAAsB,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IACpD;;OAEG;IACH,0BAA0B,IAAI,OAAO,CAAC,OAAO,CAAC;IAG9C,yBAAyB,IAAI,YAAY,EAAE;IAC3C,qBAAqB,IAAI,MAAM,EAAE;IACjC,yBAAyB,IAAI,YAAY,EAAE;CAC5C;;AAED,wBAEE"}

package/build/ReactNativeWorkoutsModule.js.map

@@ -1 +1 @@
-{"version":3,"file":"ReactNativeWorkoutsModule.js","sourceRoot":"","sources":["../src/ReactNativeWorkoutsModule.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgB,mBAAmB,EAAE,MAAM,MAAM,CAAC;AAwJzD,eAAe,mBAAmB,CAChC,qBAAqB,CACtB,CAAC","sourcesContent":["import { NativeModule, requireNativeModule } from \"expo\";\n\nimport type {\n  ActivityType,\n  AuthorizationStatus,\n  CustomWorkoutConfig,\n  DateComponents,\n  LocationType,\n  PacerWorkoutConfig,\n  SwimBikeRunWorkoutConfig,\n  ReactNativeWorkoutsModuleEvents,\n  ScheduledWorkout,\n  ScheduleResult,\n  SingleGoalWorkoutConfig,\n  WorkoutPlan,\n  WorkoutValidationResult,\n} from \"./ReactNativeWorkouts.types\";\n\ndeclare class ReactNativeWorkoutsModule\n  extends NativeModule<ReactNativeWorkoutsModuleEvents> {\n  // Constants\n  /**\n   * Whether Health data is available on this device.\n   * On iOS simulators this is typically `false`.\n   */\n  readonly isAvailable: boolean;\n\n  // Authorization\n  /**\n   * Returns the current WorkoutKit authorization status.\n   */\n  getAuthorizationStatus(): Promise<AuthorizationStatus>;\n  /**\n   * Prompts the user for WorkoutKit authorization (if needed).\n   */\n  requestAuthorization(): Promise<AuthorizationStatus>;\n\n  // Validation\n  /**\n   * Returns whether a given goal type is supported for the provided activity + location.\n   */\n  supportsGoal(\n    activityType: ActivityType,\n    locationType: LocationType,\n    goalType: string,\n  ): Promise<boolean>;\n\n  // Custom Workouts\n  /**\n   * Validates a custom workout config. (Legacy name: this does not persist anything.)\n   */\n  createCustomWorkout(\n    config: CustomWorkoutConfig,\n  ): Promise<WorkoutValidationResult>;\n  /**\n   * Previews a custom workout via Apple's system modal.\n   */\n  previewWorkout(config: CustomWorkoutConfig): Promise<boolean>;\n  /**\n   * Schedules a custom workout (syncs it to the Apple Watch Workout app).\n   *\n   * Prefer using `createCustomWorkoutPlan(...)` + `plan.scheduleAndSync(...)` for new code.\n   */\n  scheduleWorkout(\n    config: CustomWorkoutConfig,\n    date: DateComponents,\n  ): Promise<ScheduleResult>;\n\n  // Single Goal Workouts\n  /**\n   * Validates a single-goal workout config. (Legacy name: this does not persist anything.)\n   */\n  createSingleGoalWorkout(\n    config: SingleGoalWorkoutConfig,\n  ): Promise<WorkoutValidationResult>;\n  /**\n   * Previews a single-goal workout via Apple's system modal.\n   */\n  previewSingleGoalWorkout(config: SingleGoalWorkoutConfig): Promise<boolean>;\n  /**\n   * Schedules a single-goal workout (syncs it to the Apple Watch Workout app).\n   *\n   * Prefer using `createSingleGoalWorkoutPlan(...)` + `plan.scheduleAndSync(...)` for new code.\n   */\n  scheduleSingleGoalWorkout(\n    config: SingleGoalWorkoutConfig,\n    date: DateComponents,\n  ): Promise<ScheduleResult>;\n\n  // Pacer Workouts\n  /**\n   * Validates a pacer workout config. (Legacy name: this does not persist anything.)\n   */\n  createPacerWorkout(\n    config: PacerWorkoutConfig,\n  ): Promise<WorkoutValidationResult>;\n  /**\n   * Previews a pacer workout via Apple's system modal.\n   */\n  previewPacerWorkout(config: PacerWorkoutConfig): Promise<boolean>;\n  /**\n   * Schedules a pacer workout (syncs it to the Apple Watch Workout app).\n   *\n   * Prefer using `createPacerWorkoutPlan(...)` + `plan.scheduleAndSync(...)` for new code.\n   */\n  schedulePacerWorkout(\n    config: PacerWorkoutConfig,\n    date: DateComponents,\n  ): Promise<ScheduleResult>;\n\n  // Shared WorkoutPlan factories (object-oriented API)\n  /**\n   * Creates a stateful `WorkoutPlan` shared object (recommended API for new code).\n   */\n  createCustomWorkoutPlan(config: CustomWorkoutConfig): Promise<WorkoutPlan>;\n  /**\n   * Creates a stateful `WorkoutPlan` shared object (recommended API for new code).\n   */\n  createSingleGoalWorkoutPlan(\n    config: SingleGoalWorkoutConfig,\n  ): Promise<WorkoutPlan>;\n  /**\n   * Creates a stateful `WorkoutPlan` shared object (recommended API for new code).\n   */\n  createPacerWorkoutPlan(config: PacerWorkoutConfig): Promise<WorkoutPlan>;\n  /**\n   * Creates a stateful multisport `WorkoutPlan` shared object (recommended API for new code).\n   */\n  createSwimBikeRunWorkoutPlan(\n    config: SwimBikeRunWorkoutConfig,\n  ): Promise<WorkoutPlan>;\n\n  // Scheduled Workouts Management\n  /**\n   * Lists scheduled workouts created by this app.\n   */\n  getScheduledWorkouts(): Promise<ScheduledWorkout[]>;\n  /**\n   * Removes a scheduled workout by ID.\n   */\n  removeScheduledWorkout(id: string): Promise<boolean>;\n  /**\n   * Removes all scheduled workouts created by this app.\n   */\n  removeAllScheduledWorkouts(): Promise<boolean>;\n\n  // Utility\n  getSupportedActivityTypes(): ActivityType[];\n  getSupportedGoalTypes(): string[];\n  getSupportedLocationTypes(): LocationType[];\n}\n\nexport default requireNativeModule<ReactNativeWorkoutsModule>(\n  \"ReactNativeWorkouts\",\n);\n"]}
+{"version":3,"file":"ReactNativeWorkoutsModule.js","sourceRoot":"","sources":["../src/ReactNativeWorkoutsModule.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgB,mBAAmB,EAAE,MAAM,MAAM,CAAC;AAwJzD,eAAe,mBAAmB,CAChC,qBAAqB,CACtB,CAAC","sourcesContent":["import { NativeModule, requireNativeModule } from \"expo\";\n\nimport type {\n  ActivityType,\n  AuthorizationStatus,\n  CustomWorkoutConfig,\n  DateComponents,\n  LocationType,\n  PacerWorkoutConfig,\n  ReactNativeWorkoutsModuleEvents,\n  ScheduledWorkout,\n  ScheduleResult,\n  SingleGoalWorkoutConfig,\n  SwimBikeRunWorkoutConfig,\n  WorkoutPlan,\n  WorkoutValidationResult,\n} from \"./ReactNativeWorkouts.types\";\n\ndeclare class ReactNativeWorkoutsModule\n  extends NativeModule<ReactNativeWorkoutsModuleEvents> {\n  // Constants\n  /**\n   * Whether Health data is available on this device.\n   * On iOS simulators this is typically `false`.\n   */\n  readonly isAvailable: boolean;\n\n  // Authorization\n  /**\n   * Returns the current WorkoutKit authorization status.\n   */\n  getAuthorizationStatus(): Promise<AuthorizationStatus>;\n  /**\n   * Prompts the user for WorkoutKit authorization (if needed).\n   */\n  requestAuthorization(): Promise<AuthorizationStatus>;\n\n  // Validation\n  /**\n   * Returns whether a given goal type is supported for the provided activity + location.\n   */\n  supportsGoal(\n    activityType: ActivityType,\n    locationType: LocationType,\n    goalType: string,\n  ): Promise<boolean>;\n\n  // Custom Workouts\n  /**\n   * Validates a custom workout config. (Legacy name: this does not persist anything.)\n   */\n  createCustomWorkout(\n    config: CustomWorkoutConfig,\n  ): Promise<WorkoutValidationResult>;\n  /**\n   * Previews a custom workout via Apple's system modal.\n   */\n  previewWorkout(config: CustomWorkoutConfig): Promise<boolean>;\n  /**\n   * Schedules a custom workout (syncs it to the Apple Watch Workout app).\n   *\n   * Prefer using `useCustomWorkout(...)` + `plan.scheduleAndSync(...)` for new code.\n   */\n  scheduleWorkout(\n    config: CustomWorkoutConfig,\n    date: DateComponents,\n  ): Promise<ScheduleResult>;\n\n  // Single Goal Workouts\n  /**\n   * Validates a single-goal workout config. (Legacy name: this does not persist anything.)\n   */\n  createSingleGoalWorkout(\n    config: SingleGoalWorkoutConfig,\n  ): Promise<WorkoutValidationResult>;\n  /**\n   * Previews a single-goal workout via Apple's system modal.\n   */\n  previewSingleGoalWorkout(config: SingleGoalWorkoutConfig): Promise<boolean>;\n  /**\n   * Schedules a single-goal workout (syncs it to the Apple Watch Workout app).\n   *\n   * Prefer using `useSingleGoalWorkout(...)` + `plan.scheduleAndSync(...)` for new code.\n   */\n  scheduleSingleGoalWorkout(\n    config: SingleGoalWorkoutConfig,\n    date: DateComponents,\n  ): Promise<ScheduleResult>;\n\n  // Pacer Workouts\n  /**\n   * Validates a pacer workout config. (Legacy name: this does not persist anything.)\n   */\n  createPacerWorkout(\n    config: PacerWorkoutConfig,\n  ): Promise<WorkoutValidationResult>;\n  /**\n   * Previews a pacer workout via Apple's system modal.\n   */\n  previewPacerWorkout(config: PacerWorkoutConfig): Promise<boolean>;\n  /**\n   * Schedules a pacer workout (syncs it to the Apple Watch Workout app).\n   *\n   * Prefer using `usePacerWorkout(...)` + `plan.scheduleAndSync(...)` for new code.\n   */\n  schedulePacerWorkout(\n    config: PacerWorkoutConfig,\n    date: DateComponents,\n  ): Promise<ScheduleResult>;\n\n  // Shared WorkoutPlan factories (object-oriented API)\n  /**\n   * Creates a stateful `WorkoutPlan` shared object (recommended API for new code).\n   */\n  createCustomWorkoutPlan(config: CustomWorkoutConfig): Promise<WorkoutPlan>;\n  /**\n   * Creates a stateful `WorkoutPlan` shared object (recommended API for new code).\n   */\n  createSingleGoalWorkoutPlan(\n    config: SingleGoalWorkoutConfig,\n  ): Promise<WorkoutPlan>;\n  /**\n   * Creates a stateful `WorkoutPlan` shared object (recommended API for new code).\n   */\n  createPacerWorkoutPlan(config: PacerWorkoutConfig): Promise<WorkoutPlan>;\n  /**\n   * Creates a stateful multisport `WorkoutPlan` shared object (recommended API for new code).\n   */\n  createSwimBikeRunWorkoutPlan(\n    config: SwimBikeRunWorkoutConfig,\n  ): Promise<WorkoutPlan>;\n\n  // Scheduled Workouts Management\n  /**\n   * Lists scheduled workouts created by this app.\n   */\n  getScheduledWorkouts(): Promise<ScheduledWorkout[]>;\n  /**\n   * Removes a scheduled workout by ID.\n   */\n  removeScheduledWorkout(id: string): Promise<boolean>;\n  /**\n   * Removes all scheduled workouts created by this app.\n   */\n  removeAllScheduledWorkouts(): Promise<boolean>;\n\n  // Utility\n  getSupportedActivityTypes(): ActivityType[];\n  getSupportedGoalTypes(): string[];\n  getSupportedLocationTypes(): LocationType[];\n}\n\nexport default requireNativeModule<ReactNativeWorkoutsModule>(\n  \"ReactNativeWorkouts\",\n);\n"]}

package/ios/ReactNativeWorkouts.podspec

@@ -11,7 +11,10 @@ Pod::Spec.new do |s|
   s.author         = package['author']
   s.homepage       = package['homepage']
   s.platforms      = {
-    :ios => '17.0'
+    # The module APIs require iOS 17+ at runtime (WorkoutKit), but we keep the
+    # deployment target lower so apps can still build with e.g. iOS 15 targets.
+    # Calls on iOS < 17 will throw a descriptive "Unavailable" error.
+    :ios => '15.1'
   }
   s.swift_version  = '5.9'
   s.source         = { git: 'https://github.com/Janjiran/react-native-workouts' }
@@ -19,7 +22,10 @@ Pod::Spec.new do |s|
 
   s.dependency 'ExpoModulesCore'
 
-  s.frameworks = 'WorkoutKit', 'HealthKit'
+  # HealthKit exists on older iOS versions, keep it strongly linked.
+  s.frameworks = 'HealthKit'
+  # WorkoutKit does NOT exist on iOS < 17; weak-link it so the app can still load.
+  s.weak_frameworks = 'WorkoutKit'
 
   s.pod_target_xcconfig = {
     'DEFINES_MODULE' => 'YES',

package/ios/ReactNativeWorkoutsModule.swift

@@ -6,14 +6,17 @@ import UIKit
 
 // MARK: - Shared Objects
 
-@available(iOS 17.0, *)
 public final class WorkoutPlanObject: SharedObject {
-    fileprivate let plan: WorkoutPlan
+    // Keep the plan opaque so this object can be referenced in ModuleDefinition on iOS < 17.
+    // We only cast/use WorkoutKit types behind runtime availability checks.
+    fileprivate let planHandle: Any
+    fileprivate let planId: String
     fileprivate let kind: String
     fileprivate let sourceConfig: [String: Any]
 
-    fileprivate init(plan: WorkoutPlan, kind: String, sourceConfig: [String: Any]) {
-        self.plan = plan
+    fileprivate init(planHandle: Any, planId: String, kind: String, sourceConfig: [String: Any]) {
+        self.planHandle = planHandle
+        self.planId = planId
         self.kind = kind
         self.sourceConfig = sourceConfig
         super.init()
@@ -21,7 +24,7 @@ public final class WorkoutPlanObject: SharedObject {
 
     fileprivate func export() -> [String: Any] {
         return [
-            "id": plan.id.uuidString,
+            "id": planId,
             "kind": kind,
             "config": sourceConfig
         ]
@@ -29,19 +32,32 @@ public final class WorkoutPlanObject: SharedObject {
 
     @MainActor
     fileprivate func preview() async throws {
+        guard #available(iOS 17.0, *) else {
+            throw Exception(name: "Unavailable", description: "WorkoutKit requires iOS 17+. This API is unavailable on the current OS version.")
+        }
+        let plan = try self.getWorkoutPlan()
         try await presentWorkoutPreview(plan)
     }
 
     fileprivate func schedule(at date: DateComponents) async throws -> [String: Any] {
-        do {
-            try await WorkoutScheduler.shared.schedule(plan, at: date)
-            return [
-                "success": true,
-                "id": plan.id.uuidString
-            ]
-        } catch {
-            throw Exception(name: "ScheduleError", description: error.localizedDescription)
+        guard #available(iOS 17.0, *) else {
+            throw Exception(name: "Unavailable", description: "WorkoutKit requires iOS 17+. This API is unavailable on the current OS version.")
         }
+
+        let plan = try self.getWorkoutPlan()
+        await WorkoutScheduler.shared.schedule(plan, at: date)
+        return [
+            "success": true,
+            "id": planId
+        ]
+    }
+
+    @available(iOS 17.0, *)
+    private func getWorkoutPlan() throws -> WorkoutPlan {
+        guard let plan = planHandle as? WorkoutPlan else {
+            throw Exception(name: "InvalidState", description: "Workout plan handle is invalid")
+        }
+        return plan
     }
 }
 
@@ -61,10 +77,12 @@ public class ReactNativeWorkoutsModule: Module {
 
         Events("onAuthorizationChange")
 
+        let workoutKitUnavailableMessage = "WorkoutKit requires iOS 17+. This API is unavailable on the current OS version."
+
         // MARK: - Shared Object API (WorkoutPlan)
         Class("WorkoutPlan", WorkoutPlanObject.self) {
             Property("id") { planObject in
-                return planObject.plan.id.uuidString
+                return planObject.planId
             }
 
             Property("kind") { planObject in
@@ -87,15 +105,60 @@ public class ReactNativeWorkoutsModule: Module {
             }
         }
 
-        // Factories (return a WorkoutPlanObject handle to JS)
+        // MARK: - Authorization
+
+        AsyncFunction("getAuthorizationStatus") { () async throws -> String in
+            guard #available(iOS 17.0, *) else {
+                throw Exception(name: "Unavailable", description: workoutKitUnavailableMessage)
+            }
+
+            let status = await WorkoutScheduler.shared.authorizationState
+            return self.authorizationStateToString(status)
+        }
+
+        AsyncFunction("requestAuthorization") { () async throws -> String in
+            guard #available(iOS 17.0, *) else {
+                throw Exception(name: "Unavailable", description: workoutKitUnavailableMessage)
+            }
+
+            let status = await WorkoutScheduler.shared.requestAuthorization()
+            return self.authorizationStateToString(status)
+        }
+
+        // MARK: - Workout Validation
+
+        AsyncFunction("supportsGoal") { (activityType: String, locationType: String, goalType: String) throws -> Bool in
+            guard #available(iOS 17.0, *) else {
+                throw Exception(name: "Unavailable", description: workoutKitUnavailableMessage)
+            }
+
+            guard let activity = self.parseActivityType(activityType),
+                  let location = self.parseLocationType(locationType),
+                  let goal = self.parseGoalTypeForValidation(goalType) else {
+                return false
+            }
+
+            return CustomWorkout.supportsGoal(goal, activity: activity, location: location)
+        }
+
+        // MARK: - Plan factories (return a WorkoutPlanObject handle to JS)
+
         AsyncFunction("createCustomWorkoutPlan") { (config: [String: Any]) throws -> WorkoutPlanObject in
+            guard #available(iOS 17.0, *) else {
+                throw Exception(name: "Unavailable", description: workoutKitUnavailableMessage)
+            }
+
             let workout = try self.buildCustomWorkout(from: config)
             try self.validateCustomWorkout(workout)
             let plan = WorkoutPlan(.custom(workout))
-            return WorkoutPlanObject(plan: plan, kind: "custom", sourceConfig: config)
+            return WorkoutPlanObject(planHandle: plan, planId: plan.id.uuidString, kind: "custom", sourceConfig: config)
         }
 
         AsyncFunction("createSingleGoalWorkoutPlan") { (config: [String: Any]) throws -> WorkoutPlanObject in
+            guard #available(iOS 17.0, *) else {
+                throw Exception(name: "Unavailable", description: workoutKitUnavailableMessage)
+            }
+
             guard let activityTypeStr = config["activityType"] as? String,
                   let activity = self.parseActivityType(activityTypeStr),
                   let goalConfig = config["goal"] as? [String: Any] else {
@@ -111,10 +174,14 @@ public class ReactNativeWorkoutsModule: Module {
 
             let workout = SingleGoalWorkout(activity: activity, location: location, goal: goal)
             let plan = WorkoutPlan(.goal(workout))
-            return WorkoutPlanObject(plan: plan, kind: "singleGoal", sourceConfig: config)
+            return WorkoutPlanObject(planHandle: plan, planId: plan.id.uuidString, kind: "singleGoal", sourceConfig: config)
         }
 
         AsyncFunction("createPacerWorkoutPlan") { (config: [String: Any]) throws -> WorkoutPlanObject in
+            guard #available(iOS 17.0, *) else {
+                throw Exception(name: "Unavailable", description: workoutKitUnavailableMessage)
+            }
+
             guard let activityTypeStr = config["activityType"] as? String,
                   let activity = self.parseActivityType(activityTypeStr),
                   let targetConfig = config["target"] as? [String: Any] else {
@@ -126,10 +193,14 @@ public class ReactNativeWorkoutsModule: Module {
 
             let workout = PacerWorkout(activity: activity, location: location, distance: distance, time: time)
             let plan = WorkoutPlan(.pacer(workout))
-            return WorkoutPlanObject(plan: plan, kind: "pacer", sourceConfig: config)
+            return WorkoutPlanObject(planHandle: plan, planId: plan.id.uuidString, kind: "pacer", sourceConfig: config)
         }
 
         AsyncFunction("createSwimBikeRunWorkoutPlan") { (config: [String: Any]) throws -> WorkoutPlanObject in
+            guard #available(iOS 17.0, *) else {
+                throw Exception(name: "Unavailable", description: workoutKitUnavailableMessage)
+            }
+
             guard let activitiesConfig = config["activities"] as? [[String: Any]] else {
                 throw Exception(name: "InvalidConfig", description: "Missing required field: activities")
             }
@@ -143,52 +214,32 @@ public class ReactNativeWorkoutsModule: Module {
 
             let workout = SwimBikeRunWorkout(activities: activities, displayName: displayName)
             let plan = WorkoutPlan(.swimBikeRun(workout))
-            return WorkoutPlanObject(plan: plan, kind: "swimBikeRun", sourceConfig: config)
-        }
-
-        // MARK: - Authorization
-
-        AsyncFunction("getAuthorizationStatus") { () async -> String in
-            let status = await WorkoutScheduler.shared.authorizationState
-            return self.authorizationStateToString(status)
-        }
-
-        AsyncFunction("requestAuthorization") { () async -> String in
-            let status = await WorkoutScheduler.shared.requestAuthorization()
-            return self.authorizationStateToString(status)
-        }
-
-        // MARK: - Workout Validation
-
-        AsyncFunction("supportsGoal") { (activityType: String, locationType: String, goalType: String) -> Bool in
-            guard let activity = self.parseActivityType(activityType),
-                  let location = self.parseLocationType(locationType),
-                  let goal = self.parseGoalTypeForValidation(goalType) else {
-                return false
-            }
-
-            return CustomWorkout.supportsGoal(goal, activity: activity, location: location)
+            return WorkoutPlanObject(planHandle: plan, planId: plan.id.uuidString, kind: "swimBikeRun", sourceConfig: config)
         }
 
         // MARK: - Custom Workout Creation
 
         AsyncFunction("createCustomWorkout") { (config: [String: Any]) throws -> [String: Any] in
+            guard #available(iOS 17.0, *) else {
+                throw Exception(name: "Unavailable", description: workoutKitUnavailableMessage)
+            }
+
             let workout = try self.buildCustomWorkout(from: config)
             try self.validateCustomWorkout(workout)
 
-            do {
-                return [
-                    "valid": true,
-                    "displayName": workout.displayName ?? (config["displayName"] as? String ?? "")
-                ]
-            } catch {
-                throw Exception(name: "ValidationError", description: error.localizedDescription)
-            }
+            return [
+                "valid": true,
+                "displayName": workout.displayName ?? (config["displayName"] as? String ?? "")
+            ]
         }
 
         // MARK: - Workout Preview (system modal)
 
         AsyncFunction("previewWorkout") { (config: [String: Any]) async throws -> Bool in
+            guard #available(iOS 17.0, *) else {
+                throw Exception(name: "Unavailable", description: workoutKitUnavailableMessage)
+            }
+
             let workout = try self.buildCustomWorkout(from: config)
             try self.validateCustomWorkout(workout)
             let plan = WorkoutPlan(.custom(workout))
@@ -198,6 +249,10 @@ public class ReactNativeWorkoutsModule: Module {
         }
 
         AsyncFunction("previewSingleGoalWorkout") { (config: [String: Any]) async throws -> Bool in
+            guard #available(iOS 17.0, *) else {
+                throw Exception(name: "Unavailable", description: workoutKitUnavailableMessage)
+            }
+
             guard let activityTypeStr = config["activityType"] as? String,
                   let activity = self.parseActivityType(activityTypeStr),
                   let goalConfig = config["goal"] as? [String: Any] else {
@@ -219,6 +274,10 @@ public class ReactNativeWorkoutsModule: Module {
         }
 
         AsyncFunction("previewPacerWorkout") { (config: [String: Any]) async throws -> Bool in
+            guard #available(iOS 17.0, *) else {
+                throw Exception(name: "Unavailable", description: workoutKitUnavailableMessage)
+            }
+
             guard let activityTypeStr = config["activityType"] as? String,
                   let activity = self.parseActivityType(activityTypeStr),
                   let targetConfig = config["target"] as? [String: Any] else {
@@ -238,35 +297,42 @@ public class ReactNativeWorkoutsModule: Module {
         // MARK: - Scheduled Workouts
 
         AsyncFunction("scheduleWorkout") { (config: [String: Any], date: [String: Any]) async throws -> [String: Any] in
+            guard #available(iOS 17.0, *) else {
+                throw Exception(name: "Unavailable", description: workoutKitUnavailableMessage)
+            }
+
             let workout = try self.buildCustomWorkout(from: config)
             try self.validateCustomWorkout(workout)
 
             let plan = WorkoutPlan(.custom(workout))
-
             let dateComponents = self.parseDateComponents(from: date)
 
-            do {
-                try await WorkoutScheduler.shared.schedule(plan, at: dateComponents)
-                return [
-                    "success": true,
-                    "id": plan.id.uuidString
-                ]
-            } catch {
-                throw Exception(name: "ScheduleError", description: error.localizedDescription)
-            }
+            await WorkoutScheduler.shared.schedule(plan, at: dateComponents)
+            return [
+                "success": true,
+                "id": plan.id.uuidString
+            ]
         }
 
         AsyncFunction("getScheduledWorkouts") { () async throws -> [[String: Any]] in
+            guard #available(iOS 17.0, *) else {
+                throw Exception(name: "Unavailable", description: workoutKitUnavailableMessage)
+            }
+
             let workouts = await WorkoutScheduler.shared.scheduledWorkouts
-            return workouts.map { plan in
+            return workouts.map { scheduled in
                 return [
-                    "id": plan.plan.id.uuidString,
-                    "date": self.dateComponentsToDict(plan.date)
+                    "id": scheduled.plan.id.uuidString,
+                    "date": self.dateComponentsToDict(scheduled.date)
                 ]
             }
         }
 
         AsyncFunction("removeScheduledWorkout") { (id: String) async throws -> Bool in
+            guard #available(iOS 17.0, *) else {
+                throw Exception(name: "Unavailable", description: workoutKitUnavailableMessage)
+            }
+
             guard let uuid = UUID(uuidString: id) else {
                 throw Exception(name: "InvalidID", description: "Invalid workout ID format")
             }
@@ -276,27 +342,26 @@ public class ReactNativeWorkoutsModule: Module {
                 throw Exception(name: "NotFound", description: "Workout not found")
             }
 
-            do {
-                try await WorkoutScheduler.shared.remove(workout.plan, at: workout.date)
-                return true
-            } catch {
-                throw Exception(name: "RemoveError", description: error.localizedDescription)
-            }
+            await WorkoutScheduler.shared.remove(workout.plan, at: workout.date)
+            return true
         }
 
         AsyncFunction("removeAllScheduledWorkouts") { () async throws -> Bool in
-            do {
-                try await WorkoutScheduler.shared.removeAllWorkouts()
-            } catch {
-                throw Exception(name: "RemoveError", description: error.localizedDescription)
+            guard #available(iOS 17.0, *) else {
+                throw Exception(name: "Unavailable", description: workoutKitUnavailableMessage)
             }
 
+            await WorkoutScheduler.shared.removeAllWorkouts()
             return true
         }
 
         // MARK: - Single Goal Workout
 
         AsyncFunction("createSingleGoalWorkout") { (config: [String: Any]) throws -> [String: Any] in
+            guard #available(iOS 17.0, *) else {
+                throw Exception(name: "Unavailable", description: workoutKitUnavailableMessage)
+            }
+
             guard let activityTypeStr = config["activityType"] as? String,
                   let activity = self.parseActivityType(activityTypeStr),
                   let goalConfig = config["goal"] as? [String: Any] else {
@@ -318,6 +383,10 @@ public class ReactNativeWorkoutsModule: Module {
         }
 
         AsyncFunction("scheduleSingleGoalWorkout") { (config: [String: Any], date: [String: Any]) async throws -> [String: Any] in
+            guard #available(iOS 17.0, *) else {
+                throw Exception(name: "Unavailable", description: workoutKitUnavailableMessage)
+            }
+
             guard let activityTypeStr = config["activityType"] as? String,
                   let activity = self.parseActivityType(activityTypeStr),
                   let goalConfig = config["goal"] as? [String: Any] else {
@@ -326,7 +395,6 @@ public class ReactNativeWorkoutsModule: Module {
 
             let goal = try self.parseWorkoutGoal(from: goalConfig)
             let location = self.parseLocationType(config["locationType"] as? String ?? "outdoor") ?? .outdoor
-            _ = config["displayName"] as? String
 
             guard SingleGoalWorkout.supportsGoal(goal, activity: activity, location: location) else {
                 throw Exception(name: "ValidationError", description: "Single goal workout not supported for this activity/location/goal")
@@ -336,21 +404,20 @@ public class ReactNativeWorkoutsModule: Module {
             let plan = WorkoutPlan(.goal(workout))
 
             let dateComponents = self.parseDateComponents(from: date)
-
-            do {
-                try await WorkoutScheduler.shared.schedule(plan, at: dateComponents)
-                return [
-                    "success": true,
-                    "id": plan.id.uuidString
-                ]
-            } catch {
-                throw Exception(name: "ScheduleError", description: error.localizedDescription)
-            }
+            await WorkoutScheduler.shared.schedule(plan, at: dateComponents)
+            return [
+                "success": true,
+                "id": plan.id.uuidString
+            ]
         }
 
         // MARK: - Pacer Workout
 
         AsyncFunction("createPacerWorkout") { (config: [String: Any]) throws -> [String: Any] in
+            guard #available(iOS 17.0, *) else {
+                throw Exception(name: "Unavailable", description: workoutKitUnavailableMessage)
+            }
+
             guard let activityTypeStr = config["activityType"] as? String,
                   let activity = self.parseActivityType(activityTypeStr),
                   let targetConfig = config["target"] as? [String: Any] else {
@@ -370,6 +437,10 @@ public class ReactNativeWorkoutsModule: Module {
         }
 
         AsyncFunction("schedulePacerWorkout") { (config: [String: Any], date: [String: Any]) async throws -> [String: Any] in
+            guard #available(iOS 17.0, *) else {
+                throw Exception(name: "Unavailable", description: workoutKitUnavailableMessage)
+            }
+
             guard let activityTypeStr = config["activityType"] as? String,
                   let activity = self.parseActivityType(activityTypeStr),
                   let targetConfig = config["target"] as? [String: Any] else {
@@ -377,23 +448,17 @@ public class ReactNativeWorkoutsModule: Module {
             }
 
             let location = self.parseLocationType(config["locationType"] as? String ?? "outdoor") ?? .outdoor
-            _ = config["displayName"] as? String
 
             let (distance, time) = try self.parsePacerDistanceAndTime(from: targetConfig)
             let workout = PacerWorkout(activity: activity, location: location, distance: distance, time: time)
             let plan = WorkoutPlan(.pacer(workout))
 
             let dateComponents = self.parseDateComponents(from: date)
-
-            do {
-                try await WorkoutScheduler.shared.schedule(plan, at: dateComponents)
-                return [
-                    "success": true,
-                    "id": plan.id.uuidString
-                ]
-            } catch {
-                throw Exception(name: "ScheduleError", description: error.localizedDescription)
-            }
+            await WorkoutScheduler.shared.schedule(plan, at: dateComponents)
+            return [
+                "success": true,
+                "id": plan.id.uuidString
+            ]
         }
 
         // MARK: - Activity Types
@@ -443,6 +508,7 @@ public class ReactNativeWorkoutsModule: Module {
 
     // MARK: - Helper Methods
 
+    @available(iOS 17.0, *)
     private func authorizationStateToString(_ state: WorkoutScheduler.AuthorizationState) -> String {
         switch state {
         case .authorized:
@@ -451,7 +517,7 @@ public class ReactNativeWorkoutsModule: Module {
             return "notDetermined"
         case .denied:
             return "denied"
-        @unknown default:
+        default:
             return "unknown"
         }
     }
@@ -531,6 +597,7 @@ public class ReactNativeWorkoutsModule: Module {
         }
     }
 
+    @available(iOS 17.0, *)
     private func parseGoalTypeForValidation(_ type: String) -> WorkoutGoal? {
         switch type.lowercased() {
         case "open": return .open
@@ -541,6 +608,7 @@ public class ReactNativeWorkoutsModule: Module {
         }
     }
 
+    @available(iOS 17.0, *)
     private func parseWorkoutGoal(from config: [String: Any]) throws -> WorkoutGoal {
         guard let type = config["type"] as? String else {
             throw Exception(name: "InvalidGoal", description: "Goal type is required")
@@ -671,6 +739,7 @@ public class ReactNativeWorkoutsModule: Module {
         }
     }
 
+    @available(iOS 17.0, *)
     private func parseStepPurpose(_ purpose: String) -> IntervalStep.Purpose {
         switch purpose.lowercased() {
         case "work": return .work
@@ -679,7 +748,8 @@ public class ReactNativeWorkoutsModule: Module {
         }
     }
 
-    private func parseWorkoutAlert(from config: [String: Any]) throws -> WorkoutAlert? {
+    @available(iOS 17.0, *)
+    private func parseWorkoutAlert(from config: [String: Any]) throws -> (any WorkoutAlert)? {
         guard let type = config["type"] as? String else {
             return nil
         }
@@ -730,7 +800,8 @@ public class ReactNativeWorkoutsModule: Module {
         return nil
     }
 
-    private func paceRangeAlert(minMinutesPerUnit: Double, maxMinutesPerUnit: Double, unit: UnitLength) throws -> WorkoutAlert? {
+    @available(iOS 17.0, *)
+    private func paceRangeAlert(minMinutesPerUnit: Double, maxMinutesPerUnit: Double, unit: UnitLength) throws -> (any WorkoutAlert)? {
         guard minMinutesPerUnit > 0, maxMinutesPerUnit > 0 else {
             throw Exception(name: "InvalidAlert", description: "Pace min/max must be > 0")
         }
@@ -746,6 +817,7 @@ public class ReactNativeWorkoutsModule: Module {
         return SpeedRangeAlert.speed(lowSpeed...highSpeed, unit: .metersPerSecond)
     }
 
+    @available(iOS 17.0, *)
     private func validateCustomWorkout(_ workout: CustomWorkout) throws {
         let activity = workout.activity
         let location = workout.location
@@ -775,6 +847,7 @@ public class ReactNativeWorkoutsModule: Module {
         }
     }
 
+    @available(iOS 17.0, *)
     private func buildCustomWorkout(from config: [String: Any]) throws -> CustomWorkout {
         guard let activityTypeStr = config["activityType"] as? String,
               let activity = self.parseActivityType(activityTypeStr) else {
@@ -812,6 +885,7 @@ public class ReactNativeWorkoutsModule: Module {
         )
     }
 
+    @available(iOS 17.0, *)
     private func parseWorkoutStep(from config: [String: Any]) throws -> WorkoutStep {
         let goalConfig = config["goal"] as? [String: Any]
         let goal: WorkoutGoal
@@ -831,6 +905,7 @@ public class ReactNativeWorkoutsModule: Module {
         return step
     }
 
+    @available(iOS 17.0, *)
     private func parseIntervalStep(from config: [String: Any]) throws -> IntervalStep {
         let purposeStr = config["purpose"] as? String ?? "work"
         let purpose = self.parseStepPurpose(purposeStr)
@@ -848,6 +923,7 @@ public class ReactNativeWorkoutsModule: Module {
         return step
     }
 
+    @available(iOS 17.0, *)
     private func parseIntervalBlock(from config: [String: Any]) throws -> IntervalBlock {
         var block = IntervalBlock()
 
@@ -915,11 +991,8 @@ public class ReactNativeWorkoutsModule: Module {
 // MARK: - Workout Preview presentation helpers
 
 @MainActor
+@available(iOS 17.0, *)
 fileprivate func presentWorkoutPreview(_ plan: WorkoutPlan) async throws {
-    guard #available(iOS 17.0, *) else {
-        throw Exception(name: "Unavailable", description: "Workout preview requires iOS 17+")
-    }
-
     guard let viewController = topMostViewController() else {
         throw Exception(name: "NoViewController", description: "Unable to find a view controller to present from")
     }
@@ -932,9 +1005,27 @@ fileprivate func presentWorkoutPreview(_ plan: WorkoutPlan) async throws {
 }
 
 fileprivate func topMostViewController() -> UIViewController? {
-    let scenes = UIApplication.shared.connectedScenes
-    let windowScene = scenes.first { $0.activationState == .foregroundActive } as? UIWindowScene
-    let keyWindow = windowScene?.windows.first(where: { $0.isKeyWindow }) ?? windowScene?.windows.first
+    // React Native / Expo apps can temporarily be in `.foregroundInactive` during transitions.
+    // Also, `isKeyWindow` isn't always set early, so we fall back to a normal-level window.
+    let windowScenes = UIApplication.shared.connectedScenes
+        .compactMap { $0 as? UIWindowScene }
+        .filter { scene in
+            switch scene.activationState {
+            case .foregroundActive, .foregroundInactive:
+                return true
+            default:
+                return false
+            }
+        }
+
+    let candidateWindows = windowScenes.flatMap { $0.windows }
+    let keyWindow =
+        candidateWindows.first(where: { $0.isKeyWindow }) ??
+        candidateWindows.first(where: { $0.windowLevel == .normal }) ??
+        candidateWindows.first ??
+        UIApplication.shared.windows.first(where: { $0.isKeyWindow }) ??
+        UIApplication.shared.windows.first
+
     guard let root = keyWindow?.rootViewController else { return nil }
     return topMostViewController(from: root)
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "react-native-workouts",
-  "version": "0.2.1",
+  "version": "0.2.3",
   "description": "React Native Expo module for Apple WorkoutKit - create, preview, and sync custom workouts to Apple Watch",
   "main": "build/index.js",
   "types": "build/index.d.ts",
@@ -46,9 +46,7 @@
   "engines": {
     "node": ">=18"
   },
-  "dependencies": {
-    "expo-build-properties": "~1.0.10"
-  },
+  "dependencies": {},
   "devDependencies": {
     "@types/react": "~19.1.0",
     "expo": "^54.0.27",

package/src/ReactNativeWorkoutsModule.ts

@@ -7,11 +7,11 @@ import type {
   DateComponents,
   LocationType,
   PacerWorkoutConfig,
-  SwimBikeRunWorkoutConfig,
   ReactNativeWorkoutsModuleEvents,
   ScheduledWorkout,
   ScheduleResult,
   SingleGoalWorkoutConfig,
+  SwimBikeRunWorkoutConfig,
   WorkoutPlan,
   WorkoutValidationResult,
 } from "./ReactNativeWorkouts.types";
@@ -59,7 +59,7 @@ declare class ReactNativeWorkoutsModule
   /**
    * Schedules a custom workout (syncs it to the Apple Watch Workout app).
    *
-   * Prefer using `createCustomWorkoutPlan(...)` + `plan.scheduleAndSync(...)` for new code.
+   * Prefer using `useCustomWorkout(...)` + `plan.scheduleAndSync(...)` for new code.
    */
   scheduleWorkout(
     config: CustomWorkoutConfig,
@@ -80,7 +80,7 @@ declare class ReactNativeWorkoutsModule
   /**
    * Schedules a single-goal workout (syncs it to the Apple Watch Workout app).
    *
-   * Prefer using `createSingleGoalWorkoutPlan(...)` + `plan.scheduleAndSync(...)` for new code.
+   * Prefer using `useSingleGoalWorkout(...)` + `plan.scheduleAndSync(...)` for new code.
    */
   scheduleSingleGoalWorkout(
     config: SingleGoalWorkoutConfig,
@@ -101,7 +101,7 @@ declare class ReactNativeWorkoutsModule
   /**
    * Schedules a pacer workout (syncs it to the Apple Watch Workout app).
    *
-   * Prefer using `createPacerWorkoutPlan(...)` + `plan.scheduleAndSync(...)` for new code.
+   * Prefer using `usePacerWorkout(...)` + `plan.scheduleAndSync(...)` for new code.
    */
   schedulePacerWorkout(
     config: PacerWorkoutConfig,