@claudinho/core 0.8.19 → 0.9.0

package/dist/index.d.ts

@@ -485,6 +485,18 @@ interface ProviderAdapter {
     fetchStandings?(): Promise<GroupStandings[]>;
     /** Optional push subscription (websocket/SSE providers). Returns an unsubscribe fn. */
     subscribe?(onBatch: (matches: Match[]) => void): () => void;
+    /**
+     * Optional: the most recent request failure, cleared when a new request
+     * starts (best-effort under concurrency). Lets a caller whose result path
+     * fails closed to `degraded` booleans still distinguish a throttle/block
+     * (`throttled` — persist a backoff, hammering makes it worse) from an
+     * ordinary blip (retry on the normal cadence).
+     */
+    readonly lastError?: {
+        readonly kind: string;
+        readonly status?: number;
+        readonly throttled?: boolean;
+    };
 }
 
 /**
@@ -503,6 +515,19 @@ interface ProviderAdapter {
 declare const DEFAULT_COMPETITION = "fifa.world";
 /** Build an ESPN soccer base URL for a competition slug (e.g. "fifa.friendly"). */
 declare function competitionBase(slug: string): string;
+type ProviderErrorKind = 'http' | 'timeout' | 'parse';
+/**
+ * Classified provider failure, so a caller that got a degraded result can tell
+ * a throttle/block (back off — hammering makes it worse) from a timeout or a
+ * shape change (plain degraded, retry on the normal cadence).
+ */
+declare class ProviderError extends Error {
+    readonly kind: ProviderErrorKind;
+    readonly status?: number;
+    constructor(message: string, kind: ProviderErrorKind, status?: number);
+    /** 429/403 — the upstream is refusing us; retrying at the live cadence makes it worse. */
+    get throttled(): boolean;
+}
 interface EspnStatusType {
     name?: string;
     state?: string;
@@ -608,6 +633,20 @@ declare class EspnAdapter implements ProviderAdapter {
     readonly capabilities: ProviderCapabilities;
     /** Cached team-code -> group-letter map (built lazily from standings). */
     private groupMap?;
+    /**
+     * One in-flight/recent standings fetch shared by fetchStandings and
+     * fetchGroupMap, so a command like `bracket` hits the endpoint once instead
+     * of twice, and a long-lived MCP server stays fresh (short TTL). A rejected
+     * fetch clears the slot — a transient failure is never cached.
+     */
+    private standingsShared?;
+    /**
+     * The most recent request failure (best-effort under concurrency; cleared
+     * when a new request starts). A post-hoc hint for callers whose result path
+     * fails closed to `degraded` booleans but who still need to distinguish a
+     * throttle (persist a backoff) from an ordinary blip.
+     */
+    lastError?: ProviderError;
     constructor(opts?: EspnAdapterOptions);
     fetchByDate(dateISO: string): Promise<Match[]>;
     fetchWindow(startDate: string, endDate: string): Promise<Match[]>;
@@ -620,6 +659,8 @@ declare class EspnAdapter implements ProviderAdapter {
     fetchLive(): Promise<Match[]>;
     /** Standings endpoint URL (lives under apis/v2, not site/v2; derived from base). */
     private standingsUrl;
+    /** The shared standings fetch (see {@link standingsShared}). */
+    private sharedStandings;
     /**
      * Authoritative, cumulative group tables from the standings endpoint. Throws
      * on fetch/parse failure (the caller decides the fallback). Group-stage only:
@@ -628,8 +669,11 @@ declare class EspnAdapter implements ProviderAdapter {
     fetchStandings(): Promise<GroupStandings[]>;
     /**
      * Build (and cache) a team-code -> group-letter map from the standings
-     * endpoint. Best-effort: returns {} if standings are unavailable. Reuses the
-     * same parse as {@link fetchStandings}, so the two never drift.
+     * endpoint. Best-effort: returns {} if standings are unavailable — but a
+     * transient failure is NOT cached (only a successful parse pins the map), so
+     * one blip can't silently drop group letters for the adapter's lifetime.
+     * Reuses the same parse/fetch as {@link fetchStandings}, so the two never
+     * drift and one command never fetches standings twice.
      */
     fetchGroupMap(force?: boolean): Promise<Record<string, string>>;
     private fetchScoreboard;
@@ -644,7 +688,14 @@ declare class EspnAdapter implements ProviderAdapter {
  * always the World Cup.
  */
 declare function resolveCompetition(explicit?: string): string;
-/** Construct a provider adapter for a `--source` name (default: espn). */
+/** Provider names {@link makeAdapter} can construct (the CLI validates against this). */
+declare const KNOWN_SOURCES: readonly ["espn"];
+/**
+ * Construct a provider adapter for a `--source` name (default: espn). An
+ * unknown source FAILS LOUD instead of silently running ESPN — `--source foo`
+ * previously no-op'd, which lied about what the flag did (attribution stayed
+ * honest, but the advertised knob did nothing).
+ */
 declare function makeAdapter(source?: string): ProviderAdapter;
 /**
  * Merge live matches over a base set by id. Live entries replace base entries
@@ -690,6 +741,10 @@ interface StandingsResult {
  * asked-for group isn't in it (caller renders "no such group").
  */
 declare function getStandings(adapter: ProviderAdapter, group?: string): Promise<StandingsResult>;
+declare function knockoutWindow(): {
+    start: string;
+    end: string;
+} | null;
 /**
  * Knockout bracket with hybrid slot resolution: confirmed FT winners/losers from
  * the live overlay; group slots project from live standings once a group has started.
@@ -1224,4 +1279,4 @@ declare function formatShareBracket(input: ShareBracketInput, options?: ShareBra
 /** Compact one-line-per-match bracket for narrow share contexts. */
 declare function formatBracketCompactLine(mv: BracketMatchView, opts?: BracketFormatOpts): string;
 
-export { BRACKET_STAGE_ORDER, type BracketFormatOpts, type BracketMatchNode, type BracketMatchView, type BracketResult, type BracketTopology, type BracketView, type BuildSignalInput, DEFAULT_COMPETITION, DEFAULT_FLAVOR, DEFAULT_MAX_AGE_MS, EspnAdapter, type EspnAdapterOptions, FEED_TEXT_MAX, FLAVOR_LEVELS, FakeMarketProvider, type FakeMarketProviderOptions, type FavoriteStrength, type FlavorLevel, type FormatOpts, type GroupStandings, type KnockoutFixturesResult, LIVE_WINDOW_MS, type Lang, type LedgerRow, type LiveResult, type MapContext, type MarketFavorite, type MarketMapping, type MarketMappingTable, type MarketOutcome, type MarketOutcomeKind, type MarketProvider, type MarketSignal, type MarketSignalOptions, type MarketSignalsResult, type Match, type MatchByIdResult, type MatchEvent, type NextFixtureResult, type Outcome, PolymarketProvider, type PolymarketProviderOptions, type ProviderAdapter, type ProviderCapabilities, type PunditPick, type ResolvedParticipant, SHARE_DISCLAIMER, SHARE_HASHTAG, type ShareBracketInput, type ShareBracketOptions, type ShareSnippetInput, type ShareSnippetOptions, type ShareStyle, type ShareTableInput, type SlotRef, type Stage, type StandingRow, type StandingsResult, type Status, type Team, type TeamInfo, type TeamLookup, allFixtures, allTeams, asFlavorLevel, buildBracketTopology, buildBracketView, buildMarketSignal, byKickoff, competitionBase, computeStandings, countdown, currentOrNextFixtureForTeam, deriveFavorite, displayWidth, favoriteStrength, fixturesByDate, fixturesByGroup, fixturesByTeam, fixturesInLiveWindow, flagEmoji, formatBracketCompactLine, formatBracketList, formatBracketMatchLine, formatBracketTree, formatDate, formatKickoff, formatShareBracket, formatShareSnippet, formatShareTable, formatTime, getBracket, getKnockoutFixtures, getLiveMatches, getMarketSignal, getMarketSignals, getMatchById, getMatchesForDate, getNextFixtureForTeam, getStandings, groups, hasSaneDistribution, isFinished, isFlavorLevel, isLive, isReliableMarketSignal, isResolvedNation, isStaleSignal, isValidDate, isValidTimeZone, liveSourceLabel, loadBracketTopology, localDate, lookupTeam, makeAdapter, makeMarketProvider, mapEspnEvent, mapsCleanly, marketAttributionText, marketBlock, marketFavoriteText, marketFixtureForTeam, marketLine, marketProbabilityText, marketRelevant, marketSignalRendersFor, marketSourceLabel, matchFlavor, matchKey, matchLocation, mergeLive, nationToFlag, nationToRegion, nextFixtureForTeam, normalizeLang, normalizeOutcomes, outcomeFromScore, padVisible, parseStandings, parseTeamSlot, resolveCompetition, resolveMarketSource, resolveTz, sanitizeBundledFixture, sanitizeFeedText, sanitizeMatchStrings, scoreline, stageLabel, stageLabelI18n, t };
+export { BRACKET_STAGE_ORDER, type BracketFormatOpts, type BracketMatchNode, type BracketMatchView, type BracketResult, type BracketTopology, type BracketView, type BuildSignalInput, DEFAULT_COMPETITION, DEFAULT_FLAVOR, DEFAULT_MAX_AGE_MS, EspnAdapter, type EspnAdapterOptions, FEED_TEXT_MAX, FLAVOR_LEVELS, FakeMarketProvider, type FakeMarketProviderOptions, type FavoriteStrength, type FlavorLevel, type FormatOpts, type GroupStandings, KNOWN_SOURCES, type KnockoutFixturesResult, LIVE_WINDOW_MS, type Lang, type LedgerRow, type LiveResult, type MapContext, type MarketFavorite, type MarketMapping, type MarketMappingTable, type MarketOutcome, type MarketOutcomeKind, type MarketProvider, type MarketSignal, type MarketSignalOptions, type MarketSignalsResult, type Match, type MatchByIdResult, type MatchEvent, type NextFixtureResult, type Outcome, PolymarketProvider, type PolymarketProviderOptions, type ProviderAdapter, type ProviderCapabilities, ProviderError, type ProviderErrorKind, type PunditPick, type ResolvedParticipant, SHARE_DISCLAIMER, SHARE_HASHTAG, type ShareBracketInput, type ShareBracketOptions, type ShareSnippetInput, type ShareSnippetOptions, type ShareStyle, type ShareTableInput, type SlotRef, type Stage, type StandingRow, type StandingsResult, type Status, type Team, type TeamInfo, type TeamLookup, allFixtures, allTeams, asFlavorLevel, buildBracketTopology, buildBracketView, buildMarketSignal, byKickoff, competitionBase, computeStandings, countdown, currentOrNextFixtureForTeam, deriveFavorite, displayWidth, favoriteStrength, fixturesByDate, fixturesByGroup, fixturesByTeam, fixturesInLiveWindow, flagEmoji, formatBracketCompactLine, formatBracketList, formatBracketMatchLine, formatBracketTree, formatDate, formatKickoff, formatShareBracket, formatShareSnippet, formatShareTable, formatTime, getBracket, getKnockoutFixtures, getLiveMatches, getMarketSignal, getMarketSignals, getMatchById, getMatchesForDate, getNextFixtureForTeam, getStandings, groups, hasSaneDistribution, isFinished, isFlavorLevel, isLive, isReliableMarketSignal, isResolvedNation, isStaleSignal, isValidDate, isValidTimeZone, knockoutWindow, liveSourceLabel, loadBracketTopology, localDate, lookupTeam, makeAdapter, makeMarketProvider, mapEspnEvent, mapsCleanly, marketAttributionText, marketBlock, marketFavoriteText, marketFixtureForTeam, marketLine, marketProbabilityText, marketRelevant, marketSignalRendersFor, marketSourceLabel, matchFlavor, matchKey, matchLocation, mergeLive, nationToFlag, nationToRegion, nextFixtureForTeam, normalizeLang, normalizeOutcomes, outcomeFromScore, padVisible, parseStandings, parseTeamSlot, resolveCompetition, resolveMarketSource, resolveTz, sanitizeBundledFixture, sanitizeFeedText, sanitizeMatchStrings, scoreline, stageLabel, stageLabelI18n, t };

package/dist/index.js

@@ -378,7 +378,8 @@ function normalizeLang(lang) {
 }
 function t(lang, key, vars) {
   const dict = CATALOGS[normalizeLang(lang)];
-  let s = dict[key] ?? EN[key] ?? key;
+  const en = EN;
+  let s = dict[key] ?? en[key] ?? key;
   if (vars) {
     for (const [k, v] of Object.entries(vars)) s = s.replaceAll(`{${k}}`, v);
   }
@@ -3085,11 +3086,27 @@ function rosterAtZero(matches) {
 var ESPN_SOCCER = "https://site.api.espn.com/apis/site/v2/sports/soccer";
 var DEFAULT_COMPETITION = "fifa.world";
 var DEFAULT_BASE = `${ESPN_SOCCER}/${DEFAULT_COMPETITION}`;
-var USER_AGENT = "claudinho/0.0 (+https://github.com/arturogarrido/claudinho)";
+var USER_AGENT = `claudinho/${"0.9.0"} (+https://github.com/arturogarrido/claudinho)`;
 var MAX_RESPONSE_BYTES = 5 * 1024 * 1024;
 function competitionBase(slug) {
   return `${ESPN_SOCCER}/${slug}`;
 }
+var DEFAULT_TIMEOUT_MS = 6e3;
+var STANDINGS_SHARE_MS = 3e4;
+var ProviderError = class extends Error {
+  kind;
+  status;
+  constructor(message, kind, status) {
+    super(message);
+    this.name = "ProviderError";
+    this.kind = kind;
+    this.status = status;
+  }
+  /** 429/403 — the upstream is refusing us; retrying at the live cadence makes it worse. */
+  get throttled() {
+    return this.kind === "http" && (this.status === 429 || this.status === 403);
+  }
+};
 function mapStatus(st) {
   const name = (st?.type?.name ?? "").toUpperCase();
   const state = st?.type?.state ?? "";
@@ -3231,6 +3248,20 @@ var EspnAdapter = class {
   capabilities = { push: false, latencyHintSec: 45 };
   /** Cached team-code -> group-letter map (built lazily from standings). */
   groupMap;
+  /**
+   * One in-flight/recent standings fetch shared by fetchStandings and
+   * fetchGroupMap, so a command like `bracket` hits the endpoint once instead
+   * of twice, and a long-lived MCP server stays fresh (short TTL). A rejected
+   * fetch clears the slot — a transient failure is never cached.
+   */
+  standingsShared;
+  /**
+   * The most recent request failure (best-effort under concurrency; cleared
+   * when a new request starts). A post-hoc hint for callers whose result path
+   * fails closed to `degraded` booleans but who still need to distinguish a
+   * throttle (persist a backoff) from an ordinary blip.
+   */
+  lastError;
   async fetchByDate(dateISO) {
     return this.fetchScoreboard(toEspnDate(dateISO));
   }
@@ -3252,37 +3283,58 @@ var EspnAdapter = class {
     const base = this.opts.baseUrl ?? DEFAULT_BASE;
     return `${base.replace("/apis/site/v2/", "/apis/v2/")}/standings`;
   }
+  /** The shared standings fetch (see {@link standingsShared}). */
+  sharedStandings() {
+    const now = Date.now();
+    if (this.standingsShared && now - this.standingsShared.at < STANDINGS_SHARE_MS) {
+      return this.standingsShared.promise;
+    }
+    const promise = this.get(this.standingsUrl()).then(
+      (d) => parseStandings(d)
+    );
+    this.standingsShared = { at: now, promise };
+    promise.catch(() => {
+      if (this.standingsShared?.promise === promise) this.standingsShared = void 0;
+    });
+    return promise;
+  }
   /**
    * Authoritative, cumulative group tables from the standings endpoint. Throws
    * on fetch/parse failure (the caller decides the fallback). Group-stage only:
    * non-group `children` are filtered out by {@link parseStandings}.
    */
   async fetchStandings() {
-    return parseStandings(await this.get(this.standingsUrl()));
+    return this.sharedStandings();
   }
   /**
    * Build (and cache) a team-code -> group-letter map from the standings
-   * endpoint. Best-effort: returns {} if standings are unavailable. Reuses the
-   * same parse as {@link fetchStandings}, so the two never drift.
+   * endpoint. Best-effort: returns {} if standings are unavailable — but a
+   * transient failure is NOT cached (only a successful parse pins the map), so
+   * one blip can't silently drop group letters for the adapter's lifetime.
+   * Reuses the same parse/fetch as {@link fetchStandings}, so the two never
+   * drift and one command never fetches standings twice.
    */
   async fetchGroupMap(force = false) {
     if (this.groupMap && !force) return this.groupMap;
-    const map = {};
     try {
-      const tables = parseStandings(await this.get(this.standingsUrl()));
+      const tables = await this.sharedStandings();
+      const map = {};
       for (const t2 of tables) for (const r of t2.rows) map[r.team.code] = t2.group;
+      this.groupMap = map;
+      return map;
     } catch {
+      return {};
     }
-    this.groupMap = map;
-    return map;
   }
   async fetchScoreboard(dates) {
     const base = this.opts.baseUrl ?? DEFAULT_BASE;
     const url = new URL(`${base}/scoreboard`);
     url.searchParams.set("limit", "300");
     if (dates) url.searchParams.set("dates", dates);
-    const groupByTeam = this.opts.enrichGroups === false ? {} : await this.fetchGroupMap();
-    const data = await this.get(url.toString());
+    const [groupByTeam, data] = await Promise.all([
+      this.opts.enrichGroups === false ? Promise.resolve({}) : this.fetchGroupMap(),
+      this.get(url.toString())
+    ]);
     return (data.events ?? []).map((ev) => mapEspnEvent(ev, { groupByTeam }));
   }
   async get(url) {
@@ -3290,24 +3342,51 @@ var EspnAdapter = class {
     const controller = new AbortController();
     const timer = setTimeout(
       () => controller.abort(),
-      this.opts.timeoutMs ?? 15e3
+      this.opts.timeoutMs ?? DEFAULT_TIMEOUT_MS
     );
+    this.lastError = void 0;
     try {
-      const res = await doFetch(url, {
-        signal: controller.signal,
-        // ESPN never legitimately redirects; following one would sidestep the
-        // fixed-host guarantee, so treat any redirect as a failure (degraded).
-        redirect: "error",
-        headers: { Accept: "application/json", "User-Agent": USER_AGENT }
-      });
+      let res;
+      try {
+        res = await doFetch(url, {
+          signal: controller.signal,
+          // ESPN never legitimately redirects; following one would sidestep the
+          // fixed-host guarantee, so treat any redirect as a failure (degraded).
+          redirect: "error",
+          headers: { Accept: "application/json", "User-Agent": USER_AGENT }
+        });
+      } catch (e) {
+        throw e?.name === "AbortError" ? new ProviderError(`ESPN request timed out: ${url}`, "timeout") : new ProviderError(`ESPN request failed: ${e?.message ?? e}`, "http");
+      }
       if (!res.ok) {
-        throw new Error(`ESPN request failed: ${res.status} ${res.statusText}`);
+        throw new ProviderError(
+          `ESPN request failed: ${res.status} ${res.statusText}`,
+          "http",
+          res.status
+        );
       }
       const length = Number(res.headers?.get?.("content-length"));
       if (Number.isFinite(length) && length > MAX_RESPONSE_BYTES) {
-        throw new Error(`ESPN response too large: ${length} bytes`);
+        throw new ProviderError(`ESPN response too large: ${length} bytes`, "parse");
+      }
+      try {
+        return await res.json();
+      } catch (e) {
+        throw new ProviderError(
+          `ESPN response unparseable: ${e?.message ?? e}`,
+          "parse"
+        );
       }
-      return await res.json();
+    } catch (e) {
+      const pe = e instanceof ProviderError ? e : new ProviderError(String(e?.message ?? e), "http");
+      this.lastError = pe;
+      if (typeof process !== "undefined" && process.env?.CLAUDINHO_DEBUG) {
+        process.stderr.write(
+          `claudinho: espn ${pe.kind}${pe.status ? ` ${pe.status}` : ""}: ${url}
+`
+        );
+      }
+      throw pe;
     } finally {
       clearTimeout(timer);
     }
@@ -4201,13 +4280,18 @@ function resolveCompetition(explicit) {
   }
   return DEFAULT_COMPETITION;
 }
+var KNOWN_SOURCES = ["espn"];
 function makeAdapter(source = "espn") {
   switch (source) {
-    default: {
+    case "espn": {
       const competition = resolveCompetition();
       const baseUrl = competition === DEFAULT_COMPETITION ? void 0 : competitionBase(competition);
       return new EspnAdapter({ baseUrl });
     }
+    default:
+      throw new Error(
+        `Unknown data source "${source}" (available: ${KNOWN_SOURCES.join(", ")})`
+      );
   }
 }
 function mergeLive(base, live) {
@@ -4245,8 +4329,16 @@ async function getStandings(adapter, group) {
   const tables = letters.map((g) => ({ group: g, rows: rosterAtZero(fixturesByGroup(g)) })).filter((t2) => t2.rows.length > 0);
   return { tables, degraded: true };
 }
-var KNOCKOUT_WINDOW_START = "20260628";
-var KNOCKOUT_WINDOW_END = "20260719";
+var knockoutWindowMemo;
+function knockoutWindow() {
+  if (knockoutWindowMemo !== void 0) return knockoutWindowMemo;
+  const days = allFixtures().filter((m) => m.stage !== "GROUP" && m.stage !== "FRIENDLY").map((m) => m.kickoff.slice(0, 10).replace(/-/g, "")).filter((d) => d.length === 8);
+  knockoutWindowMemo = days.length ? {
+    start: days.reduce((a, b) => a < b ? a : b),
+    end: days.reduce((a, b) => a > b ? a : b)
+  } : null;
+  return knockoutWindowMemo;
+}
 async function getBracket(adapter, opts = {}) {
   const topology = loadBracketTopology();
   const base = allFixtures().filter((m) => m.stage !== "GROUP" && m.stage !== "FRIENDLY");
@@ -4254,7 +4346,8 @@ async function getBracket(adapter, opts = {}) {
   let liveDegraded = true;
   let source;
   try {
-    const live = adapter.fetchWindow ? await adapter.fetchWindow(KNOCKOUT_WINDOW_START, KNOCKOUT_WINDOW_END) : [];
+    const win = knockoutWindow();
+    const live = adapter.fetchWindow && win ? await adapter.fetchWindow(win.start, win.end) : [];
     matches = mergeLive(base, live);
     liveDegraded = false;
     source = adapter.name;
@@ -4287,8 +4380,9 @@ async function marketFixtureForTeam(adapter, code, now = /* @__PURE__ */ new Dat
   let fixtures = allFixtures();
   let overlayFailed = false;
   try {
-    if (adapter.fetchWindow) {
-      fixtures = mergeLive(fixtures, await adapter.fetchWindow(KNOCKOUT_WINDOW_START, KNOCKOUT_WINDOW_END));
+    const win = knockoutWindow();
+    if (adapter.fetchWindow && win) {
+      fixtures = mergeLive(fixtures, await adapter.fetchWindow(win.start, win.end));
     }
   } catch {
     overlayFailed = true;
@@ -4311,7 +4405,8 @@ async function getNextFixtureForTeam(adapter, code, now = /* @__PURE__ */ new Da
   let degraded = true;
   let liveById;
   try {
-    const live = adapter.fetchWindow ? await adapter.fetchWindow(KNOCKOUT_WINDOW_START, KNOCKOUT_WINDOW_END) : [];
+    const win = knockoutWindow();
+    const live = adapter.fetchWindow && win ? await adapter.fetchWindow(win.start, win.end) : [];
     matches = mergeLive(base, live);
     degraded = false;
     liveById = new Set(live.map((m) => m.id));
@@ -4322,10 +4417,11 @@ async function getNextFixtureForTeam(adapter, code, now = /* @__PURE__ */ new Da
   return { fixture, degraded, source };
 }
 async function getKnockoutFixtures(adapter, now = /* @__PURE__ */ new Date()) {
-  if (!adapter.fetchWindow) return { fixtures: [], degraded: true };
+  const win = knockoutWindow();
+  if (!adapter.fetchWindow || !win) return { fixtures: [], degraded: true };
   let live;
   try {
-    live = await adapter.fetchWindow(KNOCKOUT_WINDOW_START, KNOCKOUT_WINDOW_END);
+    live = await adapter.fetchWindow(win.start, win.end);
   } catch {
     return { fixtures: [], degraded: true };
   }
@@ -4583,7 +4679,7 @@ var mapping_2026_default = {
 var DEFAULT_BASE2 = "https://gamma-api.polymarket.com";
 var ALLOWED_HOSTS = /* @__PURE__ */ new Set(["gamma-api.polymarket.com"]);
 var USER_AGENT2 = "claudinho/0.0 (+https://github.com/arturogarrido/claudinho)";
-var DEFAULT_TIMEOUT_MS = 8e3;
+var DEFAULT_TIMEOUT_MS2 = 8e3;
 var WC_SERIES_SLUG = "soccer-fifwc";
 var WC_SPORT = "fifwc";
 var KICKOFF_TOLERANCE_MS = 6 * 60 * 6e4;
@@ -4621,7 +4717,7 @@ var PolymarketProvider = class {
     const entry = (this.opts.mapping ?? BUNDLED_MAPPING)[match.id];
     const slugs = entry?.eventSlug ? [entry.eventSlug] : deriveEventSlugs(match);
     if (slugs.length === 0) return { checked: true };
-    const configured = options?.timeoutMs ?? this.opts.timeoutMs ?? DEFAULT_TIMEOUT_MS;
+    const configured = options?.timeoutMs ?? this.opts.timeoutMs ?? DEFAULT_TIMEOUT_MS2;
     try {
       for (const slug of slugs) {
         const remaining = deadline - Date.now();
@@ -4641,7 +4737,7 @@ var PolymarketProvider = class {
     const url = `${base}/events?slug=${encodeURIComponent(slug)}`;
     const doFetch = this.opts.fetchImpl ?? fetch;
     const res = await doFetch(url, {
-      signal: AbortSignal.timeout(timeoutMs ?? this.opts.timeoutMs ?? DEFAULT_TIMEOUT_MS),
+      signal: AbortSignal.timeout(timeoutMs ?? this.opts.timeoutMs ?? DEFAULT_TIMEOUT_MS2),
       // Gamma never legitimately redirects; following one would sidestep the
       // host allow-list (it only validates the base URL), so reject redirects.
       redirect: "error",
@@ -5110,8 +5206,10 @@ export {
   FEED_TEXT_MAX,
   FLAVOR_LEVELS,
   FakeMarketProvider,
+  KNOWN_SOURCES,
   LIVE_WINDOW_MS,
   PolymarketProvider,
+  ProviderError,
   SHARE_DISCLAIMER,
   SHARE_HASHTAG,
   allFixtures,
@@ -5162,6 +5260,7 @@ export {
   isStaleSignal,
   isValidDate,
   isValidTimeZone,
+  knockoutWindow,
   liveSourceLabel,
   loadBracketTopology,
   localDate,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@claudinho/core",
-  "version": "0.8.19",
+  "version": "0.9.0",
   "description": "Domain model, provider adapters (ESPN), standings, bundled schedule, and the read-only Polymarket market-signal sidecar powering Claudinho. Not affiliated with FIFA or Anthropic.",
   "type": "module",
   "license": "MIT",
@@ -54,6 +54,7 @@
   ],
   "devDependencies": {
     "@types/node": "^22.20.0",
+    "@vitest/coverage-v8": "^4.1.9",
     "tsup": "^8.0.0",
     "tsx": "^4.19.0",
     "typescript": "^5.7.0",