@nativesquare/soma 0.16.3 → 0.16.5

package/src/client/index.ts

@@ -207,6 +207,40 @@ export class Soma {
     );
   }
 
+  /**
+   * Get per-table row counts and oldest-data timestamps for a user–provider pair.
+   *
+   * Returns an object with one entry per data table (activities, sleep, body,
+   * daily, nutrition, menstruation, plannedWorkouts). Each entry has a `count`
+   * and an `oldest` timestamp (ISO-8601 for time-series tables, YYYY-MM-DD for
+   * plannedWorkouts). `oldest` is `null` when the table has no rows.
+   *
+   * Stats are maintained automatically by ingest mutations, so this is an O(1)
+   * read regardless of how much data has been ingested.
+   *
+   * Returns `null` if the user has never connected to that provider.
+   *
+   * @param ctx - Query context from the host app
+   * @param args.userId - The host app's user identifier
+   * @param args.provider - The wearable provider name
+   *
+   * @example
+   * ```ts
+   * const stats = await soma.getProviderStats(ctx, {
+   *   userId: "user_123",
+   *   provider: "GARMIN",
+   * });
+   * // { activities: { count: 1203, oldest: "2023-02-14T06:12:00Z" },
+   * //   sleep: { count: 412, oldest: "2023-02-14T23:01:00Z" }, ... }
+   * ```
+   */
+  async getProviderStats(
+    ctx: QueryCtx,
+    args: { userId: string; provider: string },
+  ) {
+    return await ctx.runQuery(this.component.public.getProviderStats, args);
+  }
+
   /**
    * List all connections for a user (active and inactive).
    *

package/src/component/_generated/component.ts

@@ -866,6 +866,15 @@ export type ComponentApi<Name extends string | undefined = string | undefined> =
           lastDataUpdate?: string;
           provider: string;
           providerUserId?: string;
+          stats?: {
+            activities: { count: number; oldest: string | null };
+            body: { count: number; oldest: string | null };
+            daily: { count: number; oldest: string | null };
+            menstruation: { count: number; oldest: string | null };
+            nutrition: { count: number; oldest: string | null };
+            plannedWorkouts: { count: number; oldest: string | null };
+            sleep: { count: number; oldest: string | null };
+          };
           userId: string;
         },
         Name
@@ -881,6 +890,15 @@ export type ComponentApi<Name extends string | undefined = string | undefined> =
           lastDataUpdate?: string;
           provider: string;
           providerUserId?: string;
+          stats?: {
+            activities: { count: number; oldest: string | null };
+            body: { count: number; oldest: string | null };
+            daily: { count: number; oldest: string | null };
+            menstruation: { count: number; oldest: string | null };
+            nutrition: { count: number; oldest: string | null };
+            plannedWorkouts: { count: number; oldest: string | null };
+            sleep: { count: number; oldest: string | null };
+          };
           userId: string;
         },
         Name
@@ -892,6 +910,21 @@ export type ComponentApi<Name extends string | undefined = string | undefined> =
         any,
         Name
       >;
+      getProviderStats: FunctionReference<
+        "query",
+        "internal",
+        { provider: string; userId: string },
+        null | {
+          activities: { count: number; oldest: string | null };
+          body: { count: number; oldest: string | null };
+          daily: { count: number; oldest: string | null };
+          menstruation: { count: number; oldest: string | null };
+          nutrition: { count: number; oldest: string | null };
+          plannedWorkouts: { count: number; oldest: string | null };
+          sleep: { count: number; oldest: string | null };
+        },
+        Name
+      >;
       ingestActivity: FunctionReference<
         "mutation",
         "internal",
@@ -2021,6 +2054,15 @@ export type ComponentApi<Name extends string | undefined = string | undefined> =
           lastDataUpdate?: string;
           provider: string;
           providerUserId?: string;
+          stats?: {
+            activities: { count: number; oldest: string | null };
+            body: { count: number; oldest: string | null };
+            daily: { count: number; oldest: string | null };
+            menstruation: { count: number; oldest: string | null };
+            nutrition: { count: number; oldest: string | null };
+            plannedWorkouts: { count: number; oldest: string | null };
+            sleep: { count: number; oldest: string | null };
+          };
           userId: string;
         }>,
         Name