fitzroy 1.3.1 → 1.4.0

package/dist/cli.js

@@ -336,6 +336,62 @@ var init_parse_utils = __esm({
   }
 });
 
+// src/lib/venue-mapping.ts
+function normaliseVenueName(raw) {
+  const trimmed = raw.trim();
+  return VENUE_ALIAS_MAP.get(trimmed.toLowerCase()) ?? trimmed;
+}
+var VENUE_ALIASES, VENUE_ALIAS_MAP;
+var init_venue_mapping = __esm({
+  "src/lib/venue-mapping.ts"() {
+    "use strict";
+    VENUE_ALIASES = [
+      ["MCG", "M.C.G.", "Melbourne Cricket Ground"],
+      ["SCG", "S.C.G.", "Sydney Cricket Ground"],
+      ["Marvel Stadium", "Docklands", "Etihad Stadium", "Telstra Dome", "Colonial Stadium"],
+      ["Kardinia Park", "GMHBA Stadium", "Simonds Stadium", "Skilled Stadium"],
+      ["Gabba", "The Gabba", "Brisbane Cricket Ground"],
+      [
+        "Sydney Showground",
+        "ENGIE Stadium",
+        "GIANTS Stadium",
+        "Showground Stadium",
+        "Sydney Showground Stadium"
+      ],
+      ["Accor Stadium", "Stadium Australia", "ANZ Stadium", "Homebush"],
+      ["Carrara", "People First Stadium", "Heritage Bank Stadium", "Metricon Stadium"],
+      ["Perth Stadium", "Optus Stadium"],
+      ["Adelaide Oval"],
+      ["Manuka Oval", "Corroboree Group Oval Manuka"],
+      ["Blundstone Arena", "Bellerive Oval"],
+      ["UTAS Stadium", "York Park", "University of Tasmania Stadium", "Aurora Stadium"],
+      ["TIO Stadium", "Marrara Oval"],
+      ["Traeger Park", "TIO Traeger Park"],
+      ["Mars Stadium", "Eureka Stadium"],
+      ["Cazalys Stadium", "Cazaly's Stadium"],
+      ["Jiangwan Stadium"],
+      ["Riverway Stadium"],
+      ["Norwood Oval"],
+      ["Subiaco Oval", "Subiaco"],
+      ["Football Park", "AAMI Stadium"],
+      ["Princes Park", "Ikon Park"],
+      ["Blacktown International Sportspark"],
+      ["Barossa Park", "Barossa Oval", "Adelaide Hills"],
+      ["Ninja Stadium", "Summit Sports Park"]
+    ];
+    VENUE_ALIAS_MAP = (() => {
+      const map = /* @__PURE__ */ new Map();
+      for (const [canonical, ...aliases] of VENUE_ALIASES) {
+        map.set(canonical.toLowerCase(), canonical);
+        for (const alias of aliases) {
+          map.set(alias.toLowerCase(), canonical);
+        }
+      }
+      return map;
+    })();
+  }
+});
+
 // src/transforms/footywire-player-stats.ts
 import * as cheerio from "cheerio";
 function cleanPlayerName(raw) {
@@ -628,7 +684,7 @@ function transformMatchItems(items, season, competition, source = "afl-api") {
       roundNumber: item.round?.roundNumber ?? 0,
       roundType: inferRoundType(item.round?.name ?? ""),
       date: new Date(item.match.utcStartTime),
-      venue: item.venue?.name ?? "",
+      venue: item.venue?.name ? normaliseVenueName(item.venue.name) : "",
       homeTeam: normaliseTeamName(item.match.homeTeam.name),
       awayTeam: normaliseTeamName(item.match.awayTeam.name),
       homeGoals: homeScore?.matchScore.goals ?? 0,
@@ -664,6 +720,7 @@ var init_match_results = __esm({
   "src/transforms/match-results.ts"() {
     "use strict";
     init_team_mapping();
+    init_venue_mapping();
     FINALS_PATTERN = /final|elimination|qualifying|preliminary|semi|grand/i;
   }
 });
@@ -2235,7 +2292,7 @@ function transformSquiggleGamesToResults(games, season) {
     roundNumber: g.round,
     roundType: inferRoundType(g.roundname),
     date: new Date(g.unixtime * 1e3),
-    venue: g.venue,
+    venue: normaliseVenueName(g.venue),
     homeTeam: normaliseTeamName(g.hteam),
     awayTeam: normaliseTeamName(g.ateam),
     homeGoals: g.hgoals ?? 0,
@@ -2298,6 +2355,7 @@ var init_squiggle2 = __esm({
   "src/transforms/squiggle.ts"() {
     "use strict";
     init_team_mapping();
+    init_venue_mapping();
     init_match_results();
   }
 });
@@ -5171,8 +5229,8 @@ resolveAliases();
 var main = defineCommand11({
   meta: {
     name: "fitzroy",
-    version: "1.3.1",
-    description: "CLI for fetching AFL data \u2014 match results, player stats, fixtures, ladders, and more"
+    version: "1.4.0",
+    description: "TypeScript port of the fitzRoy R package \u2014 fetch AFL data from the command line"
   },
   subCommands: {
     matches: () => Promise.resolve().then(() => (init_matches(), matches_exports)).then((m) => m.matchesCommand),

package/dist/index.d.ts

@@ -1759,6 +1759,31 @@ declare const LadderResponseSchema: z2.ZodObject<{
 type LadderEntryRaw = z2.infer<typeof LadderEntryRawSchema>;
 /** Inferred type for the ladder API response. */
 type LadderResponse = z2.infer<typeof LadderResponseSchema>;
+/**
+* Venue name normalisation across AFL data sources.
+*
+* Maps sponsor names, historical names, and abbreviations to stable canonical
+* venue names. Lookups are case-insensitive.
+*
+* @example
+* ```ts
+* normaliseVenueName("GMHBA Stadium");              // "Kardinia Park"
+* normaliseVenueName("Etihad Stadium");              // "Marvel Stadium"
+* normaliseVenueName("ENGIE Stadium");               // "Sydney Showground"
+* normaliseVenueName("People First Stadium");        // "Carrara"
+* ```
+*/
+/**
+* Normalise a venue name to its canonical form.
+*
+* Performs a case-insensitive lookup against all known venue names,
+* sponsor names, and historical names. Returns the input unchanged
+* if no mapping is found.
+*
+* @param raw - The raw venue name string from any data source.
+* @returns The canonical venue name, or the trimmed input if unknown.
+*/
+declare function normaliseVenueName(raw: string): string;
 import { z as z3 } from "zod/v4";
 /** Options for constructing an {@link AflApiClient}. */
 interface AflApiClientOptions {
@@ -2179,4 +2204,4 @@ declare function transformSquiggleGamesToFixture(games: readonly SquiggleGame[],
 * Transform Squiggle standings into LadderEntry objects.
 */
 declare function transformSquiggleStandings(standings: readonly SquiggleStanding[]): LadderEntry[];
-export { transformSquiggleStandings, transformSquiggleGamesToResults, transformSquiggleGamesToFixture, transformPlayerStats, transformMatchRoster, transformMatchItems, transformLadderEntries, toAestString, parseFootyWireDate, parseAflTablesDate, parseAflApiDate, ok, normaliseTeamName, inferRoundType, fetchTeams2 as fetchTeams, fetchTeamStats2 as fetchTeamStats, fetchSquad2 as fetchSquad, fetchPlayerStats2 as fetchPlayerStats, fetchPlayerDetails, fetchMatchResults, fetchLineup, fetchLadder2 as fetchLadder, fetchFryziggStats, fetchFixture, fetchCoachesVotes, fetchAwards, err, computeLadder, ValidationError, UnsupportedSourceError, TeamStatsSummaryType, TeamStatsQuery, TeamStatsEntry, TeamScoreSchema, TeamScore, TeamQuery, TeamPlayersSchema, TeamPlayers, TeamListSchema, TeamList, TeamItemSchema, TeamItem, Team, SquiggleStandingsResponseSchema, SquiggleStandingsResponse, SquiggleStandingSchema, SquiggleStanding, SquiggleGamesResponseSchema, SquiggleGamesResponse, SquiggleGameSchema, SquiggleGame, SquiggleClientOptions, SquiggleClient, SquadSchema, SquadQuery, SquadPlayerItemSchema, SquadPlayerItem, SquadPlayerInnerSchema, SquadPlayer, SquadListSchema, SquadList, Squad, SeasonRoundQuery, ScrapeError, ScoreSchema, Score, RoundType, RoundSchema, RoundListSchema, RoundList, Round, RosterPlayerSchema, RosterPlayer, RisingStarNomination, Result, QuarterScore, PlayerStatsQuery, PlayerStatsListSchema, PlayerStatsList, PlayerStatsItemSchema, PlayerStatsItem, PlayerStats, PlayerGameStatsSchema, PlayerGameStats, PlayerDetailsQuery, PlayerDetails, PeriodScoreSchema, PeriodScore, Ok, MatchStatus, MatchRosterSchema, MatchRoster, MatchResult, MatchQuery, MatchItemSchema, MatchItemListSchema, MatchItemList, MatchItem, LineupQuery, LineupPlayer, Lineup, LadderResponseSchema, LadderResponse, LadderQuery, LadderEntryRawSchema, LadderEntryRaw, LadderEntry, Ladder, FootyWireClientOptions, FootyWireClient, Fixture, Err, DataSource, CompseasonSchema, CompseasonListSchema, CompseasonList, Compseason, CompetitionSchema, CompetitionListSchema, CompetitionList, CompetitionCode, Competition, CoachesVoteQuery, CoachesVote, CfsVenueSchema, CfsVenue, CfsScoreSchema, CfsScore, CfsMatchTeamSchema, CfsMatchTeam, CfsMatchSchema, CfsMatch, BrownlowVote, AwardType, AwardQuery, Award, AllAustralianSelection, AflTablesClientOptions, AflTablesClient, AflCoachesClientOptions, AflCoachesClient, AflApiTokenSchema, AflApiToken, AflApiError, AflApiClientOptions, AflApiClient };
+export { transformSquiggleStandings, transformSquiggleGamesToResults, transformSquiggleGamesToFixture, transformPlayerStats, transformMatchRoster, transformMatchItems, transformLadderEntries, toAestString, parseFootyWireDate, parseAflTablesDate, parseAflApiDate, ok, normaliseVenueName, normaliseTeamName, inferRoundType, fetchTeams2 as fetchTeams, fetchTeamStats2 as fetchTeamStats, fetchSquad2 as fetchSquad, fetchPlayerStats2 as fetchPlayerStats, fetchPlayerDetails, fetchMatchResults, fetchLineup, fetchLadder2 as fetchLadder, fetchFryziggStats, fetchFixture, fetchCoachesVotes, fetchAwards, err, computeLadder, ValidationError, UnsupportedSourceError, TeamStatsSummaryType, TeamStatsQuery, TeamStatsEntry, TeamScoreSchema, TeamScore, TeamQuery, TeamPlayersSchema, TeamPlayers, TeamListSchema, TeamList, TeamItemSchema, TeamItem, Team, SquiggleStandingsResponseSchema, SquiggleStandingsResponse, SquiggleStandingSchema, SquiggleStanding, SquiggleGamesResponseSchema, SquiggleGamesResponse, SquiggleGameSchema, SquiggleGame, SquiggleClientOptions, SquiggleClient, SquadSchema, SquadQuery, SquadPlayerItemSchema, SquadPlayerItem, SquadPlayerInnerSchema, SquadPlayer, SquadListSchema, SquadList, Squad, SeasonRoundQuery, ScrapeError, ScoreSchema, Score, RoundType, RoundSchema, RoundListSchema, RoundList, Round, RosterPlayerSchema, RosterPlayer, RisingStarNomination, Result, QuarterScore, PlayerStatsQuery, PlayerStatsListSchema, PlayerStatsList, PlayerStatsItemSchema, PlayerStatsItem, PlayerStats, PlayerGameStatsSchema, PlayerGameStats, PlayerDetailsQuery, PlayerDetails, PeriodScoreSchema, PeriodScore, Ok, MatchStatus, MatchRosterSchema, MatchRoster, MatchResult, MatchQuery, MatchItemSchema, MatchItemListSchema, MatchItemList, MatchItem, LineupQuery, LineupPlayer, Lineup, LadderResponseSchema, LadderResponse, LadderQuery, LadderEntryRawSchema, LadderEntryRaw, LadderEntry, Ladder, FootyWireClientOptions, FootyWireClient, Fixture, Err, DataSource, CompseasonSchema, CompseasonListSchema, CompseasonList, Compseason, CompetitionSchema, CompetitionListSchema, CompetitionList, CompetitionCode, Competition, CoachesVoteQuery, CoachesVote, CfsVenueSchema, CfsVenue, CfsScoreSchema, CfsScore, CfsMatchTeamSchema, CfsMatchTeam, CfsMatchSchema, CfsMatch, BrownlowVote, AwardType, AwardQuery, Award, AllAustralianSelection, AflTablesClientOptions, AflTablesClient, AflCoachesClientOptions, AflCoachesClient, AflApiTokenSchema, AflApiToken, AflApiError, AflApiClientOptions, AflApiClient };

package/dist/index.js

@@ -283,6 +283,56 @@ function parseFloatOr0(text) {
   return Number.isNaN(n) ? 0 : n;
 }
 
+// src/lib/venue-mapping.ts
+var VENUE_ALIASES = [
+  ["MCG", "M.C.G.", "Melbourne Cricket Ground"],
+  ["SCG", "S.C.G.", "Sydney Cricket Ground"],
+  ["Marvel Stadium", "Docklands", "Etihad Stadium", "Telstra Dome", "Colonial Stadium"],
+  ["Kardinia Park", "GMHBA Stadium", "Simonds Stadium", "Skilled Stadium"],
+  ["Gabba", "The Gabba", "Brisbane Cricket Ground"],
+  [
+    "Sydney Showground",
+    "ENGIE Stadium",
+    "GIANTS Stadium",
+    "Showground Stadium",
+    "Sydney Showground Stadium"
+  ],
+  ["Accor Stadium", "Stadium Australia", "ANZ Stadium", "Homebush"],
+  ["Carrara", "People First Stadium", "Heritage Bank Stadium", "Metricon Stadium"],
+  ["Perth Stadium", "Optus Stadium"],
+  ["Adelaide Oval"],
+  ["Manuka Oval", "Corroboree Group Oval Manuka"],
+  ["Blundstone Arena", "Bellerive Oval"],
+  ["UTAS Stadium", "York Park", "University of Tasmania Stadium", "Aurora Stadium"],
+  ["TIO Stadium", "Marrara Oval"],
+  ["Traeger Park", "TIO Traeger Park"],
+  ["Mars Stadium", "Eureka Stadium"],
+  ["Cazalys Stadium", "Cazaly's Stadium"],
+  ["Jiangwan Stadium"],
+  ["Riverway Stadium"],
+  ["Norwood Oval"],
+  ["Subiaco Oval", "Subiaco"],
+  ["Football Park", "AAMI Stadium"],
+  ["Princes Park", "Ikon Park"],
+  ["Blacktown International Sportspark"],
+  ["Barossa Park", "Barossa Oval", "Adelaide Hills"],
+  ["Ninja Stadium", "Summit Sports Park"]
+];
+var VENUE_ALIAS_MAP = (() => {
+  const map = /* @__PURE__ */ new Map();
+  for (const [canonical, ...aliases] of VENUE_ALIASES) {
+    map.set(canonical.toLowerCase(), canonical);
+    for (const alias of aliases) {
+      map.set(alias.toLowerCase(), canonical);
+    }
+  }
+  return map;
+})();
+function normaliseVenueName(raw) {
+  const trimmed = raw.trim();
+  return VENUE_ALIAS_MAP.get(trimmed.toLowerCase()) ?? trimmed;
+}
+
 // src/transforms/footywire-player-stats.ts
 var BASIC_COLS = [
   "Player",
@@ -568,7 +618,7 @@ function transformMatchItems(items, season, competition, source = "afl-api") {
       roundNumber: item.round?.roundNumber ?? 0,
       roundType: inferRoundType(item.round?.name ?? ""),
       date: new Date(item.match.utcStartTime),
-      venue: item.venue?.name ?? "",
+      venue: item.venue?.name ? normaliseVenueName(item.venue.name) : "",
       homeTeam: normaliseTeamName(item.match.homeTeam.name),
       awayTeam: normaliseTeamName(item.match.awayTeam.name),
       homeGoals: homeScore?.matchScore.goals ?? 0,
@@ -2264,7 +2314,7 @@ function transformSquiggleGamesToResults(games, season) {
     roundNumber: g.round,
     roundType: inferRoundType(g.roundname),
     date: new Date(g.unixtime * 1e3),
-    venue: g.venue,
+    venue: normaliseVenueName(g.venue),
     homeTeam: normaliseTeamName(g.hteam),
     awayTeam: normaliseTeamName(g.ateam),
     homeGoals: g.hgoals ?? 0,
@@ -3700,6 +3750,7 @@ export {
   fetchTeams,
   inferRoundType,
   normaliseTeamName,
+  normaliseVenueName,
   ok,
   parseAflApiDate,
   parseAflTablesDate,

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "fitzroy",
-  "version": "1.3.1",
-  "description": "TypeScript library and CLI for AFL data — match results, player stats, fixtures, ladders, and more",
+  "version": "1.4.0",
+  "description": "TypeScript port of the fitzRoy R package — programmatic access to AFL data including match results, player stats, fixtures, ladders, and more",
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",