matrix-workouts-core 0.1.0

package/dist/parse/persist.d.ts

@@ -0,0 +1,13 @@
+import { type RawWorkout } from "./types.js";
+/** localStorage key the site's redux-persist store lives under. */
+export declare const PERSIST_KEY = "root";
+/**
+ * The persisted blob is a JSON object whose *values are themselves JSON strings*.
+ * Missing that double encoding is the single easiest way to get this wrong.
+ */
+export type PersistRoot = Record<string, unknown>;
+/** Parse the outer blob and the inner JSON-string slice named by `slice`. */
+export declare function parsePersistSlice(raw: string | null | undefined, slice: string): PersistRoot;
+/** Pull the raw workout array out of the persisted blob. Absent/!array -> []. */
+export declare function extractRawWorkouts(raw: string | null | undefined): RawWorkout[];
+//# sourceMappingURL=persist.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"persist.d.ts","sourceRoot":"","sources":["../../src/parse/persist.ts"],"names":[],"mappings":"AAAA,OAAO,EAAqB,KAAK,UAAU,EAAE,MAAM,YAAY,CAAC;AAEhE,mEAAmE;AACnE,eAAO,MAAM,WAAW,SAAS,CAAC;AAElC;;;GAGG;AACH,MAAM,MAAM,WAAW,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAUlD,6EAA6E;AAC7E,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EAAE,KAAK,EAAE,MAAM,GAAG,WAAW,CAoB5F;AAED,iFAAiF;AACjF,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,UAAU,EAAE,CAO/E"}

package/dist/parse/persist.js

@@ -0,0 +1,40 @@
+import { WorkoutParseError } from "./types.js";
+/** localStorage key the site's redux-persist store lives under. */
+export const PERSIST_KEY = "root";
+function parseJson(raw, what) {
+    try {
+        return JSON.parse(raw);
+    }
+    catch {
+        throw new WorkoutParseError(`${what} is not valid JSON.`);
+    }
+}
+/** Parse the outer blob and the inner JSON-string slice named by `slice`. */
+export function parsePersistSlice(raw, slice) {
+    if (raw == null || raw === "") {
+        throw new WorkoutParseError(`No workout data found in this browser (localStorage "${PERSIST_KEY}" is empty). Open a workout on the site first.`);
+    }
+    const outer = parseJson(raw, `localStorage "${PERSIST_KEY}"`);
+    if (typeof outer !== "object" || outer === null || Array.isArray(outer)) {
+        throw new WorkoutParseError(`localStorage "${PERSIST_KEY}" is not an object.`);
+    }
+    const value = outer[slice];
+    if (value === undefined) {
+        throw new WorkoutParseError(`"${slice}" is missing from the stored data.`);
+    }
+    // Slices are normally JSON strings, but tolerate an already-parsed object.
+    const inner = typeof value === "string" ? parseJson(value, `"${slice}"`) : value;
+    if (typeof inner !== "object" || inner === null || Array.isArray(inner)) {
+        throw new WorkoutParseError(`"${slice}" did not contain an object.`);
+    }
+    return inner;
+}
+/** Pull the raw workout array out of the persisted blob. Absent/!array -> []. */
+export function extractRawWorkouts(raw) {
+    const userStore = parsePersistSlice(raw, "userStore");
+    const workouts = userStore["workouts"];
+    if (!Array.isArray(workouts))
+        return [];
+    return workouts.filter((w) => typeof w === "object" && w !== null && !Array.isArray(w));
+}
+//# sourceMappingURL=persist.js.map

