@playdrop/playdrop-cli 0.11.8 → 0.12.0

package/dist/commands/check.d.ts

@@ -0,0 +1,8 @@
+type ProjectCheckOptions = {
+    app?: string;
+    timeout?: string | number;
+    screenshot?: string;
+    actions?: string;
+};
+export declare function check(targetArg: string | undefined, options?: ProjectCheckOptions): Promise<void>;
+export {};

package/dist/commands/check.js

@@ -0,0 +1,188 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.check = check;
+const node_fs_1 = require("node:fs");
+const node_path_1 = require("node:path");
+const types_1 = require("@playdrop/types");
+const commandContext_1 = require("../commandContext");
+const catalogue_1 = require("../catalogue");
+const catalogue_utils_1 = require("../catalogue-utils");
+const http_1 = require("../http");
+const messages_1 = require("../messages");
+const loadCheck_1 = require("../apps/loadCheck");
+const devShared_1 = require("./devShared");
+function resolveProjectCheckTarget(targetArg, appOption) {
+    try {
+        return (0, devShared_1.resolveDevTarget)(targetArg, appOption);
+    }
+    catch (error) {
+        const code = error?.code;
+        const message = error?.message || 'Unable to resolve project check target.';
+        const suggestions = code === 'app_required'
+            ? ['Use "--app <name>" to choose which app to check.']
+            : code === 'catalogue_missing'
+                ? ['Run the command inside a Playdrop workspace with catalogue.json.']
+                : ['Provide a valid catalogue-backed app target.'];
+        (0, messages_1.printErrorWithHelp)(message, suggestions, { command: 'project check' });
+        process.exitCode = 1;
+        return null;
+    }
+}
+function parseProjectCheckTimeoutMs(value) {
+    if (value === undefined || value === null || value === '') {
+        return 15000;
+    }
+    const numeric = typeof value === 'number' ? value : Number(value);
+    if (!Number.isFinite(numeric) || numeric <= 0) {
+        throw new Error('Timeout must be a positive number of seconds.');
+    }
+    if (numeric > 600) {
+        throw new Error('Timeout cannot exceed 600 seconds.');
+    }
+    return Math.round(numeric * 1000);
+}
+function readProjectCheckActions(actionsPath) {
+    const normalizedPath = actionsPath?.trim() ?? '';
+    if (!normalizedPath) {
+        return [];
+    }
+    const raw = (0, node_fs_1.readFileSync)(normalizedPath, 'utf8');
+    return (0, loadCheck_1.normalizeProjectCheckActions)(JSON.parse(raw));
+}
+function defaultProjectCheckScreenshotPath(appName) {
+    return (0, node_path_1.join)('assets', 'marketing', 'playdrop', 'check', `${appName}.png`);
+}
+async function check(targetArg, options = {}) {
+    let timeoutMs;
+    let actions;
+    try {
+        timeoutMs = parseProjectCheckTimeoutMs(options.timeout);
+        actions = readProjectCheckActions(options.actions);
+    }
+    catch (error) {
+        (0, messages_1.printErrorWithHelp)(error?.message || 'Invalid project check options.', ['Use --actions with a JSON array of click, press, and wait actions.'], { command: 'project check' });
+        process.exitCode = 1;
+        return;
+    }
+    const resolvedTarget = resolveProjectCheckTarget(targetArg, options.app);
+    if (!resolvedTarget) {
+        return;
+    }
+    const filePath = resolvedTarget.htmlPath;
+    if (!(0, node_fs_1.existsSync)(filePath) || !(0, node_fs_1.statSync)(filePath).isFile()) {
+        (0, messages_1.printErrorWithHelp)(`App HTML was not found at ${filePath}.`, ['Run the app build first or fix the catalogue file path.'], { command: 'project check' });
+        process.exitCode = 1;
+        return;
+    }
+    const taskLookup = (0, catalogue_1.findAppTaskByFile)(filePath);
+    if (taskLookup.errors.length > 0) {
+        (0, messages_1.printErrorWithHelp)(taskLookup.errors[0] || 'Failed to resolve the app task from catalogue.json.', taskLookup.errors.slice(1), { command: 'project check' });
+        process.exitCode = 1;
+        return;
+    }
+    if (!taskLookup.task) {
+        (0, messages_1.printErrorWithHelp)('project check requires a catalogue-backed app target.', ['Add this app to catalogue.json, then rerun "playdrop project check".'], { command: 'project check' });
+        process.exitCode = 1;
+        return;
+    }
+    let appName = resolvedTarget.appName;
+    try {
+        const match = (0, catalogue_utils_1.findAppDefinition)(filePath);
+        appName = match.name;
+    }
+    catch (error) {
+        if (resolvedTarget.cataloguePath) {
+            (0, messages_1.printErrorWithHelp)(error?.message || 'Catalogue lookup failed.', ['Ensure the HTML file is listed exactly once in catalogue.json with a valid type.'], { command: 'project check' });
+            process.exitCode = 1;
+            return;
+        }
+    }
+    const screenshotPath = options.screenshot?.trim() || defaultProjectCheckScreenshotPath(appName);
+    const workspacePath = resolvedTarget.cataloguePath ?? (0, node_path_1.dirname)(filePath);
+    await (0, commandContext_1.withEnvironment)('project check', 'Checking the Playdrop hosted game shell', async ({ client, env, envConfig, account, token }) => {
+        let currentUsername = account?.username?.trim() ?? '';
+        if (!currentUsername) {
+            try {
+                currentUsername = await (0, devShared_1.fetchDevUsername)(client);
+            }
+            catch (error) {
+                if (error instanceof http_1.CLIUnsupportedClientError) {
+                    return;
+                }
+                if (error instanceof types_1.UnsupportedClientError) {
+                    (0, http_1.handleUnsupportedError)(error, 'Authentication');
+                    process.exitCode = 1;
+                    return;
+                }
+                if (error instanceof types_1.ApiError) {
+                    (0, messages_1.printErrorWithHelp)(`Could not fetch your account (status ${error.status}).`, ['Run "playdrop auth login" to refresh your session.'], { command: 'project check' });
+                    process.exitCode = 1;
+                    return;
+                }
+                if ((0, devShared_1.isNetworkError)(error)) {
+                    (0, messages_1.printNetworkIssue)('Could not reach the Playdrop API to resolve your account.', 'project check');
+                    process.exitCode = 1;
+                    return;
+                }
+                throw error;
+            }
+        }
+        try {
+            await (0, devShared_1.assertAppRegistered)(client, currentUsername, appName);
+        }
+        catch (error) {
+            if (error instanceof http_1.CLIUnsupportedClientError) {
+                return;
+            }
+            if (error instanceof types_1.UnsupportedClientError) {
+                (0, http_1.handleUnsupportedError)(error, 'Project check');
+                process.exitCode = 1;
+                return;
+            }
+            if (error instanceof types_1.ApiError && error.status === 404) {
+                (0, messages_1.printErrorWithHelp)(`App ${currentUsername}/${appName} is not registered on ${env}.`, [`Run "playdrop project create app ${appName}" before using project check.`], { command: 'project check' });
+                process.exitCode = 1;
+                return;
+            }
+            if ((0, devShared_1.isNetworkError)(error)) {
+                (0, messages_1.printNetworkIssue)('Could not reach the Playdrop API to verify the app registration.', 'project check');
+                process.exitCode = 1;
+                return;
+            }
+            throw error;
+        }
+        const projectInfo = (0, devShared_1.findProjectInfo)(filePath);
+        const devScriptAvailable = Boolean(projectInfo.projectDir
+            && projectInfo.packageJson
+            && typeof projectInfo.packageJson.scripts?.dev === 'string');
+        const entryLabel = (0, node_path_1.relative)(process.cwd(), filePath) || filePath;
+        console.log(`[check] Preparing ${entryLabel}.`);
+        if (projectInfo.projectDir && !devScriptAvailable && projectInfo.packageJsonPath) {
+            const projectLabel = (0, devShared_1.formatProjectLabel)(projectInfo);
+            if (projectLabel) {
+                console.log(`[check] package.json detected at ${projectLabel}, but no "dev" script was found. Run your app build manually if needed.`);
+            }
+        }
+        const result = await (0, loadCheck_1.runLocalHostedLoadCheck)({
+            client,
+            apiBase: envConfig.apiBase,
+            webBase: envConfig.webBase,
+            creatorUsername: currentUsername,
+            task: taskLookup.task,
+            timeoutMs,
+            token,
+            currentUser: null,
+            screenshotPath,
+            actions,
+        });
+        if (result.status !== 'PASSED') {
+            (0, messages_1.printErrorWithHelp)((0, loadCheck_1.formatHostedLoadCheckFailure)(appName, result, 'local'), result.screenshotPath ? [`Screenshot: ${result.screenshotPath}`] : [], { command: 'project check' });
+            process.exitCode = 1;
+            return;
+        }
+        console.log(`[check] Passed ${currentUsername}/${appName}.`);
+        if (result.webglRenderer) {
+            console.log(`[check] Hardware renderer: ${result.webglRenderer}`);
+        }
+    }, { workspacePath });
+}

