@claudinho/core 0.8.16 → 0.8.18

package/dist/index.d.ts

@@ -355,6 +355,30 @@ declare function currentOrNextFixtureForTeam(code: string, opts?: {
 /** Sorted list of distinct group letters present in the schedule. */
 declare function groups(fixtures?: Match[]): string[];
 
+/** A roster team plus its group letter (A–L). */
+interface TeamInfo extends Team {
+    group?: string;
+}
+/**
+ * The 48-team roster from the bundled group-stage fixtures, sorted by name.
+ * Placeholder/knockout slots (non-3-letter code or 🏳️) are skipped.
+ */
+declare function allTeams(fixtures?: Match[]): TeamInfo[];
+interface TeamLookup {
+    query: string;
+    /** The single confident match, or null when the query is ambiguous or unknown. */
+    team: TeamInfo | null;
+    /** All candidate teams, best-first (1+ whenever anything matched). */
+    matches: TeamInfo[];
+}
+/**
+ * Resolve a free-text team name or code to a roster team. Precedence: exact code,
+ * exact name, alias, then prefix/substring fuzzy on the name (fuzzy only for
+ * queries of 3+ letters, so a 1–2 char query can't substring-match noise). A
+ * unique fuzzy hit resolves; multiple hits return as candidates with `team: null`.
+ */
+declare function lookupTeam(query: string, fixtures?: Match[]): TeamLookup;
+
 /** One row of a group table. */
 interface StandingRow {
     team: Team;
@@ -1152,4 +1176,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, marketSignalRendersFor, 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, type TeamInfo, type TeamLookup, allFixtures, allTeams, 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, lookupTeam, 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

@@ -2900,6 +2900,62 @@ function groups(fixtures = SCHEDULE) {
   return [...set].sort();
 }
 
+// src/teams.ts
+function norm2(s) {
+  return s.toLowerCase().normalize("NFD").replace(/[̀-ͯ]/g, "").replace(/[^a-z]/g, "");
+}
+function allTeams(fixtures = allFixtures()) {
+  const seen = /* @__PURE__ */ new Map();
+  for (const m of fixtures) {
+    if (m.stage !== "GROUP") continue;
+    for (const t2 of [m.home, m.away]) {
+      if (!/^[A-Z]{3}$/.test(t2.code) || t2.flag === "\u{1F3F3}\uFE0F") continue;
+      if (!seen.has(t2.code)) seen.set(t2.code, { ...t2, group: m.group ?? void 0 });
+    }
+  }
+  return [...seen.values()].sort((a, b) => a.name.localeCompare(b.name));
+}
+var TEAM_ALIASES = {
+  turkey: "TUR",
+  holland: "NED",
+  korea: "KOR",
+  skorea: "KOR",
+  korearepublic: "KOR",
+  republicofkorea: "KOR",
+  czechrepublic: "CZE",
+  congo: "COD",
+  drcongo: "COD",
+  drc: "COD",
+  democraticrepublicofcongo: "COD",
+  democraticrepublicofthecongo: "COD",
+  cotedivoire: "CIV",
+  caboverde: "CPV",
+  bosnia: "BIH",
+  bosniaandherzegovina: "BIH",
+  us: "USA",
+  america: "USA",
+  unitedstatesofamerica: "USA"
+};
+function lookupTeam(query, fixtures = allFixtures()) {
+  const roster = allTeams(fixtures);
+  const q = norm2(query);
+  if (!q) return { query, team: null, matches: [] };
+  const byCode = roster.find((t2) => norm2(t2.code) === q);
+  if (byCode) return { query, team: byCode, matches: [byCode] };
+  const byName = roster.find((t2) => norm2(t2.name) === q);
+  if (byName) return { query, team: byName, matches: [byName] };
+  const aliasCode = TEAM_ALIASES[q];
+  if (aliasCode) {
+    const t2 = roster.find((r) => r.code === aliasCode);
+    if (t2) return { query, team: t2, matches: [t2] };
+  }
+  if (q.length < 3) return { query, team: null, matches: [] };
+  const prefix = roster.filter((t2) => norm2(t2.name).startsWith(q));
+  const substr = roster.filter((t2) => norm2(t2.name).includes(q) && !prefix.includes(t2));
+  const matches = [...prefix, ...substr];
+  return { query, team: matches.length === 1 ? matches[0] : null, matches };
+}
+
 // src/standings.ts
 function blankRow(team) {
   return {
@@ -4465,7 +4521,8 @@ var PolymarketProvider = class {
   opts;
   name = "polymarket";
   async findSignal(match, options) {
-    return (await this.resolveOne(match, options)).signal;
+    const deadline = options?.deadlineMs != null ? Date.now() + options.deadlineMs : Number.POSITIVE_INFINITY;
+    return (await this.resolveOne(match, options, deadline)).signal;
   }
   async findSignals(matches, options) {
     const signals = /* @__PURE__ */ new Map();
@@ -4473,7 +4530,7 @@ var PolymarketProvider = class {
     const deadline = options?.deadlineMs != null ? Date.now() + options.deadlineMs : Number.POSITIVE_INFINITY;
     for (const m of matches) {
       if (Date.now() >= deadline) break;
-      const r = await this.resolveOne(m, options);
+      const r = await this.resolveOne(m, options, deadline);
       if (r.checked) checked.add(m.id);
       if (r.signal) signals.set(m.id, r.signal);
     }
@@ -4485,13 +4542,16 @@ var PolymarketProvider = class {
    * provider/network error — so transient failures are retried, not
    * negative-cached.
    */
-  async resolveOne(match, options) {
+  async resolveOne(match, options, deadline = Number.POSITIVE_INFINITY) {
     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;
     try {
       for (const slug of slugs) {
-        const event = await this.fetchEvent(slug, options?.timeoutMs);
+        const remaining = deadline - Date.now();
+        if (remaining <= 0) return { checked: false };
+        const event = await this.fetchEvent(slug, Math.min(configured, remaining));
         const signal = event ? this.toSignal(match, slug, event, options) : void 0;
         if (signal) return { signal, checked: true };
       }
@@ -4571,6 +4631,27 @@ var PolymarketProvider = class {
     return signal.ambiguous ? void 0 : signal;
   }
 };
+var POLYMARKET_TOKEN = {
+  SUI: "che",
+  // Switzerland
+  NED: "nld",
+  // Netherlands
+  URU: "ury",
+  // Uruguay
+  POR: "prt",
+  // Portugal
+  CRO: "hrv",
+  // Croatia
+  COD: "cdr",
+  // DR Congo
+  CPV: "cvi"
+  // Cabo Verde
+};
+function pmTokens(code) {
+  const c = code.toLowerCase();
+  const alias = POLYMARKET_TOKEN[code.toUpperCase()];
+  return alias && alias !== c ? [alias, c] : [c];
+}
 function deriveEventSlugs(match) {
   const home = match.home.code.toLowerCase();
   const away = match.away.code.toLowerCase();
@@ -4578,10 +4659,18 @@ function deriveEventSlugs(match) {
   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)}`
-  ];
+  const dates = [utcDate, shiftUtcDate(utcDate, -1)];
+  const homeToks = pmTokens(match.home.code);
+  const awayToks = pmTokens(match.away.code);
+  const slugs = [];
+  for (const d of dates) {
+    for (const h of homeToks) {
+      for (const a of awayToks) {
+        slugs.push(`fifwc-${h}-${a}-${d}`);
+      }
+    }
+  }
+  return [...new Set(slugs)];
 }
 function slugToken(m) {
   return (m.slug ?? "").toLowerCase().split("-").pop() ?? "";
@@ -4590,10 +4679,10 @@ function isDrawMarket(m) {
   return slugToken(m) === "draw" || (m.groupItemTitle ?? "").trim().toLowerCase().startsWith("draw");
 }
 function pickMarket(markets, teamCode, teamName) {
-  const code = teamCode.toLowerCase();
+  const tokens = pmTokens(teamCode);
   const name = teamName.trim().toLowerCase();
   const teamMarkets = markets.filter((m) => !isDrawMarket(m));
-  const bySlug = teamMarkets.find((m) => slugToken(m) === code);
+  const bySlug = teamMarkets.find((m) => tokens.includes(slugToken(m)));
   if (bySlug) return bySlug;
   return teamMarkets.find((m) => (m.groupItemTitle ?? "").trim().toLowerCase() === name);
 }
@@ -4943,6 +5032,7 @@ export {
   SHARE_DISCLAIMER,
   SHARE_HASHTAG,
   allFixtures,
+  allTeams,
   asFlavorLevel,
   buildBracketTopology,
   buildBracketView,
@@ -4991,6 +5081,7 @@ export {
   liveSourceLabel,
   loadBracketTopology,
   localDate,
+  lookupTeam,
   makeAdapter,
   makeMarketProvider,
   mapEspnEvent,

package/package.json

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