package/dist/parse/persist.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"persist.js","sourceRoot":"","sources":["../../src/parse/persist.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAmB,MAAM,YAAY,CAAC;AAEhE,mEAAmE;AACnE,MAAM,CAAC,MAAM,WAAW,GAAG,MAAM,CAAC;AAQlC,SAAS,SAAS,CAAC,GAAW,EAAE,IAAY;IAC1C,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAY,CAAC;IACpC,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,IAAI,iBAAiB,CAAC,GAAG,IAAI,qBAAqB,CAAC,CAAC;IAC5D,CAAC;AACH,CAAC;AAED,6EAA6E;AAC7E,MAAM,UAAU,iBAAiB,CAAC,GAA8B,EAAE,KAAa;IAC7E,IAAI,GAAG,IAAI,IAAI,IAAI,GAAG,KAAK,EAAE,EAAE,CAAC;QAC9B,MAAM,IAAI,iBAAiB,CACzB,wDAAwD,WAAW,gDAAgD,CACpH,CAAC;IACJ,CAAC;IACD,MAAM,KAAK,GAAG,SAAS,CAAC,GAAG,EAAE,iBAAiB,WAAW,GAAG,CAAC,CAAC;IAC9D,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACxE,MAAM,IAAI,iBAAiB,CAAC,iBAAiB,WAAW,qBAAqB,CAAC,CAAC;IACjF,CAAC;IACD,MAAM,KAAK,GAAI,KAAiC,CAAC,KAAK,CAAC,CAAC;IACxD,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QACxB,MAAM,IAAI,iBAAiB,CAAC,IAAI,KAAK,oCAAoC,CAAC,CAAC;IAC7E,CAAC;IACD,2EAA2E;IAC3E,MAAM,KAAK,GAAG,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;IACjF,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACxE,MAAM,IAAI,iBAAiB,CAAC,IAAI,KAAK,8BAA8B,CAAC,CAAC;IACvE,CAAC;IACD,OAAO,KAAoB,CAAC;AAC9B,CAAC;AAED,iFAAiF;AACjF,MAAM,UAAU,kBAAkB,CAAC,GAA8B;IAC/D,MAAM,SAAS,GAAG,iBAAiB,CAAC,GAAG,EAAE,WAAW,CAAC,CAAC;IACtD,MAAM,QAAQ,GAAG,SAAS,CAAC,UAAU,CAAC,CAAC;IACvC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC;QAAE,OAAO,EAAE,CAAC;IACxC,OAAO,QAAQ,CAAC,MAAM,CACpB,CAAC,CAAC,EAAmB,EAAE,CAAC,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CACjF,CAAC;AACJ,CAAC"}

package/dist/parse/program.d.ts

@@ -0,0 +1,58 @@
+/**
+ * Console program ("mode") identification.
+ *
+ * `programType` is the numeric console program id and is the mode marker. Values
+ * observed across one account's 44 workouts: 46 (27x), 18 (7x), 20 (4x), 47 (3x),
+ * 0 (2x), 38 (1x). Only the ids the rider has confirmed are named here — the rest
+ * are deliberately left unmapped rather than guessed at.
+ */
+export type ProgramMode = "sprint_8" | "target_heart_rate" | "target_watts" | "fitness_test" | "virtual_active" | "unknown";
+export declare const PROGRAM_MODES: Readonly<Record<number, ProgramMode>>;
+/**
+ * How these were established, and why 0 is still unknown.
+ *
+ * The rider keeps a Notion training log with a dated row per session. Matching ride
+ * dates and durations against it identifies the modes directly, rather than by
+ * inference from the telemetry:
+ *
+ *  - **20 = target watts.** All four program-20 rides are explicitly watt-target
+ *    sessions in the log ("2x18 min at 145-150 W", "4x4 @ 200 W", "2x18 min @
+ *    155 W", "2x20 min @ 155 W"). The 2026-08-12 ride matches its log row exactly:
+ *    46.07 min, 22.29 km, 129 W average.
+ *  - **38 = fitness test.** The single program-38 ride matches the log's
+ *    "Fitness test / indoor bike" row exactly: 2026-07-20, 902 s, 7419 m, 148 W
+ *    average against a logged 149 W. The console reported a VO2 estimate and
+ *    "final stage completed: 7", which is why the series shows eight power stages
+ *    at a fixed resistance.
+ *  - **46 = target heart rate**, independently corroborated by log entries that
+ *    name the mode ("Relaxed Zone 2 ride in Target HR mode", "Target HR was 139").
+ *  - **47 = Virtual Active**, the console's scenic-route mode, where the video's
+ *    terrain drives resistance and the rider answers it with cadence. Reported by
+ *    the rider off the console for the 2026-09-13 ride (2403 s, 20.37 km, 145 W
+ *    average, 241 samples). That is one confirmed ride naming an id, the same
+ *    standard that pinned 38, and the other two program-47 rides inherit the name
+ *    by id without a confirmation of their own. Do not try to corroborate that
+ *    from the series: both 47 rides open 1, 4, 4, 4, ... which looks like a
+ *    signature until you check `raw-6aa04566...`, a program 46, which opens
+ *    1, 4, 4 as well.
+ *
+ * Program 0 remains "unknown": its rides are in the log but no entry names a console
+ * mode, and the telemetry does not separate it. It is plausibly manual / quick-start
+ * (that is the usual console convention for id 0, and both rides are short
+ * unstructured efforts) but that is a convention, not evidence.
+ *
+ * A power-plateau heuristic was tried as a way to detect watt-target rides from the
+ * data alone and REJECTED: across all 43 rides, program 20 scores 0.50-0.76 but
+ * three program-46 rides score 0.51-0.72, so any threshold misclassifies them.
+ * Use programType for this, not a derived signal.
+ */
+export declare function programMode(programType: number | null | undefined): ProgramMode;
+/** The eight per-sprint scores from a Sprint 8 (HIIT) ride, in order 1..8. */
+export interface Sprint8Result {
+    /** Sum of `scores` — the console's "sweat score". */
+    sweatScore: number;
+    /** Exactly eight scores, sprint 1 through 8. */
+    scores: number[];
+    programLevel: number | null;
+}
+//# sourceMappingURL=program.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"program.d.ts","sourceRoot":"","sources":["../../src/parse/program.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,MAAM,MAAM,WAAW,GACnB,UAAU,GACV,mBAAmB,GACnB,cAAc,GACd,cAAc,GACd,gBAAgB,GAChB,SAAS,CAAC;AAEd,eAAO,MAAM,aAAa,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAM9D,CAAC;AAEH;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AAEH,wBAAgB,WAAW,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,WAAW,CAG/E;AAED,8EAA8E;AAC9E,MAAM,WAAW,aAAa;IAC5B,qDAAqD;IACrD,UAAU,EAAE,MAAM,CAAC;IACnB,gDAAgD;IAChD,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;CAC7B"}

