@clipin/convex-wearables 0.0.1

package/dist/component/dataPoints.js

@@ -0,0 +1,258 @@
+import { v } from "convex/values";
+import { internalMutation, query } from "./_generated/server";
+// ---------------------------------------------------------------------------
+// Queries
+// ---------------------------------------------------------------------------
+/**
+ * Get time-series data points with cursor-based pagination.
+ * Uses the by_source_type_time index for efficient range queries.
+ */
+export const getTimeSeries = query({
+    args: {
+        dataSourceId: v.id("dataSources"),
+        seriesType: v.string(),
+        startDate: v.number(),
+        endDate: v.number(),
+        limit: v.optional(v.number()),
+        cursor: v.optional(v.string()),
+        order: v.optional(v.union(v.literal("asc"), v.literal("desc"))),
+    },
+    returns: v.object({
+        points: v.array(v.object({
+            timestamp: v.number(),
+            value: v.number(),
+        })),
+        nextCursor: v.union(v.string(), v.null()),
+        hasMore: v.boolean(),
+    }),
+    handler: async (ctx, args) => {
+        const limit = Math.min(args.limit ?? 500, 2000);
+        const order = args.order ?? "asc";
+        const startDate = args.cursor ? Number(args.cursor) : args.startDate;
+        const results = await ctx.db
+            .query("dataPoints")
+            .withIndex("by_source_type_time", (idx) => order === "asc"
+            ? idx
+                .eq("dataSourceId", args.dataSourceId)
+                .eq("seriesType", args.seriesType)
+                .gte("recordedAt", startDate)
+                .lte("recordedAt", args.endDate)
+            : idx
+                .eq("dataSourceId", args.dataSourceId)
+                .eq("seriesType", args.seriesType)
+                .gte("recordedAt", args.startDate)
+                .lte("recordedAt", startDate))
+            .order(order)
+            .take(limit + 1);
+        const hasMore = results.length > limit;
+        const items = hasMore ? results.slice(0, limit) : results;
+        const points = items.map((dp) => ({
+            timestamp: dp.recordedAt,
+            value: dp.value,
+        }));
+        const nextCursor = hasMore && items.length > 0 ? String(items[items.length - 1].recordedAt) : null;
+        return { points, nextCursor, hasMore };
+    },
+});
+/**
+ * Get time-series data for a user across all their data sources for a given series type.
+ * This is a user-facing query that resolves data sources internally.
+ */
+export const getTimeSeriesForUser = query({
+    args: {
+        userId: v.string(),
+        seriesType: v.string(),
+        startDate: v.number(),
+        endDate: v.number(),
+        limit: v.optional(v.number()),
+    },
+    returns: v.array(v.object({
+        timestamp: v.number(),
+        value: v.number(),
+    })),
+    handler: async (ctx, args) => {
+        const limit = Math.min(args.limit ?? 500, 2000);
+        // Get all data sources for this user
+        const sources = await ctx.db
+            .query("dataSources")
+            .withIndex("by_user_provider", (idx) => idx.eq("userId", args.userId))
+            .collect();
+        // Collect data from all sources (merge and sort)
+        const allPoints = [];
+        for (const source of sources) {
+            const points = await ctx.db
+                .query("dataPoints")
+                .withIndex("by_source_type_time", (idx) => idx
+                .eq("dataSourceId", source._id)
+                .eq("seriesType", args.seriesType)
+                .gte("recordedAt", args.startDate)
+                .lte("recordedAt", args.endDate))
+                .take(limit);
+            for (const dp of points) {
+                allPoints.push({ timestamp: dp.recordedAt, value: dp.value });
+            }
+        }
+        // Sort by timestamp and limit
+        allPoints.sort((a, b) => a.timestamp - b.timestamp);
+        return allPoints.slice(0, limit);
+    },
+});
+/**
+ * Get the latest data point for a user and series type.
+ */
+export const getLatestDataPoint = query({
+    args: {
+        userId: v.string(),
+        seriesType: v.string(),
+    },
+    returns: v.union(v.object({
+        timestamp: v.number(),
+        value: v.number(),
+        provider: v.string(),
+    }), v.null()),
+    handler: async (ctx, args) => {
+        const sources = await ctx.db
+            .query("dataSources")
+            .withIndex("by_user_provider", (idx) => idx.eq("userId", args.userId))
+            .collect();
+        let latest = null;
+        for (const source of sources) {
+            const point = await ctx.db
+                .query("dataPoints")
+                .withIndex("by_source_type_time", (idx) => idx.eq("dataSourceId", source._id).eq("seriesType", args.seriesType))
+                .order("desc")
+                .first();
+            if (point && (latest === null || point.recordedAt > latest.timestamp)) {
+                latest = {
+                    timestamp: point.recordedAt,
+                    value: point.value,
+                    provider: source.provider,
+                };
+            }
+        }
+        return latest;
+    },
+});
+/**
+ * Get all available series types for a user (i.e., types that have at least one data point).
+ */
+export const getAvailableSeriesTypes = query({
+    args: { userId: v.string() },
+    returns: v.array(v.string()),
+    handler: async (ctx, args) => {
+        const sources = await ctx.db
+            .query("dataSources")
+            .withIndex("by_user_provider", (idx) => idx.eq("userId", args.userId))
+            .collect();
+        const types = new Set();
+        for (const source of sources) {
+            // Sample a few data points to discover types
+            // This is efficient because we only need one per type
+            const points = await ctx.db
+                .query("dataPoints")
+                .withIndex("by_source_type_time", (idx) => idx.eq("dataSourceId", source._id))
+                .take(200);
+            for (const point of points) {
+                types.add(point.seriesType);
+            }
+        }
+        return Array.from(types).sort();
+    },
+});
+// ---------------------------------------------------------------------------
+// Mutations
+// ---------------------------------------------------------------------------
+/**
+ * Store a single data point. Deduplicates by (source, type, time).
+ */
+export const storeDataPoint = internalMutation({
+    args: {
+        dataSourceId: v.id("dataSources"),
+        seriesType: v.string(),
+        recordedAt: v.number(),
+        value: v.number(),
+        externalId: v.optional(v.string()),
+    },
+    returns: v.id("dataPoints"),
+    handler: async (ctx, args) => {
+        // Deduplicate by (source, type, time)
+        const existing = await ctx.db
+            .query("dataPoints")
+            .withIndex("by_source_type_time", (idx) => idx
+            .eq("dataSourceId", args.dataSourceId)
+            .eq("seriesType", args.seriesType)
+            .eq("recordedAt", args.recordedAt))
+            .first();
+        if (existing) {
+            await ctx.db.patch(existing._id, { value: args.value });
+            return existing._id;
+        }
+        return await ctx.db.insert("dataPoints", args);
+    },
+});
+/**
+ * Store a batch of data points. Used by sync workflows.
+ * Must complete within 1 second — caller is responsible for batch sizing.
+ */
+export const storeBatch = internalMutation({
+    args: {
+        dataSourceId: v.id("dataSources"),
+        seriesType: v.string(),
+        points: v.array(v.object({
+            recordedAt: v.number(),
+            value: v.number(),
+            externalId: v.optional(v.string()),
+        })),
+    },
+    returns: v.number(),
+    handler: async (ctx, args) => {
+        let count = 0;
+        for (const point of args.points) {
+            // Deduplicate by (source, type, time)
+            const existing = await ctx.db
+                .query("dataPoints")
+                .withIndex("by_source_type_time", (idx) => idx
+                .eq("dataSourceId", args.dataSourceId)
+                .eq("seriesType", args.seriesType)
+                .eq("recordedAt", point.recordedAt))
+                .first();
+            if (existing) {
+                await ctx.db.patch(existing._id, { value: point.value });
+            }
+            else {
+                await ctx.db.insert("dataPoints", {
+                    dataSourceId: args.dataSourceId,
+                    seriesType: args.seriesType,
+                    recordedAt: point.recordedAt,
+                    value: point.value,
+                    externalId: point.externalId,
+                });
+            }
+            count++;
+        }
+        return count;
+    },
+});
+/**
+ * Delete all data points for a data source. Used during user/connection cleanup.
+ */
+export const deleteByDataSource = internalMutation({
+    args: { dataSourceId: v.id("dataSources") },
+    handler: async (ctx, args) => {
+        // Delete in batches to avoid hitting limits
+        let batch = await ctx.db
+            .query("dataPoints")
+            .withIndex("by_source_type_time", (idx) => idx.eq("dataSourceId", args.dataSourceId))
+            .take(1000);
+        while (batch.length > 0) {
+            for (const dp of batch) {
+                await ctx.db.delete(dp._id);
+            }
+            batch = await ctx.db
+                .query("dataPoints")
+                .withIndex("by_source_type_time", (idx) => idx.eq("dataSourceId", args.dataSourceId))
+                .take(1000);
+        }
+    },
+});
+//# sourceMappingURL=dataPoints.js.map

