nhl-api-ts 0.0.0-stage → 0.1.0

package/dist/api/game-center.d.mts

@@ -0,0 +1,83 @@
+import type { Context } from '#src/context.mjs';
+import type { Id, JsonObject } from '#src/utils.mjs';
+/**
+ * Get the full boxscore for a specific NHL game, including team scores,
+ * shots on goal, and per-player stats.
+ *
+ * @param params.gameId Game id, e.g. 2023020280
+ * @example https://api-web.nhle.com/v1/gamecenter/2023020280/boxscore
+ */
+export declare const boxscore: (ctx: Context, { gameId }: {
+    gameId: Id;
+}) => Promise<JsonObject>;
+/**
+ * Get the full play-by-play feed for a specific NHL game, containing every
+ * recorded event (shots, hits, faceoffs, goals, penalties...).
+ *
+ * @param params.gameId Game id, e.g. 2023020280
+ * @example https://api-web.nhle.com/v1/gamecenter/2023020280/play-by-play
+ */
+export declare const playByPlay: (ctx: Context, { gameId }: {
+    gameId: Id;
+}) => Promise<JsonObject>;
+/**
+ * Get the landing-page summary for a specific NHL game, including scoring by
+ * period, three stars and penalties.
+ *
+ * @param params.gameId Game id, e.g. 2023020280
+ * @example https://api-web.nhle.com/v1/gamecenter/2023020280/landing
+ */
+export declare const matchUp: (ctx: Context, { gameId }: {
+    gameId: Id;
+}) => Promise<JsonObject>;
+/**
+ * Get scores and game states for all NHL games on a given date. Returns the
+ * current day's scores when no date is supplied.
+ *
+ * @param params.date Date in YYYY-MM-DD format. Defaults to "now".
+ * @example https://api-web.nhle.com/v1/score/2023-10-15
+ */
+export declare const dailyScores: (ctx: Context, { date }?: {
+    date?: string;
+}) => Promise<JsonObject>;
+/**
+ * Get individual player shift data for a specific game, including start/end
+ * times and durations.
+ *
+ * @param params.gameId Game id, e.g. 2023020280
+ * @param params.excludes Fields to exclude from the response. Defaults to ["eventDetails"].
+ * @example https://api.nhle.com/stats/rest/en/shiftcharts?cayenneExp=gameId=2023020280 and ...
+ */
+export declare const shiftChartData: (ctx: Context, { gameId, excludes }: {
+    gameId: Id;
+    excludes?: string[];
+}) => Promise<JsonObject>;
+/**
+ * Get the season-series record and contextual stats for a specific game,
+ * including team season stats and last games.
+ *
+ * @param params.gameId Game id, e.g. 2023020280
+ * @example https://api-web.nhle.com/v1/gamecenter/2023020280/right-rail
+ */
+export declare const seasonSeriesMatchup: (ctx: Context, { gameId }: {
+    gameId: Id;
+}) => Promise<JsonObject>;
+/**
+ * Get the narrative game story for a specific game, including scoring
+ * summaries, three stars and team game stats.
+ *
+ * @param params.gameId Game id, e.g. 2023020280
+ * @example https://api-web.nhle.com/v1/wsc/game-story/2023020280
+ */
+export declare const gameStory: (ctx: Context, { gameId }: {
+    gameId: Id;
+}) => Promise<JsonObject>;
+export declare const gameCenterApi: {
+    readonly boxscore: typeof boxscore;
+    readonly playByPlay: typeof playByPlay;
+    readonly matchUp: typeof matchUp;
+    readonly dailyScores: typeof dailyScores;
+    readonly shiftChartData: typeof shiftChartData;
+    readonly seasonSeriesMatchup: typeof seasonSeriesMatchup;
+    readonly gameStory: typeof gameStory;
+};

package/dist/api/game-center.mjs

