fitzroy 1.0.0

package/dist/index.d.ts

@@ -0,0 +1,1709 @@
+/**
+* Result type for representing success/failure without exceptions.
+*
+* Use `ok(value)` for successes and `err(error)` for expected failures.
+* Prefer this over throwing for operations that can predictably fail
+* (network requests, parsing, validation).
+*/
+/** A successful result containing data of type `T`. */
+interface Ok<T> {
+	readonly success: true;
+	readonly data: T;
+}
+/** A failed result containing an error of type `E`. */
+interface Err<E> {
+	readonly success: false;
+	readonly error: E;
+}
+/** Discriminated union representing either success or failure. */
+type Result<
+	T,
+	E = Error
+> = Ok<T> | Err<E>;
+/** Create a successful result. */
+declare function ok<T>(data: T): Ok<T>;
+/** Create a failed result. */
+declare function err<E>(error: E): Err<E>;
+/**
+* Shared domain types for fitzRoy-ts.
+*
+* Define all domain types here before writing implementation code.
+* Types are the single source of truth for the data model.
+*/
+/** AFL competition codes. */
+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";
+/** Match status as reported by the AFL API. */
+type MatchStatus = "Upcoming" | "Live" | "Complete" | "Postponed" | "Cancelled";
+/** Goals-behinds-points breakdown for a single quarter. */
+interface QuarterScore {
+	readonly goals: number;
+	readonly behinds: number;
+	readonly points: number;
+}
+/**
+* A completed or in-progress match with scores.
+*
+* One row per match. Quarter scores are optional — historical data
+* from AFL Tables may not include them.
+*/
+interface MatchResult {
+	/** Provider-assigned match identifier (e.g. AFL API `matchProviderId`). */
+	readonly matchId: string;
+	readonly season: number;
+	readonly roundNumber: number;
+	readonly roundType: RoundType;
+	readonly date: Date;
+	readonly venue: string;
+	readonly homeTeam: string;
+	readonly awayTeam: string;
+	/** Total goals-behinds-points for each team. */
+	readonly homeGoals: number;
+	readonly homeBehinds: number;
+	readonly homePoints: number;
+	readonly awayGoals: number;
+	readonly awayBehinds: number;
+	readonly awayPoints: number;
+	/** Positive = home win, negative = away win. */
+	readonly margin: number;
+	/** Per-quarter scores (null when unavailable). */
+	readonly q1Home: QuarterScore | null;
+	readonly q2Home: QuarterScore | null;
+	readonly q3Home: QuarterScore | null;
+	readonly q4Home: QuarterScore | null;
+	readonly q1Away: QuarterScore | null;
+	readonly q2Away: QuarterScore | null;
+	readonly q3Away: QuarterScore | null;
+	readonly q4Away: QuarterScore | null;
+	readonly status: MatchStatus;
+	readonly attendance: number | null;
+	/** Venue metadata (null for scraped sources). */
+	readonly venueState: string | null;
+	readonly venueTimezone: string | null;
+	/** Rushed behinds per team (null when unavailable). */
+	readonly homeRushedBehinds: number | null;
+	readonly awayRushedBehinds: number | null;
+	/** Minutes each team spent in front (null when unavailable). */
+	readonly homeMinutesInFront: number | null;
+	readonly awayMinutesInFront: number | null;
+	readonly source: DataSource;
+	readonly competition: CompetitionCode;
+}
+/**
+* Per-player statistics for a single match.
+*
+* Fields are nullable because not all stats are available for every
+* era or source.
+*/
+interface PlayerStats {
+	readonly matchId: string;
+	readonly season: number;
+	readonly roundNumber: number;
+	readonly team: string;
+	readonly competition: CompetitionCode;
+	/** Player identification. */
+	readonly playerId: string;
+	readonly givenName: string;
+	readonly surname: string;
+	readonly displayName: string;
+	readonly jumperNumber: number | null;
+	/** Core stats. */
+	readonly kicks: number | null;
+	readonly handballs: number | null;
+	readonly disposals: number | null;
+	readonly marks: number | null;
+	readonly goals: number | null;
+	readonly behinds: number | null;
+	readonly tackles: number | null;
+	readonly hitouts: number | null;
+	readonly freesFor: number | null;
+	readonly freesAgainst: number | null;
+	/** Contested/uncontested. */
+	readonly contestedPossessions: number | null;
+	readonly uncontestedPossessions: number | null;
+	readonly contestedMarks: number | null;
+	readonly intercepts: number | null;
+	/** Clearances. */
+	readonly centreClearances: number | null;
+	readonly stoppageClearances: number | null;
+	readonly totalClearances: number | null;
+	/** Other stats. */
+	readonly inside50s: number | null;
+	readonly rebound50s: number | null;
+	readonly clangers: number | null;
+	readonly turnovers: number | null;
+	readonly onePercenters: number | null;
+	readonly bounces: number | null;
+	readonly goalAssists: number | null;
+	readonly disposalEfficiency: number | null;
+	readonly metresGained: number | null;
+	/** Additional base stats. */
+	readonly goalAccuracy: number | null;
+	readonly marksInside50: number | null;
+	readonly tacklesInside50: number | null;
+	readonly shotsAtGoal: number | null;
+	readonly scoreInvolvements: number | null;
+	readonly totalPossessions: number | null;
+	readonly timeOnGroundPercentage: number | null;
+	readonly ratingPoints: number | null;
+	/** Fantasy. */
+	readonly dreamTeamPoints: number | null;
+	/** Extended stats. */
+	readonly effectiveDisposals: number | null;
+	readonly effectiveKicks: number | null;
+	readonly kickEfficiency: number | null;
+	readonly kickToHandballRatio: number | null;
+	readonly pressureActs: number | null;
+	readonly defHalfPressureActs: number | null;
+	readonly spoils: number | null;
+	readonly hitoutsToAdvantage: number | null;
+	readonly hitoutWinPercentage: number | null;
+	readonly hitoutToAdvantageRate: number | null;
+	readonly groundBallGets: number | null;
+	readonly f50GroundBallGets: number | null;
+	readonly interceptMarks: number | null;
+	readonly marksOnLead: number | null;
+	readonly contestedPossessionRate: number | null;
+	readonly contestOffOneOnOnes: number | null;
+	readonly contestOffWins: number | null;
+	readonly contestOffWinsPercentage: number | null;
+	readonly contestDefOneOnOnes: number | null;
+	readonly contestDefLosses: number | null;
+	readonly contestDefLossPercentage: number | null;
+	readonly centreBounceAttendances: number | null;
+	readonly kickins: number | null;
+	readonly kickinsPlayon: number | null;
+	readonly ruckContests: number | null;
+	readonly scoreLaunches: number | null;
+	readonly source: DataSource;
+}
+/** A scheduled match (may not yet have scores). */
+interface Fixture {
+	readonly matchId: string;
+	readonly season: number;
+	readonly roundNumber: number;
+	readonly roundType: RoundType;
+	readonly date: Date;
+	readonly venue: string;
+	readonly homeTeam: string;
+	readonly awayTeam: string;
+	readonly status: MatchStatus;
+	readonly competition: CompetitionCode;
+}
+/** A single player's position in a match lineup. */
+interface LineupPlayer {
+	readonly playerId: string;
+	readonly givenName: string;
+	readonly surname: string;
+	readonly displayName: string;
+	readonly jumperNumber: number | null;
+	readonly position: string | null;
+	readonly isEmergency: boolean;
+	readonly isSubstitute: boolean;
+}
+/** Full lineup for a match (both teams). */
+interface Lineup {
+	readonly matchId: string;
+	readonly season: number;
+	readonly roundNumber: number;
+	readonly homeTeam: string;
+	readonly awayTeam: string;
+	readonly homePlayers: readonly LineupPlayer[];
+	readonly awayPlayers: readonly LineupPlayer[];
+	readonly competition: CompetitionCode;
+}
+/** A single team's standing in the ladder. */
+interface LadderEntry {
+	readonly position: number;
+	readonly team: string;
+	readonly played: number;
+	readonly wins: number;
+	readonly losses: number;
+	readonly draws: number;
+	readonly pointsFor: number;
+	readonly pointsAgainst: number;
+	readonly percentage: number;
+	readonly premiershipsPoints: number;
+	readonly form: string | null;
+}
+/** Season ladder snapshot (optionally for a specific round). */
+interface Ladder {
+	readonly season: number;
+	readonly roundNumber: number | null;
+	readonly entries: readonly LadderEntry[];
+	readonly competition: CompetitionCode;
+}
+/** An AFL team. */
+interface Team {
+	readonly teamId: string;
+	readonly name: string;
+	readonly abbreviation: string;
+	readonly competition: CompetitionCode;
+}
+/** A player within a team squad for a season. */
+interface SquadPlayer {
+	readonly playerId: string;
+	readonly givenName: string;
+	readonly surname: string;
+	readonly displayName: string;
+	readonly jumperNumber: number | null;
+	readonly position: string | null;
+	readonly dateOfBirth: Date | null;
+	readonly heightCm: number | null;
+	readonly weightKg: number | null;
+	readonly draftYear: number | null;
+	readonly draftPosition: number | null;
+	readonly draftType: string | null;
+	readonly debutYear: number | null;
+	readonly recruitedFrom: string | null;
+}
+/** A team's squad for a given season. */
+interface Squad {
+	readonly teamId: string;
+	readonly teamName: string;
+	readonly season: number;
+	readonly players: readonly SquadPlayer[];
+	readonly competition: CompetitionCode;
+}
+/** Query for data by season and optional round. */
+interface SeasonRoundQuery {
+	readonly source: DataSource;
+	readonly season: number;
+	readonly round?: number | undefined;
+	readonly competition?: CompetitionCode | undefined;
+}
+/** Query for a specific match. */
+interface MatchQuery {
+	readonly source: DataSource;
+	readonly matchId: string;
+}
+/** Query for player stats (by season/round or specific match). */
+interface PlayerStatsQuery {
+	readonly source: DataSource;
+	readonly season: number;
+	readonly round?: number | undefined;
+	readonly matchId?: string | undefined;
+	readonly competition?: CompetitionCode | undefined;
+}
+/** Query for lineup data. */
+interface LineupQuery {
+	readonly source: DataSource;
+	readonly season: number;
+	readonly round: number;
+	readonly matchId?: string | undefined;
+	readonly competition?: CompetitionCode | undefined;
+}
+/** Query for ladder standings. */
+interface LadderQuery {
+	readonly source: DataSource;
+	readonly season: number;
+	readonly round?: number | undefined;
+	readonly competition?: CompetitionCode | undefined;
+}
+/** Query for team lists. */
+interface TeamQuery {
+	readonly competition?: CompetitionCode | undefined;
+	readonly teamType?: string | undefined;
+}
+/** Query for a team's squad. */
+interface SquadQuery {
+	readonly teamId: string;
+	readonly season: number;
+	readonly competition?: CompetitionCode | undefined;
+}
+/**
+* Fetch fixture (schedule) data for a season.
+*
+* @param query - Source, season, optional round, and competition.
+* @returns Array of fixture entries.
+*/
+declare function fetchFixture(query: SeasonRoundQuery): Promise<Result<Fixture[], Error>>;
+/**
+* Fetch ladder standings for a season (optionally for a specific round).
+*
+* @param query - Source, season, optional round, and competition.
+* @returns Ladder standings.
+*
+* @example
+* ```ts
+* const result = await fetchLadder({ source: "afl-api", season: 2024, round: 10 });
+* ```
+*/
+declare function fetchLadder2(query: LadderQuery): Promise<Result<Ladder, Error>>;
+/**
+* Fetch match lineup data for a round or specific match.
+*
+* When `matchId` is provided, returns a single-element array for that match.
+* When omitted, returns lineups for all matches in the round.
+*
+* @param query - Source, season, round, optional matchId, and competition.
+* @returns Array of lineups.
+*/
+declare function fetchLineup(query: LineupQuery): Promise<Result<Lineup[], Error>>;
+/**
+* Fetch match results for a season (and optionally a specific round).
+*
+* @param query - Source, season, optional round, and competition.
+* @returns Array of match results.
+*
+* @example
+* ```ts
+* const result = await fetchMatchResults({ source: "afl-api", season: 2025, competition: "AFLM" });
+* ```
+*/
+declare function fetchMatchResults(query: SeasonRoundQuery): Promise<Result<MatchResult[], Error>>;
+/**
+* Fetch per-player match statistics.
+*
+* @param query - Source, season, optional round/matchId, and competition.
+* @returns Array of player stats.
+*
+* @example
+* ```ts
+* const result = await fetchPlayerStats({
+*   source: "afl-api", season: 2025, round: 1, competition: "AFLM"
+* });
+* ```
+*/
+declare function fetchPlayerStats2(query: PlayerStatsQuery): Promise<Result<PlayerStats[], Error>>;
+/**
+* Fetch team lists.
+*
+* @param query - Optional competition and team type filters.
+* @returns Array of teams.
+*/
+declare function fetchTeams2(query?: TeamQuery): Promise<Result<Team[], Error>>;
+/**
+* Fetch a team's squad roster for a season.
+*
+* @param query - Team ID, season, and optional competition.
+* @returns Squad with player list.
+*/
+declare function fetchSquad2(query: SquadQuery): Promise<Result<Squad, Error>>;
+/**
+* AEST/AEDT-aware date parsing and formatting utilities.
+*
+* All functions use only Web Standard APIs (Date, Intl.DateTimeFormat).
+* No Node.js built-ins or third-party date libraries.
+*
+* @module
+*/
+/**
+* Parse a UTC ISO 8601 string from the AFL API into a Date.
+*
+* The AFL API returns dates like `"2024-03-14T06:20:00.000Z"` or
+* `"2024-03-14T06:20:00Z"`.
+*
+* @param iso - A UTC ISO 8601 date string
+* @returns A Date object, or null if parsing fails
+*
+* @example
+* ```ts
+* parseAflApiDate("2024-03-14T06:20:00.000Z")
+* // => Date(2024-03-14T06:20:00.000Z)
+* ```
+*/
+declare function parseAflApiDate(iso: string): Date | null;
+/**
+* Parse a date string from FootyWire into a Date.
+*
+* FootyWire uses formats like:
+* - `"Sat 16 Mar 2024"` (day-of-week, day, month-abbrev, year)
+* - `"16 Mar 2024"` (day, month-abbrev, year)
+* - `"16-Mar-2024"` (day-month-year with hyphens)
+*
+* @param dateStr - A FootyWire date string
+* @returns A Date object (midnight UTC), or null if parsing fails
+*
+* @example
+* ```ts
+* parseFootyWireDate("Sat 16 Mar 2024")
+* // => Date(2024-03-16T00:00:00.000Z)
+* ```
+*/
+declare function parseFootyWireDate(dateStr: string): Date | null;
+/**
+* Parse a date string from AFL Tables into a Date.
+*
+* AFL Tables uses formats like:
+* - `"16-Mar-2024"` (DD-Mon-YYYY)
+* - `"Sat 16-Mar-2024"` (Dow DD-Mon-YYYY)
+* - `"16 Mar 2024"` (DD Mon YYYY)
+*
+* For very old historical matches, dates may be partial (e.g. just a year),
+* which are not supported and return null.
+*
+* @param dateStr - An AFL Tables date string
+* @returns A Date object (midnight UTC), or null if parsing fails
+*
+* @example
+* ```ts
+* parseAflTablesDate("16-Mar-2024")
+* // => Date(2024-03-16T00:00:00.000Z)
+* ```
+*/
+declare function parseAflTablesDate(dateStr: string): Date | null;
+/**
+* Format a Date as an AEST/AEDT-aware display string.
+*
+* Uses `Intl.DateTimeFormat` with the `"Australia/Melbourne"` timezone,
+* which automatically handles AEST (UTC+10) and AEDT (UTC+11) transitions.
+*
+* @param date - The Date to format
+* @returns A formatted string like `"Thu 14 Mar 2024 5:20 PM AEDT"`
+*
+* @example
+* ```ts
+* toAestString(new Date("2024-03-14T06:20:00.000Z"))
+* // => "Thu 14 Mar 2024 5:20 PM AEDT"
+* ```
+*/
+declare function toAestString(date: Date): string;
+/**
+* Custom error classes for fitzRoy-ts.
+*
+* Each error class represents a distinct failure domain:
+* - {@link AflApiError} — failures when communicating with the AFL API
+* - {@link ScrapeError} — failures when scraping HTML sources (FootyWire, AFL Tables)
+* - {@link ValidationError} — failures when validating data against Zod schemas
+* - {@link UnsupportedSourceError} — when a data source doesn't support the requested operation
+*/
+/** Error from the AFL official API (auth failures, bad responses, timeouts). */
+declare class AflApiError extends Error {
+	readonly statusCode?: number | undefined;
+	readonly name = "AflApiError";
+	constructor(message: string, statusCode?: number | undefined);
+}
+/** Error when scraping HTML data sources. */
+declare class ScrapeError extends Error {
+	readonly source?: string | undefined;
+	readonly name = "ScrapeError";
+	constructor(message: string, source?: string | undefined);
+}
+/** Error when a data source does not support the requested operation. */
+declare class UnsupportedSourceError extends Error {
+	readonly source?: string | undefined;
+	readonly name = "UnsupportedSourceError";
+	constructor(message: string, source?: string | undefined);
+}
+/** Error when data fails Zod schema validation. */
+declare class ValidationError extends Error {
+	readonly issues?: ReadonlyArray<{
+		path: string;
+		message: string;
+	}> | undefined;
+	readonly name = "ValidationError";
+	constructor(message: string, issues?: ReadonlyArray<{
+		path: string;
+		message: string;
+	}> | undefined);
+}
+/**
+* Team name normalisation across AFL data sources.
+*
+* Maps abbreviations, short names, and historical names to the canonical
+* AFL API team names. Lookups are case-insensitive.
+*
+* @example
+* ```ts
+* normaliseTeamName("GWS");           // "GWS Giants"
+* normaliseTeamName("footscray");     // "Western Bulldogs"
+* normaliseTeamName("KANGAROOS");     // "North Melbourne"
+* normaliseTeamName("Sydney");        // "Sydney Swans"
+* ```
+*/
+/**
+* Normalise a team name to its canonical form.
+*
+* Performs a case-insensitive lookup against all known team names,
+* abbreviations, and historical names. Returns the input unchanged
+* if no mapping is found.
+*
+* @param raw - The raw team name string from any data source.
+* @returns The canonical team name, or the trimmed input if unknown.
+*/
+declare function normaliseTeamName(raw: string): string;
+import { z } from "zod/v4";
+/** Schema for the AFL API WMCTok token response. */
+declare const AflApiTokenSchema: z.ZodObject<{
+	token: z.ZodString;
+	disclaimer: z.ZodOptional<z.ZodString>;
+}, z.core.$loose>;
+/** Inferred type for the AFL API token response. */
+type AflApiToken = z.infer<typeof AflApiTokenSchema>;
+/** Schema for a single competition entry. */
+declare const CompetitionSchema: z.ZodObject<{
+	id: z.ZodNumber;
+	name: z.ZodString;
+	code: z.ZodOptional<z.ZodString>;
+}, z.core.$loose>;
+/** Schema for the competition list response. */
+declare const CompetitionListSchema: z.ZodObject<{
+	competitions: z.ZodArray<z.ZodObject<{
+		id: z.ZodNumber;
+		name: z.ZodString;
+		code: z.ZodOptional<z.ZodString>;
+	}, z.core.$loose>>;
+}, z.core.$loose>;
+/** Inferred type for a single competition. */
+type Competition = z.infer<typeof CompetitionSchema>;
+/** Inferred type for the competition list response. */
+type CompetitionList = z.infer<typeof CompetitionListSchema>;
+/** Schema for a single compseason (competition-season) entry. */
+declare const CompseasonSchema: z.ZodObject<{
+	id: z.ZodNumber;
+	name: z.ZodString;
+	shortName: z.ZodOptional<z.ZodString>;
+	currentRoundNumber: z.ZodOptional<z.ZodNumber>;
+}, z.core.$loose>;
+/** Schema for the compseason list response. */
+declare const CompseasonListSchema: z.ZodObject<{
+	compSeasons: z.ZodArray<z.ZodObject<{
+		id: z.ZodNumber;
+		name: z.ZodString;
+		shortName: z.ZodOptional<z.ZodString>;
+		currentRoundNumber: z.ZodOptional<z.ZodNumber>;
+	}, z.core.$loose>>;
+}, z.core.$loose>;
+/** Inferred type for a single compseason. */
+type Compseason = z.infer<typeof CompseasonSchema>;
+/** Inferred type for the compseason list response. */
+type CompseasonList = z.infer<typeof CompseasonListSchema>;
+/** Schema for a single round entry. */
+declare const RoundSchema: z.ZodObject<{
+	id: z.ZodNumber;
+	providerId: z.ZodOptional<z.ZodString>;
+	name: z.ZodString;
+	abbreviation: z.ZodOptional<z.ZodString>;
+	roundNumber: z.ZodNumber;
+	utcStartTime: z.ZodOptional<z.ZodString>;
+	utcEndTime: z.ZodOptional<z.ZodString>;
+}, z.core.$loose>;
+/** Schema for the round list response. */
+declare const RoundListSchema: z.ZodObject<{
+	rounds: z.ZodArray<z.ZodObject<{
+		id: z.ZodNumber;
+		providerId: z.ZodOptional<z.ZodString>;
+		name: z.ZodString;
+		abbreviation: z.ZodOptional<z.ZodString>;
+		roundNumber: z.ZodNumber;
+		utcStartTime: z.ZodOptional<z.ZodString>;
+		utcEndTime: z.ZodOptional<z.ZodString>;
+	}, z.core.$loose>>;
+}, z.core.$loose>;
+/** Inferred type for a single round. */
+type Round = z.infer<typeof RoundSchema>;
+/** Inferred type for the round list response. */
+type RoundList = z.infer<typeof RoundListSchema>;
+/** Schema for a goals/behinds/total score object (used in match and period scores). */
+declare const ScoreSchema: z.ZodObject<{
+	totalScore: z.ZodNumber;
+	goals: z.ZodNumber;
+	behinds: z.ZodNumber;
+	superGoals: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+}, z.core.$loose>;
+/** Schema for a period (quarter) score entry within a match. */
+declare const PeriodScoreSchema: z.ZodObject<{
+	periodNumber: z.ZodNumber;
+	score: z.ZodObject<{
+		totalScore: z.ZodNumber;
+		goals: z.ZodNumber;
+		behinds: z.ZodNumber;
+		superGoals: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+	}, z.core.$loose>;
+}, z.core.$loose>;
+/** Schema for a team's total score (match + period breakdown). */
+declare const TeamScoreSchema: z.ZodObject<{
+	matchScore: z.ZodObject<{
+		totalScore: z.ZodNumber;
+		goals: z.ZodNumber;
+		behinds: z.ZodNumber;
+		superGoals: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+	}, z.core.$loose>;
+	periodScore: z.ZodOptional<z.ZodArray<z.ZodObject<{
+		periodNumber: z.ZodNumber;
+		score: z.ZodObject<{
+			totalScore: z.ZodNumber;
+			goals: z.ZodNumber;
+			behinds: z.ZodNumber;
+			superGoals: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+		}, z.core.$loose>;
+	}, z.core.$loose>>>;
+	rushedBehinds: z.ZodOptional<z.ZodNumber>;
+	minutesInFront: z.ZodOptional<z.ZodNumber>;
+}, z.core.$loose>;
+/** Inferred type for a score object. */
+type Score = z.infer<typeof ScoreSchema>;
+/** Inferred type for a period score. */
+type PeriodScore = z.infer<typeof PeriodScoreSchema>;
+/** Inferred type for a team score. */
+type TeamScore = z.infer<typeof TeamScoreSchema>;
+/** Schema for a team entry within a /cfs/ match object. */
+declare const CfsMatchTeamSchema: z.ZodObject<{
+	name: z.ZodString;
+	teamId: z.ZodString;
+	abbr: z.ZodOptional<z.ZodString>;
+	nickname: z.ZodOptional<z.ZodString>;
+}, z.core.$loose>;
+/** Inferred type for a /cfs/ match team. */
+type CfsMatchTeam = z.infer<typeof CfsMatchTeamSchema>;
+/** Schema for the inner match object within a /cfs/ match item. */
+declare const CfsMatchSchema: z.ZodObject<{
+	matchId: z.ZodString;
+	name: z.ZodOptional<z.ZodString>;
+	status: z.ZodString;
+	utcStartTime: z.ZodString;
+	homeTeamId: z.ZodString;
+	awayTeamId: z.ZodString;
+	homeTeam: z.ZodObject<{
+		name: z.ZodString;
+		teamId: z.ZodString;
+		abbr: z.ZodOptional<z.ZodString>;
+		nickname: z.ZodOptional<z.ZodString>;
+	}, z.core.$loose>;
+	awayTeam: z.ZodObject<{
+		name: z.ZodString;
+		teamId: z.ZodString;
+		abbr: z.ZodOptional<z.ZodString>;
+		nickname: z.ZodOptional<z.ZodString>;
+	}, z.core.$loose>;
+	round: z.ZodOptional<z.ZodString>;
+	abbr: z.ZodOptional<z.ZodString>;
+}, z.core.$loose>;
+/** Inferred type for a /cfs/ match. */
+type CfsMatch = z.infer<typeof CfsMatchSchema>;
+/** Schema for the score wrapper within a /cfs/ match item. */
+declare const CfsScoreSchema: z.ZodObject<{
+	status: z.ZodString;
+	matchId: z.ZodString;
+	homeTeamScore: z.ZodObject<{
+		matchScore: z.ZodObject<{
+			totalScore: z.ZodNumber;
+			goals: z.ZodNumber;
+			behinds: z.ZodNumber;
+			superGoals: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+		}, z.core.$loose>;
+		periodScore: z.ZodOptional<z.ZodArray<z.ZodObject<{
+			periodNumber: z.ZodNumber;
+			score: z.ZodObject<{
+				totalScore: z.ZodNumber;
+				goals: z.ZodNumber;
+				behinds: z.ZodNumber;
+				superGoals: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+			}, z.core.$loose>;
+		}, z.core.$loose>>>;
+		rushedBehinds: z.ZodOptional<z.ZodNumber>;
+		minutesInFront: z.ZodOptional<z.ZodNumber>;
+	}, z.core.$loose>;
+	awayTeamScore: z.ZodObject<{
+		matchScore: z.ZodObject<{
+			totalScore: z.ZodNumber;
+			goals: z.ZodNumber;
+			behinds: z.ZodNumber;
+			superGoals: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+		}, z.core.$loose>;
+		periodScore: z.ZodOptional<z.ZodArray<z.ZodObject<{
+			periodNumber: z.ZodNumber;
+			score: z.ZodObject<{
+				totalScore: z.ZodNumber;
+				goals: z.ZodNumber;
+				behinds: z.ZodNumber;
+				superGoals: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+			}, z.core.$loose>;
+		}, z.core.$loose>>>;
+		rushedBehinds: z.ZodOptional<z.ZodNumber>;
+		minutesInFront: z.ZodOptional<z.ZodNumber>;
+	}, z.core.$loose>;
+}, z.core.$loose>;
+/** Inferred type for a /cfs/ score wrapper. */
+type CfsScore = z.infer<typeof CfsScoreSchema>;
+/** Schema for venue info in /cfs/ responses. */
+declare const CfsVenueSchema: z.ZodObject<{
+	name: z.ZodString;
+	venueId: z.ZodOptional<z.ZodString>;
+	state: z.ZodOptional<z.ZodString>;
+	timeZone: z.ZodOptional<z.ZodString>;
+}, z.core.$loose>;
+/** Inferred type for a /cfs/ venue. */
+type CfsVenue = z.infer<typeof CfsVenueSchema>;
+/** Schema for a single match item in round results. */
+declare const MatchItemSchema: z.ZodObject<{
+	match: z.ZodObject<{
+		matchId: z.ZodString;
+		name: z.ZodOptional<z.ZodString>;
+		status: z.ZodString;
+		utcStartTime: z.ZodString;
+		homeTeamId: z.ZodString;
+		awayTeamId: z.ZodString;
+		homeTeam: z.ZodObject<{
+			name: z.ZodString;
+			teamId: z.ZodString;
+			abbr: z.ZodOptional<z.ZodString>;
+			nickname: z.ZodOptional<z.ZodString>;
+		}, z.core.$loose>;
+		awayTeam: z.ZodObject<{
+			name: z.ZodString;
+			teamId: z.ZodString;
+			abbr: z.ZodOptional<z.ZodString>;
+			nickname: z.ZodOptional<z.ZodString>;
+		}, z.core.$loose>;
+		round: z.ZodOptional<z.ZodString>;
+		abbr: z.ZodOptional<z.ZodString>;
+	}, z.core.$loose>;
+	score: z.ZodOptional<z.ZodObject<{
+		status: z.ZodString;
+		matchId: z.ZodString;
+		homeTeamScore: z.ZodObject<{
+			matchScore: z.ZodObject<{
+				totalScore: z.ZodNumber;
+				goals: z.ZodNumber;
+				behinds: z.ZodNumber;
+				superGoals: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+			}, z.core.$loose>;
+			periodScore: z.ZodOptional<z.ZodArray<z.ZodObject<{
+				periodNumber: z.ZodNumber;
+				score: z.ZodObject<{
+					totalScore: z.ZodNumber;
+					goals: z.ZodNumber;
+					behinds: z.ZodNumber;
+					superGoals: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+				}, z.core.$loose>;
+			}, z.core.$loose>>>;
+			rushedBehinds: z.ZodOptional<z.ZodNumber>;
+			minutesInFront: z.ZodOptional<z.ZodNumber>;
+		}, z.core.$loose>;
+		awayTeamScore: z.ZodObject<{
+			matchScore: z.ZodObject<{
+				totalScore: z.ZodNumber;
+				goals: z.ZodNumber;
+				behinds: z.ZodNumber;
+				superGoals: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+			}, z.core.$loose>;
+			periodScore: z.ZodOptional<z.ZodArray<z.ZodObject<{
+				periodNumber: z.ZodNumber;
+				score: z.ZodObject<{
+					totalScore: z.ZodNumber;
+					goals: z.ZodNumber;
+					behinds: z.ZodNumber;
+					superGoals: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+				}, z.core.$loose>;
+			}, z.core.$loose>>>;
+			rushedBehinds: z.ZodOptional<z.ZodNumber>;
+			minutesInFront: z.ZodOptional<z.ZodNumber>;
+		}, z.core.$loose>;
+	}, z.core.$loose>>;
+	venue: z.ZodOptional<z.ZodObject<{
+		name: z.ZodString;
+		venueId: z.ZodOptional<z.ZodString>;
+		state: z.ZodOptional<z.ZodString>;
+		timeZone: z.ZodOptional<z.ZodString>;
+	}, z.core.$loose>>;
+	round: z.ZodOptional<z.ZodObject<{
+		name: z.ZodString;
+		roundId: z.ZodString;
+		roundNumber: z.ZodNumber;
+	}, z.core.$loose>>;
+}, z.core.$loose>;
+/** Schema for the match items (round results) response. */
+declare const MatchItemListSchema: z.ZodObject<{
+	roundId: z.ZodOptional<z.ZodString>;
+	items: z.ZodArray<z.ZodObject<{
+		match: z.ZodObject<{
+			matchId: z.ZodString;
+			name: z.ZodOptional<z.ZodString>;
+			status: z.ZodString;
+			utcStartTime: z.ZodString;
+			homeTeamId: z.ZodString;
+			awayTeamId: z.ZodString;
+			homeTeam: z.ZodObject<{
+				name: z.ZodString;
+				teamId: z.ZodString;
+				abbr: z.ZodOptional<z.ZodString>;
+				nickname: z.ZodOptional<z.ZodString>;
+			}, z.core.$loose>;
+			awayTeam: z.ZodObject<{
+				name: z.ZodString;
+				teamId: z.ZodString;
+				abbr: z.ZodOptional<z.ZodString>;
+				nickname: z.ZodOptional<z.ZodString>;
+			}, z.core.$loose>;
+			round: z.ZodOptional<z.ZodString>;
+			abbr: z.ZodOptional<z.ZodString>;
+		}, z.core.$loose>;
+		score: z.ZodOptional<z.ZodObject<{
+			status: z.ZodString;
+			matchId: z.ZodString;
+			homeTeamScore: z.ZodObject<{
+				matchScore: z.ZodObject<{
+					totalScore: z.ZodNumber;
+					goals: z.ZodNumber;
+					behinds: z.ZodNumber;
+					superGoals: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+				}, z.core.$loose>;
+				periodScore: z.ZodOptional<z.ZodArray<z.ZodObject<{
+					periodNumber: z.ZodNumber;
+					score: z.ZodObject<{
+						totalScore: z.ZodNumber;
+						goals: z.ZodNumber;
+						behinds: z.ZodNumber;
+						superGoals: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+					}, z.core.$loose>;
+				}, z.core.$loose>>>;
+				rushedBehinds: z.ZodOptional<z.ZodNumber>;
+				minutesInFront: z.ZodOptional<z.ZodNumber>;
+			}, z.core.$loose>;
+			awayTeamScore: z.ZodObject<{
+				matchScore: z.ZodObject<{
+					totalScore: z.ZodNumber;
+					goals: z.ZodNumber;
+					behinds: z.ZodNumber;
+					superGoals: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+				}, z.core.$loose>;
+				periodScore: z.ZodOptional<z.ZodArray<z.ZodObject<{
+					periodNumber: z.ZodNumber;
+					score: z.ZodObject<{
+						totalScore: z.ZodNumber;
+						goals: z.ZodNumber;
+						behinds: z.ZodNumber;
+						superGoals: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+					}, z.core.$loose>;
+				}, z.core.$loose>>>;
+				rushedBehinds: z.ZodOptional<z.ZodNumber>;
+				minutesInFront: z.ZodOptional<z.ZodNumber>;
+			}, z.core.$loose>;
+		}, z.core.$loose>>;
+		venue: z.ZodOptional<z.ZodObject<{
+			name: z.ZodString;
+			venueId: z.ZodOptional<z.ZodString>;
+			state: z.ZodOptional<z.ZodString>;
+			timeZone: z.ZodOptional<z.ZodString>;
+		}, z.core.$loose>>;
+		round: z.ZodOptional<z.ZodObject<{
+			name: z.ZodString;
+			roundId: z.ZodString;
+			roundNumber: z.ZodNumber;
+		}, z.core.$loose>>;
+	}, z.core.$loose>>;
+}, z.core.$loose>;
+/** Inferred type for a single match item. */
+type MatchItem = z.infer<typeof MatchItemSchema>;
+/** Inferred type for the match items list response. */
+type MatchItemList = z.infer<typeof MatchItemListSchema>;
+/** Schema for stat values (clearances is nested). */
+declare const PlayerGameStatsSchema: z.ZodObject<{
+	goals: z.ZodOptional<z.ZodNumber>;
+	behinds: z.ZodOptional<z.ZodNumber>;
+	kicks: z.ZodOptional<z.ZodNumber>;
+	handballs: z.ZodOptional<z.ZodNumber>;
+	disposals: z.ZodOptional<z.ZodNumber>;
+	marks: z.ZodOptional<z.ZodNumber>;
+	bounces: z.ZodOptional<z.ZodNumber>;
+	tackles: z.ZodOptional<z.ZodNumber>;
+	contestedPossessions: z.ZodOptional<z.ZodNumber>;
+	uncontestedPossessions: z.ZodOptional<z.ZodNumber>;
+	totalPossessions: z.ZodOptional<z.ZodNumber>;
+	inside50s: z.ZodOptional<z.ZodNumber>;
+	marksInside50: z.ZodOptional<z.ZodNumber>;
+	contestedMarks: z.ZodOptional<z.ZodNumber>;
+	hitouts: z.ZodOptional<z.ZodNumber>;
+	onePercenters: z.ZodOptional<z.ZodNumber>;
+	disposalEfficiency: z.ZodOptional<z.ZodNumber>;
+	clangers: z.ZodOptional<z.ZodNumber>;
+	freesFor: z.ZodOptional<z.ZodNumber>;
+	freesAgainst: z.ZodOptional<z.ZodNumber>;
+	dreamTeamPoints: z.ZodOptional<z.ZodNumber>;
+	clearances: z.ZodOptional<z.ZodObject<{
+		centreClearances: z.ZodOptional<z.ZodNumber>;
+		stoppageClearances: z.ZodOptional<z.ZodNumber>;
+		totalClearances: z.ZodOptional<z.ZodNumber>;
+	}, z.core.$loose>>;
+	rebound50s: z.ZodOptional<z.ZodNumber>;
+	goalAssists: z.ZodOptional<z.ZodNumber>;
+	goalAccuracy: z.ZodOptional<z.ZodNumber>;
+	turnovers: z.ZodOptional<z.ZodNumber>;
+	intercepts: z.ZodOptional<z.ZodNumber>;
+	tacklesInside50: z.ZodOptional<z.ZodNumber>;
+	shotsAtGoal: z.ZodOptional<z.ZodNumber>;
+	metresGained: z.ZodOptional<z.ZodNumber>;
+	scoreInvolvements: z.ZodOptional<z.ZodNumber>;
+	ratingPoints: z.ZodOptional<z.ZodNumber>;
+	extendedStats: z.ZodOptional<z.ZodObject<{
+		effectiveDisposals: z.ZodOptional<z.ZodNumber>;
+		effectiveKicks: z.ZodOptional<z.ZodNumber>;
+		kickEfficiency: z.ZodOptional<z.ZodNumber>;
+		kickToHandballRatio: z.ZodOptional<z.ZodNumber>;
+		pressureActs: z.ZodOptional<z.ZodNumber>;
+		defHalfPressureActs: z.ZodOptional<z.ZodNumber>;
+		spoils: z.ZodOptional<z.ZodNumber>;
+		hitoutsToAdvantage: z.ZodOptional<z.ZodNumber>;
+		hitoutWinPercentage: z.ZodOptional<z.ZodNumber>;
+		hitoutToAdvantageRate: z.ZodOptional<z.ZodNumber>;
+		groundBallGets: z.ZodOptional<z.ZodNumber>;
+		f50GroundBallGets: z.ZodOptional<z.ZodNumber>;
+		interceptMarks: z.ZodOptional<z.ZodNumber>;
+		marksOnLead: z.ZodOptional<z.ZodNumber>;
+		contestedPossessionRate: z.ZodOptional<z.ZodNumber>;
+		contestOffOneOnOnes: z.ZodOptional<z.ZodNumber>;
+		contestOffWins: z.ZodOptional<z.ZodNumber>;
+		contestOffWinsPercentage: z.ZodOptional<z.ZodNumber>;
+		contestDefOneOnOnes: z.ZodOptional<z.ZodNumber>;
+		contestDefLosses: z.ZodOptional<z.ZodNumber>;
+		contestDefLossPercentage: z.ZodOptional<z.ZodNumber>;
+		centreBounceAttendances: z.ZodOptional<z.ZodNumber>;
+		kickins: z.ZodOptional<z.ZodNumber>;
+		kickinsPlayon: z.ZodOptional<z.ZodNumber>;
+		ruckContests: z.ZodOptional<z.ZodNumber>;
+		scoreLaunches: z.ZodOptional<z.ZodNumber>;
+	}, z.core.$loose>>;
+}, z.core.$loose>;
+/** Schema for a single player's statistics in a match. */
+declare const PlayerStatsItemSchema: z.ZodObject<{
+	player: z.ZodObject<{
+		player: z.ZodObject<{
+			position: z.ZodOptional<z.ZodString>;
+			player: z.ZodObject<{
+				playerId: z.ZodString;
+				playerName: z.ZodObject<{
+					givenName: z.ZodString;
+					surname: z.ZodString;
+				}, z.core.$loose>;
+				captain: z.ZodOptional<z.ZodBoolean>;
+				playerJumperNumber: z.ZodOptional<z.ZodNumber>;
+			}, z.core.$loose>;
+		}, z.core.$loose>;
+		jumperNumber: z.ZodOptional<z.ZodNumber>;
+	}, z.core.$loose>;
+	teamId: z.ZodString;
+	playerStats: z.ZodObject<{
+		stats: z.ZodObject<{
+			goals: z.ZodOptional<z.ZodNumber>;
+			behinds: z.ZodOptional<z.ZodNumber>;
+			kicks: z.ZodOptional<z.ZodNumber>;
+			handballs: z.ZodOptional<z.ZodNumber>;
+			disposals: z.ZodOptional<z.ZodNumber>;
+			marks: z.ZodOptional<z.ZodNumber>;
+			bounces: z.ZodOptional<z.ZodNumber>;
+			tackles: z.ZodOptional<z.ZodNumber>;
+			contestedPossessions: z.ZodOptional<z.ZodNumber>;
+			uncontestedPossessions: z.ZodOptional<z.ZodNumber>;
+			totalPossessions: z.ZodOptional<z.ZodNumber>;
+			inside50s: z.ZodOptional<z.ZodNumber>;
+			marksInside50: z.ZodOptional<z.ZodNumber>;
+			contestedMarks: z.ZodOptional<z.ZodNumber>;
+			hitouts: z.ZodOptional<z.ZodNumber>;
+			onePercenters: z.ZodOptional<z.ZodNumber>;
+			disposalEfficiency: z.ZodOptional<z.ZodNumber>;
+			clangers: z.ZodOptional<z.ZodNumber>;
+			freesFor: z.ZodOptional<z.ZodNumber>;
+			freesAgainst: z.ZodOptional<z.ZodNumber>;
+			dreamTeamPoints: z.ZodOptional<z.ZodNumber>;
+			clearances: z.ZodOptional<z.ZodObject<{
+				centreClearances: z.ZodOptional<z.ZodNumber>;
+				stoppageClearances: z.ZodOptional<z.ZodNumber>;
+				totalClearances: z.ZodOptional<z.ZodNumber>;
+			}, z.core.$loose>>;
+			rebound50s: z.ZodOptional<z.ZodNumber>;
+			goalAssists: z.ZodOptional<z.ZodNumber>;
+			goalAccuracy: z.ZodOptional<z.ZodNumber>;
+			turnovers: z.ZodOptional<z.ZodNumber>;
+			intercepts: z.ZodOptional<z.ZodNumber>;
+			tacklesInside50: z.ZodOptional<z.ZodNumber>;
+			shotsAtGoal: z.ZodOptional<z.ZodNumber>;
+			metresGained: z.ZodOptional<z.ZodNumber>;
+			scoreInvolvements: z.ZodOptional<z.ZodNumber>;
+			ratingPoints: z.ZodOptional<z.ZodNumber>;
+			extendedStats: z.ZodOptional<z.ZodObject<{
+				effectiveDisposals: z.ZodOptional<z.ZodNumber>;
+				effectiveKicks: z.ZodOptional<z.ZodNumber>;
+				kickEfficiency: z.ZodOptional<z.ZodNumber>;
+				kickToHandballRatio: z.ZodOptional<z.ZodNumber>;
+				pressureActs: z.ZodOptional<z.ZodNumber>;
+				defHalfPressureActs: z.ZodOptional<z.ZodNumber>;
+				spoils: z.ZodOptional<z.ZodNumber>;
+				hitoutsToAdvantage: z.ZodOptional<z.ZodNumber>;
+				hitoutWinPercentage: z.ZodOptional<z.ZodNumber>;
+				hitoutToAdvantageRate: z.ZodOptional<z.ZodNumber>;
+				groundBallGets: z.ZodOptional<z.ZodNumber>;
+				f50GroundBallGets: z.ZodOptional<z.ZodNumber>;
+				interceptMarks: z.ZodOptional<z.ZodNumber>;
+				marksOnLead: z.ZodOptional<z.ZodNumber>;
+				contestedPossessionRate: z.ZodOptional<z.ZodNumber>;
+				contestOffOneOnOnes: z.ZodOptional<z.ZodNumber>;
+				contestOffWins: z.ZodOptional<z.ZodNumber>;
+				contestOffWinsPercentage: z.ZodOptional<z.ZodNumber>;
+				contestDefOneOnOnes: z.ZodOptional<z.ZodNumber>;
+				contestDefLosses: z.ZodOptional<z.ZodNumber>;
+				contestDefLossPercentage: z.ZodOptional<z.ZodNumber>;
+				centreBounceAttendances: z.ZodOptional<z.ZodNumber>;
+				kickins: z.ZodOptional<z.ZodNumber>;
+				kickinsPlayon: z.ZodOptional<z.ZodNumber>;
+				ruckContests: z.ZodOptional<z.ZodNumber>;
+				scoreLaunches: z.ZodOptional<z.ZodNumber>;
+			}, z.core.$loose>>;
+		}, z.core.$loose>;
+		timeOnGroundPercentage: z.ZodOptional<z.ZodNumber>;
+	}, z.core.$loose>;
+}, z.core.$loose>;
+/** Schema for the player stats response. */
+declare const PlayerStatsListSchema: z.ZodObject<{
+	homeTeamPlayerStats: z.ZodArray<z.ZodObject<{
+		player: z.ZodObject<{
+			player: z.ZodObject<{
+				position: z.ZodOptional<z.ZodString>;
+				player: z.ZodObject<{
+					playerId: z.ZodString;
+					playerName: z.ZodObject<{
+						givenName: z.ZodString;
+						surname: z.ZodString;
+					}, z.core.$loose>;
+					captain: z.ZodOptional<z.ZodBoolean>;
+					playerJumperNumber: z.ZodOptional<z.ZodNumber>;
+				}, z.core.$loose>;
+			}, z.core.$loose>;
+			jumperNumber: z.ZodOptional<z.ZodNumber>;
+		}, z.core.$loose>;
+		teamId: z.ZodString;
+		playerStats: z.ZodObject<{
+			stats: z.ZodObject<{
+				goals: z.ZodOptional<z.ZodNumber>;
+				behinds: z.ZodOptional<z.ZodNumber>;
+				kicks: z.ZodOptional<z.ZodNumber>;
+				handballs: z.ZodOptional<z.ZodNumber>;
+				disposals: z.ZodOptional<z.ZodNumber>;
+				marks: z.ZodOptional<z.ZodNumber>;
+				bounces: z.ZodOptional<z.ZodNumber>;
+				tackles: z.ZodOptional<z.ZodNumber>;
+				contestedPossessions: z.ZodOptional<z.ZodNumber>;
+				uncontestedPossessions: z.ZodOptional<z.ZodNumber>;
+				totalPossessions: z.ZodOptional<z.ZodNumber>;
+				inside50s: z.ZodOptional<z.ZodNumber>;
+				marksInside50: z.ZodOptional<z.ZodNumber>;
+				contestedMarks: z.ZodOptional<z.ZodNumber>;
+				hitouts: z.ZodOptional<z.ZodNumber>;
+				onePercenters: z.ZodOptional<z.ZodNumber>;
+				disposalEfficiency: z.ZodOptional<z.ZodNumber>;
+				clangers: z.ZodOptional<z.ZodNumber>;
+				freesFor: z.ZodOptional<z.ZodNumber>;
+				freesAgainst: z.ZodOptional<z.ZodNumber>;
+				dreamTeamPoints: z.ZodOptional<z.ZodNumber>;
+				clearances: z.ZodOptional<z.ZodObject<{
+					centreClearances: z.ZodOptional<z.ZodNumber>;
+					stoppageClearances: z.ZodOptional<z.ZodNumber>;
+					totalClearances: z.ZodOptional<z.ZodNumber>;
+				}, z.core.$loose>>;
+				rebound50s: z.ZodOptional<z.ZodNumber>;
+				goalAssists: z.ZodOptional<z.ZodNumber>;
+				goalAccuracy: z.ZodOptional<z.ZodNumber>;
+				turnovers: z.ZodOptional<z.ZodNumber>;
+				intercepts: z.ZodOptional<z.ZodNumber>;
+				tacklesInside50: z.ZodOptional<z.ZodNumber>;
+				shotsAtGoal: z.ZodOptional<z.ZodNumber>;
+				metresGained: z.ZodOptional<z.ZodNumber>;
+				scoreInvolvements: z.ZodOptional<z.ZodNumber>;
+				ratingPoints: z.ZodOptional<z.ZodNumber>;
+				extendedStats: z.ZodOptional<z.ZodObject<{
+					effectiveDisposals: z.ZodOptional<z.ZodNumber>;
+					effectiveKicks: z.ZodOptional<z.ZodNumber>;
+					kickEfficiency: z.ZodOptional<z.ZodNumber>;
+					kickToHandballRatio: z.ZodOptional<z.ZodNumber>;
+					pressureActs: z.ZodOptional<z.ZodNumber>;
+					defHalfPressureActs: z.ZodOptional<z.ZodNumber>;
+					spoils: z.ZodOptional<z.ZodNumber>;
+					hitoutsToAdvantage: z.ZodOptional<z.ZodNumber>;
+					hitoutWinPercentage: z.ZodOptional<z.ZodNumber>;
+					hitoutToAdvantageRate: z.ZodOptional<z.ZodNumber>;
+					groundBallGets: z.ZodOptional<z.ZodNumber>;
+					f50GroundBallGets: z.ZodOptional<z.ZodNumber>;
+					interceptMarks: z.ZodOptional<z.ZodNumber>;
+					marksOnLead: z.ZodOptional<z.ZodNumber>;
+					contestedPossessionRate: z.ZodOptional<z.ZodNumber>;
+					contestOffOneOnOnes: z.ZodOptional<z.ZodNumber>;
+					contestOffWins: z.ZodOptional<z.ZodNumber>;
+					contestOffWinsPercentage: z.ZodOptional<z.ZodNumber>;
+					contestDefOneOnOnes: z.ZodOptional<z.ZodNumber>;
+					contestDefLosses: z.ZodOptional<z.ZodNumber>;
+					contestDefLossPercentage: z.ZodOptional<z.ZodNumber>;
+					centreBounceAttendances: z.ZodOptional<z.ZodNumber>;
+					kickins: z.ZodOptional<z.ZodNumber>;
+					kickinsPlayon: z.ZodOptional<z.ZodNumber>;
+					ruckContests: z.ZodOptional<z.ZodNumber>;
+					scoreLaunches: z.ZodOptional<z.ZodNumber>;
+				}, z.core.$loose>>;
+			}, z.core.$loose>;
+			timeOnGroundPercentage: z.ZodOptional<z.ZodNumber>;
+		}, z.core.$loose>;
+	}, z.core.$loose>>;
+	awayTeamPlayerStats: z.ZodArray<z.ZodObject<{
+		player: z.ZodObject<{
+			player: z.ZodObject<{
+				position: z.ZodOptional<z.ZodString>;
+				player: z.ZodObject<{
+					playerId: z.ZodString;
+					playerName: z.ZodObject<{
+						givenName: z.ZodString;
+						surname: z.ZodString;
+					}, z.core.$loose>;
+					captain: z.ZodOptional<z.ZodBoolean>;
+					playerJumperNumber: z.ZodOptional<z.ZodNumber>;
+				}, z.core.$loose>;
+			}, z.core.$loose>;
+			jumperNumber: z.ZodOptional<z.ZodNumber>;
+		}, z.core.$loose>;
+		teamId: z.ZodString;
+		playerStats: z.ZodObject<{
+			stats: z.ZodObject<{
+				goals: z.ZodOptional<z.ZodNumber>;
+				behinds: z.ZodOptional<z.ZodNumber>;
+				kicks: z.ZodOptional<z.ZodNumber>;
+				handballs: z.ZodOptional<z.ZodNumber>;
+				disposals: z.ZodOptional<z.ZodNumber>;
+				marks: z.ZodOptional<z.ZodNumber>;
+				bounces: z.ZodOptional<z.ZodNumber>;
+				tackles: z.ZodOptional<z.ZodNumber>;
+				contestedPossessions: z.ZodOptional<z.ZodNumber>;
+				uncontestedPossessions: z.ZodOptional<z.ZodNumber>;
+				totalPossessions: z.ZodOptional<z.ZodNumber>;
+				inside50s: z.ZodOptional<z.ZodNumber>;
+				marksInside50: z.ZodOptional<z.ZodNumber>;
+				contestedMarks: z.ZodOptional<z.ZodNumber>;
+				hitouts: z.ZodOptional<z.ZodNumber>;
+				onePercenters: z.ZodOptional<z.ZodNumber>;
+				disposalEfficiency: z.ZodOptional<z.ZodNumber>;
+				clangers: z.ZodOptional<z.ZodNumber>;
+				freesFor: z.ZodOptional<z.ZodNumber>;
+				freesAgainst: z.ZodOptional<z.ZodNumber>;
+				dreamTeamPoints: z.ZodOptional<z.ZodNumber>;
+				clearances: z.ZodOptional<z.ZodObject<{
+					centreClearances: z.ZodOptional<z.ZodNumber>;
+					stoppageClearances: z.ZodOptional<z.ZodNumber>;
+					totalClearances: z.ZodOptional<z.ZodNumber>;
+				}, z.core.$loose>>;
+				rebound50s: z.ZodOptional<z.ZodNumber>;
+				goalAssists: z.ZodOptional<z.ZodNumber>;
+				goalAccuracy: z.ZodOptional<z.ZodNumber>;
+				turnovers: z.ZodOptional<z.ZodNumber>;
+				intercepts: z.ZodOptional<z.ZodNumber>;
+				tacklesInside50: z.ZodOptional<z.ZodNumber>;
+				shotsAtGoal: z.ZodOptional<z.ZodNumber>;
+				metresGained: z.ZodOptional<z.ZodNumber>;
+				scoreInvolvements: z.ZodOptional<z.ZodNumber>;
+				ratingPoints: z.ZodOptional<z.ZodNumber>;
+				extendedStats: z.ZodOptional<z.ZodObject<{
+					effectiveDisposals: z.ZodOptional<z.ZodNumber>;
+					effectiveKicks: z.ZodOptional<z.ZodNumber>;
+					kickEfficiency: z.ZodOptional<z.ZodNumber>;
+					kickToHandballRatio: z.ZodOptional<z.ZodNumber>;
+					pressureActs: z.ZodOptional<z.ZodNumber>;
+					defHalfPressureActs: z.ZodOptional<z.ZodNumber>;
+					spoils: z.ZodOptional<z.ZodNumber>;
+					hitoutsToAdvantage: z.ZodOptional<z.ZodNumber>;
+					hitoutWinPercentage: z.ZodOptional<z.ZodNumber>;
+					hitoutToAdvantageRate: z.ZodOptional<z.ZodNumber>;
+					groundBallGets: z.ZodOptional<z.ZodNumber>;
+					f50GroundBallGets: z.ZodOptional<z.ZodNumber>;
+					interceptMarks: z.ZodOptional<z.ZodNumber>;
+					marksOnLead: z.ZodOptional<z.ZodNumber>;
+					contestedPossessionRate: z.ZodOptional<z.ZodNumber>;
+					contestOffOneOnOnes: z.ZodOptional<z.ZodNumber>;
+					contestOffWins: z.ZodOptional<z.ZodNumber>;
+					contestOffWinsPercentage: z.ZodOptional<z.ZodNumber>;
+					contestDefOneOnOnes: z.ZodOptional<z.ZodNumber>;
+					contestDefLosses: z.ZodOptional<z.ZodNumber>;
+					contestDefLossPercentage: z.ZodOptional<z.ZodNumber>;
+					centreBounceAttendances: z.ZodOptional<z.ZodNumber>;
+					kickins: z.ZodOptional<z.ZodNumber>;
+					kickinsPlayon: z.ZodOptional<z.ZodNumber>;
+					ruckContests: z.ZodOptional<z.ZodNumber>;
+					scoreLaunches: z.ZodOptional<z.ZodNumber>;
+				}, z.core.$loose>>;
+			}, z.core.$loose>;
+			timeOnGroundPercentage: z.ZodOptional<z.ZodNumber>;
+		}, z.core.$loose>;
+	}, z.core.$loose>>;
+}, z.core.$loose>;
+/** Inferred type for a single player stats item. */
+type PlayerStatsItem = z.infer<typeof PlayerStatsItemSchema>;
+/** Inferred type for player game stats. */
+type PlayerGameStats = z.infer<typeof PlayerGameStatsSchema>;
+/** Inferred type for the player stats list response. */
+type PlayerStatsList = z.infer<typeof PlayerStatsListSchema>;
+/** Schema for a player entry within a match roster. */
+declare const RosterPlayerSchema: z.ZodObject<{
+	player: z.ZodObject<{
+		position: z.ZodOptional<z.ZodString>;
+		player: z.ZodObject<{
+			playerId: z.ZodString;
+			playerName: z.ZodObject<{
+				givenName: z.ZodString;
+				surname: z.ZodString;
+			}, z.core.$loose>;
+			captain: z.ZodOptional<z.ZodBoolean>;
+			playerJumperNumber: z.ZodOptional<z.ZodNumber>;
+		}, z.core.$loose>;
+	}, z.core.$loose>;
+	jumperNumber: z.ZodOptional<z.ZodNumber>;
+}, z.core.$loose>;
+/** Schema for a team's player list in the roster. */
+declare const TeamPlayersSchema: z.ZodObject<{
+	teamId: z.ZodString;
+	players: z.ZodArray<z.ZodObject<{
+		player: z.ZodObject<{
+			position: z.ZodOptional<z.ZodString>;
+			player: z.ZodObject<{
+				playerId: z.ZodString;
+				playerName: z.ZodObject<{
+					givenName: z.ZodString;
+					surname: z.ZodString;
+				}, z.core.$loose>;
+				captain: z.ZodOptional<z.ZodBoolean>;
+				playerJumperNumber: z.ZodOptional<z.ZodNumber>;
+			}, z.core.$loose>;
+		}, z.core.$loose>;
+		jumperNumber: z.ZodOptional<z.ZodNumber>;
+	}, z.core.$loose>>;
+}, z.core.$loose>;
+/** Schema for the full match roster response. */
+declare const MatchRosterSchema: z.ZodObject<{
+	match: z.ZodObject<{
+		matchId: z.ZodString;
+		name: z.ZodOptional<z.ZodString>;
+		status: z.ZodString;
+		utcStartTime: z.ZodString;
+		homeTeamId: z.ZodString;
+		awayTeamId: z.ZodString;
+		homeTeam: z.ZodObject<{
+			name: z.ZodString;
+			teamId: z.ZodString;
+			abbr: z.ZodOptional<z.ZodString>;
+			nickname: z.ZodOptional<z.ZodString>;
+		}, z.core.$loose>;
+		awayTeam: z.ZodObject<{
+			name: z.ZodString;
+			teamId: z.ZodString;
+			abbr: z.ZodOptional<z.ZodString>;
+			nickname: z.ZodOptional<z.ZodString>;
+		}, z.core.$loose>;
+		round: z.ZodOptional<z.ZodString>;
+		abbr: z.ZodOptional<z.ZodString>;
+	}, z.core.$loose>;
+	teamPlayers: z.ZodArray<z.ZodObject<{
+		teamId: z.ZodString;
+		players: z.ZodArray<z.ZodObject<{
+			player: z.ZodObject<{
+				position: z.ZodOptional<z.ZodString>;
+				player: z.ZodObject<{
+					playerId: z.ZodString;
+					playerName: z.ZodObject<{
+						givenName: z.ZodString;
+						surname: z.ZodString;
+					}, z.core.$loose>;
+					captain: z.ZodOptional<z.ZodBoolean>;
+					playerJumperNumber: z.ZodOptional<z.ZodNumber>;
+				}, z.core.$loose>;
+			}, z.core.$loose>;
+			jumperNumber: z.ZodOptional<z.ZodNumber>;
+		}, z.core.$loose>>;
+	}, z.core.$loose>>;
+}, z.core.$loose>;
+/** Inferred type for a roster player. */
+type RosterPlayer = z.infer<typeof RosterPlayerSchema>;
+/** Inferred type for a team's player list. */
+type TeamPlayers = z.infer<typeof TeamPlayersSchema>;
+/** Inferred type for the match roster response. */
+type MatchRoster = z.infer<typeof MatchRosterSchema>;
+/** Schema for a single team entry. */
+declare const TeamItemSchema: z.ZodObject<{
+	id: z.ZodNumber;
+	name: z.ZodString;
+	abbreviation: z.ZodOptional<z.ZodString>;
+	teamType: z.ZodOptional<z.ZodString>;
+}, z.core.$loose>;
+/** Schema for the team list response. */
+declare const TeamListSchema: z.ZodObject<{
+	teams: z.ZodArray<z.ZodObject<{
+		id: z.ZodNumber;
+		name: z.ZodString;
+		abbreviation: z.ZodOptional<z.ZodString>;
+		teamType: z.ZodOptional<z.ZodString>;
+	}, z.core.$loose>>;
+}, z.core.$loose>;
+/** Inferred type for a single team item. */
+type TeamItem = z.infer<typeof TeamItemSchema>;
+/** Inferred type for the team list response. */
+type TeamList = z.infer<typeof TeamListSchema>;
+/** Schema for a player's inner identity within a squad. */
+declare const SquadPlayerInnerSchema: z.ZodObject<{
+	id: z.ZodNumber;
+	providerId: z.ZodOptional<z.ZodString>;
+	firstName: z.ZodString;
+	surname: z.ZodString;
+	dateOfBirth: z.ZodOptional<z.ZodString>;
+	heightInCm: z.ZodOptional<z.ZodNumber>;
+	weightInKg: z.ZodOptional<z.ZodNumber>;
+	draftYear: z.ZodOptional<z.ZodString>;
+	draftPosition: z.ZodOptional<z.ZodString>;
+	draftType: z.ZodOptional<z.ZodString>;
+	debutYear: z.ZodOptional<z.ZodString>;
+	recruitedFrom: z.ZodOptional<z.ZodString>;
+}, z.core.$loose>;
+/** Schema for a single squad player entry. */
+declare const SquadPlayerItemSchema: z.ZodObject<{
+	player: z.ZodObject<{
+		id: z.ZodNumber;
+		providerId: z.ZodOptional<z.ZodString>;
+		firstName: z.ZodString;
+		surname: z.ZodString;
+		dateOfBirth: z.ZodOptional<z.ZodString>;
+		heightInCm: z.ZodOptional<z.ZodNumber>;
+		weightInKg: z.ZodOptional<z.ZodNumber>;
+		draftYear: z.ZodOptional<z.ZodString>;
+		draftPosition: z.ZodOptional<z.ZodString>;
+		draftType: z.ZodOptional<z.ZodString>;
+		debutYear: z.ZodOptional<z.ZodString>;
+		recruitedFrom: z.ZodOptional<z.ZodString>;
+	}, z.core.$loose>;
+	jumperNumber: z.ZodOptional<z.ZodNumber>;
+	position: z.ZodOptional<z.ZodString>;
+}, z.core.$loose>;
+/** Schema for the squad wrapper object. */
+declare const SquadSchema: z.ZodObject<{
+	team: z.ZodOptional<z.ZodObject<{
+		name: z.ZodString;
+	}, z.core.$loose>>;
+	players: z.ZodArray<z.ZodObject<{
+		player: z.ZodObject<{
+			id: z.ZodNumber;
+			providerId: z.ZodOptional<z.ZodString>;
+			firstName: z.ZodString;
+			surname: z.ZodString;
+			dateOfBirth: z.ZodOptional<z.ZodString>;
+			heightInCm: z.ZodOptional<z.ZodNumber>;
+			weightInKg: z.ZodOptional<z.ZodNumber>;
+			draftYear: z.ZodOptional<z.ZodString>;
+			draftPosition: z.ZodOptional<z.ZodString>;
+			draftType: z.ZodOptional<z.ZodString>;
+			debutYear: z.ZodOptional<z.ZodString>;
+			recruitedFrom: z.ZodOptional<z.ZodString>;
+		}, z.core.$loose>;
+		jumperNumber: z.ZodOptional<z.ZodNumber>;
+		position: z.ZodOptional<z.ZodString>;
+	}, z.core.$loose>>;
+}, z.core.$loose>;
+/** Schema for the squad response. */
+declare const SquadListSchema: z.ZodObject<{
+	squad: z.ZodObject<{
+		team: z.ZodOptional<z.ZodObject<{
+			name: z.ZodString;
+		}, z.core.$loose>>;
+		players: z.ZodArray<z.ZodObject<{
+			player: z.ZodObject<{
+				id: z.ZodNumber;
+				providerId: z.ZodOptional<z.ZodString>;
+				firstName: z.ZodString;
+				surname: z.ZodString;
+				dateOfBirth: z.ZodOptional<z.ZodString>;
+				heightInCm: z.ZodOptional<z.ZodNumber>;
+				weightInKg: z.ZodOptional<z.ZodNumber>;
+				draftYear: z.ZodOptional<z.ZodString>;
+				draftPosition: z.ZodOptional<z.ZodString>;
+				draftType: z.ZodOptional<z.ZodString>;
+				debutYear: z.ZodOptional<z.ZodString>;
+				recruitedFrom: z.ZodOptional<z.ZodString>;
+			}, z.core.$loose>;
+			jumperNumber: z.ZodOptional<z.ZodNumber>;
+			position: z.ZodOptional<z.ZodString>;
+		}, z.core.$loose>>;
+	}, z.core.$loose>;
+}, z.core.$loose>;
+/** Inferred type for a single squad player item. */
+type SquadPlayerItem = z.infer<typeof SquadPlayerItemSchema>;
+/** Inferred type for the squad response. */
+type SquadList = z.infer<typeof SquadListSchema>;
+/** Schema for a single ladder entry from the AFL API. */
+declare const LadderEntryRawSchema: z.ZodObject<{
+	position: z.ZodNumber;
+	team: z.ZodObject<{
+		name: z.ZodString;
+		id: z.ZodOptional<z.ZodNumber>;
+		abbreviation: z.ZodOptional<z.ZodString>;
+	}, z.core.$loose>;
+	played: z.ZodOptional<z.ZodNumber>;
+	pointsFor: z.ZodOptional<z.ZodNumber>;
+	pointsAgainst: z.ZodOptional<z.ZodNumber>;
+	thisSeasonRecord: z.ZodOptional<z.ZodObject<{
+		aggregatePoints: z.ZodOptional<z.ZodNumber>;
+		percentage: z.ZodOptional<z.ZodNumber>;
+		winLossRecord: z.ZodOptional<z.ZodObject<{
+			wins: z.ZodNumber;
+			losses: z.ZodNumber;
+			draws: z.ZodNumber;
+			played: z.ZodOptional<z.ZodNumber>;
+		}, z.core.$loose>>;
+	}, z.core.$loose>>;
+	form: z.ZodOptional<z.ZodString>;
+}, z.core.$loose>;
+/** Schema for the ladder API response. */
+declare const LadderResponseSchema: z.ZodObject<{
+	ladders: z.ZodArray<z.ZodObject<{
+		entries: z.ZodArray<z.ZodObject<{
+			position: z.ZodNumber;
+			team: z.ZodObject<{
+				name: z.ZodString;
+				id: z.ZodOptional<z.ZodNumber>;
+				abbreviation: z.ZodOptional<z.ZodString>;
+			}, z.core.$loose>;
+			played: z.ZodOptional<z.ZodNumber>;
+			pointsFor: z.ZodOptional<z.ZodNumber>;
+			pointsAgainst: z.ZodOptional<z.ZodNumber>;
+			thisSeasonRecord: z.ZodOptional<z.ZodObject<{
+				aggregatePoints: z.ZodOptional<z.ZodNumber>;
+				percentage: z.ZodOptional<z.ZodNumber>;
+				winLossRecord: z.ZodOptional<z.ZodObject<{
+					wins: z.ZodNumber;
+					losses: z.ZodNumber;
+					draws: z.ZodNumber;
+					played: z.ZodOptional<z.ZodNumber>;
+				}, z.core.$loose>>;
+			}, z.core.$loose>>;
+			form: z.ZodOptional<z.ZodString>;
+		}, z.core.$loose>>;
+	}, z.core.$loose>>;
+	round: z.ZodOptional<z.ZodObject<{
+		roundNumber: z.ZodNumber;
+		name: z.ZodOptional<z.ZodString>;
+	}, z.core.$loose>>;
+}, z.core.$loose>;
+/** Inferred type for a raw ladder entry. */
+type LadderEntryRaw = z.infer<typeof LadderEntryRawSchema>;
+/** Inferred type for the ladder API response. */
+type LadderResponse = z.infer<typeof LadderResponseSchema>;
+import { z as z2 } from "zod/v4";
+/** Options for constructing an {@link AflApiClient}. */
+interface AflApiClientOptions {
+	/** Custom fetch implementation (defaults to global `fetch`). */
+	readonly fetchFn?: typeof fetch | undefined;
+	/** Token endpoint override (useful for testing). */
+	readonly tokenUrl?: string | undefined;
+}
+/**
+* AFL API client that handles token authentication and provides typed fetch helpers.
+*
+* @example
+* ```ts
+* const client = new AflApiClient();
+* await client.authenticate();
+* const result = await client.fetchJson("https://api.afl.com.au/cfs/afl/matchItems/round/123", MatchItemListSchema);
+* ```
+*/
+declare class AflApiClient {
+	private readonly fetchFn;
+	private readonly tokenUrl;
+	private cachedToken;
+	constructor(options?: AflApiClientOptions);
+	/**
+	* Authenticate with the WMCTok token endpoint and cache the token.
+	*
+	* @returns The access token on success, or an error Result.
+	*/
+	authenticate(): Promise<Result<string, AflApiError>>;
+	/**
+	* Whether the cached token is still valid (not expired).
+	*/
+	get isAuthenticated(): boolean;
+	/**
+	* Perform an authenticated fetch, automatically adding the bearer token.
+	* Retries once on 401 by re-authenticating.
+	*
+	* @param url - The URL to fetch.
+	* @param init - Additional fetch options.
+	* @returns The Response on success, or an error Result.
+	*/
+	authedFetch(url: string, init?: RequestInit): Promise<Result<Response, AflApiError>>;
+	/**
+	* Fetch JSON from a URL, validate with a Zod schema, and return a typed Result.
+	*
+	* @param url - The URL to fetch.
+	* @param schema - Zod schema to validate the response against.
+	* @returns Validated data on success, or an error Result.
+	*/
+	fetchJson<T>(url: string, schema: z2.ZodType<T>): Promise<Result<T, AflApiError | ValidationError>>;
+	/**
+	* Resolve a competition code (e.g. "AFLM") to its API competition ID.
+	*
+	* @param code - The competition code to resolve.
+	* @returns The competition ID string on success.
+	*/
+	resolveCompetitionId(code: CompetitionCode): Promise<Result<number, AflApiError | ValidationError>>;
+	/**
+	* Resolve a season (compseason) ID from a competition ID and year.
+	*
+	* @param competitionId - The competition ID (from {@link resolveCompetitionId}).
+	* @param year - The season year (e.g. 2024).
+	* @returns The compseason ID string on success.
+	*/
+	resolveSeasonId(competitionId: number, year: number): Promise<Result<number, AflApiError | ValidationError>>;
+	/**
+	* Resolve a season ID from a competition code and year in one step.
+	*
+	* @param code - The competition code (e.g. "AFLM").
+	* @param year - The season year (e.g. 2025).
+	* @returns The compseason ID on success.
+	*/
+	resolveCompSeason(code: CompetitionCode, year: number): Promise<Result<number, AflApiError | ValidationError>>;
+	/**
+	* Fetch all rounds for a season with their metadata.
+	*
+	* @param seasonId - The compseason ID (from {@link resolveSeasonId}).
+	* @returns Array of round objects on success.
+	*/
+	resolveRounds(seasonId: number): Promise<Result<Round[], AflApiError | ValidationError>>;
+	/**
+	* Fetch match items for a round using the /cfs/ endpoint.
+	*
+	* @param roundProviderId - The round provider ID (e.g. "CD_R202501401").
+	* @returns Array of match items on success.
+	*/
+	fetchRoundMatchItems(roundProviderId: string): Promise<Result<MatchItem[], AflApiError | ValidationError>>;
+	/**
+	* Fetch match items for a round by resolving the round provider ID from season and round number.
+	*
+	* @param seasonId - The compseason ID.
+	* @param roundNumber - The round number.
+	* @returns Array of match items on success.
+	*/
+	fetchRoundMatchItemsByNumber(seasonId: number, roundNumber: number): Promise<Result<MatchItem[], AflApiError | ValidationError>>;
+	/**
+	* Fetch match items for all completed rounds in a season.
+	*
+	* @param seasonId - The compseason ID.
+	* @returns Aggregated array of match items from all completed rounds.
+	*/
+	fetchSeasonMatchItems(seasonId: number): Promise<Result<MatchItem[], AflApiError | ValidationError>>;
+	/**
+	* Fetch per-player statistics for a match.
+	*
+	* @param matchProviderId - The match provider ID (e.g. "CD_M20250140101").
+	* @returns Player stats list with home and away arrays.
+	*/
+	fetchPlayerStats(matchProviderId: string): Promise<Result<PlayerStatsList, AflApiError | ValidationError>>;
+	/**
+	* Fetch match roster (lineup) for a match.
+	*
+	* @param matchProviderId - The match provider ID (e.g. "CD_M20250140101").
+	* @returns Match roster with team players.
+	*/
+	fetchMatchRoster(matchProviderId: string): Promise<Result<MatchRoster, AflApiError | ValidationError>>;
+	/**
+	* Fetch team list, optionally filtered by team type.
+	*
+	* @param teamType - Optional filter (e.g. "MEN", "WOMEN").
+	* @returns Array of team items.
+	*/
+	fetchTeams(teamType?: string): Promise<Result<TeamItem[], AflApiError | ValidationError>>;
+	/**
+	* Fetch squad (roster) for a team in a specific season.
+	*
+	* @param teamId - The numeric team ID.
+	* @param compSeasonId - The compseason ID.
+	* @returns Squad list response.
+	*/
+	fetchSquad(teamId: number, compSeasonId: number): Promise<Result<SquadList, AflApiError | ValidationError>>;
+	/**
+	* Fetch ladder standings for a season (optionally for a specific round).
+	*
+	* @param seasonId - The compseason ID.
+	* @param roundId - Optional round ID (numeric `id`, not `providerId`).
+	* @returns Ladder response with entries.
+	*/
+	fetchLadder(seasonId: number, roundId?: number): Promise<Result<LadderResponse, AflApiError | ValidationError>>;
+}
+/** Options for constructing an AFL Tables client. */
+interface AflTablesClientOptions {
+	readonly fetchFn?: typeof fetch | undefined;
+}
+/**
+* AFL Tables scraper client.
+*/
+declare class AflTablesClient {
+	private readonly fetchFn;
+	constructor(options?: AflTablesClientOptions);
+	/**
+	* Fetch season match results from AFL Tables.
+	*
+	* @param year - The season year (1897 to present).
+	* @returns Array of match results.
+	*/
+	fetchSeasonResults(year: number): Promise<Result<MatchResult[], ScrapeError>>;
+}
+/** Options for constructing a FootyWire client. */
+interface FootyWireClientOptions {
+	readonly fetchFn?: typeof fetch | undefined;
+}
+/**
+* FootyWire scraper client.
+*/
+declare class FootyWireClient {
+	private readonly fetchFn;
+	constructor(options?: FootyWireClientOptions);
+	/**
+	* Fetch the HTML content of a FootyWire page.
+	*/
+	private fetchHtml;
+	/**
+	* Fetch season match results from FootyWire.
+	*
+	* @param year - The season year.
+	* @returns Array of match results.
+	*/
+	fetchSeasonResults(year: number): Promise<Result<MatchResult[], ScrapeError>>;
+}
+/**
+* Attempt to fetch advanced player statistics from Fryzigg.
+*
+* @returns Always returns an error Result explaining that Fryzigg is
+* not supported in the TypeScript port.
+*/
+declare function fetchFryziggStats(): Result<PlayerStats[], ScrapeError>;
+/**
+* Transform raw AFL API ladder entries into typed LadderEntry objects.
+*
+* @param entries - Raw ladder entries from the API response.
+* @returns Array of typed ladder entries.
+*/
+declare function transformLadderEntries(entries: readonly LadderEntryRaw[]): LadderEntry[];
+/**
+* Transform a raw match roster into a typed Lineup object.
+*
+* @param roster - Raw match roster from the /cfs/ endpoint.
+* @param season - The season year.
+* @param roundNumber - The round number.
+* @param competition - The competition code.
+* @returns Typed Lineup with normalised team names and player lists.
+*/
+declare function transformMatchRoster(roster: MatchRoster, season: number, roundNumber: number, competition: CompetitionCode): Lineup;
+/** Infer RoundType from a round name string. */
+declare function inferRoundType(roundName: string): RoundType;
+/**
+* Transform raw AFL API match items into typed MatchResult objects.
+*
+* @param items - Raw match items from the /cfs/ endpoint.
+* @param season - The season year for these matches.
+* @param competition - The competition code.
+* @returns Flattened, normalised MatchResult array.
+*/
+declare function transformMatchItems(items: readonly MatchItem[], season: number, competition: CompetitionCode, source?: DataSource): MatchResult[];
+/**
+* Transform raw AFL API player stats list into typed PlayerStats objects.
+*
+* @param data - Raw player stats response with home/away arrays.
+* @param matchId - The match provider ID.
+* @param season - The season year.
+* @param roundNumber - The round number.
+* @param competition - The competition code.
+* @returns Flattened PlayerStats array (home players first, then away).
+*/
+declare function transformPlayerStats(data: PlayerStatsList, matchId: string, season: number, roundNumber: number, competition: CompetitionCode, source?: DataSource, teamIdMap?: ReadonlyMap<string, string>): PlayerStats[];
+export { transformPlayerStats, transformMatchRoster, transformMatchItems, transformLadderEntries, toAestString, parseFootyWireDate, parseAflTablesDate, parseAflApiDate, ok, normaliseTeamName, inferRoundType, fetchTeams2 as fetchTeams, fetchSquad2 as fetchSquad, fetchPlayerStats2 as fetchPlayerStats, fetchMatchResults, fetchLineup, fetchLadder2 as fetchLadder, fetchFryziggStats, fetchFixture, err, ValidationError, UnsupportedSourceError, TeamScoreSchema, TeamScore, TeamQuery, TeamPlayersSchema, TeamPlayers, TeamListSchema, TeamList, TeamItemSchema, TeamItem, Team, SquadSchema, SquadQuery, SquadPlayerItemSchema, SquadPlayerItem, SquadPlayerInnerSchema, SquadPlayer, SquadListSchema, SquadList, Squad, SeasonRoundQuery, ScrapeError, ScoreSchema, Score, RoundType, RoundSchema, RoundListSchema, RoundList, Round, RosterPlayerSchema, RosterPlayer, Result, QuarterScore, PlayerStatsQuery, PlayerStatsListSchema, PlayerStatsList, PlayerStatsItemSchema, PlayerStatsItem, PlayerStats, PlayerGameStatsSchema, PlayerGameStats, 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, CfsVenueSchema, CfsVenue, CfsScoreSchema, CfsScore, CfsMatchTeamSchema, CfsMatchTeam, CfsMatchSchema, CfsMatch, AflTablesClientOptions, AflTablesClient, AflApiTokenSchema, AflApiToken, AflApiError, AflApiClientOptions, AflApiClient };