105 lines
7.2 KiB
TypeScript
105 lines
7.2 KiB
TypeScript
// Play Games Services leaderboards and achievements from the `games` config section (cli/lib/game-services.ts),
|
|
// through the Google Play Games Services Configuration API (games/v1configuration: achievementConfigurations,
|
|
// leaderboardConfigurations; list / insert / update; the Play service account, scope androidpublisher).
|
|
// storebound play games [status] [--dry] [--yes] [--json]
|
|
// The games project itself, its Android credential (app-signing SHA-1), the web OAuth client and publishing the
|
|
// configuration have no API: `storebound console plan play-games-services` (agent-first) and `console verify`.
|
|
// Matching: games.*[].playId, else the name in the default Play language (Play generates the ids). An insert is never
|
|
// sent twice (no 5xx retry on POST; an unclear answer reads the list again); update is a PUT of the whole
|
|
// configuration with the fields Play has and we do not manage (icon, sort rank) kept. Nothing is published: the
|
|
// owner's Publish in Play Console makes the draft live.
|
|
import { playServiceAccount } from '../lib/credentials';
|
|
import type { Ctx } from '../lib/ctx';
|
|
import { confirm, need } from '../lib/ctx';
|
|
import { dryPlan } from '../lib/dry';
|
|
import { hasAndroidProject, type ItemPlan, pgsFindings, type PlayExisting, planPlayGames, planRows, readPgsProject, usesPlayGames } from '../lib/game-services';
|
|
import { PLAY_SCOPE, tokenSource } from '../lib/google-auth';
|
|
import { errorBody } from '../lib/http';
|
|
import { done, log, warn } from '../lib/log';
|
|
import * as rt from '../lib/rt';
|
|
import { AmbiguousWriteError, createOnce, retrySafe } from '../lib/upsert';
|
|
|
|
const TAG = 'play-games';
|
|
export const GAMES_CONFIG_API = 'https://gamesconfiguration.googleapis.com/games/v1configuration';
|
|
|
|
export function gamesConfigClient(root: string) {
|
|
const token = tokenSource(playServiceAccount(root), PLAY_SCOPE);
|
|
async function call<T = unknown>(method: string, path: string, body?: unknown): Promise<T> {
|
|
const url = GAMES_CONFIG_API + path;
|
|
const safe = method !== 'POST' && retrySafe(method, url);
|
|
for (let attempt = 0; ; attempt++) {
|
|
const r = await fetch(url, { method, headers: { Authorization: 'Bearer ' + (await token()), ...(body === undefined ? {} : { 'Content-Type': 'application/json' }) }, body: body === undefined ? undefined : JSON.stringify(body) });
|
|
if (r.status === 429 && attempt < 4) { await r.body?.cancel(); await rt.sleep(2000 * (attempt + 1)); continue; }
|
|
if (r.status >= 500) {
|
|
if (safe && attempt < 4) { await r.body?.cancel(); await rt.sleep(2000 * (attempt + 1)); continue; }
|
|
const t = await r.text();
|
|
if (!safe) throw new AmbiguousWriteError(`${method} ${path} -> ${r.status} ${errorBody(t, 300)}`, r.status);
|
|
throw new Error(`${method} ${path} -> ${r.status} ${errorBody(t, 300)}`);
|
|
}
|
|
const t = await r.text();
|
|
if (!r.ok) throw new Error(`${method} ${path} -> ${r.status} ${errorBody(t, 800)}`);
|
|
return (t ? JSON.parse(t) : {}) as T;
|
|
}
|
|
}
|
|
async function list(kind: 'achievements' | 'leaderboards', appId: string): Promise<PlayExisting[]> {
|
|
const out: PlayExisting[] = [];
|
|
let page: string | undefined;
|
|
do {
|
|
const r = await call<{ items?: PlayExisting[]; nextPageToken?: string }>('GET', `/applications/${appId}/${kind}?maxResults=200${page ? `&pageToken=${encodeURIComponent(page)}` : ''}`);
|
|
out.push(...(r.items ?? []));
|
|
page = r.nextPageToken;
|
|
} while (page);
|
|
return out;
|
|
}
|
|
return { call, list };
|
|
}
|
|
|
|
export const playDefaultLocale = (config: Ctx['loaded']['config']): string => config.play?.defaultLanguage ?? 'en-US';
|
|
|
|
export async function readPlayGames(c: ReturnType<typeof gamesConfigClient>, appId: string): Promise<{ leaderboards: PlayExisting[]; achievements: PlayExisting[] }> {
|
|
return { leaderboards: await c.list('leaderboards', appId), achievements: await c.list('achievements', appId) };
|
|
}
|
|
|
|
const pending = (plan: ItemPlan[]) => plan.filter(p => p.action !== 'keep');
|
|
|
|
export async function run(ctx: Ctx): Promise<void> {
|
|
const { config, root } = ctx.loaded;
|
|
const a = ctx.args;
|
|
const sub = a._[0] ?? 'sync';
|
|
if (!['sync', 'status'].includes(sub)) throw new Error('usage: storebound play games [status] [--dry] [--yes] [--json]');
|
|
if (!usesPlayGames(config)) throw new Error('games.playGames is not set in storebound.config.ts (game-services skill): nothing to do');
|
|
need(config.play?.packageName, 'play.packageName');
|
|
const pgs = hasAndroidProject(root) ? readPgsProject(root) : null;
|
|
const project = pgs ? pgsFindings(config, pgs) : [];
|
|
const appId = config.games!.playGames!.appId ?? pgs?.appId?.value;
|
|
for (const f of project) (f.level === 'ok' ? log : warn)(TAG, `${f.msg}${f.fix ? ` (${f.fix})` : ''}`);
|
|
if (!appId) throw new Error('games.playGames.appId is not set and the Android project has no games_APP_ID: create the games project first (storebound console plan play-games-services), then set the id');
|
|
const c = gamesConfigClient(root);
|
|
const have = await readPlayGames(c, appId);
|
|
const locale = playDefaultLocale(config);
|
|
const plan = planPlayGames(config.games!, config.languages, locale, have);
|
|
if (a.has('json')) console.log(JSON.stringify({ appId, leaderboards: have.leaderboards.length, achievements: have.achievements.length, project, plan }, null, 2));
|
|
if (sub === 'status' || a.has('dry')) {
|
|
if (!a.has('json')) console.log(dryPlan(`play games (project ${appId})`, planRows(plan)));
|
|
return;
|
|
}
|
|
if (!pending(plan).length) { done(TAG, `Play Games Services in step: ${have.leaderboards.length} leaderboard(s), ${have.achievements.length} achievement(s)`); return; }
|
|
console.log(dryPlan(`play games (project ${appId}, to write)`, planRows(plan)).replace(/^dry run: /, '').replace(/; nothing written/, ''));
|
|
if (!(await confirm(ctx, 'Write these Play Games Services drafts? (nothing is published; the owner publishes in Play Console)'))) return;
|
|
for (const p of pending(plan)) {
|
|
const kind = p.kind === 'leaderboard' ? 'leaderboards' : 'achievements';
|
|
const name = (p.attributes.draft as { name: { translations: { locale: string; value: string }[] } }).name.translations.find(t => t.locale === locale)?.value;
|
|
if (p.action === 'create') {
|
|
const r = await createOnce({ what: `${p.kind} ${p.id}`, tag: TAG,
|
|
create: async () => (await c.call<PlayExisting>('POST', `/applications/${appId}/${kind}`, p.attributes)).id,
|
|
find: async () => (await c.list(kind, appId)).find(x => x.draft?.name?.translations.some(t => t.locale === locale && t.value === name))?.id ?? null });
|
|
log(TAG, `${p.kind} ${p.id}: created as ${r.value} (set playId: "${r.value}" in the config to match it by id)`);
|
|
} else {
|
|
await c.call('PUT', `/${kind}/${encodeURIComponent(p.storeId!)}`, p.attributes);
|
|
log(TAG, `${p.kind} ${p.id}: updated ${p.changed.join(', ')}`);
|
|
}
|
|
}
|
|
const left = pending(planPlayGames(config.games!, config.languages, locale, await readPlayGames(c, appId)));
|
|
if (left.length) warn(TAG, `read back: ${left.map(p => `${p.kind} ${p.id}`).join(', ')} not shown as written yet; run storebound play games status in a minute`);
|
|
done(TAG, 'Play Games Services drafts written; publish them with the games project in Play Console (the owner\'s Publish button: storebound console plan play-games-services)');
|
|
}
|