pitchapi 0.1.1

package/dist/index.d.ts

@@ -0,0 +1,2021 @@
+/**
+ * This file was auto-generated by openapi-typescript.
+ * Do not make direct changes to the file.
+ */
+interface paths {
+    "/date/{date}": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /** All matches on a given day */
+        get: operations["getMatchesByDate"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/matches/{id}": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /** Match summary */
+        get: operations["getMatch"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/matches/{id}/shots": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /** Every shot with pitch coordinates and xG */
+        get: operations["getMatchShots"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/matches/{id}/shots/{sid}": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /** A single shot */
+        get: operations["getShot"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/matches/{id}/events": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /** Match events (goals, cards, subs, ...) */
+        get: operations["getMatchEvents"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/matches/{id}/lineups": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /** Starting lineups and substitutes */
+        get: operations["getMatchLineups"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/matches/{id}/momentum": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /** Possession-momentum timeline */
+        get: operations["getMatchMomentum"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/matches/{id}/stats": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /** Team-level match statistics */
+        get: operations["getMatchStats"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/matches/{id}/players": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Per-player match stats
+         * @description Stat groups share one shape across leagues. Leagues served without a player rating carry none; for the few competitions where match statistics are unavailable (Latvia's Virsliga, Venezuela's Primera División) the lines are derived from the match events and stats the events cannot reproduce (chances created, final-third passes) are omitted rather than zero.
+         */
+        get: operations["getMatchPlayers"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/matches/{id}/players/halves": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Per-player stats for each half
+         * @description Every player's stat line for the first and the second half. Each half's `stats` has the shape of `/matches/{id}/players`, though not every stat is available per half (the rating is match-level only). A player lists only the halves they took part in. Extra time belongs to neither half, and the halves need not add up exactly to `/matches/{id}/players`. Returns `404 HALVES_UNAVAILABLE` for a match we hold without per-half player stats.
+         */
+        get: operations["getMatchPlayerHalves"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/matches/{id}/players/{pid}": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /** Individual player detail */
+        get: operations["getMatchPlayer"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/matches/{id}/players/{pid}/halves": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * One player's stats for each half
+         * @description The halves of one player, in the shape of an entry of `/matches/{id}/players/halves`. `RESOURCE_NOT_FOUND` for a player who took no part in a match that has halves; `HALVES_UNAVAILABLE` for a match that has none.
+         */
+        get: operations["getMatchPlayerHalf"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/matches/{id}/players/{pid}/shots": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /** A single player's shots */
+        get: operations["getMatchPlayerShots"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/matches/{id}/h2h": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /** Head-to-head history */
+        get: operations["getMatchH2H"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/matches/{id}/advanced": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Advanced team analytics (PPDA, field tilt, xG timeline)
+         * @description Returns `404 ANALYTICS_UNAVAILABLE` for a match whose analytics have not been computed.
+         */
+        get: operations["getMatchAdvanced"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/matches/{id}/advanced/network": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /** Pass networks */
+        get: operations["getMatchAdvancedNetwork"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/matches/{id}/advanced/players": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /** Player-level advanced rollups */
+        get: operations["getMatchAdvancedPlayers"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/matches/{id}/advanced/players/{pid}": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /** One player's advanced rollup */
+        get: operations["getMatchAdvancedPlayer"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/matches/{id}/heatmaps": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /** Binned activity grids per team and player */
+        get: operations["getMatchHeatmaps"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/leagues": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /** All leagues */
+        get: operations["listLeagues"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/leagues/{id}": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /** League detail */
+        get: operations["getLeague"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/leagues/{id}/matches": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /** Matches in a league season */
+        get: operations["getLeagueMatches"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/teams/{id}": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /** Team profile */
+        get: operations["getTeam"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/players/{id}": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /** Player profile */
+        get: operations["getPlayer"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+}
+interface components {
+    schemas: {
+        ErrorEnvelope: {
+            error: {
+                /** @enum {string} */
+                code: "INVALID_PARAMETER" | "UNAUTHORIZED" | "SUBSCRIPTION_SUSPENDED" | "PLAN_UPGRADE_REQUIRED" | "RESOURCE_NOT_FOUND" | "ANALYTICS_UNAVAILABLE" | "HALVES_UNAVAILABLE" | "RATE_LIMIT_EXCEEDED" | "INTERNAL_SERVER_ERROR";
+                message: string;
+            };
+        };
+        LeagueRef: {
+            id: string;
+            name: string;
+            image_url?: string | null;
+        };
+        TeamRef: {
+            id: string;
+            name: string;
+            image_url?: string | null;
+        };
+        TeamNameRef: {
+            id: string;
+            name: string;
+        };
+        PlayerRef: {
+            id: string;
+            name: string;
+            position_id?: number | null;
+            image_url?: string | null;
+        };
+        AdvancedPlayerRef: {
+            id: string;
+            name: string;
+            shirt_number?: number | null;
+        };
+        CoachRef: {
+            name: string;
+        };
+        Match: {
+            id: string;
+            league: components["schemas"]["LeagueRef"];
+            /** @description Season of this match */
+            season?: string | null;
+            home_team: components["schemas"]["TeamRef"];
+            away_team: components["schemas"]["TeamRef"];
+            date?: string | null;
+            /** Format: date-time */
+            time_utc?: string | null;
+            status?: string | null;
+            score_home?: number | null;
+            score_away?: number | null;
+            round_name?: string | null;
+            has_playoff: boolean;
+            referee?: string | null;
+            stadium?: string | null;
+        };
+        MatchSummary: {
+            id: string;
+            league: components["schemas"]["LeagueRef"];
+            home_team: components["schemas"]["TeamRef"];
+            away_team: components["schemas"]["TeamRef"];
+            /** Format: date-time */
+            time_utc?: string | null;
+            status?: string | null;
+            score_home?: number | null;
+            score_away?: number | null;
+        };
+        DateMatches: {
+            /** Format: date */
+            date: string;
+            matches: components["schemas"]["MatchSummary"][];
+        };
+        Shot: {
+            id: string;
+            player: components["schemas"]["PlayerRef"];
+            team_id: string;
+            x: number;
+            y: number;
+            expected_goals: number;
+            expected_goals_on_target?: number | null;
+            is_on_target: boolean;
+            goal_crossed_y?: number | null;
+            goal_crossed_z?: number | null;
+            is_inside_box: boolean;
+            shot_type: string;
+            situation: string;
+            minute: number;
+            event_type: string;
+            is_blocked?: boolean;
+            blocked_x?: number | null;
+            blocked_y?: number | null;
+            is_own_goal?: boolean;
+            is_saved_off_line?: boolean;
+            minute_added?: number | null;
+            keeper?: components["schemas"]["PlayerRef"] | null;
+        };
+        ShotPeriod: {
+            period: string;
+            shots: components["schemas"]["Shot"][];
+        };
+        Shots: {
+            match_id: string;
+            periods: components["schemas"]["ShotPeriod"][];
+        };
+        PlayerShots: {
+            player: components["schemas"]["PlayerRef"];
+            shots: components["schemas"]["Shot"][];
+        };
+        Event: {
+            event_type: string;
+            minute: number;
+            minute_added: number;
+            period: string;
+            team_id?: string;
+            player?: components["schemas"]["PlayerRef"];
+            sub_in_player?: components["schemas"]["PlayerRef"];
+            score_home?: number | null;
+            score_away?: number | null;
+            is_own_goal: boolean;
+            is_penalty: boolean;
+        };
+        Events: {
+            match_id: string;
+            events: components["schemas"]["Event"][];
+        };
+        LineupPlayer: {
+            player_id: string;
+            name: string;
+            shirt_number: string;
+            position_id: number;
+            is_captain: boolean;
+            pitch_x: number;
+            pitch_y: number;
+        };
+        LineupSide: {
+            formation: string;
+            /** @description False while this is the pre-match predicted lineup, true once the real one is published. Branch on this before trusting an upcoming fixture's XI. */
+            confirmed: boolean;
+            /**
+             * @description The source's own label for a prediction, e.g. `lastStarting11`. Omitted entirely for a confirmed lineup.
+             * @example lastStarting11
+             */
+            lineup_type?: string;
+            coach?: components["schemas"]["CoachRef"];
+            starters: components["schemas"]["LineupPlayer"][];
+            subs: components["schemas"]["LineupPlayer"][];
+        };
+        Lineups: {
+            match_id: string;
+            home_team: components["schemas"]["TeamRef"];
+            away_team: components["schemas"]["TeamRef"];
+            home: components["schemas"]["LineupSide"];
+            away: components["schemas"]["LineupSide"];
+        };
+        MomentumPoint: {
+            minute: number;
+            value: number;
+        };
+        /** @description The momentum timeline. Matches from the 33 leagues served without one have none: points is an empty array. */
+        Momentum: {
+            match_id: string;
+            points: components["schemas"]["MomentumPoint"][];
+        };
+        MatchStatItem: {
+            title: string;
+            key: string;
+            home: string;
+            away: string;
+            format_type: string;
+        };
+        MatchStatGroup: {
+            group_name: string;
+            items: components["schemas"]["MatchStatItem"][];
+        };
+        MatchStatPeriod: {
+            period: string;
+            groups: components["schemas"]["MatchStatGroup"][];
+        };
+        MatchStats: {
+            match_id: string;
+            home_team: components["schemas"]["TeamRef"];
+            away_team: components["schemas"]["TeamRef"];
+            periods: components["schemas"]["MatchStatPeriod"][];
+        };
+        PlayerMatchStats: {
+            player: components["schemas"]["PlayerRef"];
+            team_id: string;
+            /** @description Raw stat line; shape varies by position. */
+            stats: {
+                [key: string]: unknown;
+            };
+        };
+        PlayerDetail: {
+            player: components["schemas"]["PlayerRef"];
+            team_id: string;
+            position_id?: number | null;
+            stats: {
+                [key: string]: unknown;
+            };
+        };
+        PlayerHalfStats: {
+            /** @enum {string} */
+            period: "FirstHalf" | "SecondHalf";
+            /** @description The half's stat line, grouped as in PlayerMatchStats. */
+            stats: {
+                [key: string]: unknown;
+            }[];
+        };
+        PlayerHalves: {
+            player: components["schemas"]["PlayerRef"];
+            team_id: string;
+            /** @description Only the halves the player took part in, first half first. */
+            periods: components["schemas"]["PlayerHalfStats"][];
+        };
+        MatchPlayerHalves: {
+            match_id: string;
+            players: components["schemas"]["PlayerHalves"][];
+        };
+        PlayerHalfDetail: {
+            match_id: string;
+            player: components["schemas"]["PlayerRef"];
+            team_id: string;
+            periods: components["schemas"]["PlayerHalfStats"][];
+        };
+        H2HMatch: {
+            /** Format: date-time */
+            time_utc?: string | null;
+            home: components["schemas"]["TeamRef"];
+            away: components["schemas"]["TeamRef"];
+            score_home?: number | null;
+            score_away?: number | null;
+            finished: boolean;
+        };
+        H2H: {
+            match_id: string;
+            home_team: components["schemas"]["TeamRef"];
+            away_team: components["schemas"]["TeamRef"];
+            home_wins: number;
+            draws: number;
+            away_wins: number;
+            total_matches: number;
+            recent_matches: components["schemas"]["H2HMatch"][];
+        };
+        League: {
+            id: string;
+            name: string;
+            country_code: string;
+            season: string;
+            image_url?: string;
+        };
+        LeagueSummary: {
+            id: string;
+            name: string;
+            country_code: string;
+            image_url?: string | null;
+            seasons: string[];
+            is_free: boolean;
+        };
+        LeagueSeasonRef: {
+            id: string;
+            name: string;
+            season: string;
+            image_url?: string;
+        };
+        LeagueMatchSummary: {
+            id: string;
+            date?: string | null;
+            /** Format: date-time */
+            time_utc?: string | null;
+            status?: string | null;
+            home_team: components["schemas"]["TeamRef"];
+            away_team: components["schemas"]["TeamRef"];
+            score_home?: number | null;
+            score_away?: number | null;
+        };
+        LeagueMatches: {
+            league: components["schemas"]["LeagueSeasonRef"];
+            matches: components["schemas"]["LeagueMatchSummary"][];
+        };
+        Team: {
+            id: string;
+            name: string;
+            image_url?: string;
+        };
+        PlayerProfile: {
+            id: string;
+            name: string;
+            short_name?: string;
+            shirt_number?: string;
+            position_id?: number | null;
+            country_code?: string;
+            image_url?: string;
+        };
+        /** @description Null as a whole object when no model ran; members omitted when their model did not run. */
+        PossessionValue: {
+            xt_total?: number | null;
+            vaep_total?: number | null;
+            vaep_offensive?: number | null;
+            vaep_defensive?: number | null;
+            pv_total?: number | null;
+            pv_offensive?: number | null;
+            pv_defensive?: number | null;
+        };
+        /** @description `passes` already includes `crosses`; never sum the two. */
+        PassingStats: {
+            passes?: number;
+            pass_accuracy?: number | null;
+            progressive_passes?: number;
+            progressive_pass_distance?: number;
+            passes_into_box?: number;
+            key_passes?: number;
+            assists?: number;
+            through_balls?: number;
+            crosses?: number;
+            switches?: number;
+        };
+        CarryingStats: {
+            carries?: number;
+            carry_distance?: number;
+            progressive_carries?: number;
+            progressive_carry_distance?: number;
+            carries_into_final_third?: number;
+            carries_into_box?: number;
+            take_ons?: number;
+            take_ons_won?: number;
+            miscontrols?: number;
+            dispossessed?: number;
+        };
+        TeamSCABreakdown: {
+            pass_live?: number;
+            pass_dead?: number;
+            take_on?: number;
+            shot?: number;
+            foul_drawn?: number;
+            defensive?: number;
+        };
+        /** @description `chances_created` equals `passing.key_passes`; never sum them. */
+        TeamCreation: {
+            sca?: number;
+            gca?: number;
+            chances_created?: number;
+            second_assists?: number;
+            sca_breakdown?: components["schemas"]["TeamSCABreakdown"];
+            xag?: number | null;
+        };
+        PlayerSCABreakdown: {
+            pass_live?: number;
+            pass_dead?: number;
+            take_on?: number;
+            shot?: number;
+            defensive?: number;
+        };
+        PlayerCreation: {
+            sca?: number;
+            gca?: number;
+            chances_created?: number;
+            second_assists?: number;
+            sca_breakdown?: components["schemas"]["PlayerSCABreakdown"];
+            /** @description xG of shots this player's passes created (not xA). */
+            xag?: number | null;
+            xg_chain?: number | null;
+            /** @description Always <= xg_chain. */
+            xg_buildup?: number | null;
+        };
+        PlayerDefending: {
+            tackles?: number;
+            interceptions?: number;
+            blocks?: number;
+            clearances?: number;
+            duels_won?: number;
+            aerials?: number;
+            aerials_won?: number;
+        };
+        /** @description Flattens PlayerDefending plus team-only pressing/transition measures. */
+        TeamDefending: {
+            tackles?: number;
+            interceptions?: number;
+            blocks?: number;
+            clearances?: number;
+            duels_won?: number;
+            aerials?: number;
+            aerials_won?: number;
+            ppda?: number | null;
+            opponent_passes?: number;
+            defensive_actions?: number;
+            challenges?: number;
+            avg_defensive_action_x?: number | null;
+            high_turnovers?: number;
+            counterpress_regains_5s?: number;
+            ball_recovery_time?: number | null;
+        };
+        TerritoryStats: {
+            possession_pct?: number | null;
+            field_tilt?: number | null;
+            final_third_entries?: number;
+            box_entries?: number;
+            avg_action_x?: number | null;
+        };
+        TempoStats: {
+            passes_per_sequence?: number | null;
+            sequence_time?: number | null;
+            direct_speed?: number | null;
+            buildup_attacks?: number;
+            direct_attacks?: number;
+        };
+        /** @description Present only for the two starting keepers. */
+        Goalkeeping: {
+            claims?: number;
+            claims_won?: number;
+            claim_rate?: number | null;
+            sweeper_actions?: number;
+            distributions?: number;
+            launches?: number;
+            launch_pct?: number | null;
+            avg_pass_length?: number | null;
+            distribution_accuracy?: number | null;
+        };
+        AdvancedTeamStat: {
+            team: components["schemas"]["TeamNameRef"];
+            actions: number;
+            possession_value?: components["schemas"]["PossessionValue"] | null;
+            passing?: components["schemas"]["PassingStats"];
+            carrying?: components["schemas"]["CarryingStats"];
+            creation?: components["schemas"]["TeamCreation"];
+            defending?: components["schemas"]["TeamDefending"];
+            territory?: components["schemas"]["TerritoryStats"];
+            tempo?: components["schemas"]["TempoStats"];
+        };
+        AdvancedTeams: {
+            match_id: string;
+            teams: components["schemas"]["AdvancedTeamStat"][];
+        };
+        AdvancedPlayerStat: {
+            player: components["schemas"]["AdvancedPlayerRef"];
+            team_id: string;
+            minutes_played?: number | null;
+            actions: number;
+            possession_value?: components["schemas"]["PossessionValue"] | null;
+            passing?: components["schemas"]["PassingStats"];
+            carrying?: components["schemas"]["CarryingStats"];
+            creation?: components["schemas"]["PlayerCreation"];
+            defending?: components["schemas"]["PlayerDefending"];
+            goalkeeping?: components["schemas"]["Goalkeeping"] | null;
+        };
+        AdvancedPlayers: {
+            match_id: string;
+            /** @description Ordering used; falls back to "actions" when VAEP did not run. */
+            sorted_by: string;
+            players: components["schemas"]["AdvancedPlayerStat"][];
+        };
+        NetworkWindow: {
+            kind: string;
+            /** @description Null when the network covers the full match. */
+            until_seconds?: number | null;
+        };
+        PassNetworkNode: {
+            player: components["schemas"]["AdvancedPlayerRef"];
+            /** @description Mean location the player passed FROM. */
+            avg_x?: number | null;
+            avg_y?: number | null;
+            passes: number;
+            passes_received: number;
+            degree?: number | null;
+            strength?: number | null;
+            betweenness?: number | null;
+            clustering?: number | null;
+        };
+        PassNetworkEdge: {
+            from: components["schemas"]["AdvancedPlayerRef"];
+            to: components["schemas"]["AdvancedPlayerRef"];
+            passes: number;
+        };
+        PassNetwork: {
+            team: components["schemas"]["TeamNameRef"];
+            window: components["schemas"]["NetworkWindow"];
+            /** @description Null when the graph had no edges. */
+            centralization?: number | null;
+            nodes: components["schemas"]["PassNetworkNode"][];
+            edges: components["schemas"]["PassNetworkEdge"][];
+        };
+        AdvancedNetworks: {
+            match_id: string;
+            networks: components["schemas"]["PassNetwork"][];
+        };
+        /** @description The frame the cells are counted in. Without it the cells are unreadable: cell_x 0 is not "the left end of the pitch", it is the acting team's own goal line, in both halves. */
+        HeatmapGrid: {
+            /** @description Cells from goal line to goal line. Always 16. */
+            length: number;
+            /** @description Cells from touchline to touchline. Always 12. */
+            width: number;
+            /**
+             * @description The orientation actually served, echoed so a response is self-describing whether or not the request named one. In `acting_ltr`, cell_x 0 is the acting team's own goal line and 15 the opponent's, for both teams and in both halves — the same direction normalisation the shot coordinates use. In `home_ltr` the away side's cells are already turned onto the shared pitch.
+             * @enum {string}
+             */
+            frame: "acting_ltr" | "home_ltr";
+            /** @description Cell length in metres on the 105 x 68 pitch. */
+            cell_length_m: number;
+            /** @description Cell width in metres. */
+            cell_width_m: number;
+        };
+        /** @description Sparse [cell_x, cell_y, actions] triples. A cell with no activity is absent rather than zero, which is most of the 192 — expand to a dense grid client-side if you need one. Empty array, never null. */
+        HeatmapCells: number[][];
+        TeamHeatmap: {
+            team: components["schemas"]["TeamNameRef"];
+            /**
+             * @description Cells are in this team's own attacking frame either way; the side is what lets you mirror one of them to draw both on a single pitch.
+             * @enum {string}
+             */
+            side: "home" | "away";
+            actions: number;
+            cells: components["schemas"]["HeatmapCells"];
+        };
+        PlayerHeatmap: {
+            player: components["schemas"]["AdvancedPlayerRef"];
+            team: components["schemas"]["TeamNameRef"];
+            /**
+             * @description The player's team's side, repeated so a caller iterating players alone can orient them.
+             * @enum {string}
+             */
+            side: "home" | "away";
+            /** @description A raw count for the match, not per-90. A substitute's grid is thinner than a starter's for reasons that are about minutes rather than involvement. */
+            actions: number;
+            cells: components["schemas"]["HeatmapCells"];
+        };
+        /** @description Binned activity for one match: each team's own grid plus one grid per player who touched the ball. Match level only — there is no season or cross-match aggregate behind this. */
+        MatchHeatmaps: {
+            match_id: string;
+            grid: components["schemas"]["HeatmapGrid"];
+            /** @description Both teams, home first. */
+            teams: components["schemas"]["TeamHeatmap"][];
+            /** @description Ordered by involvement, busiest first. */
+            players: components["schemas"]["PlayerHeatmap"][];
+        };
+    };
+    responses: {
+        /** @description A malformed ID, date, or season (`INVALID_PARAMETER`). */
+        InvalidParameter: {
+            headers: {
+                [name: string]: unknown;
+            };
+            content: {
+                "application/json": components["schemas"]["ErrorEnvelope"];
+            };
+        };
+        /** @description Missing, malformed, or revoked key (`UNAUTHORIZED`), or a suspended subscription (`SUBSCRIPTION_SUSPENDED`). */
+        Unauthorized: {
+            headers: {
+                [name: string]: unknown;
+            };
+            content: {
+                "application/json": components["schemas"]["ErrorEnvelope"];
+            };
+        };
+        /** @description The resource's league is not on the free tier (`PLAN_UPGRADE_REQUIRED`). */
+        PlanUpgradeRequired: {
+            headers: {
+                [name: string]: unknown;
+            };
+            content: {
+                "application/json": components["schemas"]["ErrorEnvelope"];
+            };
+        };
+        /** @description Resource does not exist (`RESOURCE_NOT_FOUND`), analytics not yet computed (`ANALYTICS_UNAVAILABLE`), or no per-half player stats for the match (`HALVES_UNAVAILABLE`). */
+        NotFound: {
+            headers: {
+                [name: string]: unknown;
+            };
+            content: {
+                "application/json": components["schemas"]["ErrorEnvelope"];
+            };
+        };
+        /** @description Per-user fair-use ceiling exceeded (`RATE_LIMIT_EXCEEDED`). */
+        RateLimited: {
+            headers: {
+                /** @description Seconds to wait before retrying. */
+                "Retry-After"?: number;
+                [name: string]: unknown;
+            };
+            content: {
+                "application/json": components["schemas"]["ErrorEnvelope"];
+            };
+        };
+    };
+    parameters: {
+        MatchId: string;
+        ShotId: string;
+        PlayerId: string;
+        PlayerProfileId: string;
+        LeagueId: string;
+        TeamId: string;
+        /** @description Calendar day in `YYYY-MM-DD`. */
+        Date: string;
+        /** @description Which fixtures to return. `played` covers matches that have kicked off, `upcoming` future fixtures (a kickoff `time_utc` and a `status`, but no score yet), and `all` both. Omitting the parameter is the same as `played`; sending it empty is rejected. */
+        MatchStatus: "played" | "upcoming" | "all";
+    };
+    requestBodies: never;
+    headers: never;
+    pathItems: never;
+}
+interface operations {
+    getMatchesByDate: {
+        parameters: {
+            query?: {
+                /** @description Which fixtures to return. `played` covers matches that have kicked off, `upcoming` future fixtures (a kickoff `time_utc` and a `status`, but no score yet), and `all` both. Omitting the parameter is the same as `played`; sending it empty is rejected. */
+                status?: components["parameters"]["MatchStatus"];
+            };
+            header?: never;
+            path: {
+                /** @description Calendar day in `YYYY-MM-DD`. */
+                date: components["parameters"]["Date"];
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Matches for the day */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        data?: components["schemas"]["DateMatches"];
+                    };
+                };
+            };
+            400: components["responses"]["InvalidParameter"];
+            401: components["responses"]["Unauthorized"];
+            429: components["responses"]["RateLimited"];
+        };
+    };
+    getMatch: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                id: components["parameters"]["MatchId"];
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Match summary */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        data?: components["schemas"]["Match"];
+                    };
+                };
+            };
+            400: components["responses"]["InvalidParameter"];
+            401: components["responses"]["Unauthorized"];
+            403: components["responses"]["PlanUpgradeRequired"];
+            404: components["responses"]["NotFound"];
+            429: components["responses"]["RateLimited"];
+        };
+    };
+    getMatchShots: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                id: components["parameters"]["MatchId"];
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Shots grouped by period */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        data?: components["schemas"]["Shots"];
+                    };
+                };
+            };
+            400: components["responses"]["InvalidParameter"];
+            401: components["responses"]["Unauthorized"];
+            403: components["responses"]["PlanUpgradeRequired"];
+            429: components["responses"]["RateLimited"];
+        };
+    };
+    getShot: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                id: components["parameters"]["MatchId"];
+                sid: components["parameters"]["ShotId"];
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Shot detail */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        data?: components["schemas"]["Shot"];
+                    };
+                };
+            };
+            400: components["responses"]["InvalidParameter"];
+            401: components["responses"]["Unauthorized"];
+            403: components["responses"]["PlanUpgradeRequired"];
+            404: components["responses"]["NotFound"];
+            429: components["responses"]["RateLimited"];
+        };
+    };
+    getMatchEvents: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                id: components["parameters"]["MatchId"];
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Events */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        data?: components["schemas"]["Events"];
+                    };
+                };
+            };
+            401: components["responses"]["Unauthorized"];
+            403: components["responses"]["PlanUpgradeRequired"];
+            429: components["responses"]["RateLimited"];
+        };
+    };
+    getMatchLineups: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                id: components["parameters"]["MatchId"];
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Lineups */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        data?: components["schemas"]["Lineups"];
+                    };
+                };
+            };
+            401: components["responses"]["Unauthorized"];
+            403: components["responses"]["PlanUpgradeRequired"];
+            404: components["responses"]["NotFound"];
+            429: components["responses"]["RateLimited"];
+        };
+    };
+    getMatchMomentum: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                id: components["parameters"]["MatchId"];
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Momentum */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        data?: components["schemas"]["Momentum"];
+                    };
+                };
+            };
+            401: components["responses"]["Unauthorized"];
+            403: components["responses"]["PlanUpgradeRequired"];
+            429: components["responses"]["RateLimited"];
+        };
+    };
+    getMatchStats: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                id: components["parameters"]["MatchId"];
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Team stats */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        data?: components["schemas"]["MatchStats"];
+                    };
+                };
+            };
+            401: components["responses"]["Unauthorized"];
+            403: components["responses"]["PlanUpgradeRequired"];
+            404: components["responses"]["NotFound"];
+            429: components["responses"]["RateLimited"];
+        };
+    };
+    getMatchPlayers: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                id: components["parameters"]["MatchId"];
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Player stat lines */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        data?: components["schemas"]["PlayerMatchStats"][];
+                    };
+                };
+            };
+            401: components["responses"]["Unauthorized"];
+            403: components["responses"]["PlanUpgradeRequired"];
+            429: components["responses"]["RateLimited"];
+        };
+    };
+    getMatchPlayerHalves: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                id: components["parameters"]["MatchId"];
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Player halves */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        data?: components["schemas"]["MatchPlayerHalves"];
+                    };
+                };
+            };
+            401: components["responses"]["Unauthorized"];
+            403: components["responses"]["PlanUpgradeRequired"];
+            404: components["responses"]["NotFound"];
+            429: components["responses"]["RateLimited"];
+        };
+    };
+    getMatchPlayer: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                id: components["parameters"]["MatchId"];
+                pid: components["parameters"]["PlayerId"];
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Player detail */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        data?: components["schemas"]["PlayerDetail"];
+                    };
+                };
+            };
+            401: components["responses"]["Unauthorized"];
+            403: components["responses"]["PlanUpgradeRequired"];
+            404: components["responses"]["NotFound"];
+            429: components["responses"]["RateLimited"];
+        };
+    };
+    getMatchPlayerHalf: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                id: components["parameters"]["MatchId"];
+                pid: components["parameters"]["PlayerId"];
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Player halves */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        data?: components["schemas"]["PlayerHalfDetail"];
+                    };
+                };
+            };
+            401: components["responses"]["Unauthorized"];
+            403: components["responses"]["PlanUpgradeRequired"];
+            404: components["responses"]["NotFound"];
+            429: components["responses"]["RateLimited"];
+        };
+    };
+    getMatchPlayerShots: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                id: components["parameters"]["MatchId"];
+                pid: components["parameters"]["PlayerId"];
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Player shots */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        data?: components["schemas"]["PlayerShots"];
+                    };
+                };
+            };
+            401: components["responses"]["Unauthorized"];
+            403: components["responses"]["PlanUpgradeRequired"];
+            429: components["responses"]["RateLimited"];
+        };
+    };
+    getMatchH2H: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                id: components["parameters"]["MatchId"];
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Head-to-head */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        data?: components["schemas"]["H2H"];
+                    };
+                };
+            };
+            401: components["responses"]["Unauthorized"];
+            403: components["responses"]["PlanUpgradeRequired"];
+            404: components["responses"]["NotFound"];
+            429: components["responses"]["RateLimited"];
+        };
+    };
+    getMatchAdvanced: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                id: components["parameters"]["MatchId"];
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Advanced team rollups */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        data?: components["schemas"]["AdvancedTeams"];
+                    };
+                };
+            };
+            401: components["responses"]["Unauthorized"];
+            403: components["responses"]["PlanUpgradeRequired"];
+            404: components["responses"]["NotFound"];
+            429: components["responses"]["RateLimited"];
+        };
+    };
+    getMatchAdvancedNetwork: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                id: components["parameters"]["MatchId"];
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Pass networks */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        data?: components["schemas"]["AdvancedNetworks"];
+                    };
+                };
+            };
+            401: components["responses"]["Unauthorized"];
+            403: components["responses"]["PlanUpgradeRequired"];
+            404: components["responses"]["NotFound"];
+            429: components["responses"]["RateLimited"];
+        };
+    };
+    getMatchAdvancedPlayers: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                id: components["parameters"]["MatchId"];
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Advanced player rollups */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        data?: components["schemas"]["AdvancedPlayers"];
+                    };
+                };
+            };
+            401: components["responses"]["Unauthorized"];
+            403: components["responses"]["PlanUpgradeRequired"];
+            404: components["responses"]["NotFound"];
+            429: components["responses"]["RateLimited"];
+        };
+    };
+    getMatchAdvancedPlayer: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                id: components["parameters"]["MatchId"];
+                pid: components["parameters"]["PlayerId"];
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Advanced player rollup */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        data?: components["schemas"]["AdvancedPlayerStat"];
+                    };
+                };
+            };
+            401: components["responses"]["Unauthorized"];
+            403: components["responses"]["PlanUpgradeRequired"];
+            404: components["responses"]["NotFound"];
+            429: components["responses"]["RateLimited"];
+        };
+    };
+    getMatchHeatmaps: {
+        parameters: {
+            query?: {
+                /** @description Orientation to serve the cells in. `acting_ltr` (the default) gives every team its own attacking frame, which is what makes a player comparable across home and away fixtures. `home_ltr` puts both teams on one pitch — the home side attacking cell_x 15, the away side 0 — which is what a match view needs. The server applies the turn, so there is nothing to mirror client-side. */
+                frame?: "acting_ltr" | "home_ltr";
+            };
+            header?: never;
+            path: {
+                id: components["parameters"]["MatchId"];
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Heatmaps */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        data?: components["schemas"]["MatchHeatmaps"];
+                    };
+                };
+            };
+            401: components["responses"]["Unauthorized"];
+            403: components["responses"]["PlanUpgradeRequired"];
+            404: components["responses"]["NotFound"];
+            429: components["responses"]["RateLimited"];
+        };
+    };
+    listLeagues: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description League list */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        data?: {
+                            leagues: components["schemas"]["LeagueSummary"][];
+                        };
+                    };
+                };
+            };
+            401: components["responses"]["Unauthorized"];
+            429: components["responses"]["RateLimited"];
+        };
+    };
+    getLeague: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                id: components["parameters"]["LeagueId"];
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description League detail */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        data?: components["schemas"]["League"];
+                    };
+                };
+            };
+            400: components["responses"]["InvalidParameter"];
+            401: components["responses"]["Unauthorized"];
+            403: components["responses"]["PlanUpgradeRequired"];
+            404: components["responses"]["NotFound"];
+            429: components["responses"]["RateLimited"];
+        };
+    };
+    getLeagueMatches: {
+        parameters: {
+            query?: {
+                /** @description Season selector — `2025/2026` for a fall-spring league, `2026` for a calendar-year one. Omitted, the latest season with data is used. */
+                season?: string;
+                /** @description Which fixtures to return. `played` covers matches that have kicked off, `upcoming` future fixtures (a kickoff `time_utc` and a `status`, but no score yet), and `all` both. Omitting the parameter is the same as `played`; sending it empty is rejected. */
+                status?: components["parameters"]["MatchStatus"];
+            };
+            header?: never;
+            path: {
+                id: components["parameters"]["LeagueId"];
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description League matches */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        data?: components["schemas"]["LeagueMatches"];
+                    };
+                };
+            };
+            400: components["responses"]["InvalidParameter"];
+            401: components["responses"]["Unauthorized"];
+            403: components["responses"]["PlanUpgradeRequired"];
+            429: components["responses"]["RateLimited"];
+        };
+    };
+    getTeam: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                id: components["parameters"]["TeamId"];
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Team profile */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        data?: components["schemas"]["Team"];
+                    };
+                };
+            };
+            400: components["responses"]["InvalidParameter"];
+            401: components["responses"]["Unauthorized"];
+            403: components["responses"]["PlanUpgradeRequired"];
+            404: components["responses"]["NotFound"];
+            429: components["responses"]["RateLimited"];
+        };
+    };
+    getPlayer: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                id: components["parameters"]["PlayerProfileId"];
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Player profile */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        data?: components["schemas"]["PlayerProfile"];
+                    };
+                };
+            };
+            400: components["responses"]["InvalidParameter"];
+            401: components["responses"]["Unauthorized"];
+            403: components["responses"]["PlanUpgradeRequired"];
+            404: components["responses"]["NotFound"];
+            429: components["responses"]["RateLimited"];
+        };
+    };
+}
+
+type FetchLike = (input: string, init?: RequestInit) => Promise<Response>;
+interface TransportOptions {
+    apiKey: string;
+    baseUrl: string;
+    timeoutMs: number;
+    maxRetries: number;
+    fetch: FetchLike;
+    sleep?: (ms: number) => Promise<void>;
+}
+type Query = Record<string, string | undefined>;
+declare class Transport {
+    private readonly opts;
+    private readonly headers;
+    private readonly sleep;
+    constructor(opts: TransportOptions);
+    get<T>(path: string, query?: Query, signal?: AbortSignal): Promise<T>;
+    private fetchOnce;
+}
+
+/**
+ * The PitchAPI client and its resource namespaces.
+ *
+ *     import { PitchAPI } from "pitchapi";
+ *     const client = new PitchAPI({ apiKey: "pk_live_..." });
+ *     const match = await client.matches.get("m_4DP2fy");
+ *
+ * Every method returns the `data` object of its endpoint, typed from the
+ * OpenAPI spec, so the reference at pitchapi.dev is the field-level reference
+ * for the SDK too.
+ */
+
+/** The `data` payload of an operation's 200 response. */
+type Data<Op extends keyof operations> = NonNullable<operations[Op]["responses"][200]["content"]["application/json"]["data"]>;
+type LeaguesList = Data<"listLeagues">;
+/**
+ * Which fixtures a match listing returns: `played` (the API's default) only
+ * matches that have kicked off, `upcoming` only future fixtures, `all` both.
+ */
+type MatchStatus = "played" | "upcoming" | "all";
+/**
+ * Heatmap orientation. `acting_ltr` (default) gives every team its own
+ * attacking frame; `home_ltr` puts both teams on one pitch. The server applies
+ * the turn, so there is nothing to mirror client-side.
+ */
+type HeatmapFrame = "acting_ltr" | "home_ltr";
+/** Per-call options accepted by every method. */
+interface RequestOptions {
+    /** Abort the request (and any pending retry) from the caller's side. */
+    signal?: AbortSignal;
+}
+interface PitchAPIOptions {
+    /**
+     * A `pk_live_` / `pk_test_` key. Falls back to the `PITCHAPI_API_KEY`
+     * environment variable. Keep it server-side, never in browser code.
+     */
+    apiKey?: string;
+    /** Override the API host (testing, proxies). Falls back to `PITCHAPI_BASE_URL`. */
+    baseUrl?: string;
+    /** Per-attempt timeout in milliseconds. Default 30000. */
+    timeoutMs?: number;
+    /** Replays on 429/5xx and network errors. `0` disables retries. Default 2. */
+    maxRetries?: number;
+    /** A custom `fetch` implementation. Defaults to the global one. */
+    fetch?: FetchLike;
+}
+declare abstract class Resource {
+    protected readonly t: Transport;
+    constructor(t: Transport);
+    protected request<T>(path: string, opts: RequestOptions | undefined, query?: Query): Promise<T>;
+}
+/** `/date` — the per-day match index. */
+declare class DateResource extends Resource {
+    /**
+     * Every match on a day. `date` is a `YYYY-MM-DD` string or a `Date`, which
+     * is read in UTC. An upcoming fixture carries a kickoff `time_utc` and a
+     * `status` but no score yet.
+     */
+    get(date: string | Date, opts?: {
+        status?: MatchStatus;
+    } & RequestOptions): Promise<Data<"getMatchesByDate">>;
+}
+/** `/matches` and all of its sub-routes. */
+declare class MatchesResource extends Resource {
+    /** Match summary — league, teams, score, referee, stadium. */
+    get(matchId: string, opts?: RequestOptions): Promise<Data<"getMatch">>;
+    /** Every shot, grouped by period, with pitch coordinates and xG. */
+    shots(matchId: string, opts?: RequestOptions): Promise<Data<"getMatchShots">>;
+    /** A single shot by its opaque ID. */
+    shot(matchId: string, shotId: string, opts?: RequestOptions): Promise<Data<"getShot">>;
+    /** Match events (goals, cards, subs, ...). */
+    events(matchId: string, opts?: RequestOptions): Promise<Data<"getMatchEvents">>;
+    /** Starting lineups and substitutes. Before kickoff the XI may be predicted. */
+    lineups(matchId: string, opts?: RequestOptions): Promise<Data<"getMatchLineups">>;
+    /** Possession-momentum timeline. */
+    momentum(matchId: string, opts?: RequestOptions): Promise<Data<"getMatchMomentum">>;
+    /** Team-level match statistics. */
+    stats(matchId: string, opts?: RequestOptions): Promise<Data<"getMatchStats">>;
+    /** Per-player match stat lines. */
+    players(matchId: string, opts?: RequestOptions): Promise<Data<"getMatchPlayers">>;
+    /** One player's match stat line. */
+    player(matchId: string, playerId: string, opts?: RequestOptions): Promise<Data<"getMatchPlayer">>;
+    /**
+     * Every player's stat line for the first and the second half. Throws
+     * `NotFoundError` (code `HALVES_UNAVAILABLE`) for a match without them.
+     */
+    playersHalves(matchId: string, opts?: RequestOptions): Promise<Data<"getMatchPlayerHalves">>;
+    /** One player's stat line for each half they played. */
+    playerHalves(matchId: string, playerId: string, opts?: RequestOptions): Promise<Data<"getMatchPlayerHalf">>;
+    /** A single player's shots in the match. */
+    playerShots(matchId: string, playerId: string, opts?: RequestOptions): Promise<Data<"getMatchPlayerShots">>;
+    /** Head-to-head history for the two sides. */
+    h2h(matchId: string, opts?: RequestOptions): Promise<Data<"getMatchH2H">>;
+    /**
+     * Team advanced rollups (PPDA, field tilt, xG timeline). Throws
+     * `NotFoundError` (code `ANALYTICS_UNAVAILABLE`) for a match not yet rated.
+     */
+    advanced(matchId: string, opts?: RequestOptions): Promise<Data<"getMatchAdvanced">>;
+    /** Pass networks for both sides. */
+    advancedNetwork(matchId: string, opts?: RequestOptions): Promise<Data<"getMatchAdvancedNetwork">>;
+    /** Player-level advanced rollups. */
+    advancedPlayers(matchId: string, opts?: RequestOptions): Promise<Data<"getMatchAdvancedPlayers">>;
+    /** One player's advanced rollup. */
+    advancedPlayer(matchId: string, playerId: string, opts?: RequestOptions): Promise<Data<"getMatchAdvancedPlayer">>;
+    /**
+     * Binned activity for both teams and every player who touched the ball.
+     * Cells are sparse `[cell_x, cell_y, actions]` triples on a 16x12 grid.
+     */
+    heatmaps(matchId: string, opts?: {
+        frame?: HeatmapFrame;
+    } & RequestOptions): Promise<Data<"getMatchHeatmaps">>;
+}
+/** `/leagues`. */
+declare class LeaguesResource extends Resource {
+    /** All leagues, each with its accepted seasons and coverage. */
+    list(opts?: RequestOptions): Promise<LeaguesList>;
+    /** League detail. */
+    get(leagueId: string, opts?: RequestOptions): Promise<Data<"getLeague">>;
+    /**
+     * Matches in a league. `season` is `"2025/2026"` for a fall-spring league
+     * and `"2026"` for a calendar-year one; omitted, the latest season with
+     * data. The season is resolved before `status` applies, so `upcoming` on a
+     * finished season is an empty list.
+     */
+    matches(leagueId: string, opts?: {
+        season?: string;
+        status?: MatchStatus;
+    } & RequestOptions): Promise<Data<"getLeagueMatches">>;
+}
+/** `/teams`. */
+declare class TeamsResource extends Resource {
+    /** Team profile. */
+    get(teamId: string, opts?: RequestOptions): Promise<Data<"getTeam">>;
+}
+/** `/players` — the standalone profile. Per-match stats live under `matches`. */
+declare class PlayersResource extends Resource {
+    /** Player profile. */
+    get(playerId: string, opts?: RequestOptions): Promise<Data<"getPlayer">>;
+}
+declare class PitchAPI {
+    readonly date: DateResource;
+    readonly matches: MatchesResource;
+    readonly leagues: LeaguesResource;
+    readonly teams: TeamsResource;
+    readonly players: PlayersResource;
+    constructor(options?: PitchAPIOptions);
+}
+
+/**
+ * Error hierarchy for the PitchAPI SDK.
+ *
+ * Every error the API returns carries a stable `error.code` string in its
+ * envelope. Errors are mapped from that code first and the HTTP status second,
+ * so callers can branch on a semantic type rather than parsing status numbers.
+ */
+type ErrorCode = "INVALID_PARAMETER" | "UNAUTHORIZED" | "SUBSCRIPTION_SUSPENDED" | "PLAN_UPGRADE_REQUIRED" | "RESOURCE_NOT_FOUND" | "ANALYTICS_UNAVAILABLE" | "HALVES_UNAVAILABLE" | "RATE_LIMIT_EXCEEDED" | "INTERNAL_SERVER_ERROR";
+interface PitchAPIErrorOptions {
+    /** The stable `error.code`, when the failure came from the API envelope. */
+    code?: string | undefined;
+    /** The HTTP status, when there was a response. */
+    status?: number | undefined;
+    /** The `X-Request-ID` echoed by the API — quote it in support threads. */
+    requestId?: string | undefined;
+    cause?: unknown;
+}
+/** Base class for every error thrown by the SDK. */
+declare class PitchAPIError extends Error {
+    readonly code: string | undefined;
+    readonly status: number | undefined;
+    readonly requestId: string | undefined;
+    constructor(message: string, options?: PitchAPIErrorOptions);
+}
+/** The request never produced a response (network error, timeout, DNS). */
+declare class APIConnectionError extends PitchAPIError {
+}
+/** 400 INVALID_PARAMETER — a malformed ID, date, or season. */
+declare class InvalidParameterError extends PitchAPIError {
+}
+/** 401 UNAUTHORIZED — the API key is missing, malformed, or revoked. */
+declare class AuthError extends PitchAPIError {
+}
+/** 403 SUBSCRIPTION_SUSPENDED — the account's subscription is not active. */
+declare class SubscriptionSuspendedError extends PitchAPIError {
+}
+/** 403 PLAN_UPGRADE_REQUIRED — the resource's league is not on the account's plan. */
+declare class PlanUpgradeRequiredError extends PitchAPIError {
+}
+/**
+ * 404 — the resource does not exist, or its analytics or halves are unavailable.
+ *
+ * `code` distinguishes `RESOURCE_NOT_FOUND` from `ANALYTICS_UNAVAILABLE` and
+ * `HALVES_UNAVAILABLE`.
+ */
+declare class NotFoundError extends PitchAPIError {
+}
+/**
+ * 429 RATE_LIMIT_EXCEEDED — the per-user fair-use ceiling was hit.
+ *
+ * `retryAfter` is the number of seconds the API asked the client to wait, from
+ * the `Retry-After` header; `undefined` if the header was absent. Retries are
+ * automatic, so this means the client already backed off and tried again.
+ */
+declare class RateLimitError extends PitchAPIError {
+    readonly retryAfter: number | undefined;
+    constructor(message: string, options?: PitchAPIErrorOptions & {
+        retryAfter?: number | undefined;
+    });
+}
+/** 5xx — the API failed to serve the request. */
+declare class ServerError extends PitchAPIError {
+}
+
+/**
+ * The package version. `package.json` is the other place it is written; the
+ * release workflow and `test/version.test.ts` refuse a build where the two
+ * disagree, and this is what the client reports as its `User-Agent`.
+ */
+declare const VERSION = "0.1.1";
+
+type S = components["schemas"];
+type ErrorEnvelope = S["ErrorEnvelope"];
+type LeagueRef = S["LeagueRef"];
+type TeamRef = S["TeamRef"];
+type TeamNameRef = S["TeamNameRef"];
+type PlayerRef = S["PlayerRef"];
+type AdvancedPlayerRef = S["AdvancedPlayerRef"];
+type CoachRef = S["CoachRef"];
+type Match = S["Match"];
+type MatchSummary = S["MatchSummary"];
+type DateMatches = S["DateMatches"];
+type Shot = S["Shot"];
+type ShotPeriod = S["ShotPeriod"];
+type Shots = S["Shots"];
+type PlayerShots = S["PlayerShots"];
+type Event = S["Event"];
+type Events = S["Events"];
+type LineupPlayer = S["LineupPlayer"];
+type LineupSide = S["LineupSide"];
+type Lineups = S["Lineups"];
+type MomentumPoint = S["MomentumPoint"];
+type Momentum = S["Momentum"];
+type MatchStatItem = S["MatchStatItem"];
+type MatchStatGroup = S["MatchStatGroup"];
+type MatchStatPeriod = S["MatchStatPeriod"];
+type MatchStats = S["MatchStats"];
+type PlayerMatchStats = S["PlayerMatchStats"];
+type PlayerDetail = S["PlayerDetail"];
+type PlayerHalfStats = S["PlayerHalfStats"];
+type PlayerHalves = S["PlayerHalves"];
+type MatchPlayerHalves = S["MatchPlayerHalves"];
+type PlayerHalfDetail = S["PlayerHalfDetail"];
+type H2HMatch = S["H2HMatch"];
+type H2H = S["H2H"];
+type League = S["League"];
+type LeagueSummary = S["LeagueSummary"];
+type LeagueSeasonRef = S["LeagueSeasonRef"];
+type LeagueMatchSummary = S["LeagueMatchSummary"];
+type LeagueMatches = S["LeagueMatches"];
+type Team = S["Team"];
+type PlayerProfile = S["PlayerProfile"];
+type PossessionValue = S["PossessionValue"];
+type PassingStats = S["PassingStats"];
+type CarryingStats = S["CarryingStats"];
+type TeamSCABreakdown = S["TeamSCABreakdown"];
+type TeamCreation = S["TeamCreation"];
+type PlayerSCABreakdown = S["PlayerSCABreakdown"];
+type PlayerCreation = S["PlayerCreation"];
+type PlayerDefending = S["PlayerDefending"];
+type TeamDefending = S["TeamDefending"];
+type TerritoryStats = S["TerritoryStats"];
+type TempoStats = S["TempoStats"];
+type Goalkeeping = S["Goalkeeping"];
+type AdvancedTeamStat = S["AdvancedTeamStat"];
+type AdvancedTeams = S["AdvancedTeams"];
+type AdvancedPlayerStat = S["AdvancedPlayerStat"];
+type AdvancedPlayers = S["AdvancedPlayers"];
+type NetworkWindow = S["NetworkWindow"];
+type PassNetworkNode = S["PassNetworkNode"];
+type PassNetworkEdge = S["PassNetworkEdge"];
+type PassNetwork = S["PassNetwork"];
+type AdvancedNetworks = S["AdvancedNetworks"];
+type HeatmapGrid = S["HeatmapGrid"];
+type HeatmapCells = S["HeatmapCells"];
+type TeamHeatmap = S["TeamHeatmap"];
+type PlayerHeatmap = S["PlayerHeatmap"];
+type MatchHeatmaps = S["MatchHeatmaps"];
+
+export { APIConnectionError, type AdvancedNetworks, type AdvancedPlayerRef, type AdvancedPlayerStat, type AdvancedPlayers, type AdvancedTeamStat, type AdvancedTeams, AuthError, type CarryingStats, type CoachRef, type DateMatches, type ErrorCode, type ErrorEnvelope, type Event, type Events, type FetchLike, type Goalkeeping, type H2H, type H2HMatch, type HeatmapCells, type HeatmapFrame, type HeatmapGrid, InvalidParameterError, type League, type LeagueMatchSummary, type LeagueMatches, type LeagueRef, type LeagueSeasonRef, type LeagueSummary, type LeaguesList, type LineupPlayer, type LineupSide, type Lineups, type Match, type MatchHeatmaps, type MatchPlayerHalves, type MatchStatGroup, type MatchStatItem, type MatchStatPeriod, type MatchStats, type MatchStatus, type MatchSummary, type Momentum, type MomentumPoint, type NetworkWindow, NotFoundError, type PassNetwork, type PassNetworkEdge, type PassNetworkNode, type PassingStats, PitchAPI, PitchAPIError, type PitchAPIErrorOptions, type PitchAPIOptions, PlanUpgradeRequiredError, type PlayerCreation, type PlayerDefending, type PlayerDetail, type PlayerHalfDetail, type PlayerHalfStats, type PlayerHalves, type PlayerHeatmap, type PlayerMatchStats, type PlayerProfile, type PlayerRef, type PlayerSCABreakdown, type PlayerShots, type PossessionValue, RateLimitError, type RequestOptions, ServerError, type Shot, type ShotPeriod, type Shots, SubscriptionSuspendedError, type Team, type TeamCreation, type TeamDefending, type TeamHeatmap, type TeamNameRef, type TeamRef, type TeamSCABreakdown, type TempoStats, type TerritoryStats, VERSION, type components, type operations, type paths };