health-sync 0.2.4 → 0.3.0

package/README.md

@@ -16,6 +16,7 @@ It is designed as a personal data cache: first sync backfills history, then futu
 - Withings (Advanced Health Data API, OAuth2)
 - Hevy (public API, API key, Pro account required)
 - Strava (OAuth2 or static access token)
+- WHOOP (OAuth2)
 - Eight Sleep (unofficial API)
 
 ## Requirements
@@ -41,31 +42,32 @@ npm link
 
 ## Quick Start
 
-1. Initialize config and DB:
+1. Initialize config and DB, then follow the interactive provider onboarding wizard:
 
 ```bash
 health-sync init
 ```
 
-2. Edit `health-sync.toml`:
-- Set `[app].db` if you do not want `./health.sqlite`
+The wizard lets you:
+- see all discovered providers in a checklist
+- pick which providers to set up now
+- get provider-specific setup URLs and callback values
+- enter credentials directly into `health-sync.toml`
+- run auth flows and save tokens in `.health-sync.creds`
 
-3. Run provider auth one provider at a time:
+2. (Optional) re-run auth for a single provider later:
 
 ```bash
 health-sync auth oura
-health-sync auth withings
-health-sync auth strava
-health-sync auth eightsleep
 ```
 
-4. Sync data:
+3. Sync data:
 
 ```bash
 health-sync sync
 ```
 
-5. Inspect sync state and counts:
+4. Inspect sync state and counts:
 
 ```bash
 health-sync status
@@ -95,14 +97,14 @@ api_key = "YOUR_HEVY_API_KEY"
 enabled = true
 client_id = "YOUR_CLIENT_ID"
 client_secret = "YOUR_CLIENT_SECRET"
-redirect_uri = "http://127.0.0.1:8486/callback"
+redirect_uri = "http://localhost:8486/callback"
 ```
 
 See `health-sync.example.toml` for all provider options.
 
 ## CLI Commands
 
-- `health-sync init`: create a scaffolded config (from `health-sync.example.toml`) and create DB tables
+- `health-sync init`: create a scaffolded config (from `health-sync.example.toml`), create DB tables, and launch interactive provider setup when running in a TTY
 - `health-sync init-db`: create DB tables only (legacy)
 - `health-sync auth <provider>`: run auth flow for one provider/plugin
 - `health-sync sync`: run sync for all enabled providers
@@ -112,7 +114,7 @@ See `health-sync.example.toml` for all provider options.
 
 `auth` notes:
 
-- Oura, Withings, and Strava: OAuth flow (CLI prints auth URL and waits for callback URL/code).
+- Oura, Withings, Strava, and WHOOP: OAuth flow (CLI prints auth URL and waits for callback URL/code).
 - Eight Sleep: username/password grant (or static token).
 - Hevy: no `auth` command; configure `[hevy].api_key` directly.
 

package/health-sync.example.toml

@@ -39,7 +39,7 @@ enabled = false
 # OAuth2
 # client_id = "..."
 # client_secret = "..."
-# redirect_uri = "http://127.0.0.1:8485/callback"
+# redirect_uri = "http://localhost:8485/callback"
 # scopes = "user.metrics,user.activity"
 #
 # Sync tuning:
@@ -73,7 +73,7 @@ enabled = false
 # Option B: OAuth2 (recommended)
 # client_id = "..."
 # client_secret = "..."
-# redirect_uri = "http://127.0.0.1:8486/callback"
+# redirect_uri = "http://localhost:8486/callback"
 # scopes = "read,activity:read_all"
 # approval_prompt = "auto"
 #
@@ -82,6 +82,28 @@ enabled = false
 # overlap_seconds = 604800    # 7 days
 # page_size = 100             # 1-200
 
+[whoop]
+# Set to true to sync this provider.
+enabled = false
+
+# OAuth2
+# client_id = "..."
+# client_secret = "..."
+# redirect_uri = "http://localhost:8487/callback"
+#
+# WHOOP OAuth and API endpoints:
+# authorize_url = "https://api.prod.whoop.com/oauth/oauth2/auth"
+# token_url = "https://api.prod.whoop.com/oauth/oauth2/token"
+# api_base_url = "https://api.prod.whoop.com/developer"
+#
+# Include `offline` to receive refresh tokens.
+# scopes = "offline read:recovery read:cycles read:workout read:sleep read:profile read:body_measurement"
+#
+# Sync tuning:
+# start_date = "2010-01-01"  # YYYY-MM-DD
+# overlap_days = 7
+# page_size = 25             # 1-25
+
 [eightsleep]
 # Set to true to sync this provider.
 enabled = false

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "health-sync",
-  "version": "0.2.4",
+  "version": "0.3.0",
   "type": "module",
   "description": "Node.js port of health-sync",
   "files": [
@@ -22,7 +22,9 @@
   },
   "dependencies": {
     "@iarna/toml": "^2.2.5",
-    "better-sqlite3": "^11.9.1"
+    "@mariozechner/pi-tui": "^0.53.0",
+    "better-sqlite3": "^11.9.1",
+    "chalk": "^5.6.2"
   },
   "engines": {
     "node": ">=20"