nhle-api 0.5.3 → 0.6.0

package/CHANGELOG.md

@@ -5,6 +5,84 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.6.0] - 2026-10-03
+
+### Added
+
+- `stats` namespace for the Stats API (`api.nhle.com/stats/rest`): skater, goalie and team reports, leaders, milestones, teams, seasons, games, shift charts, drafts, config, countries, glossary and franchises
+- `getStats(report, params)` for skaters, goalies and teams, with `SkaterReport`, `GoalieReport` and `TeamReport` unions of the report names
+- Response types for every `adv` function (`EdgeSkaterDetail`, `EdgeTeamZoneTime`, ...) and `LocalizedText`
+- `video.metadata(videoId)` for Brightcove video titles, descriptions and sources
+- Root exports: `APIResult`, `NHLClient`, `createNHLClient`, `BASE_URLS`, the error classes (`NHLError`, `NotFoundError`, `ValidationError`...), `ErrorCategory`, `ErrorLogLevel`, and the Cayenne query builder
+- `nhle-api/toolkit` entry point with constants, date helpers, `resolvePath`, `normalizeAbbrev`, the Cayenne query builder, and team branding (colors and logo URLs)
+- `NHLClient` accepts an options object (`baseUrl`, `timeout`, `language`, `headers`, `errorConfig`)
+- Level-aware `logger` and `writeLog`
+- Daily API drift check (`bun run drift`, GitHub workflow "API drift") covering every public function
+- CI on pull requests (lint, typecheck, tests, build, publint and are-the-types-wrong) and a tag-triggered release workflow that publishes with npm trusted publishing
+
+### Changed
+
+- `config` is read on every request, so changing it at runtime takes effect; environment variable configuration was removed
+- Invalid `adv` parameters resolve to a failed result with a `ValidationError` instead of rejecting
+- Date parameters use the NHL's timezone (America/New_York)
+- `require` resolves `.d.cts` type declarations; the package declares `sideEffects: false` and `engines.node >= 18`
+- Stats API: `getPlayerInfo`, `getLeaders`, `getGames`, `teams.getAll` and `teams.getById` take query params before `lang`; `teams.getById` returns a list, matching the API
+
+### Fixed
+
+- The build failed under TypeScript 7; builds use TypeScript 5.9
+- Published types left out `config`, `logConfig`, `logger` and `writeLog`
+- Edge skater and team paths, goalie top-10 save percentage paths and top-10 filter codes (23 endpoints)
+- `postalLookup` sends Canadian postal codes in the only form the API matches
+- `stats.skaters.getStats()` requested an unresolved `{report}` path, report functions sent no `cayenneExp` (HTTP 500), and `getStatsWithFilters` dropped most filters
+- Functions that default to the current season used 2025-26 (the last hardcoded season); the default now follows today's date
+
+### Deprecated
+
+- `gc.game.whereToWatch()`: the endpoint now returns 404
+
+### Removed
+
+- The unused `NHLScoreboard` type
+
+## [0.5.4] - 2026-02-10
+
+### Added
+
+- Added game report tooling scripts for downloading and parsing summaries to support data collection workflows
+- Added PlayerSearchResult response typing for Game Center player search
+- Added test utilities for API response validation
+
+### Changed
+
+- Reworked API response handling to use a `success` field instead of `status`, with simpler error handling
+- Exported `nhlClient` as a named export and updated consumers
+- Renamed the route helper to `resolvePath` and refactored Game Center/Edge Advanced Stats path builders
+- Renamed Game Center and Edge Advanced Stats path modules from `_paths` to `paths` and cleaned up path object naming
+- Restructured Edge Advanced Stats exports and converted module methods to standalone async functions
+- Updated Edge Advanced Stats top10 schema validators to match the new path naming
+- Overloaded game log and playoff series schedule helpers for flexible parameter handling
+- Updated README usage examples and badges
+- Simplified base URL handling in NHL client configuration
+- Enhanced endpoint paths documentation for clarity and completeness across edge-adv module
+
+### Fixed
+
+- Corrected rankings response handling to align with `success` response payloads
+- Removed a stray console log from `getSeason`
+
+### Deprecated
+
+- Marked the player search endpoint as deprecated; use the team roster endpoints for player information instead
+
+### Technical
+
+- Reorganized edge-stats tests and added edge-adv unit tests for goalies, skaters, summary, and teams
+- Updated Game Center test utilities and imports for shared validation helpers
+- Updated test coverage to handle error result objects
+- Removed an unused Game Center index export
+- Updated dependencies and devDependencies (including cheerio and node-html-parser)
+
 ## [0.5.3] - 2025-12-03
 
 ### Added