@@ -0,0 +1,74 @@
+import { Endpoint } from '#src/http-client.mjs';
+async function getWeb(ctx, resource) {
+    return (await ctx.get(Endpoint.API_WEB_V1, resource)).json();
+}
+/**
+ * Get the full boxscore for a specific NHL game, including team scores,
+ * shots on goal, and per-player stats.
+ *
+ * @param params.gameId Game id, e.g. 2023020280
+ * @example https://api-web.nhle.com/v1/gamecenter/2023020280/boxscore
+ */
+export const boxscore = async (ctx, { gameId }) => getWeb(ctx, `gamecenter/${gameId}/boxscore`);
+/**
+ * Get the full play-by-play feed for a specific NHL game, containing every
+ * recorded event (shots, hits, faceoffs, goals, penalties...).
+ *
+ * @param params.gameId Game id, e.g. 2023020280
+ * @example https://api-web.nhle.com/v1/gamecenter/2023020280/play-by-play
+ */
+export const playByPlay = async (ctx, { gameId }) => getWeb(ctx, `gamecenter/${gameId}/play-by-play`);
+/**
+ * Get the landing-page summary for a specific NHL game, including scoring by
+ * period, three stars and penalties.
+ *
+ * @param params.gameId Game id, e.g. 2023020280
+ * @example https://api-web.nhle.com/v1/gamecenter/2023020280/landing
+ */
+export const matchUp = async (ctx, { gameId }) => getWeb(ctx, `gamecenter/${gameId}/landing`);
+/**
+ * Get scores and game states for all NHL games on a given date. Returns the
+ * current day's scores when no date is supplied.
+ *
+ * @param params.date Date in YYYY-MM-DD format. Defaults to "now".
+ * @example https://api-web.nhle.com/v1/score/2023-10-15
+ */
+export const dailyScores = async (ctx, { date } = {}) => getWeb(ctx, `score/${date ? date : 'now'}`);
+/**
+ * Get individual player shift data for a specific game, including start/end
+ * times and durations.
+ *
+ * @param params.gameId Game id, e.g. 2023020280
+ * @param params.excludes Fields to exclude from the response. Defaults to ["eventDetails"].
+ * @example https://api.nhle.com/stats/rest/en/shiftcharts?cayenneExp=gameId=2023020280 and ...
+ */
+export const shiftChartData = async (ctx, { gameId, excludes = ['eventDetails'] }) => {
+    const excludeP = excludes.join(',');
+    const exprP = `gameId=${gameId} and ((duration != '00:00' and typeCode = 517) or typeCode != 517 )`;
+    return (await ctx.get(Endpoint.API_STATS, `en/shiftcharts?cayenneExp=${exprP}&exclude=${excludeP}`)).json();
+};
+/**
+ * Get the season-series record and contextual stats for a specific game,
+ * including team season stats and last games.
+ *
+ * @param params.gameId Game id, e.g. 2023020280
+ * @example https://api-web.nhle.com/v1/gamecenter/2023020280/right-rail
+ */
+export const seasonSeriesMatchup = async (ctx, { gameId }) => getWeb(ctx, `gamecenter/${gameId}/right-rail`);
+/**
+ * Get the narrative game story for a specific game, including scoring
+ * summaries, three stars and team game stats.
+ *
+ * @param params.gameId Game id, e.g. 2023020280
+ * @example https://api-web.nhle.com/v1/wsc/game-story/2023020280
+ */
+export const gameStory = async (ctx, { gameId }) => getWeb(ctx, `wsc/game-story/${gameId}`);
+export const gameCenterApi = {
+    boxscore,
+    playByPlay,
+    matchUp,
+    dailyScores,
+    shiftChartData,
+    seasonSeriesMatchup,
+    gameStory,
+};

package/dist/api/helpers.d.mts

