@claudinho/core 0.9.4 → 0.10.0

package/dist/index.d.ts

@@ -756,20 +756,31 @@ declare class EspnAdapter implements ProviderAdapter {
 /**
  * The ESPN competition slug to fetch live state from. Defaults to the 2026
  * World Cup (`fifa.world`); override with CLAUDINHO_COMPETITION (e.g.
- * `fifa.friendly` to follow international friendlies during pre-tournament
- * testing). Only affects the *live* fetch — the bundled static schedule is
- * always the World Cup.
+ * `eng.1`, `uefa.champions`, `fifa.friendly`). Only affects the *live* fetch —
+ * the bundled static schedule is always the World Cup.
+ *
+ * Lives in its own module so that both the live layer and the market sidecar
+ * read the ONE resolver without importing each other.
  */
 declare function resolveCompetition(explicit?: string): string;
+
 /** Provider names {@link makeAdapter} can construct (the CLI validates against this). */
 declare const KNOWN_SOURCES: readonly ["espn"];
+interface AdapterOptions {
+    /**
+     * Enrich group-stage fixtures with their group letter (one extra standings
+     * request per poll). Default on; the statusline refresher turns it off because
+     * it never renders group letters.
+     */
+    enrichGroups?: boolean;
+}
 /**
  * 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;
+declare function makeAdapter(source?: string, opts?: AdapterOptions): ProviderAdapter;
 /**
  * Merge live matches over a base set by id. Live entries replace base entries
  * with the same id; unknown ids are appended.
@@ -1184,11 +1195,19 @@ declare function marketLine(signal: MarketSignal, match: Match): string;
 declare function marketBlock(signal: MarketSignal, match: Match): string[];
 
 /**
- * Provider factory + graceful-degradation wrappers, mirroring `live.ts`'s
- * getMatchesForDate contract: a market signal is optional enrichment, so any
- * provider/network/parse error degrades to "no signal" and never throws.
+ * Competitions the market sidecar covers — CLAUDINHO'S implementation scope, not
+ * Polymarket's. Polymarket does carry per-match moneylines for leagues (the
+ * event `epl-lee-new-2026-09-14` has Leeds / draw / Newcastle legs), but this
+ * sidecar derives its event slugs from the World Cup series only (`fifwc-…`,
+ * series `soccer-fifwc` — see `deriveEventSlugs`) and validates fixture↔market
+ * identity with nation tokens. Outside this set every fixture would derive a
+ * slug that cannot exist, so the sidecar is switched off by construction
+ * instead of issuing doomed requests. Supporting a league is slug-derivation,
+ * mapping and validation work per competition — not widening this set.
  */
-
+declare const MARKET_COMPETITIONS: ReadonlySet<string>;
+/** Whether the market sidecar can say anything about the active competition. */
+declare function marketsCoverCompetition(competition?: string): boolean;
 /**
  * Resolve the market-data source: explicit arg > CLAUDINHO_MARKETS_SOURCE env >
  * 'polymarket' (mirrors resolveCompetition). Set CLAUDINHO_MARKETS_SOURCE=fake
@@ -1548,4 +1567,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 BatchResolution, type BoundedList, 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, FLAVOR_LEVELS, FakeMarketProvider, type FakeMarketProviderOptions, type FavoriteStrength, type FlavorLevel, type FormatOpts, type GroupStandings, KNOCKOUT_EXTRA_TIME_MS, KNOWN_SOURCES, type KnockoutFixturesResult, LIVE_WINDOW_MS, type Lang, type LedgerRow, type LiveResult, MAX_LABEL_COLUMNS, 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, type ParseResult, PolymarketProvider, type PolymarketProviderOptions, type ProviderAdapter, type ProviderCapabilities, ProviderError, type ProviderErrorKind, type PunditPick, type ResolvedParticipant, SHARE_DISCLAIMER, SHARE_HASHTAG, type Selection, 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, ambiguous, asFlavorLevel, bounded, buildBracketTopology, buildBracketView, buildMarketSignal, byKickoff, cacheableKeys, competitionBase, computeStandings, countdown, currentOrNextFixtureForTeam, definitiveNone, deriveFavorite, displayWidth, emptyBatch, 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, humanLabel, isCacheable, isFinished, isFlavorLevel, isLive, isReliableMarketSignal, isResolvedNation, isStaleSignal, isTournamentWindowOver, isValidDate, isValidTimeZone, knockoutWindow, liveSourceLabel, liveWindowMsFor, loadBracketTopology, localDate, lookupTeam, makeAdapter, makeMarketProvider, malformed, mapEspnEvent, mapsCleanly, marketAttributionText, marketBlock, marketFavoriteText, marketFixtureForTeam, marketLine, marketProbabilityText, marketRelevant, marketSignalRendersFor, marketSourceLabel, matchFlavor, matchKey, matchLocation, mergeLive, nationToFlag, nationToRegion, nextFixtureForTeam, normalizeLang, normalizeOutcomes, outcomeFromScore, padVisible, parseCachedMarketSignal, parseCachedMatch, parseCachedMatches, parseStandings, parseTeamSlot, parsedValue, productFlag, resolveCompetition, resolveMarketSource, resolveTz, resolvedValues, sanitizeBundledFixture, scoreline, sealMarketSignal, sealMatch, selectOne, stageLabel, stageLabelI18n, t, truncateVisible, unresolved, valid };
+export { BRACKET_STAGE_ORDER, type BatchResolution, type BoundedList, 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, FLAVOR_LEVELS, FakeMarketProvider, type FakeMarketProviderOptions, type FavoriteStrength, type FlavorLevel, type FormatOpts, type GroupStandings, KNOCKOUT_EXTRA_TIME_MS, KNOWN_SOURCES, type KnockoutFixturesResult, LIVE_WINDOW_MS, type Lang, type LedgerRow, type LiveResult, MARKET_COMPETITIONS, MAX_LABEL_COLUMNS, 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, type ParseResult, PolymarketProvider, type PolymarketProviderOptions, type ProviderAdapter, type ProviderCapabilities, ProviderError, type ProviderErrorKind, type PunditPick, type ResolvedParticipant, SHARE_DISCLAIMER, SHARE_HASHTAG, type Selection, 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, ambiguous, asFlavorLevel, bounded, buildBracketTopology, buildBracketView, buildMarketSignal, byKickoff, cacheableKeys, competitionBase, computeStandings, countdown, currentOrNextFixtureForTeam, definitiveNone, deriveFavorite, displayWidth, emptyBatch, 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, humanLabel, isCacheable, isFinished, isFlavorLevel, isLive, isReliableMarketSignal, isResolvedNation, isStaleSignal, isTournamentWindowOver, isValidDate, isValidTimeZone, knockoutWindow, liveSourceLabel, liveWindowMsFor, loadBracketTopology, localDate, lookupTeam, makeAdapter, makeMarketProvider, malformed, mapEspnEvent, mapsCleanly, marketAttributionText, marketBlock, marketFavoriteText, marketFixtureForTeam, marketLine, marketProbabilityText, marketRelevant, marketSignalRendersFor, marketSourceLabel, marketsCoverCompetition, matchFlavor, matchKey, matchLocation, mergeLive, nationToFlag, nationToRegion, nextFixtureForTeam, normalizeLang, normalizeOutcomes, outcomeFromScore, padVisible, parseCachedMarketSignal, parseCachedMatch, parseCachedMatches, parseStandings, parseTeamSlot, parsedValue, productFlag, resolveCompetition, resolveMarketSource, resolveTz, resolvedValues, sanitizeBundledFixture, scoreline, sealMarketSignal, sealMatch, selectOne, stageLabel, stageLabelI18n, t, truncateVisible, unresolved, valid };

package/dist/index.js

@@ -3620,7 +3620,7 @@ function parseEspnStandings(raw) {
       complete = false;
     }
     const entries = takeBounded(rawEntries, MAX_GROUP_ROWS);
-    const seenTeams = /* @__PURE__ */ new Set();
+    const seenCodes = /* @__PURE__ */ new Map();
     const seenRanks = /* @__PURE__ */ new Set();
     const ranked = [];
     for (const e of entries) {
@@ -3629,14 +3629,17 @@ function parseEspnStandings(raw) {
         if (r.kind !== "definitive-none") complete = false;
         continue;
       }
-      const key = r.value.providerId ?? r.value.team.code;
-      if (seenTeams.has(key) || seenRanks.has(r.value.providerRank) || r.value.providerId !== void 0 && seenProviderIds.has(r.value.providerId)) {
+      const { providerId, providerRank } = r.value;
+      const code = r.value.team.code;
+      const priorHadId = seenCodes.get(code);
+      const codeCollision = priorHadId !== void 0 && (providerId === void 0 || priorHadId === false);
+      if (codeCollision || seenRanks.has(providerRank) || providerId !== void 0 && seenProviderIds.has(providerId)) {
         complete = false;
         continue;
       }
-      seenTeams.add(key);
-      seenRanks.add(r.value.providerRank);
-      if (r.value.providerId !== void 0) seenProviderIds.add(r.value.providerId);
+      seenCodes.set(code, providerId !== void 0);
+      seenRanks.add(providerRank);
+      if (providerId !== void 0) seenProviderIds.add(providerId);
       const { providerId: _dropId, providerRank: rank, ...row } = r.value;
       ranked.push({ row, rank });
     }
@@ -3666,7 +3669,7 @@ function parseEspnStandings(raw) {
 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.9.4"} (+https://github.com/arturogarrido/claudinho)`;
+var USER_AGENT = `claudinho/${"0.10.0"} (+https://github.com/arturogarrido/claudinho)`;
 var MAX_RESPONSE_BYTES = 5 * 1024 * 1024;
 function competitionBase(slug) {
   return `${ESPN_SOCCER}/${slug}`;
@@ -4751,7 +4754,7 @@ function loadBracketTopology() {
   return TOPOLOGY;
 }
 
-// src/live.ts
+// src/competition.ts
 function resolveCompetition(explicit) {
   if (explicit) return explicit;
   if (typeof process !== "undefined" && process.env?.CLAUDINHO_COMPETITION) {
@@ -4759,13 +4762,15 @@ function resolveCompetition(explicit) {
   }
   return DEFAULT_COMPETITION;
 }
+
+// src/live.ts
 var KNOWN_SOURCES = ["espn"];
-function makeAdapter(source = "espn") {
+function makeAdapter(source = "espn", opts = {}) {
   switch (source) {
     case "espn": {
       const competition = resolveCompetition();
       const baseUrl = competition === DEFAULT_COMPETITION ? void 0 : competitionBase(competition);
-      return new EspnAdapter({ baseUrl });
+      return new EspnAdapter({ baseUrl, enrichGroups: opts.enrichGroups });
     }
     default:
       throw new Error(
@@ -5644,6 +5649,10 @@ function numberish(v) {
 }
 
 // src/markets/provider.ts
+var MARKET_COMPETITIONS = /* @__PURE__ */ new Set([DEFAULT_COMPETITION]);
+function marketsCoverCompetition(competition = resolveCompetition()) {
+  return MARKET_COMPETITIONS.has(competition);
+}
 function resolveMarketSource(explicit) {
   if (explicit) return explicit;
   if (typeof process !== "undefined" && process.env?.CLAUDINHO_MARKETS_SOURCE) {
@@ -5660,6 +5669,7 @@ function makeMarketProvider(source) {
       return new FakeMarketProvider();
     // no synth → yields no signals, no network
     default:
+      if (!marketsCoverCompetition()) return new FakeMarketProvider();
       return new PolymarketProvider();
   }
 }
@@ -5948,6 +5958,7 @@ export {
   KNOCKOUT_EXTRA_TIME_MS,
   KNOWN_SOURCES,
   LIVE_WINDOW_MS,
+  MARKET_COMPETITIONS,
   MAX_LABEL_COLUMNS,
   PolymarketProvider,
   ProviderError,
@@ -6029,6 +6040,7 @@ export {
   marketRelevant,
   marketSignalRendersFor,
   marketSourceLabel,
+  marketsCoverCompetition,
   matchFlavor,
   matchKey,
   matchLocation,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@claudinho/core",
-  "version": "0.9.4",
+  "version": "0.10.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",
@@ -53,12 +53,12 @@
     "agent"
   ],
   "devDependencies": {
-    "@types/node": "^22.20.1",
-    "@vitest/coverage-v8": "^4.1.10",
+    "@types/node": "^22.20.2",
+    "@vitest/coverage-v8": "^4.1.11",
     "tsup": "^8.0.0",
-    "tsx": "^4.23.1",
+    "tsx": "^4.23.13",
     "typescript": "^5.7.0",
-    "vitest": "^4.1.10"
+    "vitest": "^4.1.11"
   },
   "scripts": {
     "build": "tsup",