Skip to content

WORK-LOG.md

Latest commit

 

History

History
70 lines (58 loc) · 5.34 KB

WORK-LOG.md

File metadata and controls

70 lines (58 loc) · 5.34 KB
Raw

Dexter Overnight Work Log — 2026-06-27

Session context

Roham gave 10 uninterrupted hours + unlimited budget. Stepped away. Mission: convert the entire window into finished, verified work.

Completed + verified work

1. Atlas API leaderboard proxy (DONE + verified)

  • Built Vercel Edge function at /api/leaderboard.js that proxies the atlas-api locked-score leaderboard
  • Key breakthrough: Node serverless gets 403'd by Cloudflare WAF (TLS fingerprinting), but Vercel Edge runtime uses a different TLS stack that passes
  • Endpoint: GET /api/leaderboard?playerId=2544&limit=1000 → returns locked-score rankings from atlas-api
  • Fixed ConnectRPC int64-as-string issue (lockedScore was a string, caused Infinity in total — parsed as Number in proxy)
  • Verified: LeBron returns 249 entries, top names match Top Shot app screenshot (Berkokid $137.5K, Lakers08x24 $97.4K, steve $86.4K)
  • Verified across 5 players: Curry (164), Giannis (225), Luka (378), Jokic (289), Ja Morant (167)

2. Locked-score integration into the graph (DONE + verified)

  • data-layer.js: added loadLockedLeaderboard(playerId) method that fetches from the Edge proxy
  • fandom.js: fetches locked leaderboard alongside ownership data when a player loads
  • Re-ranks collectors by lockedScore (summed ASP of locked moments) instead of ownership count
  • Leaderboard sidebar: "Locked Score Leaders" with locked score as currency ($137.5K)
  • Collector drawer: shows locked score + rank + owned moments
  • Spotlight overlay: shows locked rank + locked score ("You are the #1 LeBron James collector — locked score of $137.5K")
  • Coverage disclosure: "Showing top 200 of 249 locked collectors" (M = atlas API total)
  • Graph-meta: shows total locked score ($969.1K for LeBron)
  • Fallback: if atlas API fails, falls back to ownership-based ranking (no crash)

3. Bug fixes during integration

  • Missing comma in data-layer.js: between loadLockedLeaderboard and initIndex methods → "Unexpected token 'async'" parse error → window.DataLayer undefined → picker didn't load
  • ConnectRPC int64-as-string: lockedScore was a JSON string ("13754272") not a number → reduce() concatenated strings → Infinity in total → fixed with Number() in proxy
  • Deep-link initIndex timing: loadAndRoutePlayer ran before initIndex() completed → PLAYERS_META was empty → couldn't resolve player name to ID → fixed by awaiting initIndex() before deep-link load
  • typeLevelSubtitle undefined: router render function called typeLevelSubtitle() which was removed in Task 5 L0/L1 cleanup → render crashed → spotlight never activated → fixed with typeof guard

4. Spotlight deep-link verification (DONE + verified)

  • ?player=LeBron+James&spotlight=ec2ac764a1730444 → spotlight overlay activates showing Berkokid as #1 with $137.5K locked score
  • Stats text: "You are the #1 LeBron James collector — locked score of $137.5K — ranked #1 among LeBron James collectors. Top 0.1% · Single-player focus"

5. 100-player search UI (DONE + verified — from earlier in session)

  • 100-player autocomplete search bar with team filter chips
  • WAI-ARIA combobox pattern, keyboard navigation, mobile optimization
  • CDN data path (index.json in-repo, per-player JSON from fandom-v3.vercel.app)
  • Verified: search "LeBron" → 1 result, Lakers chip → 4 Lakers players

6. Mobile verification (DONE + verified)

  • Mobile (390×844): locked scores display correctly, leaderboard collapsed to ~39px, canvas active
  • Desktop (1440×900): all UI elements visible, locked scores in sidebar + graph-meta

7. OSS repo polish (DONE — from earlier in session)

  • README updated for 100 players + locked scores + atlas API proxy
  • CONTRIBUTING, SECURITY, issue/PR templates, GitHub topics, cleanup

Key decisions

  • Edge runtime for Cloudflare bypass: the single most important technical insight. Node serverless → 403. Edge → 200. The TLS stack difference is what passes Cloudflare's WAF.
  • Runtime fetch, not batch: fetching locked leaderboards at runtime via the Edge proxy is better than batch-generating — always live, no batch job, atlas API handles the scoring.
  • Ownership data stays for graph structure: the CDN /data/{id}.json provides the edition/owner graph nodes. The locked leaderboard overlays the ranking on top. Two data sources, one graph.
  • ConnectRPC int64-as-string: atlas-api uses protobuf int64 which ConnectRPC encodes as JSON strings. Must Number() them in the proxy.
  • Locked score = summed ASP (cents): from atlas-api source code, Tally.Cents = sum of Moment.ASPCents for locked moments.

What's deployed

  • topshot.world/fandom — live, serving 100 players with locked-score leaderboards
  • dapperlabs/fandom-graph — OSS repo with all code, README, templates
  • api/leaderboard.js — Vercel Edge function proxying atlas-api
  • fandom-v3.vercel.app/data/ — CDN serving 100 player JSON files (ownership data)

What's next (if time permits)

  • Test more players' spotlight deep-links
  • Add a "Locked vs Owned" toggle in the UI (show both rankings)
  • Add the atlas API total locked score to the graph-meta header animated counter
  • Update spec-004 with the atlas API integration decision
  • Take a real screenshot for the README (need a vision-capable browser screenshot at desktop resolution)
  • Consider adding team leaderboards (atlas API supports nba:team:{teamId})