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

package/dist/steam/art.js

@@ -0,0 +1,243 @@
+/**
+ * `.bitmagic/steam/art.json` — which pictures the store kit is cut from, and how each capsule is
+ * laid out: where the crop sits, where the logo goes and how big it is, how much the art is
+ * darkened behind it.
+ *
+ * The agent is the art director here. `steam art render` draws every asset from this file, the
+ * agent LOOKS at the results, edits a layout and renders again — so every knob is a plain number
+ * with a default that suits a typical key art, and nothing about a layout is hidden in code.
+ *
+ * Pure: reading, defaulting and composing HTML. Rendering lives in art-render.ts.
+ */
+import * as fs from 'fs';
+import * as path from 'path';
+import { readJsonFile, writeJsonAtomic } from '../atomic-json.js';
+import { CliError } from '../errors.js';
+import { STORE_IMAGE_SPECS } from './specs.js';
+export const SOURCE_NAMES = ['wide', 'tall', 'hero', 'logo', 'icon'];
+/** Where each source lands when a candidate is chosen, relative to `.bitmagic/steam/`. */
+export const DEFAULT_SOURCE_FILES = {
+    wide: 'art/keyart-wide.png',
+    tall: 'art/keyart-tall.png',
+    hero: 'art/keyart-hero.png',
+    logo: 'art/logo.png',
+    icon: 'art/icon.png',
+};
+/**
+ * Defaults per asset, tuned for a key art with its subject near the centre. The small capsule's
+ * logo nearly fills it because Valve asks for exactly that (it is shown as small as 120x45); the
+ * tall capsules put the logo where the art is usually emptiest — sky above, ground below.
+ */
+export const DEFAULT_LAYOUTS = {
+    header_capsule: {
+        focus: [0.5, 0.45], zoom: 1, logo: { x: 0.5, y: 0.5, width: 0.62, maxHeight: 0.62 },
+        scrim: 'radial', scrimStrength: 0.35, dim: 0, blur: 0,
+    },
+    small_capsule: {
+        focus: [0.5, 0.5], zoom: 1, logo: { x: 0.5, y: 0.5, width: 0.9, maxHeight: 0.84 },
+        scrim: 'radial', scrimStrength: 0.45, dim: 0.1, blur: 0,
+    },
+    main_capsule: {
+        focus: [0.5, 0.5], zoom: 1, logo: { x: 0.5, y: 0.8, width: 0.5, maxHeight: 0.34 },
+        scrim: 'bottom', scrimStrength: 0.55, dim: 0, blur: 0,
+    },
+    vertical_capsule: {
+        focus: [0.5, 0.45], zoom: 1, logo: { x: 0.5, y: 0.16, width: 0.86, maxHeight: 0.26 },
+        scrim: 'top', scrimStrength: 0.45, dim: 0, blur: 0,
+    },
+    page_background: {
+        focus: [0.5, 0.5], zoom: 1.04, logo: null,
+        scrim: 'none', scrimStrength: 0, dim: 0.45, blur: 3,
+    },
+    library_capsule: {
+        focus: [0.5, 0.45], zoom: 1, logo: { x: 0.5, y: 0.84, width: 0.86, maxHeight: 0.24 },
+        scrim: 'bottom', scrimStrength: 0.55, dim: 0, blur: 0,
+    },
+    library_header: {
+        focus: [0.5, 0.45], zoom: 1, logo: { x: 0.5, y: 0.5, width: 0.62, maxHeight: 0.62 },
+        scrim: 'radial', scrimStrength: 0.35, dim: 0, blur: 0,
+    },
+    library_hero: {
+        focus: [0.5, 0.5], zoom: 1, logo: null,
+        scrim: 'none', scrimStrength: 0, dim: 0, blur: 0,
+    },
+    app_icon: {
+        focus: [0.5, 0.5], zoom: 1, logo: null,
+        scrim: 'none', scrimStrength: 0, dim: 0, blur: 0,
+    },
+    shortcut_icon: {
+        focus: [0.5, 0.5], zoom: 1, logo: null,
+        scrim: 'none', scrimStrength: 0, dim: 0, blur: 0,
+    },
+};
+function num(value, fallback, min, max) {
+    return typeof value === 'number' && Number.isFinite(value) ? Math.min(max, Math.max(min, value)) : fallback;
+}
+function readLogo(value, fallback) {
+    if (value === null)
+        return null;
+    if (typeof value !== 'object')
+        return fallback;
+    const record = value;
+    const base = fallback ?? { x: 0.5, y: 0.5, width: 0.6, maxHeight: 0.5 };
+    return {
+        x: num(record.x, base.x, 0, 1),
+        y: num(record.y, base.y, 0, 1),
+        width: num(record.width, base.width, 0.05, 1),
+        maxHeight: num(record.maxHeight, base.maxHeight, 0.05, 1),
+    };
+}
+const SCRIMS = ['none', 'bottom', 'top', 'left', 'right', 'radial'];
+const ART_SOURCES = ['wide', 'tall', 'hero', 'icon'];
+/** One asset's layout: the file's fields over the default, each clamped to a sane range. */
+export function readLayout(id, value) {
+    const base = DEFAULT_LAYOUTS[id];
+    if (base === undefined)
+        throw new CliError(`art.json has a layout for "${id}", which is not a Steam asset.`);
+    if (typeof value !== 'object' || value === null)
+        return base;
+    const record = value;
+    const focus = Array.isArray(record.focus) && record.focus.length === 2
+        ? [num(record.focus[0], base.focus[0], 0, 1), num(record.focus[1], base.focus[1], 0, 1)]
+        : base.focus;
+    const source = typeof record.source === 'string' && ART_SOURCES.includes(record.source)
+        ? record.source
+        : base.source;
+    return {
+        ...(source !== undefined ? { source } : {}),
+        focus,
+        zoom: num(record.zoom, base.zoom, 1, 4),
+        logo: 'logo' in record ? readLogo(record.logo, base.logo) : base.logo,
+        scrim: typeof record.scrim === 'string' && SCRIMS.includes(record.scrim) ? record.scrim : base.scrim,
+        scrimStrength: num(record.scrimStrength, base.scrimStrength, 0, 1),
+        dim: num(record.dim, base.dim, 0, 1),
+        blur: num(record.blur, base.blur, 0, 40),
+    };
+}
+export function readArtConfig(file) {
+    const parsed = readJsonFile(file);
+    const record = typeof parsed === 'object' && parsed !== null ? parsed : {};
+    const sourcesRaw = typeof record.sources === 'object' && record.sources !== null
+        ? record.sources
+        : {};
+    const sources = {};
+    for (const name of SOURCE_NAMES) {
+        const value = sourcesRaw[name];
+        if (typeof value === 'string' && value.trim() !== '')
+            sources[name] = value.trim();
+    }
+    const layoutsRaw = typeof record.layouts === 'object' && record.layouts !== null
+        ? record.layouts
+        : {};
+    const layouts = {};
+    for (const spec of STORE_IMAGE_SPECS) {
+        if (spec.logo === 'only')
+            continue;
+        layouts[spec.id] = readLayout(spec.id, layoutsRaw[spec.id]);
+    }
+    for (const id of Object.keys(layoutsRaw)) {
+        if (layouts[id] === undefined)
+            throw new CliError(`art.json has a layout for "${id}", which is not a Steam asset.`);
+    }
+    return { sources, layouts };
+}
+/** Write the file with every layout spelled out, so the agent sees every knob it can turn. */
+export function writeArtConfig(file, config) {
+    writeJsonAtomic(file, config);
+}
+/** Record `relPath` as the `name` source, keeping everything else in the file. */
+export function setArtSource(file, name, relPath) {
+    const config = readArtConfig(file);
+    config.sources[name] = relPath;
+    writeArtConfig(file, config);
+    return config;
+}
+/** The absolute path of a source, or null when art.json names none or the file is gone. */
+export function resolveSource(steamDir, config, name) {
+    const rel = config.sources[name];
+    if (rel === undefined)
+        return null;
+    const abs = path.resolve(steamDir, rel);
+    return fs.existsSync(abs) ? abs : null;
+}
+/** Where the logo lands on a `width`x`height` canvas, keeping its aspect inside both limits. */
+export function placeLogo(placement, canvas, logo) {
+    const aspect = logo.width / logo.height;
+    let w = placement.width * canvas.width;
+    let h = w / aspect;
+    const maxH = placement.maxHeight * canvas.height;
+    if (h > maxH) {
+        h = maxH;
+        w = h * aspect;
+    }
+    return {
+        left: Math.round(placement.x * canvas.width - w / 2),
+        top: Math.round(placement.y * canvas.height - h / 2),
+        width: Math.round(w),
+        height: Math.round(h),
+    };
+}
+function scrimCss(layout, logo, canvas) {
+    const s = layout.scrimStrength;
+    const dark = `rgba(0,0,0,${s.toFixed(3)})`;
+    switch (layout.scrim) {
+        case 'bottom': return `linear-gradient(to top, ${dark} 0%, rgba(0,0,0,0) 60%)`;
+        case 'top': return `linear-gradient(to bottom, ${dark} 0%, rgba(0,0,0,0) 60%)`;
+        case 'left': return `linear-gradient(to right, ${dark} 0%, rgba(0,0,0,0) 60%)`;
+        case 'right': return `linear-gradient(to left, ${dark} 0%, rgba(0,0,0,0) 60%)`;
+        case 'radial': {
+            const cx = logo ? ((logo.left + logo.width / 2) / canvas.width) * 100 : 50;
+            const cy = logo ? ((logo.top + logo.height / 2) / canvas.height) * 100 : 50;
+            return `radial-gradient(ellipse at ${cx.toFixed(1)}% ${cy.toFixed(1)}%, ${dark} 0%, rgba(0,0,0,0) 65%)`;
+        }
+        case 'none': return 'none';
+    }
+}
+/**
+ * The page that draws one asset. Images arrive as data URLs; `logo` is null for assets that must
+ * carry none (the hero, the background, the icons).
+ */
+export function assetHtml(options) {
+    const { spec, layout } = options;
+    const canvas = { width: spec.width, height: spec.height };
+    const placed = layout.logo !== null && options.logo !== null
+        ? placeLogo(layout.logo, canvas, options.logo)
+        : null;
+    const fx = (layout.focus[0] * 100).toFixed(2);
+    const fy = (layout.focus[1] * 100).toFixed(2);
+    // Blur pulls transparent black in from outside the box; a hair of extra zoom hides that rim.
+    const zoom = layout.blur > 0 ? Math.max(layout.zoom, 1 + (layout.blur * 4) / Math.min(spec.width, spec.height)) : layout.zoom;
+    const shadow = Math.max(2, Math.round(Math.min(spec.width, spec.height) / 60));
+    return `<!doctype html><html><head><meta charset="utf-8"><style>
+html,body{margin:0;padding:0;width:${spec.width}px;height:${spec.height}px;overflow:hidden;background:#000}
+.art{position:absolute;inset:0;background:url("${options.artUrl}") ${fx}% ${fy}% / cover no-repeat;transform:scale(${zoom.toFixed(4)});transform-origin:${fx}% ${fy}%;${layout.blur > 0 ? `filter:blur(${layout.blur}px);` : ''}}
+.dim{position:absolute;inset:0;background:rgba(0,0,0,${layout.dim.toFixed(3)})}
+.scrim{position:absolute;inset:0;background:${scrimCss(layout, placed, canvas)}}
+.logo{position:absolute;filter:drop-shadow(0 ${Math.round(shadow / 2)}px ${shadow}px rgba(0,0,0,0.55))}
+</style></head><body>
+<div class="art"></div>
+${layout.dim > 0 ? '<div class="dim"></div>' : ''}
+${layout.scrim !== 'none' ? '<div class="scrim"></div>' : ''}
+${placed !== null && options.logo !== null
+        ? `<img class="logo" src="${options.logo.url}" style="left:${placed.left}px;top:${placed.top}px;width:${placed.width}px;height:${placed.height}px">`
+        : ''}
+</body></html>`;
+}
+/**
+ * The library logo: the logo alone, transparent, scaled to touch the 1280x720 box on one side —
+ * "1280 px wide and/or 720 px tall", in Valve's words — with its own aspect kept.
+ */
+export function libraryLogoSize(logo, box) {
+    const aspect = logo.width / logo.height;
+    if (aspect >= box.width / box.height) {
+        return { width: box.width, height: Math.max(1, Math.round(box.width / aspect)) };
+    }
+    return { width: Math.max(1, Math.round(box.height * aspect)), height: box.height };
+}
+export function logoOnlyHtml(logoUrl, size) {
+    return `<!doctype html><html><head><meta charset="utf-8"><style>
+html,body{margin:0;padding:0;width:${size.width}px;height:${size.height}px;overflow:hidden;background:transparent}
+img{display:block;width:${size.width}px;height:${size.height}px}
+</style></head><body><img src="${logoUrl}"></body></html>`;
+}
+//# sourceMappingURL=art.js.map

