@nativesquare/soma 0.1.0

package/dist/component/schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../src/component/schema.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAwBA,wBA0FG"}

package/dist/component/schema.js

@@ -0,0 +1,106 @@
+import { defineSchema, defineTable } from "convex/server";
+import { v } from "convex/values";
+import { connectionValidator } from "./validators/connection.js";
+import { athleteValidator } from "./validators/athlete.js";
+import { activityValidator } from "./validators/activity.js";
+import { bodyValidator } from "./validators/body.js";
+import { dailyValidator } from "./validators/daily.js";
+import { sleepValidator } from "./validators/sleep.js";
+import { menstruationValidator } from "./validators/menstruation.js";
+import { nutritionValidator } from "./validators/nutrition.js";
+import { plannedWorkoutValidator } from "./validators/plannedWorkout.js";
+// ─── Soma Schema ─────────────────────────────────────────────────────────────
+// Provider-agnostic normalized health data store.
+// Uses Terra's data model as the schema standard, but has no opinion about
+// where data comes from. The host app handles authentication and data fetching.
+//
+// Deduplication strategy:
+//   - Activity & Sleep: uniquely identified by connectionId + metadata.summary_id
+//   - Body, Daily, Nutrition: uniquely identified by connectionId + start_time + end_time
+//   - On duplicate, update the existing document with new data.
+//
+// All fields are nullable (v.optional) unless explicitly marked otherwise.
+export default defineSchema({
+    // ── Connections ────────────────────────────────────────────────────────────
+    // Represents a link between a host app user and a wearable provider.
+    // One document per user-provider pair.
+    connections: defineTable(connectionValidator)
+        .index("by_userId", ["userId"])
+        .index("by_provider", ["provider"])
+        .index("by_userId_provider", ["userId", "provider"]),
+    // ── Athletes ───────────────────────────────────────────────────────────────
+    // User profile/identifying information from the provider.
+    athletes: defineTable(athleteValidator)
+        .index("by_connectionId", ["connectionId"])
+        .index("by_userId", ["userId"]),
+    // ── Activities ─────────────────────────────────────────────────────────────
+    // Workouts and activities.
+    // Dedup key: connectionId + metadata.summary_id
+    activities: defineTable(activityValidator)
+        .index("by_connectionId", ["connectionId"])
+        .index("by_userId", ["userId"])
+        .index("by_userId_startTime", ["userId", "metadata.start_time"])
+        .index("by_connectionId_summaryId", [
+        "connectionId",
+        "metadata.summary_id",
+    ]),
+    // ── Body ───────────────────────────────────────────────────────────────────
+    // Body metrics: heart, blood pressure, glucose, temperature, etc.
+    // Dedup key: connectionId + metadata.start_time + metadata.end_time
+    body: defineTable(bodyValidator)
+        .index("by_connectionId", ["connectionId"])
+        .index("by_userId", ["userId"])
+        .index("by_userId_startTime", ["userId", "metadata.start_time"])
+        .index("by_connectionId_timeRange", [
+        "connectionId",
+        "metadata.start_time",
+        "metadata.end_time",
+    ]),
+    // ── Daily ──────────────────────────────────────────────────────────────────
+    // Daily activity summaries.
+    // Dedup key: connectionId + metadata.start_time + metadata.end_time
+    daily: defineTable(dailyValidator)
+        .index("by_connectionId", ["connectionId"])
+        .index("by_userId", ["userId"])
+        .index("by_userId_startTime", ["userId", "metadata.start_time"])
+        .index("by_connectionId_timeRange", [
+        "connectionId",
+        "metadata.start_time",
+        "metadata.end_time",
+    ]),
+    // ── Sleep ──────────────────────────────────────────────────────────────────
+    // Sleep session data.
+    // Dedup key: connectionId + metadata.summary_id
+    sleep: defineTable(sleepValidator)
+        .index("by_connectionId", ["connectionId"])
+        .index("by_userId", ["userId"])
+        .index("by_userId_startTime", ["userId", "metadata.start_time"])
+        .index("by_connectionId_summaryId", [
+        "connectionId",
+        "metadata.summary_id",
+    ]),
+    // ── Menstruation ───────────────────────────────────────────────────────────
+    // Menstruation and fertility data.
+    menstruation: defineTable(menstruationValidator)
+        .index("by_connectionId", ["connectionId"])
+        .index("by_userId", ["userId"]),
+    // ── Nutrition ──────────────────────────────────────────────────────────────
+    // Food, drink, macro/micronutrient data.
+    // Dedup key: connectionId + metadata.start_time + metadata.end_time
+    nutrition: defineTable(nutritionValidator)
+        .index("by_connectionId", ["connectionId"])
+        .index("by_userId", ["userId"])
+        .index("by_userId_startTime", ["userId", "metadata.start_time"])
+        .index("by_connectionId_timeRange", [
+        "connectionId",
+        "metadata.start_time",
+        "metadata.end_time",
+    ]),
+    // ── Planned Workouts ───────────────────────────────────────────────────────
+    // Scheduled/planned workouts from the provider.
+    plannedWorkouts: defineTable(plannedWorkoutValidator)
+        .index("by_connectionId", ["connectionId"])
+        .index("by_userId", ["userId"])
+        .index("by_userId_plannedDate", ["userId", "metadata.planned_date"]),
+});
+//# sourceMappingURL=schema.js.map

package/dist/component/schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../src/component/schema.ts"],"names":[],"mappings":"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"}