trainbud 0.5.0

package/dist/garmin/daily.js

@@ -0,0 +1,96 @@
+import { fetchDailyStress, fetchMaxMetrics, mapDailyStress, mapMaxMetrics, } from "./rawApi.js";
+import { average, formatIsoDate } from "../utils/helpers.js";
+// SECTION: Mappers
+export function mapSleepData(date, sleepData) {
+    const dailySleep = sleepData.dailySleepDTO;
+    if (!dailySleep) {
+        return null;
+    }
+    return {
+        date: formatIsoDate(date),
+        totalSleepSeconds: dailySleep.sleepTimeSeconds,
+        deepSleepSeconds: dailySleep.deepSleepSeconds,
+        lightSleepSeconds: dailySleep.lightSleepSeconds,
+        remSleepSeconds: dailySleep.remSleepSeconds,
+        awakeCount: dailySleep.awakeCount,
+        sleepScore: dailySleep.sleepScores?.overall?.value ?? null,
+        avgSleepStress: dailySleep.avgSleepStress ?? null,
+        avgOvernightHrv: sleepData.avgOvernightHrv ?? null,
+        hrvStatus: sleepData.hrvStatus ?? null,
+    };
+}
+export function mapHeartRateData(date, heartRate) {
+    if (!heartRate) {
+        return null;
+    }
+    // Connect returns null entries inside heartRateValues, and null rows in place
+    // of whole buckets. Both crashed this on a real account before the guard.
+    const samples = (heartRate.heartRateValues ?? [])
+        .flat()
+        .filter((entry) => entry != null)
+        .map((entry) => entry.heartrate);
+    const averageHeartRate = samples.length > 0 ? average(samples) : null;
+    if (heartRate.restingHeartRate == null && averageHeartRate == null) {
+        return null;
+    }
+    return {
+        date: formatIsoDate(date),
+        restingHeartRate: heartRate.restingHeartRate ?? null,
+        maxHeartRate: heartRate.maxHeartRate ?? null,
+        minHeartRate: heartRate.minHeartRate ?? null,
+        averageHeartRate,
+    };
+}
+/**
+ * Connect omits these for activities they do not apply to -- strength training
+ * reports no distance or pace, an indoor ride no elevation. They were once
+ * typed as plain numbers, which type-checked while crashing on
+ * `undefined.toFixed`.
+ */
+export function mapActivity(activity) {
+    return {
+        activityId: activity.activityId,
+        name: activity.activityName,
+        type: activity.activityType.typeKey,
+        startTimeLocal: activity.startTimeLocal,
+        distanceMeters: activity.distance ?? null,
+        durationSeconds: activity.duration ?? null,
+        averageHeartRate: activity.averageHR ?? null,
+        maxHeartRate: activity.maxHR ?? null,
+        elevationGainMeters: activity.elevationGain ?? null,
+        calories: activity.calories ?? null,
+        averageSpeedMps: activity.averageSpeed ?? null,
+    };
+}
+export function mapWeightData(date, weightData) {
+    return weightData.dateWeightList.map((entry) => ({
+        date: entry.calendarDate || formatIsoDate(date),
+        weightKg: entry.weight ?? null,
+        bodyFatPercent: entry.bodyFat ?? null,
+        muscleMassKg: entry.muscleMass ?? null,
+        bmi: entry.bmi ?? null,
+    }));
+}
+// SECTION: Fetchers
+export async function fetchSleepDay(client, date) {
+    const raw = await client.getSleepData(date);
+    return { raw, mapped: mapSleepData(date, raw) };
+}
+export async function fetchHeartRateDay(client, date) {
+    const raw = await client.getHeartRate(date);
+    return { raw, mapped: mapHeartRateData(date, raw) };
+}
+export async function fetchStressDay(client, date) {
+    const raw = await fetchDailyStress(client, date);
+    return { raw, mapped: mapDailyStress(date, raw) };
+}
+export async function fetchVo2MaxDay(client, date) {
+    const raw = await fetchMaxMetrics(client, date);
+    return { raw, mapped: mapMaxMetrics(date, raw) };
+}
+export async function fetchBodyCompositionDay(client, date) {
+    const raw = await client.getDailyWeightData(date);
+    const mapped = mapWeightData(date, raw);
+    return { raw, mapped: mapped.length > 0 ? mapped : null };
+}
+//# sourceMappingURL=daily.js.map

