@nativesquare/soma 0.1.0

package/dist/healthkit/nutrition.d.ts

@@ -0,0 +1,77 @@
+import type { HKQuantitySample } from "./types.js";
+/**
+ * The output shape of {@link transformNutrition}.
+ */
+export type NutritionData = ReturnType<typeof transformNutrition>;
+/**
+ * Transform an array of HealthKit dietary quantity samples into a
+ * Soma Nutrition document shape.
+ *
+ * Accepts samples with dietary type identifiers (protein, carbs, fat, water,
+ * vitamins, minerals, etc.) and aggregates them into Soma's macros/micros
+ * summary format.
+ *
+ * @param samples - Array of HKQuantitySample with dietary type identifiers
+ * @param timeRange - Optional explicit time range; auto-detected from samples if omitted
+ * @returns Soma Nutrition fields (without connectionId/userId)
+ *
+ * @example
+ * ```ts
+ * const data = transformNutrition(hkDietarySamples);
+ * await soma.ingestNutrition(ctx, { connectionId, userId, ...data });
+ * ```
+ */
+export declare function transformNutrition(samples: HKQuantitySample[], timeRange?: {
+    start_time: string;
+    end_time: string;
+}): {
+    metadata: {
+        start_time: string;
+        end_time: string;
+    };
+    summary: {
+        macros: {
+            calories: number | undefined;
+            protein_g: number | undefined;
+            carbohydrates_g: number | undefined;
+            fat_g: number | undefined;
+            saturated_fat_g: number | undefined;
+            fiber_g: number | undefined;
+            sugar_g: number | undefined;
+            cholesterol_mg: number | undefined;
+            sodium_mg: number | undefined;
+        } | undefined;
+        micros: {
+            calcium_mg: number | undefined;
+            iron_mg: number | undefined;
+            potassium_mg: number | undefined;
+            vitamin_A_mg: number | undefined;
+            vitamin_B6_mg: number | undefined;
+            vitamin_B12_mg: number | undefined;
+            vitamin_C_mg: number | undefined;
+            vitamin_D_mg: number | undefined;
+            vitamin_E_mg: number | undefined;
+            vitamin_K_mg: number | undefined;
+            zinc_mg: number | undefined;
+            magnesium_mg: number | undefined;
+            manganese_mg: number | undefined;
+            copper_mg: number | undefined;
+            selenium_mg: number | undefined;
+            chromium_mg: number | undefined;
+            folate_mg: number | undefined;
+            biotin_mg: number | undefined;
+            niacin_mg: number | undefined;
+            phosphorus_mg: number | undefined;
+            riboflavin_mg: number | undefined;
+            thiamin_mg: number | undefined;
+            caffeine_mg: number | undefined;
+            iodine_mg: number | undefined;
+            chloride_mg: number | undefined;
+            pantothenic_acid_mg: number | undefined;
+            monounsaturated_fat_g: number | undefined;
+            polyunsaturated_fat_g: number | undefined;
+        } | undefined;
+        water_ml: number | undefined;
+    };
+};
+//# sourceMappingURL=nutrition.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"nutrition.d.ts","sourceRoot":"","sources":["../../src/healthkit/nutrition.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAGnD;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG,UAAU,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAElE;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,gBAAgB,EAAE,EAC3B,SAAS,CAAC,EAAE;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAkIrD"}

package/dist/healthkit/nutrition.js

