bowlslink-client 0.1.0

package/README.md

@@ -0,0 +1,167 @@
+# bowlslink-client
+
+A TypeScript client library for the [BowlsLink](https://results.bowlslink.com.au/) Results API. Fetch pennant teams, match results, ladder standings, and team sheets for any Australian bowls club.
+
+Built for club website maintainers who want to display live pennant data without reverse-engineering the API themselves.
+
+## Install
+
+```bash
+npm install bowlslink-client
+```
+
+## Quick Start
+
+```ts
+import { BowlsLinkClient } from "bowlslink-client";
+
+const client = new BowlsLinkClient({
+  clubId: "2d83742c-5153-4f22-bcb3-68868f34e0d2", // Your club's BowlsLink UUID
+});
+
+// Get all pennant teams, matches, and standings
+const data = await client.getPennantData();
+
+for (const team of data.teams) {
+  console.log(`${team.name} — ${team.competitionName}`);
+  console.log(`  Ladder: ${team.ladder?.position ?? "?"} (W${team.ladder?.wins} L${team.ladder?.losses})`);
+  console.log(`  Matches: ${team.matches.length}`);
+}
+
+// Get team sheets (player/rink data) for a specific match
+const detail = await client.getMatchDetail("c0acaf56-ec90-4112-ac48-9d1d8412e7d8");
+
+for (const team of detail.teams) {
+  console.log(`\n${team.teamName}`);
+  for (const rink of team.rinks) {
+    console.log(`  ${rink.label}: ${rink.players.map((p) => `${p.name} (${p.position})`).join(", ")}`);
+  }
+}
+```
+
+## Finding Your Club ID
+
+Your club's BowlsLink UUID is in the URL when you view your club on the results site:
+
+```
+https://results.bowlslink.com.au/club/2d83742c-5153-4f22-bcb3-68868f34e0d2
+                                       ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+                                       This is your club ID
+```
+
+You can also find it by searching for your club at [results.bowlslink.com.au/search](https://results.bowlslink.com.au/search).
+
+## API
+
+### `new BowlsLinkClient(config)`
+
+| Option | Type | Required | Description |
+|--------|------|----------|-------------|
+| `clubId` | `string` | ✅ | Your club's BowlsLink UUID |
+| `baseUrl` | `string` | | API base URL (default: `https://api.bowlslink.com.au/results-api`) |
+| `fetch` | `typeof fetch` | | Custom fetch implementation for testing or non-browser environments |
+
+### `client.getPennantData(): Promise<PennantData>`
+
+Returns all active pennant entries for the club with competition details, ladder standings, and match history including finals.
+
+```ts
+interface PennantData {
+  lastUpdated: string;  // ISO 8601 timestamp
+  teams: Team[];
+}
+
+interface Team {
+  name: string;                    // e.g. "Keilor 1"
+  competitionId: string;
+  competitionName: string | null;  // e.g. "2025-26 Metro Pennant Weekend Division 2"
+  competitionStatus: string | null;
+  bowlslinkUrl: string;            // Link to competition on BowlsLink
+  ladder: LadderEntry | null;
+  matches: Match[];
+}
+
+interface Match {
+  matchId: string;
+  round: number;
+  roundLabel: string;       // "Round 1", "Semi-Finals", "Grand Final", etc.
+  dateUtc: number;          // Unix timestamp
+  state: string;            // "PLAYED" | "SCHEDULED" | etc.
+  isHome: boolean;
+  isFinals: boolean;        // true for finals-series matches
+  opponent: string;
+  opponentId: string;
+  myCompetitorId: string;
+  teamScore: number | null;
+  opponentScore: number | null;
+  outcome: "W" | "L" | "draw" | "np" | null;
+  teamPoints: number | null;
+}
+```
+
+### `client.getMatchDetail(matchId): Promise<MatchDetail>`
+
+Returns team sheets with rink and player data for a specific match.
+
+```ts
+interface MatchDetail {
+  matchId: string;
+  teams: MatchTeam[];
+}
+
+interface MatchTeam {
+  competitorId: string;
+  teamName: string;
+  rinks: Rink[];
+}
+
+interface Rink {
+  label: string;       // "Rink 1", "Rink 2", etc.
+  players: Player[];   // Sorted: lead, second, third, skip
+}
+
+interface Player {
+  name: string;
+  position: string;    // "lead" | "second" | "third" | "skip"
+}
+```
+
+## Known Quirks
+
+Things we've discovered about the BowlsLink API that this library handles for you:
+
+- **Finals are a separate endpoint.** Regular season matches come from `/competition/{id}/matches`, but finals come from `/competition/{id}/finals-series-matches`. This library fetches both and merges them.
+
+- **Higher-division finals are separate competitions.** Divisions 1–3 have their finals as entirely separate competition entries (e.g. "Division 2 Finals (Divisional)"). The regular season competition moves to `completed` status and drops off the active club entries feed. Lower divisions (4+) keep finals within the same competition using the `isFinalsSeries` flag.
+
+- **Ladder API only returns pool 1.** In multi-section competitions, the `/ladder` endpoint only returns standings for Section 1. For teams in other sections, this library automatically computes standings from match results as a fallback.
+
+- **The API is public but undocumented.** These endpoints are reverse-engineered from the BowlsLink SPA. They could change without notice.
+
+## Server-Side Usage
+
+The BowlsLink API has CORS headers allowing browser access, but for club websites we recommend calling it server-side to avoid exposing your requests to rate limiting and to enable caching:
+
+```ts
+import express from "express";
+import { BowlsLinkClient } from "bowlslink-client";
+
+const app = express();
+const client = new BowlsLinkClient({ clubId: "your-club-id" });
+
+let cache = null;
+const CACHE_TTL = 10 * 60 * 1000; // 10 minutes
+
+app.get("/api/pennant", async (req, res) => {
+  if (cache && Date.now() - cache.timestamp < CACHE_TTL) {
+    return res.json(cache.data);
+  }
+  const data = await client.getPennantData();
+  cache = { data, timestamp: Date.now() };
+  res.json(data);
+});
+```
+
+## License
+
+MIT

package/dist/api.d.ts

@@ -0,0 +1,13 @@
+import type { JsonApiInclude, JsonApiResponse } from "./types.js";
+/**
+ * Fetch a path from the BowlsLink Results API and return the parsed JSON:API response.
+ *
+ * @throws {Error} On non-OK HTTP responses.
+ */
+export declare function apiFetch(path: string, baseUrl?: string, fetchFn?: typeof globalThis.fetch): Promise<JsonApiResponse>;
+/**
+ * Build a lookup map of `{ [id]: attributes }` for a specific type from a
+ * JSON:API `include` array.
+ */
+export declare function buildLookup(include: JsonApiInclude[], type: string): Record<string, Record<string, unknown>>;
+//# sourceMappingURL=api.d.ts.map

package/dist/api.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api.d.ts","sourceRoot":"","sources":["../src/api.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAKlE;;;;GAIG;AACH,wBAAsB,QAAQ,CAC5B,IAAI,EAAE,MAAM,EACZ,OAAO,GAAE,MAAyB,EAClC,OAAO,GAAE,OAAO,UAAU,CAAC,KAAwB,GAClD,OAAO,CAAC,eAAe,CAAC,CAO1B;AAED;;;GAGG;AACH,wBAAgB,WAAW,CACzB,OAAO,EAAE,cAAc,EAAE,EACzB,IAAI,EAAE,MAAM,GACX,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAQzC"}

package/dist/api.js

@@ -0,0 +1,29 @@
+const DEFAULT_BASE_URL = "https://api.bowlslink.com.au/results-api";
+const HEADERS = { Accept: "application/json", "Content-Type": "application/json" };
+/**
+ * Fetch a path from the BowlsLink Results API and return the parsed JSON:API response.
+ *
+ * @throws {Error} On non-OK HTTP responses.
+ */
+export async function apiFetch(path, baseUrl = DEFAULT_BASE_URL, fetchFn = globalThis.fetch) {
+    const url = `${baseUrl}${path}`;
+    const res = await fetchFn(url, { headers: HEADERS });
+    if (!res.ok) {
+        throw new Error(`BowlsLink API error: ${res.status} ${res.statusText} for ${url}`);
+    }
+    return (await res.json());
+}
+/**
+ * Build a lookup map of `{ [id]: attributes }` for a specific type from a
+ * JSON:API `include` array.
+ */
+export function buildLookup(include, type) {
+    const map = {};
+    for (const item of include) {
+        if (item.type === type) {
+            map[item.id] = item.attributes ?? {};
+        }
+    }
+    return map;
+}
+//# sourceMappingURL=api.js.map

package/dist/api.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"api.js","sourceRoot":"","sources":["../src/api.ts"],"names":[],"mappings":"AAEA,MAAM,gBAAgB,GAAG,0CAA0C,CAAC;AACpE,MAAM,OAAO,GAAG,EAAE,MAAM,EAAE,kBAAkB,EAAE,cAAc,EAAE,kBAAkB,EAAE,CAAC;AAEnF;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,QAAQ,CAC5B,IAAY,EACZ,UAAkB,gBAAgB,EAClC,UAAmC,UAAU,CAAC,KAAK;IAEnD,MAAM,GAAG,GAAG,GAAG,OAAO,GAAG,IAAI,EAAE,CAAC;IAChC,MAAM,GAAG,GAAG,MAAM,OAAO,CAAC,GAAG,EAAE,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC,CAAC;IACrD,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;QACZ,MAAM,IAAI,KAAK,CAAC,wBAAwB,GAAG,CAAC,MAAM,IAAI,GAAG,CAAC,UAAU,QAAQ,GAAG,EAAE,CAAC,CAAC;IACrF,CAAC;IACD,OAAO,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,CAAoB,CAAC;AAC/C,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,WAAW,CACzB,OAAyB,EACzB,IAAY;IAEZ,MAAM,GAAG,GAA4C,EAAE,CAAC;IACxD,KAAK,MAAM,IAAI,IAAI,OAAO,EAAE,CAAC;QAC3B,IAAI,IAAI,CAAC,IAAI,KAAK,IAAI,EAAE,CAAC;YACvB,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,UAAU,IAAI,EAAE,CAAC;QACvC,CAAC;IACH,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/cjs/api.js

@@ -0,0 +1,32 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.apiFetch = apiFetch;
+exports.buildLookup = buildLookup;
+const DEFAULT_BASE_URL = "https://api.bowlslink.com.au/results-api";
+const HEADERS = { Accept: "application/json", "Content-Type": "application/json" };
+/**
+ * Fetch a path from the BowlsLink Results API and return the parsed JSON:API response.
+ *
+ * @throws {Error} On non-OK HTTP responses.
+ */
+async function apiFetch(path, baseUrl = DEFAULT_BASE_URL, fetchFn = globalThis.fetch) {
+    const url = `${baseUrl}${path}`;
+    const res = await fetchFn(url, { headers: HEADERS });
+    if (!res.ok) {
+        throw new Error(`BowlsLink API error: ${res.status} ${res.statusText} for ${url}`);
+    }
+    return (await res.json());
+}
+/**
+ * Build a lookup map of `{ [id]: attributes }` for a specific type from a
+ * JSON:API `include` array.
+ */
+function buildLookup(include, type) {
+    const map = {};
+    for (const item of include) {
+        if (item.type === type) {
+            map[item.id] = item.attributes ?? {};
+        }
+    }
+    return map;
+}

package/dist/cjs/client.js

@@ -0,0 +1,329 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BowlsLinkClient = void 0;
+const api_js_1 = require("./api.js");
+const DEFAULT_BASE_URL = "https://api.bowlslink.com.au/results-api";
+const POSITION_ORDER = ["lead", "second", "third", "skip"];
+/**
+ * BowlsLink client for fetching a single club's pennant data.
+ *
+ * @example
+ * ```ts
+ * import { BowlsLinkClient } from "bowlslink-client";
+ *
+ * const client = new BowlsLinkClient({ clubId: "2d83742c-..." });
+ * const data = await client.getPennantData();
+ * console.log(data.teams);
+ * ```
+ */
+class BowlsLinkClient {
+    clubId;
+    baseUrl;
+    fetchFn;
+    constructor(config) {
+        this.clubId = config.clubId;
+        this.baseUrl = config.baseUrl ?? DEFAULT_BASE_URL;
+        this.fetchFn = config.fetch ?? globalThis.fetch;
+    }
+    /**
+     * Fetch all active pennant entries for the club, including competition
+     * details, ladder standings, regular-season matches, and finals.
+     */
+    async getPennantData() {
+        // 1. Fetch all active entries for the club
+        const entriesPayload = await this.fetch(`/club/${this.clubId}/entries?filter%5Bstate%5D=active`);
+        const entries = entriesPayload.include
+            .filter((item) => item.type === "entry")
+            .map((item) => ({
+            id: item.id,
+            name: String(item.attributes.name ?? ""),
+            competitorId: item.includes?.competitor?.id,
+            competitionId: item.includes?.competition?.id,
+        }));
+        // 2. Fetch competition detail, ladder, and matches per unique competition
+        const uniqueCompIds = [...new Set(entries.map((e) => e.competitionId).filter(Boolean))];
+        const competitionData = Object.fromEntries(await Promise.all(uniqueCompIds.map(async (compId) => {
+            const [compPayload, ladderPayload, matchesPayload, finalsPayload] = await Promise.all([
+                this.fetch(`/competition/${compId}`),
+                this.fetch(`/competition/${compId}/ladder`),
+                this.fetch(`/competition/${compId}/matches`),
+                this.fetch(`/competition/${compId}/finals-series-matches`).catch(() => null),
+            ]);
+            // Merge finals-series-matches into regular matches so the rest of
+            // the processing (competitor lookup, match shaping) works unchanged.
+            if (finalsPayload?.include?.length) {
+                matchesPayload.include = [...matchesPayload.include, ...finalsPayload.include];
+            }
+            return [compId, { compPayload, ladderPayload, matchesPayload }];
+        })));
+        // 3. Build each team
+        const teams = entries
+            .filter((e) => e.competitionId && competitionData[e.competitionId])
+            .map((entry) => this.buildTeam(entry, competitionData[entry.competitionId]));
+        // Drop entries with no matches and sort by name
+        const activeTeams = teams
+            .filter((t) => t.matches.length > 0)
+            .sort((a, b) => a.name.localeCompare(b.name, undefined, { numeric: true }));
+        return {
+            lastUpdated: new Date().toISOString(),
+            teams: activeTeams,
+        };
+    }
+    /**
+     * Fetch match detail (team sheets with rink/player data) for a single match.
+     */
+    async getMatchDetail(matchId) {
+        const payload = await this.fetch(`/match/${matchId}`);
+        const includes = payload.include ?? [];
+        // Index competitors
+        const competitors = {};
+        for (const i of includes) {
+            if (i.type === "competitor") {
+                competitors[i.id] = String(i.attributes.name ?? "");
+            }
+        }
+        // Index players
+        const playerIndex = {};
+        for (const i of includes) {
+            if (i.type === "competitorPlayer") {
+                playerIndex[i.id] = {
+                    name: String(i.attributes.fullName ?? ""),
+                    position: String(i.attributes.assignedPosition ?? "player"),
+                    competitorId: i.includes?.competitor?.id,
+                };
+            }
+        }
+        // Build rinks per competitor from rinkMatchResult objects
+        const rinksByComp = {};
+        for (const i of includes) {
+            if (i.type === "rinkMatchResult") {
+                const rinkLabel = String(i.attributes.specialisation ?? "").replace(/^Team\s+/i, "Rink ");
+                const processPlayers = (refs) => (refs ?? [])
+                    .map((ref) => playerIndex[ref.id])
+                    .filter(Boolean)
+                    .sort((a, b) => POSITION_ORDER.indexOf(a.position) - POSITION_ORDER.indexOf(b.position));
+                const c1Players = processPlayers(i.includes?.competitorOnePlayers);
+                const c2Players = processPlayers(i.includes?.competitorTwoPlayers);
+                for (const players of [c1Players, c2Players]) {
+                    if (players.length === 0)
+                        continue;
+                    const compId = players[0].competitorId;
+                    if (!compId)
+                        continue;
+                    if (!rinksByComp[compId])
+                        rinksByComp[compId] = [];
+                    rinksByComp[compId].push({
+                        label: rinkLabel,
+                        players: players.map(({ name, position }) => ({ name, position })),
+                    });
+                }
+            }
+        }
+        // Sort rinks within each team
+        for (const rinks of Object.values(rinksByComp)) {
+            rinks.sort((a, b) => a.label.localeCompare(b.label, undefined, { numeric: true }));
+        }
+        const teams = Object.entries(competitors).map(([compId, name]) => ({
+            competitorId: compId,
+            teamName: name,
+            rinks: rinksByComp[compId] ?? [],
+        }));
+        return { matchId, teams };
+    }
+    // ─── Private helpers ─────────────────────────────────────────────────────
+    fetch(path) {
+        return (0, api_js_1.apiFetch)(path, this.baseUrl, this.fetchFn);
+    }
+    buildTeam(entry, data) {
+        const { compPayload, ladderPayload, matchesPayload } = data;
+        // Competition details
+        const competition = compPayload.include.find((i) => i.type === "competition");
+        const compAttrs = competition?.attributes ?? {};
+        // Ladder row (may only be present for pool 1 in multi-section competitions)
+        const ladderRow = ladderPayload.include.find((i) => i.type === "ladderRow" &&
+            i.attributes?.competitorId === entry.competitorId);
+        let ladder = ladderRow ? this.parseLadderRow(ladderRow.attributes.fields) : null;
+        // Build lookups from matches payload
+        const competitorNames = (0, api_js_1.buildLookup)(matchesPayload.include, "competitor");
+        const resultMap = (0, api_js_1.buildLookup)(matchesPayload.include, "multiFormatResult");
+        // Compute ladder from match data if the API didn't return one
+        if (!ladder && entry.competitorId) {
+            ladder = this.computeLadder(entry.competitorId, matchesPayload.include, resultMap);
+        }
+        // Filter and shape matches for this team
+        const matches = this.buildMatches(entry, matchesPayload.include, competitorNames, resultMap);
+        return {
+            name: entry.name,
+            competitionId: entry.competitionId ?? "",
+            competitionName: compAttrs.name ?? null,
+            competitionStatus: compAttrs.competitionStatus ?? null,
+            bowlslinkUrl: `https://results.bowlslink.com.au/competition/${entry.competitionId}`,
+            ladder,
+            matches,
+        };
+    }
+    /**
+     * When the ladder API doesn't return data for a competitor (common in
+     * multi-section competitions where /ladder only returns pool 1), compute
+     * standings from match results as a fallback.
+     */
+    computeLadder(competitorId, includes, resultMap) {
+        // Determine which pool this competitor plays in
+        const poolMatch = includes.find((i) => i.type === "match" &&
+            (i.includes?.competitorOne?.id === competitorId ||
+                i.includes?.competitorTwo?.id === competitorId));
+        const competitorPool = poolMatch?.attributes?.pool ?? null;
+        if (competitorPool === null)
+            return null;
+        // Gather all played matches in this pool (exclude finals)
+        const poolMatches = includes.filter((i) => i.type === "match" &&
+            i.attributes?.pool === competitorPool &&
+            i.attributes?.matchState === "PLAYED" &&
+            !i.attributes?.isFinalsSeries);
+        // Build per-competitor stats
+        const standings = {};
+        const ensure = (id) => {
+            if (!standings[id]) {
+                standings[id] = { played: 0, wins: 0, losses: 0, draws: 0, score: 0, againstScore: 0, points: 0 };
+            }
+        };
+        for (const m of poolMatches) {
+            const c1id = m.includes?.competitorOne?.id;
+            const c2id = m.includes?.competitorTwo?.id;
+            const resultId = m.includes?.result?.id;
+            const result = resultId ? resultMap[resultId] : undefined;
+            if (!result?.isCompleted)
+                continue;
+            if (c1id)
+                ensure(c1id);
+            if (c2id)
+                ensure(c2id);
+            const s1 = result.competitorOneScore ?? 0;
+            const s2 = result.competitorTwoScore ?? 0;
+            const p1 = result.competitorOnePoints ?? 0;
+            const p2 = result.competitorTwoPoints ?? 0;
+            if (c1id) {
+                standings[c1id].played += 1;
+                standings[c1id].score += s1;
+                standings[c1id].againstScore += s2;
+                standings[c1id].points += p1;
+            }
+            if (c2id) {
+                standings[c2id].played += 1;
+                standings[c2id].score += s2;
+                standings[c2id].againstScore += s1;
+                standings[c2id].points += p2;
+            }
+            const winnerId = result.winnerId;
+            if (winnerId === c1id) {
+                if (c1id)
+                    standings[c1id].wins += 1;
+                if (c2id)
+                    standings[c2id].losses += 1;
+            }
+            else if (winnerId === c2id) {
+                if (c2id)
+                    standings[c2id].wins += 1;
+                if (c1id)
+                    standings[c1id].losses += 1;
+            }
+            else {
+                if (c1id)
+                    standings[c1id].draws += 1;
+                if (c2id)
+                    standings[c2id].draws += 1;
+            }
+        }
+        // Sort by points desc, then score difference
+        const sorted = Object.entries(standings).sort(([, a], [, b]) => {
+            const ptsDiff = b.points - a.points;
+            if (ptsDiff !== 0)
+                return ptsDiff;
+            return (b.score - b.againstScore) - (a.score - a.againstScore);
+        });
+        const myIdx = sorted.findIndex(([cid]) => cid === competitorId);
+        if (myIdx === -1)
+            return null;
+        const my = sorted[myIdx][1];
+        return {
+            position: myIdx + 1,
+            played: my.played,
+            wins: my.wins,
+            losses: my.losses,
+            draws: my.draws,
+            byes: 0,
+            score: my.score,
+            againstScore: my.againstScore,
+            scoreDifference: my.score - my.againstScore,
+            points: my.points,
+        };
+    }
+    buildMatches(entry, includes, competitorNames, resultMap) {
+        if (!entry.competitorId)
+            return [];
+        return includes
+            .filter((i) => i.type === "match")
+            .filter((m) => {
+            const c1 = m.includes?.competitorOne?.id;
+            const c2 = m.includes?.competitorTwo?.id;
+            return c1 === entry.competitorId || c2 === entry.competitorId;
+        })
+            .map((m) => {
+            const attrs = m.attributes;
+            const c1 = m.includes?.competitorOne?.id;
+            const isHome = c1 === entry.competitorId;
+            const opponentId = isHome
+                ? m.includes?.competitorTwo?.id ?? ""
+                : c1 ?? "";
+            const resultId = m.includes?.result?.id;
+            const result = resultId ? resultMap[resultId] : undefined;
+            let outcome = null;
+            if (result?.isCompleted) {
+                if (result.winnerId === null) {
+                    outcome = result.status === "non-played" ? "np" : "draw";
+                }
+                else {
+                    outcome = result.winnerId === entry.competitorId ? "W" : "L";
+                }
+            }
+            return {
+                matchId: m.id,
+                round: attrs.round,
+                roundLabel: String(attrs.roundLabel ?? ""),
+                dateUtc: attrs.matchDayUtc,
+                state: String(attrs.matchState ?? ""),
+                isHome,
+                isFinals: Boolean(attrs.isFinalsSeries),
+                opponent: String(competitorNames[opponentId]?.name ?? "TBD"),
+                opponentId,
+                myCompetitorId: entry.competitorId,
+                teamScore: result
+                    ? (isHome ? result.competitorOneScore : result.competitorTwoScore)
+                    : null,
+                opponentScore: result
+                    ? (isHome ? result.competitorTwoScore : result.competitorOneScore)
+                    : null,
+                outcome,
+                teamPoints: result
+                    ? (isHome ? result.competitorOnePoints : result.competitorTwoPoints)
+                    : null,
+            };
+        })
+            .sort((a, b) => a.round - b.round);
+    }
+    parseLadderRow(fields) {
+        return {
+            position: fields.position,
+            played: fields.played,
+            wins: fields.wins,
+            losses: fields.losses,
+            draws: fields.draws,
+            byes: fields.byes,
+            score: fields.score,
+            againstScore: fields.againstScore,
+            scoreDifference: fields.scoreDifference,
+            points: fields.points,
+        };
+    }
+}
+exports.BowlsLinkClient = BowlsLinkClient;

package/dist/cjs/index.js

@@ -0,0 +1,5 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BowlsLinkClient = void 0;
+var client_js_1 = require("./client.js");
+Object.defineProperty(exports, "BowlsLinkClient", { enumerable: true, get: function () { return client_js_1.BowlsLinkClient; } });

package/dist/cjs/package.json

@@ -0,0 +1 @@
+{"type":"commonjs"}

package/dist/cjs/types.js

@@ -0,0 +1,3 @@
+"use strict";
+// ─── Public types ────────────────────────────────────────────────────────────
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/client.d.ts

@@ -0,0 +1,39 @@
+import type { BowlsLinkConfig, MatchDetail, PennantData } from "./types.js";
+/**
+ * BowlsLink client for fetching a single club's pennant data.
+ *
+ * @example
+ * ```ts
+ * import { BowlsLinkClient } from "bowlslink-client";
+ *
+ * const client = new BowlsLinkClient({ clubId: "2d83742c-..." });
+ * const data = await client.getPennantData();
+ * console.log(data.teams);
+ * ```
+ */
+export declare class BowlsLinkClient {
+    private readonly clubId;
+    private readonly baseUrl;
+    private readonly fetchFn;
+    constructor(config: BowlsLinkConfig);
+    /**
+     * Fetch all active pennant entries for the club, including competition
+     * details, ladder standings, regular-season matches, and finals.
+     */
+    getPennantData(): Promise<PennantData>;
+    /**
+     * Fetch match detail (team sheets with rink/player data) for a single match.
+     */
+    getMatchDetail(matchId: string): Promise<MatchDetail>;
+    private fetch;
+    private buildTeam;
+    /**
+     * When the ladder API doesn't return data for a competitor (common in
+     * multi-section competitions where /ladder only returns pool 1), compute
+     * standings from match results as a fallback.
+     */
+    private computeLadder;
+    private buildMatches;
+    private parseLadderRow;
+}
+//# 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,EACV,eAAe,EAIf,WAAW,EAEX,WAAW,EAGZ,MAAM,YAAY,CAAC;AAKpB;;;;;;;;;;;GAWG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA0B;gBAEtC,MAAM,EAAE,eAAe;IAMnC;;;OAGG;IACG,cAAc,IAAI,OAAO,CAAC,WAAW,CAAC;IA2D5C;;OAEG;IACG,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;IAuE3D,OAAO,CAAC,KAAK;IAIb,OAAO,CAAC,SAAS;IA6CjB;;;;OAIG;IACH,OAAO,CAAC,aAAa;IAsGrB,OAAO,CAAC,YAAY;IA4DpB,OAAO,CAAC,cAAc;CAcvB"}

package/dist/client.js

@@ -0,0 +1,326 @@
+import { apiFetch, buildLookup } from "./api.js";
+const DEFAULT_BASE_URL = "https://api.bowlslink.com.au/results-api";
+const POSITION_ORDER = ["lead", "second", "third", "skip"];
+/**
+ * BowlsLink client for fetching a single club's pennant data.
+ *
+ * @example
+ * ```ts
+ * import { BowlsLinkClient } from "bowlslink-client";
+ *
+ * const client = new BowlsLinkClient({ clubId: "2d83742c-..." });
+ * const data = await client.getPennantData();
+ * console.log(data.teams);
+ * ```
+ */
+export class BowlsLinkClient {
+    clubId;
+    baseUrl;
+    fetchFn;
+    constructor(config) {
+        this.clubId = config.clubId;
+        this.baseUrl = config.baseUrl ?? DEFAULT_BASE_URL;
+        this.fetchFn = config.fetch ?? globalThis.fetch;
+    }
+    /**
+     * Fetch all active pennant entries for the club, including competition
+     * details, ladder standings, regular-season matches, and finals.
+     */
+    async getPennantData() {
+        // 1. Fetch all active entries for the club
+        const entriesPayload = await this.fetch(`/club/${this.clubId}/entries?filter%5Bstate%5D=active`);
+        const entries = entriesPayload.include
+            .filter((item) => item.type === "entry")
+            .map((item) => ({
+            id: item.id,
+            name: String(item.attributes.name ?? ""),
+            competitorId: item.includes?.competitor?.id,
+            competitionId: item.includes?.competition?.id,
+        }));
+        // 2. Fetch competition detail, ladder, and matches per unique competition
+        const uniqueCompIds = [...new Set(entries.map((e) => e.competitionId).filter(Boolean))];
+        const competitionData = Object.fromEntries(await Promise.all(uniqueCompIds.map(async (compId) => {
+            const [compPayload, ladderPayload, matchesPayload, finalsPayload] = await Promise.all([
+                this.fetch(`/competition/${compId}`),
+                this.fetch(`/competition/${compId}/ladder`),
+                this.fetch(`/competition/${compId}/matches`),
+                this.fetch(`/competition/${compId}/finals-series-matches`).catch(() => null),
+            ]);
+            // Merge finals-series-matches into regular matches so the rest of
+            // the processing (competitor lookup, match shaping) works unchanged.
+            if (finalsPayload?.include?.length) {
+                matchesPayload.include = [...matchesPayload.include, ...finalsPayload.include];
+            }
+            return [compId, { compPayload, ladderPayload, matchesPayload }];
+        })));
+        // 3. Build each team
+        const teams = entries
+            .filter((e) => e.competitionId && competitionData[e.competitionId])
+            .map((entry) => this.buildTeam(entry, competitionData[entry.competitionId]));
+        // Drop entries with no matches and sort by name
+        const activeTeams = teams
+            .filter((t) => t.matches.length > 0)
+            .sort((a, b) => a.name.localeCompare(b.name, undefined, { numeric: true }));
+        return {
+            lastUpdated: new Date().toISOString(),
+            teams: activeTeams,
+        };
+    }
+    /**
+     * Fetch match detail (team sheets with rink/player data) for a single match.
+     */
+    async getMatchDetail(matchId) {
+        const payload = await this.fetch(`/match/${matchId}`);
+        const includes = payload.include ?? [];
+        // Index competitors
+        const competitors = {};
+        for (const i of includes) {
+            if (i.type === "competitor") {
+                competitors[i.id] = String(i.attributes.name ?? "");
+            }
+        }
+        // Index players
+        const playerIndex = {};
+        for (const i of includes) {
+            if (i.type === "competitorPlayer") {
+                playerIndex[i.id] = {
+                    name: String(i.attributes.fullName ?? ""),
+                    position: String(i.attributes.assignedPosition ?? "player"),
+                    competitorId: i.includes?.competitor?.id,
+                };
+            }
+        }
+        // Build rinks per competitor from rinkMatchResult objects
+        const rinksByComp = {};
+        for (const i of includes) {
+            if (i.type === "rinkMatchResult") {
+                const rinkLabel = String(i.attributes.specialisation ?? "").replace(/^Team\s+/i, "Rink ");
+                const processPlayers = (refs) => (refs ?? [])
+                    .map((ref) => playerIndex[ref.id])
+                    .filter(Boolean)
+                    .sort((a, b) => POSITION_ORDER.indexOf(a.position) - POSITION_ORDER.indexOf(b.position));
+                const c1Players = processPlayers(i.includes?.competitorOnePlayers);
+                const c2Players = processPlayers(i.includes?.competitorTwoPlayers);
+                for (const players of [c1Players, c2Players]) {
+                    if (players.length === 0)
+                        continue;
+                    const compId = players[0].competitorId;
+                    if (!compId)
+                        continue;
+                    if (!rinksByComp[compId])
+                        rinksByComp[compId] = [];
+                    rinksByComp[compId].push({
+                        label: rinkLabel,
+                        players: players.map(({ name, position }) => ({ name, position })),
+                    });
+                }
+            }
+        }
+        // Sort rinks within each team
+        for (const rinks of Object.values(rinksByComp)) {
+            rinks.sort((a, b) => a.label.localeCompare(b.label, undefined, { numeric: true }));
+        }
+        const teams = Object.entries(competitors).map(([compId, name]) => ({
+            competitorId: compId,
+            teamName: name,
+            rinks: rinksByComp[compId] ?? [],
+        }));
+        return { matchId, teams };
+    }
+    // ─── Private helpers ─────────────────────────────────────────────────────
+    fetch(path) {
+        return apiFetch(path, this.baseUrl, this.fetchFn);
+    }
+    buildTeam(entry, data) {
+        const { compPayload, ladderPayload, matchesPayload } = data;
+        // Competition details
+        const competition = compPayload.include.find((i) => i.type === "competition");
+        const compAttrs = competition?.attributes ?? {};
+        // Ladder row (may only be present for pool 1 in multi-section competitions)
+        const ladderRow = ladderPayload.include.find((i) => i.type === "ladderRow" &&
+            i.attributes?.competitorId === entry.competitorId);
+        let ladder = ladderRow ? this.parseLadderRow(ladderRow.attributes.fields) : null;
+        // Build lookups from matches payload
+        const competitorNames = buildLookup(matchesPayload.include, "competitor");
+        const resultMap = buildLookup(matchesPayload.include, "multiFormatResult");
+        // Compute ladder from match data if the API didn't return one
+        if (!ladder && entry.competitorId) {
+            ladder = this.computeLadder(entry.competitorId, matchesPayload.include, resultMap);
+        }
+        // Filter and shape matches for this team
+        const matches = this.buildMatches(entry, matchesPayload.include, competitorNames, resultMap);
+        return {
+            name: entry.name,
+            competitionId: entry.competitionId ?? "",
+            competitionName: compAttrs.name ?? null,
+            competitionStatus: compAttrs.competitionStatus ?? null,
+            bowlslinkUrl: `https://results.bowlslink.com.au/competition/${entry.competitionId}`,
+            ladder,
+            matches,
+        };
+    }
+    /**
+     * When the ladder API doesn't return data for a competitor (common in
+     * multi-section competitions where /ladder only returns pool 1), compute
+     * standings from match results as a fallback.
+     */
+    computeLadder(competitorId, includes, resultMap) {
+        // Determine which pool this competitor plays in
+        const poolMatch = includes.find((i) => i.type === "match" &&
+            (i.includes?.competitorOne?.id === competitorId ||
+                i.includes?.competitorTwo?.id === competitorId));
+        const competitorPool = poolMatch?.attributes?.pool ?? null;
+        if (competitorPool === null)
+            return null;
+        // Gather all played matches in this pool (exclude finals)
+        const poolMatches = includes.filter((i) => i.type === "match" &&
+            i.attributes?.pool === competitorPool &&
+            i.attributes?.matchState === "PLAYED" &&
+            !i.attributes?.isFinalsSeries);
+        // Build per-competitor stats
+        const standings = {};
+        const ensure = (id) => {
+            if (!standings[id]) {
+                standings[id] = { played: 0, wins: 0, losses: 0, draws: 0, score: 0, againstScore: 0, points: 0 };
+            }
+        };
+        for (const m of poolMatches) {
+            const c1id = m.includes?.competitorOne?.id;
+            const c2id = m.includes?.competitorTwo?.id;
+            const resultId = m.includes?.result?.id;
+            const result = resultId ? resultMap[resultId] : undefined;
+            if (!result?.isCompleted)
+                continue;
+            if (c1id)
+                ensure(c1id);
+            if (c2id)
+                ensure(c2id);
+            const s1 = result.competitorOneScore ?? 0;
+            const s2 = result.competitorTwoScore ?? 0;
+            const p1 = result.competitorOnePoints ?? 0;
+            const p2 = result.competitorTwoPoints ?? 0;
+            if (c1id) {
+                standings[c1id].played += 1;
+                standings[c1id].score += s1;
+                standings[c1id].againstScore += s2;
+                standings[c1id].points += p1;
+            }
+            if (c2id) {
+                standings[c2id].played += 1;
+                standings[c2id].score += s2;
+                standings[c2id].againstScore += s1;
+                standings[c2id].points += p2;
+            }
+            const winnerId = result.winnerId;
+            if (winnerId === c1id) {
+                if (c1id)
+                    standings[c1id].wins += 1;
+                if (c2id)
+                    standings[c2id].losses += 1;
+            }
+            else if (winnerId === c2id) {
+                if (c2id)
+                    standings[c2id].wins += 1;
+                if (c1id)
+                    standings[c1id].losses += 1;
+            }
+            else {
+                if (c1id)
+                    standings[c1id].draws += 1;
+                if (c2id)
+                    standings[c2id].draws += 1;
+            }
+        }
+        // Sort by points desc, then score difference
+        const sorted = Object.entries(standings).sort(([, a], [, b]) => {
+            const ptsDiff = b.points - a.points;
+            if (ptsDiff !== 0)
+                return ptsDiff;
+            return (b.score - b.againstScore) - (a.score - a.againstScore);
+        });
+        const myIdx = sorted.findIndex(([cid]) => cid === competitorId);
+        if (myIdx === -1)
+            return null;
+        const my = sorted[myIdx][1];
+        return {
+            position: myIdx + 1,
+            played: my.played,
+            wins: my.wins,
+            losses: my.losses,
+            draws: my.draws,
+            byes: 0,
+            score: my.score,
+            againstScore: my.againstScore,
+            scoreDifference: my.score - my.againstScore,
+            points: my.points,
+        };
+    }
+    buildMatches(entry, includes, competitorNames, resultMap) {
+        if (!entry.competitorId)
+            return [];
+        return includes
+            .filter((i) => i.type === "match")
+            .filter((m) => {
+            const c1 = m.includes?.competitorOne?.id;
+            const c2 = m.includes?.competitorTwo?.id;
+            return c1 === entry.competitorId || c2 === entry.competitorId;
+        })
+            .map((m) => {
+            const attrs = m.attributes;
+            const c1 = m.includes?.competitorOne?.id;
+            const isHome = c1 === entry.competitorId;
+            const opponentId = isHome
+                ? m.includes?.competitorTwo?.id ?? ""
+                : c1 ?? "";
+            const resultId = m.includes?.result?.id;
+            const result = resultId ? resultMap[resultId] : undefined;
+            let outcome = null;
+            if (result?.isCompleted) {
+                if (result.winnerId === null) {
+                    outcome = result.status === "non-played" ? "np" : "draw";
+                }
+                else {
+                    outcome = result.winnerId === entry.competitorId ? "W" : "L";
+                }
+            }
+            return {
+                matchId: m.id,
+                round: attrs.round,
+                roundLabel: String(attrs.roundLabel ?? ""),
+                dateUtc: attrs.matchDayUtc,
+                state: String(attrs.matchState ?? ""),
+                isHome,
+                isFinals: Boolean(attrs.isFinalsSeries),
+                opponent: String(competitorNames[opponentId]?.name ?? "TBD"),
+                opponentId,
+                myCompetitorId: entry.competitorId,
+                teamScore: result
+                    ? (isHome ? result.competitorOneScore : result.competitorTwoScore)
+                    : null,
+                opponentScore: result
+                    ? (isHome ? result.competitorTwoScore : result.competitorOneScore)
+                    : null,
+                outcome,
+                teamPoints: result
+                    ? (isHome ? result.competitorOnePoints : result.competitorTwoPoints)
+                    : null,
+            };
+        })
+            .sort((a, b) => a.round - b.round);
+    }
+    parseLadderRow(fields) {
+        return {
+            position: fields.position,
+            played: fields.played,
+            wins: fields.wins,
+            losses: fields.losses,
+            draws: fields.draws,
+            byes: fields.byes,
+            score: fields.score,
+            againstScore: fields.againstScore,
+            scoreDifference: fields.scoreDifference,
+            points: fields.points,
+        };
+    }
+}
+//# 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/index.d.ts

@@ -0,0 +1,3 @@
+export { BowlsLinkClient } from "./client.js";
+export type { BowlsLinkConfig, LadderEntry, Match, MatchDetail, MatchTeam, PennantData, Player, Rink, Team, } from "./types.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC9C,YAAY,EACV,eAAe,EACf,WAAW,EACX,KAAK,EACL,WAAW,EACX,SAAS,EACT,WAAW,EACX,MAAM,EACN,IAAI,EACJ,IAAI,GACL,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,2 @@
+export { BowlsLinkClient } from "./client.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,101 @@
+/** Configuration for a BowlsLink client instance. */
+export interface BowlsLinkConfig {
+    /** The BowlsLink club UUID (found on the club's BowlsLink results page). */
+    clubId: string;
+    /**
+     * Optional base URL for the results API.
+     * @default "https://api.bowlslink.com.au/results-api"
+     */
+    baseUrl?: string;
+    /**
+     * Optional custom fetch implementation (for testing or environments without
+     * a global fetch). Defaults to the global `fetch`.
+     */
+    fetch?: typeof globalThis.fetch;
+}
+/** A club's pennant team within a competition. */
+export interface Team {
+    name: string;
+    competitionId: string;
+    competitionName: string | null;
+    competitionStatus: string | null;
+    bowlslinkUrl: string;
+    ladder: LadderEntry | null;
+    matches: Match[];
+}
+/** Ladder (standings) row for a team. */
+export interface LadderEntry {
+    position: number;
+    played: number;
+    wins: number;
+    losses: number;
+    draws: number;
+    byes: number;
+    score: number;
+    againstScore: number;
+    scoreDifference: number;
+    points: number;
+}
+/** A single match for a team. */
+export interface Match {
+    matchId: string;
+    round: number;
+    roundLabel: string;
+    dateUtc: number;
+    state: string;
+    isHome: boolean;
+    isFinals: boolean;
+    opponent: string;
+    opponentId: string;
+    myCompetitorId: string;
+    teamScore: number | null;
+    opponentScore: number | null;
+    outcome: "W" | "L" | "draw" | "np" | null;
+    teamPoints: number | null;
+}
+/** Full pennant data response for a club. */
+export interface PennantData {
+    lastUpdated: string;
+    teams: Team[];
+}
+/** A player within a rink. */
+export interface Player {
+    name: string;
+    position: string;
+}
+/** A rink (sub-team) within a match. */
+export interface Rink {
+    label: string;
+    players: Player[];
+}
+/** A team's rink/player data for a specific match. */
+export interface MatchTeam {
+    competitorId: string;
+    teamName: string;
+    rinks: Rink[];
+}
+/** Match detail response with team sheets. */
+export interface MatchDetail {
+    matchId: string;
+    teams: MatchTeam[];
+}
+/** A single item in a JSON:API `include` array. */
+export interface JsonApiInclude {
+    type: string;
+    id: string;
+    attributes: Record<string, unknown>;
+    includes?: Record<string, {
+        type: string;
+        id: string;
+    } | {
+        type: string;
+        id: string;
+    }[]>;
+}
+/** Shape of a JSON:API response from BowlsLink. */
+export interface JsonApiResponse {
+    data: unknown;
+    include: JsonApiInclude[];
+    metadata?: unknown;
+}
+//# 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":"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"}

package/dist/types.js

@@ -0,0 +1,3 @@
+// ─── Public types ────────────────────────────────────────────────────────────
+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":"AAAA,gFAAgF"}

package/package.json

@@ -0,0 +1,48 @@
+{
+  "name": "bowlslink-client",
+  "version": "0.1.0",
+  "description": "Client library for the BowlsLink Results API — fetch club entries, matches, ladders, and team sheets.",
+  "type": "module",
+  "main": "dist/cjs/index.js",
+  "module": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.js"
+      },
+      "require": {
+        "types": "./dist/cjs/index.d.ts",
+        "default": "./dist/cjs/index.js"
+      }
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc && tsc -p tsconfig.cjs.json && echo '{\"type\":\"commonjs\"}' > dist/cjs/package.json",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "prepare": "npm run build",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "bowlslink",
+    "bowls",
+    "lawn-bowls",
+    "australia",
+    "pennant",
+    "results"
+  ],
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/sje397/bowlslink-api"
+  },
+  "devDependencies": {
+    "typescript": "^5.7.0",
+    "vitest": "^3.0.0"
+  }
+}