package/dist/garmin/daily.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"daily.js","sourceRoot":"","sources":["../../src/garmin/daily.ts"],"names":[],"mappings":"AAOA,OAAO,EACL,gBAAgB,EAChB,eAAe,EACf,cAAc,EACd,aAAa,GAGd,MAAM,aAAa,CAAC;AAOrB,OAAO,EAAE,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAmB7D,mBAAmB;AAEnB,MAAM,UAAU,YAAY,CAAC,IAAU,EAAE,SAAoB;IAC3D,MAAM,UAAU,GAAG,SAAS,CAAC,aAAa,CAAC;IAE3C,IAAI,CAAC,UAAU,EAAE,CAAC;QAChB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,OAAO;QACL,IAAI,EAAE,aAAa,CAAC,IAAI,CAAC;QACzB,iBAAiB,EAAE,UAAU,CAAC,gBAAgB;QAC9C,gBAAgB,EAAE,UAAU,CAAC,gBAAgB;QAC7C,iBAAiB,EAAE,UAAU,CAAC,iBAAiB;QAC/C,eAAe,EAAE,UAAU,CAAC,eAAe;QAC3C,UAAU,EAAE,UAAU,CAAC,UAAU;QACjC,UAAU,EAAE,UAAU,CAAC,WAAW,EAAE,OAAO,EAAE,KAAK,IAAI,IAAI;QAC1D,cAAc,EAAE,UAAU,CAAC,cAAc,IAAI,IAAI;QACjD,eAAe,EAAE,SAAS,CAAC,eAAe,IAAI,IAAI;QAClD,SAAS,EAAE,SAAS,CAAC,SAAS,IAAI,IAAI;KACvC,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,gBAAgB,CAC9B,IAAU,EACV,SAA+B;IAE/B,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,OAAO,IAAI,CAAC;IACd,CAAC;IAED,8EAA8E;IAC9E,0EAA0E;IAC1E,MAAM,OAAO,GAAG,CAAC,SAAS,CAAC,eAAe,IAAI,EAAE,CAAC;SAC9C,IAAI,EAAE;SACN,MAAM,CAAC,CAAC,KAAK,EAAkC,EAAE,CAAC,KAAK,IAAI,IAAI,CAAC;SAChE,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;IAEnC,MAAM,gBAAgB,GAAG,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IAEtE,IAAI,SAAS,CAAC,gBAAgB,IAAI,IAAI,IAAI,gBAAgB,IAAI,IAAI,EAAE,CAAC;QACnE,OAAO,IAAI,CAAC;IACd,CAAC;IAED,OAAO;QACL,IAAI,EAAE,aAAa,CAAC,IAAI,CAAC;QACzB,gBAAgB,EAAE,SAAS,CAAC,gBAAgB,IAAI,IAAI;QACpD,YAAY,EAAE,SAAS,CAAC,YAAY,IAAI,IAAI;QAC5C,YAAY,EAAE,SAAS,CAAC,YAAY,IAAI,IAAI;QAC5C,gBAAgB;KACjB,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,WAAW,CAAC,QAAmB;IAC7C,OAAO;QACL,UAAU,EAAE,QAAQ,CAAC,UAAU;QAC/B,IAAI,EAAE,QAAQ,CAAC,YAAY;QAC3B,IAAI,EAAE,QAAQ,CAAC,YAAY,CAAC,OAAO;QACnC,cAAc,EAAE,QAAQ,CAAC,cAAc;QACvC,cAAc,EAAE,QAAQ,CAAC,QAAQ,IAAI,IAAI;QACzC,eAAe,EAAE,QAAQ,CAAC,QAAQ,IAAI,IAAI;QAC1C,gBAAgB,EAAE,QAAQ,CAAC,SAAS,IAAI,IAAI;QAC5C,YAAY,EAAE,QAAQ,CAAC,KAAK,IAAI,IAAI;QACpC,mBAAmB,EAAE,QAAQ,CAAC,aAAa,IAAI,IAAI;QACnD,QAAQ,EAAE,QAAQ,CAAC,QAAQ,IAAI,IAAI;QACnC,eAAe,EAAE,QAAQ,CAAC,YAAY,IAAI,IAAI;KAC/C,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,aAAa,CAC3B,IAAU,EACV,UAA8B;IAE9B,OAAO,UAAU,CAAC,cAAc,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;QAC/C,IAAI,EAAE,KAAK,CAAC,YAAY,IAAI,aAAa,CAAC,IAAI,CAAC;QAC/C,QAAQ,EAAE,KAAK,CAAC,MAAM,IAAI,IAAI;QAC9B,cAAc,EAAE,KAAK,CAAC,OAAO,IAAI,IAAI;QACrC,YAAY,EAAE,KAAK,CAAC,UAAU,IAAI,IAAI;QACtC,GAAG,EAAE,KAAK,CAAC,GAAG,IAAI,IAAI;KACvB,CAAC,CAAC,CAAC;AACN,CAAC;AAED,oBAAoB;AAEpB,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,MAA6B,EAC7B,IAAU;IAEV,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC;IAC5C,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,YAAY,CAAC,IAAI,EAAE,GAAG,CAAC,EAAE,CAAC;AAClD,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,MAA6B,EAC7B,IAAU;IAEV,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC;IAC5C,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,gBAAgB,CAAC,IAAI,EAAE,GAAG,CAAC,EAAE,CAAC;AACtD,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,MAA6B,EAC7B,IAAU;IAEV,MAAM,GAAG,GAAG,MAAM,gBAAgB,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IACjD,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,cAAc,CAAC,IAAI,EAAE,GAAG,CAAC,EAAE,CAAC;AACpD,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,MAA6B,EAC7B,IAAU;IAEV,MAAM,GAAG,GAAG,MAAM,eAAe,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IAChD,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,aAAa,CAAC,IAAI,EAAE,GAAG,CAAC,EAAE,CAAC;AACnD,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAC3C,MAA6B,EAC7B,IAAU;IAEV,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,kBAAkB,CAAC,IAAI,CAAC,CAAC;IAClD,MAAM,MAAM,GAAG,aAAa,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;IACxC,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;AAC5D,CAAC"}

package/dist/garmin/garminApiTypes.d.ts

