@nativesquare/soma 0.16.2 → 0.16.3

package/dist/client/healthkit.d.ts

@@ -1,5 +1,5 @@
 import type { SomaComponent } from "./index.js";
-import type { MutationCtx, SomaResult } from "./types.js";
+import type { MutationCtx, SomaError, SomaResult } from "./types.js";
 import type { HKWorkout, HKCategorySample, HKQuantitySample, HKActivitySummary, HKCharacteristics } from "../component/healthkit/types.js";
 /**
  * Client class for Apple HealthKit integration with Soma.
@@ -7,8 +7,8 @@ import type { HKWorkout, HKCategorySample, HKQuantitySample, HKActivitySummary,
  * Unlike {@link import("./strava.js").SomaStrava | SomaStrava} and
  * {@link import("./garmin.js").SomaGarmin | SomaGarmin}, HealthKit is an
  * on-device provider — data is queried locally on iOS, not fetched from a
- * cloud API. This class wraps the transform + ingest pipeline so the host
- * app gets the same ergonomic interface as cloud providers.
+ * cloud API. This class is a thin wrapper over the component's public
+ * mutations, which own the transform + ingest pipeline.
  *
  * Because HealthKit permissions are managed in iOS Settings, the server
  * cannot independently verify whether the user has granted or revoked
@@ -57,10 +57,6 @@ export declare class SomaHealthKit {
      * permissions were granted. Creates the APPLE connection if missing,
      * or re-activates it if previously disconnected. Idempotent.
      *
-     * Because iOS permission grants happen on-device, the server cannot
-     * verify them independently — this method records the host app's
-     * assertion that the user has authorized HealthKit access.
-     *
      * @param ctx - Mutation context from the host app
      * @param args.userId - The host app's user identifier
      * @returns The connection document ID
@@ -90,10 +86,6 @@ export declare class SomaHealthKit {
      *
      * Transforms each `HKWorkout` into the Soma Activity schema and ingests it
      * with automatic deduplication by `workout.uuid`.
-     *
-     * @param ctx - Mutation (or action) context from the host app
-     * @param args.userId - The host app's user identifier
-     * @param args.workouts - Array of HKWorkout objects from HealthKit
      */
     syncActivities(ctx: MutationCtx, args: {
         userId: string;
@@ -107,10 +99,6 @@ export declare class SomaHealthKit {
      * Each inner array represents one sleep session (all `HKCategorySample`
      * stage records for a single night). Each session is aggregated into a
      * single Soma Sleep document.
-     *
-     * @param ctx - Mutation (or action) context from the host app
-     * @param args.userId - The host app's user identifier
-     * @param args.sessions - Array of sessions, each an array of sleep-stage samples
      */
     syncSleep(ctx: MutationCtx, args: {
         userId: string;
@@ -124,11 +112,6 @@ export declare class SomaHealthKit {
      * Accepts a mixed array of body-related quantity samples (heart rate, HRV,
      * blood pressure, SpO2, weight, etc.) for a single time window and produces
      * one Soma Body document.
-     *
-     * @param ctx - Mutation (or action) context from the host app
-     * @param args.userId - The host app's user identifier
-     * @param args.samples - Array of HKQuantitySample for the desired time range
-     * @param args.timeRange - Optional explicit time range; auto-detected from samples if omitted
      */
     syncBody(ctx: MutationCtx, args: {
         userId: string;
@@ -142,14 +125,6 @@ export declare class SomaHealthKit {
     }>>;
     /**
      * Sync daily activity data from HealthKit quantity samples.
-     *
-     * Accepts samples for a single day (steps, distance, energy, exercise time,
-     * heart rate, etc.) and produces one Soma Daily document.
-     *
-     * @param ctx - Mutation (or action) context from the host app
-     * @param args.userId - The host app's user identifier
-     * @param args.samples - Array of HKQuantitySample for the desired day
-     * @param args.timeRange - Optional explicit time range; auto-detected from samples if omitted
      */
     syncDaily(ctx: MutationCtx, args: {
         userId: string;
@@ -163,13 +138,6 @@ export declare class SomaHealthKit {
     }>>;
     /**
      * Sync daily activity data from HealthKit activity ring summaries.
-     *
-     * Each `HKActivitySummary` represents one day's activity rings (Move,
-     * Exercise, Stand). Each summary produces one Soma Daily document.
-     *
-     * @param ctx - Mutation (or action) context from the host app
-     * @param args.userId - The host app's user identifier
-     * @param args.summaries - Array of HKActivitySummary from HealthKit
      */
     syncDailyFromSummary(ctx: MutationCtx, args: {
         userId: string;
@@ -179,14 +147,6 @@ export declare class SomaHealthKit {
     }>>;
     /**
      * Sync nutrition data from HealthKit.
-     *
-     * Accepts dietary quantity samples for a single time window and produces
-     * one Soma Nutrition document with macros and micros.
-     *
-     * @param ctx - Mutation (or action) context from the host app
-     * @param args.userId - The host app's user identifier
-     * @param args.samples - Array of HKQuantitySample with dietary type identifiers
-     * @param args.timeRange - Optional explicit time range; auto-detected from samples if omitted
      */
     syncNutrition(ctx: MutationCtx, args: {
         userId: string;
@@ -200,14 +160,6 @@ export declare class SomaHealthKit {
     }>>;
     /**
      * Sync menstruation data from HealthKit.
-     *
-     * Accepts menstrual flow category samples for a single time window and
-     * produces one Soma Menstruation document.
-     *
-     * @param ctx - Mutation (or action) context from the host app
-     * @param args.userId - The host app's user identifier
-     * @param args.samples - Array of HKCategorySample with menstrual flow values
-     * @param args.timeRange - Optional explicit time range; auto-detected from samples if omitted
      */
     syncMenstruation(ctx: MutationCtx, args: {
         userId: string;
@@ -224,10 +176,6 @@ export declare class SomaHealthKit {
      *
      * HealthKit exposes limited profile data (biological sex, date of birth).
      * Produces one Soma Athlete document per connection.
-     *
-     * @param ctx - Mutation (or action) context from the host app
-     * @param args.userId - The host app's user identifier
-     * @param args.characteristics - The HKCharacteristics from HealthKit
      */
     syncAthlete(ctx: MutationCtx, args: {
         userId: string;
@@ -241,17 +189,6 @@ export declare class SomaHealthKit {
      * Only data types with values provided are synced. Errors from individual
      * data types are collected — one failing type does not block others.
      *
-     * @param ctx - Mutation (or action) context from the host app
-     * @param args.userId - The host app's user identifier
-     * @param args.workouts - Optional array of HKWorkout objects
-     * @param args.sleepSessions - Optional array of sleep sessions (each an array of stage samples)
-     * @param args.bodySamples - Optional body-related quantity samples
-     * @param args.dailySamples - Optional daily activity quantity samples
-     * @param args.dailySummaries - Optional daily activity ring summaries
-     * @param args.nutritionSamples - Optional dietary quantity samples
-     * @param args.menstruationSamples - Optional menstrual flow category samples
-     * @param args.characteristics - Optional user characteristics
-     *
      * @example
      * ```ts
      * const result = await soma.healthkit.syncAll(ctx, {
@@ -291,23 +228,6 @@ export declare class SomaHealthKit {
         };
         characteristics?: HKCharacteristics;
     }): Promise<SomaResult<Record<string, number>>>;
-    /**
-     * Load the active APPLE connection for a user, or throw if missing/inactive.
-     *
-     * HealthKit permissions are managed on-device, so the connection state is
-     * an assertion made by the host app via {@link SomaHealthKit.connect} and
-     * {@link SomaHealthKit.disconnect}. Sync methods refuse to run without an
-     * active connection — the host app must explicitly reconnect to resume.
-     */
-    private requireActiveConnection;
-    private updateLastDataUpdate;
-    private syncActivitiesInternal;
-    private syncSleepInternal;
-    private syncBodyInternal;
-    private syncDailyInternal;
-    private syncDailyFromSummaryInternal;
-    private syncNutritionInternal;
-    private syncMenstruationInternal;
-    private syncAthleteInternal;
 }
+export type { SomaError };
 //# sourceMappingURL=healthkit.d.ts.map

package/dist/client/healthkit.d.ts.map

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