@@ -0,0 +1,46 @@
+import type { Context } from '#src/context.mjs';
+import type { Id, JsonObject } from '#src/utils.mjs';
+/**
+ * Gets all game IDs for a specified season by querying every team's
+ * schedule. Games appear once per participating team, so ids may repeat.
+ *
+ * @param params.season Season in YYYYYYYY format, e.g. 20232024
+ * @param params.gameTypes Only include these game types (1=Preseason, 2=Regular, 3=Playoffs). Defaults to all.
+ * @param params.apiSleepRate Seconds to sleep between team requests. Defaults to 1.
+ * @example await client.helpers.gameIdsBySeason({ season: '20232024', gameTypes: [2] })
+ */
+export declare const gameIdsBySeason: (ctx: Context, { season, gameTypes, apiSleepRate, }: {
+    season: Id;
+    gameTypes?: number[];
+    apiSleepRate?: number;
+}) => Promise<number[]>;
+/**
+ * Gets every rostered player across all NHL teams for a given season. Each
+ * player gets a `team` abbreviation and flattened `firstName` / `lastName`.
+ *
+ * @param params.season Season in YYYYYYYY format, e.g. 20232024
+ * @param params.apiSleepRate Seconds to sleep between team requests. Defaults to 0.5.
+ * @example await client.helpers.allPlayers({ season: '20232024' })
+ */
+export declare const allPlayers: (ctx: Context, { season, apiSleepRate }: {
+    season: Id;
+    apiSleepRate?: number;
+}) => Promise<JsonObject[]>;
+/**
+ * Gets summary statistics for every skater in a given season, merged with
+ * the roster info from `allPlayers` (stat fields win on key collisions).
+ * Stat entries without a matching rostered player are included as-is.
+ *
+ * @param params.season Season in YYYYYYYY format, e.g. 20232024
+ * @param params.apiSleepRate Seconds to sleep between team requests. Defaults to 1.
+ * @example await client.helpers.allPlayersSummaryStatistics({ season: '20232024' })
+ */
+export declare const allPlayersSummaryStatistics: (ctx: Context, { season, apiSleepRate }: {
+    season: Id;
+    apiSleepRate?: number;
+}) => Promise<JsonObject[]>;
+export declare const helpersApi: {
+    readonly gameIdsBySeason: typeof gameIdsBySeason;
+    readonly allPlayers: typeof allPlayers;
+    readonly allPlayersSummaryStatistics: typeof allPlayersSummaryStatistics;
+};

package/dist/api/helpers.mjs

