@ekmanss/5eplay 20260716.0.0 → 20260716.1.0

package/README.md

@@ -99,7 +99,7 @@ The human-readable report is deliberately more compact than the typed snapshot:
 - the overview keeps only match status/identity/version/format, capture time, and source URL;
 - completed and live maps show scores, clear half/round results, player tables, duels, highlights,
   milestones, and readable logs; upcoming maps use one short placeholder;
-- head-to-head and recent matches show only time, teams/opponent, score, and result;
+- head-to-head and recent matches show only time, canonical match link, teams/opponent, score, and result;
 - player power is reduced to Rating plus firepower, entry, opening, utility, sniping, clutch, and
   trading scores;
 - transport versions, coordinates, raw round codes, provider JSON, odds, logos, and community

package/dist/index.d.ts

@@ -7,4 +7,4 @@ export { createFiveEPlayMatchSession } from './session.js';
 export { fiveEPlayMarkdownOutputPath, writeFiveEPlayMatchMarkdown, } from './write_markdown.js';
 export type { FiveEPlayMarkdownOptions } from './markdown.js';
 export type { WriteFiveEPlayMatchMarkdownOptions, WriteFiveEPlayMatchMarkdownResult, } from './write_markdown.js';
-export type { CreateFiveEPlayMatchSessionOptions, FiveEPlayAnalysisMap, FiveEPlayAnalysisPlayer, FiveEPlayBombEvent, FiveEPlayClientOptions, FiveEPlayCommunityCard, FiveEPlayCommunityRatings, FiveEPlayCommunityScore, FiveEPlayDiagnosticWarning, FiveEPlayErrorCode, FiveEPlayHalfScore, FiveEPlayJson, FiveEPlayJsonObject, FiveEPlayLiveMatch, FiveEPlayLiveMatchMap, FiveEPlayLiveMatchesData, FiveEPlayLiveMatchesDiagnostics, FiveEPlayLiveMatchTeam, FiveEPlayKillEvent, FiveEPlayLogEvent, FiveEPlayLogPlayer, FiveEPlayMap, FiveEPlayMapStatus, FiveEPlayMatch, FiveEPlayMatchDiagnostics, FiveEPlayMatchIdentity, FiveEPlayMatchSession, FiveEPlayMatchStatus, FiveEPlayOperation, FiveEPlayPlayerDuel, FiveEPlayPlayerEquipment, FiveEPlayPlayerMetrics, FiveEPlayPlayerStats, FiveEPlayPrematchAnalysis, FiveEPlayProgressEvent, FiveEPlayRealtimeUpdate, FiveEPlayRequestDiagnostic, FiveEPlayRequestOptions, FiveEPlayRoundEnd, FiveEPlayRoundStart, FiveEPlaySide, FiveEPlayStage, FiveEPlayTeam, FiveEPlayTeamMapState, FiveEPlayTeamPlayerStats, FiveEPlayTournament, FiveEPlayVetoEntry, FiveEPlayWebSocketFactory, FiveEPlayWebSocketLike, GetFiveEPlayMatchOptions, GetFiveEPlayMatchResult, GetFiveEPlayLiveMatchesOptions, GetFiveEPlayLiveMatchesResult, } from './types.js';
+export type { CreateFiveEPlayMatchSessionOptions, FiveEPlayAnalysisMap, FiveEPlayAnalysisPlayer, FiveEPlayBombEvent, FiveEPlayClientOptions, FiveEPlayCommunityCard, FiveEPlayCommunityRatings, FiveEPlayCommunityScore, FiveEPlayDiagnosticWarning, FiveEPlayErrorCode, FiveEPlayHalfScore, FiveEPlayJson, FiveEPlayJsonObject, FiveEPlayLiveMatch, FiveEPlayLiveMatchMap, FiveEPlayLiveMatchesData, FiveEPlayLiveMatchesDiagnostics, FiveEPlayLiveMatchTeam, FiveEPlayKillEvent, FiveEPlayLogEvent, FiveEPlayLogPlayer, FiveEPlayMap, FiveEPlayMapStatus, FiveEPlayMatch, FiveEPlayMatchDiagnostics, FiveEPlayMatchIdentity, FiveEPlayMatchSession, FiveEPlayMatchStatus, FiveEPlayOperation, FiveEPlayPlayerDuel, FiveEPlayPlayerEquipment, FiveEPlayPlayerMetrics, FiveEPlayPlayerStats, FiveEPlayPrematchAnalysis, FiveEPlayProgressEvent, FiveEPlayRealtimeUpdate, FiveEPlayRecentMatchReference, FiveEPlayRecentMatchTeam, FiveEPlayRequestDiagnostic, FiveEPlayRequestOptions, FiveEPlayRoundEnd, FiveEPlayRoundStart, FiveEPlaySide, FiveEPlayStage, FiveEPlayTeam, FiveEPlayTeamMapState, FiveEPlayTeamPlayerStats, FiveEPlayTeamRecentMatches, FiveEPlayTournament, FiveEPlayVetoEntry, FiveEPlayWebSocketFactory, FiveEPlayWebSocketLike, GetFiveEPlayMatchOptions, GetFiveEPlayMatchResult, GetFiveEPlayLiveMatchesOptions, GetFiveEPlayLiveMatchesResult, } from './types.js';

