matrix-workouts-core 0.1.0

package/dist/node/history.d.ts

@@ -0,0 +1,60 @@
+import { type Credentials, type FetchLike, type HistoryResult } from "../api/index.js";
+/**
+ * `FetchLike` over the real thing.
+ *
+ * The extension does not use this — inside the browser the request goes via the
+ * service worker, which supplies its own adapter. Keeping the shape this narrow is
+ * what lets `api/` be tested with no network and no globals at all.
+ */
+export declare const httpFetch: FetchLike;
+/**
+ * Read `.env` without taking on a dependency for it. Deliberately minimal:
+ * `KEY=value`, `#` comments, blank lines, optional surrounding quotes. A real `.env`
+ * parser handles multi-line values and interpolation; two numbers need neither.
+ *
+ * The real environment wins, so `MATRIX_XID=... <command>` works without editing the
+ * file.
+ */
+export declare function loadEnvFile(path: string): void;
+/**
+ * The raw response, kept verbatim, for the same reason the export carries
+ * `source.record`: this API is undocumented and its shape has already changed once.
+ * A normalized-only download would quietly become the smaller of the two records.
+ */
+export declare function fetchRawHistory(credentials: Credentials): Promise<unknown>;
+export interface DownloadOptions {
+    /** Directory for the raw dump and, with `split`, the per-ride documents. */
+    outDir: string;
+    /** Also write one export document per ride, as the extension's button does. */
+    split?: boolean;
+    /** Overrides the timestamped default filename. Used for a cache with one slot. */
+    rawFilename?: string;
+}
+export interface DownloadResult extends HistoryResult {
+    /** Where the verbatim response was written. */
+    rawPath: string;
+    /** The verbatim response, so a caller need not read the file back. */
+    raw: unknown;
+    /** Paths of the per-ride documents, empty unless `split`. */
+    exportPaths: string[];
+}
+/**
+ * Sign-in is the caller's job; this downloads and writes.
+ *
+ * Both requests go out together because they are the same record twice — the
+ * verbatim response for the archive, the normalized one for anything that has to
+ * read it — and serializing them would double the wait for no gain.
+ *
+ * Files are written `0600`. They are one person's heart rate and there is no reason
+ * for the rest of the machine to read them.
+ */
+export declare function downloadHistory(credentials: Credentials, options: DownloadOptions): Promise<DownloadResult>;
+/**
+ * Read a raw dump back into the normalized model.
+ *
+ * Goes through `parseHistoryResponse`, so a file read from disk and a response read
+ * off the wire are the same data handled the same way — including which records are
+ * skipped and whether the paging says something is missing.
+ */
+export declare function readRawHistoryFile(path: string): HistoryResult;
+//# sourceMappingURL=history.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"history.d.ts","sourceRoot":"","sources":["../../src/node/history.ts"],"names":[],"mappings":"AAeA,OAAO,EAKL,KAAK,WAAW,EAChB,KAAK,SAAS,EACd,KAAK,aAAa,EACnB,MAAM,iBAAiB,CAAC;AAIzB;;;;;;GAMG;AACH,eAAO,MAAM,SAAS,EAAE,SAWvB,CAAC;AAEF;;;;;;;GAOG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAc9C;AAED;;;;GAIG;AACH,wBAAsB,eAAe,CAAC,WAAW,EAAE,WAAW,GAAG,OAAO,CAAC,OAAO,CAAC,CAQhF;AAED,MAAM,WAAW,eAAe;IAC9B,4EAA4E;IAC5E,MAAM,EAAE,MAAM,CAAC;IACf,+EAA+E;IAC/E,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,kFAAkF;IAClF,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,cAAe,SAAQ,aAAa;IACnD,+CAA+C;IAC/C,OAAO,EAAE,MAAM,CAAC;IAChB,sEAAsE;IACtE,GAAG,EAAE,OAAO,CAAC;IACb,6DAA6D;IAC7D,WAAW,EAAE,MAAM,EAAE,CAAC;CACvB;AAED;;;;;;;;;GASG;AACH,wBAAsB,eAAe,CACnC,WAAW,EAAE,WAAW,EACxB,OAAO,EAAE,eAAe,GACvB,OAAO,CAAC,cAAc,CAAC,CA8BzB;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,aAAa,CAE9D"}

package/dist/node/history.js

