cfbd 5.26.3 → 5.27.0

package/dist/sdk.gen.d.ts

@@ -222,23 +222,25 @@ export declare const getReturningProduction: <ThrowOnError extends boolean = fal
  */
 export declare const getTransferPortal: <ThrowOnError extends boolean = false>(options: OptionsLegacyParser<GetTransferPortalData, ThrowOnError>) => import("@hey-api/client-fetch").RequestResult<GetTransferPortalResponse, unknown, ThrowOnError>;
 /**
- * Returns enriched pass attempts.
+ * Returns enriched pass attempts with stored PPA, success, and location-analysis eligibility.
  */
 export declare const getPassingPlays: <ThrowOnError extends boolean = false>(options: OptionsLegacyParser<GetPassingPlaysData, ThrowOnError>) => import("@hey-api/client-fetch").RequestResult<GetPassingPlaysResponse, unknown, ThrowOnError>;
 /**
- * Returns passer production by season.
+ * Returns passer production, advanced metrics, and pass-location breakdowns by season.
  */
 export declare const getPlayerPassingBySeason: <ThrowOnError extends boolean = false>(options?: OptionsLegacyParser<GetPlayerPassingBySeasonData, ThrowOnError>) => import("@hey-api/client-fetch").RequestResult<GetPlayerPassingBySeasonResponse, unknown, ThrowOnError>;
 /**
- * Returns passer production by game.
+ * Returns passer production, advanced metrics, and pass-location breakdowns by game.
  */
 export declare const getPlayerPassingByGame: <ThrowOnError extends boolean = false>(options: OptionsLegacyParser<GetPlayerPassingByGameData, ThrowOnError>) => import("@hey-api/client-fetch").RequestResult<GetPlayerPassingByGameResponse, unknown, ThrowOnError>;
 /**
- * Returns team passing production by season.
+ * Returns team passing production, advanced metrics, and pass-location
+ * breakdowns by season for offense and defense.
  */
 export declare const getTeamPassingBySeason: <ThrowOnError extends boolean = false>(options?: OptionsLegacyParser<GetTeamPassingBySeasonData, ThrowOnError>) => import("@hey-api/client-fetch").RequestResult<GetTeamPassingBySeasonResponse, unknown, ThrowOnError>;
 /**
- * Returns team passing production by game.
+ * Returns team passing production, advanced metrics, and pass-location
+ * breakdowns by game for offense and defense.
  */
 export declare const getTeamPassingByGame: <ThrowOnError extends boolean = false>(options: OptionsLegacyParser<GetTeamPassingByGameData, ThrowOnError>) => import("@hey-api/client-fetch").RequestResult<GetTeamPassingByGameResponse, unknown, ThrowOnError>;
 /**

package/dist/sdk.gen.js

@@ -437,7 +437,7 @@ var getTransferPortal = function (options) {
 };
 exports.getTransferPortal = getTransferPortal;
 /**
- * Returns enriched pass attempts.
+ * Returns enriched pass attempts with stored PPA, success, and location-analysis eligibility.
  */
 var getPassingPlays = function (options) {
     var _a;
@@ -445,7 +445,7 @@ var getPassingPlays = function (options) {
 };
 exports.getPassingPlays = getPassingPlays;
 /**
- * Returns passer production by season.
+ * Returns passer production, advanced metrics, and pass-location breakdowns by season.
  */
 var getPlayerPassingBySeason = function (options) {
     var _a;
@@ -453,7 +453,7 @@ var getPlayerPassingBySeason = function (options) {
 };
 exports.getPlayerPassingBySeason = getPlayerPassingBySeason;
 /**
- * Returns passer production by game.
+ * Returns passer production, advanced metrics, and pass-location breakdowns by game.
  */
 var getPlayerPassingByGame = function (options) {
     var _a;
@@ -461,7 +461,8 @@ var getPlayerPassingByGame = function (options) {
 };
 exports.getPlayerPassingByGame = getPlayerPassingByGame;
 /**
- * Returns team passing production by season.
+ * Returns team passing production, advanced metrics, and pass-location
+ * breakdowns by season for offense and defense.
  */
 var getTeamPassingBySeason = function (options) {
     var _a;
@@ -469,7 +470,8 @@ var getTeamPassingBySeason = function (options) {
 };
 exports.getTeamPassingBySeason = getTeamPassingBySeason;
 /**
- * Returns team passing production by game.
+ * Returns team passing production, advanced metrics, and pass-location
+ * breakdowns by game for offense and defense.
  */
 var getTeamPassingByGame = function (options) {
     var _a;

package/dist/types.gen.d.ts

@@ -902,6 +902,89 @@ export type MatchupGame = {
 export type MediaType = 'tv' | 'radio' | 'web' | 'ppv' | 'mobile';
 export type PassDepth = 'short' | 'deep';
 export type PassDirection = 'left' | 'middle' | 'right';
+/**
+ * Production for analysis-eligible attempts in one location bucket.
+ */
+export type PassingLocationProduction = {
+    attempts: number;
+    completions: number;
+    incompletions: number;
+    interceptions: number;
+    completionRate: (number) | null;
+    /**
+     * Number of attempts with non-null air yards, including zero-yard values.
+     */
+    airYardsAttemptsAvailable: number;
+    totalAirYards: (number) | null;
+    averageDepthOfTarget: (number) | null;
+    /**
+     * Number of attempts with non-null total yards, including zero-yard
+     * incompletions and interceptions.
+     */
+    totalYardsAttemptsAvailable: number;
+    totalYards: (number) | null;
+    /**
+     * Number of completed attempts with valid total yards and air yards to
+     * calculate yards after catch, including zero-yard values.
+     */
+    yardsAfterCatchAttemptsAvailable: number;
+    totalYardsAfterCatch: (number) | null;
+    averageYardsAfterCatch: (number) | null;
+    /**
+     * Successful eligible attempts / all eligible attempts; zero if empty.
+     */
+    successRate: number;
+    /**
+     * Average available PPA on eligible attempts; zero if unavailable.
+     */
+    ppa: number;
+    /**
+     * Sum of available PPA on eligible attempts; zero if unavailable.
+     */
+    totalPpa: number;
+    /**
+     * Average available PPA on successful eligible attempts; zero if unavailable.
+     */
+    explosiveness: number;
+    /**
+     * Eligible attempts with non-null PPA, including zero and negative values.
+     */
+    ppaAttemptsAvailable: number;
+    /**
+     * Eligible attempts with non-null success. Missing success remains in the
+     * success-rate denominator but does not count as successful.
+     */
+    successAttemptsAvailable: number;
+    /**
+     * Eligible attempts with stored success equal to true.
+     */
+    successfulAttempts: number;
+    /**
+     * Successful eligible attempts with non-null PPA; explosiveness denominator.
+     */
+    successfulPpaAttemptsAvailable: number;
+    /**
+     * Total yards / attempts with total yards available; null if unavailable.
+     */
+    yardsPerAttempt: (number) | null;
+    /**
+     * Total air yards / attempts with air yards available; null if unavailable.
+     * Equivalent to averageDepthOfTarget. Yardage averages use one decimal.
+     */
+    airYardsPerAttempt: (number) | null;
+};
+export type PassingLocations = {
+    'short left': PassingLocationProduction;
+    'short middle': PassingLocationProduction;
+    'short right': PassingLocationProduction;
+    'deep left': PassingLocationProduction;
+    'deep middle': PassingLocationProduction;
+    'deep right': PassingLocationProduction;
+    /**
+     * Eligible attempts without both recognized depth and direction.
+     */
+    unknown: PassingLocationProduction;
+};
 export type PassingPlay = {
     gameId: number;
     playId: string;
@@ -938,11 +1021,27 @@ export type PassingPlay = {
     isThrowaway: boolean;
     isIntentionalGrounding: boolean;
     parseStatus: PassParseStatus;
+    /**
+     * Stored offensive PPA, including zero and negative values.
+     */
+    ppa: (number) | null;
+    /**
+     * Stored success classification; null means unavailable.
+     */
+    success: (boolean) | null;
+    /**
+     * Excludes spikes, intentional grounding, and invalid parses. Throwaways,
+     * partial parses, and attempts with missing location or air yards qualify.
+     */
+    locationAnalysisEligible: boolean;
 };
 export type PassingPlayClock = {
     minutes: number;
     seconds: number;
 };
+/**
+ * Defense reports opponent production allowed without inverting PPA signs.
+ */
 export type PassingProduction = {
     attempts: number;
     completions: number;
@@ -968,6 +1067,52 @@ export type PassingProduction = {
     yardsAfterCatchAttemptsAvailable: number;
     totalYardsAfterCatch: (number) | null;
     averageYardsAfterCatch: (number) | null;
+    /**
+     * Successful eligible attempts / all eligible attempts; zero if empty.
+     */
+    successRate: number;
+    /**
+     * Average available PPA on eligible attempts; zero if unavailable.
+     */
+    ppa: number;
+    /**
+     * Sum of available PPA on eligible attempts; zero if unavailable.
+     */
+    totalPpa: number;
+    /**
+     * Average available PPA on successful eligible attempts; zero if unavailable.
+     */
+    explosiveness: number;
+    /**
+     * Eligible attempts with non-null PPA, including zero and negative values.
+     */
+    ppaAttemptsAvailable: number;
+    /**
+     * Eligible attempts with non-null success. Missing success remains in the
+     * success-rate denominator but does not count as successful.
+     */
+    successAttemptsAvailable: number;
+    /**
+     * Eligible attempts with stored success equal to true.
+     */
+    successfulAttempts: number;
+    /**
+     * Successful eligible attempts with non-null PPA; explosiveness denominator.
+     */
+    successfulPpaAttemptsAvailable: number;
+    /**
+     * Attempts eligible for advanced metrics and location analysis. Existing
+     * overall production includes ineligible attempts; location buckets do not.
+     */
+    locationEligibleAttempts: number;
+    /**
+     * Eligible attempts with both recognized source depth and direction.
+     */
+    locationAvailableAttempts: number;
+    /**
+     * All seven buckets are present, including empty buckets.
+     */
+    locations: PassingLocations;
 };
 export type PassLocation = 'short left' | 'short middle' | 'short right' | 'deep left' | 'deep middle' | 'deep right';
 export type PassOutcome = 'completion' | 'incompletion' | 'interception';
@@ -1070,6 +1215,52 @@ export type PlayerPassingGame = {
     yardsAfterCatchAttemptsAvailable: number;
     totalYardsAfterCatch: (number) | null;
     averageYardsAfterCatch: (number) | null;
+    /**
+     * Successful eligible attempts / all eligible attempts; zero if empty.
+     */
+    successRate: number;
+    /**
+     * Average available PPA on eligible attempts; zero if unavailable.
+     */
+    ppa: number;
+    /**
+     * Sum of available PPA on eligible attempts; zero if unavailable.
+     */
+    totalPpa: number;
+    /**
+     * Average available PPA on successful eligible attempts; zero if unavailable.
+     */
+    explosiveness: number;
+    /**
+     * Eligible attempts with non-null PPA, including zero and negative values.
+     */
+    ppaAttemptsAvailable: number;
+    /**
+     * Eligible attempts with non-null success. Missing success remains in the
+     * success-rate denominator but does not count as successful.
+     */
+    successAttemptsAvailable: number;
+    /**
+     * Eligible attempts with stored success equal to true.
+     */
+    successfulAttempts: number;
+    /**
+     * Successful eligible attempts with non-null PPA; explosiveness denominator.
+     */
+    successfulPpaAttemptsAvailable: number;
+    /**
+     * Attempts eligible for advanced metrics and location analysis. Existing
+     * overall production includes ineligible attempts; location buckets do not.
+     */
+    locationEligibleAttempts: number;
+    /**
+     * Eligible attempts with both recognized source depth and direction.
+     */
+    locationAvailableAttempts: number;
+    /**
+     * All seven buckets are present, including empty buckets.
+     */
+    locations: PassingLocations;
     gameId: number;
     season: number;
     week: number;
@@ -1105,6 +1296,52 @@ export type PlayerPassingSeason = {
     yardsAfterCatchAttemptsAvailable: number;
     totalYardsAfterCatch: (number) | null;
     averageYardsAfterCatch: (number) | null;
+    /**
+     * Successful eligible attempts / all eligible attempts; zero if empty.
+     */
+    successRate: number;
+    /**
+     * Average available PPA on eligible attempts; zero if unavailable.
+     */
+    ppa: number;
+    /**
+     * Sum of available PPA on eligible attempts; zero if unavailable.
+     */
+    totalPpa: number;
+    /**
+     * Average available PPA on successful eligible attempts; zero if unavailable.
+     */
+    explosiveness: number;
+    /**
+     * Eligible attempts with non-null PPA, including zero and negative values.
+     */
+    ppaAttemptsAvailable: number;
+    /**
+     * Eligible attempts with non-null success. Missing success remains in the
+     * success-rate denominator but does not count as successful.
+     */
+    successAttemptsAvailable: number;
+    /**
+     * Eligible attempts with stored success equal to true.
+     */
+    successfulAttempts: number;
+    /**
+     * Successful eligible attempts with non-null PPA; explosiveness denominator.
+     */
+    successfulPpaAttemptsAvailable: number;
+    /**
+     * Attempts eligible for advanced metrics and location analysis. Existing
+     * overall production includes ineligible attempts; location buckets do not.
+     */
+    locationEligibleAttempts: number;
+    /**
+     * Eligible attempts with both recognized source depth and direction.
+     */
+    locationAvailableAttempts: number;
+    /**
+     * All seven buckets are present, including empty buckets.
+     */
+    locations: PassingLocations;
     season: number;
     playerId: string;
     player: string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cfbd",
-  "version": "5.26.3",
+  "version": "5.27.0",
   "description": "This API is in limited Beta for Patreon subscribers. It may have bugs and is subject to changes. API keys can be acquired from the CollegeFootballData.com website.",
   "repository": {
     "type": "git",

package/src/sdk.gen.ts

@@ -526,7 +526,7 @@ export const getTransferPortal = <ThrowOnError extends boolean = false>(options:
 };
 
 /**
- * Returns enriched pass attempts.
+ * Returns enriched pass attempts with stored PPA, success, and location-analysis eligibility.
  */
 export const getPassingPlays = <ThrowOnError extends boolean = false>(options: OptionsLegacyParser<GetPassingPlaysData, ThrowOnError>) => {
     return (options?.client ?? client).get<GetPassingPlaysResponse, GetPassingPlaysError, ThrowOnError>({
@@ -536,7 +536,7 @@ export const getPassingPlays = <ThrowOnError extends boolean = false>(options: O
 };
 
 /**
- * Returns passer production by season.
+ * Returns passer production, advanced metrics, and pass-location breakdowns by season.
  */
 export const getPlayerPassingBySeason = <ThrowOnError extends boolean = false>(options?: OptionsLegacyParser<GetPlayerPassingBySeasonData, ThrowOnError>) => {
     return (options?.client ?? client).get<GetPlayerPassingBySeasonResponse, GetPlayerPassingBySeasonError, ThrowOnError>({
@@ -546,7 +546,7 @@ export const getPlayerPassingBySeason = <ThrowOnError extends boolean = false>(o
 };
 
 /**
- * Returns passer production by game.
+ * Returns passer production, advanced metrics, and pass-location breakdowns by game.
  */
 export const getPlayerPassingByGame = <ThrowOnError extends boolean = false>(options: OptionsLegacyParser<GetPlayerPassingByGameData, ThrowOnError>) => {
     return (options?.client ?? client).get<GetPlayerPassingByGameResponse, GetPlayerPassingByGameError, ThrowOnError>({
@@ -556,7 +556,8 @@ export const getPlayerPassingByGame = <ThrowOnError extends boolean = false>(opt
 };
 
 /**
- * Returns team passing production by season.
+ * Returns team passing production, advanced metrics, and pass-location
+ * breakdowns by season for offense and defense.
  */
 export const getTeamPassingBySeason = <ThrowOnError extends boolean = false>(options?: OptionsLegacyParser<GetTeamPassingBySeasonData, ThrowOnError>) => {
     return (options?.client ?? client).get<GetTeamPassingBySeasonResponse, GetTeamPassingBySeasonError, ThrowOnError>({
@@ -566,7 +567,8 @@ export const getTeamPassingBySeason = <ThrowOnError extends boolean = false>(opt
 };
 
 /**
- * Returns team passing production by game.
+ * Returns team passing production, advanced metrics, and pass-location
+ * breakdowns by game for offense and defense.
  */
 export const getTeamPassingByGame = <ThrowOnError extends boolean = false>(options: OptionsLegacyParser<GetTeamPassingByGameData, ThrowOnError>) => {
     return (options?.client ?? client).get<GetTeamPassingByGameResponse, GetTeamPassingByGameError, ThrowOnError>({

package/src/types.gen.ts

@@ -974,6 +974,91 @@ export type PassDepth = 'short' | 'deep';
 
 export type PassDirection = 'left' | 'middle' | 'right';
 
+/**
+ * Production for analysis-eligible attempts in one location bucket.
+ */
+export type PassingLocationProduction = {
+    attempts: number;
+    completions: number;
+    incompletions: number;
+    interceptions: number;
+    completionRate: (number) | null;
+    /**
+     * Number of attempts with non-null air yards, including zero-yard values.
+     */
+    airYardsAttemptsAvailable: number;
+    totalAirYards: (number) | null;
+    averageDepthOfTarget: (number) | null;
+    /**
+     * Number of attempts with non-null total yards, including zero-yard
+     * incompletions and interceptions.
+     */
+    totalYardsAttemptsAvailable: number;
+    totalYards: (number) | null;
+    /**
+     * Number of completed attempts with valid total yards and air yards to
+     * calculate yards after catch, including zero-yard values.
+     */
+    yardsAfterCatchAttemptsAvailable: number;
+    totalYardsAfterCatch: (number) | null;
+    averageYardsAfterCatch: (number) | null;
+    /**
+     * Successful eligible attempts / all eligible attempts; zero if empty.
+     */
+    successRate: number;
+    /**
+     * Average available PPA on eligible attempts; zero if unavailable.
+     */
+    ppa: number;
+    /**
+     * Sum of available PPA on eligible attempts; zero if unavailable.
+     */
+    totalPpa: number;
+    /**
+     * Average available PPA on successful eligible attempts; zero if unavailable.
+     */
+    explosiveness: number;
+    /**
+     * Eligible attempts with non-null PPA, including zero and negative values.
+     */
+    ppaAttemptsAvailable: number;
+    /**
+     * Eligible attempts with non-null success. Missing success remains in the
+     * success-rate denominator but does not count as successful.
+     */
+    successAttemptsAvailable: number;
+    /**
+     * Eligible attempts with stored success equal to true.
+     */
+    successfulAttempts: number;
+    /**
+     * Successful eligible attempts with non-null PPA; explosiveness denominator.
+     */
+    successfulPpaAttemptsAvailable: number;
+    /**
+     * Total yards / attempts with total yards available; null if unavailable.
+     */
+    yardsPerAttempt: (number) | null;
+    /**
+     * Total air yards / attempts with air yards available; null if unavailable.
+     * Equivalent to averageDepthOfTarget. Yardage averages use one decimal.
+     */
+    airYardsPerAttempt: (number) | null;
+};
+
+export type PassingLocations = {
+    'short left': PassingLocationProduction;
+    'short middle': PassingLocationProduction;
+    'short right': PassingLocationProduction;
+    'deep left': PassingLocationProduction;
+    'deep middle': PassingLocationProduction;
+    'deep right': PassingLocationProduction;
+    /**
+     * Eligible attempts without both recognized depth and direction.
+     */
+    unknown: PassingLocationProduction;
+};
+
 export type PassingPlay = {
     gameId: number;
     playId: string;
@@ -1010,6 +1095,19 @@ export type PassingPlay = {
     isThrowaway: boolean;
     isIntentionalGrounding: boolean;
     parseStatus: PassParseStatus;
+    /**
+     * Stored offensive PPA, including zero and negative values.
+     */
+    ppa: (number) | null;
+    /**
+     * Stored success classification; null means unavailable.
+     */
+    success: (boolean) | null;
+    /**
+     * Excludes spikes, intentional grounding, and invalid parses. Throwaways,
+     * partial parses, and attempts with missing location or air yards qualify.
+     */
+    locationAnalysisEligible: boolean;
 };
 
 export type PassingPlayClock = {
@@ -1017,6 +1115,9 @@ export type PassingPlayClock = {
     seconds: number;
 };
 
+/**
+ * Defense reports opponent production allowed without inverting PPA signs.
+ */
 export type PassingProduction = {
     attempts: number;
     completions: number;
@@ -1042,6 +1143,52 @@ export type PassingProduction = {
     yardsAfterCatchAttemptsAvailable: number;
     totalYardsAfterCatch: (number) | null;
     averageYardsAfterCatch: (number) | null;
+    /**
+     * Successful eligible attempts / all eligible attempts; zero if empty.
+     */
+    successRate: number;
+    /**
+     * Average available PPA on eligible attempts; zero if unavailable.
+     */
+    ppa: number;
+    /**
+     * Sum of available PPA on eligible attempts; zero if unavailable.
+     */
+    totalPpa: number;
+    /**
+     * Average available PPA on successful eligible attempts; zero if unavailable.
+     */
+    explosiveness: number;
+    /**
+     * Eligible attempts with non-null PPA, including zero and negative values.
+     */
+    ppaAttemptsAvailable: number;
+    /**
+     * Eligible attempts with non-null success. Missing success remains in the
+     * success-rate denominator but does not count as successful.
+     */
+    successAttemptsAvailable: number;
+    /**
+     * Eligible attempts with stored success equal to true.
+     */
+    successfulAttempts: number;
+    /**
+     * Successful eligible attempts with non-null PPA; explosiveness denominator.
+     */
+    successfulPpaAttemptsAvailable: number;
+    /**
+     * Attempts eligible for advanced metrics and location analysis. Existing
+     * overall production includes ineligible attempts; location buckets do not.
+     */
+    locationEligibleAttempts: number;
+    /**
+     * Eligible attempts with both recognized source depth and direction.
+     */
+    locationAvailableAttempts: number;
+    /**
+     * All seven buckets are present, including empty buckets.
+     */
+    locations: PassingLocations;
 };
 
 export type PassLocation = 'short left' | 'short middle' | 'short right' | 'deep left' | 'deep middle' | 'deep right';
@@ -1152,6 +1299,52 @@ export type PlayerPassingGame = {
     yardsAfterCatchAttemptsAvailable: number;
     totalYardsAfterCatch: (number) | null;
     averageYardsAfterCatch: (number) | null;
+    /**
+     * Successful eligible attempts / all eligible attempts; zero if empty.
+     */
+    successRate: number;
+    /**
+     * Average available PPA on eligible attempts; zero if unavailable.
+     */
+    ppa: number;
+    /**
+     * Sum of available PPA on eligible attempts; zero if unavailable.
+     */
+    totalPpa: number;
+    /**
+     * Average available PPA on successful eligible attempts; zero if unavailable.
+     */
+    explosiveness: number;
+    /**
+     * Eligible attempts with non-null PPA, including zero and negative values.
+     */
+    ppaAttemptsAvailable: number;
+    /**
+     * Eligible attempts with non-null success. Missing success remains in the
+     * success-rate denominator but does not count as successful.
+     */
+    successAttemptsAvailable: number;
+    /**
+     * Eligible attempts with stored success equal to true.
+     */
+    successfulAttempts: number;
+    /**
+     * Successful eligible attempts with non-null PPA; explosiveness denominator.
+     */
+    successfulPpaAttemptsAvailable: number;
+    /**
+     * Attempts eligible for advanced metrics and location analysis. Existing
+     * overall production includes ineligible attempts; location buckets do not.
+     */
+    locationEligibleAttempts: number;
+    /**
+     * Eligible attempts with both recognized source depth and direction.
+     */
+    locationAvailableAttempts: number;
+    /**
+     * All seven buckets are present, including empty buckets.
+     */
+    locations: PassingLocations;
     gameId: number;
     season: number;
     week: number;
@@ -1188,6 +1381,52 @@ export type PlayerPassingSeason = {
     yardsAfterCatchAttemptsAvailable: number;
     totalYardsAfterCatch: (number) | null;
     averageYardsAfterCatch: (number) | null;
+    /**
+     * Successful eligible attempts / all eligible attempts; zero if empty.
+     */
+    successRate: number;
+    /**
+     * Average available PPA on eligible attempts; zero if unavailable.
+     */
+    ppa: number;
+    /**
+     * Sum of available PPA on eligible attempts; zero if unavailable.
+     */
+    totalPpa: number;
+    /**
+     * Average available PPA on successful eligible attempts; zero if unavailable.
+     */
+    explosiveness: number;
+    /**
+     * Eligible attempts with non-null PPA, including zero and negative values.
+     */
+    ppaAttemptsAvailable: number;
+    /**
+     * Eligible attempts with non-null success. Missing success remains in the
+     * success-rate denominator but does not count as successful.
+     */
+    successAttemptsAvailable: number;
+    /**
+     * Eligible attempts with stored success equal to true.
+     */
+    successfulAttempts: number;
+    /**
+     * Successful eligible attempts with non-null PPA; explosiveness denominator.
+     */
+    successfulPpaAttemptsAvailable: number;
+    /**
+     * Attempts eligible for advanced metrics and location analysis. Existing
+     * overall production includes ineligible attempts; location buckets do not.
+     */
+    locationEligibleAttempts: number;
+    /**
+     * Eligible attempts with both recognized source depth and direction.
+     */
+    locationAvailableAttempts: number;
+    /**
+     * All seven buckets are present, including empty buckets.
+     */
+    locations: PassingLocations;
     season: number;
     playerId: string;
     player: string;