@@ -0,0 +1,70 @@
+export interface GarminOAuth1 {
+    oauth_token: string;
+    oauth_token_secret: string;
+}
+export interface GarminOAuth2 {
+    scope: string;
+    jti: string;
+    access_token: string;
+    token_type: string;
+    refresh_token: string;
+    expires_in: number;
+    expires_at: number;
+    refresh_token_expires_in: number;
+    refresh_token_expires_at: number;
+}
+export interface StoredSessionTokens {
+    oauth1: GarminOAuth1;
+    oauth2: GarminOAuth2;
+}
+export interface IActivity {
+    activityId: number;
+    activityName: string;
+    startTimeLocal: string;
+    distance: number;
+    duration: number;
+    averageHR?: number;
+    maxHR?: number;
+    elevationGain: number;
+    calories: number;
+    averageSpeed: number;
+    activityType: {
+        typeKey: string;
+    };
+}
+export interface SleepData {
+    avgOvernightHrv?: number | null;
+    hrvStatus?: string | null;
+    dailySleepDTO?: {
+        sleepTimeSeconds: number;
+        deepSleepSeconds: number;
+        lightSleepSeconds: number;
+        remSleepSeconds: number;
+        awakeCount: number;
+        avgSleepStress?: number | null;
+        sleepScores?: {
+            overall?: {
+                value: number;
+            };
+        };
+    };
+}
+export interface HeartRateData {
+    restingHeartRate?: number;
+    maxHeartRate?: number;
+    minHeartRate?: number;
+    lastSevenDaysAvgRestingHeartRate?: number;
+    heartRateValues?: Array<Array<{
+        heartrate: number;
+    } | null> | null> | null;
+}
+export interface WeightDataResponse {
+    dateWeightList: Array<{
+        calendarDate: string;
+        weight: number;
+        bodyFat: number | null;
+        muscleMass: number | null;
+        bmi: number | null;
+    }>;
+}
+//# sourceMappingURL=garminApiTypes.d.ts.map

package/dist/garmin/garminApiTypes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"garminApiTypes.d.ts","sourceRoot":"","sources":["../../src/garmin/garminApiTypes.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,YAAY;IAC3B,WAAW,EAAE,MAAM,CAAC;IACpB,kBAAkB,EAAE,MAAM,CAAC;CAC5B;AAED,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,wBAAwB,EAAE,MAAM,CAAC;IACjC,wBAAwB,EAAE,MAAM,CAAC;CAClC;AAED,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,YAAY,CAAC;IACrB,MAAM,EAAE,YAAY,CAAC;CACtB;AAED,MAAM,WAAW,SAAS;IACxB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,EAAE,MAAM,CAAC;IACvB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,aAAa,EAAE,MAAM,CAAC;IACtB,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE;QACZ,OAAO,EAAE,MAAM,CAAC;KACjB,CAAC;CACH;AAED,MAAM,WAAW,SAAS;IACxB,eAAe,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,aAAa,CAAC,EAAE;QACd,gBAAgB,EAAE,MAAM,CAAC;QACzB,gBAAgB,EAAE,MAAM,CAAC;QACzB,iBAAiB,EAAE,MAAM,CAAC;QAC1B,eAAe,EAAE,MAAM,CAAC;QACxB,UAAU,EAAE,MAAM,CAAC;QACnB,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QAC/B,WAAW,CAAC,EAAE;YACZ,OAAO,CAAC,EAAE;gBACR,KAAK,EAAE,MAAM,CAAC;aACf,CAAC;SACH,CAAC;KACH,CAAC;CACH;AAED,MAAM,WAAW,aAAa;IAC5B,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,gCAAgC,CAAC,EAAE,MAAM,CAAC;IAC1C,eAAe,CAAC,EAAE,KAAK,CAAC,KAAK,CAAC;QAAE,SAAS,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC,GAAG,IAAI,CAAC,GAAG,IAAI,CAAC;CAC5E;AAED,MAAM,WAAW,kBAAkB;IACjC,cAAc,EAAE,KAAK,CAAC;QACpB,YAAY,EAAE,MAAM,CAAC;QACrB,MAAM,EAAE,MAAM,CAAC;QACf,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;QACvB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;QAC1B,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;KACpB,CAAC,CAAC;CACJ"}

package/dist/garmin/garminApiTypes.js

@@ -0,0 +1,3 @@
+// Minimal Garmin Connect API shapes used by TrainBud (avoids importing garmin-connect/dist internals).
+export {};
+//# sourceMappingURL=garminApiTypes.js.map

package/dist/garmin/garminApiTypes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"garminApiTypes.js","sourceRoot":"","sources":["../../src/garmin/garminApiTypes.ts"],"names":[],"mappings":"AAAA,uGAAuG"}

package/dist/garmin/garminConnect.d.ts

@@ -0,0 +1,17 @@
+import type { HeartRateData, IActivity, SleepData, StoredSessionTokens, WeightDataResponse } from "./garminApiTypes.js";
+export interface GarminConnectInstance {
+    login: (username?: string, password?: string) => Promise<GarminConnectInstance>;
+    loadToken: (oauth1: StoredSessionTokens["oauth1"], oauth2: StoredSessionTokens["oauth2"]) => void;
+    exportToken: () => StoredSessionTokens;
+    getUserProfile: () => Promise<unknown>;
+    getActivities: (start?: number, limit?: number) => Promise<IActivity[]>;
+    getSleepData: (date?: Date) => Promise<SleepData>;
+    getHeartRate: (date?: Date) => Promise<HeartRateData>;
+    getDailyWeightData: (date?: Date) => Promise<WeightDataResponse>;
+    get: (url: string, data?: Record<string, unknown>) => Promise<unknown>;
+}
+export declare const GarminConnect: new (credentials?: {
+    username: string;
+    password: string;
+}) => GarminConnectInstance;
+//# sourceMappingURL=garminConnect.d.ts.map

