fifa-wc26 0.1.2 → 0.2.0

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 (`espn`, `thesportsdb`). The bundled `football-data` provider talks to a project-hosted proxy (no user-side key required); see [Providers](#providers) for proxy details.
 
 ```bash
 wc26 fixtures --team ARG --from today
@@ -38,18 +38,40 @@ 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 via the project proxy — full 104-match WC schedule + knockout stages; activates when a proxy URL is baked into the build or `WC26_PROXY_URL` is set)
+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>`.
 
+### football-data proxy
+
+The football-data.org API token is **not** shipped to end users. Requests are
+forwarded through a small Vercel Edge Function (`proxy/vercel/`) that attaches
+the token server-side and CDN-caches responses to amortize the 10 req/min
+upstream limit.
+
+Maintainers: deploy the proxy, then set the resulting URL once before
+publishing:
+
+```bash
+cd proxy/vercel
+npm install && npx vercel login && npx vercel link
+npx vercel env add FOOTBALL_DATA_TOKEN production   # paste token when prompted
+npm run deploy                                       # prints https://<project>.vercel.app
+```
+
+Then edit `DEFAULT_PROXY_BASE` in `src/providers/football-data.ts` to that URL
+and `npm run build`. End users get the proxied provider automatically; no key,
+no signup. Override at runtime with `WC26_PROXY_URL=...`.
+
 ## Cache
 
 JSON files under `~/.wc26/cache/`. TTLs: fixtures 6 h, standings 1 h, bracket 1 h, finished match 24 h, live 10 s. On provider failure the CLI serves stale cache and tags output `[STALE]` (or `"stale": true` in JSON).

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,193 @@ var TheSportsDbProvider = class {
   }
 };
 
+// src/providers/football-data.ts
+init_esm_shims();
+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;
+  return {
+    id: String(m.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 ?? "",
+    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 +878,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 +984,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 +1108,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 +1474,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.0",
   "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": {