package/dist/component/dataPoints.js.map

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

package/dist/component/dataSources.d.ts

@@ -0,0 +1,56 @@
+/**
+ * Get all data sources for a user.
+ */
+export declare const getByUser: import("convex/server").RegisteredQuery<"public", {
+    userId: string;
+}, Promise<{
+    _id: import("convex/values").GenericId<"dataSources">;
+    _creationTime: number;
+    connectionId?: import("convex/values").GenericId<"connections"> | undefined;
+    deviceModel?: string | undefined;
+    softwareVersion?: string | undefined;
+    source?: string | undefined;
+    deviceType?: string | undefined;
+    originalSourceName?: string | undefined;
+    provider: "garmin" | "suunto" | "polar" | "whoop" | "strava" | "apple" | "samsung" | "google";
+    userId: string;
+}[]>>;
+/**
+ * Get data sources for a user + provider combination.
+ */
+export declare const getByUserProvider: import("convex/server").RegisteredQuery<"public", {
+    provider: "garmin" | "suunto" | "polar" | "whoop" | "strava" | "apple" | "samsung" | "google";
+    userId: string;
+}, Promise<{
+    _id: import("convex/values").GenericId<"dataSources">;
+    _creationTime: number;
+    connectionId?: import("convex/values").GenericId<"connections"> | undefined;
+    deviceModel?: string | undefined;
+    softwareVersion?: string | undefined;
+    source?: string | undefined;
+    deviceType?: string | undefined;
+    originalSourceName?: string | undefined;
+    provider: "garmin" | "suunto" | "polar" | "whoop" | "strava" | "apple" | "samsung" | "google";
+    userId: string;
+}[]>>;
+/**
+ * Get or create a data source. Used during data ingestion to ensure
+ * a data source exists for a given user/provider/device combination.
+ */
+export declare const getOrCreate: import("convex/server").RegisteredMutation<"public", {
+    connectionId?: import("convex/values").GenericId<"connections"> | undefined;
+    deviceModel?: string | undefined;
+    softwareVersion?: string | undefined;
+    source?: string | undefined;
+    deviceType?: string | undefined;
+    originalSourceName?: string | undefined;
+    provider: "garmin" | "suunto" | "polar" | "whoop" | "strava" | "apple" | "samsung" | "google";
+    userId: string;
+}, Promise<import("convex/values").GenericId<"dataSources">>>;
+/**
+ * Delete all data sources for a user. Used during account deletion.
+ */
+export declare const deleteByUser: import("convex/server").RegisteredMutation<"internal", {
+    userId: string;
+}, Promise<void>>;
+//# sourceMappingURL=dataSources.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"dataSources.d.ts","sourceRoot":"","sources":["../../src/component/dataSources.ts"],"names":[],"mappings":"AAQA;;GAEG;AACH,eAAO,MAAM,SAAS;;;;;;;;;;;;;KASpB,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;KAc5B,CAAC;AAMH;;;GAGG;AACH,eAAO,MAAM,WAAW;;;;;;;;;6DA0CtB,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,YAAY;;iBAYvB,CAAC"}