@@ -0,0 +1,135 @@
+// ─── Nutrition Transformer ────────────────────────────────────────────────────
+// Transforms Apple HealthKit dietary quantity samples into the Soma Nutrition schema.
+import { filterByType, sumValues, sampleTimeRange } from "./utils.js";
+/**
+ * Transform an array of HealthKit dietary quantity samples into a
+ * Soma Nutrition document shape.
+ *
+ * Accepts samples with dietary type identifiers (protein, carbs, fat, water,
+ * vitamins, minerals, etc.) and aggregates them into Soma's macros/micros
+ * summary format.
+ *
+ * @param samples - Array of HKQuantitySample with dietary type identifiers
+ * @param timeRange - Optional explicit time range; auto-detected from samples if omitted
+ * @returns Soma Nutrition fields (without connectionId/userId)
+ *
+ * @example
+ * ```ts
+ * const data = transformNutrition(hkDietarySamples);
+ * await soma.ingestNutrition(ctx, { connectionId, userId, ...data });
+ * ```
+ */
+export function transformNutrition(samples, timeRange) {
+    const range = timeRange ?? sampleTimeRange(samples);
+    const sum = (type) => {
+        const filtered = filterByType(samples, type);
+        return filtered.length > 0 ? sumValues(filtered) : undefined;
+    };
+    // ── Macros ─────────────────────────────────────────────────────────────
+    const calories = sum("HKQuantityTypeIdentifierDietaryEnergyConsumed");
+    const protein = sum("HKQuantityTypeIdentifierDietaryProtein");
+    const carbs = sum("HKQuantityTypeIdentifierDietaryCarbohydrates");
+    const fat = sum("HKQuantityTypeIdentifierDietaryFatTotal");
+    const saturatedFat = sum("HKQuantityTypeIdentifierDietaryFatSaturated");
+    const fiber = sum("HKQuantityTypeIdentifierDietaryFiber");
+    const sugar = sum("HKQuantityTypeIdentifierDietarySugar");
+    const cholesterol = sum("HKQuantityTypeIdentifierDietaryCholesterol");
+    const sodium = sum("HKQuantityTypeIdentifierDietarySodium");
+    // ── Micros ─────────────────────────────────────────────────────────────
+    const calcium = sum("HKQuantityTypeIdentifierDietaryCalcium");
+    const iron = sum("HKQuantityTypeIdentifierDietaryIron");
+    const potassium = sum("HKQuantityTypeIdentifierDietaryPotassium");
+    const vitaminA = sum("HKQuantityTypeIdentifierDietaryVitaminA");
+    const vitaminB6 = sum("HKQuantityTypeIdentifierDietaryVitaminB6");
+    const vitaminB12 = sum("HKQuantityTypeIdentifierDietaryVitaminB12");
+    const vitaminC = sum("HKQuantityTypeIdentifierDietaryVitaminC");
+    const vitaminD = sum("HKQuantityTypeIdentifierDietaryVitaminD");
+    const vitaminE = sum("HKQuantityTypeIdentifierDietaryVitaminE");
+    const vitaminK = sum("HKQuantityTypeIdentifierDietaryVitaminK");
+    const zinc = sum("HKQuantityTypeIdentifierDietaryZinc");
+    const magnesium = sum("HKQuantityTypeIdentifierDietaryMagnesium");
+    const manganese = sum("HKQuantityTypeIdentifierDietaryManganese");
+    const copper = sum("HKQuantityTypeIdentifierDietaryCopper");
+    const selenium = sum("HKQuantityTypeIdentifierDietarySelenium");
+    const chromium = sum("HKQuantityTypeIdentifierDietaryChromium");
+    const folate = sum("HKQuantityTypeIdentifierDietaryFolate");
+    const biotin = sum("HKQuantityTypeIdentifierDietaryBiotin");
+    const niacin = sum("HKQuantityTypeIdentifierDietaryNiacin");
+    const phosphorus = sum("HKQuantityTypeIdentifierDietaryPhosphorus");
+    const riboflavin = sum("HKQuantityTypeIdentifierDietaryRiboflavin");
+    const thiamin = sum("HKQuantityTypeIdentifierDietaryThiamin");
+    const caffeine = sum("HKQuantityTypeIdentifierDietaryCaffeine");
+    const iodine = sum("HKQuantityTypeIdentifierDietaryIodine");
+    const chloride = sum("HKQuantityTypeIdentifierDietaryChloride");
+    const pantothenicAcid = sum("HKQuantityTypeIdentifierDietaryPanthothenicAcid");
+    // ── Fats breakdown ─────────────────────────────────────────────────────
+    const monoFat = sum("HKQuantityTypeIdentifierDietaryFatMonounsaturated");
+    const polyFat = sum("HKQuantityTypeIdentifierDietaryFatPolyunsaturated");
+    // ── Water ──────────────────────────────────────────────────────────────
+    const waterSamples = filterByType(samples, "HKQuantityTypeIdentifierDietaryWater");
+    const waterMl = waterSamples.length > 0 ? sumValues(waterSamples) * 1000 : undefined; // L → mL
+    const hasMacros = calories != null ||
+        protein != null ||
+        carbs != null ||
+        fat != null;
+    const hasMicros = calcium != null ||
+        iron != null ||
+        vitaminC != null ||
+        zinc != null ||
+        magnesium != null;
+    return {
+        metadata: {
+            start_time: range.start_time,
+            end_time: range.end_time,
+        },
+        summary: {
+            macros: hasMacros
+                ? {
+                    calories,
+                    protein_g: protein,
+                    carbohydrates_g: carbs,
+                    fat_g: fat,
+                    saturated_fat_g: saturatedFat,
+                    fiber_g: fiber,
+                    sugar_g: sugar,
+                    cholesterol_mg: cholesterol,
+                    sodium_mg: sodium,
+                }
+                : undefined,
+            micros: hasMicros
+                ? {
+                    calcium_mg: calcium,
+                    iron_mg: iron,
+                    potassium_mg: potassium,
+                    vitamin_A_mg: vitaminA,
+                    vitamin_B6_mg: vitaminB6,
+                    vitamin_B12_mg: vitaminB12,
+                    vitamin_C_mg: vitaminC,
+                    vitamin_D_mg: vitaminD,
+                    vitamin_E_mg: vitaminE,
+                    vitamin_K_mg: vitaminK,
+                    zinc_mg: zinc,
+                    magnesium_mg: magnesium,
+                    manganese_mg: manganese,
+                    copper_mg: copper,
+                    selenium_mg: selenium,
+                    chromium_mg: chromium,
+                    folate_mg: folate,
+                    biotin_mg: biotin,
+                    niacin_mg: niacin,
+                    phosphorus_mg: phosphorus,
+                    riboflavin_mg: riboflavin,
+                    thiamin_mg: thiamin,
+                    caffeine_mg: caffeine,
+                    iodine_mg: iodine,
+                    chloride_mg: chloride,
+                    pantothenic_acid_mg: pantothenicAcid,
+                    monounsaturated_fat_g: monoFat,
+                    polyunsaturated_fat_g: polyFat,
+                }
+                : undefined,
+            water_ml: waterMl,
+        },
+    };
+}
+//# sourceMappingURL=nutrition.js.map