package/dist/steam/art.js.map

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

package/dist/steam/check.d.ts

@@ -0,0 +1,21 @@
+import type { SteamPaths } from './paths.js';
+import { type SteamImageSpec } from './specs.js';
+export interface KitFinding {
+    level: 'error' | 'warning';
+    area: 'copy' | 'images' | 'screenshots' | 'trailer';
+    message: string;
+}
+export interface KitCheck {
+    ok: boolean;
+    findings: KitFinding[];
+    screenshots: string[];
+    trailer: string | null;
+}
+/** One image against its spec. Pure apart from the read. */
+export declare function checkImage(spec: SteamImageSpec, file: string): string[];
+export declare function listScreenshots(paths: SteamPaths): string[];
+export declare function findTrailer(paths: SteamPaths): string | null;
+export declare function checkKit(options: {
+    paths: SteamPaths;
+    knownTags: ReadonlySet<string> | null;
+}): Promise<KitCheck>;

package/dist/steam/check.js

@@ -0,0 +1,113 @@
+/**
+ * `bitmagic steam check` — everything Steamworks will ask for, held to Valve's rules before anyone
+ * uploads it: the store copy, every image at its exact size, the screenshots, the trailer.
+ * Errors are what blocks a review; warnings are what a reviewer or a player would notice.
+ */
+import * as fs from 'fs';
+import * as path from 'path';
+import { readImageInfo } from './image-info.js';
+import { probeVideo } from './media.js';
+import { LIBRARY_LOGO_BOX, MAC_ICNS_FILE, MIN_SCREENSHOTS, SCREENSHOT_HEIGHT, SCREENSHOT_WIDTH, SHORTCUT_ICO_FILE, STORE_IMAGE_SPECS, } from './specs.js';
+import { checkStoreCopy, readStoreCopy } from './store-copy.js';
+import { trailerProblems } from './trailer.js';
+/** One image against its spec. Pure apart from the read. */
+export function checkImage(spec, file) {
+    if (!fs.existsSync(file))
+        return [spec.required ? 'missing' : 'missing (optional)'];
+    const info = readImageInfo(fs.readFileSync(file));
+    if (info === null)
+        return ['not a PNG or JPEG file'];
+    const problems = [];
+    if (info.format !== spec.format)
+        problems.push(`is ${info.format}, Steam wants ${spec.format}`);
+    if (spec.logo === 'only') {
+        const touchesBox = (info.width === LIBRARY_LOGO_BOX.width && info.height <= LIBRARY_LOGO_BOX.height)
+            || (info.height === LIBRARY_LOGO_BOX.height && info.width <= LIBRARY_LOGO_BOX.width);
+        if (!touchesBox)
+            problems.push(`is ${info.width}x${info.height}; it must be 1280 wide and/or 720 tall`);
+        if (!info.alpha)
+            problems.push('has no transparency');
+    }
+    else if (info.width !== spec.width || info.height !== spec.height) {
+        problems.push(`is ${info.width}x${info.height}, Steam wants exactly ${spec.width}x${spec.height}`);
+    }
+    return problems;
+}
+export function listScreenshots(paths) {
+    if (!fs.existsSync(paths.screenshotsDir))
+        return [];
+    return fs.readdirSync(paths.screenshotsDir)
+        .filter((name) => /\.(png|jpe?g)$/i.test(name))
+        .sort()
+        .map((name) => path.join(paths.screenshotsDir, name));
+}
+export function findTrailer(paths) {
+    if (!fs.existsSync(paths.trailerDir))
+        return null;
+    const videos = fs.readdirSync(paths.trailerDir)
+        .filter((name) => /\.(mp4|mov|wmv)$/i.test(name))
+        .map((name) => path.join(paths.trailerDir, name))
+        .sort((a, b) => fs.statSync(b).mtimeMs - fs.statSync(a).mtimeMs);
+    return videos[0] ?? null;
+}
+export async function checkKit(options) {
+    const { paths } = options;
+    const findings = [];
+    const copy = readStoreCopy(paths.storePath);
+    if (copy === null) {
+        findings.push({ level: 'error', area: 'copy', message: `No store copy at ${paths.storePath} — run \`bitmagic steam init\`.` });
+    }
+    else {
+        for (const finding of checkStoreCopy(copy, options.knownTags)) {
+            findings.push({ level: finding.level, area: 'copy', message: `${finding.field}: ${finding.message}` });
+        }
+    }
+    for (const spec of STORE_IMAGE_SPECS) {
+        for (const problem of checkImage(spec, path.join(paths.kitDir, spec.file))) {
+            const optional = problem === 'missing (optional)';
+            findings.push({
+                level: optional ? 'warning' : 'error',
+                area: 'images',
+                message: `${spec.file} ${problem}${problem.startsWith('missing') ? ' — `bitmagic steam art render`' : ''}`,
+            });
+        }
+    }
+    for (const rel of [SHORTCUT_ICO_FILE, MAC_ICNS_FILE]) {
+        if (!fs.existsSync(path.join(paths.kitDir, rel))) {
+            findings.push({ level: 'error', area: 'images', message: `${rel} missing — \`bitmagic steam art render\` writes it from the icon art.` });
+        }
+    }
+    const screenshots = listScreenshots(paths);
+    if (screenshots.length < MIN_SCREENSHOTS) {
+        findings.push({
+            level: 'error',
+            area: 'screenshots',
+            message: `${screenshots.length} screenshot(s); Steam needs at least ${MIN_SCREENSHOTS} — \`bitmagic steam screenshots\`.`,
+        });
+    }
+    for (const file of screenshots) {
+        const info = readImageInfo(fs.readFileSync(file));
+        if (info === null) {
+            findings.push({ level: 'error', area: 'screenshots', message: `${path.basename(file)} is not an image.` });
+            continue;
+        }
+        if (info.width < SCREENSHOT_WIDTH || info.height < SCREENSHOT_HEIGHT || Math.abs(info.width / info.height - 16 / 9) > 0.01) {
+            findings.push({
+                level: 'error',
+                area: 'screenshots',
+                message: `${path.basename(file)} is ${info.width}x${info.height}; Steam wants 16:9 at 1920x1080 or larger.`,
+            });
+        }
+    }
+    const trailer = findTrailer(paths);
+    if (trailer === null) {
+        findings.push({ level: 'error', area: 'trailer', message: 'No trailer. Steam requires one before release — `bitmagic steam trailer`.' });
+    }
+    else {
+        for (const problem of trailerProblems(await probeVideo(trailer), trailer)) {
+            findings.push({ level: problem.level, area: 'trailer', message: `${path.basename(trailer)}: ${problem.message}` });
+        }
+    }
+    return { ok: !findings.some((finding) => finding.level === 'error'), findings, screenshots, trailer };
+}
+//# sourceMappingURL=check.js.map