package/dist/component/dataSources.js

@@ -0,0 +1,95 @@
+import { v } from "convex/values";
+import { internalMutation, mutation, query } from "./_generated/server";
+import { providerName } from "./schema";
+// ---------------------------------------------------------------------------
+// Queries
+// ---------------------------------------------------------------------------
+/**
+ * Get all data sources for a user.
+ */
+export const getByUser = query({
+    args: { userId: v.string() },
+    returns: v.array(v.any()),
+    handler: async (ctx, args) => {
+        return await ctx.db
+            .query("dataSources")
+            .withIndex("by_user_provider", (idx) => idx.eq("userId", args.userId))
+            .collect();
+    },
+});
+/**
+ * Get data sources for a user + provider combination.
+ */
+export const getByUserProvider = query({
+    args: {
+        userId: v.string(),
+        provider: providerName,
+    },
+    returns: v.array(v.any()),
+    handler: async (ctx, args) => {
+        return await ctx.db
+            .query("dataSources")
+            .withIndex("by_user_provider", (idx) => idx.eq("userId", args.userId).eq("provider", args.provider))
+            .collect();
+    },
+});
+// ---------------------------------------------------------------------------
+// Mutations
+// ---------------------------------------------------------------------------
+/**
+ * Get or create a data source. Used during data ingestion to ensure
+ * a data source exists for a given user/provider/device combination.
+ */
+export const getOrCreate = mutation({
+    args: {
+        userId: v.string(),
+        provider: providerName,
+        connectionId: v.optional(v.id("connections")),
+        deviceModel: v.optional(v.string()),
+        softwareVersion: v.optional(v.string()),
+        source: v.optional(v.string()),
+        deviceType: v.optional(v.string()),
+        originalSourceName: v.optional(v.string()),
+    },
+    returns: v.id("dataSources"),
+    handler: async (ctx, args) => {
+        // Look for existing data source matching this user/provider/device/source
+        const existing = await ctx.db
+            .query("dataSources")
+            .withIndex("by_user_provider_device", (idx) => idx
+            .eq("userId", args.userId)
+            .eq("provider", args.provider)
+            .eq("deviceModel", args.deviceModel ?? undefined)
+            .eq("source", args.source ?? undefined))
+            .first();
+        if (existing) {
+            // Update fields that may have changed
+            if (args.softwareVersion !== existing.softwareVersion ||
+                args.deviceType !== existing.deviceType) {
+                await ctx.db.patch(existing._id, {
+                    softwareVersion: args.softwareVersion,
+                    deviceType: args.deviceType,
+                    connectionId: args.connectionId ?? existing.connectionId,
+                });
+            }
+            return existing._id;
+        }
+        return await ctx.db.insert("dataSources", args);
+    },
+});
+/**
+ * Delete all data sources for a user. Used during account deletion.
+ */
+export const deleteByUser = internalMutation({
+    args: { userId: v.string() },
+    handler: async (ctx, args) => {
+        const sources = await ctx.db
+            .query("dataSources")
+            .withIndex("by_user_provider", (idx) => idx.eq("userId", args.userId))
+            .collect();
+        for (const source of sources) {
+            await ctx.db.delete(source._id);
+        }
+    },
+});
+//# sourceMappingURL=dataSources.js.map

