@playdrop/playdrop-cli 0.16.2 → 0.16.11

package/dist/commands/dev.js

@@ -19,120 +19,96 @@ const devServer_1 = require("./devServer");
 const tweakStaleness_1 = require("../tweakStaleness");
 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:')) {
-        const ref = rawMessage.slice('dev_runtime_asset_ref_invalid:'.length);
+    const rawMessage = error instanceof Error ? error.message : String(error ?? "unknown_error");
+    if (rawMessage.startsWith("dev_runtime_asset_ref_invalid:")) {
+        const ref = rawMessage.slice("dev_runtime_asset_ref_invalid:".length);
         return {
             message: `Invalid uses.assets ref "${ref}" in catalogue.json.`,
-            suggestions: [
-                'Use an exact canonical asset ref like asset:creator/name@r1.',
-            ],
+            suggestions: ["Use an exact canonical asset ref like asset:creator/name@r1."],
         };
     }
-    if (rawMessage.startsWith('dev_runtime_asset_version_not_found:')) {
-        const ref = rawMessage.slice('dev_runtime_asset_version_not_found:'.length);
+    if (rawMessage.startsWith("dev_runtime_asset_version_not_found:")) {
+        const ref = rawMessage.slice("dev_runtime_asset_version_not_found:".length);
         return {
             message: `Exact direct asset dependency "${ref}" does not exist on the server.`,
-            suggestions: [
-                'Publish that exact asset revision first or update uses.assets to a valid exact ref.',
-            ],
+            suggestions: ["Publish that exact asset revision first or update uses.assets to a valid exact ref."],
         };
     }
-    if (rawMessage.startsWith('dev_runtime_asset_not_public:')) {
-        const ref = rawMessage.slice('dev_runtime_asset_not_public:'.length);
+    if (rawMessage.startsWith("dev_runtime_asset_not_public:")) {
+        const ref = rawMessage.slice("dev_runtime_asset_not_public:".length);
         return {
             message: `Direct asset dependency "${ref}" is not publicly readable for project dev.`,
-            suggestions: [
-                'Make the asset public or remove it from uses.assets for this first-pass dev flow.',
-            ],
+            suggestions: ["Make the asset public or remove it from uses.assets for this first-pass dev flow."],
         };
     }
-    if (rawMessage.startsWith('dev_runtime_pack_ref_invalid:')) {
-        const ref = rawMessage.slice('dev_runtime_pack_ref_invalid:'.length);
+    if (rawMessage.startsWith("dev_runtime_pack_ref_invalid:")) {
+        const ref = rawMessage.slice("dev_runtime_pack_ref_invalid:".length);
         return {
             message: `Invalid uses.packs ref "${ref}" in catalogue.json.`,
-            suggestions: [
-                'Use an exact canonical pack ref like pack:creator/name@1.2.3.',
-            ],
+            suggestions: ["Use an exact canonical pack ref like pack:creator/name@1.2.3."],
         };
     }
-    if (rawMessage.startsWith('dev_runtime_pack_version_not_found:')) {
-        const ref = rawMessage.slice('dev_runtime_pack_version_not_found:'.length);
+    if (rawMessage.startsWith("dev_runtime_pack_version_not_found:")) {
+        const ref = rawMessage.slice("dev_runtime_pack_version_not_found:".length);
         return {
             message: `Exact pack dependency "${ref}" does not exist on the server.`,
-            suggestions: [
-                'Publish that exact pack version first or update uses.packs to a valid exact ref.',
-            ],
+            suggestions: ["Publish that exact pack version first or update uses.packs to a valid exact ref."],
         };
     }
-    if (rawMessage.startsWith('dev_runtime_pack_not_public:')) {
-        const ref = rawMessage.slice('dev_runtime_pack_not_public:'.length);
+    if (rawMessage.startsWith("dev_runtime_pack_not_public:")) {
+        const ref = rawMessage.slice("dev_runtime_pack_not_public:".length);
         return {
             message: `Pack dependency "${ref}" is not publicly readable for project dev.`,
-            suggestions: [
-                'Make the pack public or remove it from uses.packs for this first-pass dev flow.',
-            ],
+            suggestions: ["Make the pack public or remove it from uses.packs for this first-pass dev flow."],
         };
     }
-    if (rawMessage.startsWith('dev_runtime_key_duplicate:')) {
-        const runtimeKey = rawMessage.split(':')[1] ?? 'unknown';
+    if (rawMessage.startsWith("dev_runtime_key_duplicate:")) {
+        const runtimeKey = rawMessage.split(":")[1] ?? "unknown";
         return {
             message: `Duplicate runtimeKey "${runtimeKey}" detected while building dev runtime assets.`,
-            suggestions: [
-                'Give every owned asset and direct dependency a unique runtimeKey in catalogue.json.',
-            ],
+            suggestions: ["Give every owned asset and direct dependency a unique runtimeKey in catalogue.json."],
         };
     }
-    if (rawMessage.startsWith('dev_runtime_owned_asset_duplicate:')) {
-        const ownedAssetName = rawMessage.slice('dev_runtime_owned_asset_duplicate:'.length);
+    if (rawMessage.startsWith("dev_runtime_owned_asset_duplicate:")) {
+        const ownedAssetName = rawMessage.slice("dev_runtime_owned_asset_duplicate:".length);
         return {
             message: `Duplicate owned asset name "${ownedAssetName}" detected in catalogue.json.`,
-            suggestions: [
-                'Owned asset names must be unique inside the app catalogue entry.',
-            ],
+            suggestions: ["Owned asset names must be unique inside the app catalogue entry."],
         };
     }
-    if (rawMessage.startsWith('dev_runtime_asset_files_missing:')) {
-        const ref = rawMessage.slice('dev_runtime_asset_files_missing:'.length);
+    if (rawMessage.startsWith("dev_runtime_asset_files_missing:")) {
+        const ref = rawMessage.slice("dev_runtime_asset_files_missing:".length);
         return {
             message: `Dependency "${ref}" has no runtime file manifest on the server.`,
-            suggestions: [
-                'Republish the dependency so it has declared file roles before using it in project dev.',
-            ],
+            suggestions: ["Republish the dependency so it has declared file roles before using it in project dev."],
         };
     }
-    if (rawMessage.startsWith('dev_runtime_asset_spec_invalid:')) {
-        const [, ref = 'unknown', assetSpecVersion = 'unknown'] = rawMessage.split(':');
+    if (rawMessage.startsWith("dev_runtime_asset_spec_invalid:")) {
+        const [, ref = "unknown", assetSpecVersion = "unknown"] = rawMessage.split(":");
         return {
             message: `Dependency "${ref}" returned an invalid asset spec version ref "${assetSpecVersion}".`,
-            suggestions: [
-                'Republish the dependency with a valid assetSpecVersionRef or remove it from uses.assets.',
-            ],
+            suggestions: ["Republish the dependency with a valid assetSpecVersionRef or remove it from uses.assets."],
         };
     }
-    if (rawMessage.startsWith('dev_runtime_asset_spec_unsupported:')) {
-        const [, ref = 'unknown', assetSpecVersion = 'unknown'] = rawMessage.split(':');
+    if (rawMessage.startsWith("dev_runtime_asset_spec_unsupported:")) {
+        const [, ref = "unknown", assetSpecVersion = "unknown"] = rawMessage.split(":");
         return {
             message: `Dependency "${ref}" uses unsupported custom asset version "${assetSpecVersion}" for this app.`,
             suggestions: [
-                'Update assetSpecSupport in catalogue.json or pin uses.assets to a supported custom asset revision.',
+                "Update assetSpecSupport in catalogue.json or pin uses.assets to a supported custom asset revision.",
             ],
         };
     }
-    if (rawMessage.startsWith('dev_runtime_app_type_missing:')) {
-        const appName = rawMessage.slice('dev_runtime_app_type_missing:'.length);
+    if (rawMessage.startsWith("dev_runtime_app_type_missing:")) {
+        const appName = rawMessage.slice("dev_runtime_app_type_missing:".length);
         return {
             message: `App "${appName}" is missing a valid type in catalogue.json.`,
-            suggestions: [
-                'Set "type" in the app catalogue entry before running "playdrop project dev".',
-            ],
+            suggestions: ['Set "type" in the app catalogue entry before running "playdrop project dev".'],
         };
     }
     return {
-        message: 'Failed to build the local runtime asset manifest for project dev.',
-        suggestions: [
-            rawMessage,
-        ],
+        message: "Failed to build the local runtime asset manifest for project dev.",
+        suggestions: [rawMessage],
     };
 }
 async function dev(targetArg, appOption, devOptions = {}) {
@@ -143,45 +119,47 @@ async function dev(targetArg, appOption, devOptions = {}) {
     }
     catch (error) {
         const code = error?.code;
-        const message = error?.message || 'Unable to resolve dev target.';
+        const message = error?.message || "Unable to resolve dev target.";
         let suggestions = [];
         switch (code) {
-            case 'app_required':
+            case "app_required":
                 suggestions = ['Use "--app <name>" to select which app to run.'];
                 break;
-            case 'app_not_found':
-                suggestions = ['Check the app name in catalogue.json or run "playdrop project create app" to register a new app.'];
+            case "app_not_found":
+                suggestions = [
+                    'Check the app name in catalogue.json or run "playdrop project create app" to register a new app.',
+                ];
                 break;
-            case 'catalogue_missing':
-                suggestions = ['Run "playdrop project dev" from a workspace with catalogue.json or provide the path to an HTML file.'];
+            case "catalogue_missing":
+                suggestions = [
+                    'Run "playdrop project dev" from a workspace with catalogue.json or provide the path to an HTML file.',
+                ];
                 break;
-            case 'invalid_target':
-                suggestions = ['Provide a path to an HTML file or directory containing a catalogue.json.'];
+            case "invalid_target":
+                suggestions = ["Provide a path to an HTML file or directory containing a catalogue.json."];
                 break;
-            case 'empty_catalogue':
+            case "empty_catalogue":
                 suggestions = ['Add apps to catalogue.json before running "playdrop project dev".'];
                 break;
-            case 'invalid_catalogue':
+            case "invalid_catalogue":
                 suggestions = ['Fix the catalogue.json file and rerun "playdrop project dev".'];
                 break;
             default:
-                suggestions = ['Provide an app name, HTML file path, or run inside a Playdrop workspace.'];
+                suggestions = ["Provide an app name, HTML file path, or run inside a Playdrop workspace."];
                 break;
         }
-        (0, messages_1.printErrorWithHelp)(message, suggestions, { command: 'project dev' });
+        (0, messages_1.printErrorWithHelp)(message, suggestions, { command: "project dev" });
         process.exitCode = 1;
         return;
     }
     let appName = resolvedTarget.appName;
     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}.`, [
-            'Ensure the catalogue entry points to a compiled HTML file or provide the correct file path.'
-        ], { command: 'project dev' });
+        (0, messages_1.printErrorWithHelp)(`App HTML was not found at ${filePath}.`, ["Ensure the catalogue entry points to a compiled HTML file or provide the correct file path."], { command: "project dev" });
         process.exitCode = 1;
         return;
     }
-    let appTypeSlug = 'game';
+    let appTypeSlug = "game";
     try {
         const match = (0, catalogue_utils_1.findAppDefinition)(filePath);
         appName = match.name;
@@ -189,10 +167,10 @@ async function dev(targetArg, appOption, devOptions = {}) {
     }
     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.',
+            (0, messages_1.printErrorWithHelp)(error?.message || "Catalogue lookup failed.", [
+                "Ensure the HTML file is listed exactly once in catalogue.json with a valid type.",
                 'Run "playdrop project create app <name>" to scaffold a new entry if needed.',
-            ], { command: 'project dev' });
+            ], { command: "project dev" });
             process.exitCode = 1;
             return;
         }
@@ -202,24 +180,26 @@ async function dev(targetArg, appOption, devOptions = {}) {
         devAuthSelection = (0, devAuth_1.parseHostedDevAuthSelection)({
             devAuth: devOptions.devAuth,
             player: devOptions.player,
-            defaultMode: 'prompt',
+            defaultMode: "prompt",
             allowPrompt: true,
         });
     }
     catch (error) {
-        const message = error instanceof Error ? error.message : 'dev_auth_invalid';
-        if (message === 'dev_auth_player_slot_required') {
-            (0, messages_1.printErrorWithHelp)('Use --player 1, 2, 3, or 4 when --dev-auth player is selected.', [], { command: 'project dev' });
+        const message = error instanceof Error ? error.message : "dev_auth_invalid";
+        if (message === "dev_auth_player_slot_required") {
+            (0, messages_1.printErrorWithHelp)("Use --player 1, 2, 3, or 4 when --dev-auth player is selected.", [], {
+                command: "project dev",
+            });
         }
         else {
-            (0, messages_1.printErrorWithHelp)('Use --dev-auth prompt, anonymous, viewer, or player.', ['If you choose --dev-auth player, also pass --player 1, 2, 3, or 4.'], { command: 'project dev' });
+            (0, messages_1.printErrorWithHelp)("Use --dev-auth prompt, anonymous, viewer, or player.", ["If you choose --dev-auth player, also pass --player 1, 2, 3, or 4."], { command: "project dev" });
         }
         process.exitCode = 1;
         return;
     }
     const workspacePath = resolvedTarget.cataloguePath ?? (0, node_path_1.dirname)(filePath);
-    await (0, commandContext_1.withEnvironment)('project dev', 'Starting the dev server', async ({ client, env, envConfig, account }) => {
-        let currentUsername = account?.username?.trim() ?? '';
+    await (0, commandContext_1.withEnvironment)("project dev", "Starting the dev server", async ({ client, env, envConfig, account }) => {
+        let currentUsername = account?.username?.trim() ?? "";
         if (!currentUsername) {
             try {
                 currentUsername = await (0, devShared_1.fetchDevUsername)(client);
@@ -229,7 +209,7 @@ async function dev(targetArg, appOption, devOptions = {}) {
                     return;
                 }
                 if (error instanceof types_1.UnsupportedClientError) {
-                    (0, http_1.handleUnsupportedError)(error, 'Authentication');
+                    (0, http_1.handleUnsupportedError)(error, "Authentication");
                     process.exitCode = 1;
                     return;
                 }
@@ -237,12 +217,12 @@ async function dev(targetArg, appOption, devOptions = {}) {
                     (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 dev' });
+                    ], { command: "project dev" });
                     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 dev');
+                    (0, messages_1.printNetworkIssue)("Could not reach the Playdrop API to resolve your account.", "project dev");
                     process.exitCode = 1;
                     return;
                 }
@@ -258,7 +238,7 @@ async function dev(targetArg, appOption, devOptions = {}) {
                     return;
                 }
                 if (error instanceof types_1.UnsupportedClientError) {
-                    (0, http_1.handleUnsupportedError)(error, 'Dev');
+                    (0, http_1.handleUnsupportedError)(error, "Dev");
                     process.exitCode = 1;
                     return;
                 }
@@ -266,20 +246,17 @@ async function dev(targetArg, appOption, devOptions = {}) {
                     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 starting the dev server.`,
-                            'If you expected it to exist, ensure you are logged into the correct environment.'
-                        ], { command: 'project dev' });
+                            "If you expected it to exist, ensure you are logged into the correct environment.",
+                        ], { command: "project dev" });
                     }
                     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.'
-                        ], { command: 'project dev' });
+                        (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 dev" });
                     }
                     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 dev');
+                    (0, messages_1.printNetworkIssue)("Could not reach the Playdrop API to verify the app registration.", "project dev");
                     process.exitCode = 1;
                     return;
                 }
@@ -287,10 +264,10 @@ async function dev(targetArg, appOption, devOptions = {}) {
             }
         }
         const projectInfo = (0, devShared_1.findProjectInfo)(filePath);
-        const devScriptAvailable = Boolean(projectInfo.projectDir && projectInfo.packageJson && typeof projectInfo.packageJson.scripts?.dev === 'string');
+        const devScriptAvailable = Boolean(projectInfo.projectDir && projectInfo.packageJson && typeof projectInfo.packageJson.scripts?.dev === "string");
         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 dev' });
+            (0, messages_1.printErrorWithHelp)(taskLookup.errors[0] || "Failed to resolve the app task from catalogue.json.", taskLookup.errors.slice(1), { command: "project dev" });
             process.exitCode = 1;
             return;
         }
