@clipin/convex-wearables 0.0.1

package/dist/component/httpHandlers.js

@@ -0,0 +1,131 @@
+/**
+ * HTTP action handlers for OAuth callbacks and provider webhooks.
+ *
+ * These are Convex httpAction endpoints that handle:
+ * 1. OAuth callback redirects (GET /oauth/callback)
+ * 2. Provider webhook pushes (POST /webhooks/:provider)
+ */
+import { internal } from "./_generated/api";
+import { httpAction } from "./_generated/server";
+// ---------------------------------------------------------------------------
+// OAuth callback handler
+// ---------------------------------------------------------------------------
+/**
+ * Handles the OAuth redirect callback from a provider.
+ *
+ * Expected query params:
+ *   - state: The OAuth state token
+ *   - code: The authorization code
+ *
+ * The host app must mount this at a route and pass client credentials
+ * via the component configuration.
+ */
+export const oauthCallback = httpAction(async (ctx, request) => {
+    const url = new URL(request.url);
+    const state = url.searchParams.get("state");
+    const code = url.searchParams.get("code");
+    const error = url.searchParams.get("error");
+    if (error) {
+        return new Response(JSON.stringify({ error: `OAuth error: ${error}` }), {
+            status: 400,
+            headers: { "Content-Type": "application/json" },
+        });
+    }
+    if (!state || !code) {
+        return new Response(JSON.stringify({ error: "Missing state or code parameter" }), {
+            status: 400,
+            headers: { "Content-Type": "application/json" },
+        });
+    }
+    // Look up the state to find which provider and user this is for
+    const oauthState = await ctx.runQuery(internal.oauthStates.getByState, {
+        state,
+    });
+    if (!oauthState) {
+        return new Response(JSON.stringify({ error: "Invalid or expired OAuth state" }), {
+            status: 400,
+            headers: { "Content-Type": "application/json" },
+        });
+    }
+    // Return the state and code to be processed by the client-side handler.
+    // The host app will call handleCallback action with credentials.
+    return new Response(JSON.stringify({
+        state,
+        code,
+        provider: oauthState.provider,
+        userId: oauthState.userId,
+    }), { status: 200, headers: { "Content-Type": "application/json" } });
+});
+// ---------------------------------------------------------------------------
+// Strava webhook verification (GET)
+// ---------------------------------------------------------------------------
+/**
+ * Strava webhook subscription verification.
+ * Strava sends a GET request with hub.challenge to verify the endpoint.
+ */
+export const stravaWebhookVerify = httpAction(async (_ctx, request) => {
+    const url = new URL(request.url);
+    const mode = url.searchParams.get("hub.mode");
+    const challenge = url.searchParams.get("hub.challenge");
+    const _verifyToken = url.searchParams.get("hub.verify_token");
+    if (mode !== "subscribe" || !challenge) {
+        return new Response("Invalid request", { status: 400 });
+    }
+    // The verify token should match what was set during subscription creation.
+    // For now, accept any verify token — the host app should validate this
+    // in their configuration.
+    return new Response(JSON.stringify({ "hub.challenge": challenge }), {
+        status: 200,
+        headers: { "Content-Type": "application/json" },
+    });
+});
+// ---------------------------------------------------------------------------
+// Strava webhook events (POST)
+// ---------------------------------------------------------------------------
+/**
+ * Handles incoming Strava webhook events.
+ *
+ * Strava pushes activity create/update/delete events here.
+ * We process activity creates/updates by fetching the full activity
+ * and storing it. Deletes are handled by removing the corresponding event.
+ */
+export const stravaWebhookEvent = httpAction(async (_ctx, request) => {
+    try {
+        const body = await request.json();
+        // Strava webhook payload format:
+        // { object_type: "activity", object_id: 123, aspect_type: "create"|"update"|"delete",
+        //   owner_id: 456, subscription_id: 789 }
+        const { object_type, object_id, aspect_type, owner_id } = body;
+        if (object_type !== "activity") {
+            // We only handle activity events for now
+            return new Response("OK", { status: 200 });
+        }
+        const ownerId = String(owner_id);
+        const connection = await _ctx.runQuery(internal.connections.getByProviderUser, {
+            provider: "strava",
+            providerUserId: ownerId,
+        });
+        if (!connection) {
+            return new Response("OK", { status: 200 });
+        }
+        if (aspect_type === "delete") {
+            await _ctx.runMutation(internal.events.deleteByExternalId, {
+                externalId: `strava-${object_id}`,
+            });
+            return new Response("OK", { status: 200 });
+        }
+        const now = Date.now();
+        await _ctx.runMutation(internal.syncWorkflow.requestConnectionSync, {
+            connectionId: connection._id,
+            mode: "webhook",
+            triggerSource: `strava:${aspect_type}:${object_id}`,
+            windowStart: now - 30 * 24 * 60 * 60 * 1000,
+            windowEnd: now + 5 * 60 * 1000,
+        });
+        return new Response("OK", { status: 200 });
+    }
+    catch {
+        return new Response("Internal error", { status: 500 });
+    }
+});
+//# sourceMappingURL=httpHandlers.js.map

