trainingpeaks-mcp 0.5.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Rob West
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,224 @@
+# trainingpeaks-mcp
+
+An MCP (Model Context Protocol) server for accessing your TrainingPeaks training data. Works with Claude Desktop, ChatGPT, and other MCP-compatible clients.
+
+## Features
+
+- **20 tools** for accessing workouts, strength workouts, fitness metrics, peaks/PRs, files, and datetime
+- **Dual transport**: stdio for Claude Desktop, HTTP for ChatGPT
+- **FIT file parsing**: Extract structured data from downloaded FIT files
+- Also usable as a standalone TypeScript library
+
+## Quick Start
+
+### One-Click Install (Claude Desktop)
+
+1. Download the latest `.mcpb` file from [Releases](https://github.com/robertgregorywest/trainingpeaks-mcp/releases)
+2. Double-click the `.mcpb` file — Claude Desktop will open and prompt you to install
+3. Enter your TrainingPeaks credentials when prompted
+
+That's it — no Node.js installation required. Claude Desktop bundles its own runtime.
+
+### Manual Configuration (Claude Desktop)
+
+Requires **Node.js 20+**. Add to your Claude Desktop config (`~/Library/Application Support/Claude/claude_desktop_config.json` on macOS):
+
+```json
+{
+  "mcpServers": {
+    "trainingpeaks": {
+      "command": "npx",
+      "args": ["trainingpeaks-mcp"],
+      "env": {
+        "TP_USERNAME": "your-email@example.com",
+        "TP_PASSWORD": "your-password"
+      }
+    }
+  }
+}
+```
+
+Restart Claude Desktop. You can now ask Claude about your training data!
+
+### ChatGPT (via HTTP)
+
+Requires **Node.js 20+**.
+
+1. Clone and install:
+   ```bash
+   git clone https://github.com/robertgregorywest/trainingpeaks-mcp.git
+   cd trainingpeaks-mcp
+   npm install
+   ```
+
+2. Create `.env` file with your credentials:
+   ```bash
+   cp .env.example .env
+   # Edit .env with your TrainingPeaks credentials
+   ```
+
+3. Build and start the HTTP server:
+   ```bash
+   npm run build
+   npm run start:http
+   ```
+   You should see: `TrainingPeaks MCP HTTP server running on port 3000`
+
+4. Install ngrok (if not already installed):
+
+   **macOS (Homebrew):**
+   ```bash
+   brew install ngrok
+   ```
+
+   **Windows (Chocolatey):**
+   ```bash
+   choco install ngrok
+   ```
+
+   **Or download directly from:** https://ngrok.com/download
+
+5. Create a free ngrok account and get your auth token:
+   - Sign up at https://dashboard.ngrok.com/signup
+   - Copy your auth token from https://dashboard.ngrok.com/get-started/your-authtoken
+   - Configure ngrok with your token:
+     ```bash
+     ngrok config add-authtoken YOUR_AUTH_TOKEN
+     ```
+
+6. Start ngrok to expose your local server (in a new terminal):
+   ```bash
+   ngrok http 3000
+   ```
+
+   ngrok will display output like:
+   ```
+   Forwarding   https://abc123.ngrok-free.app -> http://localhost:3000
+   ```
+   Copy the `https://...ngrok-free.app` URL.
+
+7. Add the MCP connector in ChatGPT:
+   - Go to ChatGPT Settings → Connectors → Add Connector
+   - Enter your ngrok URL with `/mcp` path: `https://abc123.ngrok-free.app/mcp`
+   - Save the connector
+
+8. Test by asking ChatGPT about your TrainingPeaks data!
+
+## Available Tools
+
+| Tool | Description |
+|------|-------------|
+| `get_user` | Get user profile including athlete ID |
+| `get_athlete_id` | Get just the athlete ID |
+| `get_workouts` | List workouts in a date range |
+| `get_workout` | Get single workout summary |
+| `get_workout_details` | Get workout with full metrics, intervals, laps, zones |
+| `search_workouts` | Search workouts by title (case-insensitive) within a number of days |
+| `compare_intervals` | Compare laps/intervals side-by-side across workouts with power/duration filters |
+| `get_strength_workouts` | Get strength workouts in a date range (sets, blocks, exercises, compliance) |
+| `download_attachment` | Download workout attachment |
+| `parse_fit_file` | Parse FIT file and extract structured data |
+| `get_fitness_data` | Get CTL/ATL/TSB for date range |
+| `get_current_fitness` | Get today's fitness metrics |
+| `get_peaks` | Get peaks for specific sport and type |
+| `get_all_peaks` | Get all peaks for a sport |
+| `get_workout_peaks` | Get PRs from specific workout |
+| `get_power_peaks` | Get cycling power PRs |
+| `get_running_peaks` | Get running pace PRs |
+| `get_current_datetime` | Get current date and time with optional timezone |
+| `get_current_date` | Get current date in ISO, US, EU, or custom format |
+| `get_current_time` | Get current time in 24h, 12h, or custom format |
+
+## Example Prompts
+
+- "What workouts did I do last week?"
+- "Show me my current fitness (CTL, ATL, TSB)"
+- "What are my best 5-minute power efforts?"
+- "Get details for my most recent ride including heart rate zones"
+- "Download and parse the FIT file from yesterday's ride"
+- "Search for all my tempo workouts in the last 30 days"
+- "Compare the intervals across my last 3 threshold rides"
+- "What is the current date and time?"
+
+## Environment Variables
+
+Create a `.env` file from the example:
+
+```bash
+cp .env.example .env
+```
+
+Then edit `.env` with your TrainingPeaks credentials:
+
+```
+TP_USERNAME=your-email@example.com
+TP_PASSWORD=your-password
+```
+
+| Variable | Description |
+|----------|-------------|
+| `TP_USERNAME` | TrainingPeaks email address |
+| `TP_PASSWORD` | TrainingPeaks password |
+| `PORT` | HTTP server port (default: 3000) |
+
+## Library Usage
+
+You can also use this package as a standalone TypeScript library:
+
+```typescript
+import { createClient } from 'trainingpeaks-mcp';
+
+const client = createClient();
+
+// Get workouts for a date range
+const workouts = await client.getWorkouts('2024-01-01', '2024-12-31');
+
+// Get workout details with metrics
+const details = await client.getWorkoutDetails(workouts[0].workoutId);
+console.log(details.metrics);
+
+// Get current fitness
+const fitness = await client.getCurrentFitness();
+console.log(`CTL: ${fitness.ctl}, ATL: ${fitness.atl}, TSB: ${fitness.tsb}`);
+
+// Clean up when done
+await client.close();
+```
+
+## Development
+
+```bash
+npm run build        # Compile TypeScript
+npm run lint         # Run ESLint
+npm run test         # Run unit tests
+npm run typecheck    # Type-check without emitting
+```
+
+### Integration Tests
+
+Integration tests make real API calls to TrainingPeaks to verify all endpoints work correctly.
+
+**Prerequisites:**
+1. Create `.env` file with your TrainingPeaks credentials (see [Environment Variables](#environment-variables))
+
+**Run integration tests:**
+```bash
+npm run test:integration
+```
+
+**What's tested:**
+- User API: `getUser`, `getAthleteId`
+- Workouts API: `getWorkouts`, `getWorkout`, `getWorkoutDetails`
+- Fitness API: `getCurrentFitness`, `getFitnessData`
+- Peaks API: `getAllPeaks`, `getPeaks`, `getWorkoutPeaks`, `getPowerPeaks`, `getRunningPeaks`
+- Files API: `downloadActivityFile`
+
+Tests are skipped automatically if credentials are not available.
+
+## How It Works
+
+This library uses Playwright to automate browser login to TrainingPeaks, capturing the authentication token from API requests. The token is then used for subsequent API calls.
+
+## License
+
+MIT

package/dist/api/files.d.ts

@@ -0,0 +1,11 @@
+import type { HttpClient } from '../client.js';
+import type { UserApi } from './user.js';
+export declare class FilesApi {
+    private client;
+    private userApi;
+    constructor(client: HttpClient, userApi: UserApi);
+    downloadActivityFile(workoutId: number): Promise<Buffer | null>;
+    downloadAttachment(workoutId: number, attachmentId: number): Promise<Buffer>;
+}
+export declare function createFilesApi(client: HttpClient, userApi: UserApi): FilesApi;
+//# sourceMappingURL=files.d.ts.map

package/dist/api/files.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"files.d.ts","sourceRoot":"","sources":["../../src/api/files.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAWzC,qBAAa,QAAQ;IACnB,OAAO,CAAC,MAAM,CAAa;IAC3B,OAAO,CAAC,OAAO,CAAU;gBAEb,MAAM,EAAE,UAAU,EAAE,OAAO,EAAE,OAAO;IAK1C,oBAAoB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAoB/D,kBAAkB,CAAC,SAAS,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;CAKnF;AAED,wBAAgB,cAAc,CAAC,MAAM,EAAE,UAAU,EAAE,OAAO,EAAE,OAAO,GAAG,QAAQ,CAE7E"}

package/dist/api/files.js

@@ -0,0 +1,33 @@
+import { gunzipSync } from 'node:zlib';
+export class FilesApi {
+    client;
+    userApi;
+    constructor(client, userApi) {
+        this.client = client;
+        this.userApi = userApi;
+    }
+    async downloadActivityFile(workoutId) {
+        const athleteId = await this.userApi.getAthleteId();
+        const detailsEndpoint = `/fitness/v6/athletes/${athleteId}/workouts/${workoutId}/details`;
+        const details = await this.client.request(detailsEndpoint);
+        const fileInfo = details.workoutDeviceFileInfos?.[0];
+        if (!fileInfo) {
+            return null;
+        }
+        const rawEndpoint = `/fitness/v6/athletes/${athleteId}/workouts/${workoutId}/rawfiledata/${fileInfo.fileId}`;
+        const buffer = await this.client.requestRaw(rawEndpoint);
+        if (fileInfo.fileName.endsWith('.gz')) {
+            return Buffer.from(gunzipSync(buffer));
+        }
+        return buffer;
+    }
+    async downloadAttachment(workoutId, attachmentId) {
+        const athleteId = await this.userApi.getAthleteId();
+        const endpoint = `/fitness/v6/athletes/${athleteId}/workouts/${workoutId}/attachments/${attachmentId}/raw`;
+        return this.client.requestRaw(endpoint);
+    }
+}
+export function createFilesApi(client, userApi) {
+    return new FilesApi(client, userApi);
+}
+//# sourceMappingURL=files.js.map

package/dist/api/files.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"files.js","sourceRoot":"","sources":["../../src/api/files.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAavC,MAAM,OAAO,QAAQ;IACX,MAAM,CAAa;IACnB,OAAO,CAAU;IAEzB,YAAY,MAAkB,EAAE,OAAgB;QAC9C,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IACzB,CAAC;IAED,KAAK,CAAC,oBAAoB,CAAC,SAAiB;QAC1C,MAAM,SAAS,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,YAAY,EAAE,CAAC;QACpD,MAAM,eAAe,GAAG,wBAAwB,SAAS,aAAa,SAAS,UAAU,CAAC;QAC1F,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,OAAO,CAAyB,eAAe,CAAC,CAAC;QAEnF,MAAM,QAAQ,GAAG,OAAO,CAAC,sBAAsB,EAAE,CAAC,CAAC,CAAC,CAAC;QACrD,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,OAAO,IAAI,CAAC;QACd,CAAC;QAED,MAAM,WAAW,GAAG,wBAAwB,SAAS,aAAa,SAAS,gBAAgB,QAAQ,CAAC,MAAM,EAAE,CAAC;QAC7G,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,WAAW,CAAC,CAAC;QAEzD,IAAI,QAAQ,CAAC,QAAQ,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;YACtC,OAAO,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC;QACzC,CAAC;QAED,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,KAAK,CAAC,kBAAkB,CAAC,SAAiB,EAAE,YAAoB;QAC9D,MAAM,SAAS,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,YAAY,EAAE,CAAC;QACpD,MAAM,QAAQ,GAAG,wBAAwB,SAAS,aAAa,SAAS,gBAAgB,YAAY,MAAM,CAAC;QAC3G,OAAO,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC;IAC1C,CAAC;CACF;AAED,MAAM,UAAU,cAAc,CAAC,MAAkB,EAAE,OAAgB;IACjE,OAAO,IAAI,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AACvC,CAAC"}

package/dist/api/fitness.d.ts

@@ -0,0 +1,12 @@
+import type { HttpClient } from '../client.js';
+import type { UserApi } from './user.js';
+import type { FitnessMetrics } from '../types.js';
+export declare class FitnessApi {
+    private client;
+    private userApi;
+    constructor(client: HttpClient, userApi: UserApi);
+    getFitnessData(startDate: string, endDate: string): Promise<FitnessMetrics[]>;
+    getCurrentFitness(): Promise<FitnessMetrics>;
+}
+export declare function createFitnessApi(client: HttpClient, userApi: UserApi): FitnessApi;
+//# sourceMappingURL=fitness.d.ts.map

package/dist/api/fitness.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fitness.d.ts","sourceRoot":"","sources":["../../src/api/fitness.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAelD,qBAAa,UAAU;IACrB,OAAO,CAAC,MAAM,CAAa;IAC3B,OAAO,CAAC,OAAO,CAAU;gBAEb,MAAM,EAAE,UAAU,EAAE,OAAO,EAAE,OAAO;IAK1C,cAAc,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC;IAqC7E,iBAAiB,IAAI,OAAO,CAAC,cAAc,CAAC;CAYnD;AAED,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,UAAU,EAAE,OAAO,EAAE,OAAO,GAAG,UAAU,CAEjF"}

package/dist/api/fitness.js

@@ -0,0 +1,55 @@
+export class FitnessApi {
+    client;
+    userApi;
+    constructor(client, userApi) {
+        this.client = client;
+        this.userApi = userApi;
+    }
+    async getFitnessData(startDate, endDate) {
+        const athleteId = await this.userApi.getAthleteId();
+        const endpoint = `/fitness/v1/athletes/${athleteId}/reporting/performancedata/${startDate}/${endDate}`;
+        const response = await this.client.request(endpoint, {
+            method: 'POST',
+            body: { atlConstant: 7, atlStart: 0, ctlConstant: 42, ctlStart: 0, workoutTypes: [] },
+        });
+        // Handle different response structures
+        const data = Array.isArray(response) ? response : response.data || [];
+        if (!Array.isArray(data)) {
+            console.error('Unexpected fitness API response structure');
+            return [];
+        }
+        return data.map((d) => {
+            // Parse CTL/ATL/TSB - they may be strings like "NaN" or numbers
+            const parseMetric = (val) => {
+                if (val === undefined || val === null)
+                    return 0;
+                if (typeof val === 'string') {
+                    const parsed = parseFloat(val);
+                    return isNaN(parsed) ? 0 : parsed;
+                }
+                return isNaN(val) ? 0 : val;
+            };
+            return {
+                date: d.workoutDay?.split('T')[0] || '',
+                ctl: parseMetric(d.ctl),
+                atl: parseMetric(d.atl),
+                tsb: parseMetric(d.tsb),
+                dailyTss: d.tssActual,
+            };
+        });
+    }
+    async getCurrentFitness() {
+        const today = new Date().toISOString().split('T')[0];
+        const data = await this.getFitnessData(today, today);
+        return (data[0] ?? {
+            date: today,
+            ctl: 0,
+            atl: 0,
+            tsb: 0,
+        });
+    }
+}
+export function createFitnessApi(client, userApi) {
+    return new FitnessApi(client, userApi);
+}
+//# sourceMappingURL=fitness.js.map

package/dist/api/fitness.js.map

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

package/dist/api/peaks.d.ts

@@ -0,0 +1,15 @@
+import type { HttpClient } from '../client.js';
+import type { UserApi } from './user.js';
+import type { PeakSport, PeakType, PeakData, PeaksResponse, WorkoutPeaks, GetPeaksOptions } from '../types.js';
+export declare class PeaksApi {
+    private client;
+    private userApi;
+    constructor(client: HttpClient, userApi: UserApi);
+    getPeaks(sport: PeakSport, type: PeakType, options?: GetPeaksOptions): Promise<PeaksResponse>;
+    getAllPeaks(sport: PeakSport, options?: GetPeaksOptions): Promise<PeaksResponse>;
+    getWorkoutPeaks(workoutId: number): Promise<WorkoutPeaks>;
+    getPowerPeaks(options?: GetPeaksOptions): Promise<PeakData[]>;
+    getRunningPeaks(options?: GetPeaksOptions): Promise<PeakData[]>;
+}
+export declare function createPeaksApi(client: HttpClient, userApi: UserApi): PeaksApi;
+//# sourceMappingURL=peaks.d.ts.map

package/dist/api/peaks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"peaks.d.ts","sourceRoot":"","sources":["../../src/api/peaks.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,KAAK,EACV,SAAS,EACT,QAAQ,EACR,QAAQ,EACR,aAAa,EACb,YAAY,EACZ,eAAe,EAChB,MAAM,aAAa,CAAC;AAqBrB,qBAAa,QAAQ;IACnB,OAAO,CAAC,MAAM,CAAa;IAC3B,OAAO,CAAC,OAAO,CAAU;gBAEb,MAAM,EAAE,UAAU,EAAE,OAAO,EAAE,OAAO;IAK1C,QAAQ,CACZ,KAAK,EAAE,SAAS,EAChB,IAAI,EAAE,QAAQ,EACd,OAAO,GAAE,eAAoB,GAC5B,OAAO,CAAC,aAAa,CAAC;IAiCnB,WAAW,CAAC,KAAK,EAAE,SAAS,EAAE,OAAO,GAAE,eAAoB,GAAG,OAAO,CAAC,aAAa,CAAC;IA6BpF,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;IAezD,aAAa,CAAC,OAAO,GAAE,eAAoB,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC;IAKjE,eAAe,CAAC,OAAO,GAAE,eAAoB,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC;CAI1E;AAED,wBAAgB,cAAc,CAAC,MAAM,EAAE,UAAU,EAAE,OAAO,EAAE,OAAO,GAAG,QAAQ,CAE7E"}

package/dist/api/peaks.js

@@ -0,0 +1,85 @@
+export class PeaksApi {
+    client;
+    userApi;
+    constructor(client, userApi) {
+        this.client = client;
+        this.userApi = userApi;
+    }
+    async getPeaks(sport, type, options = {}) {
+        const athleteId = await this.userApi.getAthleteId();
+        const params = new URLSearchParams();
+        params.set('sport', sport);
+        params.set('type', type);
+        if (options.startDate) {
+            params.set('startDate', options.startDate);
+        }
+        if (options.endDate) {
+            params.set('endDate', options.endDate);
+        }
+        if (options.limit) {
+            params.set('limit', options.limit.toString());
+        }
+        const endpoint = `/fitness/v1/athletes/${athleteId}/peaks?${params.toString()}`;
+        const response = await this.client.request(endpoint);
+        return {
+            sport,
+            peaks: response.peaks.map((p) => ({
+                type: p.type,
+                value: p.value,
+                unit: p.unit,
+                workoutId: p.workoutId,
+                workoutDate: p.workoutDate,
+                workoutTitle: p.workoutTitle,
+            })),
+        };
+    }
+    async getAllPeaks(sport, options = {}) {
+        const athleteId = await this.userApi.getAthleteId();
+        const params = new URLSearchParams();
+        params.set('sport', sport);
+        if (options.startDate) {
+            params.set('startDate', options.startDate);
+        }
+        if (options.endDate) {
+            params.set('endDate', options.endDate);
+        }
+        const endpoint = `/fitness/v1/athletes/${athleteId}/peaks/all?${params.toString()}`;
+        const response = await this.client.request(endpoint);
+        return {
+            sport,
+            peaks: response.peaks.map((p) => ({
+                type: p.type,
+                value: p.value,
+                unit: p.unit,
+                workoutId: p.workoutId,
+                workoutDate: p.workoutDate,
+                workoutTitle: p.workoutTitle,
+            })),
+        };
+    }
+    async getWorkoutPeaks(workoutId) {
+        const athleteId = await this.userApi.getAthleteId();
+        const endpoint = `/fitness/v1/athletes/${athleteId}/workouts/${workoutId}/peaks`;
+        const response = await this.client.request(endpoint);
+        return {
+            workoutId,
+            peaks: response.peaks.map((p) => ({
+                type: p.type,
+                value: p.value,
+                unit: p.unit,
+            })),
+        };
+    }
+    async getPowerPeaks(options = {}) {
+        const response = await this.getAllPeaks('Bike', options);
+        return response.peaks.filter((p) => p.type.startsWith('power'));
+    }
+    async getRunningPeaks(options = {}) {
+        const response = await this.getAllPeaks('Run', options);
+        return response.peaks.filter((p) => p.type.startsWith('speed'));
+    }
+}
+export function createPeaksApi(client, userApi) {
+    return new PeaksApi(client, userApi);
+}
+//# sourceMappingURL=peaks.js.map

package/dist/api/peaks.js.map

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

package/dist/api/user.d.ts

@@ -0,0 +1,12 @@
+import type { HttpClient } from '../client.js';
+import type { User } from '../types.js';
+export declare class UserApi {
+    private client;
+    private cachedUser;
+    constructor(client: HttpClient);
+    getUser(): Promise<User>;
+    getAthleteId(): Promise<number>;
+    clearCache(): void;
+}
+export declare function createUserApi(client: HttpClient): UserApi;
+//# sourceMappingURL=user.d.ts.map

package/dist/api/user.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"user.d.ts","sourceRoot":"","sources":["../../src/api/user.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,aAAa,CAAC;AAuBxC,qBAAa,OAAO;IAClB,OAAO,CAAC,MAAM,CAAa;IAC3B,OAAO,CAAC,UAAU,CAAqB;gBAE3B,MAAM,EAAE,UAAU;IAIxB,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IA8BxB,YAAY,IAAI,OAAO,CAAC,MAAM,CAAC;IAKrC,UAAU,IAAI,IAAI;CAGnB;AAED,wBAAgB,aAAa,CAAC,MAAM,EAAE,UAAU,GAAG,OAAO,CAEzD"}

package/dist/api/user.js

@@ -0,0 +1,43 @@
+export class UserApi {
+    client;
+    cachedUser = null;
+    constructor(client) {
+        this.client = client;
+    }
+    async getUser() {
+        if (this.cachedUser) {
+            return this.cachedUser;
+        }
+        const response = await this.client.request('/users/v3/user');
+        if (!response || !response.user) {
+            console.error('Unexpected API response:', JSON.stringify(response, null, 2));
+            throw new Error('Invalid response from user API');
+        }
+        const athletes = response.user.athletes || [];
+        const user = {
+            id: response.user.userId,
+            athleteId: athletes[0]?.athleteId ?? response.user.userId,
+            email: response.user.email,
+            firstName: response.user.firstName,
+            lastName: response.user.lastName,
+            dateOfBirth: response.user.birthday,
+            gender: response.user.gender,
+            countryCode: response.user.country,
+            timezone: response.user.timeZone,
+            isPremium: response.user.settings?.account?.isPremium,
+        };
+        this.cachedUser = user;
+        return user;
+    }
+    async getAthleteId() {
+        const user = await this.getUser();
+        return user.athleteId;
+    }
+    clearCache() {
+        this.cachedUser = null;
+    }
+}
+export function createUserApi(client) {
+    return new UserApi(client);
+}
+//# sourceMappingURL=user.js.map

package/dist/api/user.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"user.js","sourceRoot":"","sources":["../../src/api/user.ts"],"names":[],"mappings":"AAwBA,MAAM,OAAO,OAAO;IACV,MAAM,CAAa;IACnB,UAAU,GAAgB,IAAI,CAAC;IAEvC,YAAY,MAAkB;QAC5B,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,CAAC;IAED,KAAK,CAAC,OAAO;QACX,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;YACpB,OAAO,IAAI,CAAC,UAAU,CAAC;QACzB,CAAC;QAED,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,OAAO,CAAkB,gBAAgB,CAAC,CAAC;QAE9E,IAAI,CAAC,QAAQ,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC;YAChC,OAAO,CAAC,KAAK,CAAC,0BAA0B,EAAE,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;YAC7E,MAAM,IAAI,KAAK,CAAC,gCAAgC,CAAC,CAAC;QACpD,CAAC;QAED,MAAM,QAAQ,GAAG,QAAQ,CAAC,IAAI,CAAC,QAAQ,IAAI,EAAE,CAAC;QAC9C,MAAM,IAAI,GAAS;YACjB,EAAE,EAAE,QAAQ,CAAC,IAAI,CAAC,MAAM;YACxB,SAAS,EAAE,QAAQ,CAAC,CAAC,CAAC,EAAE,SAAS,IAAI,QAAQ,CAAC,IAAI,CAAC,MAAM;YACzD,KAAK,EAAE,QAAQ,CAAC,IAAI,CAAC,KAAK;YAC1B,SAAS,EAAE,QAAQ,CAAC,IAAI,CAAC,SAAS;YAClC,QAAQ,EAAE,QAAQ,CAAC,IAAI,CAAC,QAAQ;YAChC,WAAW,EAAE,QAAQ,CAAC,IAAI,CAAC,QAAQ;YACnC,MAAM,EAAE,QAAQ,CAAC,IAAI,CAAC,MAAM;YAC5B,WAAW,EAAE,QAAQ,CAAC,IAAI,CAAC,OAAO;YAClC,QAAQ,EAAE,QAAQ,CAAC,IAAI,CAAC,QAAQ;YAChC,SAAS,EAAE,QAAQ,CAAC,IAAI,CAAC,QAAQ,EAAE,OAAO,EAAE,SAAS;SACtD,CAAC;QAEF,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC;QACvB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,KAAK,CAAC,YAAY;QAChB,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,OAAO,EAAE,CAAC;QAClC,OAAO,IAAI,CAAC,SAAS,CAAC;IACxB,CAAC;IAED,UAAU;QACR,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC;IACzB,CAAC;CACF;AAED,MAAM,UAAU,aAAa,CAAC,MAAkB;IAC9C,OAAO,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;AAC7B,CAAC"}

package/dist/api/workouts.d.ts

@@ -0,0 +1,20 @@
+import type { HttpClient } from '../client.js';
+import type { UserApi } from './user.js';
+import type { WorkoutSummary, WorkoutDetail, GetWorkoutsOptions, StrengthWorkoutSummary } from '../types.js';
+export declare class WorkoutsApi {
+    private client;
+    private userApi;
+    constructor(client: HttpClient, userApi: UserApi);
+    getWorkouts(startDate: string, endDate: string, options?: GetWorkoutsOptions): Promise<WorkoutSummary[]>;
+    private fetchWorkoutsForRange;
+    getWorkout(workoutId: number): Promise<WorkoutSummary>;
+    getWorkoutDetails(workoutId: number): Promise<WorkoutDetail>;
+    getStrengthWorkouts(startDate: string, endDate: string): Promise<StrengthWorkoutSummary[]>;
+    private mapStrengthWorkoutResponse;
+    private mapWorkoutResponse;
+    private mapWorkoutDetailResponse;
+    private chunkDateRange;
+    private formatDate;
+}
+export declare function createWorkoutsApi(client: HttpClient, userApi: UserApi): WorkoutsApi;
+//# sourceMappingURL=workouts.d.ts.map

package/dist/api/workouts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workouts.d.ts","sourceRoot":"","sources":["../../src/api/workouts.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,KAAK,EACV,cAAc,EACd,aAAa,EACb,kBAAkB,EAClB,sBAAsB,EACvB,MAAM,aAAa,CAAC;AAMrB,qBAAa,WAAW;IACtB,OAAO,CAAC,MAAM,CAAa;IAC3B,OAAO,CAAC,OAAO,CAAU;gBAEb,MAAM,EAAE,UAAU,EAAE,OAAO,EAAE,OAAO;IAK1C,WAAW,CACf,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,EACf,OAAO,GAAE,kBAAuB,GAC/B,OAAO,CAAC,cAAc,EAAE,CAAC;YAmBd,qBAAqB;IAc7B,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC;IAOtD,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;IAQ5D,mBAAmB,CACvB,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,sBAAsB,EAAE,CAAC;IAUpC,OAAO,CAAC,0BAA0B;IAgClC,OAAO,CAAC,kBAAkB;IAsC1B,OAAO,CAAC,wBAAwB;IAwBhC,OAAO,CAAC,cAAc;IA+BtB,OAAO,CAAC,UAAU;CAGnB;AAoFD,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,UAAU,EAAE,OAAO,EAAE,OAAO,GAAG,WAAW,CAEnF"}