package/dist/commands/create.js

@@ -1,26 +1,25 @@
 "use strict";
-/* eslint-disable complexity, max-lines, max-lines-per-function */
 var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.createAssetSpecProject = createAssetSpecProject;
 exports.create = create;
-const promises_1 = __importDefault(require("node:readline/promises"));
-const node_process_1 = require("node:process");
+const types_1 = require("@playdrop/types");
+const app_1 = require("@playdrop/types/app");
+const fflate_1 = require("fflate");
+const node_child_process_1 = require("node:child_process");
 const node_fs_1 = require("node:fs");
 const node_path_1 = require("node:path");
-const node_child_process_1 = require("node:child_process");
-const fflate_1 = require("fflate");
-const types_1 = require("@playdrop/types");
+const node_process_1 = require("node:process");
+const promises_1 = __importDefault(require("node:readline/promises"));
+const catalogue_1 = require("../catalogue");
+const catalogue_utils_1 = require("../catalogue-utils");
+const clientInfo_1 = require("../clientInfo");
 const commandContext_1 = require("../commandContext");
 const http_1 = require("../http");
 const messages_1 = require("../messages");
 const init_1 = require("./init");
-const app_1 = require("@playdrop/types/app");
-const catalogue_utils_1 = require("../catalogue-utils");
-const catalogue_1 = require("../catalogue");
-const clientInfo_1 = require("../clientInfo");
 const CATALOGUE_FILENAME = 'catalogue.json';
 const LEGACY_CATALOGUE_VERSION_KEY = ['schema', 'Version'].join('');
 const ALLOWED_CATALOGUE_TOP_LEVEL_KEYS = new Set(['apps', 'assetSpecs', 'assets', 'assetPacks']);