package/dist/component/httpHandlers.js.map

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

package/dist/component/lifecycle.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Delete ALL data for a user across all component tables.
+ * Used for GDPR compliance and account deletion.
+ *
+ * This is a "best-effort" deletion within a single mutation.
+ * For users with very large amounts of data, the host app should
+ * call this repeatedly or use a workflow.
+ */
+export declare const deleteAllUserData: import("convex/server").RegisteredMutation<"public", {
+    userId: string;
+}, Promise<void>>;
+//# sourceMappingURL=lifecycle.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"lifecycle.d.ts","sourceRoot":"","sources":["../../src/component/lifecycle.ts"],"names":[],"mappings":"AAGA;;;;;;;GAOG;AACH,eAAO,MAAM,iBAAiB;;iBAwE5B,CAAC"}

package/dist/component/lifecycle.js

@@ -0,0 +1,79 @@
+import { v } from "convex/values";
+import { mutation } from "./_generated/server";
+/**
+ * Delete ALL data for a user across all component tables.
+ * Used for GDPR compliance and account deletion.
+ *
+ * This is a "best-effort" deletion within a single mutation.
+ * For users with very large amounts of data, the host app should
+ * call this repeatedly or use a workflow.
+ */
+export const deleteAllUserData = mutation({
+    args: { userId: v.string() },
+    handler: async (ctx, args) => {
+        const { userId } = args;
+        // 1. Delete connections
+        const connections = await ctx.db
+            .query("connections")
+            .withIndex("by_user", (idx) => idx.eq("userId", userId))
+            .collect();
+        for (const conn of connections) {
+            // Delete backfill jobs for this connection
+            const backfills = await ctx.db
+                .query("backfillJobs")
+                .withIndex("by_connection", (idx) => idx.eq("connectionId", conn._id))
+                .collect();
+            for (const bf of backfills) {
+                await ctx.db.delete(bf._id);
+            }
+            await ctx.db.delete(conn._id);
+        }
+        // 2. Delete data sources and their data points
+        const sources = await ctx.db
+            .query("dataSources")
+            .withIndex("by_user_provider", (idx) => idx.eq("userId", userId))
+            .collect();
+        for (const source of sources) {
+            // Delete data points in batches
+            let points = await ctx.db
+                .query("dataPoints")
+                .withIndex("by_source_type_time", (idx) => idx.eq("dataSourceId", source._id))
+                .take(500);
+            while (points.length > 0) {
+                for (const p of points) {
+                    await ctx.db.delete(p._id);
+                }
+                points = await ctx.db
+                    .query("dataPoints")
+                    .withIndex("by_source_type_time", (idx) => idx.eq("dataSourceId", source._id))
+                    .take(500);
+            }
+            await ctx.db.delete(source._id);
+        }
+        // 3. Delete events
+        const events = await ctx.db
+            .query("events")
+            .withIndex("by_user_category_time", (idx) => idx.eq("userId", userId))
+            .collect();
+        for (const event of events) {
+            await ctx.db.delete(event._id);
+        }
+        // 4. Delete daily summaries
+        const summaries = await ctx.db
+            .query("dailySummaries")
+            .withIndex("by_user_date", (idx) => idx.eq("userId", userId))
+            .collect();
+        for (const summary of summaries) {
+            await ctx.db.delete(summary._id);
+        }
+        // 5. Delete sync jobs
+        const jobs = await ctx.db
+            .query("syncJobs")
+            .withIndex("by_user", (idx) => idx.eq("userId", userId))
+            .collect();
+        for (const job of jobs) {
+            await ctx.db.delete(job._id);
+        }
+    },
+});
+//# sourceMappingURL=lifecycle.js.map

