@dofek/velohero 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025-2026 Asher Cohen
+
+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,130 @@
+# @dofek/velohero
+
+Unofficial TypeScript client for VeloHero's private workout-export API.
+
+This package is not affiliated with, endorsed by, or supported by VeloHero.
+The endpoints and response shapes were observed from VeloHero's web
+application, are not a supported public API contract, and may change without
+notice. Use only with an account and data you are authorized to access.
+
+## Requirements
+
+- Node.js 22.14 or newer
+
+## Install
+
+```sh
+npm install @dofek/velohero
+```
+
+## Quick start
+
+```ts
+import { VeloHeroClient } from "@dofek/velohero";
+
+const username = process.env.VELOHERO_USERNAME;
+const password = process.env.VELOHERO_PASSWORD;
+if (!username || !password) {
+  throw new Error("Set VELOHERO_USERNAME and VELOHERO_PASSWORD");
+}
+
+const { sessionCookie, userId } = await VeloHeroClient.signIn(
+  username,
+  password,
+);
+const client = new VeloHeroClient(sessionCookie);
+
+const workouts = await client.getWorkouts("2026-01-01", "2026-01-31");
+const firstWorkout = workouts[0]
+  ? await client.getWorkout(workouts[0].id)
+  : null;
+
+console.log({ userId, workoutCount: workouts.length, firstWorkout });
+```
+
+Dates passed to `getWorkouts` use `YYYY-MM-DD`.
+
+## Authentication lifecycle
+
+`VeloHeroClient.signIn(username, password)` posts form data to the observed
+`/sso` endpoint and returns:
+
+```ts
+{
+  sessionCookie: string; // "VeloHero_session=<session token>"
+  userId: string;
+}
+```
+
+Pass `sessionCookie` to the constructor. Treat it like a password: do not log
+it or expose it to a browser. The private response does not provide expiry
+metadata, and this package has no session-refresh method. When VeloHero rejects
+an expired session, sign in again and construct a new client.
+
+Both the constructor and `signIn` accept an optional `fetch` implementation as
+their final argument for compatible runtimes and network-level tests.
+
+## Public API
+
+The package root exports `VeloHeroClient`:
+
+- `VeloHeroClient.signIn(username, password, fetch?)`
+- `new VeloHeroClient(sessionCookie, fetch?)`
+- `client.getWorkouts(dateFrom, dateTo)`
+- `client.getWorkout(id)`
+
+Additional modules are available through documented deep imports:
+
+```ts
+import {
+  parseDurationToSeconds,
+  parseVeloHeroWorkout,
+  type ParsedVeloHeroWorkout,
+} from "@dofek/velohero/parsing";
+import {
+  mapVeloHeroSport,
+  VELOHERO_SPORT_MAP,
+} from "@dofek/velohero/sports";
+import type {
+  VeloHeroSsoResponse,
+  VeloHeroWorkout,
+  VeloHeroWorkoutsResponse,
+} from "@dofek/velohero/types";
+```
+
+`parseVeloHeroWorkout` converts VeloHero's string-valued export record to a
+provider-neutral activity summary while retaining observed metrics in `raw`.
+
+## Rate limits and errors
+
+Observed client behavior:
+
+- HTTP `429` throws `ProviderRateLimitError` from
+  `@dofek/provider-http/rate-limit`. Its `retryAfterSeconds` property is parsed
+  from `Retry-After` when present.
+- HTTP `502`, `503`, and `504` throw `ProviderServiceUnavailableError` from the
+  same module.
+- Other unsuccessful sign-in and API responses throw `Error` containing the
+  HTTP status and response body.
+- The client does not automatically sleep or retry. Callers decide whether and
+  when an operation is safe to repeat.
+- Successful private responses are represented by TypeScript interfaces, not
+  runtime-validated schemas. Be prepared for upstream shape changes.
+
+## Observed private protocol
+
+- Base URL: `https://app.velohero.com`
+- Sign-in: `POST /sso` using form fields `user`, `pass`, and `view=json`
+- Authentication: `VeloHero_session` cookie
+- Workout list: `GET /export/workouts/json`
+- Workout detail: `GET /export/workouts/json/{id}`
+
+These details document observed behavior; they are not promises made by
+VeloHero.
+
+## Project
+
+- [Source](https://github.com/Asherlc/dofek/tree/main/packages/velohero-client)
+- [Issues](https://github.com/Asherlc/dofek/issues)
+- [Pull requests](https://github.com/Asherlc/dofek/pulls)
+- [MIT License](./LICENSE)

package/dist/client.d.ts

@@ -0,0 +1,12 @@
+import type { VeloHeroWorkout } from "./types.ts";
+export declare class VeloHeroClient {
+    #private;
+    constructor(sessionCookie: string, fetchFn?: typeof globalThis.fetch);
+    getWorkouts(dateFrom: string, dateTo: string): Promise<VeloHeroWorkout[]>;
+    getWorkout(id: string): Promise<VeloHeroWorkout>;
+    static signIn(username: string, password: string, fetchFn?: typeof globalThis.fetch): Promise<{
+        sessionCookie: string;
+        userId: string;
+    }>;
+}
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAuB,eAAe,EAA4B,MAAM,YAAY,CAAC;AAIjG,qBAAa,cAAc;;gBAIb,aAAa,EAAE,MAAM,EAAE,OAAO,GAAE,OAAO,UAAU,CAAC,KAAwB;IAsBhF,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC;IASzE,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC;WAIzC,MAAM,CACjB,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,EAChB,OAAO,GAAE,OAAO,UAAU,CAAC,KAAwB,GAClD,OAAO,CAAC;QAAE,aAAa,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;CAmCtD"}

package/dist/client.js

@@ -0,0 +1,66 @@
+import { createRateLimitAwareFetch } from "@dofek/provider-http/rate-limit";
+const VELOHERO_BASE_URL = "https://app.velohero.com";
+export class VeloHeroClient {
+    #sessionCookie;
+    #fetchFn;
+    constructor(sessionCookie, fetchFn = globalThis.fetch) {
+        this.#sessionCookie = sessionCookie;
+        this.#fetchFn = createRateLimitAwareFetch(fetchFn, { providerId: "velohero" });
+    }
+    async #get(path, params) {
+        const url = params ? `${VELOHERO_BASE_URL}${path}?${params}` : `${VELOHERO_BASE_URL}${path}`;
+        const response = await this.#fetchFn(url, {
+            headers: {
+                Cookie: this.#sessionCookie,
+                Accept: "application/json",
+            },
+        });
+        if (!response.ok) {
+            const text = await response.text();
+            throw new Error(`VeloHero API error (${response.status}): ${text}`);
+        }
+        return response.json();
+    }
+    async getWorkouts(dateFrom, dateTo) {
+        const params = new URLSearchParams({
+            date_from: dateFrom,
+            date_to: dateTo,
+        });
+        const data = await this.#get("/export/workouts/json", params);
+        return data.workouts ?? [];
+    }
+    async getWorkout(id) {
+        return this.#get(`/export/workouts/json/${id}`);
+    }
+    static async signIn(username, password, fetchFn = globalThis.fetch) {
+        const body = new URLSearchParams({
+            user: username,
+            pass: password,
+            view: "json",
+        });
+        const rateLimitFetchFn = createRateLimitAwareFetch(fetchFn, { providerId: "velohero" });
+        const response = await rateLimitFetchFn(`${VELOHERO_BASE_URL}/sso`, {
+            method: "POST",
+            headers: {
+                "Content-Type": "application/x-www-form-urlencoded",
+            },
+            body: body.toString(),
+            redirect: "manual",
+        });
+        if (!response.ok) {
+            const text = await response.text();
+            throw new Error(`VeloHero sign-in failed (${response.status}): ${text}`);
+        }
+        const data = await response.json();
+        if (!data.session) {
+            throw new Error("VeloHero sign-in did not return a session token");
+        }
+        // The session token is used as a cookie value
+        const sessionCookie = `VeloHero_session=${data.session}`;
+        return {
+            sessionCookie,
+            userId: data["user-id"],
+        };
+    }
+}
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

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