@@ -306,7 +283,9 @@ async function dev(targetArg, appOption, devOptions = {}) {
                 await (0, tweakStaleness_1.fetchAndAssertTweakState)(client, currentUsername, taskLookup.task);
             }
             catch (error) {
-                (0, messages_1.printErrorWithHelp)(error instanceof Error ? error.message : 'Could not verify the current tweak state.', [], { command: 'project dev' });
+                (0, messages_1.printErrorWithHelp)(error instanceof Error ? error.message : "Could not verify the current tweak state.", [], {
+                    command: "project dev",
+                });
                 process.exitCode = 1;
                 return;
             }
@@ -316,12 +295,12 @@ async function dev(targetArg, appOption, devOptions = {}) {
                     apiBase: envConfig.apiBase,
                     task: taskLookup.task,
                     creatorUsername: currentUsername,
-                    appBaseUrl: new URL('.', localDevAppUrl).toString(),
+                    appBaseUrl: new URL(".", localDevAppUrl).toString(),
                 });
             }
             catch (error) {
                 const formatted = formatDevRuntimeAssetManifestFailure(error);
-                (0, messages_1.printErrorWithHelp)(formatted.message, formatted.suggestions, { command: 'project dev' });
+                (0, messages_1.printErrorWithHelp)(formatted.message, formatted.suggestions, { command: "project dev" });
                 process.exitCode = 1;
                 return;
             }
