fifa-wc26 0.1.2 → 0.2.1

package/README.md

@@ -14,7 +14,7 @@ The package name is `fifa-wc26`; the binary it installs is `wc26`.
 
 ## Quick start
 
-No key required for the default providers (`espn`, `thesportsdb`).
+Default providers work keyless. No user-side key required.
 
 ```bash
 wc26 fixtures --team ARG --from today
@@ -38,15 +38,16 @@ export WC26_THESPORTSDB_KEY=...
 - `--json` — JSON to stdout
 - `--plain` — TSV, no color
 - `--no-cache` — skip cache read
-- `--provider <name>` — force a specific provider (`espn`, `thesportsdb`)
+- `--provider <name>` — force a specific provider (`football-data`, `espn`, `thesportsdb`)
 - `--verbose` — include stack traces on error
 
 ## Providers
 
-`wc26` chains keyless providers with automatic failover:
+`wc26` chains providers with automatic failover:
 
-1. `espn` (site.api.espn.com — keyless)
-2. `thesportsdb` (thesportsdb.com — free tier uses key `3`; set a paid key for higher limits)
+1. `football-data` (api.football-data.org — full 104-match WC schedule + knockout stages; no key needed)
+2. `espn` (site.api.espn.com — keyless)
+3. `thesportsdb` (thesportsdb.com — free tier uses key `3`; set a paid key for higher limits)
 
 Set a paid `thesportsdb` key via env var (`WC26_THESPORTSDB_KEY`) or `wc26 config set apiKey thesportsdb <key>`.
 

package/dist/cli.js

@@ -102,7 +102,7 @@ init_esm_shims();
 import { readFile, writeFile, mkdir, chmod } from "fs/promises";
 import { join } from "path";
 var DEFAULTS = {
-  providers: ["espn", "thesportsdb"],
+  providers: ["football-data", "espn", "thesportsdb"],
   apiKeys: {},
   defaults: { watchIntervalSec: 15, output: "pretty" }
 };
@@ -671,6 +671,308 @@ var TheSportsDbProvider = class {
   }
 };
 
+// src/providers/football-data.ts
+init_esm_shims();
+
+// src/data/wc26-venues.ts
+init_esm_shims();
+var WC26_VENUES = {
+  "537327": "Estadio Azteca, Mexico City",
+  "537328": "Estadio Akron, Guadalajara",
+  "537329": "Mercedes-Benz Stadium, Atlanta",
+  "537330": "Estadio Akron, Guadalajara",
+  "537331": "Estadio Azteca, Mexico City",
+  "537332": "Estadio BBVA, Monterrey",
+  "537333": "BMO Field, Toronto",
+  "537334": "Levi's Stadium, Bay Area",
+  "537335": "SoFi Stadium, Los Angeles",
+  "537336": "BC Place, Vancouver",
+  "537337": "BC Place, Vancouver",
+  "537338": "Lumen Field, Seattle",
+  "537339": "MetLife Stadium, New York/New Jersey",
+  "537340": "Gillette Stadium, Boston",
+  "537341": "Lincoln Financial Field, Philadelphia",
+  "537342": "Gillette Stadium, Boston",
+  "537343": "Hard Rock Stadium, Miami",
+  "537344": "Mercedes-Benz Stadium, Atlanta",
+  "537345": "SoFi Stadium, Los Angeles",
+  "537346": "BC Place, Vancouver",
+  "537347": "Levi's Stadium, Bay Area",
+  "537348": "Lumen Field, Seattle",
+  "537349": "SoFi Stadium, Los Angeles",
+  "537350": "Levi's Stadium, Bay Area",
+  "537351": "NRG Stadium, Houston",
+  "537352": "Lincoln Financial Field, Philadelphia",
+  "537353": "BMO Field, Toronto",
+  "537354": "Arrowhead Stadium, Kansas City",
+  "537355": "MetLife Stadium, New York/New Jersey",
+  "537356": "Lincoln Financial Field, Philadelphia",
+  "537357": "AT&T Stadium, Dallas",
+  "537358": "Estadio BBVA, Monterrey",
+  "537359": "NRG Stadium, Houston",
+  "537360": "Estadio BBVA, Monterrey",
+  "537361": "Arrowhead Stadium, Kansas City",
+  "537362": "AT&T Stadium, Dallas",
+  "537363": "Lumen Field, Seattle",
+  "537364": "SoFi Stadium, Los Angeles",
+  "537365": "SoFi Stadium, Los Angeles",
+  "537366": "BC Place, Vancouver",
+  "537367": "BC Place, Vancouver",
+  "537368": "Lumen Field, Seattle",
+  "537369": "Mercedes-Benz Stadium, Atlanta",
+  "537370": "Hard Rock Stadium, Miami",
+  "537371": "Mercedes-Benz Stadium, Atlanta",
+  "537372": "Hard Rock Stadium, Miami",
+  "537373": "Estadio Akron, Guadalajara",
+  "537374": "NRG Stadium, Houston",
+  "537375": "Lincoln Financial Field, Philadelphia",
+  "537376": "NRG Stadium, Houston",
+  "537377": "MetLife Stadium, New York/New Jersey",
+  "537378": "Estadio Azteca, Mexico City",
+  "537379": "AT&T Stadium, Dallas",
+  "537380": "Lumen Field, Seattle",
+  "537381": "Mercedes-Benz Stadium, Atlanta",
+  "537382": "BC Place, Vancouver",
+  "537383": "Gillette Stadium, Boston",
+  "537384": "SoFi Stadium, Los Angeles",
+  "537385": "Hard Rock Stadium, Miami",
+  "537386": "Arrowhead Stadium, Kansas City",
+  "537387": "AT&T Stadium, Dallas",
+  "537388": "Mercedes-Benz Stadium, Atlanta",
+  "537389": "Hard Rock Stadium, Miami",
+  "537390": "MetLife Stadium, New York/New Jersey",
+  "537391": "MetLife Stadium, New York/New Jersey",
+  "537392": "Gillette Stadium, Boston",
+  "537393": "Lincoln Financial Field, Philadelphia",
+  "537394": "MetLife Stadium, New York/New Jersey",
+  "537395": "Gillette Stadium, Boston",
+  "537396": "BMO Field, Toronto",
+  "537397": "Arrowhead Stadium, Kansas City",
+  "537398": "Levi's Stadium, Bay Area",
+  "537399": "AT&T Stadium, Dallas",
+  "537400": "Levi's Stadium, Bay Area",
+  "537401": "AT&T Stadium, Dallas",
+  "537402": "Arrowhead Stadium, Kansas City",
+  "537403": "NRG Stadium, Houston",
+  "537404": "Estadio Azteca, Mexico City",
+  "537405": "NRG Stadium, Houston",
+  "537406": "Estadio Akron, Guadalajara",
+  "537407": "Hard Rock Stadium, Miami",
+  "537408": "Mercedes-Benz Stadium, Atlanta",
+  "537409": "AT&T Stadium, Dallas",
+  "537410": "BMO Field, Toronto",
+  "537411": "Gillette Stadium, Boston",
+  "537412": "BMO Field, Toronto",
+  "537413": "MetLife Stadium, New York/New Jersey",
+  "537414": "Lincoln Financial Field, Philadelphia",
+  "537415": "Gillette Stadium, Boston",
+  "537416": "MetLife Stadium, New York/New Jersey",
+  "537417": "SoFi Stadium, Los Angeles",
+  "537418": "Estadio BBVA, Monterrey",
+  "537419": "BMO Field, Toronto",
+  "537420": "SoFi Stadium, Los Angeles",
+  "537421": "Levi's Stadium, Bay Area",
+  "537422": "Lumen Field, Seattle",
+  "537423": "NRG Stadium, Houston",
+  "537424": "AT&T Stadium, Dallas",
+  "537425": "Estadio Azteca, Mexico City",
+  "537426": "Mercedes-Benz Stadium, Atlanta",
+  "537427": "Hard Rock Stadium, Miami",
+  "537428": "AT&T Stadium, Dallas",
+  "537429": "BC Place, Vancouver",
+  "537430": "Arrowhead Stadium, Kansas City"
+};
+function lookupWC26Venue(matchId) {
+  return WC26_VENUES[String(matchId)];
+}
+
+// src/providers/football-data.ts
+var DEFAULT_PROXY_BASE = "https://wc26-proxy.vercel.app";
+function resolveBase(override) {
+  return (override ?? process.env.WC26_PROXY_URL ?? DEFAULT_PROXY_BASE).replace(/\/+$/, "");
+}
+var STAGE_MAP = {
+  GROUP_STAGE: "group",
+  LAST_16: "r16",
+  QUARTER_FINALS: "qf",
+  SEMI_FINALS: "sf",
+  THIRD_PLACE: "third",
+  FINAL: "final"
+};
+function mapStage3(s) {
+  return STAGE_MAP[s ?? ""] ?? "group";
+}
+function mapStatus3(s) {
+  switch (s) {
+    case "LIVE":
+    case "IN_PLAY":
+    case "PAUSED":
+      return "live";
+    case "FINISHED":
+    case "AWARDED":
+      return "finished";
+    case "POSTPONED":
+    case "SUSPENDED":
+      return "postponed";
+    case "CANCELLED":
+      return "cancelled";
+    default:
+      return "scheduled";
+  }
+}
+function teamRef2(t) {
+  const name = t.name ?? t.shortName ?? t.tla ?? "?";
+  const code = (t.tla ?? name.slice(0, 3)).toUpperCase().slice(0, 3);
+  return { code, name };
+}
+function fixtureFromMatch(m) {
+  const status = mapStatus3(m.status);
+  const ft = m.score?.fullTime;
+  const hs = ft?.home;
+  const as = ft?.away;
+  const score = hs != null && as != null && (status === "live" || status === "finished") ? {
+    home: hs,
+    away: as,
+    homePens: m.score?.penalties?.home ?? void 0,
+    awayPens: m.score?.penalties?.away ?? void 0
+  } : void 0;
+  const group = m.group ? m.group.replace(/^GROUP[_\s]+/i, "").trim().toUpperCase().slice(0, 1) : void 0;
+  const id = String(m.id);
+  return {
+    id,
+    utcKickoff: new Date(m.utcDate).toISOString(),
+    stage: mapStage3(m.stage),
+    group: group || void 0,
+    home: teamRef2(m.homeTeam),
+    away: teamRef2(m.awayTeam),
+    venue: m.venue ?? lookupWC26Venue(id) ?? "",
+    status,
+    score
+  };
+}
+var FootballDataProvider = class {
+  name = "football-data";
+  base;
+  constructor(proxyBase) {
+    this.base = resolveBase(proxyBase);
+  }
+  isConfigured() {
+    return Boolean(this.base);
+  }
+  url(path2, qs) {
+    const q = qs && [...qs].length ? `?${qs.toString()}` : "";
+    return `${this.base}${path2}${q}`;
+  }
+  async matches(q = {}) {
+    const params = new URLSearchParams();
+    if (q.from) params.set("dateFrom", q.from);
+    if (q.to) params.set("dateTo", q.to);
+    const data = await httpJson(this.url("/competitions/WC/matches", params));
+    return data.matches ?? [];
+  }
+  async fixtures(q) {
+    const raw = await this.matches({ from: q.from, to: q.to });
+    let out = raw.map(fixtureFromMatch);
+    if (q.teamCode) out = out.filter((f) => f.home.code === q.teamCode || f.away.code === q.teamCode);
+    if (q.stage) out = out.filter((f) => f.stage === q.stage);
+    return out;
+  }
+  async liveMatches() {
+    const raw = await this.matches();
+    return raw.map(fixtureFromMatch).filter((f) => f.status === "live").map((f) => ({ ...f, minute: 0, events: [] }));
+  }
+  async match(id) {
+    const data = await httpJson(this.url(`/matches/${id}`));
+    if (!data.id || !data.utcDate || !data.homeTeam || !data.awayTeam || !data.status) {
+      throw new WC26Error("NOT_FOUND", `match ${id} not found`);
+    }
+    const m = {
+      id: data.id,
+      utcDate: data.utcDate,
+      status: data.status,
+      homeTeam: data.homeTeam,
+      awayTeam: data.awayTeam,
+      score: data.score,
+      venue: data.venue,
+      stage: data.stage,
+      group: data.group
+    };
+    const f = fixtureFromMatch(m);
+    const ref = data.referees?.find((r) => /referee/i.test(r.role ?? ""))?.name;
+    return {
+      ...f,
+      minute: 0,
+      events: [],
+      lineups: { home: [], away: [] },
+      stats: {},
+      referee: ref
+    };
+  }
+  async standings(group) {
+    const data = await httpJson(this.url("/competitions/WC/standings"));
+    const out = [];
+    for (const s of data.standings ?? []) {
+      if (s.type && s.type !== "TOTAL") continue;
+      const label = (s.group ?? "").replace(/^GROUP_/i, "").trim().toUpperCase().slice(0, 1);
+      if (!label) continue;
+      out.push({
+        group: label,
+        rows: (s.table ?? []).map((r) => ({
+          team: teamRef2(r.team),
+          p: r.playedGames,
+          w: r.won,
+          d: r.draw,
+          l: r.lost,
+          gf: r.goalsFor,
+          ga: r.goalsAgainst,
+          gd: r.goalDifference,
+          pts: r.points
+        }))
+      });
+    }
+    out.sort((a, b) => a.group.localeCompare(b.group));
+    return group ? out.filter((g) => g.group === group.toUpperCase()) : out;
+  }
+  async knockoutBracket() {
+    const fixtures = await this.fixtures({});
+    const stages = ["r16", "qf", "sf", "third", "final"];
+    return fixtures.filter((f) => stages.includes(f.stage)).map((f) => ({
+      stage: f.stage,
+      matchId: f.id,
+      home: f.home,
+      away: f.away,
+      winner: f.status === "finished" && f.score ? f.score.home > f.score.away ? f.home : f.score.away > f.score.home ? f.away : void 0 : void 0
+    }));
+  }
+  async team(code) {
+    const data = await httpJson(this.url("/competitions/WC/teams"));
+    const list = data.teams ?? [];
+    const match = list.find((t) => (t.tla ?? "").toUpperCase() === code.toUpperCase());
+    if (!match) throw new WC26Error("NOT_FOUND", `team ${code} not found`);
+    let squad = [];
+    let coach = match.coach?.name;
+    try {
+      const t = await httpJson(this.url(`/teams/${match.id}`));
+      squad = (t.squad ?? []).map((p) => ({
+        name: p.name ?? "?",
+        position: p.position ?? "",
+        number: p.shirtNumber ?? void 0
+      }));
+      coach = t.coach?.name ?? coach;
+    } catch {
+      squad = [];
+    }
+    const fixtures = await this.fixtures({ teamCode: code });
+    return {
+      code: (match.tla ?? code).toUpperCase(),
+      name: match.name,
+      coach,
+      squad,
+      fixtures
+    };
+  }
+};
+
 // src/commands/_shared.ts
 function homeDir() {
   return process.env.WC26_HOME ?? join3(homedir(), ".wc26");
@@ -691,6 +993,10 @@ async function buildRegistry(opts) {
     const key = await env.config.apiKey(name) ?? "";
     if (name === "espn") providers.push(new EspnProvider());
     else if (name === "thesportsdb") providers.push(new TheSportsDbProvider(key || "3"));
+    else if (name === "football-data") {
+      const p = new FootballDataProvider();
+      if (p.isConfigured()) providers.push(p);
+    }
   }
   return new ProviderRegistry(providers);
 }
@@ -793,7 +1099,8 @@ var colorStatus = (s) => {
   return chalk.cyan(s);
 };
 var scoreStr2 = (f) => f.score ? `${f.score.home}-${f.score.away}` : "\u2013";
-function renderFixturesPretty(fixtures) {
+function renderFixturesPretty(fixtures, emptyMessage = "no matches") {
+  if (fixtures.length === 0) return chalk.dim(emptyMessage);
   const t = new Table({
     head: ["Kickoff (UTC)", "Stage", "Home", "Away", "Venue", "Score", "Status"],
     style: { head: ["bold"] }
@@ -916,7 +1223,7 @@ function nextCmd(p) {
       else {
         if (stale) process.stdout.write(`[STALE${reason ? ` ${reason}` : ""}]
 `);
-        process.stdout.write(renderFixturesPretty(out) + "\n");
+        process.stdout.write(renderFixturesPretty(out, "no upcoming matches") + "\n");
       }
     } catch (e) {
       die(e, g);
@@ -1282,7 +1589,7 @@ function cacheCmd(p) {
 
 // src/cli.ts
 var program = new Command();
-program.name("wc26").description("FIFA World Cup 2026 CLI").version("0.1.0").option("--json", "emit JSON to stdout").option("--plain", "tab-separated, no color").option("--no-cache", "skip cache read").option("--provider <name>", "force a specific provider").option("--verbose", "include stack traces");
+program.name("wc26").description("FIFA World Cup 2026 CLI").version("0.1.2").option("--json", "emit JSON to stdout").option("--plain", "tab-separated, no color").option("--no-cache", "skip cache read").option("--provider <name>", "force a specific provider").option("--verbose", "include stack traces");
 fixturesCmd(program);
 nextCmd(program);
 liveCmd(program);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "fifa-wc26",
-  "version": "0.1.2",
+  "version": "0.2.1",
   "description": "FIFA World Cup 2026 CLI: fixtures, live scores, group standings, ASCII bracket, team lookup. Keyless providers, smart cache, terminal-friendly output.",
   "type": "module",
   "bin": {