package/dist/parsing.d.ts

@@ -0,0 +1,16 @@
+import type { CanonicalActivityType } from "@dofek/training/training";
+import type { VeloHeroWorkout } from "./types.ts";
+export interface ParsedVeloHeroWorkout {
+    externalId: string;
+    activityType: CanonicalActivityType;
+    name: string;
+    startedAt: Date;
+    endedAt: Date;
+    raw: Record<string, unknown>;
+}
+/**
+ * Parse a duration string in HH:MM:SS format to total seconds.
+ */
+export declare function parseDurationToSeconds(durTime: string): number;
+export declare function parseVeloHeroWorkout(workout: VeloHeroWorkout): ParsedVeloHeroWorkout;
+//# sourceMappingURL=parsing.d.ts.map

package/dist/parsing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parsing.d.ts","sourceRoot":"","sources":["../src/parsing.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,0BAA0B,CAAC;AAEtE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAElD,MAAM,WAAW,qBAAqB;IACpC,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,qBAAqB,CAAC;IACpC,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,IAAI,CAAC;IAChB,OAAO,EAAE,IAAI,CAAC;IACd,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC9B;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAO9D;AAWD,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,eAAe,GAAG,qBAAqB,CAwCpF"}

package/dist/parsing.js

@@ -0,0 +1,61 @@
+import { mapVeloHeroSport } from "./sports.js";
+/**
+ * Parse a duration string in HH:MM:SS format to total seconds.
+ */
+export function parseDurationToSeconds(durTime) {
+    const parts = durTime.split(":");
+    if (parts.length !== 3)
+        return 0;
+    const hours = Number.parseInt(parts[0] ?? "0", 10);
+    const minutes = Number.parseInt(parts[1] ?? "0", 10);
+    const seconds = Number.parseInt(parts[2] ?? "0", 10);
+    return hours * 3600 + minutes * 60 + seconds;
+}
+/**
+ * Parse a numeric string, returning undefined if empty/invalid.
+ */
+function parseOptionalNumber(value) {
+    if (!value || value.trim() === "")
+        return undefined;
+    const num = Number.parseFloat(value);
+    return Number.isNaN(num) ? undefined : num;
+}
+export function parseVeloHeroWorkout(workout) {
+    const durationSeconds = parseDurationToSeconds(workout.dur_time);
+    // Build startedAt from date_ymd + start_time
+    const dateStr = workout.date_ymd;
+    const timeStr = workout.start_time || "00:00:00";
+    const startedAt = new Date(`${dateStr}T${timeStr}`);
+    const endedAt = new Date(startedAt.getTime() + durationSeconds * 1000);
+    const distanceKm = parseOptionalNumber(workout.dist_km);
+    const distanceMeters = distanceKm !== undefined ? Math.round(distanceKm * 1000) : undefined;
+    const avgHeartRate = parseOptionalNumber(workout.avg_hr);
+    const maxHeartRate = parseOptionalNumber(workout.max_hr);
+    const avgPower = parseOptionalNumber(workout.avg_power);
+    const maxPower = parseOptionalNumber(workout.max_power);
+    const avgCadence = parseOptionalNumber(workout.avg_cadence);
+    const maxCadence = parseOptionalNumber(workout.max_cadence);
+    const ascent = parseOptionalNumber(workout.ascent);
+    const descent = parseOptionalNumber(workout.descent);
+    return {
+        externalId: String(workout.id),
+        activityType: mapVeloHeroSport(workout.sport_id),
+        name: workout.title || `${mapVeloHeroSport(workout.sport_id)} workout`,
+        startedAt,
+        endedAt,
+        raw: {
+            sportId: workout.sport_id,
+            durationSeconds,
+            distanceMeters,
+            avgHeartRate,
+            maxHeartRate,
+            avgPower,
+            maxPower,
+            avgCadence,
+            maxCadence,
+            ascent,
+            descent,
+        },
+    };
+}
+//# sourceMappingURL=parsing.js.map

