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

package/dist/steam/paths.d.ts

@@ -0,0 +1,35 @@
+export interface SteamPaths {
+    /** `.bitmagic/steam` — the lane's root. */
+    steamDir: string;
+    /** `.bitmagic/steam.json` — the app id, depots, builder account, version. */
+    configPath: string;
+    /** The store page copy the agent writes and `steam check` validates. */
+    storePath: string;
+    /** Which image is the wide/tall/hero key art, the logo and the icon, and each capsule's layout. */
+    artConfigPath: string;
+    /** The chosen sources: keyart-wide.png, keyart-tall.png, keyart-hero.png, logo.png, icon.png. */
+    artDir: string;
+    /** Generated candidates, one PNG + one JSON record each. */
+    candidatesDir: string;
+    /** Everything uploaded to Steamworks, at its exact size. */
+    kitDir: string;
+    /** Gameplay screenshots, 1920x1080. */
+    screenshotsDir: string;
+    /** The trailer as uploaded. */
+    trailerDir: string;
+    /** The game payload the desktop shell loads: index.html + vendor tree. */
+    payloadDir: string;
+    /** Downloaded-asset cache for the payload, keyed by URL hash — survives payload rebuilds. */
+    cacheDir: string;
+    /** Validation artifacts (console logs, screenshots), one subdirectory per pass. */
+    checkDir: string;
+    /** Depot content roots: build/windows/ and build/macos/. */
+    buildDir: string;
+    /** Generated SteamPipe scripts and steamcmd's build output. */
+    steampipeDir: string;
+}
+export declare function steamPaths(root: string): SteamPaths;
+/** The Windows depot's content root: the folder that holds `<Game>.exe`. */
+export declare function windowsContentRoot(paths: SteamPaths): string;
+/** The macOS depot's content root: the folder that holds `<Game>.app`. */
+export declare function macosContentRoot(paths: SteamPaths): string;

package/dist/steam/paths.js

@@ -0,0 +1,44 @@
+/**
+ * Where the Steam lane keeps everything: under `.bitmagic/`, which the publish fingerprint
+ * excludes, so nothing `bitmagic steam` writes can flip verify/publish staleness. Same reasoning
+ * as the iOS lane's `.bitmagic/ios/` (see ios/paths.ts).
+ *
+ * Two kinds of file live here and they are treated differently:
+ *  - INPUTS the agent and creator author — `steam.json` (the app's identity on Steam),
+ *    `steam/store.json` (the store page copy), `steam/art.json` and `steam/art/` (the key art,
+ *    the logo and how each capsule is laid out). Nothing regenerates these.
+ *  - OUTPUTS the CLI derives — `steam/store-kit/` (every image, screenshot and the trailer at the
+ *    exact size Steamworks asks for), `steam/payload/`, `steam/build/`, `steam/steampipe/`.
+ *    Rebuilt on every run; safe to delete.
+ */
+import * as path from 'path';
+export function steamPaths(root) {
+    const steamDir = path.join(root, '.bitmagic', 'steam');
+    const kitDir = path.join(steamDir, 'store-kit');
+    const artDir = path.join(steamDir, 'art');
+    return {
+        steamDir,
+        configPath: path.join(root, '.bitmagic', 'steam.json'),
+        storePath: path.join(steamDir, 'store.json'),
+        artConfigPath: path.join(steamDir, 'art.json'),
+        artDir,
+        candidatesDir: path.join(artDir, 'candidates'),
+        kitDir,
+        screenshotsDir: path.join(kitDir, 'screenshots'),
+        trailerDir: path.join(kitDir, 'trailer'),
+        payloadDir: path.join(steamDir, 'payload'),
+        cacheDir: path.join(steamDir, 'cache'),
+        checkDir: path.join(steamDir, 'check'),
+        buildDir: path.join(steamDir, 'build'),
+        steampipeDir: path.join(steamDir, 'steampipe'),
+    };
+}
+/** The Windows depot's content root: the folder that holds `<Game>.exe`. */
+export function windowsContentRoot(paths) {
+    return path.join(paths.buildDir, 'windows');
+}
+/** The macOS depot's content root: the folder that holds `<Game>.app`. */
+export function macosContentRoot(paths) {
+    return path.join(paths.buildDir, 'macos');
+}
+//# sourceMappingURL=paths.js.map

