garmin-bud 0.2.0

package/dist/tools/sleep.js

@@ -0,0 +1,93 @@
+import { appConfig } from "../config.js";
+import { buildToolCacheKey, withCache } from "../garmin/cache.js";
+import { withGarminClient } from "../garmin/client.js";
+import { mapInBatches } from "../utils/batch.js";
+import { formatDuration, formatIsoDate, getDateRange, } from "../utils/helpers.js";
+// SECTION: Sleep Mapping
+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,
+    };
+}
+async function fetchSleepNights(days) {
+    const dates = getDateRange(days);
+    return withGarminClient(async (client) => {
+        const nights = await mapInBatches(dates, async (date) => {
+            try {
+                const sleepData = await client.getSleepData(date);
+                return mapSleepData(date, sleepData);
+            }
+            catch {
+                return null;
+            }
+        });
+        return nights.filter((night) => night !== null);
+    });
+}
+function formatSleepNight(night) {
+    return [
+        `${night.date}:`,
+        `  Total sleep: ${formatDuration(night.totalSleepSeconds)}`,
+        `  Deep: ${formatDuration(night.deepSleepSeconds)} | Light: ${formatDuration(night.lightSleepSeconds)} | REM: ${formatDuration(night.remSleepSeconds)}`,
+        `  Score: ${night.sleepScore ?? "n/a"} | Awakenings: ${night.awakeCount}`,
+        `  Avg sleep stress: ${night.avgSleepStress ?? "n/a"}`,
+    ].join("\n");
+}
+// SECTION: Tool Handler
+export async function getSleepDataTool(input) {
+    const nights = input.nights ?? 7;
+    const cacheKey = buildToolCacheKey("get_sleep_data", { nights });
+    const sleepNights = await withCache(cacheKey, appConfig.cacheTtlSleep, async () => {
+        return fetchSleepNights(nights);
+    });
+    if (sleepNights.length === 0) {
+        return {
+            type: "text",
+            text: `No sleep data found for the last ${nights} nights.`,
+        };
+    }
+    const averageScoreValues = sleepNights
+        .map((night) => night.sleepScore)
+        .filter((score) => score !== null);
+    const averageScore = averageScoreValues.length > 0
+        ? Math.round(averageScoreValues.reduce((sum, score) => sum + score, 0) /
+            averageScoreValues.length)
+        : null;
+    const lines = [
+        `Sleep summary for last ${sleepNights.length} recorded nights:`,
+        averageScore !== null ? `Average sleep score: ${averageScore}` : "",
+        "",
+        ...sleepNights.map(formatSleepNight),
+    ].filter(Boolean);
+    return {
+        type: "text",
+        text: lines.join("\n"),
+    };
+}
+export const sleepToolDefinitions = [
+    {
+        name: "get_sleep_data",
+        description: "Returns sleep duration, quality score, stage breakdown, and interruptions for recent nights.",
+        inputSchema: {
+            nights: {
+                type: "number",
+                description: "Number of recent nights to include. Defaults to 7.",
+            },
+        },
+        handler: getSleepDataTool,
+    },
+];
+//# sourceMappingURL=sleep.js.map

package/dist/tools/sleep.js.map

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

package/dist/tools/stress.d.ts

@@ -0,0 +1,7 @@
+import type { ToolTextResult } from "../garmin/types.js";
+import type { ToolDefinition } from "./types.js";
+export declare function getStressLevels(input: {
+    days?: number;
+}): Promise<ToolTextResult>;
+export declare const stressToolDefinitions: ToolDefinition[];
+//# sourceMappingURL=stress.d.ts.map

package/dist/tools/stress.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stress.d.ts","sourceRoot":"","sources":["../../src/tools/stress.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAqBjD,wBAAsB,eAAe,CAAC,KAAK,EAAE;IAAE,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,OAAO,CAAC,cAAc,CAAC,CAuCvF;AAED,eAAO,MAAM,qBAAqB,EAAE,cAAc,EAYjD,CAAC"}

package/dist/tools/stress.js

