@claudinho/core 0.8.5 → 0.8.7

package/dist/index.d.ts

@@ -626,6 +626,31 @@ interface MatchByIdResult {
  * nothing rather than something wrong).
  */
 declare function marketFixtureForTeam(adapter: ProviderAdapter, code: string, now?: Date): Promise<MatchByIdResult>;
+interface NextFixtureResult {
+    fixture?: Match;
+    /** True when the live overlay fetch failed and only the static skeleton was used. */
+    degraded: boolean;
+    /** The provider that served the live overlay (absent when degraded). */
+    source?: string;
+}
+/**
+ * A team's next UPCOMING fixture, LIVE-RESOLVED across the knockout phase.
+ *
+ * The bundled schedule's knockout slots are resultless placeholders (home/away
+ * are slot refs like "Group A winner", never a nation — see
+ * {@link sanitizeBundledFixture}), so a purely static lookup goes blind the
+ * moment a team's last GROUP game passes: `next MEX` answers "no upcoming
+ * fixture" even after ESPN has confirmed Mexico's Round-of-32 tie. Overlay the
+ * live knockout window (the SAME single fetch {@link getBracket} uses) so the
+ * merged set carries the resolved nations, then pick the team's next fixture
+ * with kickoff ≥ now. (Strictly upcoming — the in-play match is `getLiveMatches`'
+ * job, preserving the pre-overlay `next` semantics.)
+ *
+ * Fails closed: on any provider error it falls back to the static result
+ * (`degraded: true`), so a feed outage degrades to "no fixture" rather than
+ * inventing one — advancement is never read from the static skeleton.
+ */
+declare function getNextFixtureForTeam(adapter: ProviderAdapter, code: string, now?: Date): Promise<NextFixtureResult>;
 /**
  * A single match by id, with live overlay. The provider's scoreboard buckets
  * days in its own zone (ESPN: US/Eastern), so a fixture's UTC date can differ
@@ -1099,4 +1124,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, FLAVOR_LEVELS, FakeMarketProvider, type FakeMarketProviderOptions, type FavoriteStrength, type FlavorLevel, type FormatOpts, type GroupStandings, 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 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, allFixtures, asFlavorLevel, buildBracketTopology, buildBracketView, buildMarketSignal, byKickoff, competitionBase, computeStandings, countdown, currentOrNextFixtureForTeam, deriveFavorite, favoriteStrength, fixturesByDate, fixturesByGroup, fixturesByTeam, fixturesInLiveWindow, flagEmoji, formatBracketCompactLine, formatBracketList, formatBracketMatchLine, formatBracketTree, formatDate, formatKickoff, formatShareBracket, formatShareSnippet, formatShareTable, formatTime, getBracket, getLiveMatches, getMarketSignal, getMarketSignals, getMatchById, getMatchesForDate, getStandings, groups, hasSaneDistribution, isFinished, isFlavorLevel, isLive, isReliableMarketSignal, isStaleSignal, isValidDate, isValidTimeZone, liveSourceLabel, loadBracketTopology, localDate, makeAdapter, makeMarketProvider, mapEspnEvent, mapsCleanly, marketAttributionText, marketBlock, marketFavoriteText, marketFixtureForTeam, marketLine, marketProbabilityText, marketRelevant, marketSourceLabel, matchFlavor, matchKey, matchLocation, mergeLive, nationToFlag, nationToRegion, nextFixtureForTeam, normalizeLang, normalizeOutcomes, outcomeFromScore, parseStandings, parseTeamSlot, resolveCompetition, resolveMarketSource, resolveTz, sanitizeBundledFixture, 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, FLAVOR_LEVELS, FakeMarketProvider, type FakeMarketProviderOptions, type FavoriteStrength, type FlavorLevel, type FormatOpts, type GroupStandings, 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, allFixtures, asFlavorLevel, buildBracketTopology, buildBracketView, buildMarketSignal, byKickoff, competitionBase, computeStandings, countdown, currentOrNextFixtureForTeam, deriveFavorite, favoriteStrength, fixturesByDate, fixturesByGroup, fixturesByTeam, fixturesInLiveWindow, flagEmoji, formatBracketCompactLine, formatBracketList, formatBracketMatchLine, formatBracketTree, formatDate, formatKickoff, formatShareBracket, formatShareSnippet, formatShareTable, formatTime, getBracket, getLiveMatches, getMarketSignal, getMarketSignals, getMatchById, getMatchesForDate, getNextFixtureForTeam, getStandings, groups, hasSaneDistribution, isFinished, isFlavorLevel, isLive, isReliableMarketSignal, isStaleSignal, isValidDate, isValidTimeZone, liveSourceLabel, loadBracketTopology, localDate, makeAdapter, makeMarketProvider, mapEspnEvent, mapsCleanly, marketAttributionText, marketBlock, marketFavoriteText, marketFixtureForTeam, marketLine, marketProbabilityText, marketRelevant, marketSourceLabel, matchFlavor, matchKey, matchLocation, mergeLive, nationToFlag, nationToRegion, nextFixtureForTeam, normalizeLang, normalizeOutcomes, outcomeFromScore, parseStandings, parseTeamSlot, resolveCompetition, resolveMarketSource, resolveTz, sanitizeBundledFixture, scoreline, stageLabel, stageLabelI18n, t };

package/dist/index.js

@@ -295,8 +295,8 @@ var ES = {
   "bracket.invalidStage": "La fase debe ser una de: R32, R16, QF, SF, 3P, F",
   "bracket.unknownStage": 'Fase desconocida "{stage}". Usa R32, R16, QF, SF, 3P o F.',
   "bracket.slot.groupWinner": "Ganador del grupo {group}",
-  "bracket.slot.groupSecond": "2.\xBA del grupo {group}",
-  "bracket.slot.third": "3.\xBA ({groups})",
+  "bracket.slot.groupSecond": "2\xBA del grupo {group}",
+  "bracket.slot.third": "3\xBA ({groups})",
   "bracket.slot.winner": "Ganador {stage} {n}",
   "bracket.slot.loser": "Perdedor {stage} {n}",
   "bracket.slot.tbd": "Por definir",
@@ -3400,17 +3400,24 @@ function participant(team, status) {
 function tbd(label) {
   return { label, flag: "\u{1F3F3}\uFE0F", status: "tbd" };
 }
+function confirmedLiveParticipant(team) {
+  if (!team || team.flag === "\u{1F3F3}\uFE0F") return void 0;
+  return participant(team, "confirmed");
+}
 function winnerLabel(ctx, stage, index) {
   return t(ctx.lang, "bracket.slot.winner", {
     stage: stageLabelI18n(ctx.lang, stage),
     n: String(index)
   });
 }
-function resolveSlot(ref, ctx) {
+function resolveSlot(ref, ctx, liveTeam) {
+  const liveParticipant = confirmedLiveParticipant(liveTeam);
   switch (ref.kind) {
     case "seed":
+      if (liveParticipant) return liveParticipant;
       return tbd(ref.label);
     case "group": {
+      if (liveParticipant) return liveParticipant;
       if (!ctx.standingsDegraded && hasGroupStarted(ref.group, ctx.tables)) {
         const team = teamFromStandings(ref.group, ref.position, ctx.tables);
         if (team) {
@@ -3422,6 +3429,7 @@ function resolveSlot(ref, ctx) {
       return tbd(label);
     }
     case "third":
+      if (liveParticipant) return liveParticipant;
       return tbd(t(ctx.lang, "bracket.slot.third", { groups: ref.groups.join("/") }));
     case "winner": {
       const node = ctx.nodesByKey.get(matchKey(ref.stage, ref.index));
@@ -3430,6 +3438,7 @@ function resolveSlot(ref, ctx) {
         const winner = resolveWinner(match);
         if (winner) return participant(winner, "confirmed");
       }
+      if (liveParticipant) return liveParticipant;
       return tbd(winnerLabel(ctx, ref.stage, ref.index));
     }
     case "loser": {
@@ -3439,6 +3448,7 @@ function resolveSlot(ref, ctx) {
         const loser = resolveLoser(match);
         if (loser) return participant(loser, "confirmed");
       }
+      if (liveParticipant) return liveParticipant;
       return tbd(
         t(ctx.lang, "bracket.slot.loser", {
           stage: stageLabelI18n(ctx.lang, ref.stage),
@@ -3476,8 +3486,8 @@ function buildBracketView(topology, matches, tables, standingsDegraded, liveDegr
         stage: node.stage,
         index: node.index,
         kickoff: match.kickoff,
-        home: resolveSlot(node.home, ctx),
-        away: resolveSlot(node.away, ctx),
+        home: resolveSlot(node.home, ctx, match.home),
+        away: resolveSlot(node.away, ctx, match.away),
         match
       };
     });
@@ -4142,6 +4152,22 @@ async function marketFixtureForTeam(adapter, code, now = /* @__PURE__ */ new Dat
   const next = nextFixtureForTeam(code, { from: now });
   return { match: next, degraded: false };
 }
+async function getNextFixtureForTeam(adapter, code, now = /* @__PURE__ */ new Date()) {
+  const base = allFixtures();
+  let matches = base;
+  let degraded = true;
+  let liveById;
+  try {
+    const live = adapter.fetchWindow ? await adapter.fetchWindow(KNOCKOUT_WINDOW_START, KNOCKOUT_WINDOW_END) : [];
+    matches = mergeLive(base, live);
+    degraded = false;
+    liveById = new Set(live.map((m) => m.id));
+  } catch {
+  }
+  const fixture = nextFixtureForTeam(code, { from: now, fixtures: matches });
+  const source = fixture && liveById?.has(fixture.id) ? adapter.name : void 0;
+  return { fixture, degraded, source };
+}
 async function getMatchById(adapter, id) {
   const base = allFixtures().find((m) => m.id === id);
   if (!base) return { match: void 0, degraded: false };
@@ -4904,6 +4930,7 @@ export {
   getMarketSignals,
   getMatchById,
   getMatchesForDate,
+  getNextFixtureForTeam,
   getStandings,
   groups,
   hasSaneDistribution,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@claudinho/core",
-  "version": "0.8.5",
+  "version": "0.8.7",
   "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",