@@ -0,0 +1,106 @@
+import { buildQuery } from '#src/api/query/builder.mjs';
+import { filter } from '#src/api/query/filters.mjs';
+import { teamSeasonSchedule } from '#src/api/schedule.mjs';
+import { skaterStatsWithQueryContext } from '#src/api/stats.mjs';
+import { teams as fetchTeams, teamRoster } from '#src/api/teams.mjs';
+/**
+ * Gets all game IDs for a specified season by querying every team's
+ * schedule. Games appear once per participating team, so ids may repeat.
+ *
+ * @param params.season Season in YYYYYYYY format, e.g. 20232024
+ * @param params.gameTypes Only include these game types (1=Preseason, 2=Regular, 3=Playoffs). Defaults to all.
+ * @param params.apiSleepRate Seconds to sleep between team requests. Defaults to 1.
+ * @example await client.helpers.gameIdsBySeason({ season: '20232024', gameTypes: [2] })
+ */
+export const gameIdsBySeason = async (ctx, { season, gameTypes, apiSleepRate = 1, }) => {
+    const teams = await fetchTeams(ctx);
+    const gameIds = [];
+    for (const team of teams) {
+        const teamAbbr = team.abbr ?? '';
+        if (!teamAbbr) {
+            continue;
+        }
+        await ctx.sleep(apiSleepRate);
+        const schedule = await teamSeasonSchedule(ctx, { teamAbbr, season });
+        const games = schedule.games ?? [];
+        for (const game of games) {
+            const gameType = game.gameType;
+            const gameId = game.id;
+            if (gameId &&
+                (!gameTypes || gameTypes.length === 0 || gameTypes.includes(gameType))) {
+                gameIds.push(gameId);
+            }
+        }
+    }
+    return gameIds;
+};
+/**
+ * Gets every rostered player across all NHL teams for a given season. Each
+ * player gets a `team` abbreviation and flattened `firstName` / `lastName`.
+ *
+ * @param params.season Season in YYYYYYYY format, e.g. 20232024
+ * @param params.apiSleepRate Seconds to sleep between team requests. Defaults to 0.5.
+ * @example await client.helpers.allPlayers({ season: '20232024' })
+ */
+export const allPlayers = async (ctx, { season, apiSleepRate = 0.5 }) => {
+    const teams = await fetchTeams(ctx);
+    console.error('Fetching all player base stats. This may take a while...');
+    const outData = [];
+    for (const team of teams) {
+        await ctx.sleep(apiSleepRate);
+        const players = await teamRoster(ctx, { teamAbbr: team.abbr, season });
+        for (const player of [
+            ...players.forwards,
+            ...players.defensemen,
+            ...players.goalies,
+        ]) {
+            outData.push({
+                ...player,
+                team: team.abbr,
+                firstName: player.firstName.default,
+                lastName: player.lastName.default,
+            });
+        }
+    }
+    return outData;
+};
+/**
+ * Gets summary statistics for every skater in a given season, merged with
+ * the roster info from `allPlayers` (stat fields win on key collisions).
+ * Stat entries without a matching rostered player are included as-is.
+ *
+ * @param params.season Season in YYYYYYYY format, e.g. 20232024
+ * @param params.apiSleepRate Seconds to sleep between team requests. Defaults to 1.
+ * @example await client.helpers.allPlayersSummaryStatistics({ season: '20232024' })
+ */
+export const allPlayersSummaryStatistics = async (ctx, { season, apiSleepRate = 1 }) => {
+    console.error('WARNING: This method will take a while to run.  In the event of rate limiting, you may need to increase the api_sleep_rate.');
+    const players = await allPlayers(ctx, { season, apiSleepRate });
+    const teams = await fetchTeams(ctx);
+    const outData = [];
+    for (const team of teams) {
+        await ctx.sleep(apiSleepRate);
+        const context = buildQuery([
+            filter.franchise(team.franchise_id),
+            filter.season(season, season),
+        ]);
+        const data = await skaterStatsWithQueryContext(ctx, {
+            reportType: 'summary',
+            queryContext: context,
+            aggregate: true,
+        });
+        outData.push(...(data.data ?? []));
+    }
+    const playerById = new Map(players.map((player) => [player.id, player]));
+    return outData.map((statEntry) => {
+        const player = statEntry.playerId
+            ? playerById.get(statEntry.playerId)
+            : undefined;
+        return player ? { ...player, ...statEntry } : statEntry;
+    });
+};
+export const helpersApi = {
+    gameIdsBySeason,
+    allPlayers,
+    allPlayersSummaryStatistics,
+};

package/dist/api/misc.d.mts

@@ -0,0 +1,40 @@
+import type { Context } from '#src/context.mjs';
+import type { JsonObject } from '#src/utils.mjs';
+/**
+ * Gets the full NHL glossary of statistical terms and abbreviations.
+ *
+ * @example https://api.nhle.com/stats/rest/en/glossary?sort=fullName
+ */
+export declare const glossary: (ctx: Context) => Promise<JsonObject[]>;
+/**
+ * Gets the stats API configuration, including available report types and
+ * filters.
+ *
+ * @example https://api.nhle.com/stats/rest/en/config
+ */
+export declare const config: (ctx: Context) => Promise<JsonObject>;
+/**
+ * Gets the list of countries recognized by the NHL.
+ *
+ * @example https://api.nhle.com/stats/rest/en/country
+ */
+export declare const countries: (ctx: Context) => Promise<JsonObject[]>;
+/**
+ * Gets rules and metadata for every NHL season on record.
+ *
+ * @example https://api.nhle.com/stats/rest/en/season
+ */
+export declare const seasonSpecificRulesAndInfo: (ctx: Context) => Promise<JsonObject[]>;
+/**
+ * Gets the number of rounds for each NHL draft year.
+ *
+ * @example https://api.nhle.com/stats/rest/en/draft
+ */
+export declare const draftYearAndRounds: (ctx: Context) => Promise<JsonObject[]>;
+export declare const miscApi: {
+    readonly glossary: typeof glossary;
+    readonly config: typeof config;
+    readonly countries: typeof countries;
+    readonly seasonSpecificRulesAndInfo: typeof seasonSpecificRulesAndInfo;
+    readonly draftYearAndRounds: typeof draftYearAndRounds;
+};

