@bitmagic/cli 0.1.83-dev.1 → 0.1.83-dev.2

package/dist/commands/steam-build.js

@@ -0,0 +1,286 @@
+/**
+ * `bitmagic steam build` — the Windows and macOS depots.
+ *
+ *   payload   the self-contained bundle, every asset vendored, proven to boot with no network
+ *             on WebGPU and WebGL (shared with `ios build`: package/offline-payload.ts)
+ *   windows   Electron win32-x64 stamped into `<Game>.exe` (any OS)
+ *   macos     a universal `<Game>.app`, signed with the creator's Developer ID and notarized —
+ *             Steam requires notarization for new macOS apps (a Mac is required)
+ *   check     the finished app for this machine's platform is launched and must reach gameplay
+ *
+ * Output: `.bitmagic/steam/build/windows/` and `.bitmagic/steam/build/macos/` — exactly the
+ * content roots `steam upload` hands SteamPipe — plus `build.json` describing what was built.
+ */
+import { spawn } from 'child_process';
+import { defineCommand } from 'citty';
+import * as fs from 'fs';
+import * as path from 'path';
+import { writeJsonAtomic, readJsonFile } from '../atomic-json.js';
+import { CliError } from '../errors.js';
+import { createOutput } from '../output.js';
+import { loadProjectContext } from '../project/context.js';
+import { buildOfflinePayload, ensureSelfContainedBundle } from '../package/offline-payload.js';
+import { computeFingerprint } from '../publish/fingerprint.js';
+import { submitCredentialsPath } from './ios.js';
+import { resolveSteamConfig, updateSteamConfigFile } from '../steam/config.js';
+import { ELECTRON_VERSION, ensureElectronShell } from '../steam/electron-cache.js';
+import { launchCheckApp } from '../steam/launch-check.js';
+import { findDeveloperIdIdentities, gatekeeperAssessment, mergeUniversal, notarizeMacApp, signMacApp, stampMacApp, } from '../steam/package-macos.js';
+import { directoryBytes, packageWindows } from '../steam/package-windows.js';
+import { macosContentRoot, steamPaths, windowsContentRoot } from '../steam/paths.js';
+import { shellPackageName } from '../steam/shell-files.js';
+import { MAC_ICNS_FILE, SHORTCUT_ICO_FILE } from '../steam/specs.js';
+import { readStoreCopy } from '../steam/store-copy.js';
+const RENDERERS = ['webgpu', 'webgl'];
+export function buildRecordPath(root) {
+    return path.join(steamPaths(root).buildDir, 'build.json');
+}
+export function readBuildRecord(root) {
+    const parsed = readJsonFile(buildRecordPath(root));
+    return typeof parsed === 'object' && parsed !== null ? parsed : null;
+}
+function parsePlatforms(value) {
+    if (value === undefined || value === 'all')
+        return ['windows', 'macos'];
+    const platforms = value.split(',').map((p) => p.trim());
+    for (const platform of platforms) {
+        if (platform !== 'windows' && platform !== 'macos')
+            throw new CliError('--platform takes windows, macos or all.');
+    }
+    return platforms;
+}
+/** The notary credentials to use, or null when there are none (and the reason why). */
+function resolveNotaryCredentials(profileFlag, configProfile) {
+    const profile = profileFlag ?? configProfile;
+    if (profile !== undefined)
+        return { kind: 'profile', profile };
+    const parsed = readJsonFile(submitCredentialsPath());
+    if (parsed !== null && typeof parsed.keyId === 'string' && typeof parsed.issuerId === 'string' && typeof parsed.keyPath === 'string'
+        && fs.existsSync(parsed.keyPath)) {
+        return { kind: 'key', keyId: parsed.keyId, issuerId: parsed.issuerId, keyPath: parsed.keyPath };
+    }
+    return null;
+}
+async function runSteamBuild(args) {
+    const json = args.json === true;
+    const output = createOutput(json);
+    const context = loadProjectContext();
+    const paths = steamPaths(context.root);
+    const config = resolveSteamConfig({ root: context.root, gameId: context.metadata.gameId, configPath: paths.configPath });
+    const platforms = parsePlatforms(args.platform);
+    if (platforms.includes('macos') && process.platform !== 'darwin') {
+        throw new CliError('The macOS build needs a Mac (lipo, codesign and notarization are macOS tools). Build `--platform windows` here and the macOS depot on a Mac.', 3);
+    }
+    const copy = readStoreCopy(paths.storePath);
+    const copyrightHolder = copy?.developer?.trim() || `the creator of ${config.displayName}`;
+    const identity = { displayName: config.displayName, packageName: shellPackageName(context.metadata.gameId), version: config.version };
+    const icoPath = path.join(paths.kitDir, SHORTCUT_ICO_FILE);
+    const icnsPath = path.join(paths.kitDir, MAC_ICNS_FILE);
+    if (!fs.existsSync(icoPath) || !fs.existsSync(icnsPath)) {
+        output.info('No game icons yet, so the builds keep Electron\'s. Run `bitmagic steam art render` (it writes them from the icon art) and build again.');
+    }
+    // Signing is decided before the slow work, so a missing identity fails in seconds, not minutes.
+    let signIdentity = null;
+    if (platforms.includes('macos') && args.sign !== false) {
+        const identities = findDeveloperIdIdentities();
+        const wanted = args.identity ?? config.macIdentity;
+        if (wanted !== undefined) {
+            signIdentity = identities.find((candidate) => candidate === wanted || candidate.includes(wanted)) ?? null;
+            if (signIdentity === null)
+                throw new CliError(`No signing identity matching "${wanted}" in the keychain. Found: ${identities.join(', ') || 'none'}.`, 3);
+            if (args.identity !== undefined)
+                updateSteamConfigFile(paths.configPath, { macIdentity: signIdentity });
+        }
+        else if (identities.length === 1) {
+            signIdentity = identities[0];
+        }
+        else if (identities.length > 1) {
+            throw new CliError(`The keychain holds several Developer ID identities; pick one with --identity:\n  ${identities.join('\n  ')}`, 3);
+        }
+        else {
+            throw new CliError('Steam requires the macOS app to be notarized, which needs a "Developer ID Application" certificate in this Mac\'s '
+                + 'keychain (Apple Developer Program → Certificates). Create one, or build unsigned with --no-sign (Steam may reject it).', 3);
+        }
+    }
+    let notary = null;
+    if (signIdentity !== null && args.notarize !== false) {
+        notary = resolveNotaryCredentials(args['notary-profile'], config.notaryProfile);
+        if (notary === null) {
+            throw new CliError('Notarizing needs Apple credentials. Either write an App Store Connect API key to '
+                + `${submitCredentialsPath()} as {"keyId": "…", "issuerId": "…", "keyPath": "/path/to/AuthKey_….p8"} `
+                + '(Users and Access → Integrations → App Store Connect API, role Developer), or have the creator run '
+                + '`xcrun notarytool store-credentials <name>` in their own terminal and pass --notary-profile <name>. '
+                + 'To build without notarizing, pass --no-notarize.', 3);
+        }
+        if (args['notary-profile'] !== undefined)
+            updateSteamConfigFile(paths.configPath, { notaryProfile: args['notary-profile'] });
+    }
+    const html = ensureSelfContainedBundle(context, output, json);
+    const fingerprint = computeFingerprint(context.root);
+    const { offlineValidated } = await buildOfflinePayload({
+        root: context.root,
+        html,
+        payloadDir: paths.payloadDir,
+        cacheDir: paths.cacheDir,
+        checkDir: paths.checkDir,
+        distribution: 'steam',
+        platform: 'desktop',
+        renderers: RENDERERS,
+        skipValidation: args['skip-validation'] === true,
+        deviceLabel: 'desktop window',
+        output,
+    });
+    const record = {
+        version: config.version,
+        buildNumber: config.buildNumber,
+        electron: ELECTRON_VERSION,
+        fingerprint,
+        offlineValidated,
+        builtAt: new Date().toISOString(),
+    };
+    if (platforms.includes('windows')) {
+        const shell = await ensureElectronShell('win32-x64', output.info);
+        output.info('Stamping the Windows build…');
+        const result = await packageWindows({
+            shellDir: shell,
+            outDir: windowsContentRoot(paths),
+            productName: config.productName,
+            identity,
+            version: config.version,
+            copyrightHolder,
+            payloadDir: paths.payloadDir,
+            ico: fs.existsSync(icoPath) ? fs.readFileSync(icoPath) : null,
+        });
+        record.windows = { exe: result.exePath, bytes: result.bytes };
+        output.info(`Windows: ${result.exePath} (${(result.bytes / 1e6).toFixed(0)} MB)`);
+    }
+    if (platforms.includes('macos')) {
+        const work = path.join(paths.steamDir, 'work');
+        const stamped = { arm64: '', x64: '' };
+        for (const arch of ['arm64', 'x64']) {
+            const shell = await ensureElectronShell(`darwin-${arch}`, output.info);
+            output.info(`Stamping the macOS ${arch} app…`);
+            stamped[arch] = stampMacApp({
+                shellDir: shell,
+                outDir: path.join(work, `macos-${arch}`),
+                productName: config.productName,
+                bundleId: config.bundleId,
+                version: config.version,
+                buildNumber: config.buildNumber,
+                copyrightHolder,
+                identity,
+                payloadDir: paths.payloadDir,
+                icns: fs.existsSync(icnsPath) ? fs.readFileSync(icnsPath) : null,
+            });
+        }
+        const outRoot = macosContentRoot(paths);
+        fs.rmSync(outRoot, { recursive: true, force: true });
+        fs.mkdirSync(outRoot, { recursive: true });
+        const app = path.join(outRoot, `${config.productName}.app`);
+        output.info('Merging Apple Silicon and Intel into one universal app…');
+        mergeUniversal(stamped.arm64, stamped.x64, app);
+        fs.rmSync(work, { recursive: true, force: true });
+        let notarized = false;
+        let gatekeeper = null;
+        if (signIdentity !== null) {
+            signMacApp(app, signIdentity, output.info);
+            if (notary !== null) {
+                const result = notarizeMacApp(app, notary, output.info);
+                notarized = true;
+                output.info(`Notarized (submission ${result.submissionId}) and stapled.`);
+            }
+            gatekeeper = gatekeeperAssessment(app);
+            output.info(`Gatekeeper: ${gatekeeper.split('\n').filter((line) => /accepted|rejected|source=/.test(line)).join(' ') || gatekeeper}`);
+        }
+        else {
+            output.info('Unsigned macOS build (--no-sign). Steam requires new macOS apps to be notarized; do not ship this one.');
+        }
+        let launchChecked = false;
+        if (args['launch-check'] !== false && process.platform === 'darwin') {
+            output.info('Launching the finished app to check it reaches gameplay…');
+            const check = await launchCheckApp({
+                executable: path.join(app, 'Contents', 'MacOS', config.productName),
+                artifactDir: path.join(paths.checkDir, 'launch-macos'),
+            });
+            for (const warning of check.result.warnings)
+                output.info(`  warning: ${warning}`);
+            if (!check.result.ok) {
+                throw new CliError(`The packaged macOS app did not reach gameplay:\n${check.result.failures.map((f) => `  ✗ ${f}`).join('\n')}\n`
+                    + `Artifacts: ${path.dirname(check.screenshotPath)}`, 5);
+            }
+            launchChecked = true;
+            output.info(`The macOS app launches and plays (screenshot: ${check.screenshotPath}).`);
+        }
+        record.macos = { app, bytes: directoryBytes(app), signedBy: signIdentity, notarized, gatekeeper, launchChecked };
+        output.info(`macOS: ${app} (${(record.macos.bytes / 1e6).toFixed(0)} MB)`);
+    }
+    writeJsonAtomic(buildRecordPath(context.root), record);
+    output.info('Next: `bitmagic steam upload` (the creator logs steamcmd in once with `bitmagic steam login`).');
+    output.result({ ok: true, ...record });
+}
+/** The executable `play` and the launch check start on this machine, or null when none was built. */
+function builtExecutable(record, productName) {
+    if (process.platform === 'darwin' && record?.macos !== undefined) {
+        return { executable: path.join(record.macos.app, 'Contents', 'MacOS', productName), app: record.macos.app };
+    }
+    if (process.platform === 'win32' && record?.windows !== undefined)
+        return { executable: record.windows.exe };
+    return null;
+}
+export const steamPlayCommand = defineCommand({
+    meta: {
+        name: 'play',
+        description: 'Open the built app on this machine to play it as a Steam player will. --check runs the automated launch check instead.',
+    },
+    args: {
+        check: { type: 'boolean', description: 'Launch it headlessly-driven and check it reaches gameplay, as `steam build` does.' },
+        json: { type: 'boolean', description: 'Print the result as JSON on stdout; all progress goes to stderr.' },
+    },
+    async run({ args }) {
+        const output = createOutput(args.json === true);
+        const context = loadProjectContext();
+        const paths = steamPaths(context.root);
+        const config = resolveSteamConfig({ root: context.root, gameId: context.metadata.gameId, configPath: paths.configPath });
+        const built = builtExecutable(readBuildRecord(context.root), config.productName);
+        if (built === null)
+            throw new CliError('No build for this machine\'s platform. Run `bitmagic steam build` first.', 3);
+        if (args.check === true) {
+            const check = await launchCheckApp({ executable: built.executable, artifactDir: path.join(paths.checkDir, `launch-${process.platform === 'darwin' ? 'macos' : 'windows'}`) });
+            for (const warning of check.result.warnings)
+                output.info(`  warning: ${warning}`);
+            for (const failure of check.result.failures)
+                output.info(`  ✗ ${failure}`);
+            output.info(check.result.ok ? `The app launches and plays (screenshot: ${check.screenshotPath}).` : `It did not reach gameplay. Artifacts: ${path.dirname(check.screenshotPath)}`);
+            output.result({ ok: check.result.ok, ...check });
+            if (!check.result.ok)
+                throw new CliError('The packaged app did not reach gameplay.', 5);
+            return;
+        }
+        const child = built.app !== undefined
+            ? spawn('open', [built.app], { detached: true, stdio: 'ignore' })
+            : spawn(built.executable, [], { detached: true, stdio: 'ignore' });
+        child.unref();
+        output.info(`Opened ${built.app ?? built.executable}.`);
+        output.result({ ok: true, opened: built.app ?? built.executable });
+    },
+});
+export const steamBuildCommand = defineCommand({
+    meta: {
+        name: 'build',
+        description: 'Build the Windows and macOS depots: offline-validated payload, <Game>.exe, a signed and notarized universal <Game>.app.',
+    },
+    args: {
+        platform: { type: 'string', description: 'windows, macos, or all (default). The macOS build needs a Mac.' },
+        'skip-validation': { type: 'boolean', description: 'Skip the offline record/validation passes. Working without a network is then NOT confirmed.' },
+        sign: { type: 'boolean', negativeDescription: 'Do not sign or notarize the macOS app (a local test build; Steam requires notarization).' },
+        notarize: { type: 'boolean', negativeDescription: 'Sign but do not notarize the macOS app.' },
+        identity: { type: 'string', description: 'The Developer ID Application identity to sign with, when the keychain has several. Remembered.' },
+        'notary-profile': { type: 'string', description: 'A `notarytool store-credentials` profile to notarize with instead of the App Store Connect key. Remembered.' },
+        'launch-check': { type: 'boolean', negativeDescription: 'Do not launch the finished app to check it reaches gameplay.' },
+        json: { type: 'boolean', description: 'Print the result as JSON on stdout; all progress goes to stderr.' },
+    },
+    async run({ args }) {
+        await runSteamBuild(args);
+    },
+});
+//# sourceMappingURL=steam-build.js.map