package/dist/parse/program.js

@@ -0,0 +1,51 @@
+export const PROGRAM_MODES = Object.freeze({
+    18: "sprint_8", // carries sprintScores; confirmed by rider
+    46: "target_heart_rate", // confirmed by rider and by their training log
+    20: "target_watts", // all 4 rides are watt-target sessions in the log
+    38: "fitness_test", // console VO2 / Cooper test; exact match in the log
+    47: "virtual_active", // confirmed by rider off the console, 13 Sep 2026 ride
+});
+/**
+ * How these were established, and why 0 is still unknown.
+ *
+ * The rider keeps a Notion training log with a dated row per session. Matching ride
+ * dates and durations against it identifies the modes directly, rather than by
+ * inference from the telemetry:
+ *
+ *  - **20 = target watts.** All four program-20 rides are explicitly watt-target
+ *    sessions in the log ("2x18 min at 145-150 W", "4x4 @ 200 W", "2x18 min @
+ *    155 W", "2x20 min @ 155 W"). The 2026-08-12 ride matches its log row exactly:
+ *    46.07 min, 22.29 km, 129 W average.
+ *  - **38 = fitness test.** The single program-38 ride matches the log's
+ *    "Fitness test / indoor bike" row exactly: 2026-07-20, 902 s, 7419 m, 148 W
+ *    average against a logged 149 W. The console reported a VO2 estimate and
+ *    "final stage completed: 7", which is why the series shows eight power stages
+ *    at a fixed resistance.
+ *  - **46 = target heart rate**, independently corroborated by log entries that
+ *    name the mode ("Relaxed Zone 2 ride in Target HR mode", "Target HR was 139").
+ *  - **47 = Virtual Active**, the console's scenic-route mode, where the video's
+ *    terrain drives resistance and the rider answers it with cadence. Reported by
+ *    the rider off the console for the 2026-09-13 ride (2403 s, 20.37 km, 145 W
+ *    average, 241 samples). That is one confirmed ride naming an id, the same
+ *    standard that pinned 38, and the other two program-47 rides inherit the name
+ *    by id without a confirmation of their own. Do not try to corroborate that
+ *    from the series: both 47 rides open 1, 4, 4, 4, ... which looks like a
+ *    signature until you check `raw-6aa04566...`, a program 46, which opens
+ *    1, 4, 4 as well.
+ *
+ * Program 0 remains "unknown": its rides are in the log but no entry names a console
+ * mode, and the telemetry does not separate it. It is plausibly manual / quick-start
+ * (that is the usual console convention for id 0, and both rides are short
+ * unstructured efforts) but that is a convention, not evidence.
+ *
+ * A power-plateau heuristic was tried as a way to detect watt-target rides from the
+ * data alone and REJECTED: across all 43 rides, program 20 scores 0.50-0.76 but
+ * three program-46 rides score 0.51-0.72, so any threshold misclassifies them.
+ * Use programType for this, not a derived signal.
+ */
+export function programMode(programType) {
+    if (programType == null)
+        return "unknown";
+    return PROGRAM_MODES[programType] ?? "unknown";
+}
+//# sourceMappingURL=program.js.map

