fitzroy 1.6.2 → 1.7.1

package/dist/cli.js

@@ -135,7 +135,7 @@ function parseFootyWireDate(dateStr, defaultYear) {
     const minutes = Number.parseInt(minStr, 10);
     if (ampm.toLowerCase() === "pm" && aestHours < 12) aestHours += 12;
     if (ampm.toLowerCase() === "am" && aestHours === 12) aestHours = 0;
-    const date = new Date(Date.UTC(defaultYear, monthIndex, day, aestHours - 10, minutes));
+    const date = melbourneLocalToUtc(defaultYear, monthIndex, day, aestHours, minutes);
     if (Number.isNaN(date.getTime())) return null;
     return date;
   }
@@ -168,6 +168,20 @@ function resolveDefaultSeason(competition = "AFLM") {
   const year = (/* @__PURE__ */ new Date()).getFullYear();
   return competition === "AFLW" ? year - 1 : year;
 }
+function melbourneLocalToUtc(year, monthIndex, day, hours, minutes) {
+  const aestGuess = new Date(Date.UTC(year, monthIndex, day, hours - 10, minutes));
+  const parts = new Intl.DateTimeFormat("en-AU", {
+    timeZone: "Australia/Melbourne",
+    day: "2-digit",
+    hour: "2-digit",
+    hour12: false
+  }).formatToParts(aestGuess);
+  const getNum = (type) => Number(parts.find((p) => p.type === type)?.value);
+  if (getNum("day") === day && getNum("hour") === hours % 24) {
+    return aestGuess;
+  }
+  return new Date(Date.UTC(year, monthIndex, day, hours - 11, minutes));
+}
 function buildUtcDate(year, monthStr, day) {
   const monthIndex = MONTH_ABBREV_TO_INDEX.get(monthStr.toLowerCase());
   if (monthIndex === void 0) {
@@ -3563,6 +3577,374 @@ var init_player_details = __esm({
   }
 });
 
+// src/sources/fryzigg.ts
+import { isDataFrame, parseRds, RdsError } from "@jackemcpherson/rds-js";
+var FRYZIGG_URLS, USER_AGENT3, FryziggClient;
+var init_fryzigg = __esm({
+  "src/sources/fryzigg.ts"() {
+    "use strict";
+    init_errors();
+    init_result();
+    FRYZIGG_URLS = {
+      AFLM: "http://www.fryziggafl.net/static/fryziggafl.rds",
+      AFLW: "http://www.fryziggafl.net/static/aflw_player_stats.rds"
+    };
+    USER_AGENT3 = "fitzRoy-ts/1.0 (https://github.com/jackemcpherson/fitzRoy-ts)";
+    FryziggClient = class {
+      fetchFn;
+      constructor(options) {
+        this.fetchFn = options?.fetchFn ?? globalThis.fetch.bind(globalThis);
+      }
+      /**
+       * Fetch the full player statistics dataset for a competition.
+       *
+       * Returns column-major DataFrame from rds-js. The caller is responsible
+       * for filtering rows and mapping to domain types.
+       *
+       * @param competition - AFLM or AFLW.
+       * @returns Column-major DataFrame with all rows, or an error.
+       */
+      async fetchPlayerStats(competition) {
+        const url = FRYZIGG_URLS[competition];
+        try {
+          const response = await this.fetchFn(url, {
+            headers: { "User-Agent": USER_AGENT3 }
+          });
+          if (!response.ok) {
+            return err(
+              new ScrapeError(`Fryzigg request failed: ${response.status} (${url})`, "fryzigg")
+            );
+          }
+          const buffer = new Uint8Array(await response.arrayBuffer());
+          const result = await parseRds(buffer);
+          if (!isDataFrame(result)) {
+            return err(new ScrapeError("Fryzigg RDS file did not contain a data frame", "fryzigg"));
+          }
+          return ok(result);
+        } catch (cause) {
+          if (cause instanceof RdsError) {
+            return err(new ScrapeError(`Fryzigg RDS parse error: ${cause.message}`, "fryzigg"));
+          }
+          return err(
+            new ScrapeError(
+              `Fryzigg request failed: ${cause instanceof Error ? cause.message : String(cause)}`,
+              "fryzigg"
+            )
+          );
+        }
+      }
+    };
+  }
+});
+
+// src/transforms/fryzigg-player-stats.ts
+function transformFryziggPlayerStats(frame, options) {
+  const colIndex = /* @__PURE__ */ new Map();
+  for (let i = 0; i < frame.names.length; i++) {
+    const name = frame.names[i];
+    if (name !== void 0) {
+      colIndex.set(name, i);
+    }
+  }
+  for (const group of REQUIRED_COLUMN_GROUPS) {
+    if (!group.some((name) => colIndex.has(name))) {
+      return err(
+        new ScrapeError(
+          `Fryzigg data frame missing required column: "${group.join('" or "')}"`,
+          "fryzigg"
+        )
+      );
+    }
+  }
+  const getCol = (name) => {
+    if (name === void 0) return void 0;
+    const idx = colIndex.get(name);
+    if (idx === void 0) return void 0;
+    return frame.columns[idx];
+  };
+  const isAflw = options.competition === "AFLW";
+  const mapping = isAflw ? AFLW_COLUMNS : AFLM_COLUMNS;
+  const cols = {
+    matchId: getCol("match_id"),
+    date: getCol(mapping.date),
+    homeTeam: getCol(mapping.homeTeam),
+    awayTeam: getCol(mapping.awayTeam),
+    team: getCol(mapping.team),
+    round: getCol(mapping.round),
+    jumperNumber: getCol(mapping.jumperNumber),
+    playerId: getCol("player_id"),
+    firstName: getCol(mapping.firstName),
+    lastName: getCol(mapping.lastName),
+    playerName: getCol(mapping.playerName),
+    kicks: getCol("kicks"),
+    handballs: getCol("handballs"),
+    disposals: getCol("disposals"),
+    marks: getCol("marks"),
+    goals: getCol("goals"),
+    behinds: getCol("behinds"),
+    tackles: getCol("tackles"),
+    hitouts: getCol("hitouts"),
+    freesFor: getCol(mapping.freesFor),
+    freesAgainst: getCol(mapping.freesAgainst),
+    contestedPossessions: getCol("contested_possessions"),
+    uncontestedPossessions: getCol("uncontested_possessions"),
+    contestedMarks: getCol("contested_marks"),
+    intercepts: getCol("intercepts"),
+    centreClearances: getCol("centre_clearances"),
+    stoppageClearances: getCol("stoppage_clearances"),
+    totalClearances: getCol(mapping.totalClearances),
+    inside50s: getCol(mapping.inside50s),
+    rebound50s: getCol(mapping.rebound50s),
+    clangers: getCol("clangers"),
+    turnovers: getCol("turnovers"),
+    onePercenters: getCol("one_percenters"),
+    bounces: getCol("bounces"),
+    goalAssists: getCol("goal_assists"),
+    disposalEfficiency: getCol(mapping.disposalEfficiency),
+    metresGained: getCol("metres_gained"),
+    marksInside50: getCol(mapping.marksInside50),
+    tacklesInside50: getCol(mapping.tacklesInside50),
+    shotsAtGoal: getCol("shots_at_goal"),
+    scoreInvolvements: getCol("score_involvements"),
+    totalPossessions: getCol(mapping.totalPossessions),
+    timeOnGround: getCol(mapping.timeOnGround),
+    ratingPoints: getCol("rating_points"),
+    position: getCol(mapping.position),
+    brownlowVotes: getCol("brownlow_votes"),
+    supercoachScore: getCol("supercoach_score"),
+    dreamTeamPoints: getCol(mapping.dreamTeamPoints),
+    effectiveDisposals: getCol("effective_disposals"),
+    effectiveKicks: getCol("effective_kicks"),
+    pressureActs: getCol("pressure_acts"),
+    defHalfPressureActs: getCol("def_half_pressure_acts"),
+    spoils: getCol("spoils"),
+    hitoutsToAdvantage: getCol("hitouts_to_advantage"),
+    hitoutWinPercentage: getCol("hitout_win_percentage"),
+    groundBallGets: getCol("ground_ball_gets"),
+    f50GroundBallGets: getCol("f50_ground_ball_gets"),
+    interceptMarks: getCol("intercept_marks"),
+    marksOnLead: getCol("marks_on_lead"),
+    contestOffOneOnOnes: getCol("contest_off_one_on_ones"),
+    contestOffWins: getCol("contest_off_wins"),
+    contestDefOneOnOnes: getCol("contest_def_one_on_ones"),
+    contestDefLosses: getCol("contest_def_losses"),
+    ruckContests: getCol("ruck_contests"),
+    scoreLaunches: getCol("score_launches")
+  };
+  const dateCol = cols.date;
+  const roundCol = cols.round;
+  const nRows = dateCol ? dateCol.length : 0;
+  const hasFilters = options.season !== void 0 || options.round !== void 0;
+  let rowIndices = null;
+  let rowCount = nRows;
+  if (hasFilters) {
+    const matching = [];
+    for (let i = 0; i < nRows; i++) {
+      if (options.season !== void 0) {
+        const dateStr = dateCol?.[i];
+        if (typeof dateStr !== "string") continue;
+        const year = Number(dateStr.slice(0, 4));
+        if (year !== options.season) continue;
+      }
+      if (options.round !== void 0 && roundCol) {
+        const roundVal = roundCol[i];
+        const roundNum = typeof roundVal === "string" ? Number(roundVal) : roundVal;
+        if (roundNum !== options.round) continue;
+      }
+      matching.push(i);
+    }
+    rowIndices = matching;
+    rowCount = matching.length;
+  }
+  const stats = new Array(rowCount);
+  for (let j = 0; j < rowCount; j++) {
+    const i = rowIndices ? rowIndices[j] : j;
+    stats[j] = mapRow(i, cols, isAflw, options.competition);
+  }
+  return ok(stats);
+}
+function numAt(column, i) {
+  if (!column) return null;
+  const v = column[i];
+  return typeof v === "number" ? v : null;
+}
+function strAt(column, i) {
+  if (!column) return null;
+  const v = column[i];
+  return typeof v === "string" ? v : null;
+}
+function roundAt(column, i) {
+  if (!column) return 0;
+  const v = column[i];
+  if (typeof v === "number") return v;
+  if (typeof v === "string") {
+    const n = Number(v);
+    return Number.isNaN(n) ? 0 : n;
+  }
+  return 0;
+}
+function mapRow(i, c, isAflw, competition) {
+  const dateStr = strAt(c.date, i);
+  let firstName;
+  let lastName;
+  if (isAflw) {
+    const playerName = strAt(c.playerName, i) ?? "";
+    const commaIdx = playerName.indexOf(", ");
+    firstName = commaIdx >= 0 ? playerName.slice(0, commaIdx) : playerName;
+    lastName = commaIdx >= 0 ? playerName.slice(commaIdx + 2) : "";
+  } else {
+    firstName = strAt(c.firstName, i) ?? "";
+    lastName = strAt(c.lastName, i) ?? "";
+  }
+  const team = strAt(c.team, i) ?? "";
+  const homeTeam = strAt(c.homeTeam, i);
+  const awayTeam = strAt(c.awayTeam, i);
+  return {
+    matchId: String(c.matchId?.[i] ?? ""),
+    season: dateStr ? Number(dateStr.slice(0, 4)) : 0,
+    roundNumber: roundAt(c.round, i),
+    team: normaliseTeamName(team),
+    competition,
+    date: dateStr ? new Date(dateStr) : null,
+    homeTeam: homeTeam ? normaliseTeamName(homeTeam) : null,
+    awayTeam: awayTeam ? normaliseTeamName(awayTeam) : null,
+    playerId: String(c.playerId?.[i] ?? ""),
+    givenName: firstName,
+    surname: lastName,
+    displayName: `${firstName} ${lastName}`.trim(),
+    jumperNumber: numAt(c.jumperNumber, i),
+    kicks: numAt(c.kicks, i),
+    handballs: numAt(c.handballs, i),
+    disposals: numAt(c.disposals, i),
+    marks: numAt(c.marks, i),
+    goals: numAt(c.goals, i),
+    behinds: numAt(c.behinds, i),
+    tackles: numAt(c.tackles, i),
+    hitouts: numAt(c.hitouts, i),
+    freesFor: numAt(c.freesFor, i),
+    freesAgainst: numAt(c.freesAgainst, i),
+    contestedPossessions: numAt(c.contestedPossessions, i),
+    uncontestedPossessions: numAt(c.uncontestedPossessions, i),
+    contestedMarks: numAt(c.contestedMarks, i),
+    intercepts: numAt(c.intercepts, i),
+    centreClearances: numAt(c.centreClearances, i),
+    stoppageClearances: numAt(c.stoppageClearances, i),
+    totalClearances: numAt(c.totalClearances, i),
+    inside50s: numAt(c.inside50s, i),
+    rebound50s: numAt(c.rebound50s, i),
+    clangers: numAt(c.clangers, i),
+    turnovers: numAt(c.turnovers, i),
+    onePercenters: numAt(c.onePercenters, i),
+    bounces: numAt(c.bounces, i),
+    goalAssists: numAt(c.goalAssists, i),
+    disposalEfficiency: numAt(c.disposalEfficiency, i),
+    metresGained: numAt(c.metresGained, i),
+    goalAccuracy: null,
+    marksInside50: numAt(c.marksInside50, i),
+    tacklesInside50: numAt(c.tacklesInside50, i),
+    shotsAtGoal: numAt(c.shotsAtGoal, i),
+    scoreInvolvements: numAt(c.scoreInvolvements, i),
+    totalPossessions: numAt(c.totalPossessions, i),
+    timeOnGroundPercentage: numAt(c.timeOnGround, i),
+    ratingPoints: numAt(c.ratingPoints, i),
+    position: strAt(c.position, i),
+    goalEfficiency: null,
+    shotEfficiency: null,
+    interchangeCounts: null,
+    brownlowVotes: numAt(c.brownlowVotes, i),
+    supercoachScore: numAt(c.supercoachScore, i),
+    dreamTeamPoints: numAt(c.dreamTeamPoints, i),
+    effectiveDisposals: numAt(c.effectiveDisposals, i),
+    effectiveKicks: numAt(c.effectiveKicks, i),
+    kickEfficiency: null,
+    kickToHandballRatio: null,
+    pressureActs: numAt(c.pressureActs, i),
+    defHalfPressureActs: numAt(c.defHalfPressureActs, i),
+    spoils: numAt(c.spoils, i),
+    hitoutsToAdvantage: numAt(c.hitoutsToAdvantage, i),
+    hitoutWinPercentage: numAt(c.hitoutWinPercentage, i),
+    hitoutToAdvantageRate: null,
+    groundBallGets: numAt(c.groundBallGets, i),
+    f50GroundBallGets: numAt(c.f50GroundBallGets, i),
+    interceptMarks: numAt(c.interceptMarks, i),
+    marksOnLead: numAt(c.marksOnLead, i),
+    contestedPossessionRate: null,
+    contestOffOneOnOnes: numAt(c.contestOffOneOnOnes, i),
+    contestOffWins: numAt(c.contestOffWins, i),
+    contestOffWinsPercentage: null,
+    contestDefOneOnOnes: numAt(c.contestDefOneOnOnes, i),
+    contestDefLosses: numAt(c.contestDefLosses, i),
+    contestDefLossPercentage: null,
+    centreBounceAttendances: null,
+    kickins: null,
+    kickinsPlayon: null,
+    ruckContests: numAt(c.ruckContests, i),
+    scoreLaunches: numAt(c.scoreLaunches, i),
+    source: "fryzigg"
+  };
+}
+var REQUIRED_COLUMN_GROUPS, AFLM_COLUMNS, AFLW_COLUMNS;
+var init_fryzigg_player_stats = __esm({
+  "src/transforms/fryzigg-player-stats.ts"() {
+    "use strict";
+    init_errors();
+    init_result();
+    init_team_mapping();
+    REQUIRED_COLUMN_GROUPS = [
+      ["match_id"],
+      ["match_date", "date"],
+      ["player_id"],
+      ["player_team", "team"]
+    ];
+    AFLM_COLUMNS = {
+      date: "match_date",
+      homeTeam: "match_home_team",
+      awayTeam: "match_away_team",
+      team: "player_team",
+      round: "match_round",
+      jumperNumber: "guernsey_number",
+      firstName: "player_first_name",
+      lastName: "player_last_name",
+      playerName: void 0,
+      freesFor: "free_kicks_for",
+      freesAgainst: "free_kicks_against",
+      totalClearances: "clearances",
+      inside50s: "inside_fifties",
+      rebound50s: "rebounds",
+      disposalEfficiency: "disposal_efficiency_percentage",
+      marksInside50: "marks_inside_fifty",
+      tacklesInside50: "tackles_inside_fifty",
+      timeOnGround: "time_on_ground_percentage",
+      position: "player_position",
+      dreamTeamPoints: "afl_fantasy_score",
+      totalPossessions: void 0
+    };
+    AFLW_COLUMNS = {
+      date: "date",
+      homeTeam: "home_team",
+      awayTeam: "away_team",
+      team: "team",
+      round: "fixture_round",
+      jumperNumber: "number",
+      firstName: void 0,
+      lastName: void 0,
+      playerName: "player_name",
+      freesFor: "frees_for",
+      freesAgainst: "frees_against",
+      totalClearances: "total_clearances",
+      inside50s: "inside50s",
+      rebound50s: "rebound50s",
+      disposalEfficiency: "disposal_efficiency",
+      marksInside50: "marks_inside50",
+      tacklesInside50: "tackles_inside50",
+      timeOnGround: "time_on_ground",
+      position: "position",
+      dreamTeamPoints: "fantasy_score",
+      totalPossessions: "total_possessions"
+    };
+  }
+});
+
 // src/transforms/player-stats.ts
 function toNullable(value) {
   return value ?? null;
@@ -3771,6 +4153,16 @@ async function fetchPlayerStats(query) {
       }
       return atResult;
     }
+    case "fryzigg": {
+      const fzClient = new FryziggClient();
+      const fzResult = await fzClient.fetchPlayerStats(competition);
+      if (!fzResult.success) return fzResult;
+      return transformFryziggPlayerStats(fzResult.data, {
+        competition,
+        season: query.season,
+        round: query.round
+      });
+    }
     default:
       return err(new UnsupportedSourceError(`Unsupported source: ${query.source}`, query.source));
   }