package/dist/component/lifecycle.js.map

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

package/dist/component/menstrualCycles.d.ts

@@ -0,0 +1,98 @@
+/**
+ * Get menstrual cycle records for a user within a date range.
+ */
+export declare const getByUserDateRange: import("convex/server").RegisteredQuery<"public", {
+    userId: string;
+    startDate: string;
+    endDate: string;
+}, Promise<{
+    _id: import("convex/values").GenericId<"menstrualCycles">;
+    _creationTime: number;
+    externalId?: string | undefined;
+    currentPhase?: number | undefined;
+    dayInCycle?: number | undefined;
+    cycleLength?: number | undefined;
+    predictedCycleLength?: number | undefined;
+    periodLength?: number | undefined;
+    currentPhaseType?: string | undefined;
+    lengthOfCurrentPhase?: number | undefined;
+    daysUntilNextPhase?: number | undefined;
+    isPredictedCycle?: boolean | undefined;
+    fertileWindowStart?: number | undefined;
+    lengthOfFertileWindow?: number | undefined;
+    lastUpdatedAt?: number | undefined;
+    isPregnant?: boolean | undefined;
+    pregnancyDueDate?: string | undefined;
+    pregnancyOriginalDueDate?: string | undefined;
+    pregnancyCycleStartDate?: string | undefined;
+    pregnancyTitle?: string | undefined;
+    numberOfBabies?: string | undefined;
+    provider: "garmin" | "suunto" | "polar" | "whoop" | "strava" | "apple" | "samsung" | "google";
+    userId: string;
+    periodStartDate: string;
+}[]>>;
+/**
+ * Get the latest menstrual cycle record for a user.
+ */
+export declare const getLatest: import("convex/server").RegisteredQuery<"public", {
+    userId: string;
+}, Promise<{
+    _id: import("convex/values").GenericId<"menstrualCycles">;
+    _creationTime: number;
+    externalId?: string | undefined;
+    currentPhase?: number | undefined;
+    dayInCycle?: number | undefined;
+    cycleLength?: number | undefined;
+    predictedCycleLength?: number | undefined;
+    periodLength?: number | undefined;
+    currentPhaseType?: string | undefined;
+    lengthOfCurrentPhase?: number | undefined;
+    daysUntilNextPhase?: number | undefined;
+    isPredictedCycle?: boolean | undefined;
+    fertileWindowStart?: number | undefined;
+    lengthOfFertileWindow?: number | undefined;
+    lastUpdatedAt?: number | undefined;
+    isPregnant?: boolean | undefined;
+    pregnancyDueDate?: string | undefined;
+    pregnancyOriginalDueDate?: string | undefined;
+    pregnancyCycleStartDate?: string | undefined;
+    pregnancyTitle?: string | undefined;
+    numberOfBabies?: string | undefined;
+    provider: "garmin" | "suunto" | "polar" | "whoop" | "strava" | "apple" | "samsung" | "google";
+    userId: string;
+    periodStartDate: string;
+} | null>>;
+/**
+ * Upsert a menstrual cycle record. Deduplicates by externalId.
+ */
+export declare const upsert: import("convex/server").RegisteredMutation<"internal", {
+    externalId?: string | undefined;
+    currentPhase?: number | undefined;
+    dayInCycle?: number | undefined;
+    cycleLength?: number | undefined;
+    predictedCycleLength?: number | undefined;
+    periodLength?: number | undefined;
+    currentPhaseType?: string | undefined;
+    lengthOfCurrentPhase?: number | undefined;
+    daysUntilNextPhase?: number | undefined;
+    isPredictedCycle?: boolean | undefined;
+    fertileWindowStart?: number | undefined;
+    lengthOfFertileWindow?: number | undefined;
+    lastUpdatedAt?: number | undefined;
+    isPregnant?: boolean | undefined;
+    pregnancyDueDate?: string | undefined;
+    pregnancyOriginalDueDate?: string | undefined;
+    pregnancyCycleStartDate?: string | undefined;
+    pregnancyTitle?: string | undefined;
+    numberOfBabies?: string | undefined;
+    provider: "garmin" | "suunto" | "polar" | "whoop" | "strava" | "apple" | "samsung" | "google";
+    userId: string;
+    periodStartDate: string;
+}, Promise<import("convex/values").GenericId<"menstrualCycles">>>;
+/**
+ * Delete all menstrual cycle data for a user.
+ */
+export declare const deleteByUser: import("convex/server").RegisteredMutation<"internal", {
+    userId: string;
+}, Promise<void>>;
+//# sourceMappingURL=menstrualCycles.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"menstrualCycles.d.ts","sourceRoot":"","sources":["../../src/component/menstrualCycles.ts"],"names":[],"mappings":"AAQA;;GAEG;AACH,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;KAkB7B,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;;;UAUpB,CAAC;AAMH;;GAEG;AACH,eAAO,MAAM,MAAM;;;;;;;;;;;;;;;;;;;;;;;iEAsDjB,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,YAAY;;iBAWvB,CAAC"}