package/dist/healthkit/nutrition.js.map

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

package/dist/healthkit/sleep.d.ts

@@ -0,0 +1,60 @@
+import type { HKCategorySample } from "./types.js";
+/**
+ * The output shape of {@link transformSleep}.
+ */
+export type SleepData = ReturnType<typeof transformSleep>;
+/**
+ * Transform an array of HealthKit sleep analysis category samples into a
+ * Soma Sleep document shape.
+ *
+ * HealthKit stores sleep as individual `HKCategorySample` records — one per
+ * sleep stage segment. This function aggregates them into a single session
+ * with computed durations, a hypnogram, and efficiency score.
+ *
+ * @param samples - Array of HKCategorySample with sampleType "HKCategoryTypeIdentifierSleepAnalysis".
+ *                  Should represent a single sleep session (all samples from one night).
+ * @returns Soma Sleep fields (without connectionId/userId)
+ *
+ * @example
+ * ```ts
+ * const data = transformSleep(hkSleepSamples);
+ * await soma.ingestSleep(ctx, { connectionId, userId, ...data });
+ * ```
+ */
+export declare function transformSleep(samples: HKCategorySample[]): {
+    metadata: {
+        start_time: string;
+        end_time: string;
+        summary_id: string;
+        upload_type: 2;
+        is_nap: boolean;
+    };
+    device_data: {
+        name?: string;
+        manufacturer?: string;
+        hardware_version?: string;
+        software_version?: string;
+    } | undefined;
+    sleep_durations_data: {
+        asleep: {
+            duration_asleep_state_seconds: number;
+            duration_deep_sleep_state_seconds: number | undefined;
+            duration_light_sleep_state_seconds: number | undefined;
+            duration_REM_sleep_state_seconds: number | undefined;
+            num_REM_events: number | undefined;
+        };
+        awake: {
+            duration_awake_state_seconds: number | undefined;
+            num_wakeup_events: number | undefined;
+        };
+        hypnogram_samples: {
+            timestamp: string;
+            level: number;
+        }[] | undefined;
+        other: {
+            duration_in_bed_seconds: number;
+        };
+        sleep_efficiency: number | undefined;
+    };
+};
+//# sourceMappingURL=sleep.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sleep.d.ts","sourceRoot":"","sources":["../../src/healthkit/sleep.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAKnD;;GAEG;AACH,MAAM,MAAM,SAAS,GAAG,UAAU,CAAC,OAAO,cAAc,CAAC,CAAC;AAE1D;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,gBAAgB,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAwGzD"}