package/dist/steam/paths.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.js","sourceRoot":"","sources":["../../src/steam/paths.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAiC7B,MAAM,UAAU,UAAU,CAAC,IAAY;IACrC,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,WAAW,EAAE,OAAO,CAAC,CAAC;IACvD,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,WAAW,CAAC,CAAC;IAChD,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;IAC1C,OAAO;QACL,QAAQ;QACR,UAAU,EAAE,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,WAAW,EAAE,YAAY,CAAC;QACtD,SAAS,EAAE,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,YAAY,CAAC;QAC5C,aAAa,EAAE,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,UAAU,CAAC;QAC9C,MAAM;QACN,aAAa,EAAE,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,YAAY,CAAC;QAC9C,MAAM;QACN,cAAc,EAAE,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,aAAa,CAAC;QAChD,UAAU,EAAE,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,SAAS,CAAC;QACxC,UAAU,EAAE,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,SAAS,CAAC;QAC1C,QAAQ,EAAE,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,OAAO,CAAC;QACtC,QAAQ,EAAE,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,OAAO,CAAC;QACtC,QAAQ,EAAE,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,OAAO,CAAC;QACtC,YAAY,EAAE,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,WAAW,CAAC;KAC/C,CAAC;AACJ,CAAC;AAED,4EAA4E;AAC5E,MAAM,UAAU,kBAAkB,CAAC,KAAiB;IAClD,OAAO,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC;AAC9C,CAAC;AAED,0EAA0E;AAC1E,MAAM,UAAU,gBAAgB,CAAC,KAAiB;IAChD,OAAO,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;AAC5C,CAAC"}

package/dist/steam/playtest-shots.d.ts

@@ -0,0 +1,18 @@
+import { type RendererChoice } from '../browser-gl.js';
+export interface PlaytestShotsOptions {
+    payloadDir: string;
+    script: string;
+    /** Where screenshot_NN.png files go; numbering continues after `startIndex`. */
+    outDir: string;
+    startIndex: number;
+    renderer: RendererChoice;
+    /** Hard cap for the whole script. */
+    timeoutMs: number;
+    log: (message: string) => void;
+}
+export interface PlaytestShotsResult {
+    written: string[];
+    /** Remote URLs the game asked for that the payload does not carry — missing in the shipped build. */
+    refused: string[];
+}
+export declare function captureWithPlaytest(options: PlaytestShotsOptions): Promise<PlaytestShotsResult>;

package/dist/steam/playtest-shots.js

@@ -0,0 +1,83 @@
+/**
+ * Screenshots of real play: the packaged payload booted in headless Chrome at exactly 1920x1080,
+ * offline, as the Steam build runs it, with an agent-written script driving the game and calling
+ * `shot()` at the moments worth showing. The HUD, the menus the player sees, the actual camera —
+ * what a Steam reviewer means by "gameplay" — rather than frames lifted from a cinematic cut.
+ *
+ * The script is an ES module the agent writes for this game:
+ *
+ *   export default async ({ page, shot, wait }) => {
+ *     await page.keyboard.press('Enter');          // through the game's own menus
+ *     await wait(4000);
+ *     await page.keyboard.down('ArrowUp');         // play
+ *     await wait(1500);
+ *     await shot('first stage, rolling');
+ *     await page.keyboard.up('ArrowUp');
+ *   };
+ *
+ * `page` is a Playwright Page. The run sets `navigator.webdriver`, as verify does, so a game's own
+ * start screen behaves the way it does under `bitmagic verify`.
+ */
+import * as fs from 'fs';
+import * as path from 'path';
+import { pathToFileURL } from 'url';
+import { browserLaunchPlan } from '../browser-gl.js';
+import { launchSystemChrome } from '../chrome-launch.js';
+import { CliError } from '../errors.js';
+import { startPayloadServer } from '../package/local-server.js';
+import { isOnlineOnlyUrl } from '../package/packaged-check.js';
+import { SCREENSHOT_HEIGHT, SCREENSHOT_WIDTH } from './specs.js';
+export async function captureWithPlaytest(options) {
+    if (!fs.existsSync(path.join(options.payloadDir, 'index.html'))) {
+        throw new CliError('No packaged payload yet — run `bitmagic steam build` first (the shots are taken from what ships).', 3);
+    }
+    const loaded = await import(pathToFileURL(path.resolve(options.script)).href);
+    if (typeof loaded.default !== 'function') {
+        throw new CliError(`${options.script} must export a default async function ({ page, shot, wait }).`);
+    }
+    const play = loaded.default;
+    const server = await startPayloadServer(options.payloadDir);
+    const plan = browserLaunchPlan(process.env, options.renderer);
+    const browser = await launchSystemChrome({ headless: plan.headless, args: ['--mute-audio', ...plan.args], command: 'bitmagic steam screenshots' });
+    const written = [];
+    const refused = new Set();
+    try {
+        const context = await browser.newContext({ viewport: { width: SCREENSHOT_WIDTH, height: SCREENSHOT_HEIGHT }, deviceScaleFactor: 1 });
+        // Offline, like the Steam build: anything not in the payload is refused — and remembered, because
+        // a scene the validation passes never reached may ask for an asset that was never packaged.
+        await context.route('**/*', (route) => {
+            const url = route.request().url();
+            if (url.startsWith(server.origin))
+                return route.continue();
+            if (!isOnlineOnlyUrl(url))
+                refused.add(url);
+            return route.abort('internetdisconnected');
+        });
+        const page = await context.newPage();
+        await page.goto(`${server.origin}/index.html?renderer=${options.renderer}`, { waitUntil: 'load', timeout: 60_000 });
+        let index = options.startIndex;
+        const shot = async (label) => {
+            index += 1;
+            const file = path.join(options.outDir, `screenshot_${String(index).padStart(2, '0')}.png`);
+            fs.mkdirSync(options.outDir, { recursive: true });
+            await page.screenshot({ path: file, clip: { x: 0, y: 0, width: SCREENSHOT_WIDTH, height: SCREENSHOT_HEIGHT } });
+            written.push(file);
+            options.log(`  ${path.basename(file)}${label ? ` ← ${label}` : ''}`);
+            return file;
+        };
+        const wait = (ms) => page.waitForTimeout(ms);
+        let timer;
+        await Promise.race([
+            play({ page, shot, wait }),
+            new Promise((_, reject) => {
+                timer = setTimeout(() => reject(new CliError(`The playtest ran past ${Math.round(options.timeoutMs / 1000)} s and was stopped.`)), options.timeoutMs);
+            }),
+        ]).finally(() => clearTimeout(timer));
+        return { written, refused: [...refused] };
+    }
+    finally {
+        await browser.close();
+        await server.close();
+    }
+}
+//# sourceMappingURL=playtest-shots.js.map