@@ -306,7 +305,10 @@ function buildCatalogueEntry(name, metadata, sourceInfo, relativeFilePath) {
             entry.surfaceTargets = { ...parsed.map };
         }
         catch (error) {
-            throw new Error(`Invalid surfaceTargets for ${name}: ${error?.message || 'unknown error'}`);
+            const message = error instanceof Error && error.message.trim()
+                ? error.message.trim()
+                : String(error);
+            throw new Error(`Invalid surfaceTargets for ${name}: ${message}`);
         }
     }
     if (Object.prototype.hasOwnProperty.call(metadata, 'templateSource')) {
@@ -1048,8 +1050,8 @@ function describeInitSummary(summary) {
 async function create(name, options = {}) {
     const file = (0, node_path_1.resolve)(`${name}.html`);
     const projectDirCandidate = (0, node_path_1.resolve)(name);
-    let templateOptionRaw = options.template?.trim();
-    let remixOptionRaw = options.remix?.trim();
+    const templateOptionRaw = options.template?.trim();
+    const remixOptionRaw = options.remix?.trim();
     let parsedTemplate = null;
     let parsedRemix = null;
     const existingLookup = (0, catalogue_1.resolveCatalogueEntries)(process.cwd(), { filterName: name });
@@ -1149,7 +1151,7 @@ async function create(name, options = {}) {
                 process.exitCode = 1;
                 return;
             }
-            const detailMessage = typeof error?.message === 'string' && error.message.trim()
+            const detailMessage = error instanceof Error && error.message.trim()
                 ? error.message.trim()
                 : '';
             const problem = detailMessage
@@ -1222,7 +1224,7 @@ async function create(name, options = {}) {
         try {
             (0, node_fs_1.mkdirSync)(projectDir);
         }
-        catch (error) {
+        catch {
             (0, messages_1.printErrorWithHelp)(`Cannot create ${projectDir} because it already exists.`, [
                 'Remove or rename the existing directory before running "playdrop project create app" again.'
             ], { command: 'project create app' });

package/dist/commands/createRemixContent.js

@@ -3,9 +3,9 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.createAssetRemix = createAssetRemix;
 exports.createPackRemix = createPackRemix;
 exports.createRemixContent = createRemixContent;
+const types_1 = require("@playdrop/types");
 const node_fs_1 = require("node:fs");
 const node_path_1 = require("node:path");
-const types_1 = require("@playdrop/types");
 const commandContext_1 = require("../commandContext");
 const http_1 = require("../http");
 const messages_1 = require("../messages");
@@ -232,7 +232,7 @@ async function createPackRemix(name, remixRef) {
     const catalogue = readWorkspaceCatalogue(cataloguePath);
     assertWorkspaceRootCanOwnEntries(cataloguePath);
     ensureUniqueEntryName(catalogue, 'pack', name);
-    const detail = await client.fetchAssetPackBySlug(parsedRef.creatorUsername, parsedRef.name);
+    await client.fetchAssetPackBySlug(parsedRef.creatorUsername, parsedRef.name);
     const versions = await client.listAssetPackVersions(parsedRef.creatorUsername, parsedRef.name, { limit: 200, offset: 0 });
     const version = versions.versions.find((entry) => entry.version === parsedRef.version);
     if (!version) {

package/dist/commands/detail.js

@@ -1,13 +1,13 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.detail = detail;
+const appUrls_1 = require("../appUrls");
 const commandContext_1 = require("../commandContext");
 const errors_1 = require("../errors");
 const messages_1 = require("../messages");
 const output_1 = require("../output");
 const refs_1 = require("../refs");
-const appUrls_1 = require("../appUrls");
-function printRefValidationError(raw) {
+function printRefValidationError(_raw) {
     (0, messages_1.printErrorWithHelp)('A canonical ref is required.', [
         'Use the format <creator>/<kind>/<name>.',
         'Kinds must be exactly app, asset, asset-spec, or asset-pack.',

package/dist/commands/dev.js

@@ -4,19 +4,19 @@ exports.formatDevRuntimeAssetManifestFailure = formatDevRuntimeAssetManifestFail
 exports.dev = dev;
 exports.resolveDevRouterPort = resolveDevRouterPort;
 exports.resolveCliDevRouterPort = resolveCliDevRouterPort;
+const types_1 = require("@playdrop/types");
 const node_fs_1 = require("node:fs");
 const node_path_1 = require("node:path");
-const types_1 = require("@playdrop/types");
+const appUrls_1 = require("../appUrls");
+const catalogue_1 = require("../catalogue");
+const catalogue_utils_1 = require("../catalogue-utils");
 const commandContext_1 = require("../commandContext");
+const devAuth_1 = require("../devAuth");
 const http_1 = require("../http");
 const messages_1 = require("../messages");
-const catalogue_1 = require("../catalogue");
-const catalogue_utils_1 = require("../catalogue-utils");
-const devShared_1 = require("./devShared");
-const appUrls_1 = require("../appUrls");
-const devServer_1 = require("./devServer");
 const devRuntimeAssets_1 = require("./devRuntimeAssets");
-const devAuth_1 = require("../devAuth");
+const devServer_1 = require("./devServer");
+const devShared_1 = require("./devShared");
 function formatDevRuntimeAssetManifestFailure(error) {
     const rawMessage = error instanceof Error ? error.message : String(error ?? 'unknown_error');
     if (rawMessage.startsWith('dev_runtime_asset_ref_invalid:')) {
@@ -217,9 +217,7 @@ async function dev(targetArg, appOption, devOptions = {}) {
         return;
     }
     const workspacePath = resolvedTarget.cataloguePath ?? (0, node_path_1.dirname)(filePath);
-    await (0, commandContext_1.withEnvironment)('project dev', 'Starting the dev server', 
-    // eslint-disable-next-line complexity
-    async ({ client, env, envConfig, account }) => {
+    await (0, commandContext_1.withEnvironment)('project dev', 'Starting the dev server', async ({ client, env, envConfig, account }) => {
         let currentUsername = account?.username?.trim() ?? '';
         if (!currentUsername) {
             try {
@@ -250,10 +248,9 @@ async function dev(targetArg, appOption, devOptions = {}) {
                 throw error;
             }
         }
-        let appResponse = null;
         if (resolvedTarget.cataloguePath) {
             try {
-                appResponse = await (0, devShared_1.assertAppRegistered)(client, currentUsername, appName);
+                await (0, devShared_1.assertAppRegistered)(client, currentUsername, appName);
             }
             catch (error) {
                 if (error instanceof http_1.CLIUnsupportedClientError) {

package/dist/commands/devServer.d.ts

@@ -1,7 +1,7 @@
-import http from 'node:http';
 import { type ChildProcess } from 'node:child_process';
-import type { ProjectInfo } from './devShared';
+import http from 'node:http';
 import type { DevRuntimeAssetManifestRegistration } from './devRuntimeAssets';
+import type { ProjectInfo } from './devShared';
 export interface StartDevServerOptions {
     appName: string;
     appType: string;

package/dist/commands/devServer.js

@@ -14,11 +14,11 @@ exports.isDevServerAvailable = isDevServerAvailable;
 exports.createDevRouterServer = createDevRouterServer;
 exports.listenDevRouterServer = listenDevRouterServer;
 exports.runDevRouterServer = runDevRouterServer;
-const node_http_1 = __importDefault(require("node:http"));
-const node_fs_1 = require("node:fs");
-const node_path_1 = require("node:path");
 const node_child_process_1 = require("node:child_process");
 const node_crypto_1 = require("node:crypto");
+const node_fs_1 = require("node:fs");
+const node_http_1 = __importDefault(require("node:http"));
+const node_path_1 = require("node:path");
 exports.DEV_ROUTER_PORT = 8888;
 const DEV_ROUTER_HOST = '127.0.0.1';
 const CONTROL_PREFIX = '/_playdrop';
@@ -581,7 +581,6 @@ async function isDevServerAvailable(input, timeoutMs = 1000) {
 }
 function createDevRouterServer(initialPort = exports.DEV_ROUTER_PORT) {
     let activePort = initialPort;
-    // eslint-disable-next-line complexity
     const handleRequest = async (req, res) => {
         const method = req.method || 'GET';
         const allowedOrigin = resolveApprovedDevRouterOrigin(typeof req.headers.origin === 'string' ? req.headers.origin : undefined);

package/dist/commands/marketing.js

@@ -1,5 +1,4 @@
 "use strict";
-/* eslint-disable max-lines */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.MARKETING_AUDIO_POLICIES = exports.MARKETING_SURFACES = void 0;
 exports.parseMarketingCaptureOptions = parseMarketingCaptureOptions;
@@ -11,22 +10,22 @@ exports.buildMarketingCaptureManifest = buildMarketingCaptureManifest;
 exports.createMarketingReport = createMarketingReport;
 exports.marketingDoctor = marketingDoctor;
 exports.marketingCapture = marketingCapture;
+const types_1 = require("@playdrop/types");
 const node_child_process_1 = require("node:child_process");
-const promises_1 = require("node:fs/promises");
 const node_fs_1 = require("node:fs");
-const node_path_1 = require("node:path");
+const promises_1 = require("node:fs/promises");
 const node_os_1 = require("node:os");
-const types_1 = require("@playdrop/types");
-const catalogue_utils_1 = require("../catalogue-utils");
+const node_path_1 = require("node:path");
+const appUrls_1 = require("../appUrls");
 const catalogue_1 = require("../catalogue");
+const catalogue_utils_1 = require("../catalogue-utils");
 const commandContext_1 = require("../commandContext");
 const http_1 = require("../http");
-const appUrls_1 = require("../appUrls");
 const messages_1 = require("../messages");
 const playwright_1 = require("../playwright");
-const devServer_1 = require("./devServer");
-const devRuntimeAssets_1 = require("./devRuntimeAssets");
 const dev_1 = require("./dev");
+const devRuntimeAssets_1 = require("./devRuntimeAssets");
+const devServer_1 = require("./devServer");
 const devShared_1 = require("./devShared");
 exports.MARKETING_SURFACES = ['desktop', 'mobile-landscape', 'mobile-portrait'];
 exports.MARKETING_AUDIO_POLICIES = ['music-and-sfx', 'sfx-only', 'silent'];
@@ -329,7 +328,7 @@ function loadCatalogueApp(cataloguePath, appName) {
     if (!cataloguePath || !(0, node_fs_1.existsSync)(cataloguePath)) {
         return null;
     }
-    const raw = JSON.parse(require('node:fs').readFileSync(cataloguePath, 'utf8'));
+    const raw = JSON.parse((0, node_fs_1.readFileSync)(cataloguePath, 'utf8'));
     const apps = raw && typeof raw === 'object' && Array.isArray(raw.apps)
         ? raw.apps
         : Array.isArray(raw)
@@ -661,7 +660,7 @@ function muxMarketingAudio(videoPath, audioPath) {
         '-shortest',
         muxedPath,
     ], 'ffmpeg_failed');
-    require('node:fs').renameSync(muxedPath, videoPath);
+    (0, node_fs_1.renameSync)(muxedPath, videoPath);
 }
 function extractPoster(videoPath, posterPath) {
     runTool('ffmpeg', [
@@ -861,7 +860,7 @@ async function marketingCapture(targetArg, options = {}) {
     const outputPaths = resolveMarketingOutputPaths(projectRoot, appName, parsedOptions.outputDir);
     const projectInfo = (0, devShared_1.findProjectInfo)(resolvedTarget.htmlPath);
     const devScriptAvailable = Boolean(projectInfo.projectDir && projectInfo.packageJson && typeof projectInfo.packageJson.scripts?.dev === 'string');
-    await (0, commandContext_1.withEnvironment)('project marketing capture', 'Capturing marketing media', async ({ client, env, envConfig }) => {
+    await (0, commandContext_1.withEnvironment)('project marketing capture', 'Capturing marketing media', async ({ client, env: _env, envConfig }) => {
         let currentUsername = '';
         try {
             const currentUser = await (0, devShared_1.fetchDevUser)(client);

package/dist/commands/play.js

@@ -2,15 +2,15 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.play = play;
 const types_1 = require("@playdrop/types");
-const commandContext_1 = require("../commandContext");
 const appUrls_1 = require("../appUrls");
 const browser_1 = require("../browser");
+const commandContext_1 = require("../commandContext");
 const http_1 = require("../http");
 const messages_1 = require("../messages");
 const output_1 = require("../output");
 const refs_1 = require("../refs");
 const devShared_1 = require("./devShared");
-function printPlayRefValidationError(rawRef) {
+function printPlayRefValidationError(_rawRef) {
     (0, messages_1.printErrorWithHelp)('A canonical app ref is required.', [
         'Use the format <creator>/app/<name>.',
         'Example: playdrop play playdrop/app/hangingout',

package/dist/commands/review.d.ts

@@ -33,6 +33,26 @@ export type ReviewRatingCardOptions = {
     punchline?: string;
     title?: string;
 };
+export type ReviewListWindowsOptions = {
+    pid: string;
+};
+export type ReviewScreenshotOptions = {
+    metadata?: string;
+    out: string;
+    pid: string;
+    windowId?: string;
+};
+export declare function buildReviewListWindowsRecorderArgs(options: ReviewListWindowsOptions): string[];
+export declare function buildReviewScreenshotRecorderArgs(options: ReviewScreenshotOptions): {
+    args: string[];
+    metadataPath: string;
+    outputPath: string;
+};
+export declare function listReviewCaptureWindows(options: ReviewListWindowsOptions): Promise<void>;
+export declare function captureReviewScreenshot(options: ReviewScreenshotOptions): Promise<{
+    metadataPath: string;
+    outputPath: string;
+}>;
 export declare function validateGameReviewResult(input: ValidateGameReviewResultInput): Promise<ReviewValidationResult>;
 export declare function validateReviewResultCommand(options: ReviewValidateResultOptions): Promise<void>;
 export declare function composeReviewEvidence(options: ReviewComposeEvidenceOptions): Promise<{

package/dist/commands/review.js

@@ -4,14 +4,20 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.REQUIRED_REVIEW_EVIDENCE_FILES = exports.REVIEW_CRITERIA = void 0;
+exports.buildReviewListWindowsRecorderArgs = buildReviewListWindowsRecorderArgs;
+exports.buildReviewScreenshotRecorderArgs = buildReviewScreenshotRecorderArgs;
+exports.listReviewCaptureWindows = listReviewCaptureWindows;
+exports.captureReviewScreenshot = captureReviewScreenshot;
 exports.validateGameReviewResult = validateGameReviewResult;
 exports.validateReviewResultCommand = validateReviewResultCommand;
 exports.composeReviewEvidence = composeReviewEvidence;
 exports.createReviewRatingCard = createReviewRatingCard;
 const node_path_1 = __importDefault(require("node:path"));
+const node_child_process_1 = require("node:child_process");
 const node_fs_1 = require("node:fs");
 const sharp_1 = __importDefault(require("sharp"));
 const output_1 = require("../output");
+const captureListing_1 = require("./captureListing");
 exports.REVIEW_CRITERIA = [
     'Gameplay / Core Loop',
     'Depth / Replayability',
@@ -46,6 +52,7 @@ exports.REQUIRED_REVIEW_EVIDENCE_FILES = [
     'rating-card.png',
 ];
 const REVIEW_EVIDENCE_MAX_BYTES = 10 * 1024 * 1024;
+const REVIEW_RECORDER_TIMEOUT_MS = 15000;
 function resolveFilePath(filePath, code) {
     const normalized = typeof filePath === 'string' ? filePath.trim() : '';
     if (!normalized) {
@@ -167,6 +174,111 @@ async function assertPngFile(filePath) {
         }
     }
 }
+async function assertNonBlankPngFile(filePath) {
+    await assertPngFile(filePath);
+    const image = (0, sharp_1.default)(filePath);
+    const metadata = await image.metadata();
+    if (!metadata.width || !metadata.height) {
+        throw new Error(`review_screenshot_invalid_image:${filePath}`);
+    }
+    const stats = await image.stats();
+    const colorChannels = stats.channels.slice(0, 3);
+    const brightest = Math.max(...colorChannels.map((channel) => channel.max));
+    if (brightest <= 5) {
+        throw new Error(`review_screenshot_blank:${filePath}`);
+    }
+}
+function parsePositiveInteger(value, code) {
+    const normalized = typeof value === 'string' ? value.trim() : '';
+    const parsed = Number.parseInt(normalized, 10);
+    if (!Number.isSafeInteger(parsed) || parsed <= 0 || String(parsed) !== normalized) {
+        throw new Error(code);
+    }
+    return parsed;
+}
+function buildReviewListWindowsRecorderArgs(options) {
+    const pid = parsePositiveInteger(options.pid, 'invalid_review_window_pid');
+    return ['--list-windows', '--pid', String(pid)];
+}
+function buildReviewScreenshotRecorderArgs(options) {
+    const pid = parsePositiveInteger(options.pid, 'invalid_review_window_pid');
+    const outputPath = resolveFilePath(options.out, 'missing_out');
+    const metadataPath = options.metadata
+        ? resolveFilePath(options.metadata, 'invalid_review_screenshot_metadata')
+        : outputPath.replace(/\.png$/i, '') + '.metadata.json';
+    const args = [
+        '--pid',
+        String(pid),
+        '--screenshot',
+        outputPath,
+        '--metadata',
+        metadataPath,
+    ];
+    if (options.windowId !== undefined && options.windowId !== '') {
+        const windowId = parsePositiveInteger(options.windowId, 'invalid_review_window_id');
+        args.push('--window-id', String(windowId));
+    }
+    return { args, metadataPath, outputPath };
+}
+function runRecorder(args) {
+    return new Promise((resolve, reject) => {
+        const recorderPath = (0, captureListing_1.resolveListingRecorderPath)();
+        const child = (0, node_child_process_1.spawn)(recorderPath, args, {
+            stdio: ['ignore', 'pipe', 'pipe'],
+        });
+        let stdout = '';
+        let stderr = '';
+        let settled = false;
+        const timer = setTimeout(() => {
+            if (settled) {
+                return;
+            }
+            settled = true;
+            child.kill('SIGKILL');
+            reject(new Error(`review_recorder_timeout:${REVIEW_RECORDER_TIMEOUT_MS}`));
+        }, REVIEW_RECORDER_TIMEOUT_MS);
+        child.stdout.on('data', (chunk) => {
+            stdout += chunk.toString();
+        });
+        child.stderr.on('data', (chunk) => {
+            stderr += chunk.toString();
+        });
+        child.on('error', (error) => {
+            if (settled) {
+                return;
+            }
+            settled = true;
+            clearTimeout(timer);
+            reject(new Error(`review_recorder_unavailable:${recorderPath}:${error.message}`));
+        });
+        child.on('close', (code) => {
+            if (settled) {
+                return;
+            }
+            settled = true;
+            clearTimeout(timer);
+            if (code === 0) {
+                resolve(stdout);
+                return;
+            }
+            const detail = (stderr || stdout || `exit ${code}`).trim();
+            reject(new Error(`review_recorder_failed:${detail}`));
+        });
+    });
+}
+async function listReviewCaptureWindows(options) {
+    const output = await runRecorder(buildReviewListWindowsRecorderArgs(options));
+    process.stdout.write(output);
+}
+async function captureReviewScreenshot(options) {
+    const { args, metadataPath, outputPath } = buildReviewScreenshotRecorderArgs(options);
+    await node_fs_1.promises.mkdir(node_path_1.default.dirname(outputPath), { recursive: true });
+    await node_fs_1.promises.mkdir(node_path_1.default.dirname(metadataPath), { recursive: true });
+    await runRecorder(args);
+    await assertNonBlankPngFile(outputPath);
+    (0, output_1.printSuccess)(`Review screenshot written to ${outputPath}`);
+    return { metadataPath, outputPath };
+}
 async function validateGameReviewResult(input) {
     const normalizedState = String(input.reviewState || '').trim().toUpperCase();
     if (!TERMINAL_REVIEW_STATES.has(normalizedState)) {

package/dist/commands/upload-content.d.ts

@@ -2,7 +2,7 @@ import type { ApiClient } from '@playdrop/api-client';
 import { type AssetPackUploadedLocalAsset } from '@playdrop/types';
 import type { AssetPackTask, AssetSpecTask, AssetTask, OwnedAssetTask, PackOwnedAssetTask } from '../catalogue';
 import type { CliTask } from '../taskUtils';
-export type CurrentUserRole = 'USER' | 'CREATOR' | 'ADMIN' | null;
+export type CurrentUserRole = 'CREATOR' | 'ADMIN' | null;
 export type UploadedAssetInfo = {
     creatorUsername: string;
     name: string;