package/dist/parsing.js.map

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

package/dist/sports.d.ts

@@ -0,0 +1,4 @@
+import type { CanonicalActivityType } from "@dofek/training/training";
+export declare const VELOHERO_SPORT_MAP: Record<string, CanonicalActivityType>;
+export declare function mapVeloHeroSport(sportId: string): CanonicalActivityType;
+//# sourceMappingURL=sports.d.ts.map

package/dist/sports.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sports.d.ts","sourceRoot":"","sources":["../src/sports.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,0BAA0B,CAAC;AAEtE,eAAO,MAAM,kBAAkB,EAAE,MAAM,CAAC,MAAM,EAAE,qBAAqB,CAcpE,CAAC;AAEF,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,qBAAqB,CAEvE"}

package/dist/sports.js

@@ -0,0 +1,19 @@
+export const VELOHERO_SPORT_MAP = {
+    "0": "other",
+    "1": "cycling",
+    "2": "running",
+    "3": "swimming",
+    "4": "gym",
+    "5": "strength",
+    "6": "mountain_biking",
+    "7": "hiking",
+    "8": "cross_country_skiing",
+    "9": "cycling", // velomobil / HPV
+    "10": "other",
+    "11": "rowing",
+    "12": "e_bike_cycling", // pedelec / e-bike
+};
+export function mapVeloHeroSport(sportId) {
+    return VELOHERO_SPORT_MAP[sportId] ?? "other";
+}
+//# sourceMappingURL=sports.js.map