@@ -0,0 +1,69 @@
+import { appConfig } from "../config.js";
+import { buildToolCacheKey, withCache } from "../garmin/cache.js";
+import { withGarminClient } from "../garmin/client.js";
+import { fetchDailyStress, mapDailyStress, } from "../garmin/rawApi.js";
+import { mapInBatches } from "../utils/batch.js";
+import { average, calculateTrend, getDateRange } from "../utils/helpers.js";
+async function fetchStressDays(days) {
+    const dates = getDateRange(days);
+    return withGarminClient(async (client) => {
+        const summaries = await mapInBatches(dates, async (date) => {
+            try {
+                const payload = await fetchDailyStress(client, date);
+                return mapDailyStress(date, payload);
+            }
+            catch {
+                return null;
+            }
+        });
+        return summaries.filter((entry) => entry !== null);
+    });
+}
+export async function getStressLevels(input) {
+    const days = input.days ?? 7;
+    const cacheKey = buildToolCacheKey("get_stress_levels", { days });
+    const summaries = await withCache(cacheKey, appConfig.cacheTtlStats, async () => {
+        return fetchStressDays(days);
+    });
+    if (summaries.length === 0) {
+        return {
+            type: "text",
+            text: `No stress data found for the last ${days} days.`,
+        };
+    }
+    const averages = summaries
+        .map((entry) => entry.averageStress)
+        .filter((value) => value !== null);
+    const trend = calculateTrend(averages, true);
+    const avgStress = averages.length > 0 ? Math.round(average(averages)) : null;
+    const lines = summaries.slice(0, 7).map((entry) => {
+        return `${entry.date}: avg ${entry.averageStress ?? "n/a"}, max ${entry.maxStress ?? "n/a"}`;
+    });
+    return {
+        type: "text",
+        text: [
+            `Stress levels over ${summaries.length} recorded days:`,
+            avgStress !== null ? `Average stress: ${avgStress}` : "",
+            averages.length > 1 ? `Trend: ${trend}` : "",
+            "",
+            "Recent days:",
+            ...lines,
+        ]
+            .filter(Boolean)
+            .join("\n"),
+    };
+}
+export const stressToolDefinitions = [
+    {
+        name: "get_stress_levels",
+        description: "Returns daily stress averages and trends from Garmin Connect.",
+        inputSchema: {
+            days: {
+                type: "number",
+                description: "Number of days to analyze. Defaults to 7.",
+            },
+        },
+        handler: getStressLevels,
+    },
+];
+//# sourceMappingURL=stress.js.map

package/dist/tools/stress.js.map

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

package/dist/tools/trainingInsights.d.ts

@@ -0,0 +1,7 @@
+import type { ToolTextResult } from "../garmin/types.js";
+import type { ToolDefinition } from "./types.js";
+export declare function getTrainingInsights(input: {
+    days?: number;
+}): Promise<ToolTextResult>;
+export declare const trainingInsightsToolDefinitions: ToolDefinition[];
+//# sourceMappingURL=trainingInsights.d.ts.map

package/dist/tools/trainingInsights.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"trainingInsights.d.ts","sourceRoot":"","sources":["../../src/tools/trainingInsights.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAEjD,wBAAsB,mBAAmB,CAAC,KAAK,EAAE;IAAE,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,OAAO,CAAC,cAAc,CAAC,CA8C3F;AAED,eAAO,MAAM,+BAA+B,EAAE,cAAc,EAa3D,CAAC"}

package/dist/tools/trainingInsights.js