package/dist/garmin/garminConnect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"garminConnect.d.ts","sourceRoot":"","sources":["../../src/garmin/garminConnect.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,aAAa,EACb,SAAS,EACT,SAAS,EACT,mBAAmB,EACnB,kBAAkB,EACnB,MAAM,qBAAqB,CAAC;AAQ7B,MAAM,WAAW,qBAAqB;IACpC,KAAK,EAAE,CAAC,QAAQ,CAAC,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,qBAAqB,CAAC,CAAC;IAChF,SAAS,EAAE,CAAC,MAAM,EAAE,mBAAmB,CAAC,QAAQ,CAAC,EAAE,MAAM,EAAE,mBAAmB,CAAC,QAAQ,CAAC,KAAK,IAAI,CAAC;IAClG,WAAW,EAAE,MAAM,mBAAmB,CAAC;IACvC,cAAc,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,CAAC;IACvC,aAAa,EAAE,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,SAAS,EAAE,CAAC,CAAC;IACxE,YAAY,EAAE,CAAC,IAAI,CAAC,EAAE,IAAI,KAAK,OAAO,CAAC,SAAS,CAAC,CAAC;IAClD,YAAY,EAAE,CAAC,IAAI,CAAC,EAAE,IAAI,KAAK,OAAO,CAAC,aAAa,CAAC,CAAC;IACtD,kBAAkB,EAAE,CAAC,IAAI,CAAC,EAAE,IAAI,KAAK,OAAO,CAAC,kBAAkB,CAAC,CAAC;IACjE,GAAG,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;CACxE;AAID,eAAO,MAAM,aAAa,qBAjBU;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,KAAK,qBAiB3B,CAAC"}

package/dist/garmin/garminConnect.js

@@ -0,0 +1,5 @@
+import { createRequire } from "node:module";
+const require = createRequire(import.meta.url);
+const moduleRef = require("garmin-connect");
+export const GarminConnect = moduleRef.GarminConnect;
+//# sourceMappingURL=garminConnect.js.map

package/dist/garmin/garminConnect.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"garminConnect.js","sourceRoot":"","sources":["../../src/garmin/garminConnect.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAS5C,MAAM,OAAO,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAkB/C,MAAM,SAAS,GAAG,OAAO,CAAC,gBAAgB,CAAwB,CAAC;AAEnE,MAAM,CAAC,MAAM,aAAa,GAAG,SAAS,CAAC,aAAa,CAAC"}

package/dist/garmin/partial.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Every per-day tool used to write `catch { return null }` around its fetch and
+ * then filter the nulls away, which collapsed two different facts into one
+ * empty array: "the user did not wear the watch" and "Garmin would not answer".
+ * `withCache` then persisted that array for the full success TTL, so a single
+ * rate-limited minute made the tool report "No sleep data found for the last 7
+ * nights" for the next two hours -- an assertion about the user's life, made
+ * from a failed request.
+ *
+ * A day that could not be fetched is now counted rather than discarded, so the
+ * renderer can say which of the two happened and the cache can refuse to keep a
+ * degraded answer for long.
+ */
+export interface DayFetchResult<T> {
+    /** Days that answered with a real measurement. */
+    values: T[];
+    /** Days whose request failed. NOT days with nothing recorded. */
+    unreachableDays: number;
+    /** Days asked for, so a caller can say "3 of 30". */
+    requestedDays: number;
+}
+export declare function fetchEachDay<T, D>(dates: D[], fetchOne: (date: D) => Promise<T | null | undefined>, source: string): Promise<DayFetchResult<T>>;
+/** True when part of the answer is missing because a request failed. */
+export declare function isPartial(result: {
+    unreachableDays: number;
+}): boolean;
+/**
+ * The one sentence that keeps "nothing was recorded" and "nothing could be
+ * fetched" from rendering the same. Returns "" when the fetch was complete.
+ */
+export declare function partialFetchNote(result: DayFetchResult<unknown>, noun: string): string;
+//# sourceMappingURL=partial.d.ts.map

package/dist/garmin/partial.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"partial.d.ts","sourceRoot":"","sources":["../../src/garmin/partial.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;;;GAYG;AACH,MAAM,WAAW,cAAc,CAAC,CAAC;IAC/B,kDAAkD;IAClD,MAAM,EAAE,CAAC,EAAE,CAAC;IACZ,iEAAiE;IACjE,eAAe,EAAE,MAAM,CAAC;IACxB,qDAAqD;IACrD,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,wBAAsB,YAAY,CAAC,CAAC,EAAE,CAAC,EACrC,KAAK,EAAE,CAAC,EAAE,EACV,QAAQ,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,OAAO,CAAC,CAAC,GAAG,IAAI,GAAG,SAAS,CAAC,EACpD,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,CAkB5B;AAED,wEAAwE;AACxE,wBAAgB,SAAS,CAAC,MAAM,EAAE;IAAE,eAAe,EAAE,MAAM,CAAA;CAAE,GAAG,OAAO,CAEtE;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,cAAc,CAAC,OAAO,CAAC,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAUtF"}

package/dist/garmin/partial.js