package/dist/steam/check.js.map

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

package/dist/steam/config.d.ts

@@ -0,0 +1,57 @@
+export interface SteamConfigFile {
+    /** The app id Steamworks gave the game when the app credit was spent. */
+    appId?: number;
+    /** Depot ids. Steamworks creates `appId + 1` with the app; the second depot is added by hand. */
+    depots?: {
+        windows?: number;
+        macos?: number;
+    };
+    /** The Steam LOGIN NAME steamcmd uploads with. Never a password. */
+    account?: string;
+    /** Overrides game.json's gameName for the executable, window title and store copy. */
+    displayName?: string;
+    /** Shown in the .exe's version resource and the .app's CFBundleShortVersionString. */
+    version?: string;
+    /** The macOS bundle identifier; `ai.bitmagic.game.<gameid>` unless set. */
+    bundleId?: string;
+    /** codesign identity, when the keychain holds more than one Developer ID Application. */
+    macIdentity?: string;
+    /** A `notarytool store-credentials` keychain profile to notarize with, instead of an API key. */
+    notaryProfile?: string;
+}
+export interface SteamAppConfig {
+    appId?: number;
+    windowsDepot?: number;
+    macosDepot?: number;
+    account?: string;
+    /** Any unicode — the window title, the store name. */
+    displayName: string;
+    /** ASCII-safe filename for `<Game>.exe` and `<Game>.app`. */
+    productName: string;
+    version: string;
+    /** yyyyMMddHHmm, UTC — CFBundleVersion and the .exe build field; always increases. */
+    buildNumber: string;
+    bundleId: string;
+    macIdentity?: string;
+    notaryProfile?: string;
+}
+/**
+ * The executable's filename: ASCII letters, digits, space and dash, accents folded rather than
+ * dropped, at most 40 characters, never a Windows device name, never ending in a dot or dash.
+ * The same rules as the Creator's Steam export (game-play-agent name-sanitizer.ts), so a game
+ * exported from either lane ships under the same filename.
+ */
+export declare function sanitizeExecutableName(name: string, gameId: string): string;
+export declare function readSteamConfigFile(configPath: string): SteamConfigFile;
+/** Merge `patch` into the file on disk and write it back. Returns the merged file. */
+export declare function updateSteamConfigFile(configPath: string, patch: SteamConfigFile): SteamConfigFile;
+/** Parse a Steam numeric id from a flag, naming the flag when it is not one. */
+export declare function parseSteamId(flag: string, value: string | undefined): number | undefined;
+export declare function resolveSteamConfig(options: {
+    root: string;
+    gameId: string;
+    configPath: string;
+    now?: Date;
+}): SteamAppConfig;
+/** The app id, or a refusal that says where to get one. */
+export declare function requireAppId(config: SteamAppConfig): number;