package/dist/component/menstrualCycles.js

@@ -0,0 +1,112 @@
+import { v } from "convex/values";
+import { internalMutation, query } from "./_generated/server";
+import { providerName } from "./schema";
+// ---------------------------------------------------------------------------
+// Queries
+// ---------------------------------------------------------------------------
+/**
+ * Get menstrual cycle records for a user within a date range.
+ */
+export const getByUserDateRange = query({
+    args: {
+        userId: v.string(),
+        startDate: v.string(), // ISO date "2026-01-01"
+        endDate: v.string(),
+    },
+    returns: v.array(v.any()),
+    handler: async (ctx, args) => {
+        return await ctx.db
+            .query("menstrualCycles")
+            .withIndex("by_user_date", (idx) => idx
+            .eq("userId", args.userId)
+            .gte("periodStartDate", args.startDate)
+            .lte("periodStartDate", args.endDate))
+            .collect();
+    },
+});
+/**
+ * Get the latest menstrual cycle record for a user.
+ */
+export const getLatest = query({
+    args: { userId: v.string() },
+    returns: v.any(),
+    handler: async (ctx, args) => {
+        return await ctx.db
+            .query("menstrualCycles")
+            .withIndex("by_user_date", (idx) => idx.eq("userId", args.userId))
+            .order("desc")
+            .first();
+    },
+});
+// ---------------------------------------------------------------------------
+// Mutations
+// ---------------------------------------------------------------------------
+/**
+ * Upsert a menstrual cycle record. Deduplicates by externalId.
+ */
+export const upsert = internalMutation({
+    args: {
+        userId: v.string(),
+        provider: providerName,
+        externalId: v.optional(v.string()),
+        periodStartDate: v.string(),
+        dayInCycle: v.optional(v.number()),
+        cycleLength: v.optional(v.number()),
+        predictedCycleLength: v.optional(v.number()),
+        periodLength: v.optional(v.number()),
+        currentPhase: v.optional(v.number()),
+        currentPhaseType: v.optional(v.string()),
+        lengthOfCurrentPhase: v.optional(v.number()),
+        daysUntilNextPhase: v.optional(v.number()),
+        isPredictedCycle: v.optional(v.boolean()),
+        fertileWindowStart: v.optional(v.number()),
+        lengthOfFertileWindow: v.optional(v.number()),
+        lastUpdatedAt: v.optional(v.number()),
+        isPregnant: v.optional(v.boolean()),
+        pregnancyDueDate: v.optional(v.string()),
+        pregnancyOriginalDueDate: v.optional(v.string()),
+        pregnancyCycleStartDate: v.optional(v.string()),
+        pregnancyTitle: v.optional(v.string()),
+        numberOfBabies: v.optional(v.string()),
+    },
+    returns: v.id("menstrualCycles"),
+    handler: async (ctx, args) => {
+        // Dedup by externalId
+        if (args.externalId) {
+            const existing = await ctx.db
+                .query("menstrualCycles")
+                .withIndex("by_external_id", (idx) => idx.eq("externalId", args.externalId))
+                .first();
+            if (existing) {
+                await ctx.db.patch(existing._id, args);
+                return existing._id;
+            }
+        }
+        // Dedup by user + periodStartDate
+        const existing = await ctx.db
+            .query("menstrualCycles")
+            .withIndex("by_user_date", (idx) => idx.eq("userId", args.userId).eq("periodStartDate", args.periodStartDate))
+            .first();
+        if (existing) {
+            await ctx.db.patch(existing._id, args);
+            return existing._id;
+        }
+        return await ctx.db.insert("menstrualCycles", args);
+    },
+});
+/**
+ * Delete all menstrual cycle data for a user.
+ */
+export const deleteByUser = internalMutation({
+    args: { userId: v.string() },
+    handler: async (ctx, args) => {
+        const records = await ctx.db
+            .query("menstrualCycles")
+            .withIndex("by_user_provider", (idx) => idx.eq("userId", args.userId))
+            .collect();
+        for (const r of records) {
+            await ctx.db.delete(r._id);
+        }
+    },
+});
+//# sourceMappingURL=menstrualCycles.js.map