@@ -0,0 +1,38 @@
+import { mapInBatches } from "../utils/batch.js";
+import { logger } from "../utils/logger.js";
+export async function fetchEachDay(dates, fetchOne, source) {
+    let unreachableDays = 0;
+    const mapped = await mapInBatches(dates, async (date) => {
+        try {
+            return await fetchOne(date);
+        }
+        catch (error) {
+            unreachableDays += 1;
+            logger.debug({ err: error, date: String(date), source }, "Day fetch failed");
+            return null;
+        }
+    });
+    return {
+        values: mapped.filter((value) => value !== null && value !== undefined),
+        unreachableDays,
+        requestedDays: dates.length,
+    };
+}
+/** True when part of the answer is missing because a request failed. */
+export function isPartial(result) {
+    return result.unreachableDays > 0;
+}
+/**
+ * The one sentence that keeps "nothing was recorded" and "nothing could be
+ * fetched" from rendering the same. Returns "" when the fetch was complete.
+ */
+export function partialFetchNote(result, noun) {
+    if (result.unreachableDays === 0) {
+        return "";
+    }
+    if (result.values.length === 0) {
+        return `Could not reach Garmin for any of the last ${result.requestedDays} ${noun}. This is not the same as having no ${noun} recorded — try again shortly.`;
+    }
+    return `Note: ${result.unreachableDays} of ${result.requestedDays} ${noun} could not be fetched, so these figures cover only what was retrieved.`;
+}
+//# sourceMappingURL=partial.js.map

package/dist/garmin/partial.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"partial.js","sourceRoot":"","sources":["../../src/garmin/partial.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAwB5C,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,KAAU,EACV,QAAoD,EACpD,MAAc;IAEd,IAAI,eAAe,GAAG,CAAC,CAAC;IAExB,MAAM,MAAM,GAAG,MAAM,YAAY,CAAC,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE;QACtD,IAAI,CAAC;YACH,OAAO,MAAM,QAAQ,CAAC,IAAI,CAAC,CAAC;QAC9B,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,eAAe,IAAI,CAAC,CAAC;YACrB,MAAM,CAAC,KAAK,CAAC,EAAE,GAAG,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,EAAE,kBAAkB,CAAC,CAAC;YAC7E,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,OAAO;QACL,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,KAAK,EAAc,EAAE,CAAC,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,SAAS,CAAC;QACnF,eAAe;QACf,aAAa,EAAE,KAAK,CAAC,MAAM;KAC5B,CAAC;AACJ,CAAC;AAED,wEAAwE;AACxE,MAAM,UAAU,SAAS,CAAC,MAAmC;IAC3D,OAAO,MAAM,CAAC,eAAe,GAAG,CAAC,CAAC;AACpC,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,gBAAgB,CAAC,MAA+B,EAAE,IAAY;IAC5E,IAAI,MAAM,CAAC,eAAe,KAAK,CAAC,EAAE,CAAC;QACjC,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,IAAI,MAAM,CAAC,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC/B,OAAO,8CAA8C,MAAM,CAAC,aAAa,IAAI,IAAI,uCAAuC,IAAI,gCAAgC,CAAC;IAC/J,CAAC;IAED,OAAO,SAAS,MAAM,CAAC,eAAe,OAAO,MAAM,CAAC,aAAa,IAAI,IAAI,wEAAwE,CAAC;AACpJ,CAAC"}

package/dist/garmin/rawApi.d.ts

@@ -0,0 +1,59 @@
+import type { GarminConnectInstance } from "./garminConnect.js";
+/**
+ * The calendar day this Date stands for, read in the zone it was built in.
+ *
+ * Every Date reaching here is LOCAL midnight -- `getDateRange` and
+ * `getDatesBetween` both go through `DateTime.local().startOf("day")`. Reading
+ * one of those `{ zone: "utc" }` does not convert it, it asks which UTC day
+ * that instant falls on, and for any zone east of UTC that is the day before.
+ * On this machine, Asia/Baku at UTC+4, local midnight on 2026-09-03 is
+ * 2026-09-02T20:00Z, so every stress and VO2 max request asked Connect about
+ * 2026-09-02 and the answer was then stamped 2026-09-02 as well -- plausible
+ * numbers filed under a day the user did not live, feeding the recovery score.
+ * Auckland is off by one the same way; Los Angeles happens to land right,
+ * which is the mirror image of the garmin-connect bug fixed in d64a78a.
+ *
+ * Asserting `toISOString()` is what let that one survive: it is a property of
+ * which midnight the Date sits on, not of the day Garmin is asked about. The
+ * test beside this one pins the day in the URL, in four zones.
+ */
+declare function toGarminDate(date: Date): string;
+/** Exported for the timezone test: the bug is invisible from outside this module. */
+export declare const __toGarminDateForTest: typeof toGarminDate;
+/**
+ * Connect takes the date as a path segment here. Sent as a query parameter --
+ * which is how this was written -- it answers 404 for every day, so stress was
+ * always empty and the recovery score, which is partly built from stress, was
+ * always degraded. The failure was invisible because the 404s were swallowed
+ * per day and the tool simply reported "no stress data".
+ */
+export declare function fetchDailyStress(client: GarminConnectInstance, date: Date): Promise<unknown>;
+/**
+ * `maxmet/daily/<date>` answers 404 -- it is `latest/<date>`. VO2 max is only
+ * recomputed after a qualifying activity, so "latest" is the right question
+ * anyway: a daily route would come back empty on most days even if it existed.
+ *
+ * The catch is that this endpoint **ignores the date it is given**. Asked about
+ * 2026-04-05 it returns the current measurement with its own
+ * `generic.calendarDate` of 2026-08-12. Stamping the response with the
+ * requested date -- which is what this did -- writes one real reading across
+ * every day in the range as if it had been measured on each of them, which is
+ * invented history, and a trend over it is flat by construction.
+ */
+export declare function fetchMaxMetrics(client: GarminConnectInstance, date: Date): Promise<unknown>;
+export interface DailyStressSummary {
+    date: string;
+    averageStress: number | null;
+    maxStress: number | null;
+    restStress: number | null;
+    stressDurationSeconds: number | null;
+}
+export interface Vo2MaxEntry {
+    date: string;
+    vo2Max: number | null;
+    vo2MaxCycling: number | null;
+}
+export declare function mapDailyStress(date: Date, payload: unknown): DailyStressSummary | null;
+export declare function mapMaxMetrics(date: Date, payload: unknown): Vo2MaxEntry | null;
+export {};
+//# sourceMappingURL=rawApi.d.ts.map

