mirror of
https://github.com/MBombeck/HealthLog.git
synced 2026-11-16 23:33:29 +00:00
feat(fitbit): add the Fitbit connection data model and FITBIT measurement source
Lay the data-model foundation for the Fitbit/Pixel integration over the Google Health API, mirroring the WHOOP provider. No OAuth, sync, or UI yet. - Prisma: FitbitConnection (1:1 per user, encrypted access/refresh tokens) and FitbitOAuthState models, two encrypted BYO-credential columns on User, and FITBIT appended to the MeasurementSource enum. Migration 0117_v1120_fitbit_integration is additive only — one enum value plus two tables and two nullable columns, no new MeasurementType (every launch metric maps onto an existing type). - Wire the two new encrypted columns and the FitbitConnection token columns into scripts/rotate-encryption-key.ts. - FITBIT touchpoints: the read measurementSourceEnum (not the writable set), the DEFAULT_SOURCE_PRIORITY and workout-source ladders, the sources-section label map, the IntegrationKey union plus its display name, and a fitbit()/fitbitStatus() query-key pair. The source-rank SQL and read-tier collapse pick FITBIT up from the ladders with no code change. - Add the FITBIT source label to all six locale bundles and regenerate the OpenAPI contract so the source enum carries FITBIT for the iOS decoder.
This commit is contained in:
1 parent
045da70133
commit
86b2774567
18 files changed
+368
-20
No files matched your search
@@ -0,0 +1,83 @@
|
||||
-- v1.12.0 — Fitbit/Pixel integration via the Google Health API (schema + data
|
||||
-- layer).
|
||||
--
|
||||
-- Purely-additive: one enum-extension, two new tables, and two new nullable
|
||||
-- columns on `users`. No backfill, no existing row touched. Unlike the WHOOP
|
||||
-- migration (0111) this adds NO new `measurement_type` values — every Fitbit
|
||||
-- launch metric maps onto an existing type.
|
||||
--
|
||||
-- 1. `measurement_source` += `FITBIT` for the server-side native ingest.
|
||||
-- 2. `fitbit_connections` — per-user encrypted token row (1:1 with users),
|
||||
-- mirroring `whoop_connections` minus `max_heart_rate`, plus
|
||||
-- `fitbit_user_id` and `backfill_completed_at`.
|
||||
-- 3. `fitbit_oauth_states` — short-lived `(nonce → userId)` CSRF ledger,
|
||||
-- identical in shape to `whoop_oauth_states`.
|
||||
-- 4. `users` += `fitbit_client_id_encrypted` / `fitbit_client_secret_encrypted`
|
||||
-- — per-user BYO-keys (Google's Testing-mode per-app authorized-user cap
|
||||
-- makes a single shared client unworkable for a multi-operator product).
|
||||
--
|
||||
-- Idempotent guards (`IF NOT EXISTS`) make reruns safe. Forward-only.
|
||||
--
|
||||
-- Reversibility: Postgres cannot remove an enum value, so `FITBIT` stays; with
|
||||
-- no rows carrying it it is inert. The two tables drop with `DROP TABLE IF
|
||||
-- EXISTS`, the two columns with `DROP COLUMN IF EXISTS`.
|
||||
|
||||
-- ── 1. measurement_source — append the Fitbit server-owned source ──────
|
||||
ALTER TYPE "measurement_source" ADD VALUE IF NOT EXISTS 'FITBIT';
|
||||
|
||||
-- ── 2. fitbit_connections ─────────────────────────────────────────────
|
||||
CREATE TABLE IF NOT EXISTS "fitbit_connections" (
|
||||
"id" TEXT NOT NULL,
|
||||
"user_id" TEXT NOT NULL,
|
||||
"fitbit_user_id" TEXT NOT NULL,
|
||||
"access_token" TEXT NOT NULL,
|
||||
"refresh_token" TEXT NOT NULL,
|
||||
"token_expires_at" TIMESTAMP(3) NOT NULL,
|
||||
"scope" TEXT,
|
||||
"last_synced_at" TIMESTAMP(3),
|
||||
"backfill_completed_at" TIMESTAMP(3),
|
||||
"created_at" TIMESTAMP(3) NOT NULL DEFAULT CURRENT_TIMESTAMP,
|
||||
"updated_at" TIMESTAMP(3) NOT NULL,
|
||||
|
||||
CONSTRAINT "fitbit_connections_pkey" PRIMARY KEY ("id")
|
||||
);
|
||||
|
||||
CREATE UNIQUE INDEX IF NOT EXISTS "fitbit_connections_user_id_key"
|
||||
ON "fitbit_connections" ("user_id");
|
||||
|
||||
DO $$ BEGIN
|
||||
ALTER TABLE "fitbit_connections"
|
||||
ADD CONSTRAINT "fitbit_connections_user_id_fkey"
|
||||
FOREIGN KEY ("user_id") REFERENCES "users"("id")
|
||||
ON DELETE CASCADE ON UPDATE CASCADE;
|
||||
EXCEPTION
|
||||
WHEN duplicate_object THEN NULL;
|
||||
END $$;
|
||||
|
||||
-- ── 3. fitbit_oauth_states ────────────────────────────────────────────
|
||||
CREATE TABLE IF NOT EXISTS "fitbit_oauth_states" (
|
||||
"nonce" TEXT NOT NULL,
|
||||
"user_id" TEXT NOT NULL,
|
||||
"created_at" TIMESTAMP(3) NOT NULL DEFAULT CURRENT_TIMESTAMP,
|
||||
"expires_at" TIMESTAMP(3) NOT NULL,
|
||||
|
||||
CONSTRAINT "fitbit_oauth_states_pkey" PRIMARY KEY ("nonce")
|
||||
);
|
||||
|
||||
CREATE INDEX IF NOT EXISTS "fitbit_oauth_states_expires_at_idx"
|
||||
ON "fitbit_oauth_states" ("expires_at");
|
||||
|
||||
DO $$ BEGIN
|
||||
ALTER TABLE "fitbit_oauth_states"
|
||||
ADD CONSTRAINT "fitbit_oauth_states_user_id_fkey"
|
||||
FOREIGN KEY ("user_id") REFERENCES "users"("id")
|
||||
ON DELETE CASCADE ON UPDATE CASCADE;
|
||||
EXCEPTION
|
||||
WHEN duplicate_object THEN NULL;
|
||||
END $$;
|
||||
|
||||
-- ── 4. users — per-user Fitbit BYO-key columns (encrypted at app level) ─
|
||||
ALTER TABLE "users"
|
||||
ADD COLUMN IF NOT EXISTS "fitbit_client_id_encrypted" TEXT;
|
||||
ALTER TABLE "users"
|
||||
ADD COLUMN IF NOT EXISTS "fitbit_client_secret_encrypted" TEXT;
|
||||
@@ -66,6 +66,14 @@ model User {
|
||||
whoopClientIdEncrypted String? @map("whoop_client_id_encrypted")
|
||||
whoopClientSecretEncrypted String? @map("whoop_client_secret_encrypted")
|
||||
|
||||
// v1.12.0 — Fitbit/Pixel OAuth credentials (per-user BYO-keys, encrypted at
|
||||
// app level) over the Google Health API. The per-app authorized-user cap in
|
||||
// Google's Testing mode makes a single shared client unworkable for a
|
||||
// multi-operator product, so each self-hoster registers their own Google
|
||||
// Cloud OAuth client and pastes the client id/secret into Settings.
|
||||
fitbitClientIdEncrypted String? @map("fitbit_client_id_encrypted")
|
||||
fitbitClientSecretEncrypted String? @map("fitbit_client_secret_encrypted")
|
||||
|
||||
// moodLog integration (per-user, encrypted)
|
||||
moodLogUrlEncrypted String? @map("mood_log_url_encrypted")
|
||||
moodLogApiKeyEncrypted String? @map("mood_log_api_key_encrypted")
|
||||
@@ -340,6 +348,10 @@ model User {
|
||||
// OAuth-state ledger (1:N) relations.
|
||||
whoopConnection WhoopConnection?
|
||||
whoopOAuthStates WhoopOAuthState[]
|
||||
// v1.12.0 — Fitbit/Pixel integration. Mirrors the WHOOP connection (1:1) +
|
||||
// OAuth-state ledger (1:N) relations.
|
||||
fitbitConnection FitbitConnection?
|
||||
fitbitOAuthStates FitbitOAuthState[]
|
||||
moodEntries MoodEntry[]
|
||||
notificationChannels NotificationChannel[]
|
||||
pushSubscriptions PushSubscription[]
|
||||
@@ -672,6 +684,10 @@ enum MeasurementSource {
|
||||
// (no client write path) as `source = WHOOP` rows. iOS DTO mirrors this
|
||||
// exact spelling so the `/api/sync/changes` delta feed decodes the rows.
|
||||
WHOOP
|
||||
// v1.12.0 — Fitbit/Pixel integration via the Google Health API. Server-owned
|
||||
// (no client write path); rejected on batch + single POST like WITHINGS/WHOOP.
|
||||
// iOS DTO mirrors this exact spelling so /api/sync/changes decodes the rows.
|
||||
FITBIT
|
||||
|
||||
@@map("measurement_source")
|
||||
}
|
||||
@@ -1827,6 +1843,47 @@ model WhoopOAuthState {
|
||||
@@map("whoop_oauth_states")
|
||||
}
|
||||
|
||||
/// v1.12.0 — Fitbit/Pixel connection over the Google Health API. Mirrors
|
||||
/// `WhoopConnection` 1:1 per user. Tokens are encrypted at the app level
|
||||
/// before persistence. Unlike WHOOP, Google refresh tokens do not rotate per
|
||||
/// use, so `refreshToken` is overwritten only when a token response carries a
|
||||
/// fresh one.
|
||||
model FitbitConnection {
|
||||
id String @id @default(cuid())
|
||||
userId String @unique @map("user_id")
|
||||
fitbitUserId String @map("fitbit_user_id") // Google/Fitbit external id
|
||||
accessToken String @map("access_token") // encrypted at app level
|
||||
refreshToken String @map("refresh_token") // encrypted at app level
|
||||
tokenExpiresAt DateTime @map("token_expires_at")
|
||||
/// Space-separated OAuth scope string granted by the Google authorisation
|
||||
/// flow. Null = legacy connection that predates scope tracking.
|
||||
scope String? @map("scope")
|
||||
lastSyncedAt DateTime? @map("last_synced_at")
|
||||
/// Set once the self-converging history backfill walks every collection to
|
||||
/// completion. Null = backfill still in flight (or never started).
|
||||
backfillCompletedAt DateTime? @map("backfill_completed_at")
|
||||
createdAt DateTime @default(now()) @map("created_at")
|
||||
updatedAt DateTime @updatedAt @map("updated_at")
|
||||
|
||||
user User @relation(fields: [userId], references: [id], onDelete: Cascade)
|
||||
|
||||
@@map("fitbit_connections")
|
||||
}
|
||||
|
||||
/// v1.12.0 — short-lived `(nonce → userId)` ledger backing the Fitbit OAuth
|
||||
/// state check, identical in shape + lifecycle to `WhoopOAuthState`.
|
||||
model FitbitOAuthState {
|
||||
nonce String @id
|
||||
userId String @map("user_id")
|
||||
createdAt DateTime @default(now()) @map("created_at")
|
||||
expiresAt DateTime @map("expires_at")
|
||||
|
||||
user User @relation(fields: [userId], references: [id], onDelete: Cascade)
|
||||
|
||||
@@index([expiresAt])
|
||||
@@map("fitbit_oauth_states")
|
||||
}
|
||||
|
||||
// ─── Mood Entries (moodLog) ───────────────────────────────────
|
||||
|
||||
model MoodEntry {
|
||||
|
||||
Reference in new issue
Block a user