package/dist/api/misc.mjs

@@ -0,0 +1,43 @@
+import { Endpoint } from '#src/http-client.mjs';
+async function getData(ctx, resource) {
+    const response = await (await ctx.get(Endpoint.API_CORE, resource)).json();
+    return response.data ?? [];
+}
+/**
+ * Gets the full NHL glossary of statistical terms and abbreviations.
+ *
+ * @example https://api.nhle.com/stats/rest/en/glossary?sort=fullName
+ */
+export const glossary = async (ctx) => getData(ctx, 'stats/rest/en/glossary?sort=fullName');
+/**
+ * Gets the stats API configuration, including available report types and
+ * filters.
+ *
+ * @example https://api.nhle.com/stats/rest/en/config
+ */
+export const config = async (ctx) => (await ctx.get(Endpoint.API_CORE, 'stats/rest/en/config')).json();
+/**
+ * Gets the list of countries recognized by the NHL.
+ *
+ * @example https://api.nhle.com/stats/rest/en/country
+ */
+export const countries = async (ctx) => getData(ctx, 'stats/rest/en/country');
+/**
+ * Gets rules and metadata for every NHL season on record.
+ *
+ * @example https://api.nhle.com/stats/rest/en/season
+ */
+export const seasonSpecificRulesAndInfo = async (ctx) => getData(ctx, 'stats/rest/en/season');
+/**
+ * Gets the number of rounds for each NHL draft year.
+ *
+ * @example https://api.nhle.com/stats/rest/en/draft
+ */
+export const draftYearAndRounds = async (ctx) => getData(ctx, 'stats/rest/en/draft');
+export const miscApi = {
+    glossary,
+    config,
+    countries,
+    seasonSpecificRulesAndInfo,
+    draftYearAndRounds,
+};

package/dist/api/players.d.mts

@@ -0,0 +1,27 @@
+import type { Context } from '#src/context.mjs';
+import type { Id, JsonObject } from '#src/utils.mjs';
+/**
+ * Gets prospects for a specific team, grouped by position.
+ *
+ * @param params.teamAbbr Team abbreviation, e.g. BUF, TOR
+ * @example https://api-web.nhle.com/v1/prospects/BUF
+ */
+export declare const prospectsByTeam: (ctx: Context, { teamAbbr }: {
+    teamAbbr: string;
+}) => Promise<JsonObject>;
+/**
+ * Gets the roster for a given team and season, grouped by position
+ * (forwards, defensemen, goalies). Same data as `teams.teamRoster`.
+ *
+ * @param params.teamAbbr Team abbreviation, e.g. BUF, TOR
+ * @param params.season Season in YYYYYYYY format, e.g. 20232024
+ * @example https://api-web.nhle.com/v1/roster/BUF/20232024
+ */
+export declare const playersByTeam: (ctx: Context, { teamAbbr, season }: {
+    teamAbbr: string;
+    season: Id;
+}) => Promise<JsonObject>;
+export declare const playersApi: {
+    readonly prospectsByTeam: typeof prospectsByTeam;
+    readonly playersByTeam: typeof playersByTeam;
+};

package/dist/api/players.mjs

@@ -0,0 +1,18 @@
+import { Endpoint } from '#src/http-client.mjs';
+/**
+ * Gets prospects for a specific team, grouped by position.
+ *
+ * @param params.teamAbbr Team abbreviation, e.g. BUF, TOR
+ * @example https://api-web.nhle.com/v1/prospects/BUF
+ */
+export const prospectsByTeam = async (ctx, { teamAbbr }) => (await ctx.get(Endpoint.API_WEB_V1, `prospects/${teamAbbr}`)).json();
+/**
+ * Gets the roster for a given team and season, grouped by position
+ * (forwards, defensemen, goalies). Same data as `teams.teamRoster`.
+ *
+ * @param params.teamAbbr Team abbreviation, e.g. BUF, TOR
+ * @param params.season Season in YYYYYYYY format, e.g. 20232024
+ * @example https://api-web.nhle.com/v1/roster/BUF/20232024
+ */
+export const playersByTeam = async (ctx, { teamAbbr, season }) => (await ctx.get(Endpoint.API_WEB_V1, `roster/${teamAbbr}/${season}`)).json();
+export const playersApi = { prospectsByTeam, playersByTeam };