package/dist/steam/playtest-shots.js.map

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

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

@@ -0,0 +1,25 @@
+/**
+ * Scripted Steamworks steps: currently the About and short-description forms. Each recipe saves a
+ * DRAFT; none submits for review, publishes or releases, which stay the creator's (with the
+ * agent clicking only after an explicit yes, through `portal click --approved`).
+ *
+ * Steamworks changes its pages without notice. A recipe that cannot find what it expects stops
+ * and says what it was looking for, and the agent finishes that step by hand with `portal look`
+ * and `portal fill` — the recipes are the fast path, never the only one.
+ */
+import type { Page } from 'playwright-core';
+export interface RecipeContext {
+    page: Page;
+    root: string;
+    gameId: string;
+    log: (message: string) => void;
+}
+export interface RecipeResult {
+    recipe: string;
+    done: string[];
+    /** What the agent still has to do by hand on this page. */
+    remaining: string[];
+}
+export type Recipe = (context: RecipeContext) => Promise<RecipeResult>;
+export declare const RECIPES: Record<string, Recipe>;
+export declare function runPortalRecipe(name: string, context: RecipeContext): Promise<RecipeResult>;

package/dist/steam/portal-recipes.js

@@ -0,0 +1,61 @@
+import { CliError } from '../errors.js';
+import { requireAppId, resolveSteamConfig } from './config.js';
+import { steamPaths } from './paths.js';
+import { readStoreCopy, SHORT_DESCRIPTION_MAX } from './store-copy.js';
+/** Only description drafts: surveys and release actions need decisions, not canned answers. */
+const descriptions = async ({ page, root, gameId }) => {
+    const paths = steamPaths(root);
+    const appId = requireAppId(resolveSteamConfig({ root, gameId, configPath: paths.configPath }));
+    const copy = readStoreCopy(paths.storePath);
+    if (copy === null || copy.about.trim().length === 0 || copy.shortDescription.trim().length === 0) {
+        throw new CliError('Write about and shortDescription in .bitmagic/steam/store.json first.');
+    }
+    if (copy.shortDescription.length > SHORT_DESCRIPTION_MAX) {
+        throw new CliError(`shortDescription exceeds ${SHORT_DESCRIPTION_MAX} characters.`);
+    }
+    const url = `https://partner.steamgames.com/admin/game/editbyappid/${appId}?activetab=tab_description`;
+    await page.goto(url, { waitUntil: 'domcontentloaded' });
+    const visual = page.getByRole('checkbox', { name: 'Use visual editor', exact: true });
+    await visual.waitFor({ state: 'visible', timeout: 15000 });
+    await visual.uncheck();
+    const short = page.locator('#app_content_short_description__textarea');
+    // The BBCode editor has no stable ID; fail if the page exposes an ambiguous editor.
+    const source = page.locator('textarea:visible:not([id]), textarea[id=""]:visible');
+    if (await source.count() !== 1)
+        throw new CliError('Steam description editor changed. Use portal look to finish the draft.');
+    await source.fill(copy.about);
+    // The legacy localized field commits through change/blur; exercise normal editing events.
+    await short.fill('');
+    await short.pressSequentially(copy.shortDescription);
+    await short.press('Tab');
+    await Promise.all([
+        page.waitForNavigation({ waitUntil: 'domcontentloaded', timeout: 15000 }),
+        page.getByRole('button', { name: 'Save', exact: true }).click(),
+    ]);
+    // Reopen to prove the server retained the values instead of only echoing local inputs.
+    await page.goto(url, { waitUntil: 'domcontentloaded' });
+    await visual.waitFor({ state: 'visible', timeout: 15000 });
+    await visual.uncheck();
+    if (await source.inputValue() !== copy.about || await short.inputValue() !== copy.shortDescription) {
+        throw new CliError('Steam did not retain the complete descriptions. Inspect the page notice before retrying.');
+    }
+    return {
+        recipe: 'descriptions',
+        done: ['Saved and reopened the About This Game and short description drafts.'],
+        remaining: ['Inspect the store beta preview with the creator before publishing.'],
+    };
+};
+export const RECIPES = { descriptions };
+export async function runPortalRecipe(name, context) {
+    const recipe = RECIPES[name];
+    if (recipe === undefined) {
+        throw new CliError(`No portal recipe called "${name}". Known: ${Object.keys(RECIPES).join(', ') || 'none'}.`);
+    }
+    const result = await recipe(context);
+    for (const line of result.done)
+        context.log(`  done: ${line}`);
+    for (const line of result.remaining)
+        context.log(`  by hand: ${line}`);
+    return result;
+}
+//# sourceMappingURL=portal-recipes.js.map