package/dist/parse/program.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"program.js","sourceRoot":"","sources":["../../src/parse/program.ts"],"names":[],"mappings":"AAgBA,MAAM,CAAC,MAAM,aAAa,GAA0C,MAAM,CAAC,MAAM,CAAC;IAChF,EAAE,EAAE,UAAU,EAAW,2CAA2C;IACpE,EAAE,EAAE,mBAAmB,EAAE,+CAA+C;IACxE,EAAE,EAAE,cAAc,EAAO,kDAAkD;IAC3E,EAAE,EAAE,cAAc,EAAO,oDAAoD;IAC7E,EAAE,EAAE,gBAAgB,EAAK,uDAAuD;CACjF,CAAC,CAAC;AAEH;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AAEH,MAAM,UAAU,WAAW,CAAC,WAAsC;IAChE,IAAI,WAAW,IAAI,IAAI;QAAE,OAAO,SAAS,CAAC;IAC1C,OAAO,aAAa,CAAC,WAAW,CAAC,IAAI,SAAS,CAAC;AACjD,CAAC"}

package/dist/parse/types.d.ts

@@ -0,0 +1,127 @@
+import type { ProgramMode, Sprint8Result } from "./program.js";
+/**
+ * Types for the jfit workout record.
+ *
+ * `Raw*` types mirror the upstream shape byte-for-byte, quirks and all. Everything
+ * downstream should consume the normalized types, whose field names carry units —
+ * upstream names are ambiguous and in one case (`averageDistance`, which is
+ * cumulative) actively misleading.
+ */
+/** Machine types seen in the wild. Unknown values are preserved, not rejected. */
+export type KnownMachineType = "upright_bike" | "recumbent_bike" | "treadmill" | "rower" | "elliptical";
+export type MachineType = KnownMachineType | (string & {});
+/** One sample, emitted every 10 seconds by the console. */
+export interface RawInterval {
+    /** Seconds covered by this sample: 10 for every sample except the last, which is 0. */
+    duration: number;
+    /** Distance covered during this sample, meters. Quantized to 0.01 mile. */
+    distance: number;
+    /** CUMULATIVE distance to this point, meters. The name is a misnomer. */
+    averageDistance: number;
+    speed: number;
+    rpm: number;
+    power: number;
+    resistance: number;
+    heartRate: number;
+    incline: number;
+    totalSteps: number;
+}
+export interface RawSprintScores {
+    [sprint: string]: number;
+}
+export interface RawWorkout {
+    workoutId: string;
+    /**
+     * The record's own document id, and the segment the site's `/workouts/:id` links
+     * use. NOT interchangeable with `workoutId` — see `Workout.routeId`.
+     */
+    id?: string;
+    workoutTime: string;
+    machineType: MachineType;
+    exerciseTitle?: string;
+    workoutType?: string;
+    workoutSource?: string;
+    machineId?: string;
+    programType?: number;
+    duration: number;
+    distance: number;
+    calories?: number;
+    minHeartRate?: number;
+    maxHeartRate?: number;
+    averageHeartRate?: number;
+    archived?: number;
+    /** Sprint 8 rides only: the console's sweat score (== sum of sprintScores). */
+    totalSweatScore?: number;
+    /** Sprint 8 rides only: eight scores keyed "1".."8". Its presence identifies the mode. */
+    sprintScores?: RawSprintScores;
+    programLevel?: number;
+    sprint8ProgramLevel?: number;
+    intervals?: RawInterval[];
+    [key: string]: unknown;
+}
+/** A normalized sample. Units are in the names; time is elapsed from workout start. */
+export interface Sample {
+    elapsedSeconds: number;
+    /** Distance covered during this sample, meters. */
+    distanceMeters: number;
+    /** Cumulative distance at this sample, meters. */
+    cumulativeDistanceMeters: number;
+    speedKmh: number;
+    cadenceRpm: number;
+    powerWatts: number;
+    /** Console resistance level. Range is machine- and program-dependent (1–13 observed). */
+    resistanceLevel: number;
+    heartRateBpm: number;
+    inclinePercent: number;
+    totalSteps: number;
+}
+export interface Workout {
+    /** The record's `workoutId`. Fixture filenames and the export are named by it. */
+    id: string;
+    /**
+     * The id the site's own `/workouts/:id` links carry — the record's `id` field.
+     *
+     * On every ride recorded before 13 Aug 2026 this is a DIFFERENT value from `id`,
+     * so anything resolving a URL must go through `findWorkout`, which accepts either.
+     * Falls back to `id` for a record that carries no `id` field at all.
+     */
+    routeId: string;
+    /** Start of the workout. */
+    startedAt: Date;
+    machineType: MachineType;
+    machineId: string | null;
+    /** Numeric console program id, e.g. 46. Raw value, always preserved. */
+    programType: number | null;
+    /** Named mode for the program id, where known. */
+    mode: ProgramMode;
+    /** Present only on Sprint 8 rides; null otherwise. */
+    sprint8: Sprint8Result | null;
+    durationSeconds: number;
+    distanceMeters: number;
+    calories: number | null;
+    /**
+     * Summary heart rate as reported by the platform. NOTE: these are NOT derived
+     * from `samples` and do not always agree with them — compute your own from the
+     * series if you need consistency.
+     */
+    reported: {
+        minHeartRateBpm: number | null;
+        maxHeartRateBpm: number | null;
+        averageHeartRateBpm: number | null;
+    };
+    archived: boolean;
+    samples: Sample[];
+    /**
+     * The record exactly as it arrived, untouched: camelCase from localStorage,
+     * snake_case from the API. Kept so an export can be lossless — the upstream
+     * shape is undocumented and carries fields this model does not name, and
+     * dropping them silently would make the exported file a worse record of the
+     * ride than the one the browser already had.
+     */
+    raw: Record<string, unknown>;
+}
+/** Every parse failure surfaces as this, with a message safe to show a user. */
+export declare class WorkoutParseError extends Error {
+    name: string;
+}
+//# sourceMappingURL=types.d.ts.map

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

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