package/dist/garmin/rawApi.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rawApi.d.ts","sourceRoot":"","sources":["../../src/garmin/rawApi.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAIhE;;;;;;;;;;;;;;;;;GAiBG;AACH,iBAAS,YAAY,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,CAExC;AAED,qFAAqF;AACrF,eAAO,MAAM,qBAAqB,qBAAe,CAAC;AAElD;;;;;;GAMG;AACH,wBAAsB,gBAAgB,CAAC,MAAM,EAAE,qBAAqB,EAAE,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,OAAO,CAAC,CAElG;AAED;;;;;;;;;;;GAWG;AACH,wBAAsB,eAAe,CAAC,MAAM,EAAE,qBAAqB,EAAE,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,OAAO,CAAC,CAEjG;AAED,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,qBAAqB,EAAE,MAAM,GAAG,IAAI,CAAC;CACtC;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;CAC9B;AAYD,wBAAgB,cAAc,CAAC,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,GAAG,kBAAkB,GAAG,IAAI,CA0BtF;AAED,wBAAgB,aAAa,CAAC,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,GAAG,WAAW,GAAG,IAAI,CAuC9E"}

package/dist/garmin/rawApi.js

@@ -0,0 +1,113 @@
+import { DateTime } from "luxon";
+const GC_API = "https://connectapi.garmin.com";
+/**
+ * The calendar day this Date stands for, read in the zone it was built in.
+ *
+ * Every Date reaching here is LOCAL midnight -- `getDateRange` and
+ * `getDatesBetween` both go through `DateTime.local().startOf("day")`. Reading
+ * one of those `{ zone: "utc" }` does not convert it, it asks which UTC day
+ * that instant falls on, and for any zone east of UTC that is the day before.
+ * On this machine, Asia/Baku at UTC+4, local midnight on 2026-09-03 is
+ * 2026-09-02T20:00Z, so every stress and VO2 max request asked Connect about
+ * 2026-09-02 and the answer was then stamped 2026-09-02 as well -- plausible
+ * numbers filed under a day the user did not live, feeding the recovery score.
+ * Auckland is off by one the same way; Los Angeles happens to land right,
+ * which is the mirror image of the garmin-connect bug fixed in d64a78a.
+ *
+ * Asserting `toISOString()` is what let that one survive: it is a property of
+ * which midnight the Date sits on, not of the day Garmin is asked about. The
+ * test beside this one pins the day in the URL, in four zones.
+ */
+function toGarminDate(date) {
+    return DateTime.fromJSDate(date).toFormat("yyyy-MM-dd");
+}
+/** Exported for the timezone test: the bug is invisible from outside this module. */
+export const __toGarminDateForTest = toGarminDate;
+/**
+ * Connect takes the date as a path segment here. Sent as a query parameter --
+ * which is how this was written -- it answers 404 for every day, so stress was
+ * always empty and the recovery score, which is partly built from stress, was
+ * always degraded. The failure was invisible because the 404s were swallowed
+ * per day and the tool simply reported "no stress data".
+ */
+export async function fetchDailyStress(client, date) {
+    return client.get(`${GC_API}/wellness-service/wellness/dailyStress/${toGarminDate(date)}`);
+}
+/**
+ * `maxmet/daily/<date>` answers 404 -- it is `latest/<date>`. VO2 max is only
+ * recomputed after a qualifying activity, so "latest" is the right question
+ * anyway: a daily route would come back empty on most days even if it existed.
+ *
+ * The catch is that this endpoint **ignores the date it is given**. Asked about
+ * 2026-04-05 it returns the current measurement with its own
+ * `generic.calendarDate` of 2026-08-12. Stamping the response with the
+ * requested date -- which is what this did -- writes one real reading across
+ * every day in the range as if it had been measured on each of them, which is
+ * invented history, and a trend over it is flat by construction.
+ */
+export async function fetchMaxMetrics(client, date) {
+    return client.get(`${GC_API}/metrics-service/metrics/maxmet/latest/${toGarminDate(date)}`);
+}
+/**
+ * Connect reports a negative stress level for a day it has no measurement for:
+ * -1 when the watch was not worn, -2 while the day is still in progress. They
+ * are sentinels, not readings, and averaging them in pulls the weekly figure
+ * below anything the scale can produce.
+ */
+function measured(value) {
+    return value === null || value < 0 ? null : value;
+}
+export function mapDailyStress(date, payload) {
+    if (!payload || typeof payload !== "object") {
+        return null;
+    }
+    const data = payload;
+    // The real response carries avgStressLevel and maxStressLevel and nothing
+    // else of use: there is no overallStressLevel, restStressLevel or
+    // stressDuration in it. overallStressLevel is kept as a fallback because
+    // other wellness endpoints do use that name.
+    const averageStress = typeof data.avgStressLevel === "number"
+        ? data.avgStressLevel
+        : typeof data.overallStressLevel === "number"
+            ? data.overallStressLevel
+            : null;
+    return {
+        date: toGarminDate(date),
+        averageStress: measured(averageStress),
+        maxStress: measured(typeof data.maxStressLevel === "number" ? data.maxStressLevel : null),
+        restStress: typeof data.restStressLevel === "number" ? data.restStressLevel : null,
+        stressDurationSeconds: typeof data.stressDuration === "number" ? data.stressDuration : null,
+    };
+}
+export function mapMaxMetrics(date, payload) {
+    if (!payload || typeof payload !== "object") {
+        return null;
+    }
+    const data = payload;
+    const generic = data.generic;
+    const cycling = data.cycling;
+    const vo2Max = typeof generic?.vo2MaxValue === "number"
+        ? generic.vo2MaxValue
+        : typeof data.vo2MaxValue === "number"
+            ? data.vo2MaxValue
+            : null;
+    const vo2MaxCycling = typeof cycling?.vo2MaxValue === "number"
+        ? cycling.vo2MaxValue
+        : typeof data.vo2MaxCyclingValue === "number"
+            ? data.vo2MaxCyclingValue
+            : null;
+    if (vo2Max === null && vo2MaxCycling === null) {
+        return null;
+    }
+    // The day the measurement was actually taken, which is rarely the day asked
+    // about. Falling back to the requested date only when Connect omits its own.
+    const measuredOn = typeof generic?.calendarDate === "string" && generic.calendarDate.length > 0
+        ? generic.calendarDate
+        : toGarminDate(date);
+    return {
+        date: measuredOn,
+        vo2Max,
+        vo2MaxCycling,
+    };
+}
+//# sourceMappingURL=rawApi.js.map

