nhl-api-ts 0.2.1 → 0.3.0

package/dist/api/edge.mjs

@@ -1,14 +1,39 @@
 import { Endpoint } from '#src/http-client.mjs';
-/** "<path>/<id>/now" when no season is given, else "<path>/<id>/<season>/<gameType>". */
-function edgeResource(path, id, { season, gameType = 2 }) {
-    const base = id === undefined ? path : `${path}/${id}`;
+/** Player positions of an EDGE top-10 leaderboard. */
+export const EdgePositions = {
+    ALL: 'all',
+    FORWARDS: 'forwards',
+    DEFENSE: 'defense',
+};
+/** Game strengths of an EDGE top-10 leaderboard. */
+export const EdgeStrengths = {
+    ALL: 'all',
+    EVEN: 'es',
+    POWER_PLAY: 'pp',
+    PENALTY_KILL: 'pk',
+};
+/** Rink zones; the `sortBy` of the zone time top-10s. */
+export const EdgeZones = {
+    OFFENSIVE: 'offensive',
+    NEUTRAL: 'neutral',
+    DEFENSIVE: 'defensive',
+};
+/**
+ * "<path>/<segments...>/now" when no season is given, else
+ * "<path>/<segments...>/<season>/<gameType>".
+ */
+function edgeResource(path, segments, { season, gameType = 2 }) {
+    const base = [path, ...segments].join('/');
     if (season === undefined || season === null) {
         return `${base}/now`;
     }
     return `${base}/${season}/${gameType}`;
 }
+async function getEdgeSegments(ctx, path, segments, params) {
+    return (await ctx.get(Endpoint.API_WEB_V1, edgeResource(path, segments, params))).json();
+}
 async function getEdge(ctx, path, id, params) {
-    return (await ctx.get(Endpoint.API_WEB_V1, edgeResource(path, id, params))).json();
+    return getEdgeSegments(ctx, path, id === undefined ? [] : [id], params);
 }
 // ========================
 // SKATER ENDPOINTS
@@ -203,6 +228,169 @@ export async function teamShotSpeedDetail(ctx, params) {
 export async function teamSkatingSpeedDetail(ctx, params) {
     return getEdge(ctx, 'edge/team-skating-speed-detail', params.teamId, params);
 }
+// ========================
+// LEADERBOARDS (TOP 10)
+// ========================
+/**
+ * Get the NHL EDGE top 10 skaters by skating distance.
+ *
+ * @param params.positions 'all' (default), 'forwards' or 'defense'
+ * @param params.strength 'all' (default), 'es', 'pp' or 'pk'
+ * @param params.sortBy 'total', 'per-60', 'max-game' or 'max-period'
+ * @example https://api-web.nhle.com/v1/edge/skater-distance-top-10/all/all/total/20252026/2
+ */
+export async function skaterDistanceTop10(ctx, { positions = EdgePositions.ALL, strength = EdgeStrengths.ALL, sortBy, ...params }) {
+    return getEdgeSegments(ctx, 'edge/skater-distance-top-10', [positions, strength, sortBy], params);
+}
+/**
+ * Get the NHL EDGE top 10 skaters by skating speed.
+ *
+ * @param params.positions 'all' (default), 'forwards' or 'defense'
+ * @param params.sortBy 'max', 'over-22', '20-22' or '18-20' (bursts in mph)
+ * @example https://api-web.nhle.com/v1/edge/skater-speed-top-10/all/max/20252026/2
+ */
+export async function skaterSpeedTop10(ctx, { positions = EdgePositions.ALL, sortBy, ...params }) {
+    return getEdgeSegments(ctx, 'edge/skater-speed-top-10', [positions, sortBy], params);
+}
+/**
+ * Get the NHL EDGE top 10 skaters by zone time.
+ *
+ * @param params.positions 'all' (default), 'forwards' or 'defense'
+ * @param params.strength 'all' (default), 'es', 'pp' or 'pk'
+ * @param params.sortBy Zone: 'offensive', 'neutral' or 'defensive'. See `EdgeZones`.
+ * @example https://api-web.nhle.com/v1/edge/skater-zone-time-top-10/all/all/offensive/20252026/2
+ */
+export async function skaterZoneTimeTop10(ctx, { positions = EdgePositions.ALL, strength = EdgeStrengths.ALL, sortBy, ...params }) {
+    return getEdgeSegments(ctx, 'edge/skater-zone-time-top-10', [positions, strength, sortBy], params);
+}
+/**
+ * Get the NHL EDGE top 10 skaters by shot speed.
+ *
+ * @param params.positions 'all' (default), 'forwards' or 'defense'
+ * @param params.sortBy 'max', 'over-100', '90-99', '80-89' or '70-79' (attempts in mph)
+ * @example https://api-web.nhle.com/v1/edge/skater-shot-speed-top-10/all/max/20252026/2
+ */
+export async function skaterShotSpeedTop10(ctx, { positions = EdgePositions.ALL, sortBy, ...params }) {
+    return getEdgeSegments(ctx, 'edge/skater-shot-speed-top-10', [positions, sortBy], params);
+}
+/**
+ * Get the NHL EDGE top 10 skaters by shot location. `sortBy` comes before
+ * `category` in the URL (the NHL-API-Reference has them the other way round,
+ * which 404s).
+ *
+ * @param params.positions 'all' (default), 'forwards' or 'defense'. 'F' / 'D' are a 404 here.
+ * @param params.sortBy 'sog', 'goals' or 'shooting-pctg'
+ * @param params.category 'all' (default), 'high', 'mid' or 'long'
+ * @example https://api-web.nhle.com/v1/edge/skater-shot-location-top-10/all/sog/all/20252026/2
+ */
+export async function skaterShotLocationTop10(ctx, { positions = EdgePositions.ALL, sortBy, category = 'all', ...params }) {
+    return getEdgeSegments(ctx, 'edge/skater-shot-location-top-10', [positions, sortBy, category], params);
+}
+/**
+ * Get the NHL EDGE top 10 goalies by 5v5 performance.
+ *
+ * @param params.sortBy 'save-pctg', 'save-pctg-close', 'shots' or 'shots-per-60'
+ * @example https://api-web.nhle.com/v1/edge/goalie-5v5-top-10/save-pctg/20252026/2
+ */
+export async function goalie5v5Top10(ctx, { sortBy, ...params }) {
+    return getEdgeSegments(ctx, 'edge/goalie-5v5-top-10', [sortBy], params);
+}
+/**
+ * Get the NHL EDGE top 10 goalies by shot location.
+ *
+ * @param params.sortBy 'save-pctg', 'saves', 'goals-against' or 'shots-against'
+ * @param params.category 'all' (default), 'high', 'mid' or 'long'
+ * @example https://api-web.nhle.com/v1/edge/goalie-shot-location-top-10/save-pctg/all/20252026/2
+ */
+export async function goalieShotLocationTop10(ctx, { sortBy, category = 'all', ...params }) {
+    return getEdgeSegments(ctx, 'edge/goalie-shot-location-top-10', [sortBy, category], params);
+}
+/**
+ * Get the NHL EDGE top 10 goalies by games above a .900 save percentage.
+ *
+ * @param params.sortBy 'games' (count) or 'pctg' (share of games played)
+ * @example https://api-web.nhle.com/v1/edge/goalie-edge-save-pctg-top-10/games/20252026/2
+ */
+export async function goalieSavePercentageTop10(ctx, { sortBy, ...params }) {
+    return getEdgeSegments(ctx, 'edge/goalie-edge-save-pctg-top-10', [sortBy], params);
+}
+/**
+ * Get the NHL EDGE top 10 teams by skating distance.
+ *
+ * @param params.positions 'all' (default), 'forwards' or 'defense'
+ * @param params.strength 'all' (default), 'es', 'pp' or 'pk'
+ * @param params.sortBy 'total', 'per-60', 'max-game' or 'max-period'
+ * @example https://api-web.nhle.com/v1/edge/team-skating-distance-top-10/all/all/total/20252026/2
+ */
+export async function teamSkatingDistanceTop10(ctx, { positions = EdgePositions.ALL, strength = EdgeStrengths.ALL, sortBy, ...params }) {
+    return getEdgeSegments(ctx, 'edge/team-skating-distance-top-10', [positions, strength, sortBy], params);
+}
+/**
+ * Get the NHL EDGE top 10 teams by skating speed.
+ *
+ * @param params.positions 'all' (default), 'forwards' or 'defense'
+ * @param params.sortBy 'max', 'over-22', '20-22' or '18-20' (bursts in mph)
+ * @example https://api-web.nhle.com/v1/edge/team-skating-speed-top-10/all/max/20252026/2
+ */
+export async function teamSkatingSpeedTop10(ctx, { positions = EdgePositions.ALL, sortBy, ...params }) {
+    return getEdgeSegments(ctx, 'edge/team-skating-speed-top-10', [positions, sortBy], params);
+}
+/**
+ * Get the NHL EDGE top 10 teams by zone time. There is no `positions` slot.
+ *
+ * @param params.strength 'all' (default), 'es', 'pp' or 'pk'
+ * @param params.sortBy Zone: 'offensive', 'neutral' or 'defensive'. See `EdgeZones`.
+ * @example https://api-web.nhle.com/v1/edge/team-zone-time-top-10/es/offensive/20242025/2
+ */
+export async function teamZoneTimeTop10(ctx, { strength = EdgeStrengths.ALL, sortBy, ...params }) {
+    return getEdgeSegments(ctx, 'edge/team-zone-time-top-10', [strength, sortBy], params);
+}
+/**
+ * Get the NHL EDGE top 10 teams by shot speed.
+ *
+ * @param params.positions 'all' (default), 'forwards' or 'defense'
+ * @param params.sortBy 'max', 'over-100', '90-99', '80-89' or '70-79' (attempts in mph)
+ * @example https://api-web.nhle.com/v1/edge/team-shot-speed-top-10/all/max/20252026/2
+ */
+export async function teamShotSpeedTop10(ctx, { positions = EdgePositions.ALL, sortBy, ...params }) {
+    return getEdgeSegments(ctx, 'edge/team-shot-speed-top-10', [positions, sortBy], params);
+}
+/**
+ * Get the NHL EDGE top 10 teams by shot location. `sortBy` comes before
+ * `category` in the URL (the NHL-API-Reference has them the other way round,
+ * which 404s).
+ *
+ * @param params.positions 'all' (default), 'forwards' or 'defense'. 'F' / 'D' are a 404 here.
+ * @param params.sortBy 'sog', 'goals' or 'shooting-pctg'
+ * @param params.category 'all' (default), 'high', 'mid' or 'long'
+ * @example https://api-web.nhle.com/v1/edge/team-shot-location-top-10/all/sog/all/20252026/2
+ */
+export async function teamShotLocationTop10(ctx, { positions = EdgePositions.ALL, sortBy, category = 'all', ...params }) {
+    return getEdgeSegments(ctx, 'edge/team-shot-location-top-10', [positions, sortBy, category], params);
+}
+/**
+ * Get the NHL EDGE comparison statistics for a specific team.
+ *
+ * @param params.teamId NHL team id, e.g. 10
+ * @example await client.edge.teamComparison({ teamId: 10 })
+ */
+export async function teamComparison(ctx, params) {
+    return getEdge(ctx, 'edge/team-comparison', params.teamId, params);
+}
+// ========================
+// LEAGUE ENDPOINTS
+// ========================
+/**
+ * Get the NHL EDGE "by the numbers" league highlights. Without a season this
+ * is the latest game night (`games`, `gameDate` and the nightly leaders);
+ * with a season it is the season bests (hardest shot, top speed, longest
+ * distance in a game).
+ *
+ * @example https://api-web.nhle.com/v1/edge/by-the-numbers/now
+ */
+export async function byTheNumbers(ctx, params = {}) {
+    return getEdge(ctx, 'edge/by-the-numbers', undefined, params);
+}
 export const edgeApi = {
     skaterDetail,
     skaterShotSpeedDetail,
@@ -227,4 +415,19 @@ export const edgeApi = {
     teamLanding,
     teamShotSpeedDetail,
     teamSkatingSpeedDetail,
+    skaterDistanceTop10,
+    skaterSpeedTop10,
+    skaterZoneTimeTop10,
+    skaterShotSpeedTop10,
+    skaterShotLocationTop10,
+    goalie5v5Top10,
+    goalieShotLocationTop10,
+    goalieSavePercentageTop10,
+    teamSkatingDistanceTop10,
+    teamSkatingSpeedTop10,
+    teamZoneTimeTop10,
+    teamShotSpeedTop10,
+    teamShotLocationTop10,
+    teamComparison,
+    byTheNumbers,
 };

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

@@ -1,5 +1,5 @@
 import type { Context } from '#src/context.mjs';
-import type { Boxscore, DailyScores, GameLanding, GameStory, PlayByPlay, RightRail, ShiftChart } from '#src/types/index.mjs';
+import type { Boxscore, DailyScores, GameLanding, GameMeta, GameStory, PlayByPlay, PlayReplay, RightRail, Scoreboard, ShiftChart, WscPlay } from '#src/types/index.mjs';
 import type { Id } from '#src/utils.mjs';
 /**
  * Get the full boxscore for a specific NHL game, including team scores,
@@ -73,6 +73,50 @@ export declare function seasonSeriesMatchup(ctx: Context, { gameId }: {
 export declare function gameStory(ctx: Context, { gameId }: {
     gameId: Id;
 }): Promise<GameStory>;
+/**
+ * Get the league scoreboard: every game in the week around a date, grouped by
+ * date. Returns the week around today when no date is supplied.
+ *
+ * @param params.date Date in YYYY-MM-DD format. Defaults to "now".
+ * @example https://api-web.nhle.com/v1/scoreboard/2023-10-15
+ */
+export declare function scoreboard(ctx: Context, { date }?: {
+    date?: string;
+}): Promise<Scoreboard>;
+/**
+ * Get the play-by-play feed nhl.com's game story widget uses. A bare array of
+ * plays, with a different play shape from `playByPlay`.
+ *
+ * @param params.gameId Game id, e.g. 2023020280
+ * @example https://api-web.nhle.com/v1/wsc/play-by-play/2023020280
+ */
+export declare function wscPlayByPlay(ctx: Context, { gameId }: {
+    gameId: Id;
+}): Promise<WscPlay[]>;
+/**
+ * Get the replay card for one play-by-play event: the game header, plus a
+ * `goal` object (scorer, assists, highlight clip and the `pptReplayUrl`
+ * puck-and-player-tracking link) when the event is a goal. Any event id works.
+ *
+ * @experimental Feeds an nhl.com widget; the shape may change without notice.
+ * @param params.gameId Game id, e.g. 2023020280
+ * @param params.eventNumber The play's `eventId` from `playByPlay`, e.g. 193
+ * @example https://api-web.nhle.com/v1/ppt-replay/2023020280/193
+ */
+export declare function playReplay(ctx: Context, { gameId, eventNumber }: {
+    gameId: Id;
+    eventNumber: Id;
+}): Promise<PlayReplay>;
+/**
+ * Get the metadata nhl.com uses to render a game page: the two teams, the
+ * season state and the game state.
+ *
+ * @param params.gameId Game id, e.g. 2023020280
+ * @example https://api-web.nhle.com/v1/meta/game/2023020280
+ */
+export declare function gameMeta(ctx: Context, { gameId }: {
+    gameId: Id;
+}): Promise<GameMeta>;
 export declare const gameCenterApi: {
     readonly boxscore: typeof boxscore;
     readonly playByPlay: typeof playByPlay;
@@ -81,4 +125,8 @@ export declare const gameCenterApi: {
     readonly shiftChartData: typeof shiftChartData;
     readonly seasonSeriesMatchup: typeof seasonSeriesMatchup;
     readonly gameStory: typeof gameStory;
+    readonly scoreboard: typeof scoreboard;
+    readonly wscPlayByPlay: typeof wscPlayByPlay;
+    readonly playReplay: typeof playReplay;
+    readonly gameMeta: typeof gameMeta;
 };

package/dist/api/game-center.mjs

@@ -75,6 +75,49 @@ export async function seasonSeriesMatchup(ctx, { gameId }) {
 export async function gameStory(ctx, { gameId }) {
     return getWeb(ctx, `wsc/game-story/${gameId}`);
 }
+/**
+ * Get the league scoreboard: every game in the week around a date, grouped by
+ * date. Returns the week around today when no date is supplied.
+ *
+ * @param params.date Date in YYYY-MM-DD format. Defaults to "now".
+ * @example https://api-web.nhle.com/v1/scoreboard/2023-10-15
+ */
+export async function scoreboard(ctx, { date } = {}) {
+    return getWeb(ctx, `scoreboard/${date ?? 'now'}`);
+}
+/**
+ * Get the play-by-play feed nhl.com's game story widget uses. A bare array of
+ * plays, with a different play shape from `playByPlay`.
+ *
+ * @param params.gameId Game id, e.g. 2023020280
+ * @example https://api-web.nhle.com/v1/wsc/play-by-play/2023020280
+ */
+export async function wscPlayByPlay(ctx, { gameId }) {
+    return getWeb(ctx, `wsc/play-by-play/${gameId}`);
+}
+/**
+ * Get the replay card for one play-by-play event: the game header, plus a
+ * `goal` object (scorer, assists, highlight clip and the `pptReplayUrl`
+ * puck-and-player-tracking link) when the event is a goal. Any event id works.
+ *
+ * @experimental Feeds an nhl.com widget; the shape may change without notice.
+ * @param params.gameId Game id, e.g. 2023020280
+ * @param params.eventNumber The play's `eventId` from `playByPlay`, e.g. 193
+ * @example https://api-web.nhle.com/v1/ppt-replay/2023020280/193
+ */
+export async function playReplay(ctx, { gameId, eventNumber }) {
+    return getWeb(ctx, `ppt-replay/${gameId}/${eventNumber}`);
+}
+/**
+ * Get the metadata nhl.com uses to render a game page: the two teams, the
+ * season state and the game state.
+ *
+ * @param params.gameId Game id, e.g. 2023020280
+ * @example https://api-web.nhle.com/v1/meta/game/2023020280
+ */
+export async function gameMeta(ctx, { gameId }) {
+    return getWeb(ctx, `meta/game/${gameId}`);
+}
 export const gameCenterApi = {
     boxscore,
     playByPlay,
@@ -83,4 +126,8 @@ export const gameCenterApi = {
     shiftChartData,
     seasonSeriesMatchup,
     gameStory,
+    scoreboard,
+    wscPlayByPlay,
+    playReplay,
+    gameMeta,
 };

package/dist/api/misc.d.mts

@@ -1,5 +1,6 @@
 import type { Context } from '#src/context.mjs';
-import type { Country, DraftYear, GlossaryEntry, SeasonRules, StatsConfig } from '#src/types/index.mjs';
+import type { ComponentSeason, Country, DraftYear, GeoLocation, GlossaryEntry, Meta, PartnerGameOdds, PostalLookupTeam, SeasonId, SeasonRules, StatsConfig, StatsGame, TvSchedule } from '#src/types/index.mjs';
+import type { Id } from '#src/utils.mjs';
 /**
  * Gets the full NHL glossary of statistical terms and abbreviations.
  *
@@ -31,10 +32,123 @@ export declare function seasonSpecificRulesAndInfo(ctx: Context): Promise<Season
  * @example https://api.nhle.com/stats/rest/en/draft
  */
 export declare function draftYearAndRounds(ctx: Context): Promise<DraftYear[]>;
+/**
+ * Gets the season and game type the stats API currently serves by default.
+ *
+ * @example https://api.nhle.com/stats/rest/en/componentSeason
+ */
+export declare function componentSeasons(ctx: Context): Promise<ComponentSeason[]>;
+export interface GamesParams {
+    /** Season in YYYYYYYY format, e.g. 20232024 (about 1,500 games). */
+    season?: Id;
+    /** 1=Preseason, 2=Regular season, 3=Playoffs. */
+    gameType?: number;
+    /** NHL team id, home or away, e.g. 10. */
+    teamId?: Id;
+    /** First game date, YYYY-MM-DD (inclusive). */
+    startDate?: string;
+    /** Last game date, YYYY-MM-DD (inclusive). */
+    endDate?: string;
+    /**
+     * Extra filter expression, joined to the others with `and`. Only the row
+     * fields (`season`, `gameType`, `gameDate`, `homeTeamId`, ...) can be
+     * filtered; report columns like `seasonId` are a 400.
+     */
+    cayenneExp?: string;
+}
+/**
+ * Gets games from the stats API. At least one filter is required:
+ * unfiltered, the API sends every game ever played (about 19 MB).
+ *
+ * @param params.season Season in YYYYYYYY format, e.g. 20232024
+ * @param params.gameType 1=Preseason, 2=Regular season, 3=Playoffs
+ * @param params.teamId NHL team id, home or away, e.g. 10
+ * @param params.startDate First game date, YYYY-MM-DD
+ * @param params.endDate Last game date, YYYY-MM-DD
+ * @param params.cayenneExp Extra filter expression, e.g. "homeScore>=7"
+ * @throws RangeError When no filter is given, or a date is not YYYY-MM-DD
+ * @example await client.misc.games({ season: 20232024, teamId: 10, gameType: 3 })
+ */
+export declare function games(ctx: Context, params: GamesParams): Promise<StatsGame[]>;
+/**
+ * Gets the national TV schedule for the week around a date, grouped by date.
+ *
+ * @param params.date Date in YYYY-MM-DD format. Defaults to "now".
+ * @example https://api-web.nhle.com/v1/network/tv-schedule/2023-10-15
+ */
+export declare function tvSchedule(ctx: Context, { date }?: {
+    date?: string;
+}): Promise<TvSchedule>;
+/**
+ * Gets betting odds for today's games from the NHL's odds partner in a
+ * country.
+ *
+ * @experimental Feeds an nhl.com widget; the shape may change without notice.
+ * @param params.countryCode Two-letter country code, e.g. US, CA
+ * @example https://api-web.nhle.com/v1/partner-game/US/now
+ */
+export declare function partnerGameOdds(ctx: Context, { countryCode }: {
+    countryCode: string;
+}): Promise<PartnerGameOdds>;
+/**
+ * Gets every NHL season id, oldest first.
+ *
+ * @example https://api-web.nhle.com/v1/season
+ */
+export declare function seasonIds(ctx: Context): Promise<SeasonId[]>;
+/**
+ * Gets display metadata (names, headshots, logos) for players and teams.
+ * Lists you leave out or pass empty come back empty.
+ *
+ * @param params.players Player ids, e.g. [8478402]
+ * @param params.teams Team abbreviations, e.g. ['TOR', 'BUF']
+ * @example https://api-web.nhle.com/v1/meta?players=8478402&teams=TOR,BUF
+ */
+export declare function meta(ctx: Context, { players, teams }?: {
+    players?: Id[];
+    teams?: string[];
+}): Promise<Meta>;
+/**
+ * Gets the caller's country, looked up from their IP address. The answer
+ * depends on where the request comes from.
+ *
+ * @experimental Feeds an nhl.com widget; the shape may change without notice.
+ * @example https://api-web.nhle.com/v1/location
+ */
+export declare function location(ctx: Context): Promise<GeoLocation>;
+/**
+ * Gets the teams whose local broadcast market covers a postal code. Empty
+ * for codes outside every market.
+ *
+ * @experimental Feeds an nhl.com widget; the shape may change without notice.
+ * @param params.postalCode Postal or ZIP code, e.g. 90210 or "M5V 3L9"
+ * @example https://api-web.nhle.com/v1/postal-lookup/90210
+ */
+export declare function postalLookup(ctx: Context, { postalCode }: {
+    postalCode: string;
+}): Promise<PostalLookupTeam[]>;
+/**
+ * Checks that the stats API is up. Resolves `true` on success; it never
+ * resolves `false`, since any failure throws an `NHLApiException` subclass
+ * (or a network error).
+ *
+ * @throws ServerErrorException When the stats API answers 5xx
+ * @example https://api.nhle.com/stats/rest/ping
+ */
+export declare function ping(ctx: Context): Promise<true>;
 export declare const miscApi: {
     readonly glossary: typeof glossary;
     readonly config: typeof config;
     readonly countries: typeof countries;
     readonly seasonSpecificRulesAndInfo: typeof seasonSpecificRulesAndInfo;
     readonly draftYearAndRounds: typeof draftYearAndRounds;
+    readonly componentSeasons: typeof componentSeasons;
+    readonly games: typeof games;
+    readonly tvSchedule: typeof tvSchedule;
+    readonly partnerGameOdds: typeof partnerGameOdds;
+    readonly seasonIds: typeof seasonIds;
+    readonly meta: typeof meta;
+    readonly location: typeof location;
+    readonly postalLookup: typeof postalLookup;
+    readonly ping: typeof ping;
 };

package/dist/api/misc.mjs

@@ -1,8 +1,13 @@
+import { andClauses, cayenneString } from '#src/api/query/cayenne.mjs';
+import { normalizeDate } from '#src/api/schedule.mjs';
 import { Endpoint } from '#src/http-client.mjs';
-async function getData(ctx, resource) {
-    const response = await (await ctx.get(Endpoint.API_CORE, resource)).json();
+async function getData(ctx, resource, queryParams) {
+    const response = await (await ctx.get(Endpoint.API_CORE, resource, queryParams)).json();
     return response.data ?? [];
 }
+async function getWeb(ctx, resource) {
+    return (await ctx.get(Endpoint.API_WEB_V1, resource)).json();
+}
 /**
  * Gets the full NHL glossary of statistical terms and abbreviations.
  *
@@ -44,10 +49,150 @@ export async function seasonSpecificRulesAndInfo(ctx) {
 export async function draftYearAndRounds(ctx) {
     return getData(ctx, 'stats/rest/en/draft');
 }
+/**
+ * Gets the season and game type the stats API currently serves by default.
+ *
+ * @example https://api.nhle.com/stats/rest/en/componentSeason
+ */
+export async function componentSeasons(ctx) {
+    return getData(ctx, 'stats/rest/en/componentSeason');
+}
+function gamesClauses({ season, gameType, teamId, startDate, endDate, cayenneExp, }) {
+    const clauses = [];
+    if (season !== undefined && season !== null) {
+        clauses.push(`season=${season}`);
+    }
+    if (gameType !== undefined) {
+        clauses.push(`gameType=${gameType}`);
+    }
+    if (teamId !== undefined && teamId !== null) {
+        clauses.push(`homeTeamId=${teamId} or visitingTeamId=${teamId}`);
+    }
+    if (startDate !== undefined) {
+        clauses.push(`gameDate>=${cayenneString(normalizeDate(startDate))}`);
+    }
+    if (endDate !== undefined) {
+        clauses.push(`gameDate<=${cayenneString(normalizeDate(endDate))}`);
+    }
+    if (cayenneExp?.trim()) {
+        clauses.push(cayenneExp);
+    }
+    return clauses;
+}
+/**
+ * Gets games from the stats API. At least one filter is required:
+ * unfiltered, the API sends every game ever played (about 19 MB).
+ *
+ * @param params.season Season in YYYYYYYY format, e.g. 20232024
+ * @param params.gameType 1=Preseason, 2=Regular season, 3=Playoffs
+ * @param params.teamId NHL team id, home or away, e.g. 10
+ * @param params.startDate First game date, YYYY-MM-DD
+ * @param params.endDate Last game date, YYYY-MM-DD
+ * @param params.cayenneExp Extra filter expression, e.g. "homeScore>=7"
+ * @throws RangeError When no filter is given, or a date is not YYYY-MM-DD
+ * @example await client.misc.games({ season: 20232024, teamId: 10, gameType: 3 })
+ */
+export async function games(ctx, params) {
+    const clauses = gamesClauses(params);
+    if (clauses.length === 0) {
+        throw new RangeError('Missing filter. Pass season, gameType, teamId, a date or cayenneExp.');
+    }
+    return getData(ctx, 'stats/rest/en/game', {
+        cayenneExp: andClauses(clauses),
+    });
+}
+/**
+ * Gets the national TV schedule for the week around a date, grouped by date.
+ *
+ * @param params.date Date in YYYY-MM-DD format. Defaults to "now".
+ * @example https://api-web.nhle.com/v1/network/tv-schedule/2023-10-15
+ */
+export async function tvSchedule(ctx, { date } = {}) {
+    return getWeb(ctx, `network/tv-schedule/${date ?? 'now'}`);
+}
+/**
+ * Gets betting odds for today's games from the NHL's odds partner in a
+ * country.
+ *
+ * @experimental Feeds an nhl.com widget; the shape may change without notice.
+ * @param params.countryCode Two-letter country code, e.g. US, CA
+ * @example https://api-web.nhle.com/v1/partner-game/US/now
+ */
+export async function partnerGameOdds(ctx, { countryCode }) {
+    return getWeb(ctx, `partner-game/${countryCode}/now`);
+}
+/**
+ * Gets every NHL season id, oldest first.
+ *
+ * @example https://api-web.nhle.com/v1/season
+ */
+export async function seasonIds(ctx) {
+    return getWeb(ctx, 'season');
+}
+/**
+ * Gets display metadata (names, headshots, logos) for players and teams.
+ * Lists you leave out or pass empty come back empty.
+ *
+ * @param params.players Player ids, e.g. [8478402]
+ * @param params.teams Team abbreviations, e.g. ['TOR', 'BUF']
+ * @example https://api-web.nhle.com/v1/meta?players=8478402&teams=TOR,BUF
+ */
+export async function meta(ctx, { players = [], teams = [] } = {}) {
+    const query = {};
+    if (players.length > 0) {
+        query.players = players.join(',');
+    }
+    if (teams.length > 0) {
+        query.teams = teams.join(',');
+    }
+    return (await ctx.get(Endpoint.API_WEB_V1, 'meta', query)).json();
+}
+/**
+ * Gets the caller's country, looked up from their IP address. The answer
+ * depends on where the request comes from.
+ *
+ * @experimental Feeds an nhl.com widget; the shape may change without notice.
+ * @example https://api-web.nhle.com/v1/location
+ */
+export async function location(ctx) {
+    return getWeb(ctx, 'location');
+}
+/**
+ * Gets the teams whose local broadcast market covers a postal code. Empty
+ * for codes outside every market.
+ *
+ * @experimental Feeds an nhl.com widget; the shape may change without notice.
+ * @param params.postalCode Postal or ZIP code, e.g. 90210 or "M5V 3L9"
+ * @example https://api-web.nhle.com/v1/postal-lookup/90210
+ */
+export async function postalLookup(ctx, { postalCode }) {
+    return getWeb(ctx, `postal-lookup/${encodeURIComponent(postalCode)}`);
+}
+/**
+ * Checks that the stats API is up. Resolves `true` on success; it never
+ * resolves `false`, since any failure throws an `NHLApiException` subclass
+ * (or a network error).
+ *
+ * @throws ServerErrorException When the stats API answers 5xx
+ * @example https://api.nhle.com/stats/rest/ping
+ */
+export async function ping(ctx) {
+    await ctx.get(Endpoint.API_CORE, 'stats/rest/ping');
+    return true;
+}
 export const miscApi = {
     glossary,
     config,
     countries,
     seasonSpecificRulesAndInfo,
     draftYearAndRounds,
+    componentSeasons,
+    games,
+    tvSchedule,
+    partnerGameOdds,
+    seasonIds,
+    meta,
+    location,
+    postalLookup,
+    ping,
 };