feat(embeds): detailed Steam store / news / app-widget embeds

Recognize store.steampowered.com content URLs and render each richly, within
the existing privacy-first facade. 2-agent reviewed (both SHIP).

- getSteamTarget / steamWidgetEmbedUrl (videoEmbed.ts, +tests): classify
  /app/{id}, /news/app/{id}/view/{gid}, /(bundle|sub|dlc)/{id}; non-content
  pages (home/search/wishlist) and other hosts fall through to the generic card.
- SteamCard now dispatches:
  - app → OG capsule header + click-to-play facade → Steam's OFFICIAL store
    widget iframe (store.steampowered.com/widget/{id}): live region-aware price,
    discount %, Buy on Steam. Nothing loads from Steam until "Show price &
    store" is pressed; gated by the inlineMediaEmbeds setting. App pages use the
    wide card so the ~646px widget has room.
  - news → rich announcement card (banner + headline + body preview + link) —
    your example URL previously fell through to the plain generic card.
  - bundle/sub/dlc → the OG store card.

Grounded in our CSP: the widget works via frame-src https: (no infra change),
images route through the homeserver (img-src excludes Steam), and there is NO
client-side Steam API call (connect-src + Steam CORS both block it) — which is
also the honest ceiling: no review scores/genres client-side, price/buy come
from the official widget.

Runtime QA still needed: the live widget iframe rendering (height/fit) can't be
verified headlessly.

Gates: tsc 0, eslint 0, prettier clean, 912 tests, build ok.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
This commit is contained in:
2026-07-21 21:41:06 -04:00
co-authored by Claude Opus 4.8
parent 8e02cef658
commit ef82650cf7
4 changed files with 293 additions and 15 deletions
+32
View File
@@ -24,6 +24,8 @@ import {
getBlueskyEmbed,
getLoomId,
getKickChannel,
getSteamTarget,
steamWidgetEmbedUrl,
buildVideoEmbedUrl,
spotifyEmbedHeight,
parseMediaEmbed,
@@ -208,6 +210,36 @@ test('Apple Music: album vs single song height, embed host swap', () => {
assert.equal(getAppleMusicEmbed('https://example.com/album/x/1'), null);
});
test('getSteamTarget: app / news / bundle / non-content', () => {
assert.deepEqual(getSteamTarget('https://store.steampowered.com/app/739630/Phasmophobia/'), {
kind: 'app',
appId: '739630',
});
assert.deepEqual(
getSteamTarget(
'https://store.steampowered.com/news/app/739630/view/668371152183232404?l=english',
),
{ kind: 'news', appId: '739630', gid: '668371152183232404' },
);
assert.deepEqual(getSteamTarget('https://store.steampowered.com/bundle/232/'), {
kind: 'store',
label: 'bundle',
});
assert.deepEqual(getSteamTarget('https://store.steampowered.com/sub/12345/'), {
kind: 'store',
label: 'sub',
});
// non-content store pages and other hosts are not embedded
assert.equal(getSteamTarget('https://store.steampowered.com/'), null);
assert.equal(getSteamTarget('https://store.steampowered.com/search/?term=horror'), null);
assert.equal(getSteamTarget('https://steamcommunity.com/app/739630'), null);
assert.equal(getSteamTarget('not a url'), null);
});
test('steamWidgetEmbedUrl', () => {
assert.equal(steamWidgetEmbedUrl('739630'), 'https://store.steampowered.com/widget/739630/');
});
test('getTweetId', () => {
assert.equal(getTweetId('https://x.com/user/status/1799999999999999999'), '1799999999999999999');
assert.equal(getTweetId('https://twitter.com/user/status/12345'), '12345');