Skip to content

Releases: sportsdataverse/sportsdataverse-js

Release list

v3.0.0

Choose a tag to compare

@saiemgilani saiemgilani released this 17 Jun 17:55
03fed05

A major release turning sportsdataverse (Node.js) into a cross-league ESPN client plus a native/provider live-API client with a tidy parser layer.

Highlights

  • ESPN cross-league surface — 116 endpoint wrappers across 29 leagues, dual-cased (sdv.nba.espn_nba_scoreboard() / espnNbaScoreboard()).
  • 7 native API families — MLB Stats API, Baseball Savant / Statcast, NHL ×4 (api-web / EDGE / Stats REST / Records), and the NFL.com "Shield" API (anonymous token minted automatically).
  • 5 cross-sport provider families on standalone sdv.<ns>.* namespaces, generated from canonical OpenAPI specs via a reusable OpenAPI 3.x → endpoint-YAML transform:
    • The Odds API (sdv.odds.*), 247Sports (sdv.recruiting.*), CBS Sports (sdv.cbs.*), Fox Sports (sdv.fox.*), Yahoo Sports (sdv.yahoo.*).
    • 517 flat-API wrappers across 13 families in total.
  • Tidy parser layer — pass { parsed: true } to turn any raw payload into a tidy array of row objects (incl. all 116 ESPN endpoints, via a 22-parser port of _common_espn_parsers). Strictly additive.
  • Dual-case naming, TypeScript, ESM-only (Node ≥ 20.18.1); codegen-driven with a drift gate.
  • Interactive playground — Raw/Parsed toggle + sortable table + shareable deep-links + an Examples menu, plus getting-started guides and RunKit live notebooks.

Legacy pre-3.0 methods (sdv.nba.getPlayByPlay(id), …) are preserved.

📖 Full notes: https://js.sportsdataverse.org/CHANGELOG · Docs: https://js.sportsdataverse.org