package/README.md

@@ -1,153 +1,319 @@
-# NHLe API Library
-
-A TypeScript wrapper for the NHLe API with simple, composable functions and full type safety.
-
-## Overview
-
-Access NHLe game data, player statistics, and team information through a clean, functional API. Built with TypeScript for complete type safety and designed for ease of use.
-
-## Installation
-
-To install the package, run:
-
-```bash
-npm install nhle-api
-```
-
-## Usage
-
-Here are some basic examples of how to use the NHLe API library:
-
-```typescript
-import { gc } from "nhle-api";
-
-// Get game landing page data
-const gameInfo = await gc.game.landing(2023020001);
-console.log(gameInfo);
-
-// Get live play-by-play
-const playByPlay = await gc.game.playByPlay(2023020001);
-console.log(playByPlay);
-
-// Get boxscore
-const boxscore = await gc.game.boxscore(2023020001);
-console.log(boxscore);
-
-// Get today's scores
-const scores = await gc.score(new Date());
-console.log(scores);
-
-// Get current scoreboard
-const scoreboard = await gc.scoreboard();
-console.log(scoreboard);
-
-// Get team roster
-const roster = await gc.team.roster("TOR");
-console.log(roster);
-
-// Get player information
-const player = await gc.player.landing(8478402); // Connor McDavid
-console.log(player);
-```
-
-## Configuration
-
-The library supports simple configuration through environment variables:
-
-```bash
-# Set request timeout (in milliseconds, default: 5000)
-export NHLE_API_TIMEOUT=10000
-
-# Set language for responses (en or fr, default: en)
-export NHLE_API_LANGUAGE=en
-
-# Set logging level (silent, error, warn, info, debug; default: warn)
-export NHLE_API_LOGLEVEL=debug
-```
-
-For more details, see [Environment Configuration Documentation](docs/ENVIRONMENT_CONFIG.md).
-
-## API Reference
-
-### Gamecenter API (`gc`)
-
-The primary API for accessing NHL game data, scores, team and player information (live and historical).
-
-#### `gc.game` - Game Data
-
-- `playByPlay(gameId)` - Get play-by-play data for a game
-- `boxscore(gameId)` - Get boxscore for a game
-- `landing(gameId)` - Get landing page data for a game
-- `reports(gameId)` - Get game reports (right rail data)
-- `schedule(date?)` - Get schedule for a specific date (defaults to today)
-- `scheduleCalendar(date?)` - Get schedule calendar for a specific date
-- `playoffBracket(year?)` - Get playoff bracket for a year
-- `playoffSeries(season?)` - Get playoff series for a season
-- `playoffSeriesSchedule(season, seriesLetter)` - Get schedule for a playoff series
-- `whereToWatch()` - Get where to watch information
-- `networkTVSchedule(date?)` - Get network TV schedule
-- `wsc.gameStory(gameId)` - Get game story (web service)
-- `wsc.playByPlay(gameId)` - Get play-by-play (web service)
-- `pptReplay.goal(gameId, eventId)` - Get goal replay data
-- `pptReplay.event(date?)` - Get replay events for a date
-
-#### `gc.score` - Scores & Scoreboards
-
-- `score(date?)` - Get scores for a specific date (defaults to today)
-- `scoreboard()` - Get current scoreboard
-
-#### `gc.team` - Team Data
-
-- `roster(teamCode, season?)` - Get team roster
-- `rosterSeasons(teamCode)` - Get available roster seasons
-- `prospects(teamCode)` - Get team prospects
-- `clubStats(teamCode, season?)` - Get club stats
-- `clubStatsSeason(teamCode)` - Get club stats season
-- `standings(date?)` - Get standings for a date
-- `standingsSeason()` - Get standings by season
-- `schedule.now(teamCode)` - Get team's current schedule
-- `schedule.month(teamCode, month)` - Get team's schedule for a month
-- `schedule.season(teamCode, season)` - Get team's schedule for a season
-
-#### `gc.player` - Player Data
-
-- `landing(playerId)` - Get player landing page data
-- `gameLog(playerId, season?, gameType?)` - Get player game log
-- `spotlight()` - Get featured players
-- `search(query)` - Search for players
-- `statsLeaders.season(season?, gameType?, category?, limit?)` - Get season stats leaders
-- `statsLeaders.current(gameType?, category?, limit?)` - Get current stats leaders
-
-#### `gc.draft` - Draft Data
-
-- `picks(year?)` - Get draft picks for a year
-- `tracker()` - Get draft tracker
-- `rankings(year?)` - Get draft rankings
-
-#### `gc.misc` - Miscellaneous
-
-- `seasons()` - Get all NHL seasons
-- `meta.game(gameId)` - Get game metadata
-- `meta.gameVideo(gameId)` - Get game video metadata
-- `postalLookup(postalCode)` - Lookup location by postal code
-- `location()` - Get current location info
-- `partnerGame(country, date?)` - Get partner game information
-
-### Edge Stats API (`stats`) - _In Development_
-
-Historical and current NHL statistics (functionality being finalized)
-
-### Edge Advanced API (`adv`) - _In Development_
-
-Advanced analytics endpoints (functionality being finalized)
-
-## Docs
-
-- [Environment Configuration](docs/ENVIRONMENT_CONFIG.md) - Configure timeouts, language, and base URLs
-- [Query Builder Guide](docs/QUERY_BUILDER_GUIDE.md) - Advanced query building for stats API
-
-## Support
-
-If you find this library helpful, consider supporting its development:
-
-[![ko-fi](https://ko-fi.com/img/githubbutton_sm.svg)](https://ko-fi.com/R6R01DV0JD)
+# NHLe API Library
+
+[![npm version](https://img.shields.io/npm/v/nhle-api.svg)](https://www.npmjs.com/package/nhle-api)
+[![npm downloads](https://img.shields.io/npm/dm/nhle-api.svg)](https://www.npmjs.com/package/nhle-api)
+[![license](https://img.shields.io/github/license/spiflicate/nhle-api.svg)](LICENSE)
+
+A modern TypeScript wrapper around the public NHL GameCenter and EdgeStats APIs with simple, composable functions and strong TypeScript typing.
+
+## Overview
+
+The library exposes a small, functional surface over the NHL "Game Center", Edge and Stats APIs and ships with response types for every endpoint.
+
+- Written in TypeScript and published as ESM/CJS
+- Thin functional wrappers over official NHL API routes
+- Typed responses for Game Center (`gc`), Edge advanced stats (`adv`), the Stats API (`stats`) and video metadata (`video`)
+- Every function resolves to an `APIResult` instead of throwing
+- Runtime configuration for timeouts, language and logging
+
+## Installation
+
+```bash
+npm install nhle-api
+```
+
+The package ships both ESM and CJS builds; use standard `import`/`require` according to your toolchain.
+
+## Quick Start
+
+The primary entrypoint is the Game Center API namespace `gc`:
+
+```ts
+import { gc } from 'nhle-api';
+
+// Get game landing page data
+const gameInfo = await gc.game.landing(2023020001);
+
+// Get live play-by-play
+const playByPlay = await gc.game.playByPlay(2023020001);
+
+// Get boxscore
+const boxscore = await gc.game.boxscore(2023020001);
+
+// Get today's scores
+const scores = await gc.score(new Date());
+
+// Get current scoreboard
+const scoreboard = await gc.scoreboard();
+
+// Get team roster
+const roster = await gc.team.roster('TOR');
+
+// Get player landing page (Connor McDavid)
+const player = await gc.player.landing(8478402);
+```
+
+## Configuration
+
+`config` holds the shared defaults. Change it at runtime; every request reads it, so changes apply even after the API modules are loaded:
+
+```ts
+import { config, logConfig } from 'nhle-api';
+
+config.timeout = 10000; // ms, default 5000
+config.language = 'fr'; // 'en' (default) or 'fr'
+config.logLevel = 'error'; // 'silent' | 'error' | 'warn' (default) | 'info' | 'debug'
+
+logConfig();
+```
+
+See `docs/CONFIGURATION.md` for per-client settings.
+
+## Top-Level Exports
+
+The package root `nhle-api` re-exports the API namespaces, configuration, the HTTP client, error classes, constants and types:
+
+```ts
+// API namespaces
+import { adv, gc, stats, video } from 'nhle-api';
+
+// Configuration and logging
+import { config, logConfig, logger } from 'nhle-api';
+
+// Result type and errors
+import { NHLError, NotFoundError, ValidationError } from 'nhle-api';
+import type { APIResult } from 'nhle-api';
+
+// Your own client (custom base URL, headers, timeout, error handling)
+import { NHLClient, createNHLClient } from 'nhle-api';
+
+// Cayenne filter builder for `stats`
+import { CayenneQueryBuilder } from 'nhle-api';
+
+// Response and parameter types
+import type { EdgeSkaterDetail, GamecenterLanding, Season } from 'nhle-api';
+```
+
+## Toolkit Entry Point
+
+Use the `nhle-api/toolkit` subpath when you only need NHL constants and shared helpers. It does not load the API clients or configuration:
+
+```ts
+import {
+   NHL,
+   getCurrentSeason,
+   normalizeAbbrev,
+   resolvePath,
+} from 'nhle-api/toolkit';
+
+const season = getCurrentSeason();
+const team = normalizeAbbrev('TB'); // 'TBL'
+const teamPath = resolvePath('/teams/{team}', { team });
+```
+
+This entry point exports `NHL`, date helpers, `normalizeAbbrev`, `resolvePath`,
+the Cayenne query builder, team branding data, historical team palettes, and
+official logo URL helpers.
+
+## Game Center API (`gc`)
+
+`gc` is the primary namespace for accessing live and historical NHL data.
+
+### `gc.game` – Game Data
+
+- `playByPlay(gameId)` – Full live play-by-play event stream
+- `boxscore(gameId)` – Boxscore and team/player stats for a game
+- `landing(gameId)` – Game landing page data (summary, lines, etc.)
+- `reports(gameId)` – Game reports / right-rail data
+- `schedule(date?)` – Schedule for a given date (defaults to today)
+- `scheduleCalendar(date?)` – Calendar-style schedule for a date
+- `playoffBracket(year?)` – Playoff bracket for a given year
+- `playoffSeries(season?)` – Playoff series information for a season
+- `playoffSeriesSchedule(season, seriesLetter)` – Schedule for a playoff series
+- `whereToWatch()` – Regional broadcast / streaming info (deprecated: the NHL retired this endpoint and it returns 404)
+- `networkTVSchedule(date?)` – National TV schedule
+- `wsc.gameStory(gameId)` – Game story from the web service collection
+- `wsc.playByPlay(gameId)` – Play-by-play from the web service collection
+- `pptReplay.goal(gameId, eventId)` – Goal replay data for a specific event
+- `pptReplay.event(date?)` – Replay events for a given date (does not appear to be functional at this time)
+
+### `gc.score` – Scores & Scoreboards
+
+- `score(date?)` – Scores for a given date (defaults to today)
+- `scoreboard()` – Current live scoreboard
+
+### `gc.team` – Team Data
+
+- `roster(teamCode, season?)` – Team roster for a given season
+- `rosterSeasons(teamCode)` – Available roster seasons for a team
+- `prospects(teamCode)` – Team prospects
+- `clubStats(teamCode, season?)` – Club stats for a team/season
+- `clubStatsSeason(teamCode)` – Season-level club stats
+- `standings(date?)` – Standings for a given date
+- `standingsSeason()` – Season standings
+- `schedule.now(teamCode)` – Current schedule segment for a team
+- `schedule.month(teamCode, month)` – Team schedule for a given month
+- `schedule.season(teamCode, season)` – Full season schedule for a team
+
+### `gc.player` – Player Data
+
+- `landing(playerId)` – Player landing page data
+- `gameLog(playerId, season?, gameType?)` – Game log for a player
+- `spotlight()` – Featured players (spotlight carousel)
+- `search(query)` – Player search
+- `statsLeaders.season(season?, gameType?, category?, limit?)` – Season stat leaders
+- `statsLeaders.current(gameType?, category?, limit?)` – Current stat leaders
+
+### `gc.draft` – Draft Data
+
+- `picks(year?)` – Draft picks for a given year
+- `tracker()` – Draft tracker
+- `rankings(year?)` – Draft rankings (all, NA/International, skaters/goalies)
+
+### `gc.misc` – Miscellaneous
+
+- `seasons()` – All NHL seasons
+- `meta.game(gameId)` – Game metadata
+- `meta.gameVideo(gameId)` – Game video metadata
+- `postalLookup(postalCode)` – Postal/ZIP lookup (location info)
+- `location()` – Location info for current context
+- `partnerGame(country, date?)` – Partner game information
+
+## Edge Advanced Stats (`adv`)
+
+NHL Edge puck and player tracking data (`api-web.nhle.com/v1/edge`), with response types for every function (`EdgeSkaterDetail`, `EdgeTeamZoneTime`, ...).
+
+- `adv.skaters`: `detail`, `comparison`, `leaders`, `shotLocation`, `shotSpeed`, `skatingDistance`, `skatingSpeed`, `zoneTime`, and `top10.{distance, shotLocation, shotSpeed, speed, zoneTime}`
+- `adv.goalies`: `player`, `compare`, `leaders`, `savePercentage`, `savePercentage5v5`, `saveLocation`, and `top10.{savePercentage, savePercentage5v5, saveLocation}`
+- `adv.teams`: `stats`, `compare`, `leaders`, `shotLocation`, `shotSpeed`, `skatingDistance`, `skatingSpeed`, `zoneTime`, and `top10.{shotLocation, shotSpeed, skatingDistance, skatingSpeed, zoneTime}`
+- `adv.byTheNumbers()`: the Edge home page's daily highlights
+
+```ts
+const result = await adv.skaters.detail(8478402, 20242025, 2);
+if (result.success) console.log(result.data.skatingSpeed.speedMax.imperial);
+```
+
+## Stats API (`stats`)
+
+The stats.nhl.com reports (`api.nhle.com/stats/rest`). List endpoints answer `{ data, total }` and accept `cayenneExp`, `sort`, `dir`, `limit` and `start`.
+
+- `stats.skaters` / `stats.goalies` / `stats.teams`: `getStats(report, params)` for any report (`summary`, `realtime`, `powerplay`...; `SkaterReport`, `GoalieReport` and `TeamReport` list them), plus `getStatsWithParams`, `getStatsWithBuilder` and `getStatsWithFilters`
+- `stats.skaters.getPlayerInfo(params)`, `getLeaders(category, params)`, `getMilestones()`; the same leaders and milestones for goalies
+- `stats.teams.getAll(params)`, `getById(teamId, params)`
+- `stats.season`: `getSeasons()`, `getGames(params)`, `getShiftChart(gameId)`, `getDraft()`
+- `stats.misc`: `getConfig()` (every report's columns), `getCountries()`, `getGlossary()`, `getFranchises()`
+
+```ts
+import { stats } from 'nhle-api';
+
+const result = await stats.skaters.getStats('summary', {
+   cayenneExp: 'seasonId=20242025 and gameTypeId=2',
+   sort: 'points',
+   dir: 'desc',
+   limit: 10,
+});
+
+// Or with the query builder
+const goalies = await stats.goalies.getStatsWithBuilder('summary', (q) => ({
+   cayenneExp: q.equals('seasonId', 20242025).greaterThan('gamesPlayed', 20).build(),
+   sort: 'savePct',
+   dir: 'desc',
+}));
+```
+
+See [docs/QUERY_BUILDER_GUIDE.md](docs/QUERY_BUILDER_GUIDE.md) for the builder.
+
+## Video (`video`)
+
+- `video.metadata(videoId)`: title, descriptions, duration, poster and playable sources (with the best MP4 as `url`) for a Brightcove video id, such as a goal's `highlightClip` in `gc.game.landing`
+
+## Types
+
+Response types are exported for every endpoint: Game Center (`GamecenterLanding`, `TeamRoster`...), Edge (`Edge*`) and the Stats API (`stats.SkaterStats`, `stats.Team`...), along with parameter types (`Season`, `GameId`, `TeamAbbrev`...) and shared shapes such as `LocalizedText`.
+
+### Results and errors
+
+Functions never throw for API failures. Each resolves to an `APIResult<T>`:
+
+- `{ success: true, data }` on success.
+- `{ success: false, error }` otherwise, where `error` is an `NHLError` subclass: `NotFoundError` (404), `ClientError` (other 4xx), `ServerError` (5xx), `RateLimitError` (429), `NetworkError`, or `ValidationError` for parameters rejected before any request.
+- `error.category` and `error.context` (endpoint, status code, response body) carry the details.
+
+```ts
+import { gc, NotFoundError } from 'nhle-api';
+import type { APIResult, GamecenterLanding } from 'nhle-api';
+
+const result: APIResult<GamecenterLanding> = await gc.game.landing(2023020001);
+
+if (result.success) {
+   console.log(result.data.venue.default);
+} else if (result.error instanceof NotFoundError) {
+   console.log('No such game');
+} else {
+   console.error(result.error.category, result.error.message);
+}
+```
+
+## Roadmap / Status
+
+- ✅ Game Center endpoints with response types
+- ✅ Edge Advanced (`adv`) endpoints with response types
+- ✅ Stats API (`stats`) endpoints with typed reports
+- ✅ Runtime configuration (`config`) and per-client settings (`NHLClient`)
+- ✅ Error classes and `APIResult` exported
+- ✅ Daily drift check against the live APIs
+
+For a detailed list of changes, see `CHANGELOG.md`.
+
+## Docs
+
+- [Configuration](docs/CONFIGURATION.md) - Code-defined configuration and default values
+- [Query Builder Guide](docs/QUERY_BUILDER_GUIDE.md) - Cayenne query builder for stats APIs
+
+## Contributing
+
+This project is still evolving and feedback is very welcome.
+
+- **Bug reports / issues:** If an endpoint returns unexpected data, response parsing fails, or types don’t match the real API, please open a GitHub issue with the endpoint, parameters, and (sanitized) sample payloads if possible.
+- **Type improvements:** PRs or issues that improve response coverage, fix missing/incorrect fields, or refine enums and unions are particularly helpful.
+- **JSDoc / docs:** Additions or corrections to JSDoc on public types and functions, or clarifications to the guides in `docs/`, are also very much appreciated.
+
+Before filing an issue, check the `CHANGELOG.md` for recent changes and breaking notes, and include the library version you’re using.
+
+## API drift check
+
+The NHL APIs are undocumented and change without notice. `bun run drift` calls every public function against the live APIs (with a finished season, game and draft) and compares each response's structure with `scripts/drift/baseline.json`. It fails when an endpoint stops answering, an error response changes, or a field is added, removed or changes type. Values are ignored, and so are fields that turn `null`. Translations in localized strings (`{ default, fr, cs, ... }`) count as one field.
+
+The **API drift** workflow runs it daily and on demand (Actions → API drift → Run workflow). A failure opens one `api-drift` issue with the report, which the next passing run closes. It never runs on PRs, so upstream changes don't block unrelated work.
+
+When an API really has changed:
+
+1. Update the response types in `src/types/responses/`.
+2. Accept the new shapes with `bun run drift --update` and commit the baseline.
+
+Checks for date- or location-dependent data (scoreboard, draft tracker) are marked `volatile`: a field missing today is only noted, and `--update` adds to their baseline instead of replacing it. When you add a library function, add a check in `scripts/drift/checks.ts`; `test/unit/drift.test.ts` fails if a public function has none.
+
+## Releasing
+
+1. Move the `Unreleased` notes in `CHANGELOG.md` under the new version.
+2. Bump the version and tag it: `npm version patch` (or `minor`/`major`).
+3. Push the commit and tag: `git push --follow-tags`.
+
+4. Approve the staged version with 2FA, on npmjs.com (the package's **Staged Packages** tab) or with `npm stage approve <stage-id>`.
+
+The **Release** workflow checks that the tag matches `package.json`, runs the full CI suite and `check:package`, stages the version on npm with provenance, and creates a GitHub release. It uses [npm trusted publishing](https://docs.npmjs.com/trusted-publishers), so there is no npm token in the repo, and [staged publishing](https://docs.npmjs.com/staged-publishing), so nothing goes live until a maintainer approves it.
+
+One-time setup on npmjs.com:
+
+1. Open the `nhle-api` package's **Settings → Trusted publishing** and add GitHub Actions with user `spiflicate`, repository `nhle-api` and workflow `release.yml`. Leave "Allow npm publish" and "Allow npm dist-tag" unchecked, so CI can only stage.
+2. Under **Publishing access**, choose "Require two-factor authentication and disallow tokens".
+
+## Support
+
+If you find this library helpful, consider supporting its development:
+
+[![ko-fi](https://ko-fi.com/img/githubbutton_sm.svg)](https://ko-fi.com/R6R01DV0JD)
+
+## License
+
+This project is licensed under the MIT License. See the [LICENSE](LICENSE) file for details.