package/dist/healthkit/sleep.js

@@ -0,0 +1,108 @@
+// ─── Sleep Transformer ───────────────────────────────────────────────────────
+// Transforms Apple HealthKit sleep analysis samples into the Soma Sleep schema.
+import { HKSleepCategory } from "./types.js";
+import { mapSleepLevel, isAsleepCategory } from "./maps/sleep-level.js";
+import { diffSeconds, buildDeviceData } from "./utils.js";
+/**
+ * Transform an array of HealthKit sleep analysis category samples into a
+ * Soma Sleep document shape.
+ *
+ * HealthKit stores sleep as individual `HKCategorySample` records — one per
+ * sleep stage segment. This function aggregates them into a single session
+ * with computed durations, a hypnogram, and efficiency score.
+ *
+ * @param samples - Array of HKCategorySample with sampleType "HKCategoryTypeIdentifierSleepAnalysis".
+ *                  Should represent a single sleep session (all samples from one night).
+ * @returns Soma Sleep fields (without connectionId/userId)
+ *
+ * @example
+ * ```ts
+ * const data = transformSleep(hkSleepSamples);
+ * await soma.ingestSleep(ctx, { connectionId, userId, ...data });
+ * ```
+ */
+export function transformSleep(samples) {
+    if (samples.length === 0) {
+        throw new Error("transformSleep requires at least one sleep sample");
+    }
+    // Sort by start time
+    const sorted = [...samples].sort((a, b) => new Date(a.startDate).getTime() - new Date(b.startDate).getTime());
+    const sessionStart = sorted[0].startDate;
+    const sessionEnd = sorted[sorted.length - 1].endDate;
+    // Compute stage durations
+    let deepSeconds = 0;
+    let lightSeconds = 0;
+    let remSeconds = 0;
+    let awakeSeconds = 0;
+    let asleepUnspecifiedSeconds = 0;
+    let inBedSeconds = 0;
+    let wakeupEvents = 0;
+    let remEvents = 0;
+    for (const sample of sorted) {
+        const duration = diffSeconds(sample.startDate, sample.endDate);
+        switch (sample.value) {
+            case HKSleepCategory.AsleepDeep:
+                deepSeconds += duration;
+                break;
+            case HKSleepCategory.AsleepCore:
+                lightSeconds += duration;
+                break;
+            case HKSleepCategory.AsleepREM:
+                remSeconds += duration;
+                remEvents++;
+                break;
+            case HKSleepCategory.Awake:
+                awakeSeconds += duration;
+                wakeupEvents++;
+                break;
+            case HKSleepCategory.AsleepUnspecified:
+                asleepUnspecifiedSeconds += duration;
+                break;
+            case HKSleepCategory.InBed:
+                inBedSeconds += duration;
+                break;
+        }
+    }
+    const totalAsleepSeconds = deepSeconds + lightSeconds + remSeconds + asleepUnspecifiedSeconds;
+    const totalInBedSeconds = diffSeconds(sessionStart, sessionEnd);
+    const sleepEfficiency = totalInBedSeconds > 0 ? totalAsleepSeconds / totalInBedSeconds : undefined;
+    // Build hypnogram
+    const hypnogramSamples = sorted
+        .filter((s) => s.value !== HKSleepCategory.InBed)
+        .map((s) => ({
+        timestamp: s.startDate,
+        level: mapSleepLevel(s.value),
+    }));
+    // Determine if this is a nap (< 3 hours)
+    const isNap = totalInBedSeconds < 3 * 60 * 60;
+    const firstSample = sorted[0];
+    return {
+        metadata: {
+            start_time: sessionStart,
+            end_time: sessionEnd,
+            summary_id: firstSample.uuid,
+            upload_type: 2, // Automatic
+            is_nap: isNap,
+        },
+        device_data: buildDeviceData(firstSample.source, firstSample.device),
+        sleep_durations_data: {
+            asleep: {
+                duration_asleep_state_seconds: totalAsleepSeconds,
+                duration_deep_sleep_state_seconds: deepSeconds > 0 ? deepSeconds : undefined,
+                duration_light_sleep_state_seconds: lightSeconds > 0 ? lightSeconds : undefined,
+                duration_REM_sleep_state_seconds: remSeconds > 0 ? remSeconds : undefined,
+                num_REM_events: remEvents > 0 ? remEvents : undefined,
+            },
+            awake: {
+                duration_awake_state_seconds: awakeSeconds > 0 ? awakeSeconds : undefined,
+                num_wakeup_events: wakeupEvents > 0 ? wakeupEvents : undefined,
+            },
+            hypnogram_samples: hypnogramSamples.length > 0 ? hypnogramSamples : undefined,
+            other: {
+                duration_in_bed_seconds: totalInBedSeconds,
+            },
+            sleep_efficiency: sleepEfficiency,
+        },
+    };
+}
+//# sourceMappingURL=sleep.js.map