package/dist/sports.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sports.js","sourceRoot":"","sources":["../src/sports.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,kBAAkB,GAA0C;IACvE,GAAG,EAAE,OAAO;IACZ,GAAG,EAAE,SAAS;IACd,GAAG,EAAE,SAAS;IACd,GAAG,EAAE,UAAU;IACf,GAAG,EAAE,KAAK;IACV,GAAG,EAAE,UAAU;IACf,GAAG,EAAE,iBAAiB;IACtB,GAAG,EAAE,QAAQ;IACb,GAAG,EAAE,sBAAsB;IAC3B,GAAG,EAAE,SAAS,EAAE,kBAAkB;IAClC,IAAI,EAAE,OAAO;IACb,IAAI,EAAE,QAAQ;IACd,IAAI,EAAE,gBAAgB,EAAE,mBAAmB;CAC5C,CAAC;AAEF,MAAM,UAAU,gBAAgB,CAAC,OAAe;IAC9C,OAAO,kBAAkB,CAAC,OAAO,CAAC,IAAI,OAAO,CAAC;AAChD,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,28 @@
+export interface VeloHeroWorkout {
+    id: string;
+    date_ymd: string;
+    start_time: string;
+    dur_time: string;
+    sport_id: string;
+    dist_km: string;
+    title?: string;
+    ascent?: string;
+    descent?: string;
+    avg_hr?: string;
+    max_hr?: string;
+    avg_power?: string;
+    max_power?: string;
+    avg_cadence?: string;
+    max_cadence?: string;
+    calories?: string;
+    file?: string;
+    hide?: string;
+}
+export interface VeloHeroWorkoutsResponse {
+    workouts: VeloHeroWorkout[];
+}
+export interface VeloHeroSsoResponse {
+    session: string;
+    "user-id": string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,wBAAwB;IACvC,QAAQ,EAAE,eAAe,EAAE,CAAC;CAC7B;AAED,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;CACnB"}

package/dist/types.js

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

package/dist/types.js.map

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

package/package.json

@@ -0,0 +1,60 @@
+{
+  "name": "@dofek/velohero",
+  "version": "0.1.0",
+  "description": "Unofficial VeloHero API client using reverse-engineered session authentication",
+  "type": "module",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Asherlc/dofek.git",
+    "directory": "packages/velohero-client"
+  },
+  "homepage": "https://github.com/Asherlc/dofek/tree/main/packages/velohero-client#readme",
+  "bugs": "https://github.com/Asherlc/dofek/issues",
+  "keywords": [
+    "velohero",
+    "cycling",
+    "api-client",
+    "unofficial",
+    "typescript"
+  ],
+  "engines": {
+    "node": ">=22.14.0"
+  },
+  "sideEffects": false,
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "exports": {
+    ".": {
+      "types": "./dist/client.d.ts",
+      "import": "./dist/client.js"
+    },
+    "./*": {
+      "types": "./dist/*.d.ts",
+      "import": "./dist/*.js"
+    }
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "test": "vitest run",
+    "test:watch": "vitest --watch",
+    "build": "tsc",
+    "prepack": "pnpm run build",
+    "lint": "biome check .",
+    "typecheck": "tsc --noEmit"
+  },
+  "dependencies": {
+    "@dofek/provider-http": "0.1.0",
+    "@dofek/training": "0.1.0"
+  },
+  "devDependencies": {
+    "typescript": "6.0.3",
+    "vitest": "3.2.6"
+  },
+  "gitHead": "ac95258c753c7e75b57da7ae47426d22b78e8c01"
+}