package/dist/commands/steam-build.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"steam-build.js","sourceRoot":"","sources":["../../src/commands/steam-build.ts"],"names":[],"mappings":"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"}

package/dist/commands/steam-portal.d.ts

@@ -0,0 +1 @@
+export declare const steamPortalCommand: import("citty").CommandDef<import("citty").ArgsDef>;

package/dist/commands/steam-portal.js

@@ -0,0 +1,319 @@
+/**
+ * `bitmagic steam portal` — the Steamworks website in a Chrome window the creator logs in to,
+ * with commands any agent can drive it by: look at the page, fill a field, upload files, click.
+ * See steam/portal.ts for the window and the lines it will not cross.
+ */
+import { defineCommand } from 'citty';
+import * as fs from 'fs';
+import * as os from 'os';
+import * as path from 'path';
+import { CliError } from '../errors.js';
+import { createOutput } from '../output.js';
+import { findDirWithFileUpwards, loadProjectContext } from '../project/context.js';
+import { steamPaths } from '../steam/paths.js';
+import { resolveSteamConfig } from '../steam/config.js';
+import { readStoreCopy } from '../steam/store-copy.js';
+import { STEAMWORKS_HOME, attachPortal, clickElement, closePortal, detach, fillElement, gotoUrl, lookAtPage, openPortal, pageText, portalDir, selectOption, setChecked, uploadToElement, } from '../steam/portal.js';
+import { runPortalRecipe, RECIPES } from '../steam/portal-recipes.js';
+const JSON_FLAG = {
+    type: 'boolean',
+    description: 'Print the result as JSON on stdout; all progress goes to stderr.',
+};
+/** Where `portal screenshot` writes: the project's check dir inside a project, else the portal dir. */
+function screenshotTarget() {
+    const root = findDirWithFileUpwards('bitmagic.json');
+    return root !== null
+        ? path.join(steamPaths(root).checkDir, 'portal.png')
+        : path.join(portalDir(), 'portal.png');
+}
+async function withPage(fn) {
+    const { browser, page } = await attachPortal();
+    try {
+        return await fn(page);
+    }
+    finally {
+        await detach(browser);
+    }
+}
+function printLook(output, look) {
+    output.info(`${look.title} — ${look.url}${look.loggedIn ? '' : '  (not logged in)'}`);
+    if (look.headings.length > 0)
+        output.info(`Headings: ${look.headings.join(' | ')}`);
+    for (const notice of look.notices)
+        output.info(`Notice: ${notice}`);
+    for (const element of look.elements) {
+        const state = [
+            element.value !== undefined && element.value !== '' ? `= "${element.value}"` : '',
+            element.checked !== undefined ? (element.checked ? '[x]' : '[ ]') : '',
+            element.disabled ? '(disabled)' : '',
+        ].filter((part) => part !== '').join(' ');
+        output.info(`  ${element.ref.padEnd(5)} ${element.role.padEnd(9)} ${element.label}${state ? ` ${state}` : ''}`);
+    }
+}
+/** A dotted path into store.json, e.g. `about` or `systemRequirements.windows.minimum.os`. */
+function storeValue(field) {
+    const root = findDirWithFileUpwards('bitmagic.json');
+    if (root === null)
+        throw new CliError('--store reads .bitmagic/steam/store.json, so run it inside the game project.');
+    const copy = readStoreCopy(steamPaths(root).storePath);
+    if (copy === null)
+        throw new CliError('No store copy yet — `bitmagic steam init`, then write it.', 3);
+    let value = copy;
+    for (const key of field.split('.')) {
+        value = typeof value === 'object' && value !== null ? value[key] : undefined;
+    }
+    if (typeof value === 'number')
+        return String(value);
+    if (Array.isArray(value))
+        return value.join(', ');
+    if (typeof value !== 'string')
+        throw new CliError(`store.json has no text at "${field}".`);
+    return value;
+}
+const openCommand = defineCommand({
+    meta: {
+        name: 'open',
+        description: 'Open Steamworks in a dedicated Chrome window (or bring the open one to a page). The creator logs in there.',
+    },
+    args: {
+        url: { type: 'string', description: 'A Steamworks page to open instead of the home page.' },
+        app: { type: 'boolean', description: 'Open this game\'s app page (needs the app id from `steam init`).' },
+        json: JSON_FLAG,
+    },
+    async run({ args }) {
+        const output = createOutput(args.json === true);
+        let url = args.url;
+        if (args.app === true) {
+            const context = loadProjectContext();
+            const paths = steamPaths(context.root);
+            const config = resolveSteamConfig({ root: context.root, gameId: context.metadata.gameId, configPath: paths.configPath });
+            if (config.appId === undefined)
+                throw new CliError('No app id yet — `bitmagic steam init --app-id <id>`.', 3);
+            url = `${STEAMWORKS_HOME}apps/landing/${config.appId}`;
+        }
+        const result = await openPortal(url !== undefined ? { url } : {});
+        const look = await withPage(lookAtPage);
+        output.info(result.reused ? 'The Steamworks window was already open.' : 'Opened Steamworks in its own Chrome window.');
+        output.info(look.loggedIn
+            ? `Logged in. ${look.title} — ${look.url}`
+            : 'Not logged in yet. The creator logs in in that window — their password and Steam Guard code are theirs to type, '
+                + 'nobody else\'s. Then run `bitmagic steam portal status`.');
+        output.result({ ok: true, ...result, loggedIn: look.loggedIn, url: look.url });
+    },
+});
+const statusCommand = defineCommand({
+    meta: { name: 'status', description: 'Whether the window is open and logged in, and which page it is on.' },
+    args: { json: JSON_FLAG },
+    async run({ args }) {
+        const output = createOutput(args.json === true);
+        const look = await withPage(lookAtPage);
+        output.info(`${look.loggedIn ? 'Logged in' : 'NOT logged in'} — ${look.title} — ${look.url}`);
+        output.result({ ok: true, loggedIn: look.loggedIn, url: look.url, title: look.title });
+    },
+});
+const lookCommand = defineCommand({
+    meta: {
+        name: 'look',
+        description: 'Describe the current page: headings, notices, and every control numbered e1, e2, … for fill/click/upload.',
+    },
+    args: {
+        screenshot: { type: 'boolean', description: 'Also save a screenshot of the page and print its path.' },
+        json: JSON_FLAG,
+    },
+    async run({ args }) {
+        const output = createOutput(args.json === true);
+        const result = await withPage(async (page) => {
+            const look = await lookAtPage(page);
+            let shot;
+            if (args.screenshot === true) {
+                shot = screenshotTarget();
+                fs.mkdirSync(path.dirname(shot), { recursive: true });
+                await page.screenshot({ path: shot, fullPage: false });
+            }
+            return { look, shot };
+        });
+        printLook(output, result.look);
+        if (result.shot)
+            output.info(`Screenshot: ${result.shot}`);
+        output.result({ ok: true, ...result.look, ...(result.shot ? { screenshot: result.shot } : {}) });
+    },
+});
+const textCommand = defineCommand({
+    meta: { name: 'text', description: 'Print the page\'s visible text — to read instructions, errors and what was saved.' },
+    args: { max: { type: 'string', description: 'Characters to print (default 20000).' }, json: JSON_FLAG },
+    async run({ args }) {
+        const output = createOutput(args.json === true);
+        const text = await withPage((page) => pageText(page, args.max !== undefined ? Number(args.max) : 20_000));
+        output.info(text);
+        output.result({ ok: true, text });
+    },
+});
+const screenshotCommand = defineCommand({
+    meta: { name: 'screenshot', description: 'Save a screenshot of the page and print its path, to look at it.' },
+    args: { full: { type: 'boolean', description: 'The whole scrolling page, not just the window.' }, json: JSON_FLAG },
+    async run({ args }) {
+        const output = createOutput(args.json === true);
+        const target = screenshotTarget();
+        fs.mkdirSync(path.dirname(target), { recursive: true });
+        await withPage((page) => page.screenshot({ path: target, fullPage: args.full === true }));
+        output.info(target);
+        output.result({ ok: true, path: target });
+    },
+});
+const gotoCommand = defineCommand({
+    meta: { name: 'goto', description: 'Go to a Steamworks page (full URL, or a path such as /apps/landing/<appid>).' },
+    args: { url: { type: 'positional', required: true, description: 'URL or path on partner.steamgames.com.' }, json: JSON_FLAG },
+    async run({ args }) {
+        const output = createOutput(args.json === true);
+        const look = await withPage(async (page) => {
+            await gotoUrl(page, args.url);
+            return lookAtPage(page);
+        });
+        printLook(output, look);
+        output.result({ ok: true, ...look });
+    },
+});
+const clickCommand = defineCommand({
+    meta: {
+        name: 'click',
+        description: 'Click an element by its ref from `look`. Submit/publish/release/pay/delete buttons need --approved.',
+    },
+    args: {
+        ref: { type: 'positional', required: true, description: 'An element ref from `look`, e.g. e12.' },
+        approved: {
+            type: 'boolean',
+            description: 'The creator has explicitly approved THIS step (a submission, publish, release, payment or deletion).',
+        },
+        json: JSON_FLAG,
+    },
+    async run({ args }) {
+        const output = createOutput(args.json === true);
+        const result = await withPage(async (page) => {
+            const label = await clickElement(page, args.ref, { approved: args.approved === true });
+            await page.waitForTimeout(800);
+            return { label, look: await lookAtPage(page) };
+        });
+        output.info(`Clicked "${result.label}".`);
+        printLook(output, result.look);
+        output.result({ ok: true, clicked: result.label, ...result.look });
+    },
+});
+const fillCommand = defineCommand({
+    meta: {
+        name: 'fill',
+        description: 'Type into a field by its ref: --value text, --file <path>, or --store <field of store.json>. Never a password.',
+    },
+    args: {
+        ref: { type: 'positional', required: true, description: 'An element ref from `look`.' },
+        value: { type: 'string', description: 'The text to put in the field.' },
+        file: { type: 'string', description: 'Read the text from this file.' },
+        store: { type: 'string', description: 'Take the text from .bitmagic/steam/store.json, e.g. about, shortDescription, systemRequirements.windows.minimum.os.' },
+        json: JSON_FLAG,
+    },
+    async run({ args }) {
+        const output = createOutput(args.json === true);
+        const sources = [args.value, args.file, args.store].filter((source) => source !== undefined);
+        if (sources.length !== 1)
+            throw new CliError('Pass exactly one of --value, --file or --store.');
+        const value = args.value ?? (args.file !== undefined ? fs.readFileSync(path.resolve(args.file), 'utf-8') : storeValue(args.store ?? ''));
+        await withPage((page) => fillElement(page, args.ref, value));
+        output.info(`Filled ${args.ref} (${value.length} characters). Nothing is saved until the page's own Save is clicked.`);
+        output.result({ ok: true, ref: args.ref, characters: value.length });
+    },
+});
+const uploadCommand = defineCommand({
+    meta: { name: 'upload', description: 'Give files to a file input by its ref (comma-separated paths).' },
+    args: {
+        ref: { type: 'positional', required: true, description: 'A file input ref from `look`.' },
+        files: { type: 'positional', required: true, description: 'Comma-separated file paths.' },
+        json: JSON_FLAG,
+    },
+    async run({ args }) {
+        const output = createOutput(args.json === true);
+        const files = args.files.split(',').map((file) => path.resolve(file.trim().replace(/^~(?=$|\/)/, os.homedir())));
+        const look = await withPage(async (page) => {
+            await uploadToElement(page, args.ref, files);
+            await page.waitForTimeout(1500);
+            return lookAtPage(page);
+        });
+        output.info(`Gave ${files.length} file(s) to ${args.ref}.`);
+        printLook(output, look);
+        output.result({ ok: true, files, ...look });
+    },
+});
+const selectCommand = defineCommand({
+    meta: { name: 'select', description: 'Choose an option in a dropdown by its ref.' },
+    args: {
+        ref: { type: 'positional', required: true, description: 'A select ref from `look`.' },
+        option: { type: 'positional', required: true, description: 'The option\'s visible text (or value).' },
+        json: JSON_FLAG,
+    },
+    async run({ args }) {
+        const output = createOutput(args.json === true);
+        const chosen = await withPage((page) => selectOption(page, args.ref, args.option));
+        output.info(`Selected ${chosen.join(', ')} in ${args.ref}.`);
+        output.result({ ok: true, selected: chosen });
+    },
+});
+const checkCommand = defineCommand({
+    meta: { name: 'check', description: 'Tick (or with --off untick) a checkbox by its ref.' },
+    args: {
+        ref: { type: 'positional', required: true, description: 'A checkbox ref from `look`.' },
+        off: { type: 'boolean', description: 'Untick instead.' },
+        json: JSON_FLAG,
+    },
+    async run({ args }) {
+        const output = createOutput(args.json === true);
+        await withPage((page) => setChecked(page, args.ref, args.off !== true));
+        output.info(`${args.off === true ? 'Unticked' : 'Ticked'} ${args.ref}.`);
+        output.result({ ok: true });
+    },
+});
+const runCommand = defineCommand({
+    meta: {
+        name: 'run',
+        description: `Run a scripted Steamworks step from the store kit: ${Object.keys(RECIPES).join(', ')}. Stops before anything is submitted.`,
+    },
+    args: {
+        recipe: { type: 'positional', required: true, description: `One of: ${Object.keys(RECIPES).join(', ')}.` },
+        json: JSON_FLAG,
+    },
+    async run({ args }) {
+        const output = createOutput(args.json === true);
+        const context = loadProjectContext();
+        const result = await withPage((page) => runPortalRecipe(args.recipe, { page, root: context.root, gameId: context.metadata.gameId, log: output.info }));
+        output.result({ ok: true, ...result });
+    },
+});
+const closeCommand = defineCommand({
+    meta: { name: 'close', description: 'Close the Steamworks window. The login is kept in its profile for next time.' },
+    args: { json: JSON_FLAG },
+    async run({ args }) {
+        const output = createOutput(args.json === true);
+        const closed = await closePortal();
+        output.info(closed ? 'Closed the Steamworks window.' : 'No Steamworks window was open.');
+        output.result({ ok: true, closed });
+    },
+});
+export const steamPortalCommand = defineCommand({
+    meta: {
+        name: 'portal',
+        description: 'Drive the Steamworks website in a Chrome window the creator logs in to: look, fill, upload, click, run steps.',
+    },
+    subCommands: {
+        open: openCommand,
+        status: statusCommand,
+        look: lookCommand,
+        text: textCommand,
+        screenshot: screenshotCommand,
+        goto: gotoCommand,
+        click: clickCommand,
+        fill: fillCommand,
+        upload: uploadCommand,
+        select: selectCommand,
+        check: checkCommand,
+        run: runCommand,
+        close: closeCommand,
+    },
+});
+//# sourceMappingURL=steam-portal.js.map