package/dist/parse/types.js

@@ -0,0 +1,5 @@
+/** Every parse failure surfaces as this, with a message safe to show a user. */
+export class WorkoutParseError extends Error {
+    name = "WorkoutParseError";
+}
+//# sourceMappingURL=types.js.map

package/dist/parse/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/parse/types.ts"],"names":[],"mappings":"AAkIA,gFAAgF;AAChF,MAAM,OAAO,iBAAkB,SAAQ,KAAK;IACjC,IAAI,GAAG,mBAAmB,CAAC;CACrC"}

package/dist/parse/workout.d.ts

@@ -0,0 +1,22 @@
+import type { RawWorkout, Workout } from "./types.js";
+/**
+ * The console records distance in hundredths of a mile and the API converts to
+ * meters, so every per-sample distance is a multiple of this. Useful as a sanity
+ * check, and it explains why summed samples drift from the reported total.
+ */
+export declare const DISTANCE_QUANTUM_METERS = 16.09;
+/**
+ * Nominal seconds between samples. Every sample reports 10 EXCEPT the final one,
+ * whose duration is whatever fraction of a sample the ride ended on — observed as
+ * 0, 1, 2, 3, 5, 6, 7, 8, 10 and 11 across one account's history. Never assume the
+ * last sample is 0, and never derive elapsed time as `index * 10`.
+ */
+export declare const SAMPLE_INTERVAL_SECONDS = 10;
+/**
+ * The HTTP API returns snake_case; the persisted localStorage blob returns
+ * camelCase. Normalize both to camelCase so one code path handles either source.
+ */
+export declare function camelizeWorkout(raw: Record<string, unknown>): RawWorkout;
+/** Normalize one raw record. Accepts either the API or the localStorage shape. */
+export declare function toWorkout(input: Record<string, unknown>): Workout;
+//# sourceMappingURL=workout.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"workout.d.ts","sourceRoot":"","sources":["../../src/parse/workout.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAe,UAAU,EAAU,OAAO,EAAE,MAAM,YAAY,CAAC;AAG3E;;;;GAIG;AACH,eAAO,MAAM,uBAAuB,QAAQ,CAAC;AAE7C;;;;;GAKG;AACH,eAAO,MAAM,uBAAuB,KAAK,CAAC;AAY1C;;;GAGG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,UAAU,CAmBxE;AAkCD,kFAAkF;AAClF,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAoDjE"}

