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

package/dist/steam/portal.js

@@ -0,0 +1,340 @@
+/**
+ * The Steamworks website, driven in a Chrome window the creator logs in to.
+ *
+ * Valve has no API for store pages, graphical assets or most app settings — only the website. So
+ * `bitmagic steam portal open` starts the creator's own Chrome on a dedicated profile under
+ * `~/.bitmagic/steam-portal/` (their everyday profile is never touched), the CREATOR logs in
+ * there, and every later `steam portal` command attaches to that same window over the DevTools
+ * protocol to look at the page, fill a field, upload a file or click a button. The window outlives
+ * each command, so a login lasts across a whole session, and the profile keeps it between them.
+ *
+ * Two lines this module will not cross, whatever the caller asks:
+ *  - credentials: it never types into a password field or a login page — logging in, Steam Guard
+ *    codes and payment are the creator's;
+ *  - commitments: a click on a button that submits for review, publishes, releases, pays or
+ *    deletes is refused unless the caller passes `approved`, which the skill reserves for after
+ *    the creator has said yes to that specific step.
+ *
+ * Navigation is limited to Valve's own sites.
+ */
+import { spawn } from 'child_process';
+import * as fs from 'fs';
+import * as os from 'os';
+import * as path from 'path';
+import { chromium } from 'playwright-core';
+import { readJsonFile, writeJsonAtomic } from '../atomic-json.js';
+import { CliError } from '../errors.js';
+export const STEAMWORKS_HOME = 'https://partner.steamgames.com/';
+const VALVE_HOSTS = [
+    'partner.steamgames.com',
+    'store.steampowered.com',
+    'steamcommunity.com',
+    'help.steampowered.com',
+    'login.steampowered.com',
+    'checkout.steampowered.com',
+];
+export function portalDir(baseDir = path.join(os.homedir(), '.bitmagic')) {
+    return path.join(baseDir, 'steam-portal');
+}
+function sessionPath(dir) {
+    return path.join(dir, 'session.json');
+}
+function readSession(dir) {
+    const parsed = readJsonFile(sessionPath(dir));
+    if (parsed === null || typeof parsed.port !== 'number' || typeof parsed.pid !== 'number')
+        return null;
+    return { port: parsed.port, pid: parsed.pid, startedAt: String(parsed.startedAt ?? '') };
+}
+export function isValveUrl(url) {
+    try {
+        const host = new URL(url).hostname;
+        return VALVE_HOSTS.some((allowed) => host === allowed || host.endsWith(`.${allowed}`));
+    }
+    catch {
+        return false;
+    }
+}
+/** The system Chrome binary for this OS, or null when none is installed where Chrome installs. */
+export function findChromeExecutable(env = process.env) {
+    const candidates = [];
+    if (process.platform === 'darwin') {
+        candidates.push('/Applications/Google Chrome.app/Contents/MacOS/Google Chrome');
+        candidates.push(path.join(os.homedir(), 'Applications/Google Chrome.app/Contents/MacOS/Google Chrome'));
+    }
+    else if (process.platform === 'win32') {
+        for (const base of [env.PROGRAMFILES, env['PROGRAMFILES(X86)'], env.LOCALAPPDATA]) {
+            if (base)
+                candidates.push(path.join(base, 'Google', 'Chrome', 'Application', 'chrome.exe'));
+        }
+    }
+    else {
+        candidates.push('/usr/bin/google-chrome', '/usr/bin/google-chrome-stable', '/opt/google/chrome/chrome');
+    }
+    return candidates.find((candidate) => fs.existsSync(candidate)) ?? null;
+}
+async function endpointAlive(port) {
+    try {
+        const response = await fetch(`http://127.0.0.1:${port}/json/version`, { signal: AbortSignal.timeout(1500) });
+        return response.ok;
+    }
+    catch {
+        return false;
+    }
+}
+/** Chrome writes the port it chose for `--remote-debugging-port=0` into this file. */
+async function waitForDevToolsPort(profileDir, timeoutMs) {
+    const file = path.join(profileDir, 'DevToolsActivePort');
+    const deadline = Date.now() + timeoutMs;
+    while (Date.now() < deadline) {
+        try {
+            const port = Number(fs.readFileSync(file, 'utf-8').split('\n')[0]);
+            if (Number.isInteger(port) && port > 0 && await endpointAlive(port))
+                return port;
+        }
+        catch {
+            // Not written yet.
+        }
+        await new Promise((resolve) => setTimeout(resolve, 250));
+    }
+    throw new CliError('Chrome started but did not open its DevTools port. Close any Chrome window using the Steam profile and try again.');
+}
+/** Start the Steamworks window, or reuse the one already open. */
+export async function openPortal(options = {}) {
+    const dir = options.dir ?? portalDir();
+    const existing = readSession(dir);
+    if (existing !== null && await endpointAlive(existing.port)) {
+        if (options.url !== undefined) {
+            const { browser, page } = await attachPortal({ dir });
+            try {
+                await page.goto(options.url, { waitUntil: 'domcontentloaded' });
+                await page.bringToFront();
+            }
+            finally {
+                await detach(browser);
+            }
+        }
+        return { reused: true, port: existing.port };
+    }
+    const chrome = findChromeExecutable();
+    if (chrome === null) {
+        throw new CliError('`bitmagic steam portal` drives Google Chrome, and none is installed. Install it from https://www.google.com/chrome/.', 3);
+    }
+    const profileDir = path.join(dir, 'profile');
+    fs.mkdirSync(profileDir, { recursive: true });
+    fs.rmSync(path.join(profileDir, 'DevToolsActivePort'), { force: true });
+    const child = spawn(chrome, [
+        `--user-data-dir=${profileDir}`,
+        '--remote-debugging-port=0',
+        '--remote-debugging-address=127.0.0.1',
+        '--no-first-run',
+        '--no-default-browser-check',
+        '--disable-features=ChromeWhatsNewUI',
+        options.url ?? STEAMWORKS_HOME,
+    ], { detached: true, stdio: 'ignore' });
+    child.unref();
+    const port = await waitForDevToolsPort(profileDir, 20_000);
+    writeJsonAtomic(sessionPath(dir), { port, pid: child.pid ?? 0, startedAt: new Date().toISOString() });
+    return { reused: false, port };
+}
+/** Disconnect from the window without closing it. */
+export async function detach(browser) {
+    try {
+        await browser.close();
+    }
+    catch {
+        // Already gone.
+    }
+}
+/** Attach to the open window and pick the tab to work in: the newest Valve tab, else any tab. */
+export async function attachPortal(options = {}) {
+    const dir = options.dir ?? portalDir();
+    const session = readSession(dir);
+    if (session === null || !await endpointAlive(session.port)) {
+        throw new CliError('No Steamworks window is open. Run `bitmagic steam portal open` and log in there.', 3);
+    }
+    const browser = await chromium.connectOverCDP(`http://127.0.0.1:${session.port}`);
+    const context = browser.contexts()[0];
+    const pages = (context?.pages() ?? []).filter((page) => !page.url().startsWith('devtools://'));
+    const valve = pages.filter((page) => isValveUrl(page.url()));
+    const page = valve[valve.length - 1] ?? pages[pages.length - 1] ?? await context?.newPage();
+    if (page === undefined) {
+        await detach(browser);
+        throw new CliError('The Steamworks window has no tab to work in.');
+    }
+    return { browser, page };
+}
+/** Close the window and forget the session. The profile (and its login) stays for next time. */
+export async function closePortal(options = {}) {
+    const dir = options.dir ?? portalDir();
+    const session = readSession(dir);
+    fs.rmSync(sessionPath(dir), { force: true });
+    if (session === null || !await endpointAlive(session.port))
+        return false;
+    const browser = await chromium.connectOverCDP(`http://127.0.0.1:${session.port}`);
+    try {
+        const cdp = await browser.newBrowserCDPSession();
+        await cdp.send('Browser.close');
+    }
+    catch {
+        // Closing tears the connection down under us.
+    }
+    return true;
+}
+/**
+ * Number every control on the page (`data-bm-ref`), and describe each the way a person would
+ * name it — its label, the table row it sits in, its placeholder, its name. Runs in the page.
+ */
+const LOOK_SCRIPT = `(() => {
+  const clean = (s) => (s || '').replace(/\\s+/g, ' ').trim();
+  const short = (s, n) => { s = clean(s); return s.length > n ? s.slice(0, n - 1) + '…' : s; };
+  const visible = (el) => {
+    const r = el.getBoundingClientRect();
+    const cs = getComputedStyle(el);
+    return r.width > 0 && r.height > 0 && cs.visibility !== 'hidden' && cs.display !== 'none';
+  };
+  const labelOf = (el) => {
+    const aria = el.getAttribute('aria-label');
+    if (aria) return aria;
+    const by = el.getAttribute('aria-labelledby');
+    if (by) { const t = by.split(' ').map((id) => document.getElementById(id)?.innerText || '').join(' '); if (clean(t)) return t; }
+    if (el.labels && el.labels.length) return Array.from(el.labels).map((l) => l.innerText).join(' ');
+    const tag = el.tagName.toLowerCase();
+    if (tag === 'button' || tag === 'a' || el.getAttribute('role') === 'button' || el.getAttribute('role') === 'tab') {
+      const t = el.innerText || el.value || el.title || el.getAttribute('alt');
+      if (clean(t)) return t;
+      const img = el.querySelector('img[alt]');
+      if (img) return img.getAttribute('alt');
+    }
+    if (el.placeholder) return el.placeholder;
+    const row = el.closest('tr');
+    if (row && row.cells && row.cells.length > 1 && !row.cells[0].contains(el)) return row.cells[0].innerText;
+    let prev = el.previousElementSibling;
+    for (let i = 0; prev && i < 3; i++, prev = prev.previousElementSibling) { if (clean(prev.innerText)) return prev.innerText; }
+    const parentText = el.parentElement ? clean(el.parentElement.innerText) : '';
+    if (parentText && parentText.length < 120) return parentText;
+    return el.name || el.id || el.title || '';
+  };
+  document.querySelectorAll('[data-bm-ref]').forEach((el) => el.removeAttribute('data-bm-ref'));
+  const out = [];
+  let n = 0;
+  const selector = 'a[href], button, input, textarea, select, [role=button], [role=checkbox], [role=tab], [role=menuitem], [contenteditable="true"]';
+  for (const el of document.querySelectorAll(selector)) {
+    const tag = el.tagName.toLowerCase();
+    const type = (el.getAttribute('type') || '').toLowerCase();
+    if (type === 'hidden') continue;
+    if (!visible(el) && type !== 'file') continue;
+    const ref = 'e' + (++n);
+    el.setAttribute('data-bm-ref', ref);
+    const role = tag === 'input' ? (type || 'text') : tag === 'a' ? 'link' : (el.getAttribute('role') || tag);
+    const entry = { ref, role, label: short(labelOf(el), 90) };
+    if (role === 'link' && !entry.label) { el.removeAttribute('data-bm-ref'); n--; continue; }
+    if (el.name) entry.label += entry.label ? ' [' + el.name + ']' : el.name;
+    if (tag === 'textarea' || (tag === 'input' && !['checkbox', 'radio', 'file', 'submit', 'button', 'image'].includes(type))) entry.value = short(el.value, 120);
+    if (tag === 'select') entry.value = short(el.selectedOptions && el.selectedOptions[0] ? el.selectedOptions[0].text : '', 80);
+    if (type === 'checkbox' || type === 'radio') entry.checked = el.checked;
+    if (el.getAttribute('role') === 'checkbox') entry.checked = el.getAttribute('aria-checked') === 'true';
+    if (el.disabled) entry.disabled = true;
+    out.push(entry);
+    if (n >= 600) break;
+  }
+  const headings = Array.from(document.querySelectorAll('h1, h2, h3')).filter(visible).map((h) => short(h.innerText, 100)).filter(Boolean).slice(0, 60);
+  const notices = Array.from(document.querySelectorAll('.error, .errors, .warning, .notice, .success, [role=alert], .formErrors, .msg')).filter(visible).map((e) => short(e.innerText, 300)).filter(Boolean).slice(0, 12);
+  const loggedIn = !!document.querySelector('a[href*="logout"], a[href*="Logout"], form[action*="logout"]');
+  return { url: location.href, title: document.title, headings, elements: out, notices, loggedIn };
+})()`;
+export async function lookAtPage(page) {
+    await page.waitForLoadState('domcontentloaded');
+    return page.evaluate(LOOK_SCRIPT);
+}
+/** The visible text of the page, for reading what it says. */
+export async function pageText(page, maxChars = 20_000) {
+    const text = await page.evaluate('document.body ? document.body.innerText : ""');
+    return text.length > maxChars ? `${text.slice(0, maxChars)}\n…` : text;
+}
+// ============================================================================
+// Acting on it
+// ============================================================================
+/**
+ * Button text that commits the creator to something: a review submission, a publish, a release, a
+ * payment, a deletion. Matched on the element's own label.
+ */
+const COMMITTING = /\b(submit|publish|release|purchase|pay|buy|checkout|delete|remove|retire|set build live|mark as ready|ready for review|agree|accept)\b/i;
+export function isCommittingLabel(label) {
+    return COMMITTING.test(label);
+}
+function isLoginUrl(url) {
+    return /\/login\b|\/signin\b|openid|\/twofactor/i.test(url);
+}
+export async function resolveRef(page, ref) {
+    if (!/^e\d+$/.test(ref))
+        throw new CliError(`"${ref}" is not an element ref — run \`bitmagic steam portal look\` and use one of its e-numbers.`);
+    const locator = page.locator(`[data-bm-ref="${ref}"]`);
+    if (await locator.count() === 0) {
+        throw new CliError(`${ref} is not on the page any more (it changed since the last look). Run \`bitmagic steam portal look\` again.`);
+    }
+    return locator.first();
+}
+async function labelOfLocator(locator) {
+    return locator.evaluate((el) => {
+        const e = el;
+        return [e.innerText, e.getAttribute('aria-label'), e.value, e.getAttribute('title')].filter(Boolean).join(' ');
+    });
+}
+export async function clickElement(page, ref, options = {}) {
+    const locator = await resolveRef(page, ref);
+    const label = (await labelOfLocator(locator)).replace(/\s+/g, ' ').trim();
+    if (isCommittingLabel(label) && options.approved !== true) {
+        throw new CliError(`"${label}" commits the creator to something (a submission, a publish, a payment or a deletion). `
+            + 'Ask the creator, and only after they say yes to this exact step run the click again with --approved.', 6);
+    }
+    await locator.scrollIntoViewIfNeeded();
+    await locator.click();
+    await page.waitForLoadState('domcontentloaded').catch(() => undefined);
+    return label;
+}
+export async function fillElement(page, ref, value) {
+    if (isLoginUrl(page.url())) {
+        throw new CliError('This is a login page. Logging in is the creator\'s to do, in the window — nothing is typed here.', 6);
+    }
+    const locator = await resolveRef(page, ref);
+    const type = (await locator.getAttribute('type'))?.toLowerCase();
+    if (type === 'password') {
+        throw new CliError('That is a password field. Passwords are the creator\'s to type, never the agent\'s.', 6);
+    }
+    await locator.scrollIntoViewIfNeeded();
+    const editable = await locator.getAttribute('contenteditable');
+    if (editable === 'true') {
+        await locator.click();
+        await page.keyboard.press(process.platform === 'darwin' ? 'Meta+A' : 'Control+A');
+        await page.keyboard.insertText(value);
+    }
+    else {
+        await locator.fill(value);
+    }
+}
+export async function uploadToElement(page, ref, files) {
+    const locator = await resolveRef(page, ref);
+    if ((await locator.getAttribute('type'))?.toLowerCase() !== 'file') {
+        throw new CliError(`${ref} is not a file input. \`look\` lists file inputs with role "file".`);
+    }
+    for (const file of files) {
+        if (!fs.existsSync(file))
+            throw new CliError(`No file at ${file}.`);
+    }
+    await locator.setInputFiles([...files]);
+}
+export async function selectOption(page, ref, option) {
+    const locator = await resolveRef(page, ref);
+    return locator.selectOption({ label: option }).catch(() => locator.selectOption(option));
+}
+export async function setChecked(page, ref, checked) {
+    const locator = await resolveRef(page, ref);
+    await locator.setChecked(checked);
+}
+export async function gotoUrl(page, url) {
+    const target = /^https?:\/\//.test(url) ? url : new URL(url.replace(/^\//, ''), STEAMWORKS_HOME).toString();
+    if (!isValveUrl(target))
+        throw new CliError(`${target} is not a Valve site; the Steamworks window only goes to Steamworks and the Steam store.`);
+    await page.goto(target, { waitUntil: 'domcontentloaded' });
+}
+//# sourceMappingURL=portal.js.map

