@clipin/convex-wearables 0.0.2 → 0.1.0

package/dist/component/dataPoints.d.ts

@@ -1,81 +1,195 @@
-/**
- * Get time-series data points with cursor-based pagination.
- * Uses the by_source_type_time index for efficient range queries.
- */
+import type { Id } from "./_generated/dataModel";
+type TimeSeriesPoint = {
+    timestamp: number;
+    value: number;
+    resolution?: "raw" | "rollup";
+    bucketMinutes?: number;
+    avg?: number;
+    min?: number;
+    max?: number;
+    last?: number;
+    count?: number;
+};
 export declare const getTimeSeries: import("convex/server").RegisteredQuery<"public", {
     cursor?: string | undefined;
     limit?: number | undefined;
     order?: "asc" | "desc" | undefined;
-    seriesType: string;
     dataSourceId: import("convex/values").GenericId<"dataSources">;
+    seriesType: string;
     startDate: number;
     endDate: number;
 }, Promise<{
-    points: {
-        timestamp: number;
-        value: number;
-    }[];
+    points: TimeSeriesPoint[];
     nextCursor: string | null;
     hasMore: boolean;
 }>>;
-/**
- * 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 declare const getTimeSeriesForUser: import("convex/server").RegisteredQuery<"public", {
     limit?: number | undefined;
-    seriesType: string;
     userId: string;
+    seriesType: string;
     startDate: number;
     endDate: number;
-}, Promise<{
-    timestamp: number;
-    value: number;
-}[]>>;
-/**
- * Get the latest data point for a user and series type.
- */
+}, Promise<TimeSeriesPoint[]>>;
 export declare const getLatestDataPoint: import("convex/server").RegisteredQuery<"public", {
-    seriesType: string;
     userId: string;
+    seriesType: string;
 }, Promise<{
     timestamp: number;
     value: number;
     provider: string;
 } | null>>;
-/**
- * Get all available series types for a user (i.e., types that have at least one data point).
- */
 export declare const getAvailableSeriesTypes: import("convex/server").RegisteredQuery<"public", {
     userId: string;
 }, Promise<string[]>>;
-/**
- * Store a single data point. Deduplicates by (source, type, time).
- */
+export declare const getTimeSeriesPolicyConfiguration: import("convex/server").RegisteredQuery<"public", {}, Promise<{
+    maintenance: {
+        enabled: boolean;
+        intervalMs: number;
+    };
+    defaultRules: {
+        _id: import("convex/values").GenericId<"timeSeriesPolicyRules">;
+        provider: "garmin" | "suunto" | "polar" | "whoop" | "strava" | "apple" | "samsung" | "google" | undefined;
+        seriesType: string | undefined;
+        scope: "provider" | "provider_series" | "series" | "global";
+        policySetKind: "default" | "preset";
+        policySetKey: string;
+        tiers: ({
+            kind: string;
+            fromAgeMs: number;
+            toAgeMs: number | null;
+            bucketMs?: undefined;
+            aggregations?: undefined;
+        } | {
+            kind: string;
+            fromAgeMs: number;
+            toAgeMs: number | null;
+            bucketMs: number;
+            aggregations: ("avg" | "min" | "max" | "last" | "count")[];
+        })[];
+        updatedAt: number;
+    }[];
+    presets: {
+        key: string;
+        rules: {
+            _id: import("convex/values").GenericId<"timeSeriesPolicyRules">;
+            provider: "garmin" | "suunto" | "polar" | "whoop" | "strava" | "apple" | "samsung" | "google" | undefined;
+            seriesType: string | undefined;
+            scope: "provider" | "provider_series" | "series" | "global";
+            policySetKind: "default" | "preset";
+            policySetKey: string;
+            tiers: ({
+                kind: string;
+                fromAgeMs: number;
+                toAgeMs: number | null;
+                bucketMs?: undefined;
+                aggregations?: undefined;
+            } | {
+                kind: string;
+                fromAgeMs: number;
+                toAgeMs: number | null;
+                bucketMs: number;
+                aggregations: ("avg" | "min" | "max" | "last" | "count")[];
+            })[];
+            updatedAt: number;
+        }[];
+    }[];
+}>>;
+export declare const getUserTimeSeriesPolicyPreset: import("convex/server").RegisteredQuery<"public", {
+    userId: string;
+}, Promise<{
+    userId: string;
+    presetKey: string;
+    updatedAt: number;
+} | null>>;
+export declare const getEffectiveTimeSeriesPolicy: import("convex/server").RegisteredQuery<"public", {
+    provider: "garmin" | "suunto" | "polar" | "whoop" | "strava" | "apple" | "samsung" | "google";
+    userId: string;
+    seriesType: string;
+}, Promise<{
+    provider: "garmin" | "suunto" | "polar" | "whoop" | "strava" | "apple" | "samsung" | "google";
+    seriesType: string;
+    sourceKind: "default" | "preset" | "builtin";
+    sourceKey: string | null;
+    matchedScope: "provider" | "default" | "provider_series" | "series" | "global";
+    tiers: ({
+        kind: string;
+        fromAgeMs: number;
+        toAgeMs: number | null;
+        bucketMs?: undefined;
+        aggregations?: undefined;
+    } | {
+        kind: string;
+        fromAgeMs: number;
+        toAgeMs: number | null;
+        bucketMs: number;
+        aggregations: ("avg" | "min" | "max" | "last" | "count")[];
+    })[];
+}>>;
+export declare const replaceTimeSeriesPolicyConfiguration: import("convex/server").RegisteredMutation<"public", {
+    maintenance?: {
+        enabled?: boolean | undefined;
+        interval?: string | number | undefined;
+    } | undefined;
+    presets?: {
+        key: string;
+        rules: {
+            provider?: "garmin" | "suunto" | "polar" | "whoop" | "strava" | "apple" | "samsung" | "google" | undefined;
+            seriesType?: string | undefined;
+            tiers: ({
+                kind: "raw";
+                fromAge: string | number;
+                toAge: string | number | null;
+            } | {
+                aggregations?: ("avg" | "min" | "max" | "last" | "count")[] | undefined;
+                kind: "rollup";
+                fromAge: string | number;
+                toAge: string | number | null;
+                bucket: string | number;
+            })[];
+        }[];
+    }[] | undefined;
+    defaultRules: {
+        provider?: "garmin" | "suunto" | "polar" | "whoop" | "strava" | "apple" | "samsung" | "google" | undefined;
+        seriesType?: string | undefined;
+        tiers: ({
+            kind: "raw";
+            fromAge: string | number;
+            toAge: string | number | null;
+        } | {
+            aggregations?: ("avg" | "min" | "max" | "last" | "count")[] | undefined;
+            kind: "rollup";
+            fromAge: string | number;
+            toAge: string | number | null;
+            bucket: string | number;
+        })[];
+    }[];
+}, Promise<{
+    defaultRulesStored: number;
+    presetsStored: number;
+}>>;
+export declare const setUserTimeSeriesPolicyPreset: import("convex/server").RegisteredMutation<"public", {
+    userId: string;
+    presetKey: string | null;
+}, Promise<null>>;
 export declare const storeDataPoint: import("convex/server").RegisteredMutation<"internal", {
     externalId?: string | undefined;
+    dataSourceId: import("convex/values").GenericId<"dataSources">;
     seriesType: string;
     recordedAt: number;
     value: number;
-    dataSourceId: import("convex/values").GenericId<"dataSources">;
-}, Promise<import("convex/values").GenericId<"dataPoints">>>;
-/**
- * Store a batch of data points. Used by sync workflows.
- * Must complete within 1 second — caller is responsible for batch sizing.
- */
+}, Promise<Id<"dataPoints"> | null>>;
 export declare const storeBatch: import("convex/server").RegisteredMutation<"internal", {
-    seriesType: string;
     dataSourceId: import("convex/values").GenericId<"dataSources">;
+    seriesType: string;
     points: {
         externalId?: string | undefined;
         recordedAt: number;
         value: number;
     }[];
 }, Promise<number>>;