package/dist/parse/workout.js

@@ -0,0 +1,130 @@
+import { programMode } from "./program.js";
+import { WorkoutParseError } from "./types.js";
+/**
+ * The console records distance in hundredths of a mile and the API converts to
+ * meters, so every per-sample distance is a multiple of this. Useful as a sanity
+ * check, and it explains why summed samples drift from the reported total.
+ */
+export const DISTANCE_QUANTUM_METERS = 16.09;
+/**
+ * Nominal seconds between samples. Every sample reports 10 EXCEPT the final one,
+ * whose duration is whatever fraction of a sample the ride ended on — observed as
+ * 0, 1, 2, 3, 5, 6, 7, 8, 10 and 11 across one account's history. Never assume the
+ * last sample is 0, and never derive elapsed time as `index * 10`.
+ */
+export const SAMPLE_INTERVAL_SECONDS = 10;
+const num = (v) => typeof v === "number" && Number.isFinite(v) ? v : null;
+const numOr = (v, fallback) => num(v) ?? fallback;
+/** Convert snake_case keys to camelCase, one level deep plus nested intervals. */
+function camelizeKey(key) {
+    return key.replace(/_([a-z0-9])/g, (_, c) => c.toUpperCase());
+}
+/**
+ * The HTTP API returns snake_case; the persisted localStorage blob returns
+ * camelCase. Normalize both to camelCase so one code path handles either source.
+ */
+export function camelizeWorkout(raw) {
+    const out = {};
+    for (const [k, v] of Object.entries(raw)) {
+        const key = camelizeKey(k);
+        if (key === "intervals" && Array.isArray(v)) {
+            out[key] = v.map((iv) => {
+                const s = {};
+                if (iv && typeof iv === "object") {
+                    for (const [ik, ivv] of Object.entries(iv)) {
+                        s[camelizeKey(ik)] = ivv;
+                    }
+                }
+                return s;
+            });
+        }
+        else {
+            out[key] = v;
+        }
+    }
+    return out;
+}
+function toSample(raw, elapsedSeconds) {
+    return {
+        elapsedSeconds,
+        distanceMeters: numOr(raw.distance, 0),
+        cumulativeDistanceMeters: numOr(raw.averageDistance, 0),
+        speedKmh: numOr(raw.speed, 0),
+        cadenceRpm: numOr(raw.rpm, 0),
+        powerWatts: numOr(raw.power, 0),
+        resistanceLevel: numOr(raw.resistance, 0),
+        heartRateBpm: numOr(raw.heartRate, 0),
+        inclinePercent: numOr(raw.incline, 0),
+        totalSteps: numOr(raw.totalSteps, 0),
+    };
+}
+function toSprint8(raw) {
+    const scoresByKey = raw.sprintScores;
+    if (!scoresByKey || typeof scoresByKey !== "object")
+        return null;
+    const scores = [];
+    for (let i = 1; i <= 8; i += 1) {
+        const v = num(scoresByKey[String(i)]);
+        if (v === null)
+            return null; // partial score sets are not a Sprint 8 result
+        scores.push(v);
+    }
+    const summed = scores.reduce((a, b) => a + b, 0);
+    return {
+        scores,
+        sweatScore: num(raw.totalSweatScore) ?? summed,
+        programLevel: num(raw.sprint8ProgramLevel) ?? num(raw.programLevel),
+    };
+}
+/** Normalize one raw record. Accepts either the API or the localStorage shape. */
+export function toWorkout(input) {
+    const raw = camelizeWorkout(input);
+    // Two identifiers, and they are not interchangeable: `workoutId` names the ride,
+    // `id` is what the site's own /workouts/:id links carry. They coincide only on
+    // rides recorded from 13 Aug 2026 onwards. Either one alone still identifies a
+    // record, so a record carrying only one of them is read rather than rejected.
+    const workoutId = typeof raw.workoutId === "string" ? raw.workoutId : null;
+    const recordId = typeof raw.id === "string" ? raw.id : null;
+    const id = workoutId ?? recordId;
+    if (!id)
+        throw new WorkoutParseError("Workout record has no workoutId and no id.");
+    const startedAt = new Date(String(raw.workoutTime));
+    if (Number.isNaN(startedAt.getTime())) {
+        throw new WorkoutParseError(`Workout ${id} has an unreadable workoutTime.`);
+    }
+    const intervals = Array.isArray(raw.intervals) ? raw.intervals : [];
+    const programType = num(raw.programType);
+    // Elapsed time accumulates each sample's own duration, so a short final sample
+    // (or any irregular one) lands at the right place on the clock.
+    let elapsed = 0;
+    const samples = intervals.map((interval) => {
+        const sample = toSample(interval, elapsed);
+        elapsed += numOr(interval.duration, SAMPLE_INTERVAL_SECONDS);
+        return sample;
+    });
+    return {
+        id,
+        routeId: recordId ?? id,
+        startedAt,
+        machineType: typeof raw.machineType === "string" ? raw.machineType : "unknown",
+        machineId: typeof raw.machineId === "string" ? raw.machineId : null,
+        programType,
+        mode: programMode(programType),
+        sprint8: toSprint8(raw),
+        durationSeconds: numOr(raw.duration, 0),
+        distanceMeters: numOr(raw.distance, 0),
+        calories: num(raw.calories),
+        reported: {
+            minHeartRateBpm: num(raw.minHeartRate),
+            maxHeartRateBpm: num(raw.maxHeartRate),
+            averageHeartRateBpm: num(raw.averageHeartRate),
+        },
+        archived: numOr(raw.archived, 0) !== 0,
+        samples,
+        // `input`, not `raw`: the camelized copy has already dropped the distinction
+        // between the two upstream shapes, and a fixture captured through the export
+        // has to come back out in the shape it went in.
+        raw: input,
+    };
+}
+//# sourceMappingURL=workout.js.map