@@ -3785,6 +4177,8 @@ var init_player_stats2 = __esm({
     init_afl_api();
     init_afl_tables();
     init_footywire();
+    init_fryzigg();
+    init_fryzigg_player_stats();
     init_player_stats();
   }
 });
@@ -4379,7 +4773,13 @@ var init_validation2 = __esm({
     "use strict";
     init_team_mapping();
     init_date_utils();
-    VALID_SOURCES = ["afl-api", "footywire", "afl-tables", "squiggle"];
+    VALID_SOURCES = [
+      "afl-api",
+      "footywire",
+      "afl-tables",
+      "squiggle",
+      "fryzigg"
+    ];
     VALID_COMPETITIONS = ["AFLM", "AFLW"];
     VALID_FORMATS = ["table", "json", "csv"];
     VALID_SUMMARIES = ["totals", "averages"];
@@ -5400,7 +5800,7 @@ resolveAliases();
 var main = defineCommand11({
   meta: {
     name: "fitzroy",
-    version: "1.6.2",
+    version: "1.7.1",
     description: "TypeScript port of the fitzRoy R package \u2014 fetch AFL data from the command line"
   },
   subCommands: {

package/dist/index.d.ts

@@ -35,7 +35,7 @@ type CompetitionCode = "AFLM" | "AFLW";
 /** Round classification. */
 type RoundType = "HomeAndAway" | "Finals";
 /** Supported data sources mirroring the R package's `source` parameter. */
-type DataSource = "afl-api" | "footywire" | "afl-tables" | "squiggle";
+type DataSource = "afl-api" | "footywire" | "afl-tables" | "squiggle" | "fryzigg";
 /** Match status as reported by the AFL API. */
 type MatchStatus = "Upcoming" | "Live" | "Complete" | "Postponed" | "Cancelled";
 /** Goals-behinds-points breakdown for a single quarter. */
@@ -2152,13 +2152,33 @@ declare class FootyWireClient {
 	*/
 	fetchTeamStats(year: number, summaryType?: "totals" | "averages"): Promise<Result<TeamStatsEntry[], ScrapeError>>;
 }
+import { DataFrame } from "@jackemcpherson/rds-js";
+/** Options for constructing a Fryzigg client. */
+interface FryziggClientOptions {
+	readonly fetchFn?: typeof fetch | undefined;
+}
 /**
-* Attempt to fetch advanced player statistics from Fryzigg.
+* Fryzigg RDS client.
 *
-* @returns Always returns an error Result explaining that Fryzigg is
-* not supported in the TypeScript port.
+* Downloads and parses static RDS files from fryziggafl.net. The full
+* dataset is always fetched — there is no server-side filtering. Callers
+* should filter the returned DataFrame by season/round before constructing
+* row objects to minimise memory usage.
 */
-declare function fetchFryziggStats(): Result<PlayerStats[], ScrapeError>;
+declare class FryziggClient {
+	private readonly fetchFn;
+	constructor(options?: FryziggClientOptions);
+	/**
+	* Fetch the full player statistics dataset for a competition.
+	*
+	* Returns column-major DataFrame from rds-js. The caller is responsible
+	* for filtering rows and mapping to domain types.
+	*
+	* @param competition - AFLM or AFLW.
+	* @returns Column-major DataFrame with all rows, or an error.
+	*/
+	fetchPlayerStats(competition: CompetitionCode): Promise<Result<DataFrame, ScrapeError>>;
+}
 /** Options for constructing a Squiggle client. */
 interface SquiggleClientOptions {
 	readonly fetchFn?: typeof fetch | undefined;
@@ -2200,6 +2220,21 @@ declare class SquiggleClient {
 * @returns Sorted ladder entries.
 */
 declare function computeLadder(results: readonly MatchResult[], upToRound?: number): LadderEntry[];
+import { DataFrame as DataFrame2 } from "@jackemcpherson/rds-js";
+/** Parameters for filtering and mapping fryzigg data. */
+interface FryziggTransformOptions {
+	readonly competition: CompetitionCode;
+	readonly season?: number | undefined;
+	readonly round?: number | undefined;
+}
+/**
+* Transform a fryzigg DataFrame into filtered PlayerStats[].
+*
+* @param frame - Column-major data from FryziggClient.
+* @param options - Competition, season, and round filters.
+* @returns Filtered array of PlayerStats, or error if columns are missing.
+*/
+declare function transformFryziggPlayerStats(frame: DataFrame2, options: FryziggTransformOptions): Result<PlayerStats[], ScrapeError>;
 /**
 * Transform raw AFL API ladder entries into typed LadderEntry objects.
 *
@@ -2264,4 +2299,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, 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, TransformContext, 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, transformFryziggPlayerStats, 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, fetchFixture, fetchCoachesVotes, fetchAwards, err, computeLadder, ValidationError, UnsupportedSourceError, TransformContext, 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, FryziggTransformOptions, FryziggClientOptions, FryziggClient, 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

@@ -82,7 +82,7 @@ function parseFootyWireDate(dateStr, defaultYear) {
     const minutes = Number.parseInt(minStr, 10);
     if (ampm.toLowerCase() === "pm" && aestHours < 12) aestHours += 12;
     if (ampm.toLowerCase() === "am" && aestHours === 12) aestHours = 0;
-    const date = new Date(Date.UTC(defaultYear, monthIndex, day, aestHours - 10, minutes));
+    const date = melbourneLocalToUtc(defaultYear, monthIndex, day, aestHours, minutes);
     if (Number.isNaN(date.getTime())) return null;
     return date;
   }
@@ -154,6 +154,20 @@ var MONTH_ABBREV_TO_INDEX = /* @__PURE__ */ new Map([
   ["november", 10],
   ["december", 11]
 ]);
+function melbourneLocalToUtc(year, monthIndex, day, hours, minutes) {
+  const aestGuess = new Date(Date.UTC(year, monthIndex, day, hours - 10, minutes));
+  const parts = new Intl.DateTimeFormat("en-AU", {
+    timeZone: "Australia/Melbourne",
+    day: "2-digit",
+    hour: "2-digit",
+    hour12: false
+  }).formatToParts(aestGuess);
+  const getNum = (type) => Number(parts.find((p) => p.type === type)?.value);
+  if (getNum("day") === day && getNum("hour") === hours % 24) {
+    return aestGuess;
+  }
+  return new Date(Date.UTC(year, monthIndex, day, hours - 11, minutes));
+}
 function buildUtcDate(year, monthStr, day) {
   const monthIndex = MONTH_ABBREV_TO_INDEX.get(monthStr.toLowerCase());
   if (monthIndex === void 0) {
@@ -3475,6 +3489,357 @@ async function fetchPlayerDetails(query) {
   }
 }
 
+// src/sources/fryzigg.ts
+import { isDataFrame, parseRds, RdsError } from "@jackemcpherson/rds-js";
+var FRYZIGG_URLS = {
+  AFLM: "http://www.fryziggafl.net/static/fryziggafl.rds",
+  AFLW: "http://www.fryziggafl.net/static/aflw_player_stats.rds"
+};
+var USER_AGENT3 = "fitzRoy-ts/1.0 (https://github.com/jackemcpherson/fitzRoy-ts)";
+var FryziggClient = class {
+  fetchFn;
+  constructor(options) {
+    this.fetchFn = options?.fetchFn ?? globalThis.fetch.bind(globalThis);
+  }
+  /**
+   * Fetch the full player statistics dataset for a competition.
+   *
+   * Returns column-major DataFrame from rds-js. The caller is responsible
+   * for filtering rows and mapping to domain types.
+   *
+   * @param competition - AFLM or AFLW.
+   * @returns Column-major DataFrame with all rows, or an error.
+   */
+  async fetchPlayerStats(competition) {
+    const url = FRYZIGG_URLS[competition];
+    try {
+      const response = await this.fetchFn(url, {
+        headers: { "User-Agent": USER_AGENT3 }
+      });
+      if (!response.ok) {
+        return err(
+          new ScrapeError(`Fryzigg request failed: ${response.status} (${url})`, "fryzigg")
+        );
+      }
+      const buffer = new Uint8Array(await response.arrayBuffer());
+      const result = await parseRds(buffer);
+      if (!isDataFrame(result)) {
+        return err(new ScrapeError("Fryzigg RDS file did not contain a data frame", "fryzigg"));
+      }
+      return ok(result);
+    } catch (cause) {
+      if (cause instanceof RdsError) {
+        return err(new ScrapeError(`Fryzigg RDS parse error: ${cause.message}`, "fryzigg"));
+      }
+      return err(
+        new ScrapeError(
+          `Fryzigg request failed: ${cause instanceof Error ? cause.message : String(cause)}`,
+          "fryzigg"
+        )
+      );
+    }
+  }
+};
+
+// src/transforms/fryzigg-player-stats.ts
+var REQUIRED_COLUMN_GROUPS = [
+  ["match_id"],
+  ["match_date", "date"],
+  ["player_id"],
+  ["player_team", "team"]
+];
+var AFLM_COLUMNS = {
+  date: "match_date",
+  homeTeam: "match_home_team",
+  awayTeam: "match_away_team",
+  team: "player_team",
+  round: "match_round",
+  jumperNumber: "guernsey_number",
+  firstName: "player_first_name",
+  lastName: "player_last_name",
+  playerName: void 0,
+  freesFor: "free_kicks_for",
+  freesAgainst: "free_kicks_against",
+  totalClearances: "clearances",
+  inside50s: "inside_fifties",
+  rebound50s: "rebounds",
+  disposalEfficiency: "disposal_efficiency_percentage",
+  marksInside50: "marks_inside_fifty",
+  tacklesInside50: "tackles_inside_fifty",
+  timeOnGround: "time_on_ground_percentage",
+  position: "player_position",
+  dreamTeamPoints: "afl_fantasy_score",
+  totalPossessions: void 0
+};
+var AFLW_COLUMNS = {
+  date: "date",
+  homeTeam: "home_team",
+  awayTeam: "away_team",
+  team: "team",
+  round: "fixture_round",
+  jumperNumber: "number",
+  firstName: void 0,
+  lastName: void 0,
+  playerName: "player_name",
+  freesFor: "frees_for",
+  freesAgainst: "frees_against",
+  totalClearances: "total_clearances",
+  inside50s: "inside50s",
+  rebound50s: "rebound50s",
+  disposalEfficiency: "disposal_efficiency",
+  marksInside50: "marks_inside50",
+  tacklesInside50: "tackles_inside50",
+  timeOnGround: "time_on_ground",
+  position: "position",
+  dreamTeamPoints: "fantasy_score",
+  totalPossessions: "total_possessions"
+};
+function transformFryziggPlayerStats(frame, options) {
+  const colIndex = /* @__PURE__ */ new Map();
+  for (let i = 0; i < frame.names.length; i++) {
+    const name = frame.names[i];
+    if (name !== void 0) {
+      colIndex.set(name, i);
+    }
+  }
+  for (const group of REQUIRED_COLUMN_GROUPS) {
+    if (!group.some((name) => colIndex.has(name))) {
+      return err(
+        new ScrapeError(
+          `Fryzigg data frame missing required column: "${group.join('" or "')}"`,
+          "fryzigg"
+        )
+      );
+    }
+  }
+  const getCol = (name) => {
+    if (name === void 0) return void 0;
+    const idx = colIndex.get(name);
+    if (idx === void 0) return void 0;
+    return frame.columns[idx];
+  };
+  const isAflw = options.competition === "AFLW";
+  const mapping = isAflw ? AFLW_COLUMNS : AFLM_COLUMNS;
+  const cols = {
+    matchId: getCol("match_id"),
+    date: getCol(mapping.date),
+    homeTeam: getCol(mapping.homeTeam),
+    awayTeam: getCol(mapping.awayTeam),
+    team: getCol(mapping.team),
+    round: getCol(mapping.round),
+    jumperNumber: getCol(mapping.jumperNumber),
+    playerId: getCol("player_id"),
+    firstName: getCol(mapping.firstName),
+    lastName: getCol(mapping.lastName),
+    playerName: getCol(mapping.playerName),
+    kicks: getCol("kicks"),
+    handballs: getCol("handballs"),
+    disposals: getCol("disposals"),
+    marks: getCol("marks"),
+    goals: getCol("goals"),
+    behinds: getCol("behinds"),
+    tackles: getCol("tackles"),
+    hitouts: getCol("hitouts"),
+    freesFor: getCol(mapping.freesFor),
+    freesAgainst: getCol(mapping.freesAgainst),
+    contestedPossessions: getCol("contested_possessions"),
+    uncontestedPossessions: getCol("uncontested_possessions"),
+    contestedMarks: getCol("contested_marks"),
+    intercepts: getCol("intercepts"),
+    centreClearances: getCol("centre_clearances"),
+    stoppageClearances: getCol("stoppage_clearances"),
+    totalClearances: getCol(mapping.totalClearances),
+    inside50s: getCol(mapping.inside50s),
+    rebound50s: getCol(mapping.rebound50s),
+    clangers: getCol("clangers"),
+    turnovers: getCol("turnovers"),
+    onePercenters: getCol("one_percenters"),
+    bounces: getCol("bounces"),
+    goalAssists: getCol("goal_assists"),
+    disposalEfficiency: getCol(mapping.disposalEfficiency),
+    metresGained: getCol("metres_gained"),
+    marksInside50: getCol(mapping.marksInside50),
+    tacklesInside50: getCol(mapping.tacklesInside50),
+    shotsAtGoal: getCol("shots_at_goal"),
+    scoreInvolvements: getCol("score_involvements"),
+    totalPossessions: getCol(mapping.totalPossessions),
+    timeOnGround: getCol(mapping.timeOnGround),
+    ratingPoints: getCol("rating_points"),
+    position: getCol(mapping.position),
+    brownlowVotes: getCol("brownlow_votes"),
+    supercoachScore: getCol("supercoach_score"),
+    dreamTeamPoints: getCol(mapping.dreamTeamPoints),
+    effectiveDisposals: getCol("effective_disposals"),
+    effectiveKicks: getCol("effective_kicks"),
+    pressureActs: getCol("pressure_acts"),
+    defHalfPressureActs: getCol("def_half_pressure_acts"),
+    spoils: getCol("spoils"),
+    hitoutsToAdvantage: getCol("hitouts_to_advantage"),
+    hitoutWinPercentage: getCol("hitout_win_percentage"),
+    groundBallGets: getCol("ground_ball_gets"),
+    f50GroundBallGets: getCol("f50_ground_ball_gets"),
+    interceptMarks: getCol("intercept_marks"),
+    marksOnLead: getCol("marks_on_lead"),
+    contestOffOneOnOnes: getCol("contest_off_one_on_ones"),
+    contestOffWins: getCol("contest_off_wins"),
+    contestDefOneOnOnes: getCol("contest_def_one_on_ones"),
+    contestDefLosses: getCol("contest_def_losses"),
+    ruckContests: getCol("ruck_contests"),
+    scoreLaunches: getCol("score_launches")
+  };
+  const dateCol = cols.date;
+  const roundCol = cols.round;
+  const nRows = dateCol ? dateCol.length : 0;
+  const hasFilters = options.season !== void 0 || options.round !== void 0;
+  let rowIndices = null;
+  let rowCount = nRows;
+  if (hasFilters) {
+    const matching = [];
+    for (let i = 0; i < nRows; i++) {
+      if (options.season !== void 0) {
+        const dateStr = dateCol?.[i];
+        if (typeof dateStr !== "string") continue;
+        const year = Number(dateStr.slice(0, 4));
+        if (year !== options.season) continue;
+      }
+      if (options.round !== void 0 && roundCol) {
+        const roundVal = roundCol[i];
+        const roundNum = typeof roundVal === "string" ? Number(roundVal) : roundVal;
+        if (roundNum !== options.round) continue;
+      }
+      matching.push(i);
+    }
+    rowIndices = matching;
+    rowCount = matching.length;
+  }
+  const stats = new Array(rowCount);
+  for (let j = 0; j < rowCount; j++) {
+    const i = rowIndices ? rowIndices[j] : j;
+    stats[j] = mapRow(i, cols, isAflw, options.competition);
+  }
+  return ok(stats);
+}
+function numAt(column, i) {
+  if (!column) return null;
+  const v = column[i];
+  return typeof v === "number" ? v : null;
+}
+function strAt(column, i) {
+  if (!column) return null;
+  const v = column[i];
+  return typeof v === "string" ? v : null;
+}
+function roundAt(column, i) {
+  if (!column) return 0;
+  const v = column[i];
+  if (typeof v === "number") return v;
+  if (typeof v === "string") {
+    const n = Number(v);
+    return Number.isNaN(n) ? 0 : n;
+  }
+  return 0;
+}
+function mapRow(i, c, isAflw, competition) {
+  const dateStr = strAt(c.date, i);
+  let firstName;
+  let lastName;
+  if (isAflw) {
+    const playerName = strAt(c.playerName, i) ?? "";
+    const commaIdx = playerName.indexOf(", ");
+    firstName = commaIdx >= 0 ? playerName.slice(0, commaIdx) : playerName;
+    lastName = commaIdx >= 0 ? playerName.slice(commaIdx + 2) : "";
+  } else {
+    firstName = strAt(c.firstName, i) ?? "";
+    lastName = strAt(c.lastName, i) ?? "";
+  }
+  const team = strAt(c.team, i) ?? "";
+  const homeTeam = strAt(c.homeTeam, i);
+  const awayTeam = strAt(c.awayTeam, i);
+  return {
+    matchId: String(c.matchId?.[i] ?? ""),
+    season: dateStr ? Number(dateStr.slice(0, 4)) : 0,
+    roundNumber: roundAt(c.round, i),
+    team: normaliseTeamName(team),
+    competition,
+    date: dateStr ? new Date(dateStr) : null,
+    homeTeam: homeTeam ? normaliseTeamName(homeTeam) : null,
+    awayTeam: awayTeam ? normaliseTeamName(awayTeam) : null,
+    playerId: String(c.playerId?.[i] ?? ""),
+    givenName: firstName,
+    surname: lastName,
+    displayName: `${firstName} ${lastName}`.trim(),
+    jumperNumber: numAt(c.jumperNumber, i),
+    kicks: numAt(c.kicks, i),
+    handballs: numAt(c.handballs, i),
+    disposals: numAt(c.disposals, i),
+    marks: numAt(c.marks, i),
+    goals: numAt(c.goals, i),
+    behinds: numAt(c.behinds, i),
+    tackles: numAt(c.tackles, i),
+    hitouts: numAt(c.hitouts, i),
+    freesFor: numAt(c.freesFor, i),
+    freesAgainst: numAt(c.freesAgainst, i),
+    contestedPossessions: numAt(c.contestedPossessions, i),
+    uncontestedPossessions: numAt(c.uncontestedPossessions, i),
+    contestedMarks: numAt(c.contestedMarks, i),
+    intercepts: numAt(c.intercepts, i),
+    centreClearances: numAt(c.centreClearances, i),
+    stoppageClearances: numAt(c.stoppageClearances, i),
+    totalClearances: numAt(c.totalClearances, i),
+    inside50s: numAt(c.inside50s, i),
+    rebound50s: numAt(c.rebound50s, i),
+    clangers: numAt(c.clangers, i),
+    turnovers: numAt(c.turnovers, i),
+    onePercenters: numAt(c.onePercenters, i),
+    bounces: numAt(c.bounces, i),
+    goalAssists: numAt(c.goalAssists, i),
+    disposalEfficiency: numAt(c.disposalEfficiency, i),
+    metresGained: numAt(c.metresGained, i),
+    goalAccuracy: null,
+    marksInside50: numAt(c.marksInside50, i),
+    tacklesInside50: numAt(c.tacklesInside50, i),
+    shotsAtGoal: numAt(c.shotsAtGoal, i),
+    scoreInvolvements: numAt(c.scoreInvolvements, i),
+    totalPossessions: numAt(c.totalPossessions, i),
+    timeOnGroundPercentage: numAt(c.timeOnGround, i),
+    ratingPoints: numAt(c.ratingPoints, i),
+    position: strAt(c.position, i),
+    goalEfficiency: null,
+    shotEfficiency: null,
+    interchangeCounts: null,
+    brownlowVotes: numAt(c.brownlowVotes, i),
+    supercoachScore: numAt(c.supercoachScore, i),
+    dreamTeamPoints: numAt(c.dreamTeamPoints, i),
+    effectiveDisposals: numAt(c.effectiveDisposals, i),
+    effectiveKicks: numAt(c.effectiveKicks, i),
+    kickEfficiency: null,
+    kickToHandballRatio: null,
+    pressureActs: numAt(c.pressureActs, i),
+    defHalfPressureActs: numAt(c.defHalfPressureActs, i),
+    spoils: numAt(c.spoils, i),
+    hitoutsToAdvantage: numAt(c.hitoutsToAdvantage, i),
+    hitoutWinPercentage: numAt(c.hitoutWinPercentage, i),
+    hitoutToAdvantageRate: null,
+    groundBallGets: numAt(c.groundBallGets, i),
+    f50GroundBallGets: numAt(c.f50GroundBallGets, i),
+    interceptMarks: numAt(c.interceptMarks, i),
+    marksOnLead: numAt(c.marksOnLead, i),
+    contestedPossessionRate: null,
+    contestOffOneOnOnes: numAt(c.contestOffOneOnOnes, i),
+    contestOffWins: numAt(c.contestOffWins, i),
+    contestOffWinsPercentage: null,
+    contestDefOneOnOnes: numAt(c.contestDefOneOnOnes, i),
+    contestDefLosses: numAt(c.contestDefLosses, i),
+    contestDefLossPercentage: null,
+    centreBounceAttendances: null,
+    kickins: null,
+    kickinsPlayon: null,
+    ruckContests: numAt(c.ruckContests, i),
+    scoreLaunches: numAt(c.scoreLaunches, i),
+    source: "fryzigg"
+  };
+}
+
 // src/transforms/player-stats.ts
 function toNullable(value) {
   return value ?? null;
@@ -3677,6 +4042,16 @@ async function fetchPlayerStats(query) {
       }
       return atResult;
     }
+    case "fryzigg": {
+      const fzClient = new FryziggClient();
+      const fzResult = await fzClient.fetchPlayerStats(competition);
+      if (!fzResult.success) return fzResult;
+      return transformFryziggPlayerStats(fzResult.data, {
+        competition,
+        season: query.season,
+        round: query.round
+      });
+    }
     default:
       return err(new UnsupportedSourceError(`Unsupported source: ${query.source}`, query.source));
   }
@@ -3803,16 +4178,6 @@ async function fetchSquad(query) {
     competition
   });
 }
-
-// src/sources/fryzigg.ts
-function fetchFryziggStats() {
-  return err(
-    new ScrapeError(
-      "Fryzigg data is only available in R-specific RDS binary format and cannot be consumed from TypeScript. Use the AFL API source for player statistics instead.",
-      "fryzigg"
-    )
-  );
-}
 export {
   AflApiClient,
   AflApiError,
@@ -3828,6 +4193,7 @@ export {
   CompseasonListSchema,
   CompseasonSchema,
   FootyWireClient,
+  FryziggClient,
   LadderEntryRawSchema,
   LadderResponseSchema,
   MatchItemListSchema,
@@ -3862,7 +4228,6 @@ export {
   fetchAwards,
   fetchCoachesVotes,
   fetchFixture,
-  fetchFryziggStats,
   fetchLadder,
   fetchLineup,
   fetchMatchResults,
@@ -3879,6 +4244,7 @@ export {
   parseAflTablesDate,
   parseFootyWireDate,
   toAestString,
+  transformFryziggPlayerStats,
   transformLadderEntries,
   transformMatchItems,
   transformMatchRoster,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "fitzroy",
-  "version": "1.6.2",
+  "version": "1.7.1",
   "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",
@@ -43,6 +43,7 @@
   },
   "dependencies": {
     "@clack/prompts": "^1.1.0",
+    "@jackemcpherson/rds-js": "0.2.0",
     "cheerio": "^1.0.0",
     "citty": "^0.2.1",
     "fitzroy": "^1.4.1",