package/dist/steam/portal.js.map

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

package/dist/steam/raster.d.ts

@@ -0,0 +1,58 @@
+import type { SizedPng } from './icon-files.js';
+export declare function dataUrlFor(bytes: Buffer): string;
+export interface KeyOptions {
+    /** The background colour to remove, `#rrggbb`; `auto` reads it off the image's border. */
+    keyColor: string;
+    /** Colour distance (0-441) at or below which a pixel is fully transparent. */
+    tolerance: number;
+    /** Width of the soft edge above `tolerance`, in the same units. */
+    softness: number;
+}
+export interface KeyedImage {
+    png: Buffer;
+    width: number;
+    height: number;
+    /** The colour actually removed, `#rrggbb`. */
+    keyColor: string;
+}
+export declare class RasterSession {
+    private readonly browser;
+    private readonly page;
+    private constructor();
+    static open(command: string): Promise<RasterSession>;
+    close(): Promise<void>;
+    /**
+     * Lay `html` out at exactly `width`x`height` CSS pixels and capture it. `transparent` keeps the
+     * page background clear (the library logo); otherwise the page paints black under the art.
+     */
+    render(html: string, width: number, height: number, options?: {
+        transparent?: boolean;
+        format?: 'png' | 'jpeg';
+    }): Promise<Buffer>;
+    /** Decode any supported image and re-encode it as PNG, with its size. */
+    toPng(bytes: Buffer): Promise<{
+        png: Buffer;
+        width: number;
+        height: number;
+    }>;
+    /**
+     * Remove a flat background colour and trim to what is left, plus `pad` pixels. Partially
+     * keyed edge pixels are un-mixed from the key colour (c = (observed - (1-a)·key) / a), so an
+     * anti-aliased outline keeps its own colour instead of a green or magenta fringe.
+     */
+    keyAndTrim(bytes: Buffer, options: KeyOptions & {
+        pad?: number;
+    }): Promise<KeyedImage>;
+    /** Trim fully transparent margins off a PNG, keeping `pad` pixels. */
+    trimTransparent(png: Buffer, pad?: number): Promise<{
+        png: Buffer;
+        width: number;
+        height: number;
+    }>;
+    /**
+     * Square PNGs of `bytes` at each size, cover-cropped to the centre (or to `focus`, as fractions).
+     * Downscaling halves step by step before the last draw — one big drawImage from 1024 to 16 would
+     * alias badly even with high-quality smoothing.
+     */
+    squareIcons(bytes: Buffer, sizes: readonly number[], focus?: readonly [number, number]): Promise<SizedPng[]>;
+}