wehub-resource-sync
9b395f5cc3
E2E Headed Chrome / e2e-headed (macos-15) (push) Has been cancelled
E2E Headed Chrome / e2e-headed (ubuntu-latest) (push) Has been cancelled
E2E Headed Chrome / e2e-headed (windows-latest) (push) Has been cancelled
CI / build (macos-latest) (push) Has been cancelled
CI / build (ubuntu-latest) (push) Has been cancelled
CI / build (windows-latest) (push) Has been cancelled
CI / unit-test (push) Has been cancelled
CI / bun-test (push) Has been cancelled
CI / adapter-test (push) Has been cancelled
CI / smoke-test (macos-latest) (push) Has been cancelled
CI / smoke-test (ubuntu-latest) (push) Has been cancelled
Security Audit / audit (push) Has been cancelled
Build Chrome Extension / build (push) Has been cancelled
Trigger Website Rebuild (Docs Updated) / dispatch (push) Has been cancelled
68 lines
3.2 KiB
JavaScript
68 lines
3.2 KiB
JavaScript
// steam app — fetch a single Steam game / DLC / app's storefront detail.
|
|
//
|
|
// Hits the public appdetails API (`/api/appdetails?appids=<id>`). Surfaces
|
|
// the columns most useful for an agent: name, type, free flag, release
|
|
// date, developers / publishers, price, metacritic, recommendations,
|
|
// genres / categories joined.
|
|
import { cli, Strategy } from '@jackwener/opencli/registry';
|
|
import { EmptyResultError } from '@jackwener/opencli/errors';
|
|
import { STEAM_STORE, decodeHtmlEntities, priceCents, requireAppId, requireCountryCode, steamFetch } from './utils.js';
|
|
|
|
function joinNames(list) {
|
|
if (!Array.isArray(list)) return '';
|
|
return list
|
|
.map((entry) => (entry && typeof entry === 'object' ? entry.description ?? entry.name ?? '' : String(entry)))
|
|
.filter(Boolean)
|
|
.join(', ');
|
|
}
|
|
|
|
cli({
|
|
site: 'steam',
|
|
name: 'app',
|
|
access: 'read',
|
|
description: 'Steam storefront detail for a single app id',
|
|
domain: 'store.steampowered.com',
|
|
strategy: Strategy.PUBLIC,
|
|
browser: false,
|
|
args: [
|
|
{ name: 'id', positional: true, required: true, help: 'Numeric Steam app id (e.g. "620" for Portal 2)' },
|
|
{ name: 'currency', default: 'us', help: 'Storefront country code (e.g. us / cn / jp / de)' },
|
|
],
|
|
columns: [
|
|
'id', 'name', 'type', 'isFree', 'releaseDate', 'developers', 'publishers',
|
|
'price', 'currency', 'metacritic', 'recommendations', 'genres', 'categories',
|
|
'shortDescription', 'website', 'url',
|
|
],
|
|
func: async (args) => {
|
|
const appId = requireAppId(args.id);
|
|
const cc = requireCountryCode(args.currency);
|
|
const url = `${STEAM_STORE}/api/appdetails?appids=${appId}&l=en&cc=${encodeURIComponent(cc)}`;
|
|
const body = await steamFetch(url, `steam app ${appId}`);
|
|
const wrapper = body?.[appId];
|
|
if (!wrapper || wrapper.success !== true || !wrapper.data) {
|
|
throw new EmptyResultError('steam app', `Steam app id ${appId} returned no data (may be region-locked or removed).`);
|
|
}
|
|
const data = wrapper.data;
|
|
const isFree = data.is_free === true;
|
|
const priceFinal = priceCents(data?.price_overview?.final ?? null);
|
|
return [{
|
|
id: String(data.steam_appid ?? appId),
|
|
name: decodeHtmlEntities(data.name ?? ''),
|
|
type: String(data.type ?? ''),
|
|
isFree,
|
|
releaseDate: String(data?.release_date?.date ?? ''),
|
|
developers: Array.isArray(data.developers) ? data.developers.join(', ') : '',
|
|
publishers: Array.isArray(data.publishers) ? data.publishers.join(', ') : '',
|
|
price: isFree ? 0 : priceFinal,
|
|
currency: String(data?.price_overview?.currency ?? '').toUpperCase(),
|
|
metacritic: data?.metacritic?.score != null ? Number(data.metacritic.score) : null,
|
|
recommendations: data?.recommendations?.total != null ? Number(data.recommendations.total) : null,
|
|
genres: joinNames(data.genres),
|
|
categories: joinNames(data.categories),
|
|
shortDescription: decodeHtmlEntities(data.short_description ?? ''),
|
|
website: String(data.website ?? ''),
|
|
url: `${STEAM_STORE}/app/${data.steam_appid ?? appId}/`,
|
|
}];
|
|
},
|
|
});
|