package/dist/healthkit/sleep.js.map

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

package/dist/healthkit/types.d.ts

@@ -0,0 +1,94 @@
+export interface HKDevice {
+    name?: string;
+    manufacturer?: string;
+    model?: string;
+    hardwareVersion?: string;
+    softwareVersion?: string;
+}
+export interface HKSource {
+    name: string;
+    bundleIdentifier: string;
+}
+export interface HKQuantitySample {
+    uuid: string;
+    sampleType: HKQuantityTypeIdentifier;
+    startDate: string;
+    endDate: string;
+    value: number;
+    unit: string;
+    source?: HKSource;
+    device?: HKDevice;
+}
+export interface HKCategorySample {
+    uuid: string;
+    sampleType: HKCategoryTypeIdentifier;
+    startDate: string;
+    endDate: string;
+    value: number;
+    source?: HKSource;
+    device?: HKDevice;
+}
+export interface HKWorkoutRoute {
+    locations: Array<{
+        latitude: number;
+        longitude: number;
+        altitude?: number;
+        timestamp: string;
+    }>;
+}
+export interface HKWorkout {
+    uuid: string;
+    workoutActivityType: number;
+    startDate: string;
+    endDate: string;
+    duration: number;
+    totalEnergyBurned?: number;
+    totalDistance?: number;
+    totalSwimmingStrokeCount?: number;
+    totalFlightsClimbed?: number;
+    source?: HKSource;
+    device?: HKDevice;
+    heartRateSamples?: HKQuantitySample[];
+    routeData?: HKWorkoutRoute[];
+}
+export interface HKActivitySummary {
+    activeEnergyBurned: number;
+    activeEnergyBurnedGoal: number;
+    appleExerciseTime: number;
+    appleExerciseTimeGoal: number;
+    appleStandHours: number;
+    appleStandHoursGoal: number;
+    dateComponents: {
+        year: number;
+        month: number;
+        day: number;
+    };
+}
+export interface HKCharacteristics {
+    biologicalSex?: HKBiologicalSex;
+    dateOfBirth?: string;
+    bloodType?: string;
+    fitzpatrickSkinType?: number;
+    wheelchairUse?: boolean;
+}
+export type HKBiologicalSex = "female" | "male" | "other" | "notSet";
+export type HKQuantityTypeIdentifier = "HKQuantityTypeIdentifierBodyMass" | "HKQuantityTypeIdentifierHeight" | "HKQuantityTypeIdentifierBodyMassIndex" | "HKQuantityTypeIdentifierBodyFatPercentage" | "HKQuantityTypeIdentifierLeanBodyMass" | "HKQuantityTypeIdentifierHeartRate" | "HKQuantityTypeIdentifierRestingHeartRate" | "HKQuantityTypeIdentifierHeartRateVariabilitySDNN" | "HKQuantityTypeIdentifierHeartRateRecoveryOneMinute" | "HKQuantityTypeIdentifierBloodPressureSystolic" | "HKQuantityTypeIdentifierBloodPressureDiastolic" | "HKQuantityTypeIdentifierOxygenSaturation" | "HKQuantityTypeIdentifierVO2Max" | "HKQuantityTypeIdentifierRespiratoryRate" | "HKQuantityTypeIdentifierBloodGlucose" | "HKQuantityTypeIdentifierBodyTemperature" | "HKQuantityTypeIdentifierStepCount" | "HKQuantityTypeIdentifierDistanceWalkingRunning" | "HKQuantityTypeIdentifierDistanceCycling" | "HKQuantityTypeIdentifierDistanceSwimming" | "HKQuantityTypeIdentifierActiveEnergyBurned" | "HKQuantityTypeIdentifierBasalEnergyBurned" | "HKQuantityTypeIdentifierFlightsClimbed" | "HKQuantityTypeIdentifierAppleExerciseTime" | "HKQuantityTypeIdentifierAppleStandTime" | "HKQuantityTypeIdentifierDietaryEnergyConsumed" | "HKQuantityTypeIdentifierDietaryProtein" | "HKQuantityTypeIdentifierDietaryCarbohydrates" | "HKQuantityTypeIdentifierDietaryFatTotal" | "HKQuantityTypeIdentifierDietaryFatSaturated" | "HKQuantityTypeIdentifierDietaryFatMonounsaturated" | "HKQuantityTypeIdentifierDietaryFatPolyunsaturated" | "HKQuantityTypeIdentifierDietaryCholesterol" | "HKQuantityTypeIdentifierDietarySodium" | "HKQuantityTypeIdentifierDietarySugar" | "HKQuantityTypeIdentifierDietaryFiber" | "HKQuantityTypeIdentifierDietaryWater" | "HKQuantityTypeIdentifierDietaryCalcium" | "HKQuantityTypeIdentifierDietaryIron" | "HKQuantityTypeIdentifierDietaryPotassium" | "HKQuantityTypeIdentifierDietaryVitaminA" | "HKQuantityTypeIdentifierDietaryVitaminB6" | "HKQuantityTypeIdentifierDietaryVitaminB12" | "HKQuantityTypeIdentifierDietaryVitaminC" | "HKQuantityTypeIdentifierDietaryVitaminD" | "HKQuantityTypeIdentifierDietaryVitaminE" | "HKQuantityTypeIdentifierDietaryVitaminK" | "HKQuantityTypeIdentifierDietaryZinc" | "HKQuantityTypeIdentifierDietaryMagnesium" | "HKQuantityTypeIdentifierDietaryManganese" | "HKQuantityTypeIdentifierDietaryCopper" | "HKQuantityTypeIdentifierDietarySelenium" | "HKQuantityTypeIdentifierDietaryChromium" | "HKQuantityTypeIdentifierDietaryFolate" | "HKQuantityTypeIdentifierDietaryBiotin" | "HKQuantityTypeIdentifierDietaryNiacin" | "HKQuantityTypeIdentifierDietaryPhosphorus" | "HKQuantityTypeIdentifierDietaryRiboflavin" | "HKQuantityTypeIdentifierDietaryThiamin" | "HKQuantityTypeIdentifierDietaryCaffeine" | "HKQuantityTypeIdentifierDietaryIodine" | "HKQuantityTypeIdentifierDietaryChloride" | "HKQuantityTypeIdentifierDietaryPanthothenicAcid" | (string & {});
+export type HKCategoryTypeIdentifier = "HKCategoryTypeIdentifierSleepAnalysis" | "HKCategoryTypeIdentifierMenstrualFlow" | "HKCategoryTypeIdentifierAppleStandHour" | (string & {});
+export declare const HKSleepCategory: {
+    readonly InBed: 0;
+    readonly AsleepUnspecified: 1;
+    readonly Awake: 2;
+    readonly AsleepCore: 3;
+    readonly AsleepDeep: 4;
+    readonly AsleepREM: 5;
+};
+export type HKSleepCategoryValue = (typeof HKSleepCategory)[keyof typeof HKSleepCategory];
+export declare const HKMenstrualFlowCategory: {
+    readonly Unspecified: 1;
+    readonly Light: 2;
+    readonly Medium: 3;
+    readonly Heavy: 4;
+    readonly None: 5;
+};
+export type HKMenstrualFlowCategoryValue = (typeof HKMenstrualFlowCategory)[keyof typeof HKMenstrualFlowCategory];
+//# sourceMappingURL=types.d.ts.map

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

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