package/dist/api/query/builder.d.mts

@@ -0,0 +1,20 @@
+import type { Filter } from '#src/api/query/filters.mjs';
+/**
+ * A container for query information and validation state: the constructed
+ * query string, the original filters, any validation errors and a base fact
+ * query (defaults to "gamesPlayed>=1").
+ */
+export interface QueryContext {
+    readonly query: string;
+    readonly filters: readonly Filter[];
+    readonly errors: readonly string[];
+    readonly factQuery: string;
+}
+/**
+ * Builds and validates a query string from a list of filters. Invalid
+ * filters are skipped and their errors collected; valid filters are joined
+ * with " and ".
+ */
+export declare function buildQuery(filters: readonly Filter[], factQuery?: string): QueryContext;
+/** True if there are no validation errors. */
+export declare function isValidQuery(context: QueryContext): boolean;

package/dist/api/query/builder.mjs

@@ -0,0 +1,28 @@
+import { toQuery, validateFilter } from '#src/api/query/filters.mjs';
+/**
+ * Builds and validates a query string from a list of filters. Invalid
+ * filters are skipped and their errors collected; valid filters are joined
+ * with " and ".
+ */
+export function buildQuery(filters, factQuery = 'gamesPlayed>=1') {
+    const outputFilters = [];
+    const errors = [];
+    for (const filter of filters) {
+        const error = validateFilter(filter);
+        if (error) {
+            errors.push(error);
+            continue;
+        }
+        outputFilters.push(toQuery(filter));
+    }
+    return {
+        query: outputFilters.join(' and '),
+        filters,
+        errors,
+        factQuery,
+    };
+}
+/** True if there are no validation errors. */
+export function isValidQuery(context) {
+    return context.errors.length === 0;
+}

package/dist/api/query/errors.d.mts

@@ -0,0 +1,3 @@
+export declare class InvalidQueryValueException extends Error {
+    constructor(message: string);
+}

package/dist/api/query/errors.mjs

@@ -0,0 +1,6 @@
+export class InvalidQueryValueException extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'InvalidQueryValueException';
+    }
+}

package/dist/api/query/filters/base.d.mts

@@ -0,0 +1,4 @@
+export declare abstract class QueryBase {
+    abstract toQuery(): string;
+    abstract validate(): boolean | undefined;
+}

package/dist/api/query/filters/base.mjs

@@ -0,0 +1,2 @@
+export class QueryBase {
+}

package/dist/api/query/filters/decision.d.mts

@@ -0,0 +1,13 @@
+import { QueryBase } from '#src/api/query/filters/base.mjs';
+export declare class DecisionQuery extends QueryBase {
+    readonly decision: string;
+    private readonly decisionQ;
+    /**
+     * Decision filter. W=win, L=loss, O=overtime loss.
+     * @param decision W, L, O
+     */
+    constructor(decision: string);
+    toString(): string;
+    toQuery(): string;
+    validate(): boolean;
+}

package/dist/api/query/filters/decision.mjs

@@ -0,0 +1,26 @@
+import { InvalidQueryValueException } from '#src/api/query/errors.mjs';
+import { QueryBase } from '#src/api/query/filters/base.mjs';
+export class DecisionQuery extends QueryBase {
+    decision;
+    decisionQ = 'decision';
+    /**
+     * Decision filter. W=win, L=loss, O=overtime loss.
+     * @param decision W, L, O
+     */
+    constructor(decision) {
+        super();
+        this.decision = decision;
+    }
+    toString() {
+        return `DecisionQuery: Value=${this.decision}`;
+    }
+    toQuery() {
+        return `${this.decisionQ}='${this.decision}'`;
+    }
+    validate() {
+        if (!['W', 'L', 'O'].includes(this.decision)) {
+            throw new InvalidQueryValueException('Decision value must be one of [W, L, O]');
+        }
+        return true;
+    }
+}