package/dist/steam/config.js

@@ -0,0 +1,145 @@
+/**
+ * The game's identity on Steam: `.bitmagic/steam.json`.
+ *
+ * Everything here is an id Steamworks assigned or a name the creator chose, so it is the one file
+ * in the lane worth keeping — `steam init` writes it and every later command reads it. It never
+ * holds a password: steamcmd caches its own login (see steampipe.ts), and the builder account's
+ * NAME is all this file needs to ask it for that cached login.
+ */
+import * as fs from 'fs';
+import * as path from 'path';
+import { writeJsonAtomic, readJsonFile } from '../atomic-json.js';
+import { CliError } from '../errors.js';
+import { readGameName } from '../project/game-name.js';
+import { buildNumberNow, deriveBundleId } from '../ios/app-config.js';
+const WINDOWS_RESERVED = new Set([
+    'CON', 'PRN', 'AUX', 'NUL',
+    'COM1', 'COM2', 'COM3', 'COM4', 'COM5', 'COM6', 'COM7', 'COM8', 'COM9',
+    'LPT1', 'LPT2', 'LPT3', 'LPT4', 'LPT5', 'LPT6', 'LPT7', 'LPT8', 'LPT9',
+]);
+/**
+ * The executable's filename: ASCII letters, digits, space and dash, accents folded rather than
+ * dropped, at most 40 characters, never a Windows device name, never ending in a dot or dash.
+ * The same rules as the Creator's Steam export (game-play-agent name-sanitizer.ts), so a game
+ * exported from either lane ships under the same filename.
+ */
+export function sanitizeExecutableName(name, gameId) {
+    const cleaned = name
+        .normalize('NFKD')
+        .replace(/[̀-ͯ]/g, '')
+        .replace(/[^A-Za-z0-9 -]/g, ' ')
+        .replace(/\s+/g, ' ')
+        .trim()
+        .slice(0, 40)
+        .trim()
+        .replace(/[.-]+$/, '')
+        .trim();
+    if (cleaned.length === 0 || WINDOWS_RESERVED.has(cleaned.toUpperCase())) {
+        return `Bitmagic Game ${gameId.replace(/[^A-Za-z0-9-]/g, '').slice(0, 16)}`.trim();
+    }
+    return cleaned;
+}
+function positiveInt(value) {
+    return typeof value === 'number' && Number.isInteger(value) && value > 0 ? value : undefined;
+}
+function nonEmpty(value) {
+    return typeof value === 'string' && value.trim().length > 0 ? value.trim() : undefined;
+}
+export function readSteamConfigFile(configPath) {
+    const parsed = readJsonFile(configPath);
+    if (typeof parsed !== 'object' || parsed === null || Array.isArray(parsed))
+        return {};
+    const record = parsed;
+    const depotsRaw = record.depots;
+    const depots = typeof depotsRaw === 'object' && depotsRaw !== null
+        ? {
+            windows: positiveInt(depotsRaw.windows),
+            macos: positiveInt(depotsRaw.macos),
+        }
+        : undefined;
+    return {
+        appId: positiveInt(record.appId),
+        ...(depots !== undefined ? { depots } : {}),
+        account: nonEmpty(record.account),
+        displayName: nonEmpty(record.displayName),
+        version: nonEmpty(record.version),
+        bundleId: nonEmpty(record.bundleId),
+        macIdentity: nonEmpty(record.macIdentity),
+        notaryProfile: nonEmpty(record.notaryProfile),
+    };
+}
+/** Drop undefined leaves so the written file holds only what was actually set. */
+function compact(file) {
+    const out = {};
+    if (file.appId !== undefined)
+        out.appId = file.appId;
+    if (file.depots?.windows !== undefined || file.depots?.macos !== undefined) {
+        out.depots = {
+            ...(file.depots.windows !== undefined ? { windows: file.depots.windows } : {}),
+            ...(file.depots.macos !== undefined ? { macos: file.depots.macos } : {}),
+        };
+    }
+    if (file.account !== undefined)
+        out.account = file.account;
+    if (file.displayName !== undefined)
+        out.displayName = file.displayName;
+    if (file.version !== undefined)
+        out.version = file.version;
+    if (file.bundleId !== undefined)
+        out.bundleId = file.bundleId;
+    if (file.macIdentity !== undefined)
+        out.macIdentity = file.macIdentity;
+    if (file.notaryProfile !== undefined)
+        out.notaryProfile = file.notaryProfile;
+    return out;
+}
+/** Merge `patch` into the file on disk and write it back. Returns the merged file. */
+export function updateSteamConfigFile(configPath, patch) {
+    const current = readSteamConfigFile(configPath);
+    const merged = {
+        ...current,
+        ...Object.fromEntries(Object.entries(patch).filter(([, value]) => value !== undefined)),
+        depots: { ...current.depots, ...Object.fromEntries(Object.entries(patch.depots ?? {}).filter(([, v]) => v !== undefined)) },
+    };
+    const out = compact(merged);
+    fs.mkdirSync(path.dirname(configPath), { recursive: true });
+    writeJsonAtomic(configPath, out);
+    return out;
+}
+/** Parse a Steam numeric id from a flag, naming the flag when it is not one. */
+export function parseSteamId(flag, value) {
+    if (value === undefined)
+        return undefined;
+    const trimmed = value.trim();
+    if (!/^\d{1,10}$/.test(trimmed) || Number(trimmed) <= 0) {
+        throw new CliError(`--${flag} must be a positive number as Steamworks shows it (got ${JSON.stringify(value)}).`);
+    }
+    return Number(trimmed);
+}
+export function resolveSteamConfig(options) {
+    const file = readSteamConfigFile(options.configPath);
+    const displayName = file.displayName ?? readGameName(options.root);
+    return {
+        ...(file.appId !== undefined ? { appId: file.appId } : {}),
+        ...(file.depots?.windows !== undefined ? { windowsDepot: file.depots.windows } : {}),
+        ...(file.depots?.macos !== undefined ? { macosDepot: file.depots.macos } : {}),
+        ...(file.account !== undefined ? { account: file.account } : {}),
+        displayName,
+        productName: sanitizeExecutableName(displayName, options.gameId),
+        version: file.version ?? '1.0.0',
+        buildNumber: buildNumberNow(options.now),
+        bundleId: file.bundleId ?? deriveBundleId(options.gameId),
+        ...(file.macIdentity !== undefined ? { macIdentity: file.macIdentity } : {}),
+        ...(file.notaryProfile !== undefined ? { notaryProfile: file.notaryProfile } : {}),
+    };
+}
+/** The app id, or a refusal that says where to get one. */
+export function requireAppId(config) {
+    if (config.appId === undefined) {
+        throw new CliError('No Steam app id on file. The creator buys an app credit in Steamworks (the $100 Steam Direct '
+            + 'fee) and creates the app; then run `bitmagic steam init --app-id <id>` with the id '
+            + 'Steamworks shows on the app\'s page.', 3);
+    }
+    return config.appId;
+}
+//# sourceMappingURL=config.js.map

package/dist/steam/config.js.map

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

package/dist/steam/electron-cache.d.ts

@@ -0,0 +1,11 @@
+export declare const ELECTRON_VERSION = "44.5.1";
+export type ShellPlatform = 'win32-x64' | 'darwin-x64' | 'darwin-arm64';
+export declare function electronCacheDir(): string;
+/** `SHASUMS256.txt` → file name → sha256. Pure. */
+export declare function parseShaSums(text: string): Map<string, string>;
+/**
+ * The extracted release for `platform`, downloading and verifying it first if needed. macOS
+ * releases are unpacked with `ditto`, the only extractor that keeps a framework's symlinks as
+ * symlinks — which is also why the macOS build needs a Mac.
+ */
+export declare function ensureElectronShell(platform: ShellPlatform, log: (message: string) => void): Promise<string>;