Imported from pablo-albaladejo/kaiord (packages/train2go-bridge/test/fixtures/AGENTS.md). Install upstream with npx skills add pablo-albaladejo/kaiord --skill fixtures. Copyright stays with the author.

test/fixtures/

Test data: HTML fragments and JSON responses from Train2Go APIs, used to validate parsers and message handlers without a live session.

Files

Usage in Tests

import fs from "fs";
import { parseWeeklyHtml } from "../parser.js";

const fixturesDir = import.meta.dirname;

it("should parse activities from weekly HTML", () => {
  // Arrange
  const html = fs.readFileSync(fixturesDir + "/weekly.html", "utf-8");

  // Act
  const activities = parseWeeklyHtml(html);

  // Assert
  expect(activities).toBeInstanceOf(Array);
  expect(activities[0]).toMatchObject({
    id: expect.any(Number),
    date: expect.stringMatching(/\d{4}-\d{2}-\d{2}/),
    sport: expect.any(String),
    title: expect.any(String),
  });
});

Fixture Formats

weekly.html, daily.html

HTML fragments containing:

• Activity table rows with data-id, data-status, class="measured", etc.
• Sport icons: icon-sportsCycling, icon-sportsRunning, etc.
• Workload values in data-value="..." attributes
• Titles in title="..." attributes

Used by parser.js with regex-based extraction (no DOM parsing in fixtures).

details-active.html

Server-rendered HTML page with:

• User profile display
• Training zones table with low/high thresholds (HR, power, pace)
• Extracted via parseDetailsHtml to populate profile zones

ping-active.json, ping-expired.json

JSON responses from /api/v2/profile/ping:

{
  "status": "ok",
  "profile_id": 12345,
  "name": "John Doe",
  "zones": { ... }
}

or

{
  "status": "unauthenticated"
}

Updating Fixtures

When Train2Go HTML structure changes:

1. Capture live HTML from app.train2go.com (F12 → Network → Copy Response)
2. Save to fixture file, redacting any PII (real names, profile IDs, email addresses)
3. Verify parser tests still pass: pnpm --filter @kaiord/train2go-bridge test:watch
4. Commit fixture change with explanation in commit message

Privacy: All fixtures must be anonymized — no real user data.

For AI Agents

• Load fixtures via fs.readFileSync(import.meta.dirname + "/filename", "utf-8")
• Pass to parser functions; parsers expect raw HTML/JSON strings, not DOM objects
• Use fixtures to test graceful degradation (malformed HTML should not throw)
• When adding new parser functions, add corresponding fixture files