@claudinho/core 0.8.11 → 0.8.13

package/dist/index.d.ts

@@ -847,6 +847,17 @@ declare function deriveFavorite(outcomes: MarketOutcome[]): MarketFavorite | und
  * draw line (a 90' group result must price the draw).
  */
 declare function mapsCleanly(match: Match, outcomes: MarketOutcome[]): boolean;
+/**
+ * Is a (possibly cached/looked-up) signal safe to RENDER for THIS fixture? A
+ * signal is keyed and stored by match id, but display labels are taken from the
+ * *current* Match — so a cached signal must be re-checked against the fixture
+ * actually being shown. The guard: same match id AND the outcomes still map to
+ * the fixture's real teams. This fails closed when a knockout slot the feed
+ * resolved earlier later degrades back to a 🏳️ placeholder (the signal's own
+ * `ambiguous` flag was decided at fetch time, against the resolved match, so it
+ * can't catch this on its own).
+ */
+declare function marketSignalRendersFor(match: Match, signal: MarketSignal): boolean;
 /** Sanity check: ≥2 priced outcomes whose probabilities sum to ~1. */
 declare function hasSaneDistribution(outcomes: MarketOutcome[]): boolean;
 /** Is the signal older than the freshness window? Unparseable timestamps are stale. */
@@ -952,29 +963,6 @@ declare class FakeMarketProvider implements MarketProvider {
     private synthesize;
 }
 
-/**
- * Polymarket public-data adapter — read-only prediction-market signals.
- *
- * STRICT read-only by design: it touches only the public Gamma events/markets
- * data endpoint. No auth, no wallet, no CLOB/order endpoints, no trading, and no
- * outbound links (sourceMarketId is opaque, never a URL). Any network/parse/host
- * error degrades to "no signal" — it never throws.
- *
- * Payload model (verified against the live Gamma API, see
- * docs/POLYMARKET_MARKET_PREDICTIONS.md): a World Cup match is a Gamma EVENT
- * (`fifwc-{home}-{away}-{date}`) whose payload carries the three moneyline
- * BINARY markets — home win / draw / away win. Each is `outcomes: ["Yes","No"]`
- * and the outcome's probability is its "Yes" price.
- *
- * Mapping is by event slug, which is deterministic — so by default the slug is
- * DERIVED from the fixture (team codes + UTC date) and every match attempts
- * enrichment. A hand-curated entry in mapping.2026.json overrides the derived
- * slug for the rare fixture whose slug doesn't follow the pattern. Because the
- * slug is a guess, validation FAILS CLOSED: the returned event must match the
- * requested slug, line up on kickoff, expose the right moneyline markets, and
- * resolve in regular time — otherwise no signal is produced.
- */
-
 /**
  * Optional override of the derived event slug for a fixture whose Polymarket
  * slug doesn't follow `fifwc-{home}-{away}-{date}` (e.g. an abbreviation that
@@ -1164,4 +1152,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, 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, 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, getKnockoutFixtures, getLiveMatches, getMarketSignal, getMarketSignals, getMatchById, getMatchesForDate, getNextFixtureForTeam, getStandings, groups, hasSaneDistribution, isFinished, isFlavorLevel, isLive, isReliableMarketSignal, isResolvedNation, 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, 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, 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, getKnockoutFixtures, getLiveMatches, getMarketSignal, getMarketSignals, getMatchById, getMatchesForDate, getNextFixtureForTeam, getStandings, groups, hasSaneDistribution, isFinished, isFlavorLevel, isLive, isReliableMarketSignal, isResolvedNation, isStaleSignal, isValidDate, isValidTimeZone, liveSourceLabel, loadBracketTopology, localDate, makeAdapter, makeMarketProvider, mapEspnEvent, mapsCleanly, marketAttributionText, marketBlock, marketFavoriteText, marketFixtureForTeam, marketLine, marketProbabilityText, marketRelevant, marketSignalRendersFor, 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

@@ -497,6 +497,10 @@ function localDate(iso, tz) {
     timeZone: zone
   }).format(new Date(iso));
 }
+function shiftUtcDate(dateISO, days) {
+  const [y, m, d] = dateISO.slice(0, 10).split("-").map(Number);
+  return new Date(Date.UTC(y ?? 1970, (m ?? 1) - 1, (d ?? 1) + days)).toISOString().slice(0, 10);
+}
 
 // src/normalize.ts
 function outcomeFromScore(home, away) {
@@ -4141,14 +4145,19 @@ async function getBracket(adapter, opts = {}) {
     source
   };
 }
-function shiftUtcDate(dateISO, days) {
-  const [y, m, d] = dateISO.slice(0, 10).split("-").map(Number);
-  return new Date(Date.UTC(y ?? 1970, (m ?? 1) - 1, (d ?? 1) + days)).toISOString().slice(0, 10);
-}
 var EXTRA_TIME_SLACK_MS = 60 * 6e4;
 async function marketFixtureForTeam(adapter, code, now = /* @__PURE__ */ new Date()) {
   const nowMs = now.getTime();
-  const candidate = fixturesByTeam(code).find((m) => {
+  let fixtures = allFixtures();
+  let overlayFailed = false;
+  try {
+    if (adapter.fetchWindow) {
+      fixtures = mergeLive(fixtures, await adapter.fetchWindow(KNOCKOUT_WINDOW_START, KNOCKOUT_WINDOW_END));
+    }
+  } catch {
+    overlayFailed = true;
+  }
+  const candidate = fixturesByTeam(code, fixtures).find((m) => {
     const k = Date.parse(m.kickoff);
     return nowMs >= k && nowMs <= k + LIVE_WINDOW_MS + EXTRA_TIME_SLACK_MS;
   });
@@ -4157,8 +4166,8 @@ async function marketFixtureForTeam(adapter, code, now = /* @__PURE__ */ new Dat
     const m = r.match ?? candidate;
     if (!isFinished(m.status)) return { ...r, match: m };
   }
-  const next = nextFixtureForTeam(code, { from: now });
-  return { match: next, degraded: false };
+  const next = nextFixtureForTeam(code, { from: now, fixtures });
+  return { match: next, degraded: overlayFailed };
 }
 async function getNextFixtureForTeam(adapter, code, now = /* @__PURE__ */ new Date()) {
   const base = allFixtures();
@@ -4267,6 +4276,9 @@ function mapsCleanly(match, outcomes) {
   if (match.stage === "GROUP" && !draw) return false;
   return true;
 }
+function marketSignalRendersFor(match, signal) {
+  return signal.matchId === match.id && mapsCleanly(match, signal.outcomes);
+}
 function hasSaneDistribution(outcomes) {
   const priced = outcomes.filter((o) => Number.isFinite(o.probability) && o.probability > 0);
   if (priced.length < 2) return false;
@@ -4470,12 +4482,15 @@ var PolymarketProvider = class {
    */
   async resolveOne(match, options) {
     const entry = (this.opts.mapping ?? BUNDLED_MAPPING)[match.id];
-    const eventSlug = entry?.eventSlug ?? deriveEventSlug(match);
-    if (!eventSlug) return { checked: true };
+    const slugs = entry?.eventSlug ? [entry.eventSlug] : deriveEventSlugs(match);
+    if (slugs.length === 0) return { checked: true };
     try {
-      const event = await this.fetchEvent(eventSlug, options?.timeoutMs);
-      const signal = event ? this.toSignal(match, eventSlug, event, options) : void 0;
-      return { signal, checked: true };
+      for (const slug of slugs) {
+        const event = await this.fetchEvent(slug, options?.timeoutMs);
+        const signal = event ? this.toSignal(match, slug, event, options) : void 0;
+        if (signal) return { signal, checked: true };
+      }
+      return { checked: true };
     } catch {
       return { checked: false };
     }
@@ -4551,14 +4566,17 @@ var PolymarketProvider = class {
     return signal.ambiguous ? void 0 : signal;
   }
 };
-function deriveEventSlug(match) {
+function deriveEventSlugs(match) {
   const home = match.home.code.toLowerCase();
   const away = match.away.code.toLowerCase();
-  if (home === away || home === "tbd" || away === "tbd") return void 0;
-  if (!/^[a-z]{3}$/.test(home) || !/^[a-z]{3}$/.test(away)) return void 0;
-  const date = match.kickoff.slice(0, 10);
-  if (!/^\d{4}-\d{2}-\d{2}$/.test(date)) return void 0;
-  return `fifwc-${home}-${away}-${date}`;
+  if (home === away || home === "tbd" || away === "tbd") return [];
+  if (!/^[a-z]{3}$/.test(home) || !/^[a-z]{3}$/.test(away)) return [];
+  const utcDate = match.kickoff.slice(0, 10);
+  if (!/^\d{4}-\d{2}-\d{2}$/.test(utcDate)) return [];
+  return [
+    `fifwc-${home}-${away}-${utcDate}`,
+    `fifwc-${home}-${away}-${shiftUtcDate(utcDate, -1)}`
+  ];
 }
 function slugToken(m) {
   return (m.slug ?? "").toLowerCase().split("-").pop() ?? "";
@@ -4979,6 +4997,7 @@ export {
   marketLine,
   marketProbabilityText,
   marketRelevant,
+  marketSignalRendersFor,
   marketSourceLabel,
   matchFlavor,
   matchKey,

package/package.json

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