@@ -339,26 +318,26 @@ async function dev(targetArg, appOption, devOptions = {}) {
             });
         }
         catch (error) {
-            const message = typeof error?.message === 'string' ? error.message : '';
+            const message = typeof error?.message === "string" ? error.message : "";
             const mountConflict = (0, devServer_1.parseMountConflictError)(message);
             if (mountConflict) {
                 (0, messages_1.printErrorWithHelp)(`A different dev session already owns ${mountConflict.ref}.`, [
                     `Active owner pid: ${mountConflict.ownerPid}.`,
                     `Mounted repo root: ${mountConflict.repoRoot}.`,
                     `Mounted HTML path: ${mountConflict.htmlPath}.`,
-                ], { command: 'project dev' });
+                ], { command: "project dev" });
             }
-            else if (message.startsWith('dev_router_incompatible:')) {
+            else if (message.startsWith("dev_router_incompatible:")) {
                 (0, messages_1.printErrorWithHelp)(`An incompatible shared dev router is already running on port ${devRouterPort}.`, [
                     'Stop the existing dev router process, then retry "playdrop project dev".',
                     `If needed, rebuild the local CLI first with "npm run build --workspace @playdrop/playdrop-cli" from /Users/oliviermichon/Documents/playdrop.`,
-                ], { command: 'project dev' });
+                ], { command: "project dev" });
             }
             else {
                 (0, messages_1.printErrorWithHelp)(error?.message || `Failed to start the shared dev router on port ${devRouterPort}.`, [
-                    'Close the conflicting process or wait for the stale mount to exit.',
-                    'Ensure the app HTML file exists and is readable.',
-                ], { command: 'project dev' });
+                    "Close the conflicting process or wait for the stale mount to exit.",
+                    "Ensure the app HTML file exists and is readable.",
+                ], { command: "project dev" });
             }
             process.exitCode = 1;
             return;