@@ -0,0 +1,126 @@
+/**
+ * The Node half of the client: real `fetch`, real files.
+ *
+ * Everything above this file is platform-free by construction — `api/` takes a
+ * `FetchLike` rather than calling `fetch`, `parse/` takes a `ReadableStorage` rather
+ * than touching `localStorage`. This is where that abstinence is paid off exactly
+ * once, for every consumer outside the browser: the standalone CLI in `bin/`, and
+ * the MCP server in its own repo.
+ *
+ * PRIVACY: credentials pass through and are never written to the output or logged.
+ * The downloaded files are the rider's heart rate — callers choose where they land.
+ */
+import { readFileSync, writeFileSync, mkdirSync, existsSync } from "node:fs";
+import { resolve } from "node:path";
+import { ApiError, fetchWorkoutHistory, parseHistoryResponse, workoutsUrl, } from "../api/index.js";
+import { exportFilename, workoutExport } from "../export/index.js";
+import { toWorkout } from "../parse/index.js";
+/**
+ * `FetchLike` over the real thing.
+ *
+ * The extension does not use this — inside the browser the request goes via the
+ * service worker, which supplies its own adapter. Keeping the shape this narrow is
+ * what lets `api/` be tested with no network and no globals at all.
+ */
+export const httpFetch = async (url, init) => {
+    const response = await fetch(url, {
+        method: init.method ?? "GET",
+        headers: init.headers,
+        ...(init.body === undefined ? {} : { body: init.body }),
+    });
+    return {
+        ok: response.ok,
+        status: response.status,
+        json: () => response.json(),
+    };
+};
+/**
+ * Read `.env` without taking on a dependency for it. Deliberately minimal:
+ * `KEY=value`, `#` comments, blank lines, optional surrounding quotes. A real `.env`
+ * parser handles multi-line values and interpolation; two numbers need neither.
+ *
+ * The real environment wins, so `MATRIX_XID=... <command>` works without editing the
+ * file.
+ */
+export function loadEnvFile(path) {
+    if (!existsSync(path))
+        return;
+    for (const line of readFileSync(path, "utf8").split("\n")) {
+        const trimmed = line.trim();
+        if (!trimmed || trimmed.startsWith("#"))
+            continue;
+        const eq = trimmed.indexOf("=");
+        if (eq < 1)
+            continue;
+        const key = trimmed.slice(0, eq).trim();
+        if (process.env[key] !== undefined)
+            continue;
+        process.env[key] = trimmed
+            .slice(eq + 1)
+            .trim()
+            .replace(/^(["'])(.*)\1$/, "$2");
+    }
+}
+/**
+ * The raw response, kept verbatim, for the same reason the export carries
+ * `source.record`: this API is undocumented and its shape has already changed once.
+ * A normalized-only download would quietly become the smaller of the two records.
+ */
+export async function fetchRawHistory(credentials) {
+    const response = await fetch(workoutsUrl(credentials.exerciserId), {
+        headers: { Authorization: `Bearer ${credentials.token}`, Accept: "application/json" },
+    });
+    if (!response.ok) {
+        throw new ApiError(`History request failed (HTTP ${response.status}).`, response.status);
+    }
+    return response.json();
+}
+/**
+ * Sign-in is the caller's job; this downloads and writes.
+ *
+ * Both requests go out together because they are the same record twice — the
+ * verbatim response for the archive, the normalized one for anything that has to
+ * read it — and serializing them would double the wait for no gain.
+ *
+ * Files are written `0600`. They are one person's heart rate and there is no reason
+ * for the rest of the machine to read them.
+ */
+export async function downloadHistory(credentials, options) {
+    const [raw, parsed] = await Promise.all([
+        fetchRawHistory(credentials),
+        fetchWorkoutHistory(credentials, httpFetch),
+    ]);
+    mkdirSync(options.outDir, { recursive: true });
+    const stamp = new Date().toISOString().replace(/[:.]/g, "-").slice(0, 19);
+    const rawPath = resolve(options.outDir, options.rawFilename ?? `raw-history-${stamp}.json`);
+    writeFileSync(rawPath, `${JSON.stringify(raw, null, 2)}\n`, { mode: 0o600 });
+    const exportPaths = [];
+    if (options.split) {
+        // The verbatim response already holds every record; these are the normalized
+        // documents, one per ride, in the format the extension's export button writes.
+        const records = raw.workouts ?? [];
+        for (const record of records) {
+            try {
+                const workout = toWorkout(record);
+                const path = resolve(options.outDir, exportFilename(workout));
+                writeFileSync(path, `${JSON.stringify(workoutExport(workout), null, 2)}\n`, { mode: 0o600 });
+                exportPaths.push(path);
+            }
+            catch {
+                // Already counted in `skipped`; one bad record is not worth the run.
+            }
+        }
+    }
+    return { ...parsed, raw, rawPath, exportPaths };
+}
+/**
+ * Read a raw dump back into the normalized model.
+ *
+ * Goes through `parseHistoryResponse`, so a file read from disk and a response read
+ * off the wire are the same data handled the same way — including which records are
+ * skipped and whether the paging says something is missing.
+ */
+export function readRawHistoryFile(path) {
+    return parseHistoryResponse(JSON.parse(readFileSync(path, "utf8")));
+}
+//# sourceMappingURL=history.js.map

package/dist/node/history.js.map

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

package/dist/node/index.d.ts

@@ -0,0 +1,2 @@
+export * from "./history.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/node/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/node/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC"}

package/dist/node/index.js

@@ -0,0 +1,2 @@
+export * from "./history.js";
+//# sourceMappingURL=index.js.map

package/dist/node/index.js.map

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

package/dist/parse/controlSignature.d.ts

@@ -0,0 +1,38 @@
+import type { Sample } from "./types.js";
+/**
+ * How a ride's load was actually driven, derived from the samples rather than from
+ * the program id. This matters because `programType` is only partly decoded, and
+ * because the right visualization follows the control mode, not the number.
+ */
+export type ControlMode = 
+/** Resistance held flat while power moves: constant-power / ERG, e.g. a ramp test. */
+"power_controlled"
+/** Large, frequent resistance swings: discrete hard/easy blocks, e.g. Sprint 8. */
+ | "interval_blocks"
+/** Not separable from the telemetry alone. */
+ | "unclassified";
+export interface ControlSignature {
+    mode: ControlMode;
+    /** Distinct resistance levels used. */
+    levels: number;
+    minLevel: number;
+    maxLevel: number;
+    /** Number of samples where resistance differs from the previous sample. */
+    changes: number;
+    /** Changes per 100 samples. */
+    changeRate: number;
+    /** Mean magnitude of a resistance change. ~1 means single-step nudging. */
+    meanStep: number;
+}
+/**
+ * NOTE ON WHAT THIS DELIBERATELY DOES NOT DO.
+ *
+ * A closed-loop heart-rate program nudges resistance by a single level at a time
+ * (mean step ~1.0-1.4 across 24 observed rides), which looks tempting to detect.
+ * It is not reliably separable: rider-controlled rides land in the same band, and
+ * both overlap on change rate too. So this classifier names only the two modes the
+ * telemetry genuinely isolates and returns "unclassified" otherwise, exposing the
+ * raw metrics so a caller can decide with more context than the series alone.
+ */
+export declare function controlSignature(samples: readonly Sample[]): ControlSignature;
+//# sourceMappingURL=controlSignature.d.ts.map

package/dist/parse/controlSignature.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"controlSignature.d.ts","sourceRoot":"","sources":["../../src/parse/controlSignature.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC;AAEzC;;;;GAIG;AACH,MAAM,MAAM,WAAW;AACrB,sFAAsF;AACpF,kBAAkB;AACpB,mFAAmF;GACjF,iBAAiB;AACnB,8CAA8C;GAC5C,cAAc,CAAC;AAEnB,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,WAAW,CAAC;IAClB,uCAAuC;IACvC,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,2EAA2E;IAC3E,OAAO,EAAE,MAAM,CAAC;IAChB,+BAA+B;IAC/B,UAAU,EAAE,MAAM,CAAC;IACnB,2EAA2E;IAC3E,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;;;;;;;;GASG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,GAAG,gBAAgB,CAgC7E"}

package/dist/parse/controlSignature.js

@@ -0,0 +1,42 @@
+/**
+ * NOTE ON WHAT THIS DELIBERATELY DOES NOT DO.
+ *
+ * A closed-loop heart-rate program nudges resistance by a single level at a time
+ * (mean step ~1.0-1.4 across 24 observed rides), which looks tempting to detect.
+ * It is not reliably separable: rider-controlled rides land in the same band, and
+ * both overlap on change rate too. So this classifier names only the two modes the
+ * telemetry genuinely isolates and returns "unclassified" otherwise, exposing the
+ * raw metrics so a caller can decide with more context than the series alone.
+ */
+export function controlSignature(samples) {
+    const levels = samples.map((s) => s.resistanceLevel);
+    const power = samples.map((s) => s.powerWatts);
+    const distinct = new Set(levels);
+    const steps = [];
+    for (let i = 1; i < levels.length; i += 1) {
+        const delta = Math.abs(levels[i] - levels[i - 1]);
+        if (delta > 0)
+            steps.push(delta);
+    }
+    const changes = steps.length;
+    const meanStep = changes ? steps.reduce((a, b) => a + b, 0) / changes : 0;
+    const changeRate = samples.length ? (changes / samples.length) * 100 : 0;
+    const powerSpread = power.length ? Math.max(...power) - Math.min(...power) : 0;
+    let mode = "unclassified";
+    if (distinct.size === 1 && powerSpread > 50) {
+        mode = "power_controlled";
+    }
+    else if (meanStep >= 4 && changeRate >= 20) {
+        mode = "interval_blocks";
+    }
+    return {
+        mode,
+        levels: distinct.size,
+        minLevel: levels.length ? Math.min(...levels) : 0,
+        maxLevel: levels.length ? Math.max(...levels) : 0,
+        changes,
+        changeRate,
+        meanStep,
+    };
+}
+//# sourceMappingURL=controlSignature.js.map

package/dist/parse/controlSignature.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"controlSignature.js","sourceRoot":"","sources":["../../src/parse/controlSignature.ts"],"names":[],"mappings":"AA6BA;;;;;;;;;GASG;AACH,MAAM,UAAU,gBAAgB,CAAC,OAA0B;IACzD,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC;IACrD,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC;IAC/C,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,CAAC;IAEjC,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;QAC1C,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAE,GAAG,MAAM,CAAC,CAAC,GAAG,CAAC,CAAE,CAAC,CAAC;QACpD,IAAI,KAAK,GAAG,CAAC;YAAE,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACnC,CAAC;IACD,MAAM,OAAO,GAAG,KAAK,CAAC,MAAM,CAAC;IAC7B,MAAM,QAAQ,GAAG,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC;IAC1E,MAAM,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;IAEzE,MAAM,WAAW,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAE/E,IAAI,IAAI,GAAgB,cAAc,CAAC;IACvC,IAAI,QAAQ,CAAC,IAAI,KAAK,CAAC,IAAI,WAAW,GAAG,EAAE,EAAE,CAAC;QAC5C,IAAI,GAAG,kBAAkB,CAAC;IAC5B,CAAC;SAAM,IAAI,QAAQ,IAAI,CAAC,IAAI,UAAU,IAAI,EAAE,EAAE,CAAC;QAC7C,IAAI,GAAG,iBAAiB,CAAC;IAC3B,CAAC;IAED,OAAO;QACL,IAAI;QACJ,MAAM,EAAE,QAAQ,CAAC,IAAI;QACrB,QAAQ,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;QACjD,QAAQ,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;QACjD,OAAO;QACP,UAAU;QACV,QAAQ;KACT,CAAC;AACJ,CAAC"}

package/dist/parse/heartRate.d.ts

@@ -0,0 +1,78 @@
+import type { Sample } from "./types.js";
+/**
+ * Chest-strap dropouts.
+ *
+ * The console records whatever the strap reports, including nothing. Dropouts show
+ * up as implausibly low values (0, 14, 15, 30, 43...) sitting between physiologically
+ * normal neighbours. Two independent signals catch them:
+ *
+ *  - an absolute floor: a working strap on someone mid-cardio does not read 15 bpm;
+ *  - a rate-of-change limit: heart rate cannot fall 90 bpm in ten seconds.
+ *
+ * The rate check compares against the last *accepted* value, so a run of consecutive
+ * bad samples cannot drag the reference down with it.
+ *
+ * THE REFERENCE GOES STALE, AND THE CHECK HAS TO ACCOUNT FOR IT. The last accepted
+ * sample may be two minutes back, and over two minutes a heart rate legitimately
+ * moves much further than it can in ten seconds. Comparing a recovered sample
+ * against a stale reference rejects it for being too far from a value that is no
+ * longer relevant — which keeps the reference stale, and rejects the next one too.
+ * That cascade ate a third of one real ride's samples and stretched short gaps into
+ * long ones. So the allowance widens with the gap, at a rate a heart rate can
+ * actually drift.
+ *
+ * THE WIDENING IS ASYMMETRIC, because dropouts are not. A strap losing contact reads
+ * *low* — every bad value observed across the fixtures is below the true rate (0, 14,
+ * 15, 30, 43, and softer ones in the 80s and 90s during a 140 bpm ride). So widening
+ * the window equally in both directions lets the softer glitches in, and once the
+ * reference anchors on an 86 the genuine 140s that follow are all rejected. Measured
+ * on one fixture, symmetric widening made things *worse*: 83 rejected to 89.
+ *
+ * So upward moves get the full drift allowance immediately, while downward moves get
+ * none at all until the strap has been out long enough for a real fall to have
+ * happened — and only then at a slower rate. Without that grace window a two-sample
+ * gap buys just enough slack for a 121 to follow a 147, and the reference anchors on
+ * it and rejects the genuine 147s behind it; that single sample cost seven real ones
+ * on the fixture it was found in.
+ *
+ * The three constants are physiological in kind and empirical in value: they are
+ * tuned against the fixtures, and the fixtures are what should be re-run if they
+ * ever change. `npm test` asserts the outcome on every one.
+ */
+export interface HeartRateQualityOptions {
+    /** Values at or below this are dropouts regardless of context. Default 60. */
+    floorBpm?: number;
+    /** Largest plausible change between consecutive samples. Default 25 bpm per 10s. */
+    maxDeltaBpm?: number;
+    /**
+     * How fast a heart rate can plausibly *rise*, bpm per second, used to widen the
+     * rate check across a gap. Default 0.5 — 30 bpm per minute, at the top of what a
+     * hard interval start produces, so the check stays generous rather than clever.
+     */
+    driftBpmPerSecond?: number;
+    /**
+     * The same allowance for a *fall*. Much smaller, because a low reading is what a
+     * failing strap produces. Default 0.15 — still enough that a real recovery across
+     * a five-minute gap (60 bpm down) is accepted.
+     */
+    fallBpmPerSecond?: number;
+    /**
+     * A fall gets no extra allowance at all until the gap exceeds this. Below it, a
+     * sharp drop is the strap failing, not the rider easing off. Default 60 s.
+     */
+    fallGraceSeconds?: number;
+}
+/** Per-sample validity mask, parallel to `samples`. */
+export declare function flagHeartRateDropouts(samples: readonly Sample[], options?: HeartRateQualityOptions): boolean[];
+export interface HeartRateStats {
+    minBpm: number | null;
+    maxBpm: number | null;
+    meanBpm: number | null;
+    /** Count of samples accepted as real. */
+    validCount: number;
+    /** Count of samples rejected as dropouts. */
+    dropoutCount: number;
+}
+/** Summary over the samples that survive dropout filtering. */
+export declare function heartRateStats(samples: readonly Sample[], options?: HeartRateQualityOptions): HeartRateStats;
+//# sourceMappingURL=heartRate.d.ts.map

package/dist/parse/heartRate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"heartRate.d.ts","sourceRoot":"","sources":["../../src/parse/heartRate.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC;AAGzC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG;AACH,MAAM,WAAW,uBAAuB;IACtC,8EAA8E;IAC9E,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,oFAAoF;IACpF,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;;OAIG;IACH,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B;;;;OAIG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B;;;OAGG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAUD,uDAAuD;AACvD,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,SAAS,MAAM,EAAE,EAC1B,OAAO,GAAE,uBAA4B,GACpC,OAAO,EAAE,CA+BX;AAED,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,yCAAyC;IACzC,UAAU,EAAE,MAAM,CAAC;IACnB,6CAA6C;IAC7C,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,+DAA+D;AAC/D,wBAAgB,cAAc,CAC5B,OAAO,EAAE,SAAS,MAAM,EAAE,EAC1B,OAAO,GAAE,uBAA4B,GACpC,cAAc,CAehB"}

package/dist/parse/heartRate.js

@@ -0,0 +1,57 @@
+import { SAMPLE_INTERVAL_SECONDS } from "./workout.js";
+const DEFAULTS = {
+    floorBpm: 60,
+    maxDeltaBpm: 25,
+    driftBpmPerSecond: 0.5,
+    fallBpmPerSecond: 0.15,
+    fallGraceSeconds: 60,
+};
+/** Per-sample validity mask, parallel to `samples`. */
+export function flagHeartRateDropouts(samples, options = {}) {
+    const floor = options.floorBpm ?? DEFAULTS.floorBpm;
+    const maxDelta = options.maxDeltaBpm ?? DEFAULTS.maxDeltaBpm;
+    const rise = options.driftBpmPerSecond ?? DEFAULTS.driftBpmPerSecond;
+    const fall = options.fallBpmPerSecond ?? DEFAULTS.fallBpmPerSecond;
+    const fallGrace = options.fallGraceSeconds ?? DEFAULTS.fallGraceSeconds;
+    const valid = [];
+    let reference = null;
+    let referenceSeconds = 0;
+    for (const sample of samples) {
+        const bpm = sample.heartRateBpm;
+        let ok = bpm > floor;
+        if (ok && reference !== null) {
+            // Never tighter than the consecutive-sample allowance, however short the gap.
+            const gap = Math.max(SAMPLE_INTERVAL_SECONDS, sample.elapsedSeconds - referenceSeconds);
+            const change = bpm - reference;
+            const widening = change >= 0
+                ? rise * (gap - SAMPLE_INTERVAL_SECONDS)
+                : fall * Math.max(0, gap - fallGrace);
+            if (Math.abs(change) > maxDelta + widening)
+                ok = false;
+        }
+        valid.push(ok);
+        if (ok) {
+            reference = bpm;
+            referenceSeconds = sample.elapsedSeconds;
+        }
+    }
+    return valid;
+}
+/** Summary over the samples that survive dropout filtering. */
+export function heartRateStats(samples, options = {}) {
+    const valid = flagHeartRateDropouts(samples, options);
+    const good = samples.filter((_, i) => valid[i]).map((s) => s.heartRateBpm);
+    const dropoutCount = samples.length - good.length;
+    if (good.length === 0) {
+        return { minBpm: null, maxBpm: null, meanBpm: null, validCount: 0, dropoutCount };
+    }
+    const sum = good.reduce((a, b) => a + b, 0);
+    return {
+        minBpm: Math.min(...good),
+        maxBpm: Math.max(...good),
+        meanBpm: sum / good.length,
+        validCount: good.length,
+        dropoutCount,
+    };
+}
+//# sourceMappingURL=heartRate.js.map

package/dist/parse/heartRate.js.map

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

package/dist/parse/index.d.ts

@@ -0,0 +1,30 @@
+export * from "./types.js";
+export * from "./program.js";
+export * from "./persist.js";
+export * from "./machine.js";
+export * from "./workout.js";
+export * from "./heartRate.js";
+export * from "./controlSignature.js";
+import type { Workout } from "./types.js";
+/** Minimal surface we need from localStorage — keeps this testable without a DOM. */
+export interface ReadableStorage {
+    getItem(key: string): string | null;
+}
+/**
+ * Read every workout the site has cached in this browser, newest first.
+ *
+ * Note this is only what the app happens to hold — typically the current week.
+ * Deeper history lives behind the HTTP API (see AGENTS.md).
+ */
+export declare function loadCachedWorkouts(storage: ReadableStorage): Workout[];
+/**
+ * Find one workout by either of the two ids a record carries.
+ *
+ * `routeId` is tried first because the callers that matter hold a URL segment, and
+ * the site's links are built from the record's `id`. The fallback to `workoutId`
+ * keeps every other caller — fixtures, exports, tests — working, and the two id
+ * spaces do not collide: across one account's 45 records, all 45 `workoutId`s and
+ * all 45 `id`s were distinct and no value appeared in both roles.
+ */
+export declare function findWorkout(workouts: readonly Workout[], id: string): Workout | null;
+//# sourceMappingURL=index.d.ts.map

package/dist/parse/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/parse/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,cAAc,CAAC;AAC7B,cAAc,cAAc,CAAC;AAC7B,cAAc,cAAc,CAAC;AAC7B,cAAc,cAAc,CAAC;AAC7B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,uBAAuB,CAAC;AAItC,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAE1C,qFAAqF;AACrF,MAAM,WAAW,eAAe;IAC9B,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;CACrC;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,EAAE,CAItE;AAED;;;;;;;;GAQG;AACH,wBAAgB,WAAW,CAAC,QAAQ,EAAE,SAAS,OAAO,EAAE,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,GAAG,IAAI,CAEpF"}

package/dist/parse/index.js

@@ -0,0 +1,33 @@
+export * from "./types.js";
+export * from "./program.js";
+export * from "./persist.js";
+export * from "./machine.js";
+export * from "./workout.js";
+export * from "./heartRate.js";
+export * from "./controlSignature.js";
+import { extractRawWorkouts, PERSIST_KEY } from "./persist.js";
+import { toWorkout } from "./workout.js";
+/**
+ * Read every workout the site has cached in this browser, newest first.
+ *
+ * Note this is only what the app happens to hold — typically the current week.
+ * Deeper history lives behind the HTTP API (see AGENTS.md).
+ */
+export function loadCachedWorkouts(storage) {
+    return extractRawWorkouts(storage.getItem(PERSIST_KEY))
+        .map((raw) => toWorkout(raw))
+        .sort((a, b) => b.startedAt.getTime() - a.startedAt.getTime());
+}
+/**
+ * Find one workout by either of the two ids a record carries.
+ *
+ * `routeId` is tried first because the callers that matter hold a URL segment, and
+ * the site's links are built from the record's `id`. The fallback to `workoutId`
+ * keeps every other caller — fixtures, exports, tests — working, and the two id
+ * spaces do not collide: across one account's 45 records, all 45 `workoutId`s and
+ * all 45 `id`s were distinct and no value appeared in both roles.
+ */
+export function findWorkout(workouts, id) {
+    return workouts.find((w) => w.routeId === id) ?? workouts.find((w) => w.id === id) ?? null;
+}
+//# sourceMappingURL=index.js.map

package/dist/parse/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/parse/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,cAAc,CAAC;AAC7B,cAAc,cAAc,CAAC;AAC7B,cAAc,cAAc,CAAC;AAC7B,cAAc,cAAc,CAAC;AAC7B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,uBAAuB,CAAC;AAEtC,OAAO,EAAE,kBAAkB,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAC/D,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAQzC;;;;;GAKG;AACH,MAAM,UAAU,kBAAkB,CAAC,OAAwB;IACzD,OAAO,kBAAkB,CAAC,OAAO,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;SACpD,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,SAAS,CAAC,GAA8B,CAAC,CAAC;SACvD,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC,SAAS,CAAC,OAAO,EAAE,CAAC,CAAC;AACnE,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,WAAW,CAAC,QAA4B,EAAE,EAAU;IAClE,OAAO,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,KAAK,EAAE,CAAC,IAAI,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,IAAI,IAAI,CAAC;AAC7F,CAAC"}

package/dist/parse/machine.d.ts

@@ -0,0 +1,42 @@
+import type { MachineType } from "./types.js";
+/**
+ * What this extension is for, and what it declines to take over.
+ *
+ * The project's scope is the indoor bike (see AGENTS.md). That has always been true
+ * of what it was *designed* against; this module is what makes it true of what it
+ * actually renders. A treadmill or rower record populates different fields
+ * (`totalSteps`, `incline`, `totalStrokes`, `peakSpm`) and would get a dashboard
+ * built around power, resistance and cadence — three channels those machines may not
+ * report at all. Better to leave the stock page alone than to draw a confident set of
+ * panels about a ride we have never seen one of.
+ *
+ * BOTH bike types are in scope, not just the upright one. The account this was built
+ * against contains a recumbent ride (24 Jul, `raw-6a6368cb…`), and it is a committed
+ * fixture — narrowing to `upright_bike` would switch off a real ride that renders
+ * correctly today.
+ */
+export declare const BIKE_MACHINE_TYPES: readonly MachineType[];
+/**
+ * Whether to render our dashboard for this machine.
+ *
+ * `"unknown"` passes, and that is deliberate: it is `toWorkout`'s own sentinel for a
+ * record that carried no `machineType` at all, which is not knowing rather than
+ * knowing it is out of scope. The parse layer's standing rule is to stay tolerant of
+ * an undocumented upstream shape, and a record missing one field still has a full
+ * interval series worth drawing.
+ */
+export declare function isSupportedMachine(machineType: MachineType): boolean;
+/**
+ * The machine type of one cached workout, without parsing its samples.
+ *
+ * Returns `null` for "cannot tell" — no blob, unreadable blob, workout not cached,
+ * or no `machineType` on it. Callers must treat that as *not* grounds for hiding
+ * anything: most of the user's history is outside the cached week, and refusing a
+ * ride because it is old would be far worse than showing a pill we might not need.
+ *
+ * This exists so route handling can decide without going through `toWorkout`, which
+ * maps every interval into a `Sample`. The costly half of parsing stays where the
+ * design put it: on open, not on navigation.
+ */
+export declare function cachedMachineType(persistRoot: string | null | undefined, workoutId: string): MachineType | null;
+//# sourceMappingURL=machine.d.ts.map

package/dist/parse/machine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"machine.d.ts","sourceRoot":"","sources":["../../src/parse/machine.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE9C;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,kBAAkB,EAAE,SAAS,WAAW,EAAuC,CAAC;AAE7F;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAAC,WAAW,EAAE,WAAW,GAAG,OAAO,CAEpE;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,iBAAiB,CAC/B,WAAW,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EACtC,SAAS,EAAE,MAAM,GAChB,WAAW,GAAG,IAAI,CAuBpB"}

package/dist/parse/machine.js

@@ -0,0 +1,65 @@
+import { extractRawWorkouts } from "./persist.js";
+/**
+ * What this extension is for, and what it declines to take over.
+ *
+ * The project's scope is the indoor bike (see AGENTS.md). That has always been true
+ * of what it was *designed* against; this module is what makes it true of what it
+ * actually renders. A treadmill or rower record populates different fields
+ * (`totalSteps`, `incline`, `totalStrokes`, `peakSpm`) and would get a dashboard
+ * built around power, resistance and cadence — three channels those machines may not
+ * report at all. Better to leave the stock page alone than to draw a confident set of
+ * panels about a ride we have never seen one of.
+ *
+ * BOTH bike types are in scope, not just the upright one. The account this was built
+ * against contains a recumbent ride (24 Jul, `raw-6a6368cb…`), and it is a committed
+ * fixture — narrowing to `upright_bike` would switch off a real ride that renders
+ * correctly today.
+ */
+export const BIKE_MACHINE_TYPES = ["upright_bike", "recumbent_bike"];
+/**
+ * Whether to render our dashboard for this machine.
+ *
+ * `"unknown"` passes, and that is deliberate: it is `toWorkout`'s own sentinel for a
+ * record that carried no `machineType` at all, which is not knowing rather than
+ * knowing it is out of scope. The parse layer's standing rule is to stay tolerant of
+ * an undocumented upstream shape, and a record missing one field still has a full
+ * interval series worth drawing.
+ */
+export function isSupportedMachine(machineType) {
+    return machineType === "unknown" || BIKE_MACHINE_TYPES.includes(machineType);
+}
+/**
+ * The machine type of one cached workout, without parsing its samples.
+ *
+ * Returns `null` for "cannot tell" — no blob, unreadable blob, workout not cached,
+ * or no `machineType` on it. Callers must treat that as *not* grounds for hiding
+ * anything: most of the user's history is outside the cached week, and refusing a
+ * ride because it is old would be far worse than showing a pill we might not need.
+ *
+ * This exists so route handling can decide without going through `toWorkout`, which
+ * maps every interval into a `Sample`. The costly half of parsing stays where the
+ * design put it: on open, not on navigation.
+ */
+export function cachedMachineType(persistRoot, workoutId) {
+    let records;
+    try {
+        records = extractRawWorkouts(persistRoot);
+    }
+    catch {
+        // A blob we cannot read is not a machine type we know. Opening the view will
+        // surface the real parse error; this is not the place to report it.
+        return null;
+    }
+    // Matched against both identifiers, in both key styles: `workoutId` names the
+    // ride but the URL this is called with carries the record's `id`, and the two
+    // differ on every ride before 13 Aug 2026. See `Workout.routeId`.
+    const record = records.find((w) => {
+        const raw = w;
+        return (raw["id"] === workoutId || raw["workoutId"] === workoutId || raw["workout_id"] === workoutId);
+    });
+    if (!record)
+        return null;
+    const type = record["machineType"] ?? record["machine_type"];
+    return typeof type === "string" && type !== "" ? type : null;
+}
+//# sourceMappingURL=machine.js.map

package/dist/parse/machine.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"machine.js","sourceRoot":"","sources":["../../src/parse/machine.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAGlD;;;;;;;;;;;;;;;GAeG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAA2B,CAAC,cAAc,EAAE,gBAAgB,CAAC,CAAC;AAE7F;;;;;;;;GAQG;AACH,MAAM,UAAU,kBAAkB,CAAC,WAAwB;IACzD,OAAO,WAAW,KAAK,SAAS,IAAI,kBAAkB,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC;AAC/E,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,iBAAiB,CAC/B,WAAsC,EACtC,SAAiB;IAEjB,IAAI,OAAO,CAAC;IACZ,IAAI,CAAC;QACH,OAAO,GAAG,kBAAkB,CAAC,WAAW,CAAC,CAAC;IAC5C,CAAC;IAAC,MAAM,CAAC;QACP,6EAA6E;QAC7E,oEAAoE;QACpE,OAAO,IAAI,CAAC;IACd,CAAC;IAED,8EAA8E;IAC9E,8EAA8E;IAC9E,kEAAkE;IAClE,MAAM,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE;QAChC,MAAM,GAAG,GAAG,CAA4B,CAAC;QACzC,OAAO,CACL,GAAG,CAAC,IAAI,CAAC,KAAK,SAAS,IAAI,GAAG,CAAC,WAAW,CAAC,KAAK,SAAS,IAAI,GAAG,CAAC,YAAY,CAAC,KAAK,SAAS,CAC7F,CAAC;IACJ,CAAC,CAAwC,CAAC;IAC1C,IAAI,CAAC,MAAM;QAAE,OAAO,IAAI,CAAC;IAEzB,MAAM,IAAI,GAAG,MAAM,CAAC,aAAa,CAAC,IAAI,MAAM,CAAC,cAAc,CAAC,CAAC;IAC7D,OAAO,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,KAAK,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC;AAC/D,CAAC"}