package/dist/component/menstrualCycles.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"menstrualCycles.js","sourceRoot":"","sources":["../../src/component/menstrualCycles.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,eAAe,CAAC;AAClC,OAAO,EAAE,gBAAgB,EAAE,KAAK,EAAE,MAAM,qBAAqB,CAAC;AAC9D,OAAO,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAExC,8EAA8E;AAC9E,UAAU;AACV,8EAA8E;AAE9E;;GAEG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,KAAK,CAAC;IACtC,IAAI,EAAE;QACJ,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE;QAClB,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,wBAAwB;QAC/C,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;KACpB;IACD,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC;IACzB,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,IAAI,EAAE,EAAE;QAC3B,OAAO,MAAM,GAAG,CAAC,EAAE;aAChB,KAAK,CAAC,iBAAiB,CAAC;aACxB,SAAS,CAAC,cAAc,EAAE,CAAC,GAAG,EAAE,EAAE,CACjC,GAAG;aACA,EAAE,CAAC,QAAQ,EAAE,IAAI,CAAC,MAAM,CAAC;aACzB,GAAG,CAAC,iBAAiB,EAAE,IAAI,CAAC,SAAS,CAAC;aACtC,GAAG,CAAC,iBAAiB,EAAE,IAAI,CAAC,OAAO,CAAC,CACxC;aACA,OAAO,EAAE,CAAC;IACf,CAAC;CACF,CAAC,CAAC;AAEH;;GAEG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG,KAAK,CAAC;IAC7B,IAAI,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE;IAC5B,OAAO,EAAE,CAAC,CAAC,GAAG,EAAE;IAChB,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,IAAI,EAAE,EAAE;QAC3B,OAAO,MAAM,GAAG,CAAC,EAAE;aAChB,KAAK,CAAC,iBAAiB,CAAC;aACxB,SAAS,CAAC,cAAc,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,QAAQ,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;aACjE,KAAK,CAAC,MAAM,CAAC;aACb,KAAK,EAAE,CAAC;IACb,CAAC;CACF,CAAC,CAAC;AAEH,8EAA8E;AAC9E,YAAY;AACZ,8EAA8E;AAE9E;;GAEG;AACH,MAAM,CAAC,MAAM,MAAM,GAAG,gBAAgB,CAAC;IACrC,IAAI,EAAE;QACJ,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE;QAClB,QAAQ,EAAE,YAAY;QACtB,UAAU,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;QAClC,eAAe,EAAE,CAAC,CAAC,MAAM,EAAE;QAC3B,UAAU,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;QAClC,WAAW,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;QACnC,oBAAoB,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;QAC5C,YAAY,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;QACpC,YAAY,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;QACpC,gBAAgB,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;QACxC,oBAAoB,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;QAC5C,kBAAkB,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;QAC1C,gBAAgB,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC;QACzC,kBAAkB,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;QAC1C,qBAAqB,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;QAC7C,aAAa,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;QACrC,UAAU,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC;QACnC,gBAAgB,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;QACxC,wBAAwB,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;QAChD,uBAAuB,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;QAC/C,cAAc,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;QACtC,cAAc,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;KACvC;IACD,OAAO,EAAE,CAAC,CAAC,EAAE,CAAC,iBAAiB,CAAC;IAChC,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,IAAI,EAAE,EAAE;QAC3B,sBAAsB;QACtB,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;YACpB,MAAM,QAAQ,GAAG,MAAM,GAAG,CAAC,EAAE;iBAC1B,KAAK,CAAC,iBAAiB,CAAC;iBACxB,SAAS,CAAC,gBAAgB,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,YAAY,EAAE,IAAI,CAAC,UAAU,CAAC,CAAC;iBAC3E,KAAK,EAAE,CAAC;YACX,IAAI,QAAQ,EAAE,CAAC;gBACb,MAAM,GAAG,CAAC,EAAE,CAAC,KAAK,CAAC,QAAQ,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;gBACvC,OAAO,QAAQ,CAAC,GAAG,CAAC;YACtB,CAAC;QACH,CAAC;QAED,kCAAkC;QAClC,MAAM,QAAQ,GAAG,MAAM,GAAG,CAAC,EAAE;aAC1B,KAAK,CAAC,iBAAiB,CAAC;aACxB,SAAS,CAAC,cAAc,EAAE,CAAC,GAAG,EAAE,EAAE,CACjC,GAAG,CAAC,EAAE,CAAC,QAAQ,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,iBAAiB,EAAE,IAAI,CAAC,eAAe,CAAC,CAC1E;aACA,KAAK,EAAE,CAAC;QAEX,IAAI,QAAQ,EAAE,CAAC;YACb,MAAM,GAAG,CAAC,EAAE,CAAC,KAAK,CAAC,QAAQ,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;YACvC,OAAO,QAAQ,CAAC,GAAG,CAAC;QACtB,CAAC;QAED,OAAO,MAAM,GAAG,CAAC,EAAE,CAAC,MAAM,CAAC,iBAAiB,EAAE,IAAI,CAAC,CAAC;IACtD,CAAC;CACF,CAAC,CAAC;AAEH;;GAEG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,gBAAgB,CAAC;IAC3C,IAAI,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE;IAC5B,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,IAAI,EAAE,EAAE;QAC3B,MAAM,OAAO,GAAG,MAAM,GAAG,CAAC,EAAE;aACzB,KAAK,CAAC,iBAAiB,CAAC;aACxB,SAAS,CAAC,kBAAkB,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,QAAQ,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;aACrE,OAAO,EAAE,CAAC;QACb,KAAK,MAAM,CAAC,IAAI,OAAO,EAAE,CAAC;YACxB,MAAM,GAAG,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;QAC7B,CAAC;IACH,CAAC;CACF,CAAC,CAAC"}

