@playdrop/playdrop-cli 0.13.17 → 0.14.1

package/config/client-meta.json

@@ -1,7 +1,7 @@
 {
-  "version": "0.13.17",
+  "version": "0.14.1",
   "build": 1,
-  "runtimeSdkVersion": "0.13.17",
+  "runtimeSdkVersion": "0.14.1",
   "runtimeSdkBuild": 1,
   "clients": {
     "all": {

package/dist/apps/loadCheck.d.ts

@@ -30,32 +30,14 @@ export type HostedLaunchState = {
     errorCode: string | null;
     message: string | null;
 };
-export type ProjectCheckAction = {
-    type: 'click';
-    x: number;
-    y: number;
-    button?: 'left' | 'right' | 'middle';
-} | {
-    type: 'press';
-    key: string;
-} | {
-    type: 'wait';
-    ms: number;
-};
+export declare function formatConsoleValue(value: unknown): string;
+export declare function formatBrowserConsoleMessage(values: unknown[], fallbackText: string): string;
 export declare function resolveLoadCheckSurface(surfaceTargets: unknown, primarySurface?: unknown): AppSurface;
 export declare function cloneLoadCheckContextOptions(surface: AppSurface): BrowserContextOptions;
 export declare function isSoftwareWebGlRenderer(renderer: string | null | undefined): boolean;
-export declare function normalizeProjectCheckActions(value: unknown): ProjectCheckAction[];
-export declare function focusProjectCheckGameFrame(page: Pick<Page, 'mouse'>, frame: Frame): Promise<{
-    x: number;
-    y: number;
-    width: number;
-    height: number;
-}>;
 export declare function dispatchPlaytestTapeToFrame(page: Page, frame: Frame, surface: AppSurface, tape: AppPlaytestTape, hooks?: {
     onBeforeEvent?: (eventIndex: number, event: AppPlaytestTapeEvent) => void;
 }): Promise<void>;
-export declare function dispatchProjectCheckActionsToFrame(page: Page, frame: Frame, actions: readonly ProjectCheckAction[]): Promise<void>;
 export declare function formatHostedLoadCheckFailure(taskName: string, result: HostedLoadCheckResult, scope?: 'local' | 'staged' | 'final'): string;
 export declare function redactHostedLoadCheckSecrets(text: string, sourceUrl: string): string;
 export declare function runLocalHostedLoadCheck(input: {
@@ -71,7 +53,6 @@ export declare function runLocalHostedLoadCheck(input: {
     captureSession?: TaskCaptureSession | null;
     allowUnregisteredViewerLaunch?: boolean;
     screenshotPath?: string | null;
-    actions?: ProjectCheckAction[];
     surface?: AppSurface;
     playtestTape?: AppPlaytestTape;
     postReadyWaitMs?: number;

package/dist/apps/loadCheck.js

@@ -4,13 +4,12 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.PLAYDROP_SURFACE_CONTEXT_OPTIONS = void 0;
+exports.formatConsoleValue = formatConsoleValue;
+exports.formatBrowserConsoleMessage = formatBrowserConsoleMessage;
 exports.resolveLoadCheckSurface = resolveLoadCheckSurface;
 exports.cloneLoadCheckContextOptions = cloneLoadCheckContextOptions;
 exports.isSoftwareWebGlRenderer = isSoftwareWebGlRenderer;
-exports.normalizeProjectCheckActions = normalizeProjectCheckActions;
-exports.focusProjectCheckGameFrame = focusProjectCheckGameFrame;
 exports.dispatchPlaytestTapeToFrame = dispatchPlaytestTapeToFrame;
-exports.dispatchProjectCheckActionsToFrame = dispatchProjectCheckActionsToFrame;
 exports.formatHostedLoadCheckFailure = formatHostedLoadCheckFailure;
 exports.redactHostedLoadCheckSecrets = redactHostedLoadCheckSecrets;
 exports.runLocalHostedLoadCheck = runLocalHostedLoadCheck;
@@ -37,7 +36,6 @@ var surfaceProfiles_2 = require("./surfaceProfiles");
 Object.defineProperty(exports, "PLAYDROP_SURFACE_CONTEXT_OPTIONS", { enumerable: true, get: function () { return surfaceProfiles_2.PLAYDROP_SURFACE_CONTEXT_OPTIONS; } });
 const FRAME_SELECTOR = 'iframe[title="Game"]';
 const DEFAULT_HOSTED_LOAD_TIMEOUT_MS = 15000;
-const POST_READY_SETTLE_MS = 750;
 const PLAYTEST_INTERACTIVE_MEAN_DELTA_MIN = 0.002;
 const PLAYTEST_INTERACTIVE_CHANGED_PIXEL_RATIO_MIN = 0.01;
 const LOAD_CHECK_SURFACE_ORDER = ['DESKTOP', 'MOBILE_LANDSCAPE', 'MOBILE_PORTRAIT'];
@@ -75,6 +73,9 @@ function isKnownGoogleTelemetryUrl(rawUrl) {
     return GOOGLE_TELEMETRY_HOSTS.some((domain) => isHostOrSubdomain(hostname, domain));
 }
 function formatConsoleValue(value) {
+    if (value instanceof Error) {
+        return `${value.name}: ${value.message}`;
+    }
     if (typeof value === 'string')
         return value;
     if (typeof value === 'number' || typeof value === 'boolean' || value === null) {
@@ -84,6 +85,10 @@ function formatConsoleValue(value) {
         return 'undefined';
     }
     if (typeof value === 'object') {
+        const namedError = value;
+        if (typeof namedError.message === 'string') {
+            return `${typeof namedError.name === 'string' ? `${namedError.name}: ` : ''}${namedError.message}`;
+        }
         try {
             return JSON.stringify(value);
         }
@@ -93,6 +98,13 @@ function formatConsoleValue(value) {
     }
     return String(value);
 }
+function formatBrowserConsoleMessage(values, fallbackText) {
+    if (values.length === 0) {
+        return fallbackText;
+    }
+    const rendered = values.map(formatConsoleValue).join(' ');
+    return rendered === '{}' || rendered === '[object]' ? fallbackText : rendered;
+}
 function serializePayload(payload) {
     if (payload === undefined) {
         return '';
@@ -263,67 +275,6 @@ function isSoftwareWebGlRenderer(renderer) {
     const normalized = typeof renderer === 'string' ? renderer.trim() : '';
     return normalized.length > 0 && SOFTWARE_WEBGL_RENDERER_PATTERNS.some((pattern) => pattern.test(normalized));
 }
-function normalizeProjectCheckActions(value) {
-    if (value === undefined || value === null) {
-        return [];
-    }
-    if (!Array.isArray(value)) {
-        throw new Error('project_check_actions_invalid: expected a JSON array.');
-    }
-    return value.map((entry, index) => {
-        if (!entry || typeof entry !== 'object' || Array.isArray(entry)) {
-            throw new Error(`project_check_action_invalid:${index}`);
-        }
-        const type = typeof entry.type === 'string'
-            ? entry.type.trim().toLowerCase()
-            : '';
-        if (type === 'click') {
-            const x = Number(entry.x);
-            const y = Number(entry.y);
-            if (!Number.isFinite(x) || !Number.isFinite(y)) {
-                throw new Error(`project_check_action_invalid:${index}:click_coordinates_required`);
-            }
-            const rawButton = typeof entry.button === 'string'
-                ? entry.button.trim().toLowerCase()
-                : '';
-            const button = rawButton === 'right' || rawButton === 'middle' ? rawButton : 'left';
-            return { type: 'click', x, y, button };
-        }
-        if (type === 'press') {
-            const key = typeof entry.key === 'string'
-                ? entry.key.trim()
-                : '';
-            if (!key) {
-                throw new Error(`project_check_action_invalid:${index}:key_required`);
-            }
-            return { type: 'press', key };
-        }
-        if (type === 'wait') {
-            const ms = Number(entry.ms);
-            if (!Number.isInteger(ms) || ms < 0 || ms > 60000) {
-                throw new Error(`project_check_action_invalid:${index}:wait_ms_invalid`);
-            }
-            return { type: 'wait', ms };
-        }
-        throw new Error(`project_check_action_type_unknown:${index}`);
-    });
-}
-async function focusProjectCheckGameFrame(page, frame) {
-    const element = await frame.frameElement();
-    try {
-        await element.scrollIntoViewIfNeeded().catch(() => { });
-        const box = await element.boundingBox();
-        if (!box) {
-            throw new Error('project_check_game_frame_not_visible');
-        }
-        await page.mouse.click(box.x + (box.width / 2), box.y + (box.height / 2), { button: 'left' });
-        await frame.evaluate(() => window.focus()).catch(() => { });
-        return box;
-    }
-    finally {
-        await element.dispose().catch(() => { });
-    }
-}
 async function prepareProjectCheckGameFrame(frame) {
     const element = await frame.frameElement();
     try {
@@ -457,24 +408,6 @@ async function dispatchPlaytestTapeToFrame(page, frame, surface, tape, hooks = {
         }
     }
 }
-async function dispatchProjectCheckActionsToFrame(page, frame, actions) {
-    for (const action of actions) {
-        if (action.type === 'wait') {
-            await page.waitForTimeout(action.ms);
-            continue;
-        }
-        const box = await focusProjectCheckGameFrame(page, frame);
-        if (action.type === 'click') {
-            await page.mouse.click(box.x + action.x, box.y + action.y, { button: action.button ?? 'left' });
-            continue;
-        }
-        if (action.type === 'press') {
-            await page.keyboard.press(action.key);
-            continue;
-        }
-        throw new Error('project_check_action_type_unknown');
-    }
-}
 async function findGameFrame(page, timeoutMs) {
     const handle = await page.waitForSelector(FRAME_SELECTOR, { timeout: timeoutMs });
     const frame = await handle.contentFrame();
@@ -514,7 +447,6 @@ async function saveScreenshot(page, screenshotPath) {
     }
     await (0, promises_1.mkdir)((0, node_path_1.dirname)(normalizedPath), { recursive: true });
     await page.screenshot({ path: normalizedPath, fullPage: true });
-    console.log(`[check] Saved screenshot to ${(0, node_path_1.relative)(process.cwd(), normalizedPath) || normalizedPath}`);
     return normalizedPath;
 }
 async function saveGameFrameScreenshot(page, screenshotPath) {
@@ -637,9 +569,11 @@ async function runHostedLoadCheck(options) {
                         settleHostedLaunchWaiter(normalizedHostedState);
                     }
                 }
-                const serialized = serializePayload(payload);
-                const line = redactReportText(['[check][custom]', typeof type === 'string' ? type.toLowerCase() : 'info', serialized].filter(Boolean).join(' '));
-                console.log(line);
+                const normalizedType = typeof type === 'string' ? type.toLowerCase() : 'info';
+                if (/error|failed|denied|unreachable/.test(normalizedType)) {
+                    const serialized = serializePayload(payload);
+                    errors.push(redactReportText(['[check][custom]', normalizedType, serialized].filter(Boolean).join(' ')));
+                }
             });
             await page.addInitScript(() => {
                 window.addEventListener('unhandledrejection', (event) => {
@@ -676,14 +610,11 @@ async function runHostedLoadCheck(options) {
             const handleConsoleMessage = async (message) => {
                 const type = message.type();
                 const args = await Promise.all(message.args().map((arg) => arg.jsonValue().catch(() => arg.toString())));
-                const rendered = args.length > 0 ? args.map(formatConsoleValue).join(' ') : message.text();
+                const rendered = formatBrowserConsoleMessage(args, message.text());
                 const line = redactReportText(withTapeAction(`[check][console:${type}] ${rendered}`));
                 if (type === 'error' || type === 'assert' || type === 'trace') {
                     errors.push(line);
-                    console.error(line);
-                    return;
                 }
-                console.log(line);
             };
             page.on('console', (message) => {
                 void handleConsoleMessage(message).catch((error) => {
@@ -695,7 +626,6 @@ async function runHostedLoadCheck(options) {
                 const text = redactReportText(error?.message ?? String(error));
                 const line = withTapeAction(`[check][pageerror] ${text}`);
                 errors.push(line);
-                console.error(line);
             });
             page.on('requestfailed', (request) => {
                 const failure = request.failure();
@@ -710,7 +640,6 @@ async function runHostedLoadCheck(options) {
                 }
                 const line = withTapeAction(`[check][requestfailed] ${text}`);
                 errors.push(line);
-                console.error(line);
             });
             page.on('response', (response) => {
                 const status = response.status();
@@ -724,9 +653,7 @@ async function runHostedLoadCheck(options) {
                 }
                 const line = withTapeAction(`[check][response] ${text}`);
                 errors.push(line);
-                console.error(line);
             });
-            console.log(`[check] Opening ${reportTargetUrl}`);
             const response = await page.goto(options.targetUrl, { waitUntil: 'domcontentloaded', timeout: 30000 });
             if (response && !response.ok()) {
                 errors.push(`[check][navigation] ${response.status()} ${response.statusText()} ${reportTargetUrl}`);
@@ -764,14 +691,10 @@ async function runHostedLoadCheck(options) {
             }
             const frame = await findGameFrame(page, readinessTimeoutMs);
             webglRenderer = await readWebGlRenderer(frame);
-            console.log(`[check] WebGL renderer: ${webglRenderer}`);
             if (isSoftwareWebGlRenderer(webglRenderer)) {
                 throw new Error(`project_check_webgl_renderer_software: WebGL renderer is "${webglRenderer}". Real hardware acceleration is required.`);
             }
             await saveGameFrameScreenshot(page, options.readyGameFrameScreenshotPath);
-            if (options.playtestTape && options.actions?.length) {
-                throw new Error('project_check_input_mode_conflict: playtest tape and legacy actions cannot run together.');
-            }
             if (options.playtestTape) {
                 if (!options.playtestSurface) {
                     throw new Error('project_check_playtest_surface_required');
@@ -782,10 +705,6 @@ async function runHostedLoadCheck(options) {
                     },
                 });
             }
-            else if (options.actions?.length) {
-                await dispatchProjectCheckActionsToFrame(page, frame, options.actions);
-                await page.waitForTimeout(POST_READY_SETTLE_MS);
-            }
             else if (options.postReadyWaitMs && options.postReadyWaitMs > 0) {
                 await page.waitForTimeout(options.postReadyWaitMs);
             }
@@ -916,7 +835,6 @@ async function runLocalHostedLoadCheck(input) {
                 expectedHostedLaunchState: resolvePostAuthHostedLaunchState(localAppMetadata.controllerMode),
                 contextOptions,
                 screenshotPath: input.screenshotPath,
-                actions: input.actions,
                 playtestTape: input.playtestTape,
                 playtestSurface: captureSurface,
                 postReadyWaitMs: input.postReadyWaitMs,
@@ -962,7 +880,6 @@ async function runLocalHostedLoadCheck(input) {
                 savedSessionBootstrap: true,
                 contextOptions,
                 screenshotPath: input.screenshotPath,
-                actions: input.actions,
                 playtestTape: input.playtestTape,
                 playtestSurface: captureSurface,
                 postReadyWaitMs: input.postReadyWaitMs,
@@ -981,7 +898,6 @@ async function runLocalHostedLoadCheck(input) {
             expectedHostedLaunchState: anonymousExpectedState,
             contextOptions,
             screenshotPath: input.screenshotPath,
-            actions: input.actions,
             playtestTape: input.playtestTape,
             playtestSurface: captureSurface,
             postReadyWaitMs: input.postReadyWaitMs,

package/dist/apps/surfaceProfiles.d.ts

@@ -1,5 +1,6 @@
 import type { AppSurface } from '@playdrop/types';
 import type { BrowserContextOptions } from 'playwright-core';
+export declare const PLAYDROP_MOBILE_USER_AGENT = "Mozilla/5.0 (iPhone; CPU iPhone OS 26_0 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/26.0 Mobile/15E148 Safari/604.1";
 export type PlaydropSurfaceProfile = {
     contextOptions: BrowserContextOptions;
     playwrightMcpDevice: string | null;

package/dist/apps/surfaceProfiles.js

@@ -1,9 +1,9 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.PLAYDROP_SURFACE_CONTEXT_OPTIONS = exports.PLAYDROP_SURFACE_PROFILES = void 0;
+exports.PLAYDROP_SURFACE_CONTEXT_OPTIONS = exports.PLAYDROP_SURFACE_PROFILES = exports.PLAYDROP_MOBILE_USER_AGENT = void 0;
 exports.clonePlaydropSurfaceContextOptions = clonePlaydropSurfaceContextOptions;
 exports.buildPlaywrightMcpSurfaceArgs = buildPlaywrightMcpSurfaceArgs;
-const MOBILE_USER_AGENT = 'Mozilla/5.0 (iPhone; CPU iPhone OS 26_0 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/26.0 Mobile/15E148 Safari/604.1';
+exports.PLAYDROP_MOBILE_USER_AGENT = 'Mozilla/5.0 (iPhone; CPU iPhone OS 26_0 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/26.0 Mobile/15E148 Safari/604.1';
 exports.PLAYDROP_SURFACE_PROFILES = {
     DESKTOP: {
         contextOptions: {
@@ -21,7 +21,7 @@ exports.PLAYDROP_SURFACE_PROFILES = {
             deviceScaleFactor: 3,
             isMobile: true,
             hasTouch: true,
-            userAgent: MOBILE_USER_AGENT,
+            userAgent: exports.PLAYDROP_MOBILE_USER_AGENT,
         },
         playwrightMcpDevice: 'iPhone 13 landscape',
     },
@@ -32,7 +32,7 @@ exports.PLAYDROP_SURFACE_PROFILES = {
             deviceScaleFactor: 3,
             isMobile: true,
             hasTouch: true,
-            userAgent: MOBILE_USER_AGENT,
+            userAgent: exports.PLAYDROP_MOBILE_USER_AGENT,
         },
         playwrightMcpDevice: 'iPhone 13',
     },
@@ -60,5 +60,6 @@ function buildPlaywrightMcpSurfaceArgs(surface) {
         ...(profile.playwrightMcpDevice ? ['--device', profile.playwrightMcpDevice] : []),
         '--viewport-size',
         `${viewport.width}x${viewport.height}`,
+        ...(profile.contextOptions.userAgent ? ['--user-agent', profile.contextOptions.userAgent] : []),
     ];
 }

package/dist/apps/validate.d.ts

@@ -1,5 +1,5 @@
 import type { AppTask } from '../catalogue';
 export type AppValidationWarningMode = 'source' | 'bundle';
-export declare function collectAppValidationWarnings(task: AppTask, mode?: AppValidationWarningMode): string[];
+export declare function collectAppValidationWarnings(task: AppTask, _mode?: AppValidationWarningMode): string[];
 export declare function runFormatScript(task: AppTask): Promise<boolean>;
 export declare function validateAppTask(task: AppTask): Promise<void>;