@claudinho/core 0.9.1 → 0.9.3

package/dist/index.d.ts

@@ -385,9 +385,48 @@ declare function nextFixtureForTeam(code: string, opts?: {
     from?: Date;
     fixtures?: Match[];
 }): Match | undefined;
-/** A fixture is potentially live from kickoff until ~kickoff + 140 min. */
+/**
+ * A group/regular fixture is potentially live from kickoff until ~kickoff + 140
+ * min (90' + half-time + stoppage).
+ */
 declare const LIVE_WINDOW_MS: number;
-/** Fixtures whose live window contains `now` (cheap, static — no network). */
+/**
+ * Extra allowance for knockout matches, which can go to extra time (+30') and a
+ * penalty shootout, running to ~kickoff + 190 min — well past LIVE_WINDOW_MS.
+ * Without it the statusline refresher stops polling at kickoff+140min and the
+ * cache goes stale mid-match, so a knockout tie still level after 90' (in ET or
+ * penalties) silently drops off the statusline while it's still being played.
+ * Numerically matches the slack `marketFixtureForTeam` already applies (live.ts).
+ */
+declare const KNOCKOUT_EXTRA_TIME_MS: number;
+/** Live-window length for a fixture — longer for knockout (extra time + penalties). */
+declare function liveWindowMsFor(m: Match): number;
+/**
+ * True once EVERY bundled fixture's (stage-aware) live window has ELAPSED —
+ * derived from the bundled schedule rather than a hardcoded date (same reasoning
+ * as the derived knockout window: the `CLAUDINHO_COMPETITION` seam must not carry
+ * a dead calendar).
+ *
+ * Named for exactly what it measures. This is a TIME predicate, not proof that
+ * every match was played: the bundled schedule is a **resultless skeleton** (every
+ * fixture ships `SCHEDULED` by design), so status can't inform it — a POSTPONED or
+ * abandoned fixture still reads as elapsed once its window passes. That is
+ * acceptable for the only use it has (turning a spent schedule into a sign-off),
+ * and it's why this is not called `isTournamentComplete`. **Make it status-aware
+ * against the live overlay before reusing it for anything that asserts results.**
+ *
+ * Deliberately a GLOBAL condition, independent of any team filter: an eliminated
+ * team mid-tournament has no next fixture either, and must NOT read as "over".
+ * Every other empty case still fails closed to the neutral `⚽ —`.
+ *
+ * Callers must additionally confirm the bundled schedule even applies — it
+ * describes the DEFAULT competition, so `CLAUDINHO_COMPETITION` pointing elsewhere
+ * makes this answer meaningless (see the `DEFAULT_COMPETITION` gates in the CLI).
+ *
+ * Empty fixture list → false: "we know nothing" is not "it's over".
+ */
+declare function isTournamentWindowOver(now?: number, fixtures?: Match[]): boolean;
+/** Fixtures whose (stage-aware) live window contains `now` (cheap, static — no network). */
 declare function fixturesInLiveWindow(now?: number, fixtures?: Match[]): Match[];
 /**
  * The team's in-play fixture when one is inside its live window, else the next
@@ -1279,4 +1318,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, 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 };
+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, KNOCKOUT_EXTRA_TIME_MS, 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, isTournamentWindowOver, isValidDate, isValidTimeZone, knockoutWindow, liveSourceLabel, liveWindowMsFor, 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

@@ -2941,10 +2941,22 @@ function nextFixtureForTeam(code, opts = {}) {
   );
 }
 var LIVE_WINDOW_MS = 140 * 6e4;
+var KNOCKOUT_EXTRA_TIME_MS = 60 * 6e4;
+function liveWindowMsFor(m) {
+  return m.stage === "GROUP" || m.stage === "FRIENDLY" ? LIVE_WINDOW_MS : LIVE_WINDOW_MS + KNOCKOUT_EXTRA_TIME_MS;
+}
+function isTournamentWindowOver(now = Date.now(), fixtures = SCHEDULE) {
+  if (fixtures.length === 0) return false;
+  return fixtures.every((m) => {
+    const k = Date.parse(m.kickoff);
+    if (Number.isNaN(k)) return false;
+    return now > k + liveWindowMsFor(m);
+  });
+}
 function fixturesInLiveWindow(now = Date.now(), fixtures = SCHEDULE) {
   return fixtures.filter((m) => {
     const k = Date.parse(m.kickoff);
-    return now >= k && now <= k + LIVE_WINDOW_MS;
+    return now >= k && now <= k + liveWindowMsFor(m);
   }).sort(byKickoff);
 }
 function currentOrNextFixtureForTeam(code, opts = {}) {
@@ -2952,7 +2964,7 @@ function currentOrNextFixtureForTeam(code, opts = {}) {
   const nowMs = from.getTime();
   const inPlay = fixturesByTeam(code, opts.fixtures ?? SCHEDULE).find((m) => {
     const k = Date.parse(m.kickoff);
-    return nowMs >= k && nowMs <= k + LIVE_WINDOW_MS;
+    return nowMs >= k && nowMs <= k + liveWindowMsFor(m);
   });
   return inPlay ?? nextFixtureForTeam(code, opts);
 }
@@ -3086,7 +3098,7 @@ 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.9.1"} (+https://github.com/arturogarrido/claudinho)`;
+var USER_AGENT = `claudinho/${"0.9.3"} (+https://github.com/arturogarrido/claudinho)`;
 var MAX_RESPONSE_BYTES = 5 * 1024 * 1024;
 function competitionBase(slug) {
   return `${ESPN_SOCCER}/${slug}`;
@@ -5206,6 +5218,7 @@ export {
   FEED_TEXT_MAX,
   FLAVOR_LEVELS,
   FakeMarketProvider,
+  KNOCKOUT_EXTRA_TIME_MS,
   KNOWN_SOURCES,
   LIVE_WINDOW_MS,
   PolymarketProvider,
@@ -5258,10 +5271,12 @@ export {
   isReliableMarketSignal,
   isResolvedNation,
   isStaleSignal,
+  isTournamentWindowOver,
   isValidDate,
   isValidTimeZone,
   knockoutWindow,
   liveSourceLabel,
+  liveWindowMsFor,
   loadBracketTopology,
   localDate,
   lookupTeam,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@claudinho/core",
-  "version": "0.9.1",
+  "version": "0.9.3",
   "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.0",
-    "@vitest/coverage-v8": "^4.1.9",
+    "@types/node": "^22.20.1",
+    "@vitest/coverage-v8": "^4.1.10",
     "tsup": "^8.0.0",
-    "tsx": "^4.23.0",
+    "tsx": "^4.23.1",
     "typescript": "^5.7.0",
-    "vitest": "^4.1.9"
+    "vitest": "^4.1.10"
   },
   "scripts": {
     "build": "tsup",