package/dist/component/oauthActions.d.ts

@@ -0,0 +1,52 @@
+/**
+ * OAuth flow Convex actions.
+ *
+ * Actions (not mutations) because they make external HTTP calls to
+ * provider token endpoints and APIs.
+ */
+/**
+ * Generate an OAuth authorization URL for a provider.
+ *
+ * Stores the state token in the oauthStates table and returns the URL
+ * the client should redirect the user to.
+ */
+export declare const generateAuthUrl: import("convex/server").RegisteredAction<"public", {
+    subscriptionKey?: string | undefined;
+    provider: "garmin" | "suunto" | "polar" | "whoop" | "strava" | "apple" | "samsung" | "google";
+    userId: string;
+    redirectUri: string;
+    clientId: string;
+    clientSecret: string;
+}, Promise<string>>;
+/**
+ * Handle the OAuth callback. Consumes the state token, exchanges the
+ * authorization code for access/refresh tokens, fetches the user's
+ * provider profile, and creates/updates the connection.
+ */
+export declare const handleCallback: import("convex/server").RegisteredAction<"public", {
+    subscriptionKey?: string | undefined;
+    state: string;
+    clientId: string;
+    clientSecret: string;
+    code: string;
+}, Promise<{
+    provider: any;
+    userId: any;
+    connectionId: string;
+}>>;
+/**
+ * Ensure a connection has a valid (non-expired) access token.
+ * If expired, refreshes the token and updates the connection.
+ * Returns the valid access token.
+ */
+export declare const ensureValidToken: import("convex/server").RegisteredAction<"internal", {
+    refreshToken?: string | undefined;
+    tokenExpiresAt?: number | undefined;
+    subscriptionKey?: string | undefined;
+    provider: "garmin" | "suunto" | "polar" | "whoop" | "strava" | "apple" | "samsung" | "google";
+    accessToken: string;
+    connectionId: import("convex/values").GenericId<"connections">;
+    clientId: string;
+    clientSecret: string;
+}, Promise<string>>;
+//# sourceMappingURL=oauthActions.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"oauthActions.d.ts","sourceRoot":"","sources":["../../src/component/oauthActions.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAoBH;;;;;GAKG;AACH,eAAO,MAAM,eAAe;;;;;;;mBA4D1B,CAAC;AAMH;;;;GAIG;AACH,eAAO,MAAM,cAAc;;;;;;;;;;GAkGzB,CAAC;AAEH;;;;GAIG;AACH,eAAO,MAAM,gBAAgB;;;;;;;;;mBAqD3B,CAAC"}