-/**
- * Delete all data points for a data source. Used during user/connection cleanup.
- */
+export declare const runTimeSeriesMaintenance: import("convex/server").RegisteredMutation<"internal", {}, Promise<null>>;
 export declare const deleteByDataSource: import("convex/server").RegisteredMutation<"internal", {
     dataSourceId: import("convex/values").GenericId<"dataSources">;
-}, Promise<void>>;
+}, Promise<null>>;
+export {};
 //# sourceMappingURL=dataPoints.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"dataPoints.d.ts","sourceRoot":"","sources":["../../src/component/dataPoints.ts"],"names":[],"mappings":"AAOA;;;GAGG;AACH,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;GAuDxB,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,oBAAoB;;;;;;;eAwBC,MAAM;WAAS,MAAM;KAsBrD,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,kBAAkB;;;;eAmBF,MAAM;WAAS,MAAM;cAAY,MAAM;UAsBlE,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,uBAAuB;;qBA0BlC,CAAC;AAMH;;GAEG;AACH,eAAO,MAAM,cAAc;;;;;;4DA4BzB,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,UAAU;;;;;;;;mBA0CrB,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,kBAAkB;;iBAmB7B,CAAC"}
+{"version":3,"file":"dataPoints.d.ts","sourceRoot":"","sources":["../../src/component/dataPoints.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAO,EAAE,EAAE,MAAM,wBAAwB,CAAC;AA6CtD,KAAK,eAAe,GAAG;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,KAAK,GAAG,QAAQ,CAAC;IAC9B,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,CAAC;AAwFF,eAAO,MAAM,aAAa;;;;;;;;;;;;GAsDxB,CAAC;AAEH,eAAO,MAAM,oBAAoB;;;;;;8BAoC/B,CAAC;AAEH,eAAO,MAAM,kBAAkB;;;;eAmBF,MAAM;WAAS,MAAM;cAAY,MAAM;UAiDlE,CAAC;AAEH,eAAO,MAAM,uBAAuB;;qBAWlC,CAAC;AAEH,eAAO,MAAM,gCAAgC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqB3C,CAAC;AAEH,eAAO,MAAM,6BAA6B;;;;;;UA4BxC,CAAC;AAEH,eAAO,MAAM,4BAA4B;;;;;;;;;;;;;;;;;;;;;;;GAwBvC,CAAC;AAMH,eAAO,MAAM,oCAAoC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0E/C,CAAC;AAEH,eAAO,MAAM,6BAA6B;;;iBA8CxC,CAAC;AAEH,eAAO,MAAM,cAAc;;;;;;oCAwBzB,CAAC;AAEH,eAAO,MAAM,UAAU;;;;;;;;mBAiBrB,CAAC;AAEH,eAAO,MAAM,wBAAwB,2EAuDnC,CAAC;AAEH,eAAO,MAAM,kBAAkB;;iBA4C7B,CAAC"}