package/dist/markdown.js

@@ -342,25 +342,24 @@ function recentMatchesSection(match) {
         return [];
     const lines = ['### 近期比赛', ''];
     for (const item of analysis.recentMatches) {
-        const rows = item.matches.flatMap((group) => records(record(group).matches)).map((game) => {
-            const home = record(game.home_info);
-            const opponent = record(game.opponent_info);
-            const teamIsHome = text(home.id) === item.teamId || text(opponent.id) !== item.teamId;
-            const teamScore = integer(game[teamIsHome ? 'home_score' : 'opponent_score']);
-            const opponentScore = integer(game[teamIsHome ? 'opponent_score' : 'home_score']);
-            const opponentName = text((teamIsHome ? opponent : home).disp_name);
-            const outcome = teamScore === null || opponentScore === null ? '—'
-                : teamScore > opponentScore ? '胜' : teamScore < opponentScore ? '负' : '平';
+        const rows = item.matches.map((game) => {
+            const team = game.teams.find((candidate) => candidate.id === item.teamId);
+            const opponent = game.teams.find((candidate) => candidate.id !== item.teamId);
+            const outcome = game.winnerTeamId === null ? '平'
+                : game.winnerTeamId === item.teamId ? '胜' : '负';
             return [
-                compactTimestamp(integer(game.ts)),
-                opponentName,
-                `${number(teamScore)} : ${number(opponentScore)}`,
+                compactTimestamp(game.playedAtUnixSeconds),
+                `[${game.id}](${game.url})`,
+                opponent?.name,
+                `${number(team?.score ?? null)} : ${number(opponent?.score ?? null)}`,
                 outcome,
             ];
         });
         lines.push(`#### ${plain(teamName(match, item.teamId))}`, '', rows.length
-            ? table(['比赛时间', '对手', '比分（本队 : 对手）', '结果'], rows)
-            : '_暂无近期比赛数据_', '');
+            ? table(['比赛时间', '比赛', '对手', '比分（本队 : 对手）', '结果'], rows)
+            : '_暂无近期比赛数据_', item.invalidReferenceCount > 0
+            ? `> 注意：源数据中另有 ${item.invalidReferenceCount} 条近期比赛引用不完整，未纳入报告。`
+            : '', '');
     }
     return lines;
 }

package/dist/transform.js

@@ -1,4 +1,5 @@
 import { mergeLogEvents, transformLogRecord } from './log.js';
+import { matchIdentityFromInput } from './input.js';
 import { flag, integer, jsonObjects, numeric, record, records, side, strings, text, } from './value.js';
 function cleanName(value) {
     return text(value) ?? '';
@@ -298,6 +299,52 @@ function analysisMap(value, teams) {
         }),
     };
 }