package/dist/healthkit/types.js

@@ -0,0 +1,26 @@
+// ─── Apple HealthKit Input Types ──────────────────────────────────────────────
+// Library-agnostic TypeScript interfaces representing HealthKit data shapes.
+// Compatible with @kingstinct/react-native-healthkit, react-native-health,
+// expo-health, or any custom native module.
+//
+// These types define the CONTRACT that the host app must satisfy when passing
+// HealthKit data to Soma's transformer functions. They intentionally do NOT
+// depend on any specific React Native library.
+// ─── HealthKit Sleep Category Values ─────────────────────────────────────────
+export const HKSleepCategory = {
+    InBed: 0,
+    AsleepUnspecified: 1,
+    Awake: 2,
+    AsleepCore: 3,
+    AsleepDeep: 4,
+    AsleepREM: 5,
+};
+// ─── HealthKit Menstrual Flow Values ─────────────────────────────────────────
+export const HKMenstrualFlowCategory = {
+    Unspecified: 1,
+    Light: 2,
+    Medium: 3,
+    Heavy: 4,
+    None: 5,
+};
+//# sourceMappingURL=types.js.map

package/dist/healthkit/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/healthkit/types.ts"],"names":[],"mappings":"AAAA,iFAAiF;AACjF,6EAA6E;AAC7E,2EAA2E;AAC3E,4CAA4C;AAC5C,EAAE;AACF,8EAA8E;AAC9E,4EAA4E;AAC5E,+CAA+C;AA0L/C,gFAAgF;AAEhF,MAAM,CAAC,MAAM,eAAe,GAAG;IAC7B,KAAK,EAAE,CAAC;IACR,iBAAiB,EAAE,CAAC;IACpB,KAAK,EAAE,CAAC;IACR,UAAU,EAAE,CAAC;IACb,UAAU,EAAE,CAAC;IACb,SAAS,EAAE,CAAC;CACJ,CAAC;AAKX,gFAAgF;AAEhF,MAAM,CAAC,MAAM,uBAAuB,GAAG;IACrC,WAAW,EAAE,CAAC;IACd,KAAK,EAAE,CAAC;IACR,MAAM,EAAE,CAAC;IACT,KAAK,EAAE,CAAC;IACR,IAAI,EAAE,CAAC;CACC,CAAC"}

