@playdrop/playdrop-cli 0.4.0 → 0.4.2

package/dist/commands/login.js

@@ -1,54 +1,19 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.setOpenBrowserForTests = setOpenBrowserForTests;
-exports.resetOpenBrowserForTests = resetOpenBrowserForTests;
+exports.setOpenBrowserForTests = exports.resetOpenBrowserForTests = void 0;
 exports.login = login;
-const node_child_process_1 = require("node:child_process");
 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 browser_1 = require("../browser");
+Object.defineProperty(exports, "resetOpenBrowserForTests", { enumerable: true, get: function () { return browser_1.resetOpenBrowserForTests; } });
+Object.defineProperty(exports, "setOpenBrowserForTests", { enumerable: true, get: function () { return browser_1.setOpenBrowserForTests; } });
 const messages_1 = require("../messages");
 function sleep(ms) {
     return new Promise((resolve) => setTimeout(resolve, ms));
 }
-function getBrowserCommand(url) {
-    if (process.platform === 'darwin') {
-        return { command: 'open', args: [url] };
-    }
-    if (process.platform === 'win32') {
-        return { command: 'cmd', args: ['/c', 'start', '', url] };
-    }
-    if (process.platform === 'linux') {
-        return { command: 'xdg-open', args: [url] };
-    }
-    return null;
-}
-async function defaultOpenBrowser(url) {
-    const command = getBrowserCommand(url);
-    if (!command) {
-        return false;
-    }
-    return await new Promise((resolve) => {
-        const child = (0, node_child_process_1.spawn)(command.command, command.args, {
-            detached: true,
-            stdio: 'ignore',
-        });
-        child.once('error', () => resolve(false));
-        child.once('spawn', () => {
-            child.unref();
-            resolve(true);
-        });
-    });
-}
-let openBrowser = defaultOpenBrowser;
-function setOpenBrowserForTests(fn) {
-    openBrowser = fn;
-}
-function resetOpenBrowserForTests() {
-    openBrowser = defaultOpenBrowser;
-}
 function extractAccessToken(data) {
     return data.accessToken
         ?? (typeof data === 'object' && data !== null && 'token' in data ? data.token : undefined);
@@ -69,7 +34,7 @@ function storeLogin(env, data) {
     (0, config_1.saveConfig)({ token, env });
     const username = data.user?.username ?? 'unknown';
     console.log(`Logged in as ${username} on ${env}.`);
-    console.log('Next: run "playdrop whoami" to confirm your session.');
+    console.log('Next: run "playdrop auth whoami" to confirm your session.');
 }
 async function loginWithUsernamePassword(env, baseUrl, username, password) {
     const client = (0, apiClient_1.createCliApiClient)({ baseUrl });
@@ -84,8 +49,8 @@ async function loginWithUsernamePassword(env, baseUrl, username, password) {
         }
         if (unknownError instanceof types_1.ApiError) {
             (0, messages_1.printErrorWithHelp)(`Login failed with status ${unknownError.status}.`, [
-                'Verify your username and password, then rerun "playdrop login".',
-                'Use "playdrop whoami" after logging in to confirm your status.',
+                'Verify your username and password, then rerun "playdrop auth login".',
+                'Use "playdrop auth whoami" after logging in to confirm your status.',
             ], { command: 'login' });
             process.exitCode = 1;
             return;
@@ -106,8 +71,8 @@ async function loginWithKey(env, baseUrl, apiKey) {
         }
         if (unknownError instanceof types_1.ApiError) {
             (0, messages_1.printErrorWithHelp)(`Login failed with status ${unknownError.status}.`, [
-                'Verify your API key, then rerun "playdrop login --key <api-key>".',
-                'Use "playdrop whoami" after logging in to confirm your status.',
+                'Verify your API key, then rerun "playdrop auth login --key <api-key>".',
+                'Use "playdrop auth whoami" after logging in to confirm your status.',
             ], { command: 'login' });
             process.exitCode = 1;
             return;
@@ -137,7 +102,7 @@ async function loginInBrowser(env, baseUrl) {
         throw unknownError;
     }
     console.log(`Open this URL to continue: ${flow.loginUrl}`);
-    const opened = await openBrowser(flow.loginUrl).catch(() => false);
+    const opened = await (0, browser_1.openBrowserUrl)(flow.loginUrl).catch(() => false);
     if (opened) {
         console.log('Opened the login page in your browser.');
     }
@@ -170,13 +135,13 @@ async function loginInBrowser(env, baseUrl) {
             if (unknownError instanceof types_1.ApiError) {
                 if (unknownError.status === 410 || unknownError.code === 'cli_login_expired') {
                     (0, messages_1.printErrorWithHelp)('Browser login expired before it was approved.', [
-                        'Rerun "playdrop login" to start a new browser login request.',
+                        'Rerun "playdrop auth login" to start a new browser login request.',
                     ], { command: 'login' });
                     process.exitCode = 1;
                     return;
                 }
                 (0, messages_1.printErrorWithHelp)(`Browser login failed with status ${unknownError.status}.`, [
-                    'Rerun "playdrop login" to try again.',
+                    'Rerun "playdrop auth login" to try again.',
                 ], { command: 'login' });
                 process.exitCode = 1;
                 return;
@@ -185,7 +150,7 @@ async function loginInBrowser(env, baseUrl) {
         }
     }
     (0, messages_1.printErrorWithHelp)('Browser login timed out after 10 minutes.', [
-        'Rerun "playdrop login" to start a new browser login request.',
+        'Rerun "playdrop auth login" to start a new browser login request.',
     ], { command: 'login' });
     process.exitCode = 1;
 }
@@ -205,7 +170,7 @@ async function login(env, options = {}) {
     const apiKey = options.key?.trim();
     if (apiKey && (username || password)) {
         (0, messages_1.printErrorWithHelp)('Choose exactly one login method.', [
-            'Use "playdrop login" for browser login.',
+            'Use "playdrop auth login" for browser login.',
             'Use "--username" with "--password" for direct login.',
             'Use "--key" by itself for API key login.',
         ], { command: 'login' });
@@ -214,8 +179,8 @@ async function login(env, options = {}) {
     }
     if ((username && !password) || (!username && password)) {
         (0, messages_1.printErrorWithHelp)('Provide both "--username" and "--password" together.', [
-            'Rerun "playdrop login --username <username> --password <password>".',
-            'Or run "playdrop login" to use browser login instead.',
+            'Rerun "playdrop auth login --username <username> --password <password>".',
+            'Or run "playdrop auth login" to use browser login instead.',
         ], { command: 'login' });
         process.exitCode = 1;
         return;

package/dist/commands/logout.js

@@ -5,5 +5,5 @@ const config_1 = require("../config");
 function logout() {
     (0, config_1.clearConfig)();
     console.log('Logged out.');
-    console.log('Next: run "playdrop login" when you need a new session.');
+    console.log('Next: run "playdrop auth login" when you need a new session.');
 }

package/dist/commands/notifications.js

@@ -116,7 +116,7 @@ async function browseNotifications(options = {}) {
             const handled = (0, errors_1.handleCommandFailure)(error, 'notifications browse', 'Notification lookup', {
                 apiMessage: (apiError) => ({
                     problem: `Notification lookup failed with status ${apiError.status}.`,
-                    suggestions: ['Run "playdrop login" and retry.'],
+                    suggestions: ['Run "playdrop auth login" and retry.'],
                 }),
             });
             if (!handled) {
@@ -145,7 +145,7 @@ async function readNotification(rawId, options = {}) {
             const handled = (0, errors_1.handleCommandFailure)(error, 'notifications read', 'Notification update', {
                 apiMessage: (apiError) => ({
                     problem: `Notification update failed with status ${apiError.status}.`,
-                    suggestions: ['Run "playdrop login" and retry.'],
+                    suggestions: ['Run "playdrop auth login" and retry.'],
                 }),
             });
             if (!handled) {
@@ -168,7 +168,7 @@ async function readAllNotifications(options = {}) {
             const handled = (0, errors_1.handleCommandFailure)(error, 'notifications read-all', 'Notification update', {
                 apiMessage: (apiError) => ({
                     problem: `Notification update failed with status ${apiError.status}.`,
-                    suggestions: ['Run "playdrop login" and retry.'],
+                    suggestions: ['Run "playdrop auth login" and retry.'],
                 }),
             });
             if (!handled) {

package/dist/commands/play.d.ts

@@ -0,0 +1,5 @@
+type PlayOptions = {
+    json?: boolean;
+};
+export declare function play(rawRef: string | undefined, options?: PlayOptions): Promise<void>;
+export {};

package/dist/commands/play.js

@@ -0,0 +1,102 @@
+"use strict";
+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 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) {
+    (0, messages_1.printErrorWithHelp)('A canonical app ref is required.', [
+        'Use the format <creator>/app/<name>.',
+        'Example: playdrop play playdrop/app/hangingout',
+    ], { command: 'play' });
+    process.exitCode = 1;
+}
+async function play(rawRef, options = {}) {
+    let ref;
+    try {
+        ref = (0, refs_1.parseContentRef)(rawRef ?? '');
+    }
+    catch {
+        printPlayRefValidationError(rawRef);
+        return;
+    }
+    if (ref.kind !== 'app') {
+        (0, messages_1.printErrorWithHelp)('The play command only supports app refs.', [
+            'Use the format <creator>/app/<name>.',
+            'Assets and asset packs do not have authenticated play routes.',
+        ], { command: 'play' });
+        process.exitCode = 1;
+        return;
+    }
+    await (0, commandContext_1.withEnvironment)('play', 'Launching a published app', async ({ client, envConfig }) => {
+        try {
+            const response = await client.fetchAppBySlug(ref.creator, ref.name);
+            const playUrl = (0, appUrls_1.buildPlatformPlayUrl)(envConfig.webBase, {
+                creatorUsername: response.app.creatorUsername,
+                appName: response.app.name,
+                appType: response.app.type,
+            });
+            const playPath = new URL(playUrl).pathname;
+            const launch = await client.startCliWebLaunch({
+                redirectPath: playPath,
+            });
+            const payload = {
+                ref: ref.ref,
+                playUrl,
+                launchUrl: launch.launchUrl,
+                expiresAt: launch.expiresAt,
+            };
+            if (options.json) {
+                (0, output_1.printJson)(payload);
+                return;
+            }
+            console.log(`Play URL: ${playUrl}`);
+            console.log(`Launch URL: ${launch.launchUrl}`);
+            const opened = await (0, browser_1.openBrowserUrl)(launch.launchUrl).catch(() => false);
+            if (opened) {
+                console.log('Opened the app in your browser.');
+            }
+            else {
+                console.log('Open the launch URL above in your browser.');
+            }
+        }
+        catch (error) {
+            if (error instanceof http_1.CLIUnsupportedClientError) {
+                return;
+            }
+            if (error instanceof types_1.UnsupportedClientError) {
+                (0, http_1.handleUnsupportedError)(error, 'Play');
+                process.exitCode = 1;
+                return;
+            }
+            if (error instanceof types_1.ApiError) {
+                if (error.status === 404) {
+                    (0, messages_1.printErrorWithHelp)(`No app was found for "${ref.ref}".`, [
+                        'Check the ref and retry.',
+                        'Run "playdrop browse --kind app" to discover public apps.',
+                    ], { command: 'play' });
+                    process.exitCode = 1;
+                    return;
+                }
+                (0, messages_1.printErrorWithHelp)(`Could not launch "${ref.ref}" (status ${error.status}).`, [
+                    'Run "playdrop auth whoami" to confirm your session.',
+                    'Retry in a moment if the platform was just updated.',
+                ], { command: 'play' });
+                process.exitCode = 1;
+                return;
+            }
+            if ((0, devShared_1.isNetworkError)(error)) {
+                (0, messages_1.printNetworkIssue)('Could not reach the Playdrop API to launch the app.', 'play');
+                process.exitCode = 1;
+                return;
+            }
+            throw error;
+        }
+    });
+}

package/dist/commands/upload.js

@@ -9,14 +9,8 @@ const taskSelection_1 = require("../taskSelection");
 const taskUtils_1 = require("../taskUtils");
 const uploadLog_1 = require("../uploadLog");
 const upload_content_1 = require("./upload-content");
+const appUrls_1 = require("../appUrls");
 const upload_graph_1 = require("./upload-graph");
-const DEFAULT_PORTAL_BASE = 'https://www.playdrop.ai';
-const APP_TYPE_TO_SLUG = {
-    GAME: 'game',
-    DEMO: 'demo',
-    TOOL: 'tool',
-    TEMPLATE: 'template',
-};
 function buildApiUnavailableMessage(apiBase) {
     if (apiBase && typeof apiBase === 'string') {
         return `Could not reach the Playdrop API at ${apiBase}. Check your internet connection, then ensure the server is running before retrying.`;
@@ -57,8 +51,7 @@ async function fetchCurrentUserInfo(client, apiBase) {
     }
 }
 function normalizePortalBase(webBase) {
-    const base = webBase && webBase.trim().length > 0 ? webBase.trim() : DEFAULT_PORTAL_BASE;
-    return base.replace(/\/$/, '');
+    return (0, appUrls_1.normalizePlaydropWebBase)(webBase);
 }
 function normalizeCreatorUsername(username) {
     if (!username)
@@ -70,7 +63,7 @@ function normalizeCreatorUsername(username) {
     return trimmed;
 }
 function buildAppOverviewUrl(base, creator, task) {
-    const typeSlug = APP_TYPE_TO_SLUG[task.type ?? 'GAME'] ?? 'game';
+    const typeSlug = (0, appUrls_1.getAppTypeSlug)(task.type ?? 'GAME');
     const encodedCreator = encodeURIComponent(creator);
     const encodedName = encodeURIComponent(task.name);
     return `${base}/creators/${encodedCreator}/apps/${typeSlug}/${encodedName}/overview`;
@@ -194,6 +187,11 @@ async function uploadAppTask(state, task, taskCreator, options) {
         entityId: buildTaskEntityId(task, taskCreator),
         catalogue: task.cataloguePath,
         detail: `version ${upload.version} created`,
+        playUrl: (0, appUrls_1.buildPlatformPlayUrl)(state.portalBase, {
+            creatorUsername: taskCreator,
+            appName: task.name,
+            appType: task.type ?? 'GAME',
+        }),
     };
     appendOverviewLink(entry, task, state.portalBase, taskCreator);
     return entry;
@@ -345,7 +343,7 @@ async function flushGraphState(client, graphState, results) {
     }
 }
 async function processUploadTasks(client, tasks, owner, ownerUsername, currentUserRole, webBase, options) {
-    const portalBase = webBase ? normalizePortalBase(webBase) : null;
+    const portalBase = normalizePortalBase(webBase);
     const defaultCreator = normalizeCreatorUsername(ownerUsername) ?? owner;
     const results = [];
     let aborted = false;
@@ -427,5 +425,6 @@ async function upload(pathOrName, options) {
         }
         const results = await processUploadTasks(client, tasks, owner, userInfo.username, userInfo.role, envConfig.webBase, options);
         (0, uploadLog_1.printTaskSummary)(results, warnings, { action: 'upload', environment: env });
+        (0, uploadLog_1.printPublishedAppNextSteps)(results);
     });
 }

package/dist/commands/versionsBrowse.js

@@ -6,6 +6,7 @@ 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 parsePositiveInteger(raw, label, fallback) {
     if (raw === undefined) {
         return fallback;
@@ -88,7 +89,10 @@ async function browseVersions(rawRef, options = {}) {
             let entries = [];
             let pagination;
             if (ref.kind === 'app') {
-                const response = await client.listAppVersions(ref.creator, ref.name);
+                const [appDetail, response] = await Promise.all([
+                    client.fetchAppBySlug(ref.creator, ref.name),
+                    client.listAppVersions(ref.creator, ref.name),
+                ]);
                 const listed = response.versions ?? [];
                 const selected = listed.slice(offset, offset + limit);
                 const details = await Promise.all(selected.map(async (version) => {
@@ -102,7 +106,11 @@ async function browseVersions(rawRef, options = {}) {
                         releaseNotes: version.releaseNotes ?? null,
                         isCurrent: Boolean(version.isCurrent),
                         urls: {
-                            play: typeof detail.version.assetUrl === 'string' ? detail.version.assetUrl : null,
+                            play: (0, appUrls_1.buildPlatformPlayUrl)(envConfig.webBase, {
+                                creatorUsername: ref.creator,
+                                appName: ref.name,
+                                appType: appDetail.app.type,
+                            }),
                             source: typeof detail.version.sourceUrl === 'string' ? detail.version.sourceUrl : null,
                         },
                     };
@@ -195,7 +203,7 @@ async function browseVersions(rawRef, options = {}) {
                     if (apiError.status === 401 || apiError.status === 403) {
                         return {
                             problem: `You do not have access to version history for "${ref.ref}".`,
-                            suggestions: ['Run "playdrop login" if this is private content you own.'],
+                            suggestions: ['Run "playdrop auth login" if this is private content you own.'],
                         };
                     }
                     return {

package/dist/commands/whoami.js

@@ -36,8 +36,8 @@ async function whoami() {
             }
             if (unknownError instanceof types_1.ApiError) {
                 (0, messages_1.printErrorWithHelp)(`Request failed with status ${unknownError.status}.`, [
-                    'Run "playdrop login" to refresh your credentials.',
-                    'Use "playdrop whoami" again after logging in to confirm your status.',
+                    'Run "playdrop auth login" to refresh your credentials.',
+                    'Use "playdrop auth whoami" again after logging in to confirm your status.',
                 ], { command: 'whoami' });
                 process.exitCode = 1;
                 return null;
@@ -62,7 +62,7 @@ async function whoami() {
     const username = data.user?.username;
     if (!username) {
         (0, messages_1.printErrorWithHelp)('The Playdrop API returned an unexpected response.', [
-            'Retry "playdrop whoami" in a moment.',
+            'Retry "playdrop auth whoami" in a moment.',
             'If the problem continues, contact the Playdrop team.',
         ], { command: 'whoami' });
         process.exitCode = 1;

package/dist/index.js

@@ -11,6 +11,7 @@ const logout_1 = require("./commands/logout");
 const browse_1 = require("./commands/browse");
 const search_1 = require("./commands/search");
 const detail_1 = require("./commands/detail");
+const play_1 = require("./commands/play");
 const comments_1 = require("./commands/comments");
 const versionsBrowse_1 = require("./commands/versionsBrowse");
 const credits_1 = require("./commands/credits");
@@ -174,6 +175,13 @@ program
     .action(async (ref, opts) => {
     await (0, detail_1.detail)(ref, opts);
 });
+program
+    .command('play <ref>')
+    .description('Open one published app in your browser with your current session')
+    .option('--json', 'Output JSON')
+    .action(async (ref, opts) => {
+    await (0, play_1.play)(ref, opts);
+});
 const comments = program.command('comments').description('Comments for apps, assets, and asset packs');
 comments
     .command('browse <ref>')
@@ -559,11 +567,15 @@ projectCapture
     .option('--timeout <seconds>', 'Capture timeout in seconds')
     .option('--screenshot <path>', 'Screenshot output path')
     .option('--log <path>', 'Log output path')
+    .option('--expected-url <url>', 'Expected final URL after redirects')
     .option('--username <username>', 'Login username')
     .option('--password <password>', 'Login password')
     .option('--login-url <url>', 'Explicit login URL')
-    .action(async (url, opts) => {
-    await (0, captureRemote_1.captureRemote)(url, opts);
+    .action(async (url, _opts, command) => {
+    await (0, captureRemote_1.captureRemote)(url, {
+        ...(command.parent?.opts() ?? {}),
+        ...command.opts(),
+    });
 });
 project
     .command('validate [target]')
@@ -627,7 +639,7 @@ feedback
     await (0, feedback_1.browseFeedback)(opts);
 });
 feedback
-    .command('delete <id>')
+    .command('delete <id>', { hidden: true })
     .description('Delete one feedback entry')
     .option('--json', 'Output JSON')
     .action(async (id, opts) => {

package/dist/messages.js

@@ -28,22 +28,22 @@ function printErrorWithHelp(problem, suggestions, options = {}) {
 }
 function printLoginRequired(context, command) {
     printErrorWithHelp(`${context} requires you to be logged in.`, [
-        'Run "playdrop login" to authenticate.',
-        'Use "playdrop whoami" to verify your current status.',
+        'Run "playdrop auth login" to authenticate.',
+        'Use "playdrop auth whoami" to verify your current status.',
     ], { command });
 }
 function printUnknownEnvironment(env, available, command) {
     const listLine = available ? `Available environments: ${available}.` : '';
     const suggestions = [
         listLine,
-        'Run "playdrop login --env <env>" to store a supported environment before retrying.',
+        'Run "playdrop auth login --env <env>" to store a supported environment before retrying.',
     ].filter(Boolean);
     printErrorWithHelp(`Environment "${env}" is not supported.`, suggestions, { command });
 }
 function printConfigEnvironmentMissing(command) {
     printErrorWithHelp('No environment is configured yet.', [
-        'Run "playdrop login" to choose an environment and save your credentials.',
-        'Use "playdrop whoami" after logging in to confirm your status.',
+        'Run "playdrop auth login" to choose an environment and save your credentials.',
+        'Use "playdrop auth whoami" after logging in to confirm your status.',
     ], { command });
 }
 function printNetworkIssue(context, command) {

package/dist/playwright.d.ts

@@ -1,4 +1,4 @@
-import type { Browser, BrowserContextOptions, Page } from 'playwright-core';
+import type { Browser, BrowserContext, BrowserContextOptions, Page } from 'playwright-core';
 type PlaywrightModule = {
     chromium: {
         launch(options: {
@@ -12,6 +12,7 @@ export declare function setPlaywrightLoader(loader: (() => Promise<PlaywrightMod
 export declare function createPlaywrightLaunchError(tool: string, error: unknown): Error;
 type PageCallback<T> = (context: {
     browser: Browser;
+    context: BrowserContext;
     page: Page;
 }) => Promise<T>;
 export declare function withChromiumPage<T>(callback: PageCallback<T>, contextOptions?: BrowserContextOptions): Promise<T>;

package/dist/playwright.js

@@ -36,6 +36,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.setPlaywrightLoader = setPlaywrightLoader;
 exports.createPlaywrightLaunchError = createPlaywrightLaunchError;
 exports.withChromiumPage = withChromiumPage;
+const node_url_1 = require("node:url");
 const TOOL_NAME = 'playdrop';
 // Force software WebGL so headless model preview generation remains stable on local/dev machines.
 const CHROMIUM_ARGS = [
@@ -47,6 +48,7 @@ const CHROMIUM_ARGS = [
     '--ignore-gpu-blocklist',
 ];
 let customLoader = null;
+const nativeImport = new Function('specifier', 'return import(specifier);');
 function setPlaywrightLoader(loader) {
     customLoader = loader;
 }
@@ -54,6 +56,21 @@ async function loadPlaywright() {
     if (customLoader) {
         return customLoader();
     }
+    const loaderPath = process.env.PLAYDROP_PLAYWRIGHT_LOADER_PATH?.trim();
+    if (loaderPath) {
+        const loaderModule = await nativeImport((0, node_url_1.pathToFileURL)(loaderPath).href);
+        const candidate = loaderModule.loadPlaywright
+            ?? loaderModule.createPlaywrightModule
+            ?? loaderModule.default
+            ?? loaderModule;
+        if (typeof candidate === 'function') {
+            return await candidate();
+        }
+        if (candidate && typeof candidate === 'object' && typeof candidate.chromium?.launch === 'function') {
+            return candidate;
+        }
+        throw new Error(`Invalid Playwright loader module at ${loaderPath}.`);
+    }
     return Promise.resolve().then(() => __importStar(require('playwright-core')));
 }
 function createPlaywrightLaunchError(tool, error) {
@@ -85,7 +102,7 @@ async function withChromiumPage(callback, contextOptions = {}) {
     try {
         context = await browser.newContext(contextOptions);
         const page = await context.newPage();
-        return await callback({ browser, page });
+        return await callback({ browser, context, page });
     }
     finally {
         if (context) {

package/dist/uploadLog.d.ts

@@ -7,9 +7,11 @@ export type TaskLogEntry = {
     entityId: string;
     catalogue: string;
     detail?: string;
+    playUrl?: string | null;
 };
 export declare function formatTaskLogLine(entry: TaskLogEntry): string;
 export declare function printTaskSummary(entries: TaskLogEntry[], warnings: Iterable<string>, options: {
     action: TaskAction;
     environment?: string;
 }): void;
+export declare function printPublishedAppNextSteps(entries: TaskLogEntry[]): void;

package/dist/uploadLog.js

@@ -2,6 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.formatTaskLogLine = formatTaskLogLine;
 exports.printTaskSummary = printTaskSummary;
+exports.printPublishedAppNextSteps = printPublishedAppNextSteps;
 const STATUS_EMOJI = {
     success: '✅',
     skipped: '➖',
@@ -116,3 +117,16 @@ function printTaskSummary(entries, warnings, options) {
     }
     console.log(parts.join(', '));
 }
+function printPublishedAppNextSteps(entries) {
+    const apps = entries.filter((entry) => entry.status === 'success' && entry.entityType === 'app' && entry.playUrl);
+    for (const entry of apps) {
+        const playUrl = entry.playUrl;
+        console.log('');
+        console.log(`Next steps for ${entry.entityId}:`);
+        console.log(`- Manually test the game at ${playUrl} and make sure it is working and up to spec.`);
+        console.log(`- Once satisfied, share the game URL on social media to start having people play it: ${playUrl}`);
+        console.log('- Publish the code on GitHub in a public repo with the playable game link in the README.');
+        console.log('- Set up automation to check player feedback every day using play count, likes, and comments, then come up with improvement ideas from it.');
+        console.log('- Send feedback to Playdrop with "playdrop feedback send" for any bugs or improvement ideas you encountered.');
+    }
+}