vyndr/tests/unit/headshotThread.test.js

// Wave 2A (WIRING & DATA TRAIN, Step 2) — the headshot id thread.
//
// Doctrine: a REAL athlete photo where an id resolves; a team-colored monogram
// (NEVER a gray silhouette, NEVER a broken image) where it can't. The id is
// NEVER fabricated — it rides free on the snapshot's per-player stats resolve.
//
// This suite locks the four links of the chain:
//   (a) getHeadshotUrl builds the right per-league CDN URL from a known id
//   (b) an MLB grade with a resolved MLBAM id → playerId on the strip
//   (c) an NBA/WNBA grade with a resolved ESPN id → espnId on the strip
//   (d) a grade with NO id → strip carries no id → PlayerAvatar falls to a
//       monogram (the null path). Absent beats fabricated.

// The PURE URL core is CommonJS (the .ts re-exports it verbatim); jest can't
// transform the .ts, so we require the same single source of truth here.
const { getHeadshotUrl } = require('../../web/src/lib/playerHeadshotUrl');
const adapter = require('../../web/src/lib/slateAdapter');

describe('(a) getHeadshotUrl — per-league CDN URL from a real id', () => {
  it('MLB → img.mlbstatic.com via the MLBAM people id', () => {
    // Aaron Judge = MLBAM 592450.
    const url = getHeadshotUrl({ sport: 'mlb', playerId: 592450 });
    expect(url).toBe(
      'https://img.mlbstatic.com/mlb-photos/image/upload/d_people:generic:headshot:67:current.png/w_213,q_auto:best/v1/people/592450/headshot/67/current',
    );
  });

  it('NBA → a.espncdn headshot from the ESPN athlete id (espnId, no playerId)', () => {
    const url = getHeadshotUrl({ sport: 'nba', espnId: 3945274 });
    expect(url).toBe(
      'https://a.espncdn.com/combiner/i?img=/i/headshots/nba/players/full/3945274.png&w=130&h=95',
    );
  });

  it('WNBA → a.espncdn headshot from the ESPN athlete id', () => {
    const url = getHeadshotUrl({ sport: 'wnba', espnId: 4066533 });
    expect(url).toBe(
      'https://a.espncdn.com/combiner/i?img=/i/headshots/wnba/players/full/4066533.png&w=130&h=95',
    );
  });

  it('dormant NFL/NHL leagues now resolve an ESPN headshot path (cheap correctness)', () => {
    expect(getHeadshotUrl({ sport: 'nfl', espnId: 3139477 })).toContain('/headshots/nfl/players/full/3139477.png');
    expect(getHeadshotUrl({ sport: 'nhl', espnId: 3024816 })).toContain('/headshots/nhl/players/full/3024816.png');
  });

  it('no id at all → the neutral silhouette sentinel (component swaps to monogram)', () => {
    expect(getHeadshotUrl({ sport: 'mlb' })).toBe('/images/player-silhouette.svg');
    expect(getHeadshotUrl({ sport: 'soccer', playerId: 123 })).toBe('/images/player-silhouette.svg');
  });
});

describe('(b) MLB grade → playerId threads onto the strip', () => {
  it('carries the MLBAM playerId from the enriched grade to the strip prop group', () => {
    const props = [{ player: 'Aaron Judge', stat_type: 'hits', line: 1.5, home_team: 'NYY', away_team: 'BOS' }];
    const gradeIndex = adapter.indexGrades([
      {
        player: 'Aaron Judge', stat_type: 'hits', line: 1.5, direction: 'over', grade: 'A',
        playerId: 592450, team: 'NYY',
        gradedAt: { line: 1.5, timestamp: '2026-07-10T02:00:00Z' },
      },
    ]);
    const strips = adapter.buildPlayerStripsFromProps(props, gradeIndex, {});
    expect(strips).toHaveLength(1);
    expect(strips[0].playerId).toBe(592450);
    expect(strips[0].espnId).toBeUndefined();
    // And the id builds the real MLB headshot.
    expect(getHeadshotUrl({ sport: 'mlb', playerId: strips[0].playerId })).toContain('/people/592450/headshot');
  });
});

describe('(c) NBA/WNBA grade → espnId threads onto the strip', () => {
  it('carries the ESPN espnId from the enriched grade to the strip prop group', () => {
    const props = [{ player: 'Caitlin Clark', stat_type: 'points', line: 22.5, home_team: 'IND', away_team: 'CHI' }];
    const gradeIndex = adapter.indexGrades([
      {
        player: 'Caitlin Clark', stat_type: 'points', line: 22.5, direction: 'over', grade: 'B+',
        espnId: 4433403, team: 'IND',
        gradedAt: { line: 22.5, timestamp: '2026-07-10T02:00:00Z' },
      },
    ]);
    const strips = adapter.buildPlayerStripsFromProps(props, gradeIndex, {});
    expect(strips).toHaveLength(1);
    expect(strips[0].espnId).toBe(4433403);
    expect(strips[0].playerId).toBeUndefined();
    expect(getHeadshotUrl({ sport: 'wnba', espnId: strips[0].espnId })).toContain('/players/full/4433403.png');
  });
});

describe('(d) no resolved id → monogram path (never a fabricated face)', () => {
  it('a grade with no id → strip has neither playerId nor espnId', () => {
    const props = [{ player: 'Unknown Prospect', stat_type: 'hits', line: 0.5, home_team: 'NYY', away_team: 'BOS' }];
    const gradeIndex = adapter.indexGrades([
      {
        player: 'Unknown Prospect', stat_type: 'hits', line: 0.5, direction: 'over', grade: 'C',
        team: 'NYY',
        gradedAt: { line: 0.5, timestamp: '2026-07-10T02:00:00Z' },
      },
    ]);
    const strips = adapter.buildPlayerStripsFromProps(props, gradeIndex, {});
    expect(strips[0].playerId).toBeUndefined();
    expect(strips[0].espnId).toBeUndefined();
    // PlayerAvatar renders `url = (playerId!=null || espnId!=null) ? … : null`,
    // so an absent id yields a null url → the branded monogram. Prove the
    // resolver returns the silhouette sentinel (which the component swaps out)
    // rather than a fabricated CDN URL when no id is present.
    expect(getHeadshotUrl({ sport: 'mlb', playerId: strips[0].playerId, espnId: strips[0].espnId }))
      .toBe('/images/player-silhouette.svg');
  });
});