import { VECTOR_METRICS } from '@persona-lenz/shared'; import type { ExtractedPlayerMatchFeature } from './analysis.types'; import { TimelineMetricService } from './timeline-metric.service'; function createBaseFeature(): ExtractedPlayerMatchFeature { return { matchId: 'KR_1', puuid: 'target-puuid', queueId: 420, role: 'MIDDLE', championId: 103, gameCreation: 1_700_000_000_000, gameDurationSec: 1_800, win: true, patch: '26.13', features: { kda: 3, }, normalized: { kda: 0.5, }, vector: [], featureSchemaVersion: 2, normalizationMethod: 'registry-baseline', confidence: 1, timelineProcessed: false, laneOpponent: { puuid: 'enemy-mid-puuid', championId: 134, }, }; } function createRawMatch() { return { metadata: { matchId: 'KR_1', }, info: { participants: [ { participantId: 1, puuid: 'target-puuid', teamId: 100, teamPosition: 'MIDDLE', }, { participantId: 2, puuid: 'ally-jungle-puuid', teamId: 100, teamPosition: 'JUNGLE', }, { participantId: 3, puuid: 'ally-top-puuid', teamId: 100, teamPosition: 'TOP', }, { participantId: 6, puuid: 'enemy-mid-puuid', teamId: 200, teamPosition: 'MIDDLE', }, { participantId: 7, puuid: 'enemy-jungle-puuid', teamId: 200, teamPosition: 'JUNGLE', }, ], }, }; } function participantFrame(overrides: Record) { return { jungleMinionsKilled: 0, minionsKilled: 0, position: { x: 0, y: 0 }, timeEnemySpentControlled: 0, totalGold: 0, xp: 0, ...overrides, }; } function createTimeline() { return { info: { frames: [ { timestamp: 8 * 60_000, events: [], participantFrames: { '1': participantFrame({ position: { x: 4_000, y: 4_000 } }), '2': participantFrame({ position: { x: 5_000, y: 4_000 } }), '3': participantFrame({ position: { x: 10_000, y: 4_000 } }), }, }, { timestamp: 10 * 60_000, events: [ { type: 'CHAMPION_KILL', timestamp: 100_000, killerId: 1, victimId: 6, assistingParticipantIds: [2], }, { type: 'CHAMPION_KILL', timestamp: 200_000, killerId: 2, victimId: 7, assistingParticipantIds: [1], }, { type: 'CHAMPION_KILL', timestamp: 300_000, killerId: 2, victimId: 7, assistingParticipantIds: null, victimDamageReceived: [{ participantId: 1 }], }, { type: 'CHAMPION_KILL', timestamp: 400_000, killerId: 6, victimId: 1, assistingParticipantIds: [], }, { type: 'WARD_PLACED', timestamp: 500_000, creatorId: 1, }, ], participantFrames: { '1': participantFrame({ jungleMinionsKilled: 5, minionsKilled: 75, position: { x: 4_000, y: 4_000 }, timeEnemySpentControlled: 10_000, totalGold: 4_000, xp: 5_000, }), '2': participantFrame({ position: { x: 4_800, y: 4_000 } }), '3': participantFrame({ position: { x: 9_000, y: 4_000 } }), '6': participantFrame({ jungleMinionsKilled: 0, minionsKilled: 70, totalGold: 3_500, xp: 4_500, }), }, }, { timestamp: 14 * 60_000, events: [ { type: 'WARD_PLACED', timestamp: 830_000, creatorId: 1, }, ], participantFrames: { '1': participantFrame({ position: { x: 4_000, y: 4_000 }, timeEnemySpentControlled: 30_000, totalGold: 6_000, }), '2': participantFrame({ position: { x: 5_500, y: 4_000 } }), '3': participantFrame({ position: { x: 11_000, y: 4_000 } }), '6': participantFrame({ totalGold: 6_200, }), }, }, { timestamp: 15 * 60_000, events: [ { type: 'WARD_PLACED', timestamp: 850_000, creatorId: 1, }, { type: 'ELITE_MONSTER_KILL', timestamp: 900_000, killerId: 2, killerTeamId: 100, monsterType: 'DRAGON', assistingParticipantIds: [1], }, ], participantFrames: {}, }, { timestamp: 20 * 60_000, events: [], participantFrames: { '1': participantFrame({ position: { x: 4_000, y: 4_000 }, timeEnemySpentControlled: 60_000, }), '2': participantFrame({ position: { x: 7_000, y: 4_000 } }), '3': participantFrame({ position: { x: 12_000, y: 4_000 } }), }, }, { timestamp: 30 * 60_000, events: [], participantFrames: { '1': participantFrame({ timeEnemySpentControlled: 90_000, }), }, }, ], }, }; } function createInsightTimeline() { return { info: { frames: [ { timestamp: 10 * 60_000, events: [ { actualStartTime: 640_000, type: 'OBJECTIVE_BOUNTY_PRESTART', timestamp: 590_000, teamId: 100, }, ], participantFrames: { '1': participantFrame({ minionsKilled: 80, position: { x: 7_500, y: 7_500 }, totalGold: 4_000, xp: 5_000, }), '6': participantFrame({ minionsKilled: 72, totalGold: 3_400, xp: 4_700, }), }, }, { timestamp: 11 * 60_000, events: [ { type: 'CHAMPION_KILL', timestamp: 650_000, killerId: 1, victimId: 6, shutdownBounty: 450, assistingParticipantIds: [], }, ], participantFrames: { '1': participantFrame({ position: { x: 7_800, y: 9_000 } }), }, }, { timestamp: 12 * 60_000, events: [ { type: 'TURRET_PLATE_DESTROYED', timestamp: 700_000, teamId: 200, laneType: 'MID_LANE', }, { type: 'OBJECTIVE_BOUNTY_FINISH', timestamp: 700_000, teamId: 100, }, ], participantFrames: { '1': participantFrame({ position: { x: 7_800, y: 7_800 } }), }, }, { timestamp: 800_000, events: [ { type: 'CHAMPION_KILL', timestamp: 800_000, killerId: 1, victimId: 7, assistingParticipantIds: [], }, ], participantFrames: { '1': participantFrame({ position: { x: 9_866, y: 4_414 } }), }, }, { timestamp: 14 * 60_000, events: [], participantFrames: { '1': participantFrame({ position: { x: 9_866, y: 4_414 }, totalGold: 5_800, }), '2': participantFrame({ position: { x: 8_800, y: 4_600 } }), '3': participantFrame({ position: { x: 1_000, y: 13_000 } }), '6': participantFrame({ totalGold: 5_500 }), }, }, { timestamp: 15 * 60_000, events: [ { type: 'ELITE_MONSTER_KILL', timestamp: 900_000, killerId: 2, killerTeamId: 100, monsterType: 'DRAGON', assistingParticipantIds: [1], position: { x: 9_866, y: 4_414 }, }, ], participantFrames: { '1': participantFrame({ position: { x: 9_866, y: 4_414 } }), }, }, { timestamp: 20 * 60_000, events: [ { type: 'CHAMPION_KILL', timestamp: 1_030_000, killerId: 6, victimId: 1, assistingParticipantIds: [], }, { type: 'CHAMPION_KILL', timestamp: 1_215_000, killerId: 2, victimId: 7, assistingParticipantIds: [], }, ], participantFrames: { '1': participantFrame({ position: { x: 7_500, y: 7_500 }, totalGold: 8_000, }), '6': participantFrame({ totalGold: 7_700 }), }, }, ], }, }; } function createDeficitRecoveryTimeline() { return { info: { frames: [ { timestamp: 10 * 60_000, events: [], participantFrames: { '1': participantFrame({ minionsKilled: 65, totalGold: 3_200, xp: 4_200, }), '6': participantFrame({ minionsKilled: 75, totalGold: 3_900, xp: 4_600, }), }, }, { timestamp: 20 * 60_000, events: [], participantFrames: { '1': participantFrame({ totalGold: 7_500 }), '6': participantFrame({ totalGold: 7_300 }), }, }, ], }, }; } describe('TimelineMetricService', () => { const service = new TimelineMetricService(); it('extracts timeline vector metrics and ratio counts', () => { const feature = createBaseFeature(); const result = service.extractTimelineMetrics( feature, createRawMatch(), createTimeline(), { advantageEvents: [], deathEvents: [ { t: 400_000, victimParticipantId: 1, x: 4_000, y: 4_000, zone: 'middleLane', shutdownBountyGiven: 300, nearestAllyDistanceApprox: 1_500, }, { t: 1_000_000, victimParticipantId: 1, x: 4_000, y: 4_000, zone: 'middleLane', shutdownBountyGiven: 0, nearestAllyDistanceApprox: 1_500, }, ], fightClusters: [ { startTimeMs: 100_000, endTimeMs: 130_000, killCount: 3, participantIds: [1, 2, 6, 7], openerParticipantIds: [1], cleanupParticipantIds: [2], isTeamfight: true, }, { startTimeMs: 600_000, endTimeMs: 640_000, killCount: 3, participantIds: [1, 2, 6, 7], openerParticipantIds: [2], cleanupParticipantIds: [1], isTeamfight: true, }, ], objectiveWindows: [ { objectiveTimeMs: 900_000, startTimeMs: 780_000, endTimeMs: 930_000, killerParticipantId: 2, killerTeamId: 100, monsterType: 'DRAGON', }, ], roamFrames: [], }, ); expect(result.features).toMatchObject({ goldDiffAt10: 500, goldDiffAt14: -200, csDiffAt10: 10, xpDiffAt10: 500, deathsBefore14: 1, killParticipationBefore14: 1, earlyWardsPerMin: 2 / 14, objectivePreWardRateNumerator: 1, objectivePreWardRateDenominator: 1, eliteObjectiveParticipationRateNumerator: 1, eliteObjectiveParticipationRateDenominator: 1, teamfightFirstEngagementParticipationRateNumerator: 1, teamfightFirstEngagementParticipationRateDenominator: 2, teamfightCleanupKillParticipationRateNumerator: 1, teamfightCleanupKillParticipationRateDenominator: 2, deathWithShutdownBountyGivenRateNumerator: 1, deathWithShutdownBountyGivenRateDenominator: 2, ccTimePerMinute: 3, }); expect(result.features.isolationTendency).toBeCloseTo( (1_000 + 800 + 1_500 + 3_000) / 4, ); expect(result.normalized.objectivePreWardRate).toBe(1); expect(result.normalized.eliteObjectiveParticipationRate).toBe(1); expect(result.normalized.teamfightFirstEngagementParticipationRate).toBe( 0.5, ); expect(result.vector).toHaveLength(VECTOR_METRICS.length); expect( result.vector[ VECTOR_METRICS.findIndex((metric) => metric.id === 'goldDiffAt10') ], ).toBeCloseTo(result.normalized.goldDiffAt10); expect( result.vector[ VECTOR_METRICS.findIndex( (metric) => metric.id === 'objectivePreWardRate', ) ], ).toBe(1); expect( result.vector[ VECTOR_METRICS.findIndex( (metric) => metric.id === 'deathWithShutdownBountyGivenRate', ) ], ).toBe(0.5); expect(result.vector[VECTOR_METRICS.length - 1]).toBe( result.normalized.ccTimePerMinute, ); }); it('extracts timeline insight metrics outside the vector', () => { const feature = createBaseFeature(); const result = service.extractTimelineMetrics( feature, createRawMatch(), createInsightTimeline(), { advantageEvents: [ { timestampMs: 600_000, teamId: 100, type: 'championKill', score: 1, participantIds: [1], }, { timestampMs: 650_000, teamId: 100, type: 'championKill', score: 1, participantIds: [1], }, { timestampMs: 1_030_000, teamId: 200, type: 'championKill', score: 1, participantIds: [6], }, { timestampMs: 1_215_000, teamId: 100, type: 'championKill', score: 1, participantIds: [2], }, ], deathEvents: [ { t: 1_000_000, victimParticipantId: 1, x: 7_500, y: 7_500, zone: 'middleLane', shutdownBountyGiven: 0, nearestAllyDistanceApprox: 5_000, }, { t: 1_200_000, victimParticipantId: 1, x: 7_500, y: 7_500, zone: 'middleLane', shutdownBountyGiven: 0, nearestAllyDistanceApprox: 1_000, }, ], fightClusters: [ { startTimeMs: 850_000, endTimeMs: 870_000, killCount: 2, participantIds: [1, 2, 6, 7], openerParticipantIds: [1], cleanupParticipantIds: [2], isTeamfight: false, }, ], objectiveWindows: [ { objectiveTimeMs: 900_000, startTimeMs: 780_000, endTimeMs: 930_000, killerParticipantId: 2, killerTeamId: 100, monsterType: 'DRAGON', position: { x: 9_866, y: 4_414 }, }, ], roamFrames: [ { t: 600_000, participantId: 1, teamId: 100, x: 7_500, y: 7_500, zone: 'river', assignedLaneZone: 'middleLane', }, { t: 660_000, participantId: 1, teamId: 100, x: 8_000, y: 7_000, zone: 'river', assignedLaneZone: 'middleLane', }, ], }, ); expect(result.features).toMatchObject({ objectiveFightOpeningParticipationRateNumerator: 1, objectiveFightOpeningParticipationRateDenominator: 1, objectiveFightOpeningConvertedToObjectiveRateNumerator: 1, objectiveFightOpeningConvertedToObjectiveRateDenominator: 1, preObjectivePitPresenceRateNumerator: 1, preObjectivePitPresenceRateDenominator: 1, preObjectivePickParticipationRateNumerator: 1, preObjectivePickParticipationRateDenominator: 1, deathFollowedByTeamLossRateNumerator: 1, deathFollowedByTeamLossRateDenominator: 2, deathTradedForTeamAdvantageRateNumerator: 1, deathTradedForTeamAdvantageRateDenominator: 2, deathWhileIsolatedFromNearestAllyRateNumerator: 1, deathWhileIsolatedFromNearestAllyRateDenominator: 2, laneLeadConversionRateNumerator: 1, laneLeadConversionRateDenominator: 1, roamConvertedToTeamAdvantageRateNumerator: 1, roamConvertedToTeamAdvantageRateDenominator: 1, shutdownGoldCollectedPerGame: 450, platePresenceParticipationRateNumerator: 1, platePresenceParticipationRateDenominator: 1, objectiveBountyComebackParticipationRateNumerator: 1, objectiveBountyComebackParticipationRateDenominator: 1, }); expect(result.normalized.objectiveFightOpeningParticipationRate).toBe(1); expect(result.normalized.deathFollowedByTeamLossRate).toBe(0.5); expect(result.normalized.deathTradedForTeamAdvantageRate).toBe(0.5); expect(result.normalized.deathWhileIsolatedFromNearestAllyRate).toBe(0.5); expect(result.vector).toHaveLength(VECTOR_METRICS.length); expect( VECTOR_METRICS.some( (metric) => metric.id === 'shutdownGoldCollectedPerGame', ), ).toBe(false); }); it('extracts early deficit recovery as a sparse ratio metric', () => { const feature = createBaseFeature(); const result = service.extractTimelineMetrics( feature, createRawMatch(), createDeficitRecoveryTimeline(), { advantageEvents: [], deathEvents: [], fightClusters: [], objectiveWindows: [], roamFrames: [], }, ); expect(result.features).toMatchObject({ goldDiffAt10: -700, earlyDeficitRecoveryRateNumerator: 1, earlyDeficitRecoveryRateDenominator: 1, laneLeadConversionRateNumerator: 0, laneLeadConversionRateDenominator: 0, }); expect(result.normalized.earlyDeficitRecoveryRate).toBe(1); }); it('does not count the death kill event as a follow-up team loss', () => { const feature = createBaseFeature(); const result = service.extractTimelineMetrics( feature, createRawMatch(), createTimeline(), { advantageEvents: [ { timestampMs: 400_000, teamId: 200, type: 'championKill', score: 1, participantIds: [6], }, ], deathEvents: [ { t: 400_000, victimParticipantId: 1, x: 4_000, y: 4_000, zone: 'middleLane', shutdownBountyGiven: 0, nearestAllyDistanceApprox: 1_500, }, ], fightClusters: [], objectiveWindows: [], roamFrames: [], }, ); expect(result.features).toMatchObject({ deathFollowedByTeamLossRateNumerator: 0, deathFollowedByTeamLossRateDenominator: 1, }); expect(result.normalized.deathFollowedByTeamLossRate).toBe(0); }); });