package/dist/garmin/rawApi.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rawApi.js","sourceRoot":"","sources":["../../src/garmin/rawApi.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AAGjC,MAAM,MAAM,GAAG,+BAA+B,CAAC;AAE/C;;;;;;;;;;;;;;;;;GAiBG;AACH,SAAS,YAAY,CAAC,IAAU;IAC9B,OAAO,QAAQ,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAC;AAC1D,CAAC;AAED,qFAAqF;AACrF,MAAM,CAAC,MAAM,qBAAqB,GAAG,YAAY,CAAC;AAElD;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,MAA6B,EAAE,IAAU;IAC9E,OAAO,MAAM,CAAC,GAAG,CAAC,GAAG,MAAM,0CAA0C,YAAY,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;AAC7F,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,MAA6B,EAAE,IAAU;IAC7E,OAAO,MAAM,CAAC,GAAG,CAAC,GAAG,MAAM,0CAA0C,YAAY,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;AAC7F,CAAC;AAgBD;;;;;GAKG;AACH,SAAS,QAAQ,CAAC,KAAoB;IACpC,OAAO,KAAK,KAAK,IAAI,IAAI,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC;AACpD,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,IAAU,EAAE,OAAgB;IACzD,IAAI,CAAC,OAAO,IAAI,OAAO,OAAO,KAAK,QAAQ,EAAE,CAAC;QAC5C,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,IAAI,GAAG,OAAkC,CAAC;IAEhD,0EAA0E;IAC1E,kEAAkE;IAClE,yEAAyE;IACzE,6CAA6C;IAC7C,MAAM,aAAa,GACjB,OAAO,IAAI,CAAC,cAAc,KAAK,QAAQ;QACrC,CAAC,CAAC,IAAI,CAAC,cAAc;QACrB,CAAC,CAAC,OAAO,IAAI,CAAC,kBAAkB,KAAK,QAAQ;YAC3C,CAAC,CAAC,IAAI,CAAC,kBAAkB;YACzB,CAAC,CAAC,IAAI,CAAC;IAEb,OAAO;QACL,IAAI,EAAE,YAAY,CAAC,IAAI,CAAC;QACxB,aAAa,EAAE,QAAQ,CAAC,aAAa,CAAC;QACtC,SAAS,EAAE,QAAQ,CAAC,OAAO,IAAI,CAAC,cAAc,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC,CAAC,IAAI,CAAC;QACzF,UAAU,EAAE,OAAO,IAAI,CAAC,eAAe,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC,CAAC,IAAI;QAClF,qBAAqB,EACnB,OAAO,IAAI,CAAC,cAAc,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC,CAAC,IAAI;KACvE,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,IAAU,EAAE,OAAgB;IACxD,IAAI,CAAC,OAAO,IAAI,OAAO,OAAO,KAAK,QAAQ,EAAE,CAAC;QAC5C,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,IAAI,GAAG,OAAkC,CAAC;IAChD,MAAM,OAAO,GAAG,IAAI,CAAC,OAA8C,CAAC;IACpE,MAAM,OAAO,GAAG,IAAI,CAAC,OAA8C,CAAC;IAEpE,MAAM,MAAM,GACV,OAAO,OAAO,EAAE,WAAW,KAAK,QAAQ;QACtC,CAAC,CAAC,OAAO,CAAC,WAAW;QACrB,CAAC,CAAC,OAAO,IAAI,CAAC,WAAW,KAAK,QAAQ;YACpC,CAAC,CAAC,IAAI,CAAC,WAAW;YAClB,CAAC,CAAC,IAAI,CAAC;IAEb,MAAM,aAAa,GACjB,OAAO,OAAO,EAAE,WAAW,KAAK,QAAQ;QACtC,CAAC,CAAC,OAAO,CAAC,WAAW;QACrB,CAAC,CAAC,OAAO,IAAI,CAAC,kBAAkB,KAAK,QAAQ;YAC3C,CAAC,CAAC,IAAI,CAAC,kBAAkB;YACzB,CAAC,CAAC,IAAI,CAAC;IAEb,IAAI,MAAM,KAAK,IAAI,IAAI,aAAa,KAAK,IAAI,EAAE,CAAC;QAC9C,OAAO,IAAI,CAAC;IACd,CAAC;IAED,4EAA4E;IAC5E,6EAA6E;IAC7E,MAAM,UAAU,GACd,OAAO,OAAO,EAAE,YAAY,KAAK,QAAQ,IAAI,OAAO,CAAC,YAAY,CAAC,MAAM,GAAG,CAAC;QAC1E,CAAC,CAAC,OAAO,CAAC,YAAY;QACtB,CAAC,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC;IAEzB,OAAO;QACL,IAAI,EAAE,UAAU;QAChB,MAAM;QACN,aAAa;KACd,CAAC;AACJ,CAAC"}