package/dist/parse/workout.js.map

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

package/package.json

@@ -0,0 +1,68 @@
+{
+  "name": "matrix-workouts-core",
+  "version": "0.1.0",
+  "description": "Parser, API client and export format for Matrix / Johnson Fitness workout records",
+  "license": "MIT",
+  "author": "Christoph Halang",
+  "type": "module",
+  "keywords": [
+    "matrix-fitness",
+    "johnson-fitness",
+    "jfit",
+    "workout",
+    "cycling",
+    "power",
+    "cadence",
+    "heart-rate",
+    "telemetry"
+  ],
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./node": {
+      "types": "./dist/node/index.d.ts",
+      "import": "./dist/node/index.js"
+    }
+  },
+  "bin": {
+    "matrix-workouts-history": "dist/node/bin/history.js"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "MATRIX_API.md",
+    "CHANGELOG.md",
+    "LICENSE"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/bestimmaa/matrix-workouts-core.git"
+  },
+  "bugs": {
+    "url": "https://github.com/bestimmaa/matrix-workouts-core/issues"
+  },
+  "homepage": "https://github.com/bestimmaa/matrix-workouts-core#readme",
+  "publishConfig": {
+    "access": "public"
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "scripts": {
+    "build": "rm -rf dist && tsc -p tsconfig.build.json && chmod +x dist/node/bin/history.js",
+    "prepare": "npm run build",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "history": "vite-node src/node/bin/history.ts --",
+    "release": "node scripts/release.js"
+  },
+  "devDependencies": {
+    "@types/node": "^22.20.2",
+    "typescript": "^5.7.2",
+    "vite-node": "^2.1.8",
+    "vitest": "^2.1.8"
+  }
+}