@@ -368,16 +347,14 @@ async function dev(targetArg, appOption, devOptions = {}) {
             if (shuttingDown)
                 return;
             shuttingDown = true;
-            process.off('SIGINT', handleShutdown);
-            process.off('SIGTERM', handleShutdown);
-            handle
-                .close()
-                .catch(closeError => {
+            process.off("SIGINT", handleShutdown);
+            process.off("SIGTERM", handleShutdown);
+            handle.close().catch((closeError) => {
                 console.error(closeError instanceof Error ? closeError.message : closeError);
             });
         };
-        process.on('SIGINT', handleShutdown);
-        process.on('SIGTERM', handleShutdown);
+        process.on("SIGINT", handleShutdown);
+        process.on("SIGTERM", handleShutdown);
         const webUrl = envConfig.webBase;
         const entryLabel = (0, node_path_1.relative)(process.cwd(), filePath) || filePath;
         const runtimeRootLabel = (0, node_path_1.relative)(process.cwd(), (0, node_path_1.dirname)(filePath)) || (0, node_path_1.dirname)(filePath);
@@ -397,9 +374,9 @@ async function dev(targetArg, appOption, devOptions = {}) {
                 appName,
                 localDevPort: devRouterPort === devServer_1.DEV_ROUTER_PORT ? null : devRouterPort,
             }), devAuthSelection);