package/dist/component/dataSources.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dataSources.js","sourceRoot":"","sources":["../../src/component/dataSources.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,eAAe,CAAC;AAClC,OAAO,EAAE,gBAAgB,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,qBAAqB,CAAC;AACxE,OAAO,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAExC,8EAA8E;AAC9E,UAAU;AACV,8EAA8E;AAE9E;;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,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,aAAa,CAAC;aACpB,SAAS,CAAC,kBAAkB,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,QAAQ,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;aACrE,OAAO,EAAE,CAAC;IACf,CAAC;CACF,CAAC,CAAC;AAEH;;GAEG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,KAAK,CAAC;IACrC,IAAI,EAAE;QACJ,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE;QAClB,QAAQ,EAAE,YAAY;KACvB;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,aAAa,CAAC;aACpB,SAAS,CAAC,kBAAkB,EAAE,CAAC,GAAG,EAAE,EAAE,CACrC,GAAG,CAAC,EAAE,CAAC,QAAQ,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,UAAU,EAAE,IAAI,CAAC,QAAQ,CAAC,CAC5D;aACA,OAAO,EAAE,CAAC;IACf,CAAC;CACF,CAAC,CAAC;AAEH,8EAA8E;AAC9E,YAAY;AACZ,8EAA8E;AAE9E;;;GAGG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,QAAQ,CAAC;IAClC,IAAI,EAAE;QACJ,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE;QAClB,QAAQ,EAAE,YAAY;QACtB,YAAY,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC,aAAa,CAAC,CAAC;QAC7C,WAAW,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;QACnC,eAAe,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;QACvC,MAAM,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;QAC9B,UAAU,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;QAClC,kBAAkB,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;KAC3C;IACD,OAAO,EAAE,CAAC,CAAC,EAAE,CAAC,aAAa,CAAC;IAC5B,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,IAAI,EAAE,EAAE;QAC3B,0EAA0E;QAC1E,MAAM,QAAQ,GAAG,MAAM,GAAG,CAAC,EAAE;aAC1B,KAAK,CAAC,aAAa,CAAC;aACpB,SAAS,CAAC,yBAAyB,EAAE,CAAC,GAAG,EAAE,EAAE,CAC5C,GAAG;aACA,EAAE,CAAC,QAAQ,EAAE,IAAI,CAAC,MAAM,CAAC;aACzB,EAAE,CAAC,UAAU,EAAE,IAAI,CAAC,QAAQ,CAAC;aAC7B,EAAE,CAAC,aAAa,EAAE,IAAI,CAAC,WAAW,IAAI,SAAS,CAAC;aAChD,EAAE,CAAC,QAAQ,EAAE,IAAI,CAAC,MAAM,IAAI,SAAS,CAAC,CAC1C;aACA,KAAK,EAAE,CAAC;QAEX,IAAI,QAAQ,EAAE,CAAC;YACb,sCAAsC;YACtC,IACE,IAAI,CAAC,eAAe,KAAK,QAAQ,CAAC,eAAe;gBACjD,IAAI,CAAC,UAAU,KAAK,QAAQ,CAAC,UAAU,EACvC,CAAC;gBACD,MAAM,GAAG,CAAC,EAAE,CAAC,KAAK,CAAC,QAAQ,CAAC,GAAG,EAAE;oBAC/B,eAAe,EAAE,IAAI,CAAC,eAAe;oBACrC,UAAU,EAAE,IAAI,CAAC,UAAU;oBAC3B,YAAY,EAAE,IAAI,CAAC,YAAY,IAAI,QAAQ,CAAC,YAAY;iBACzD,CAAC,CAAC;YACL,CAAC;YACD,OAAO,QAAQ,CAAC,GAAG,CAAC;QACtB,CAAC;QAED,OAAO,MAAM,GAAG,CAAC,EAAE,CAAC,MAAM,CAAC,aAAa,EAAE,IAAI,CAAC,CAAC;IAClD,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,aAAa,CAAC;aACpB,SAAS,CAAC,kBAAkB,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,QAAQ,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;aACrE,OAAO,EAAE,CAAC;QAEb,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;YAC7B,MAAM,GAAG,CAAC,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QAClC,CAAC;IACH,CAAC;CACF,CAAC,CAAC"}