package/dist/healthkit/utils.d.ts

@@ -0,0 +1,63 @@
+import type { HKDevice, HKQuantitySample, HKSource } from "./types.js";
+/**
+ * Compute the difference in seconds between two ISO-8601 timestamps.
+ */
+export declare function diffSeconds(start: string, end: string): number;
+/**
+ * Build the start-of-day and end-of-day ISO-8601 strings for a date.
+ */
+export declare function dayRange(date: {
+    year: number;
+    month: number;
+    day: number;
+}): {
+    start_time: string;
+    end_time: string;
+};
+/**
+ * Find the earliest startDate and latest endDate in an array of samples.
+ * Returns ISO-8601 strings. Falls back to provided defaults if array is empty.
+ */
+export declare function sampleTimeRange(samples: Array<{
+    startDate: string;
+    endDate: string;
+}>, fallback?: {
+    start_time: string;
+    end_time: string;
+}): {
+    start_time: string;
+    end_time: string;
+};
+/**
+ * Build a Soma DeviceData object from HealthKit source and device metadata.
+ */
+export declare function buildDeviceData(source?: HKSource, device?: HKDevice): {
+    name?: string;
+    manufacturer?: string;
+    hardware_version?: string;
+    software_version?: string;
+} | undefined;
+/**
+ * Filter an array of HKQuantitySamples by sampleType identifier.
+ */
+export declare function filterByType(samples: HKQuantitySample[], sampleType: string): HKQuantitySample[];
+/**
+ * Sum the values of quantity samples.
+ */
+export declare function sumValues(samples: HKQuantitySample[]): number;
+/**
+ * Average the values of quantity samples.
+ * Returns undefined if the array is empty.
+ */
+export declare function avgValue(samples: HKQuantitySample[]): number | undefined;
+/**
+ * Min value in a set of quantity samples.
+ * Returns undefined if the array is empty.
+ */
+export declare function minValue(samples: HKQuantitySample[]): number | undefined;
+/**
+ * Max value in a set of quantity samples.
+ * Returns undefined if the array is empty.
+ */
+export declare function maxValue(samples: HKQuantitySample[]): number | undefined;
+//# sourceMappingURL=utils.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/healthkit/utils.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,QAAQ,EAAE,gBAAgB,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAEvE;;GAEG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAE9D;AAED;;GAEG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;CACb,GAAG;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAO3C;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAC7B,OAAO,EAAE,KAAK,CAAC;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC,EACtD,QAAQ,CAAC,EAAE;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GAClD;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAmB1C;AAED;;GAEG;AACH,wBAAgB,eAAe,CAC7B,MAAM,CAAC,EAAE,QAAQ,EACjB,MAAM,CAAC,EAAE,QAAQ,GAEf;IACE,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B,GACD,SAAS,CAQZ;AAED;;GAEG;AACH,wBAAgB,YAAY,CAC1B,OAAO,EAAE,gBAAgB,EAAE,EAC3B,UAAU,EAAE,MAAM,GACjB,gBAAgB,EAAE,CAEpB;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,OAAO,EAAE,gBAAgB,EAAE,GAAG,MAAM,CAE7D;AAED;;;GAGG;AACH,wBAAgB,QAAQ,CAAC,OAAO,EAAE,gBAAgB,EAAE,GAAG,MAAM,GAAG,SAAS,CAGxE;AAED;;;GAGG;AACH,wBAAgB,QAAQ,CAAC,OAAO,EAAE,gBAAgB,EAAE,GAAG,MAAM,GAAG,SAAS,CAGxE;AAED;;;GAGG;AACH,wBAAgB,QAAQ,CAAC,OAAO,EAAE,gBAAgB,EAAE,GAAG,MAAM,GAAG,SAAS,CAGxE"}