@playdrop/playdrop-cli 0.4.0 → 0.4.1

package/dist/commands/capture.js

@@ -2,82 +2,16 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.capture = capture;
 const node_fs_1 = require("node:fs");
-const promises_1 = require("node:fs/promises");
 const node_path_1 = require("node:path");
 const types_1 = require("@playdrop/types");
-const config_1 = require("../config");
-const apiClient_1 = require("../apiClient");
 const http_1 = require("../http");
-const environment_1 = require("../environment");
 const messages_1 = require("../messages");
 const catalogue_utils_1 = require("../catalogue-utils");
 const devShared_1 = require("./devShared");
 const devServer_1 = require("./devServer");
-const playwright_1 = require("../playwright");
-const MAX_CAPTURE_TIMEOUT_SECONDS = 600;
-function validateTimeout(value) {
-    if (value === undefined || Number.isNaN(value)) {
-        return 5;
-    }
-    if (!Number.isFinite(value) || value <= 0) {
-        throw new Error('Timeout must be a positive number of seconds.');
-    }
-    if (value > MAX_CAPTURE_TIMEOUT_SECONDS) {
-        throw new Error(`Timeout cannot exceed ${MAX_CAPTURE_TIMEOUT_SECONDS} seconds (10 minutes).`);
-    }
-    return value;
-}
-function formatAppTypeSlug(type) {
-    switch (type) {
-        case 'TOOL':
-            return 'tool';
-        case 'TEMPLATE':
-            return 'template';
-        case 'DEMO':
-            return 'demo';
-        case undefined:
-            return 'game';
-        default:
-            return 'game';
-    }
-}
-function formatConsoleValue(value) {
-    if (typeof value === 'string')
-        return value;
-    if (typeof value === 'number' || typeof value === 'boolean' || value === null) {
-        return String(value);
-    }
-    if (typeof value === 'undefined') {
-        return 'undefined';
-    }
-    if (typeof value === 'function') {
-        return '[function]';
-    }
-    if (typeof value === 'object') {
-        try {
-            return JSON.stringify(value);
-        }
-        catch {
-            return '[object]';
-        }
-    }
-    return String(value);
-}
-function serializePayload(payload) {
-    if (payload === undefined) {
-        return '';
-    }
-    if (typeof payload === 'string') {
-        return payload;
-    }
-    try {
-        return JSON.stringify(payload);
-    }
-    catch {
-        return String(payload);
-    }
-}
-const LOG_LEVEL_VALUES = ['debug', 'info', 'warn', 'error'];
+const commandContext_1 = require("../commandContext");
+const appUrls_1 = require("../appUrls");
+const captureRuntime_1 = require("../captureRuntime");
 const MOBILE_USER_AGENT = 'Mozilla/5.0 (iPhone; CPU iPhone OS 16_0 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/16.0 Mobile/15E148 Safari/604.1';
 const SURFACE_PRESETS = {
     desktop: {
@@ -111,42 +45,6 @@ const SURFACE_PRESETS = {
     },
 };
 const SURFACE_ORDER = ['desktop', 'mobileLandscape', 'mobilePortrait'];
-function resolveLogLevel(value) {
-    if (!value)
-        return 'info';
-    const normalized = value.trim().toLowerCase();
-    if (LOG_LEVEL_VALUES.includes(normalized)) {
-        return normalized;
-    }
-    throw new Error(`Unsupported log level "${value}". Choose one of: ${LOG_LEVEL_VALUES.join(', ')}`);
-}
-function severityOrder(level) {
-    switch (level) {
-        case 'debug':
-            return 0;
-        case 'info':
-            return 1;
-        case 'warn':
-            return 2;
-        case 'error':
-            return 3;
-        default:
-            return 1;
-    }
-}
-function mapConsoleTypeToLevel(type) {
-    const normalized = type.toLowerCase();
-    if (normalized === 'debug')
-        return 'debug';
-    if (normalized === 'warning' || normalized === 'warn')
-        return 'warn';
-    if (normalized === 'error' || normalized === 'assert' || normalized === 'trace')
-        return 'error';
-    return 'info';
-}
-function shouldEmit(level, threshold) {
-    return severityOrder(level) >= severityOrder(threshold);
-}
 function normalizeSurfaceOverride(value) {
     if (!value)
         return null;
@@ -187,43 +85,38 @@ function formatSurfaceList(targets) {
     }
     return enabled.join(', ');
 }
+function resolveCaptureLoginOverride(options) {
+    const username = options.username?.trim() || '';
+    const password = options.password || '';
+    if ((username && !password) || (!username && password)) {
+        throw new Error('invalid_credentials_pair');
+    }
+    if (!username) {
+        return null;
+    }
+    return { username, password };
+}
+// eslint-disable-next-line max-lines-per-function
 async function capture(targetArg, options = {}) {
-    const timeoutSeconds = validateTimeout(options.timeoutSeconds);
+    const timeoutSeconds = (0, captureRuntime_1.validateCaptureTimeout)(options.timeoutSeconds);
     const timeoutMs = Math.round(timeoutSeconds * 1000);
     let minimumLogLevel;
+    let loginOverride;
     try {
-        minimumLogLevel = resolveLogLevel(options.logLevel);
+        minimumLogLevel = (0, captureRuntime_1.resolveCaptureLogLevel)(options.logLevel);
+        loginOverride = resolveCaptureLoginOverride(options);
     }
     catch (error) {
-        (0, messages_1.printErrorWithHelp)(error?.message || 'Invalid log level.', [`Valid values: ${LOG_LEVEL_VALUES.join(', ')}`], { command: 'project capture' });
-        process.exitCode = 1;
-        return;
-    }
-    const screenshotPath = options.screenshotPath
-        ? (0, node_path_1.resolve)(process.cwd(), options.screenshotPath)
-        : null;
-    const cfg = (0, config_1.loadConfig)();
-    if (!cfg.env) {
-        (0, messages_1.printConfigEnvironmentMissing)('project capture');
-        process.exitCode = 1;
-        return;
-    }
-    if (!cfg.token) {
-        (0, messages_1.printLoginRequired)('Capturing app logs', 'project capture');
-        process.exitCode = 1;
-        return;
-    }
-    const envConfig = (0, environment_1.resolveEnvironmentConfig)(cfg.env);
-    if (!envConfig) {
-        const choices = (0, environment_1.formatEnvironmentList)();
-        (0, messages_1.printUnknownEnvironment)(cfg.env, choices, 'project capture');
+        if (error instanceof Error && error.message === 'invalid_credentials_pair') {
+            (0, messages_1.printErrorWithHelp)('Use --username and --password together.', [], { command: 'project capture' });
+        }
+        else {
+            (0, messages_1.printErrorWithHelp)(error?.message || 'Invalid log level.', ['Valid values: debug, info, warn, error'], { command: 'project capture' });
+        }
         process.exitCode = 1;
         return;
     }
-    if (envConfig.allowInsecureRequests) {
-        process.env.NODE_TLS_REJECT_UNAUTHORIZED = '0';
-    }
-    const client = (0, apiClient_1.createCliApiClient)({ baseUrl: envConfig.apiBase, token: cfg.token });
+    const screenshotPath = options.screenshotPath ? (0, node_path_1.resolve)(process.cwd(), options.screenshotPath) : null;
     const portToUse = 8888;
     let resolvedTarget;
     try {
@@ -293,11 +186,11 @@ async function capture(targetArg, options = {}) {
         ? ` (${surfaceContextOptions.viewport.width}x${surfaceContextOptions.viewport.height})`
         : '';
     console.log(`[capture] Surface: ${surfacePreset.label}${viewportLabel}`);
-    let appTypeSlug = 'game';
+    let appTypeSlug = (0, appUrls_1.getAppTypeSlug)(null);
     try {
         const match = (0, catalogue_utils_1.findAppDefinition)(filePath);
         appName = match.name;
-        appTypeSlug = formatAppTypeSlug(match.type);
+        appTypeSlug = (0, appUrls_1.getAppTypeSlug)(match.type);
     }
     catch (error) {
         if (resolvedTarget.cataloguePath) {
@@ -309,374 +202,184 @@ async function capture(targetArg, options = {}) {
             return;
         }
     }
-    let currentUser = null;
-    let currentUsername = '';
-    try {
-        currentUser = await (0, devShared_1.fetchDevUser)(client);
-        currentUsername = currentUser.username.trim();
-    }
-    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 login" to refresh your session and ensure the API is reachable.',
-                'Use "playdrop whoami" afterwards to confirm your status.',
-            ], { command: 'project capture' });
-            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 capture');
-            process.exitCode = 1;
-            return;
-        }
-        if (error instanceof Error && error.message === 'DEV_USERNAME_EMPTY') {
-            (0, messages_1.printErrorWithHelp)('Could not determine your Playdrop creator username.', [
-                'Retry "playdrop project capture" in a moment.',
-                'If the problem persists, contact the Playdrop team.'
-            ], { command: 'project capture' });
-            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, 'Capture');
-            process.exitCode = 1;
-            return;
+    const projectInfo = (0, devShared_1.findProjectInfo)(filePath);
+    const devScriptAvailable = Boolean(projectInfo.projectDir && projectInfo.packageJson && typeof projectInfo.packageJson.scripts?.dev === 'string');
+    await (0, commandContext_1.withEnvironment)('project capture', 'Capturing app logs', async ({ client, env, envConfig, token }) => {
+        let currentUser = null;
+        let currentUsername = '';
+        try {
+            currentUser = await (0, devShared_1.fetchDevUser)(client);
+            currentUsername = currentUser.username.trim();
         }
-        if (error instanceof types_1.ApiError) {
-            if (error.status === 404) {
-                (0, messages_1.printErrorWithHelp)(`App ${currentUsername}/${appName} is not registered on ${cfg.env}.`, [
-                    `Run "playdrop project create app ${appName}" to register the app before running capture.`,
-                    'If you expected it to exist, ensure you are logged into the correct environment.'
-                ], { command: 'project capture' });
+        catch (error) {
+            if (error instanceof http_1.CLIUnsupportedClientError) {
+                return;
             }
-            else {
-                (0, messages_1.printErrorWithHelp)(`Failed to verify app registration (status ${error.status}).`, [
-                    'Retry in a moment.',
-                    'If the issue persists, contact the Playdrop team.'
+            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 and ensure the API is reachable.',
+                    'Use "playdrop auth whoami" afterwards to confirm your status.',
                 ], { command: 'project capture' });
+                process.exitCode = 1;
+                return;
             }
-            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 capture');
-            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(`[capture] Preparing ${entryLabel} for ${cfg.env} (${appTypeSlug}).`);
-    const serverAlreadyRunning = await (0, devServer_1.isDevServerAvailable)(appName, portToUse, 750);
-    const devServerStartedByCapture = !serverAlreadyRunning;
-    let serverHandle = null;
-    let signalHandler = null;
-    let cleanupRequested = false;
-    const cleanup = async () => {
-        if (cleanupRequested)
-            return;
-        cleanupRequested = true;
-        if (serverHandle) {
-            try {
-                await serverHandle.close();
+            if ((0, devShared_1.isNetworkError)(error)) {
+                (0, messages_1.printNetworkIssue)('Could not reach the Playdrop API to resolve your account.', 'project capture');
+                process.exitCode = 1;
+                return;
             }
-            catch (error) {
-                console.error(error instanceof Error ? error.message : String(error));
+            if (error instanceof Error && error.message === 'DEV_USERNAME_EMPTY') {
+                (0, messages_1.printErrorWithHelp)('Could not determine your Playdrop creator username.', [
+                    'Retry "playdrop project capture" in a moment.',
+                    'If the problem persists, contact the Playdrop team.',
+                ], { command: 'project capture' });
+                process.exitCode = 1;
+                return;
             }
+            throw error;
         }
-    };
-    if (serverAlreadyRunning) {
-        console.log(`[capture] Reusing dev server at http://localhost:${portToUse}/apps/${appName}.html`);
-    }
-    else {
         try {
-            serverHandle = await (0, devServer_1.startDevServer)({
-                appName,
-                htmlPath: filePath,
-                port: portToUse,
-                projectInfo,
-            });
-            signalHandler = () => {
-                void cleanup().finally(() => process.exit(130));
-            };
-            process.on('SIGINT', signalHandler);
-            process.on('SIGTERM', signalHandler);
+            await (0, devShared_1.assertAppRegistered)(client, currentUsername, appName);
         }
         catch (error) {
-            (0, messages_1.printErrorWithHelp)(error?.message || `Failed to start dev server on port ${portToUse}.`, [
-                'Check if another process is already using the port.',
-                'Ensure the HTML file exists and is readable.',
-            ], { command: 'project capture' });
-            process.exitCode = 1;
-            return;
-        }
-    }
-    if (!serverAlreadyRunning && projectInfo.projectDir && !devScriptAvailable && projectInfo.packageJsonPath) {
-        const projectLabel = (0, devShared_1.formatProjectLabel)(projectInfo);
-        if (projectLabel) {
-            console.log(`[capture] package.json detected at ${projectLabel}, but no "dev" script was found. Run your build/watch scripts manually if needed.`);
-        }
-    }
-    if (devServerStartedByCapture) {
-        await new Promise(resolve => setTimeout(resolve, 1000));
-    }
-    const webBase = envConfig.webBase ?? 'https://www.playdrop.ai';
-    const frameUrl = `${webBase}/creators/${encodeURIComponent(currentUsername)}/apps/${appTypeSlug}/${encodeURIComponent(appName)}/dev`;
-    console.log(`[capture] Launching Playwright against ${frameUrl}`);
-    const errors = [];
-    const handleConsoleMessage = async (message) => {
-        const type = message.type();
-        const level = mapConsoleTypeToLevel(type);
-        const originPage = message.page();
-        const originLabel = originPage ? originPage.url() : 'worker';
-        const location = message.location();
-        const locationLabel = location && location.url
-            ? `${location.url}:${location.lineNumber ?? 0}:${location.columnNumber ?? 0}`
-            : undefined;
-        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 prefix = `[capture][console:${type}]`;
-        const components = [prefix, rendered].filter(Boolean);
-        const line = components.join(' ');
-        let effectiveLevel = level;
-        if (level === 'warn' && line.includes('GL Driver Message')) {
-            effectiveLevel = 'debug';
-        }
-        const allowed = shouldEmit(effectiveLevel, minimumLogLevel);
-        if (type === 'error' || type === 'assert' || type === 'trace') {
-            errors.push(line);
-            if (allowed) {
-                console.error(line);
+            if (error instanceof http_1.CLIUnsupportedClientError) {
+                return;
             }
-            return;
-        }
-        if (!allowed) {
-            return;
-        }
-        if (effectiveLevel === 'warn') {
-            console.warn(line);
-        }
-        else if (effectiveLevel === 'info') {
-            console.info(line);
-        }
-        else if (effectiveLevel === 'debug') {
-            console.debug(line);
-        }
-        else {
-            console.log(line);
-        }
-    };
-    try {
-        await (0, playwright_1.withChromiumPage)(async ({ page }) => {
-            await page.addInitScript(({ token, user }) => {
-                try {
-                    if (token) {
-                        window.localStorage.setItem('playdrop.accessToken', token);
-                    }
-                }
-                catch {
-                    // ignore storage errors
-                }
-                try {
-                    if (user) {
-                        window.localStorage.setItem('playdrop.user', JSON.stringify(user));
-                    }
-                }
-                catch {
-                    // ignore storage errors
-                }
-                try {
-                    window.sessionStorage.removeItem('playdrop.logoutReason');
-                }
-                catch {
-                    // ignore storage errors
-                }
-            }, { token: cfg.token, user: currentUser });
-            await page.exposeBinding('__playdropCaptureLog', async ({ frame }, type, payload) => {
-                const normalized = typeof type === 'string' ? type.toLowerCase() : 'info';
-                const level = normalized === 'error' || normalized === 'fatal'
-                    ? 'error'
-                    : normalized === 'warn' || normalized === 'warning'
-                        ? 'warn'
-                        : normalized === 'debug'
-                            ? 'debug'
-                            : 'info';
-                const frameUrl = frame?.url();
-                const serialized = serializePayload(payload);
-                const parts = ['[capture][custom]', normalized, serialized].filter(Boolean);
-                const line = parts.join(' ');
-                const allowed = shouldEmit(level, minimumLogLevel);
-                if (level === 'error') {
-                    errors.push(line);
-                    if (allowed) {
-                        console.error(line);
-                    }
-                    return;
-                }
-                if (!allowed) {
-                    return;
-                }
-                if (level === 'warn') {
-                    console.warn(line);
-                }
-                else if (level === 'debug') {
-                    console.debug(line);
+            if (error instanceof types_1.UnsupportedClientError) {
+                (0, http_1.handleUnsupportedError)(error, 'Capture');
+                process.exitCode = 1;
+                return;
+            }
+            if (error instanceof types_1.ApiError) {
+                if (error.status === 404) {
+                    (0, messages_1.printErrorWithHelp)(`App ${currentUsername}/${appName} is not registered on ${env}.`, [
+                        `Run "playdrop project create app ${appName}" to register the app before running capture.`,
+                        'If you expected it to exist, ensure you are logged into the correct environment.',
+                    ], { command: 'project capture' });
                 }
                 else {
-                    console.log(line);
-                }
-            });
-            await page.addInitScript(() => {
-                window.addEventListener('unhandledrejection', event => {
-                    try {
-                        console.error('[capture][unhandledrejection]', event.reason);
-                    }
-                    catch {
-                        console.error('[capture][unhandledrejection]');
-                    }
-                });
-                const bridgeWindow = window;
-                bridgeWindow.playdrop = bridgeWindow.playdrop || {};
-                const bridge = (type, payload) => {
-                    try {
-                        const binding = bridgeWindow.__playdropCaptureLog;
-                        if (typeof binding === 'function') {
-                            binding(type, payload);
-                        }
-                    }
-                    catch (error) {
-                        console.error('[capture][bridge-error]', error);
-                    }
-                };
-                Object.defineProperty(bridgeWindow.playdrop, 'capture', {
-                    value: bridge,
-                    configurable: true,
-                    writable: true,
-                });
-            });
-            page.on('console', message => {
-                void handleConsoleMessage(message);
-            });
-            page.on('pageerror', error => {
-                const text = error?.message ?? String(error);
-                errors.push(text);
-                if (shouldEmit('error', minimumLogLevel)) {
-                    console.error(`[capture][pageerror] ${text}`);
+                    (0, messages_1.printErrorWithHelp)(`Failed to verify app registration (status ${error.status}).`, [
+                        'Retry in a moment.',
+                        'If the issue persists, contact the Playdrop team.',
+                    ], { command: 'project capture' });
                 }
-            });
-            page.on('requestfailed', request => {
-                const failure = request.failure();
-                const errorText = failure?.errorText ?? '';
-                const text = `${request.method()} ${request.url()} - ${errorText || 'failed'}`;
-                if (/ERR_ABORTED/i.test(errorText) || /ERR_HTTP2_PROTOCOL_ERROR/i.test(errorText)) {
-                    if (shouldEmit('debug', minimumLogLevel)) {
-                        console.debug(`[capture][requestcancelled] ${text}`);
-                    }
-                    return;
-                }
-                errors.push(text);
-                if (shouldEmit('warn', minimumLogLevel)) {
-                    console.error(`[capture][requestfailed] ${text}`);
-                }
-            });
-            page.on('response', response => {
-                const status = response.status();
-                if (status >= 400) {
-                    const text = `${status} ${response.statusText()} ${response.url()}`;
-                    if (status === 404 && /\\?playdrop_channel=/.test(response.url())) {
-                        if (shouldEmit('debug', minimumLogLevel)) {
-                            console.debug(`[capture][response-reload] ${text}`);
-                        }
-                        return;
-                    }
-                    errors.push(text);
-                    if (shouldEmit('warn', minimumLogLevel)) {
-                        console.error(`[capture][response] ${text}`);
-                    }
-                }
-            });
-            const response = await page.goto(frameUrl, { waitUntil: 'domcontentloaded', timeout: 30000 });
-            if (response && !response.ok()) {
-                const statusText = `${response.status()} ${response.statusText()}`;
-                console.warn(`[capture] Navigation succeeded with non-OK status: ${statusText}`);
+                process.exitCode = 1;
+                return;
             }
-            await page.waitForTimeout(timeoutMs);
-            if (screenshotPath) {
+            if ((0, devShared_1.isNetworkError)(error)) {
+                (0, messages_1.printNetworkIssue)('Could not reach the Playdrop API to verify the app registration.', 'project capture');
+                process.exitCode = 1;
+                return;
+            }
+            throw error;
+        }
+        const entryLabel = (0, node_path_1.relative)(process.cwd(), filePath) || filePath;
+        console.log(`[capture] Preparing ${entryLabel} for ${env} (${appTypeSlug}).`);
+        const serverAlreadyRunning = await (0, devServer_1.isDevServerAvailable)(appName, portToUse, 750);
+        const devServerStartedByCapture = !serverAlreadyRunning;
+        let serverHandle = null;
+        let signalHandler = null;
+        let cleanupRequested = false;
+        const cleanup = async () => {
+            if (cleanupRequested)
+                return;
+            cleanupRequested = true;
+            if (serverHandle) {
                 try {
-                    const targetDir = (0, node_path_1.dirname)(screenshotPath);
-                    if (targetDir && targetDir !== '.' && targetDir !== '/') {
-                        await (0, promises_1.mkdir)(targetDir, { recursive: true });
-                    }
-                    await page.screenshot({ path: screenshotPath, fullPage: true });
-                    const relativePath = (0, node_path_1.relative)(process.cwd(), screenshotPath) || screenshotPath;
-                    console.log(`[capture] Saved screenshot to ${relativePath}`);
+                    await serverHandle.close();
                 }
                 catch (error) {
-                    const reason = error?.message ?? String(error);
-                    errors.push(`screenshot_failed: ${reason}`);
-                    console.error(`[capture] Failed to write screenshot: ${reason}`);
+                    console.error(error instanceof Error ? error.message : String(error));
                 }
             }
-        }, surfaceContextOptions);
-    }
-    catch (error) {
-        if (error instanceof http_1.CLIUnsupportedClientError) {
-            return;
+        };
+        if (serverAlreadyRunning) {
+            console.log(`[capture] Reusing dev server at http://localhost:${portToUse}/apps/${appName}.html`);
         }
-        if (error instanceof types_1.UnsupportedClientError) {
-            (0, http_1.handleUnsupportedError)(error, 'Capture');
-            process.exitCode = 1;
-            return;
+        else {
+            try {
+                serverHandle = await (0, devServer_1.startDevServer)({
+                    appName,
+                    htmlPath: filePath,
+                    port: portToUse,
+                    projectInfo,
+                });
+                signalHandler = () => {
+                    void cleanup().finally(() => process.exit(130));
+                };
+                process.on('SIGINT', signalHandler);
+                process.on('SIGTERM', signalHandler);
+            }
+            catch (error) {
+                (0, messages_1.printErrorWithHelp)(error?.message || `Failed to start dev server on port ${portToUse}.`, [
+                    'Check if another process is already using the port.',
+                    'Ensure the HTML file exists and is readable.',
+                ], { command: 'project capture' });
+                process.exitCode = 1;
+                return;
+            }
+        }
+        if (!serverAlreadyRunning && projectInfo.projectDir && !devScriptAvailable && projectInfo.packageJsonPath) {
+            const projectLabel = (0, devShared_1.formatProjectLabel)(projectInfo);
+            if (projectLabel) {
+                console.log(`[capture] package.json detected at ${projectLabel}, but no "dev" script was found. Run your build/watch scripts manually if needed.`);
+            }
         }
-        const message = error instanceof Error ? error.message : String(error);
-        if (/browserType\.launch/i.test(message) || /MachPortRendezvousServer/i.test(message) || /Chromium/i.test(message)) {
-            const launchError = (0, playwright_1.createPlaywrightLaunchError)('playdrop project capture', error);
-            console.error(launchError.message);
+        if (devServerStartedByCapture) {
+            await new Promise(resolve => setTimeout(resolve, 1000));
         }
-        else if (error instanceof Error && error.stack) {
-            console.error(error.stack);
+        const webBase = envConfig.webBase ?? 'https://www.playdrop.ai';
+        const frameUrl = `${webBase}/creators/${encodeURIComponent(currentUsername)}/apps/${appTypeSlug}/${encodeURIComponent(appName)}/dev`;
+        console.log(`[capture] Launching Playwright against ${frameUrl}`);
+        try {
+            const result = await (0, captureRuntime_1.runCapture)({
+                targetUrl: frameUrl,
+                expectedUrl: frameUrl,
+                timeoutMs,
+                minimumLogLevel,
+                screenshotPath,
+                contextOptions: surfaceContextOptions,
+                token: loginOverride ? undefined : token,
+                user: loginOverride ? undefined : currentUser,
+                login: loginOverride,
+                enableCaptureBridge: true,
+            });
+            if (result.errorCount > 0) {
+                console.error(`[capture] Completed with ${result.errorCount} error(s) after ${timeoutSeconds} seconds.`);
+                process.exitCode = 1;
+            }
+            else {
+                console.log(`[capture] Completed without console errors after ${timeoutSeconds} seconds.`);
+            }
         }
-        else {
-            console.error(`[capture] ${message}`);
+        catch (error) {
+            if (error instanceof http_1.CLIUnsupportedClientError) {
+                return;
+            }
+            if (error instanceof types_1.UnsupportedClientError) {
+                (0, http_1.handleUnsupportedError)(error, 'Capture');
+                process.exitCode = 1;
+                return;
+            }
+            if (error instanceof Error && error.stack) {
+                console.error(error.stack);
+            }
+            else {
+                console.error(`[capture] ${error instanceof Error ? error.message : String(error)}`);
+            }
+            process.exitCode = 1;
         }
-        process.exitCode = 1;
-        return;
-    }
-    finally {
-        if (signalHandler) {
-            process.off('SIGINT', signalHandler);
-            process.off('SIGTERM', signalHandler);
+        finally {
+            if (signalHandler) {
+                process.off('SIGINT', signalHandler);
+                process.off('SIGTERM', signalHandler);
+            }
+            await cleanup();
         }
-        await cleanup();
-    }
-    if (errors.length > 0) {
-        console.error(`[capture] Completed with ${errors.length} error(s) after ${timeoutSeconds} seconds.`);
-        process.exitCode = 1;
-    }
-    else {
-        console.log(`[capture] Completed without console errors after ${timeoutSeconds} seconds.`);
-    }
+    });
 }