@@ -0,0 +1,61 @@
+import { filterActivitiesByRange } from "../utils/helpers.js";
+import { DateTime } from "luxon";
+import { getActivitiesPool, formatActivitySummary } from "./activities.js";
+import { getSleepDataTool } from "./sleep.js";
+import { getRecoveryStatus } from "./recovery.js";
+import { getStressLevels } from "./stress.js";
+export async function getTrainingInsights(input) {
+    const days = input.days ?? 7;
+    const endDate = DateTime.now().toISODate();
+    const startDate = DateTime.now().minus({ days }).toISODate();
+    const { activities: pool } = await getActivitiesPool();
+    const ranged = filterActivitiesByRange(pool, startDate ?? "", endDate ?? "");
+    const latest = pool[0] ?? null;
+    const [sleep, recovery, stress] = await Promise.all([
+        getSleepDataTool({ nights: days }),
+        getRecoveryStatus({}),
+        getStressLevels({ days }),
+    ]);
+    const activityLines = ranged.length > 0
+        ? ranged.map((activity, index) => {
+            return `${index + 1}. ${activity.name} (${activity.type}) — ${activity.startTimeLocal}`;
+        })
+        : [`No activities found between ${startDate} and ${endDate}.`];
+    const sections = [
+        "Training insights summary",
+        `Period: ${startDate} to ${endDate}`,
+        "",
+        "## Latest activity",
+        latest ? formatActivitySummary(latest) : "No activities found.",
+        "",
+        "## Activities in period",
+        ...activityLines,
+        "",
+        "## Sleep",
+        sleep.text,
+        "",
+        "## Recovery",
+        recovery.text,
+        "",
+        "## Stress",
+        stress.text,
+    ];
+    return {
+        type: "text",
+        text: sections.join("\n"),
+    };
+}
+export const trainingInsightsToolDefinitions = [
+    {
+        name: "get_training_insights",
+        description: "Returns a combined weekly training summary: latest activity, recent workouts, sleep, recovery, and stress.",
+        inputSchema: {
+            days: {
+                type: "number",
+                description: "Number of days to summarize. Defaults to 7.",
+            },
+        },
+        handler: getTrainingInsights,
+    },
+];
+//# sourceMappingURL=trainingInsights.js.map

package/dist/tools/trainingInsights.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"trainingInsights.js","sourceRoot":"","sources":["../../src/tools/trainingInsights.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAAE,MAAM,qBAAqB,CAAC;AAC9D,OAAO,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AACjC,OAAO,EAAE,iBAAiB,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAC;AAC3E,OAAO,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAC9C,OAAO,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAClD,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAI9C,MAAM,CAAC,KAAK,UAAU,mBAAmB,CAAC,KAAwB;IAChE,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,IAAI,CAAC,CAAC;IAC7B,MAAM,OAAO,GAAG,QAAQ,CAAC,GAAG,EAAE,CAAC,SAAS,EAAE,CAAC;IAC3C,MAAM,SAAS,GAAG,QAAQ,CAAC,GAAG,EAAE,CAAC,KAAK,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,SAAS,EAAE,CAAC;IAE7D,MAAM,EAAE,UAAU,EAAE,IAAI,EAAE,GAAG,MAAM,iBAAiB,EAAE,CAAC;IACvD,MAAM,MAAM,GAAG,uBAAuB,CAAC,IAAI,EAAE,SAAS,IAAI,EAAE,EAAE,OAAO,IAAI,EAAE,CAAC,CAAC;IAC7E,MAAM,MAAM,GAAG,IAAI,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC;IAE/B,MAAM,CAAC,KAAK,EAAE,QAAQ,EAAE,MAAM,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;QAClD,gBAAgB,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;QAClC,iBAAiB,CAAC,EAAE,CAAC;QACrB,eAAe,CAAC,EAAE,IAAI,EAAE,CAAC;KAC1B,CAAC,CAAC;IAEH,MAAM,aAAa,GACjB,MAAM,CAAC,MAAM,GAAG,CAAC;QACf,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,KAAK,EAAE,EAAE;YAC7B,OAAO,GAAG,KAAK,GAAG,CAAC,KAAK,QAAQ,CAAC,IAAI,KAAK,QAAQ,CAAC,IAAI,OAAO,QAAQ,CAAC,cAAc,EAAE,CAAC;QAC1F,CAAC,CAAC;QACJ,CAAC,CAAC,CAAC,+BAA+B,SAAS,QAAQ,OAAO,GAAG,CAAC,CAAC;IAEnE,MAAM,QAAQ,GAAG;QACf,2BAA2B;QAC3B,WAAW,SAAS,OAAO,OAAO,EAAE;QACpC,EAAE;QACF,oBAAoB;QACpB,MAAM,CAAC,CAAC,CAAC,qBAAqB,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,sBAAsB;QAC/D,EAAE;QACF,yBAAyB;QACzB,GAAG,aAAa;QAChB,EAAE;QACF,UAAU;QACV,KAAK,CAAC,IAAI;QACV,EAAE;QACF,aAAa;QACb,QAAQ,CAAC,IAAI;QACb,EAAE;QACF,WAAW;QACX,MAAM,CAAC,IAAI;KACZ,CAAC;IAEF,OAAO;QACL,IAAI,EAAE,MAAM;QACZ,IAAI,EAAE,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC;KAC1B,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,MAAM,+BAA+B,GAAqB;IAC/D;QACE,IAAI,EAAE,uBAAuB;QAC7B,WAAW,EACT,4GAA4G;QAC9G,WAAW,EAAE;YACX,IAAI,EAAE;gBACJ,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,6CAA6C;aAC3D;SACF;QACD,OAAO,EAAE,mBAAmB;KAC7B;CACF,CAAC"}