+function recentMatchRows(value) {
+    return records(record(value).matches).flatMap((group) => {
+        const nested = records(group.matches);
+        return nested.length ? nested : text(group.id) ? [group] : [];
+    });
+}
+function completedRecentMatch(value) {
+    const source = record(value);
+    const identity = matchIdentityFromInput(text(source.id) ?? '');
+    const status = text(source.status)?.toLowerCase();
+    const playedAtUnixSeconds = integer(source.ts);
+    const first = record(source.home_info);
+    const second = record(source.opponent_info);
+    const firstId = text(first.id);
+    const secondId = text(second.id);
+    const firstName = text(first.disp_name);
+    const secondName = text(second.disp_name);
+    const firstScore = integer(source.home_score);
+    const secondScore = integer(source.opponent_score);
+    const completed = status === 'past' || status === 'completed' || status === '2';
+    if (!identity || !completed || playedAtUnixSeconds === null || playedAtUnixSeconds <= 0
+        || !firstId || !secondId || !firstName || !secondName
+        || firstScore === null || secondScore === null || firstScore < 0 || secondScore < 0) {
+        return null;
+    }
+    return {
+        ...identity,
+        status: 'completed',
+        playedAtUnixSeconds,
+        teams: [
+            { id: firstId, name: firstName, score: firstScore },
+            { id: secondId, name: secondName, score: secondScore },
+        ],
+        winnerTeamId: firstScore === secondScore ? null : firstScore > secondScore ? firstId : secondId,
+    };
+}
+function recentMatches(value) {
+    const rows = recentMatchRows(value);
+    const normalized = rows.map(completedRecentMatch);
+    const byId = new Map(normalized.flatMap((match) => match ? [[match.id, match]] : []));
+    return {
+        sourceCount: rows.length,
+        invalidReferenceCount: normalized.filter((match) => match === null).length,
+        matches: [...byId.values()].sort((left, right) => right.playedAtUnixSeconds - left.playedAtUnixSeconds),
+    };
+}
 function prematchAnalysis(value, teams) {
     if (value === null)
         return null;
@@ -330,7 +377,7 @@ function prematchAnalysis(value, teams) {
         })),
         recentMatches: teams.map((team, index) => ({
             teamId: team.id,
-            matches: jsonObjects(record(result[index === 0 ? 't1_rec_matches' : 't2_rec_matches']).matches),
+            ...recentMatches(result[index === 0 ? 't1_rec_matches' : 't2_rec_matches']),
         })),
         headToHead: {
             teamWinRates: teams.map((team, index) => ({

package/dist/types.d.ts

@@ -293,6 +293,26 @@ export interface FiveEPlayAnalysisMap {
         banRate: number | null;
     }>;
 }
+export interface FiveEPlayRecentMatchTeam {
+    id: string;
+    name: string;
+    score: number;
+}
+export interface FiveEPlayRecentMatchReference {
+    id: string;
+    numericId: number;
+    url: string;
+    status: 'completed';
+    playedAtUnixSeconds: number;
+    teams: [FiveEPlayRecentMatchTeam, FiveEPlayRecentMatchTeam];
+    winnerTeamId: string | null;
+}
+export interface FiveEPlayTeamRecentMatches {
+    teamId: string;
+    sourceCount: number;
+    invalidReferenceCount: number;
+    matches: FiveEPlayRecentMatchReference[];
+}
 export interface FiveEPlayPrematchAnalysis {
     hidden: boolean;
     teams: Array<{
@@ -309,10 +329,7 @@ export interface FiveEPlayPrematchAnalysis {
         teamId: string;
         players: FiveEPlayJsonObject[];
     }>;
-    recentMatches: Array<{
-        teamId: string;
-        matches: FiveEPlayJsonObject[];
-    }>;
+    recentMatches: FiveEPlayTeamRecentMatches[];
     headToHead: {
         teamWinRates: Array<{
             teamId: string;

package/docs/data-contracts.md

@@ -44,6 +44,12 @@ weapon, special-kill flag, and coordinate fields. Unknown future event types rem
 records, recent matches, and head-to-head matches. Provider-specific power records remain JSON
 objects so new metrics are preserved without a schema bump.
 
+Each `analysis.recentMatches[]` group exposes typed, completed match references rather than raw
+provider JSON. Every reference contains its canonical `csgo_mc_*` ID/URL, numeric ID, completion
+status and timestamp, both teams and scores, and the winning team ID. `sourceCount` records how
+many source rows were present; `invalidReferenceCount` makes malformed or incomplete source rows
+explicit so consumers can fail closed instead of treating them as genuinely missing history.
+
 `communityRatings` contains every public tab and returned card, including player, coach, and
 big-event cards. Account-specific `my_*` voting state, write actions, and chat messages are not
 returned.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ekmanss/5eplay",
-  "version": "20260716.0.0",
+  "version": "20260716.1.0",
   "description": "Typed 5EPlay CS2 live-match discovery, match-detail snapshots, and MQTT updates without a browser.",
   "type": "module",
   "main": "./dist/index.js",