-            console.log('\nTest your app at:');
+            console.log("\nTest your app at:");
             console.log(`  ${iframeUrl}`);
-            console.log('\nMake something fun then share it with');
+            console.log("\nMake something fun then share it with");
             console.log(`playdrop project publish ${appName}`);
         }
         else {
@@ -408,19 +385,19 @@ async function dev(targetArg, appOption, devOptions = {}) {
     }, { workspacePath });
 }
 function resolveDevRouterPort(value) {
-    if (value === null || value === undefined || String(value).trim() === '') {
+    if (value === null || value === undefined || String(value).trim() === "") {
         return devServer_1.DEV_ROUTER_PORT;
     }
-    const parsed = typeof value === 'number' ? value : Number.parseInt(String(value), 10);
+    const parsed = typeof value === "number" ? value : Number.parseInt(String(value), 10);
     if (!Number.isInteger(parsed) || parsed <= 0 || parsed > 65535) {
-        throw new Error('invalid_dev_router_port');
+        throw new Error("invalid_dev_router_port");
     }
     return parsed;
 }
 function resolveRequiredWorkerDevRouterPort(env) {
     const raw = env.PLAYDROP_WORKER_TASK_DEV_PORT;
     if (!raw?.trim()) {
-        throw new Error('worker_task_dev_port_missing');
+        throw new Error("worker_task_dev_port_missing");
     }
     try {
         return resolveDevRouterPort(raw);
@@ -430,7 +407,7 @@ function resolveRequiredWorkerDevRouterPort(env) {
     }
 }
 function resolveCliDevRouterPort(env = process.env) {
-    if (env.PLAYDROP_WORKER_CONTEXT !== '1') {
+    if (env.PLAYDROP_WORKER_CONTEXT !== "1") {
         return devServer_1.DEV_ROUTER_PORT;
     }
     const workerPort = resolveRequiredWorkerDevRouterPort(env);