@claudinho/core 0.5.0 → 0.5.2

package/dist/index.d.ts

@@ -424,6 +424,12 @@ declare class EspnAdapter implements ProviderAdapter {
     constructor(opts?: EspnAdapterOptions);
     fetchByDate(dateISO: string): Promise<Match[]>;
     fetchWindow(startDate: string, endDate: string): Promise<Match[]>;
+    /**
+     * In-play matches from ESPN's DEFAULT scoreboard bucket only (no `dates`). This
+     * single bucket misses a late kickoff ESPN files under an adjacent day, so it
+     * is a fallback for window-less callers — the domain `getLiveMatches` wraps a
+     * ±1-day window around this to catch boundary-crossing matches. Prefer it.
+     */
     fetchLive(): Promise<Match[]>;
     /** Standings endpoint URL (lives under apis/v2, not site/v2; derived from base). */
     private standingsUrl;
@@ -525,8 +531,20 @@ declare function marketFixtureForTeam(adapter: ProviderAdapter, code: string, no
  * provider error.
  */
 declare function getMatchById(adapter: ProviderAdapter, id: string): Promise<MatchByIdResult>;
-/** Currently-live matches; empty + degraded on error. */
-declare function getLiveMatches(adapter: ProviderAdapter): Promise<LiveResult>;
+/**
+ * Currently-live matches; empty + degraded on error.
+ *
+ * The provider buckets its scoreboard by its own day (ESPN: US/Eastern), so a
+ * late kickoff that crossed the day boundary lands in an ADJACENT bucket — a
+ * 04:00Z match still live at 76' while the provider's default "today" bucket
+ * already shows the prior, all-FT day. A bare `adapter.fetchLive()` reads only
+ * that single default bucket, so it silently MISSES such a match and `live` /
+ * the statusline / the hook show "nothing live" mid-match. Fetch the ±1-day UTC
+ * window around `now` instead — the same trick {@link getMatchesForDate} and
+ * {@link getMatchById} use — and filter to in-play, so no live match can hide in
+ * an adjacent bucket. Adapters without a window fetch fall back to `fetchLive()`.
+ */
+declare function getLiveMatches(adapter: ProviderAdapter, now?: Date): Promise<LiveResult>;
 
 /**
  * Prediction-market "signal" model — a *sidecar* to Match, deliberately never
@@ -866,6 +884,14 @@ interface ShareSnippetInput {
     emptyNote?: string;
     /** Exact run cue to advertise, e.g. "npx @claudinho/cli next MEX". */
     installLine?: string;
+    /**
+     * True when the live fetch failed and these are static fixtures (no live
+     * scores). A pasted card must say so — otherwise a "no matches" / scheduled
+     * card reads as authoritative when the feed is actually down. When set with
+     * matches present, a not-live notice is appended; for the empty case the
+     * caller picks a feed-down `emptyNote`.
+     */
+    degraded?: boolean;
     /** Timezone for kickoff date/time (date/time only — copy stays English). */
     tz?: string;
     /** Locale for kickoff date/time. */

package/dist/index.js

@@ -2839,9 +2839,15 @@ var EspnAdapter = class {
   async fetchWindow(startDate, endDate) {
     return this.fetchScoreboard(`${toEspnDate(startDate)}-${toEspnDate(endDate)}`);
   }
+  /**
+   * In-play matches from ESPN's DEFAULT scoreboard bucket only (no `dates`). This
+   * single bucket misses a late kickoff ESPN files under an adjacent day, so it
+   * is a fallback for window-less callers — the domain `getLiveMatches` wraps a
+   * ±1-day window around this to catch boundary-crossing matches. Prefer it.
+   */
   async fetchLive() {
     const today = await this.fetchScoreboard();
-    return today.filter((m) => m.status === "LIVE" || m.status === "HT");
+    return today.filter((m) => isLive(m.status));
   }
   /** Standings endpoint URL (lives under apis/v2, not site/v2; derived from base). */
   standingsUrl() {
@@ -2986,9 +2992,13 @@ async function getMatchById(adapter, id) {
     return { match: base, degraded: true };
   }
 }
-async function getLiveMatches(adapter) {
+async function getLiveMatches(adapter, now = /* @__PURE__ */ new Date()) {
   try {
-    return { matches: await adapter.fetchLive(), degraded: false, source: adapter.name };
+    const day = now.toISOString().slice(0, 10);
+    const matches = adapter.fetchWindow ? (await adapter.fetchWindow(shiftUtcDate(day, -1), shiftUtcDate(day, 1))).filter(
+      (m) => isLive(m.status)
+    ) : await adapter.fetchLive();
+    return { matches, degraded: false, source: adapter.name };
   } catch {
     return { matches: [], degraded: true };
   }
@@ -3508,6 +3518,9 @@ function formatShareSnippet(input, options = {}) {
       blocks.push(card.join("\n"));
     }
   }
+  if (input.degraded && input.matches.length > 0) {
+    blocks.push("(Live data unavailable \u2014 showing the bundled schedule, not live scores.)");
+  }
   blocks.push(
     shareFooter({
       source: input.source,

package/package.json

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