package/dist/tools/types.d.ts

@@ -0,0 +1,12 @@
+import type { ToolTextResult } from "../garmin/types.js";
+export interface ToolInputSchema {
+    type: string;
+    description: string;
+}
+export interface ToolDefinition {
+    name: string;
+    description: string;
+    inputSchema: Record<string, ToolInputSchema> | Record<string, never>;
+    handler: (input: Record<string, unknown>) => Promise<ToolTextResult>;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/tools/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAEzD,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;IACrE,OAAO,EAAE,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,CAAC,cAAc,CAAC,CAAC;CACtE"}

package/dist/tools/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/tools/types.js.map

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

package/dist/tools/vo2Max.d.ts

@@ -0,0 +1,7 @@
+import type { ToolTextResult } from "../garmin/types.js";
+import type { ToolDefinition } from "./types.js";
+export declare function getVo2MaxTrends(input: {
+    days?: number;
+}): Promise<ToolTextResult>;
+export declare const vo2MaxToolDefinitions: ToolDefinition[];
+//# sourceMappingURL=vo2Max.d.ts.map

package/dist/tools/vo2Max.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vo2Max.d.ts","sourceRoot":"","sources":["../../src/tools/vo2Max.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAqBjD,wBAAsB,eAAe,CAAC,KAAK,EAAE;IAAE,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,OAAO,CAAC,cAAc,CAAC,CA2CvF;AAED,eAAO,MAAM,qBAAqB,EAAE,cAAc,EAYjD,CAAC"}

package/dist/tools/vo2Max.js

@@ -0,0 +1,72 @@
+import { appConfig } from "../config.js";
+import { buildToolCacheKey, withCache } from "../garmin/cache.js";
+import { withGarminClient } from "../garmin/client.js";
+import { fetchMaxMetrics, mapMaxMetrics } from "../garmin/rawApi.js";
+import { mapInBatches } from "../utils/batch.js";
+import { calculateTrend, getDateRange } from "../utils/helpers.js";
+async function fetchVo2MaxDays(days) {
+    const dates = getDateRange(days);
+    return withGarminClient(async (client) => {
+        const entries = await mapInBatches(dates, async (date) => {
+            try {
+                const payload = await fetchMaxMetrics(client, date);
+                return mapMaxMetrics(date, payload);
+            }
+            catch {
+                return null;
+            }
+        });
+        return entries.filter((entry) => entry !== null);
+    });
+}
+export async function getVo2MaxTrends(input) {
+    const days = input.days ?? 30;
+    const cacheKey = buildToolCacheKey("get_vo2_max_trends", { days });
+    const entries = await withCache(cacheKey, appConfig.cacheTtlStats, async () => {
+        return fetchVo2MaxDays(days);
+    });
+    if (entries.length === 0) {
+        return {
+            type: "text",
+            text: `No VO2 max data found for the last ${days} days.`,
+        };
+    }
+    const values = entries
+        .map((entry) => entry.vo2Max)
+        .filter((value) => value !== null);
+    const trend = calculateTrend(values, false);
+    const current = entries[0]?.vo2Max ?? null;
+    const previous = entries.at(-1)?.vo2Max ?? null;
+    const lines = entries.slice(0, 10).map((entry) => {
+        const cycling = entry.vo2MaxCycling !== null ? `, cycling ${entry.vo2MaxCycling}` : "";
+        return `${entry.date}: VO2 max ${entry.vo2Max ?? "n/a"}${cycling}`;
+    });
+    return {
+        type: "text",
+        text: [
+            `VO2 max trends over ${entries.length} recorded days:`,
+            current !== null ? `Current VO2 max: ${current}` : "",
+            previous !== null && entries.length > 1 ? `Oldest in range: ${previous}` : "",
+            values.length > 1 ? `Trend: ${trend}` : "",
+            "",
+            "Recent entries:",
+            ...lines,
+        ]
+            .filter(Boolean)
+            .join("\n"),
+    };
+}
+export const vo2MaxToolDefinitions = [
+    {
+        name: "get_vo2_max_trends",
+        description: "Returns VO2 max fitness trends over time from Garmin Connect.",
+        inputSchema: {
+            days: {
+                type: "number",
+                description: "Number of days to analyze. Defaults to 30.",
+            },
+        },
+        handler: getVo2MaxTrends,
+    },
+];
+//# sourceMappingURL=vo2Max.js.map

package/dist/tools/vo2Max.js.map

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

package/dist/utils/batch.d.ts

@@ -0,0 +1,2 @@
+export declare function mapInBatches<T, R>(items: T[], fn: (item: T) => Promise<R>, concurrency?: number): Promise<R[]>;
+//# sourceMappingURL=batch.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"batch.d.ts","sourceRoot":"","sources":["../../src/utils/batch.ts"],"names":[],"mappings":"AAEA,wBAAsB,YAAY,CAAC,CAAC,EAAE,CAAC,EACrC,KAAK,EAAE,CAAC,EAAE,EACV,EAAE,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,OAAO,CAAC,CAAC,CAAC,EAC3B,WAAW,SAAsB,GAChC,OAAO,CAAC,CAAC,EAAE,CAAC,CAkBd"}

package/dist/utils/batch.js

@@ -0,0 +1,18 @@
+const DEFAULT_CONCURRENCY = 6;
+export async function mapInBatches(items, fn, concurrency = DEFAULT_CONCURRENCY) {
+    if (items.length === 0) {
+        return [];
+    }
+    const results = new Array(items.length);
+    let index = 0;
+    async function worker() {
+        while (index < items.length) {
+            const current = index++;
+            results[current] = await fn(items[current]);
+        }
+    }
+    const workers = Array.from({ length: Math.min(concurrency, items.length) }, () => worker());
+    await Promise.all(workers);
+    return results;
+}
+//# sourceMappingURL=batch.js.map

package/dist/utils/batch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"batch.js","sourceRoot":"","sources":["../../src/utils/batch.ts"],"names":[],"mappings":"AAAA,MAAM,mBAAmB,GAAG,CAAC,CAAC;AAE9B,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,KAAU,EACV,EAA2B,EAC3B,WAAW,GAAG,mBAAmB;IAEjC,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvB,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,MAAM,OAAO,GAAQ,IAAI,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IAC7C,IAAI,KAAK,GAAG,CAAC,CAAC;IAEd,KAAK,UAAU,MAAM;QACnB,OAAO,KAAK,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC;YAC5B,MAAM,OAAO,GAAG,KAAK,EAAE,CAAC;YACxB,OAAO,CAAC,OAAO,CAAC,GAAG,MAAM,EAAE,CAAC,KAAK,CAAC,OAAO,CAAM,CAAC,CAAC;QACnD,CAAC;IACH,CAAC;IAED,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,GAAG,CAAC,WAAW,EAAE,KAAK,CAAC,MAAM,CAAC,EAAE,EAAE,GAAG,EAAE,CAAC,MAAM,EAAE,CAAC,CAAC;IAC5F,MAAM,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IAC3B,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/utils/helpers.d.ts

@@ -0,0 +1,19 @@
+import { DateTime } from "luxon";
+import type { ActivitySummary } from "../garmin/types.js";
+export type TrendDirection = "improving" | "declining" | "stable" | "insufficient_data";
+export declare function parseIsoDate(value: string): Date;
+export declare function formatIsoDate(date: Date): string;
+export declare function getDateRange(days: number): Date[];
+export declare function getYesterday(): Date;
+export declare function getDatesBetween(startDate: string, endDate: string): Date[];
+export declare function parseActivityLocalDateTime(value: string): DateTime;
+export declare function filterActivitiesByRange(activities: ActivitySummary[], startDate: string, endDate: string): ActivitySummary[];
+export declare function formatDuration(seconds: number): string;
+export declare function formatDistanceMeters(meters: number): string;
+export declare function formatPaceMetersPerSecond(metersPerSecond: number): string;
+export declare function calculateTrend(values: number[], lowerIsBetter?: boolean): TrendDirection;
+export declare function average(values: number[]): number;
+export declare function clamp(value: number, min: number, max: number): number;
+export declare function hashParams(params: Record<string, unknown>): string;
+export declare function sanitizeErrorMessage(message: string): string;
+//# sourceMappingURL=helpers.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../../src/utils/helpers.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AACjC,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAE1D,MAAM,MAAM,cAAc,GAAG,WAAW,GAAG,WAAW,GAAG,QAAQ,GAAG,mBAAmB,CAAC;AAExF,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAMhD;AAED,wBAAgB,aAAa,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,CAEhD;AAED,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,EAAE,CASjD;AAED,wBAAgB,YAAY,IAAI,IAAI,CAEnC;AAED,wBAAgB,eAAe,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,EAAE,CAqB1E;AAED,wBAAgB,0BAA0B,CAAC,KAAK,EAAE,MAAM,GAAG,QAAQ,CAYlE;AAED,wBAAgB,uBAAuB,CACrC,UAAU,EAAE,eAAe,EAAE,EAC7B,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,GACd,eAAe,EAAE,CAYnB;AAED,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CActD;AAED,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAM3D;AAED,wBAAgB,yBAAyB,CAAC,eAAe,EAAE,MAAM,GAAG,MAAM,CASzE;AAED,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,EAAE,aAAa,UAAQ,GAAG,cAAc,CA6BtF;AAED,wBAAgB,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,CAMhD;AAED,wBAAgB,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAErE;AAED,wBAAgB,UAAU,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAGlE;AAED,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAK5D"}

package/dist/utils/helpers.js

@@ -0,0 +1,131 @@
+import { DateTime } from "luxon";
+export function parseIsoDate(value) {
+    const parsed = DateTime.fromISO(value, { zone: "utc" });
+    if (!parsed.isValid) {
+        throw new Error(`Invalid date "${value}". Use ISO 8601 format such as 2026-06-01.`);
+    }
+    return parsed.toJSDate();
+}
+export function formatIsoDate(date) {
+    return DateTime.fromJSDate(date, { zone: "utc" }).toISODate() ?? "";
+}
+export function getDateRange(days) {
+    const dates = [];
+    const today = DateTime.utc().startOf("day");
+    for (let offset = 0; offset < days; offset += 1) {
+        dates.push(today.minus({ days: offset }).toJSDate());
+    }
+    return dates;
+}
+export function getYesterday() {
+    return DateTime.utc().minus({ days: 1 }).startOf("day").toJSDate();
+}
+export function getDatesBetween(startDate, endDate) {
+    const start = DateTime.fromISO(startDate, { zone: "utc" }).startOf("day");
+    const end = DateTime.fromISO(endDate, { zone: "utc" }).startOf("day");
+    if (!start.isValid || !end.isValid) {
+        throw new Error("Invalid date range. Use ISO 8601 dates such as 2026-06-01.");
+    }
+    if (end < start) {
+        throw new Error("end_date must be on or after start_date.");
+    }
+    const dates = [];
+    let cursor = start;
+    while (cursor <= end) {
+        dates.push(cursor.toJSDate());
+        cursor = cursor.plus({ days: 1 });
+    }
+    return dates;
+}
+export function parseActivityLocalDateTime(value) {
+    const fromIso = DateTime.fromISO(value, { setZone: true });
+    if (fromIso.isValid) {
+        return fromIso;
+    }
+    const fromSql = DateTime.fromSQL(value, { setZone: true });
+    if (fromSql.isValid) {
+        return fromSql;
+    }
+    return DateTime.invalid("unparsable");
+}
+export function filterActivitiesByRange(activities, startDate, endDate) {
+    const start = DateTime.fromISO(startDate, { zone: "utc" }).startOf("day");
+    const end = DateTime.fromISO(endDate, { zone: "utc" }).startOf("day");
+    return activities.filter((activity) => {
+        const activityDay = parseActivityLocalDateTime(activity.startTimeLocal).startOf("day");
+        if (!activityDay.isValid) {
+            return false;
+        }
+        return activityDay.toMillis() >= start.toMillis() && activityDay.toMillis() <= end.toMillis();
+    });
+}
+export function formatDuration(seconds) {
+    const hours = Math.floor(seconds / 3600);
+    const minutes = Math.floor((seconds % 3600) / 60);
+    const remainingSeconds = Math.floor(seconds % 60);
+    if (hours > 0) {
+        return `${hours}h ${minutes}m ${remainingSeconds}s`;
+    }
+    if (minutes > 0) {
+        return `${minutes}m ${remainingSeconds}s`;
+    }
+    return `${remainingSeconds}s`;
+}
+export function formatDistanceMeters(meters) {
+    if (meters >= 1000) {
+        return `${(meters / 1000).toFixed(2)} km`;
+    }
+    return `${meters.toFixed(0)} m`;
+}
+export function formatPaceMetersPerSecond(metersPerSecond) {
+    if (metersPerSecond <= 0) {
+        return "n/a";
+    }
+    const secondsPerKm = 1000 / metersPerSecond;
+    const minutes = Math.floor(secondsPerKm / 60);
+    const seconds = Math.round(secondsPerKm % 60);
+    return `${minutes}:${seconds.toString().padStart(2, "0")} /km`;
+}
+export function calculateTrend(values, lowerIsBetter = false) {
+    const filtered = values.filter((value) => Number.isFinite(value));
+    if (filtered.length < 2) {
+        return "insufficient_data";
+    }
+    const midpoint = Math.floor(filtered.length / 2);
+    const recent = filtered.slice(0, midpoint);
+    const older = filtered.slice(midpoint);
+    if (recent.length === 0 || older.length === 0) {
+        return "insufficient_data";
+    }
+    const recentAverage = average(recent);
+    const olderAverage = average(older);
+    const delta = recentAverage - olderAverage;
+    const threshold = Math.max(Math.abs(olderAverage) * 0.02, 0.5);
+    if (Math.abs(delta) <= threshold) {
+        return "stable";
+    }
+    if (lowerIsBetter) {
+        return delta < 0 ? "improving" : "declining";
+    }
+    return delta > 0 ? "improving" : "declining";
+}
+export function average(values) {
+    if (values.length === 0) {
+        return 0;
+    }
+    return values.reduce((sum, value) => sum + value, 0) / values.length;
+}
+export function clamp(value, min, max) {
+    return Math.min(max, Math.max(min, value));
+}
+export function hashParams(params) {
+    const sortedEntries = Object.entries(params).sort(([left], [right]) => left.localeCompare(right));
+    return JSON.stringify(Object.fromEntries(sortedEntries));
+}
+export function sanitizeErrorMessage(message) {
+    return message
+        .replace(/[A-Za-z0-9._%+-]+@[A-Za-z0-9.-]+\.[A-Za-z]{2,}/g, "[email]")
+        .replace(/(?:[A-Za-z]:\\|\/)[^\s]+/g, "[path]")
+        .replace(/\bpassword[^\s]*/gi, "[redacted]");
+}
+//# sourceMappingURL=helpers.js.map

package/dist/utils/helpers.js.map

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

package/dist/utils/logger.d.ts

@@ -0,0 +1,4 @@
+import type { Logger } from "pino";
+export declare function configureLogger(logPath?: string): void;
+export declare const logger: Logger;
+//# sourceMappingURL=logger.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,MAAM,CAAC;AA0DnC,wBAAgB,eAAe,CAAC,OAAO,SAAoB,GAAG,IAAI,CAEjE;AAED,eAAO,MAAM,MAAM,EAAE,MAMnB,CAAC"}