package/dist/steam/portal-recipes.js.map

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

package/dist/steam/portal.d.ts

@@ -0,0 +1,58 @@
+import { type Browser, type Locator, type Page } from 'playwright-core';
+export declare const STEAMWORKS_HOME = "https://partner.steamgames.com/";
+export declare function portalDir(baseDir?: string): string;
+export declare function isValveUrl(url: string): boolean;
+/** The system Chrome binary for this OS, or null when none is installed where Chrome installs. */
+export declare function findChromeExecutable(env?: Record<string, string | undefined>): string | null;
+export interface OpenResult {
+    reused: boolean;
+    port: number;
+}
+/** Start the Steamworks window, or reuse the one already open. */
+export declare function openPortal(options?: {
+    url?: string;
+    dir?: string;
+}): Promise<OpenResult>;
+/** Disconnect from the window without closing it. */
+export declare function detach(browser: Browser): Promise<void>;
+/** Attach to the open window and pick the tab to work in: the newest Valve tab, else any tab. */
+export declare function attachPortal(options?: {
+    dir?: string;
+}): Promise<{
+    browser: Browser;
+    page: Page;
+}>;
+/** Close the window and forget the session. The profile (and its login) stays for next time. */
+export declare function closePortal(options?: {
+    dir?: string;
+}): Promise<boolean>;
+export interface PageElement {
+    ref: string;
+    role: string;
+    label: string;
+    value?: string;
+    checked?: boolean;
+    disabled?: boolean;
+}
+export interface PageLook {
+    url: string;
+    title: string;
+    loggedIn: boolean;
+    headings: string[];
+    elements: PageElement[];
+    /** Status and error banners the page is showing, verbatim. */
+    notices: string[];
+}
+export declare function lookAtPage(page: Page): Promise<PageLook>;
+/** The visible text of the page, for reading what it says. */
+export declare function pageText(page: Page, maxChars?: number): Promise<string>;
+export declare function isCommittingLabel(label: string): boolean;
+export declare function resolveRef(page: Page, ref: string): Promise<Locator>;
+export declare function clickElement(page: Page, ref: string, options?: {
+    approved?: boolean;
+}): Promise<string>;
+export declare function fillElement(page: Page, ref: string, value: string): Promise<void>;
+export declare function uploadToElement(page: Page, ref: string, files: readonly string[]): Promise<void>;
+export declare function selectOption(page: Page, ref: string, option: string): Promise<string[]>;
+export declare function setChecked(page: Page, ref: string, checked: boolean): Promise<void>;
+export declare function gotoUrl(page: Page, url: string): Promise<void>;