package/dist/component/events.d.ts

@@ -0,0 +1,203 @@
+import type { Id } from "./_generated/dataModel";
+/**
+ * Get events (workouts or sleep) for a user with cursor-based pagination.
+ */
+export declare const getEvents: import("convex/server").RegisteredQuery<"public", {
+    cursor?: string | undefined;
+    limit?: number | undefined;
+    startDate?: number | undefined;
+    endDate?: number | undefined;
+    category: "workout" | "sleep";
+    userId: string;
+}, Promise<{
+    events: {
+        _id: import("convex/values").GenericId<"events">;
+        _creationTime: number;
+        type?: string | undefined;
+        sourceName?: string | undefined;
+        durationSeconds?: number | undefined;
+        endDatetime?: number | undefined;
+        externalId?: string | undefined;
+        heartRateMin?: number | undefined;
+        heartRateMax?: number | undefined;
+        heartRateAvg?: number | undefined;
+        energyBurned?: number | undefined;
+        distance?: number | undefined;
+        stepsCount?: number | undefined;
+        maxSpeed?: number | undefined;
+        maxWatts?: number | undefined;
+        movingTimeSeconds?: number | undefined;
+        totalElevationGain?: number | undefined;
+        averageSpeed?: number | undefined;
+        averageWatts?: number | undefined;
+        elevHigh?: number | undefined;
+        elevLow?: number | undefined;
+        sleepTotalDurationMinutes?: number | undefined;
+        sleepTimeInBedMinutes?: number | undefined;
+        sleepEfficiencyScore?: number | undefined;
+        sleepDeepMinutes?: number | undefined;
+        sleepRemMinutes?: number | undefined;
+        sleepLightMinutes?: number | undefined;
+        sleepAwakeMinutes?: number | undefined;
+        isNap?: boolean | undefined;
+        sleepStages?: {
+            stage: string;
+            startTime: number;
+            endTime: number;
+        }[] | undefined;
+        category: "workout" | "sleep";
+        startDatetime: number;
+        userId: string;
+        dataSourceId: import("convex/values").GenericId<"dataSources">;
+    }[];
+    nextCursor: string | null;
+    hasMore: boolean;
+}>>;
+/**
+ * Get a single event by its ID.
+ */
+export declare const getEvent: import("convex/server").RegisteredQuery<"public", {
+    eventId: import("convex/values").GenericId<"events">;
+}, Promise<{
+    _id: import("convex/values").GenericId<"events">;
+    _creationTime: number;
+    type?: string | undefined;
+    sourceName?: string | undefined;
+    durationSeconds?: number | undefined;
+    endDatetime?: number | undefined;
+    externalId?: string | undefined;
+    heartRateMin?: number | undefined;
+    heartRateMax?: number | undefined;
+    heartRateAvg?: number | undefined;
+    energyBurned?: number | undefined;
+    distance?: number | undefined;
+    stepsCount?: number | undefined;
+    maxSpeed?: number | undefined;
+    maxWatts?: number | undefined;
+    movingTimeSeconds?: number | undefined;
+    totalElevationGain?: number | undefined;
+    averageSpeed?: number | undefined;
+    averageWatts?: number | undefined;
+    elevHigh?: number | undefined;
+    elevLow?: number | undefined;
+    sleepTotalDurationMinutes?: number | undefined;
+    sleepTimeInBedMinutes?: number | undefined;
+    sleepEfficiencyScore?: number | undefined;
+    sleepDeepMinutes?: number | undefined;
+    sleepRemMinutes?: number | undefined;
+    sleepLightMinutes?: number | undefined;
+    sleepAwakeMinutes?: number | undefined;
+    isNap?: boolean | undefined;
+    sleepStages?: {
+        stage: string;
+        startTime: number;
+        endTime: number;
+    }[] | undefined;
+    category: "workout" | "sleep";
+    startDatetime: number;
+    userId: string;
+    dataSourceId: import("convex/values").GenericId<"dataSources">;
+} | null>>;
+/**
+ * Get an event by its external ID (for deduplication checks).
+ */
+export declare const getByExternalId: import("convex/server").RegisteredQuery<"internal", {
+    externalId: string;
+}, Promise<{
+    _id: import("convex/values").GenericId<"events">;
+    _creationTime: number;
+    type?: string | undefined;
+    sourceName?: string | undefined;
+    durationSeconds?: number | undefined;
+    endDatetime?: number | undefined;
+    externalId?: string | undefined;
+    heartRateMin?: number | undefined;
+    heartRateMax?: number | undefined;
+    heartRateAvg?: number | undefined;
+    energyBurned?: number | undefined;
+    distance?: number | undefined;
+    stepsCount?: number | undefined;
+    maxSpeed?: number | undefined;
+    maxWatts?: number | undefined;
+    movingTimeSeconds?: number | undefined;
+    totalElevationGain?: number | undefined;
+    averageSpeed?: number | undefined;
+    averageWatts?: number | undefined;
+    elevHigh?: number | undefined;
+    elevLow?: number | undefined;
+    sleepTotalDurationMinutes?: number | undefined;
+    sleepTimeInBedMinutes?: number | undefined;
+    sleepEfficiencyScore?: number | undefined;
+    sleepDeepMinutes?: number | undefined;
+    sleepRemMinutes?: number | undefined;
+    sleepLightMinutes?: number | undefined;
+    sleepAwakeMinutes?: number | undefined;
+    isNap?: boolean | undefined;
+    sleepStages?: {
+        stage: string;
+        startTime: number;
+        endTime: number;
+    }[] | undefined;
+    category: "workout" | "sleep";
+    startDatetime: number;
+    userId: string;
+    dataSourceId: import("convex/values").GenericId<"dataSources">;
+} | null>>;
+/**
+ * Store a single event (workout or sleep). Deduplicates by externalId if provided.
+ */
+export declare const storeEvent: import("convex/server").RegisteredMutation<"internal", {
+    type?: string | undefined;
+    sourceName?: string | undefined;
+    durationSeconds?: number | undefined;
+    endDatetime?: number | undefined;
+    externalId?: string | undefined;
+    heartRateMin?: number | undefined;
+    heartRateMax?: number | undefined;
+    heartRateAvg?: number | undefined;
+    energyBurned?: number | undefined;
+    distance?: number | undefined;
+    stepsCount?: number | undefined;
+    maxSpeed?: number | undefined;
+    maxWatts?: number | undefined;
+    movingTimeSeconds?: number | undefined;
+    totalElevationGain?: number | undefined;
+    averageSpeed?: number | undefined;
+    averageWatts?: number | undefined;
+    elevHigh?: number | undefined;
+    elevLow?: number | undefined;
+    sleepTotalDurationMinutes?: number | undefined;
+    sleepTimeInBedMinutes?: number | undefined;
+    sleepEfficiencyScore?: number | undefined;
+    sleepDeepMinutes?: number | undefined;
+    sleepRemMinutes?: number | undefined;
+    sleepLightMinutes?: number | undefined;
+    sleepAwakeMinutes?: number | undefined;
+    isNap?: boolean | undefined;
+    sleepStages?: {
+        stage: string;
+        startTime: number;
+        endTime: number;
+    }[] | undefined;
+    category: "workout" | "sleep";
+    startDatetime: number;
+    userId: string;
+    dataSourceId: import("convex/values").GenericId<"dataSources">;
+}, Promise<import("convex/values").GenericId<"events">>>;
+/**
+ * Store a batch of events. Used by sync workflows to write multiple events
+ * in a single mutation (must complete within 1 second).
+ */
+export declare const storeEventBatch: import("convex/server").RegisteredMutation<"internal", {
+    events: any[];
+}, Promise<Id<"events">[]>>;
+export declare const deleteByExternalId: import("convex/server").RegisteredMutation<"internal", {
+    externalId: string;
+}, Promise<void>>;
+/**
+ * Delete all events for a user. Used for GDPR/account deletion.
+ */
+export declare const deleteUserEvents: import("convex/server").RegisteredMutation<"internal", {
+    userId: string;
+}, Promise<void>>;
+//# sourceMappingURL=events.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"events.d.ts","sourceRoot":"","sources":["../../src/component/events.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,wBAAwB,CAAC;AAQjD;;GAEG;AACH,eAAO,MAAM,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsFpB,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,QAAQ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;UAMnB,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;UAS1B,CAAC;AAMH;;GAEG;AACH,eAAO,MAAM,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;wDA8ErB,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,eAAe;;2BAuC1B,CAAC;AAEH,eAAO,MAAM,kBAAkB;;iBAc7B,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,gBAAgB;;iBAW3B,CAAC"}