package/dist/garmin/types.d.ts

@@ -0,0 +1,85 @@
+import type { StoredSessionTokens } from "./garminApiTypes.js";
+export type StoredSession = StoredSessionTokens;
+export interface ActivitySummary {
+    activityId: number;
+    name: string;
+    type: string;
+    startTimeLocal: string;
+    distanceMeters: number | null;
+    durationSeconds: number | null;
+    averageHeartRate: number | null;
+    maxHeartRate: number | null;
+    elevationGainMeters: number | null;
+    calories: number | null;
+    averageSpeedMps: number | null;
+}
+export interface SleepNightSummary {
+    date: string;
+    totalSleepSeconds: number;
+    deepSleepSeconds: number | null;
+    lightSleepSeconds: number | null;
+    remSleepSeconds: number | null;
+    awakeCount: number | null;
+    sleepScore: number | null;
+    avgSleepStress: number | null;
+    avgOvernightHrv: number | null;
+    hrvStatus: string | null;
+}
+export interface HeartRateDaySummary {
+    date: string;
+    restingHeartRate: number | null;
+    maxHeartRate: number | null;
+    minHeartRate: number | null;
+    averageHeartRate: number | null;
+}
+export interface BodyCompositionEntry {
+    date: string;
+    weightKg: number | null;
+    bodyFatPercent: number | null;
+    muscleMassKg: number | null;
+    bmi: number | null;
+}
+export interface RecoveryWeights {
+    hrv: number;
+    sleep: number;
+    stress: number;
+    restingHr: number;
+}
+export interface RecoveryStatusResult {
+    score: number;
+    status: "recovered" | "good" | "fatigued";
+    recommendation: string;
+    /**
+     * Null means the signal was not measured, which is a different thing from
+     * measuring badly. Sleep defaulted to 0 seconds when the watch was not worn
+     * and scored 35 out of 100 for it, so an unworn night produced a confident
+     * "fatigued" verdict out of no data at all. A null component is dropped and
+     * the remaining weights are renormalised.
+     */
+    components: {
+        hrvScore: number;
+        sleepScore: number | null;
+        stressScore: number;
+        restingHrScore: number;
+    };
+}
+export interface ToolTextResult {
+    type: "text";
+    text: string;
+}
+/**
+ * Tools return rendered text for MCP clients and the same information as typed
+ * data for everything else -- the history store, the detectors and the watch.
+ * Before this existed, watchApi.ts recovered numbers by matching regexes
+ * against the formatted prose, so a wording change in a renderer silently broke
+ * the watch.
+ */
+export interface ToolResult<T> extends ToolTextResult {
+    data: T;
+}
+export declare class GarminApiError extends Error {
+    readonly statusCode?: number;
+    readonly retryAfterSeconds?: number;
+    constructor(message: string, statusCode?: number, retryAfterSeconds?: number);
+}
+//# sourceMappingURL=types.d.ts.map

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

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

package/dist/garmin/types.js

@@ -0,0 +1,11 @@
+export class GarminApiError extends Error {
+    statusCode;
+    retryAfterSeconds;
+    constructor(message, statusCode, retryAfterSeconds) {
+        super(message);
+        this.name = "GarminApiError";
+        this.statusCode = statusCode;
+        this.retryAfterSeconds = retryAfterSeconds;
+    }
+}
+//# sourceMappingURL=types.js.map

package/dist/garmin/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/garmin/types.ts"],"names":[],"mappings":"AAkGA,MAAM,OAAO,cAAe,SAAQ,KAAK;IAC9B,UAAU,CAAU;IACpB,iBAAiB,CAAU;IAEpC,YAAY,OAAe,EAAE,UAAmB,EAAE,iBAA0B;QAC1E,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,gBAAgB,CAAC;QAC7B,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;QAC7B,IAAI,CAAC,iBAAiB,GAAG,iBAAiB,CAAC;IAC7C,CAAC;CACF"}

package/dist/history/capture.d.ts

@@ -0,0 +1,12 @@
+import type { IngestSource } from "./schema.js";
+/**
+ * Matched case-insensitively against the key name. Identity and credentials
+ * only -- never a measurement, never a date. A fixture with its numbers
+ * redacted would be worse than the invented payload it replaces.
+ */
+export declare const REDACTED_KEYS: string[];
+/** Deep clone with identity fields replaced. Never mutates its input. */
+export declare function redactPayload(payload: unknown): unknown;
+/** Writes one redacted response to `<dir>/<source>-<date>.json`. */
+export declare function writeFixture(directory: string, source: IngestSource, date: string, payload: unknown): string;
+//# sourceMappingURL=capture.d.ts.map

package/dist/history/capture.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"capture.d.ts","sourceRoot":"","sources":["../../src/history/capture.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAgBhD;;;;GAIG;AACH,eAAO,MAAM,aAAa,UAczB,CAAC;AAYF,yEAAyE;AACzE,wBAAgB,aAAa,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAgBvD;AAED,oEAAoE;AACpE,wBAAgB,YAAY,CAC1B,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,YAAY,EACpB,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,OAAO,GACf,MAAM,CAOR"}