package/dist/api/query/filters/draft.d.mts

@@ -0,0 +1,15 @@
+import { QueryBase } from '#src/api/query/filters/base.mjs';
+import type { Id } from '#src/utils.mjs';
+export declare class DraftQuery extends QueryBase {
+    readonly year: Id;
+    readonly round?: Id;
+    private readonly yearQ;
+    private readonly roundQ;
+    /**
+     * @param year Draft year
+     * @param draftRound Optional draft round. The API seems to default this to "1".
+     */
+    constructor(year: Id, draftRound?: Id);
+    toQuery(): string;
+    validate(): boolean;
+}

package/dist/api/query/filters/draft.mjs

@@ -0,0 +1,27 @@
+import { QueryBase } from '#src/api/query/filters/base.mjs';
+export class DraftQuery extends QueryBase {
+    year;
+    round;
+    yearQ = 'draftYear';
+    roundQ = 'draftRound';
+    /**
+     * @param year Draft year
+     * @param draftRound Optional draft round. The API seems to default this to "1".
+     */
+    constructor(year, draftRound) {
+        super();
+        this.year = year;
+        this.round = draftRound;
+    }
+    toQuery() {
+        let query = `${this.yearQ}=${this.year}`;
+        if (this.round) {
+            query += ' and ';
+            query += `${this.roundQ}=${this.round}`;
+        }
+        return query;
+    }
+    validate() {
+        return true;
+    }
+}

package/dist/api/query/filters/experience.d.mts

@@ -0,0 +1,9 @@
+import { QueryBase } from '#src/api/query/filters/base.mjs';
+export declare class ExperienceQuery extends QueryBase {
+    readonly isRookie: boolean;
+    private readonly experienceQ;
+    /** Experience filter. true = rookies only, false = veterans only. */
+    constructor(isRookie: boolean);
+    toQuery(): string;
+    validate(): boolean;
+}

package/dist/api/query/filters/experience.mjs

@@ -0,0 +1,17 @@
+import { QueryBase } from '#src/api/query/filters/base.mjs';
+export class ExperienceQuery extends QueryBase {
+    isRookie;
+    experienceQ = 'isRookie';
+    /** Experience filter. true = rookies only, false = veterans only. */
+    constructor(isRookie) {
+        super();
+        this.isRookie = isRookie;
+    }
+    toQuery() {
+        const val = this.isRookie ? '1' : '0';
+        return `${this.experienceQ}='${val}'`;
+    }
+    validate() {
+        return true;
+    }
+}

package/dist/api/query/filters/franchise.d.mts

@@ -0,0 +1,9 @@
+import { QueryBase } from '#src/api/query/filters/base.mjs';
+import type { Id } from '#src/utils.mjs';
+export declare class FranchiseQuery extends QueryBase {
+    readonly franchiseId: Id;
+    private readonly franchiseQ;
+    constructor(franchiseId: Id);
+    toQuery(): string;
+    validate(): boolean;
+}

package/dist/api/query/filters/franchise.mjs

@@ -0,0 +1,15 @@
+import { QueryBase } from '#src/api/query/filters/base.mjs';
+export class FranchiseQuery extends QueryBase {
+    franchiseId;
+    franchiseQ = 'franchiseId';
+    constructor(franchiseId) {
+        super();
+        this.franchiseId = franchiseId;
+    }
+    toQuery() {
+        return `${this.franchiseQ}=${this.franchiseId}`;
+    }
+    validate() {
+        return true;
+    }
+}

package/dist/api/query/filters/game-type.d.mts

@@ -0,0 +1,10 @@
+import { QueryBase } from '#src/api/query/filters/base.mjs';
+import type { Id } from '#src/utils.mjs';
+export declare class GameTypeQuery extends QueryBase {
+    readonly gameType: Id;
+    private readonly gameTypeQ;
+    /** @param gameType 1=Preseason, 2=Regular season, 3=Playoffs */
+    constructor(gameType: Id);
+    toQuery(): string;
+    validate(): boolean;
+}