@playdrop/playdrop-cli 0.16.2 → 0.16.11

package/dist/commands/devBrowser.js

@@ -21,20 +21,20 @@ const devAuth_1 = require("../devAuth");
 const dev_1 = require("./dev");
 const playwright_1 = require("../playwright");
 function resolveDevBrowserAuthSelection(options) {
-    const normalizedMode = options.devAuth?.trim().toLowerCase() || 'prompt';
-    if (options.player !== undefined && normalizedMode !== 'player') {
-        throw new Error('dev_auth_player_requires_player_mode');
+    const normalizedMode = options.devAuth?.trim().toLowerCase() || "prompt";
+    if (options.player !== undefined && normalizedMode !== "player") {
+        throw new Error("dev_auth_player_requires_player_mode");
     }
     return (0, devAuth_1.parseHostedDevAuthSelection)({
         devAuth: options.devAuth,
         player: options.player,
-        defaultMode: 'prompt',
+        defaultMode: "prompt",
         allowPrompt: true,
     });
 }
 function waitForContextClose(context) {
     return new Promise((resolve) => {
-        context.once?.('close', () => {
+        context.once?.("close", () => {
             resolve();
         });
     });
@@ -47,50 +47,59 @@ async function devBrowser(targetArg, options = {}) {
         devAuthSelection = resolveDevBrowserAuthSelection(options);
     }
     catch (error) {
-        const message = error?.message || 'Unable to start the dev browser.';
-        if (message === 'dev_auth_player_requires_player_mode') {
-            (0, messages_1.printErrorWithHelp)('Use --player only with --dev-auth player.', [], { command: 'project dev-browser' });
+        const message = error?.message || "Unable to start the dev browser.";
+        if (message === "dev_auth_player_requires_player_mode") {
+            (0, messages_1.printErrorWithHelp)("Use --player only with --dev-auth player.", [], { command: "project dev-browser" });
             process.exitCode = 1;
             return;
         }
-        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-browser' });
+        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-browser",
+            });
             process.exitCode = 1;
             return;
         }
         const code = error?.code;
         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-browser" from a workspace with catalogue.json or provide the path to an HTML file.'];
+            case "catalogue_missing":
+                suggestions = [
+                    'Run "playdrop project dev-browser" 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-browser".'];
                 break;
-            case 'invalid_catalogue':
+            case "invalid_catalogue":
                 suggestions = ['Fix the catalogue.json file and rerun "playdrop project dev-browser".'];
                 break;
             default:
-                suggestions = ['Use --dev-auth prompt, anonymous, viewer, or player.', 'If you choose --dev-auth player, also pass --player 1, 2, 3, or 4.'];
+                suggestions = [
+                    "Use --dev-auth prompt, anonymous, viewer, or player.",
+                    "If you choose --dev-auth player, also pass --player 1, 2, 3, or 4.",
+                ];
                 break;
         }
-        (0, messages_1.printErrorWithHelp)(message, suggestions, { command: 'project dev-browser' });
+        (0, messages_1.printErrorWithHelp)(message, suggestions, { command: "project dev-browser" });
         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-browser' });
+        (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-browser" });
         process.exitCode = 1;
         return;
     }
@@ -104,17 +113,17 @@ async function devBrowser(targetArg, options = {}) {
     }
     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-browser' });
+            ], { command: "project dev-browser" });
             process.exitCode = 1;
             return;
         }
     }
     const workspacePath = resolvedTarget.cataloguePath ?? (0, node_path_1.dirname)(filePath);
-    await (0, commandContext_1.withEnvironment)('project dev-browser', 'Launching the Playdrop dev browser', async ({ client, env, envConfig, account }) => {
-        let currentUsername = account?.username?.trim() ?? '';
+    await (0, commandContext_1.withEnvironment)("project dev-browser", "Launching the Playdrop dev browser", async ({ client, env, envConfig, account }) => {
+        let currentUsername = account?.username?.trim() ?? "";
         if (!currentUsername) {
             try {
                 currentUsername = await (0, devShared_1.fetchDevUsername)(client);
@@ -124,7 +133,7 @@ async function devBrowser(targetArg, options = {}) {
                     return;
                 }
                 if (error instanceof types_1.UnsupportedClientError) {
-                    (0, http_1.handleUnsupportedError)(error, 'Authentication');
+                    (0, http_1.handleUnsupportedError)(error, "Authentication");
                     process.exitCode = 1;
                     return;
                 }
@@ -132,12 +141,12 @@ async function devBrowser(targetArg, options = {}) {
                     (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-browser' });
+                    ], { command: "project dev-browser" });
                     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-browser');
+                    (0, messages_1.printNetworkIssue)("Could not reach the Playdrop API to resolve your account.", "project dev-browser");
                     process.exitCode = 1;
                     return;
                 }
@@ -153,7 +162,7 @@ async function devBrowser(targetArg, options = {}) {
                     return;
                 }
                 if (error instanceof types_1.UnsupportedClientError) {
-                    (0, http_1.handleUnsupportedError)(error, 'Dev browser');
+                    (0, http_1.handleUnsupportedError)(error, "Dev browser");
                     process.exitCode = 1;
                     return;
                 }
@@ -161,17 +170,17 @@ async function devBrowser(targetArg, options = {}) {
                     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 opening the dev browser.`,
-                            'If you expected it to exist, ensure you are logged into the correct environment.',
-                        ], { command: 'project dev-browser' });
+                            "If you expected it to exist, ensure you are logged into the correct environment.",
+                        ], { command: "project dev-browser" });
                     }
                     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-browser' });
+                        (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-browser" });
                     }
                     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-browser');
+                    (0, messages_1.printNetworkIssue)("Could not reach the Playdrop API to verify the app registration.", "project dev-browser");
                     process.exitCode = 1;
                     return;
                 }
@@ -179,12 +188,10 @@ async function devBrowser(targetArg, options = {}) {
             }
         }
         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-browser' });
+            (0, messages_1.printErrorWithHelp)(taskLookup.errors[0] || "Failed to resolve the app task from catalogue.json.", taskLookup.errors.slice(1), { command: "project dev-browser" });
             process.exitCode = 1;
             return;
         }
@@ -202,12 +209,12 @@ async function devBrowser(targetArg, options = {}) {
                     apiBase: envConfig.apiBase,
                     task: taskLookup.task,
                     creatorUsername: currentUsername,
-                    appBaseUrl: new URL('.', localDevAppUrl).toString(),
+                    appBaseUrl: new URL(".", localDevAppUrl).toString(),
                 });
             }
             catch (error) {
                 const formatted = (0, dev_1.formatDevRuntimeAssetManifestFailure)(error);
-                (0, messages_1.printErrorWithHelp)(formatted.message, formatted.suggestions, { command: 'project dev-browser' });
+                (0, messages_1.printErrorWithHelp)(formatted.message, formatted.suggestions, { command: "project dev-browser" });
                 process.exitCode = 1;
                 return;
             }
@@ -225,26 +232,26 @@ async function devBrowser(targetArg, options = {}) {
             });
         }
         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-browser' });
+                ], { command: "project dev-browser" });
             }
-            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 ${devServer_1.DEV_ROUTER_PORT}.`, [
                     'Stop the existing dev router process, then retry "playdrop project dev-browser".',
                     'If needed, rebuild the local CLI first with "npm run build --workspace @playdrop/playdrop-cli".',
-                ], { command: 'project dev-browser' });
+                ], { command: "project dev-browser" });
             }
             else {
                 (0, messages_1.printErrorWithHelp)(error?.message || `Failed to start the shared dev router on port ${devServer_1.DEV_ROUTER_PORT}.`, [
-                    'Close the conflicting process or wait for the stale mount to exit.',
-                    'Ensure the app HTML file exists and is readable.',
-                ], { command: 'project dev-browser' });
+                    "Close the conflicting process or wait for the stale mount to exit.",
+                    "Ensure the app HTML file exists and is readable.",
+                ], { command: "project dev-browser" });
             }
             process.exitCode = 1;
             return;
@@ -255,10 +262,10 @@ async function devBrowser(targetArg, options = {}) {
             appType,
             devAuth: devAuthSelection.devAuth,
             player: devAuthSelection.player ? String(devAuthSelection.player) : null,
-            launchCheck: devAuthSelection.devAuth !== 'prompt',
+            launchCheck: devAuthSelection.devAuth !== "prompt",
         });
         let launchUrl = devUrl;
-        if (devAuthSelection.devAuth !== 'anonymous') {
+        if (devAuthSelection.devAuth !== "anonymous") {
             try {
                 const target = new URL(devUrl);
                 const launch = await client.startCliWebLaunch({
@@ -272,17 +279,17 @@ async function devBrowser(targetArg, options = {}) {
                     return;
                 }
                 if (error instanceof types_1.UnsupportedClientError) {
-                    (0, http_1.handleUnsupportedError)(error, 'Dev browser launch');
+                    (0, http_1.handleUnsupportedError)(error, "Dev browser launch");
                     process.exitCode = 1;
                     return;
                 }
                 if (error instanceof types_1.ApiError) {
-                    (0, messages_1.printErrorWithHelp)(`Could not prepare the Playdrop browser session (status ${error.status}).`, ['Run "playdrop auth login" and retry the dev browser command.'], { command: 'project dev-browser' });
+                    (0, messages_1.printErrorWithHelp)(`Could not prepare the Playdrop browser session (status ${error.status}).`, ['Run "playdrop auth login" and retry the dev browser command.'], { command: "project dev-browser" });
                     process.exitCode = 1;
                     return;
                 }
                 if ((0, devShared_1.isNetworkError)(error)) {
-                    (0, messages_1.printNetworkIssue)('Could not reach the Playdrop API to prepare the browser session.', 'project dev-browser');
+                    (0, messages_1.printNetworkIssue)("Could not reach the Playdrop API to prepare the browser session.", "project dev-browser");
                     process.exitCode = 1;
                     return;
                 }
@@ -291,7 +298,7 @@ async function devBrowser(targetArg, options = {}) {
         }
         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);
-        const profileDir = (0, node_fs_1.mkdtempSync)((0, node_path_1.join)(node_os_1.default.tmpdir(), 'playdrop-dev-browser-'));
+        const profileDir = (0, node_fs_1.mkdtempSync)((0, node_path_1.join)(node_os_1.default.tmpdir(), "playdrop-dev-browser-"));
         console.log(`App dev router mounted at ${handle.appUrl}`);
         console.log(`Serving ${entryLabel}`);
         console.log(`Static root ${runtimeRootLabel}`);
@@ -305,8 +312,8 @@ async function devBrowser(targetArg, options = {}) {
         if (launchUrl !== devUrl) {
             console.log(`Launch URL: ${launchUrl}`);
         }
-        console.log('Opening an isolated Chromium dev window.');
-        console.log('Close the browser window or press Ctrl+C to stop.');
+        console.log("Opening an isolated Chromium dev window.");
+        console.log("Close the browser window or press Ctrl+C to stop.");
         let context = null;
         let cleanedUp = false;
         const cleanup = async () => {
@@ -314,8 +321,8 @@ async function devBrowser(targetArg, options = {}) {
                 return;
             }
             cleanedUp = true;
-            process.off('SIGINT', handleSignal);
-            process.off('SIGTERM', handleSignal);
+            process.off("SIGINT", handleSignal);
+            process.off("SIGTERM", handleSignal);
             if (context) {
                 try {
                     await context.close();
@@ -334,28 +341,30 @@ async function devBrowser(targetArg, options = {}) {
         const handleSignal = () => {
             void cleanup();
         };
-        process.on('SIGINT', handleSignal);
-        process.on('SIGTERM', handleSignal);
+        process.on("SIGINT", handleSignal);
+        process.on("SIGTERM", handleSignal);
         try {
             context = await (0, playwright_1.launchPersistentChromiumContext)(profileDir, {
-                automationOrigin: devAuthSelection.devAuth === 'prompt' ? null : new URL(devUrl).origin,
+                automationOrigin: devAuthSelection.devAuth === "prompt" ? null : new URL(devUrl).origin,
                 viewport: { width: 1440, height: 960 },
             });
         }
         catch (error) {
             await cleanup();
-            (0, messages_1.printErrorWithHelp)(error?.message || 'Failed to launch the Playdrop dev browser.', ['Install Playwright Chromium with "npx playwright install chromium" and retry.'], { command: 'project dev-browser' });
+            (0, messages_1.printErrorWithHelp)(error?.message || "Failed to launch the Playdrop dev browser.", ['Install Playwright Chromium with "npx playwright install chromium" and retry.'], { command: "project dev-browser" });
             process.exitCode = 1;
             return;
         }
         try {
-            const page = context.pages()[0] ?? await context.newPage();
-            await page.goto(launchUrl, { waitUntil: 'domcontentloaded' });
+            const page = context.pages()[0] ?? (await context.newPage());
+            await page.goto(launchUrl, { waitUntil: "domcontentloaded" });
             await waitForContextClose(context);
         }
         catch (error) {
             await cleanup();
-            (0, messages_1.printErrorWithHelp)(error?.message || 'Failed to open the Playdrop dev browser window.', [], { command: 'project dev-browser' });
+            (0, messages_1.printErrorWithHelp)(error?.message || "Failed to open the Playdrop dev browser window.", [], {
+                command: "project dev-browser",
+            });
             process.exitCode = 1;
             return;
         }

package/dist/commands/devRuntimeAssets.d.ts

@@ -1,6 +1,6 @@
-import type { ApiClient } from '@playdrop/api-client';
-import { type AppAuthMode, type AppControllerMode, type AppMetadataAssetSpecSupport, type AppRuntimeAssetsResponse, type AppSurface, type AppType, type TweakValues } from '@playdrop/types';
-import type { AppTask } from '../catalogue';
+import type { ApiClient } from "@playdrop/api-client";
+import { type AppAuthMode, type AppControllerMode, type AppMetadataAssetSpecSupport, type AppRuntimeAssetsResponse, type AppSurface, type AppType, type TweakValues } from "@playdrop/types";
+import type { AppTask } from "../catalogue";
 export type LocalOwnedRuntimeAssetFileRecord = {
     absolutePath: string;
     contentType: string | null;
@@ -28,7 +28,7 @@ export declare function createEmptyDevRuntimeAssetManifest(): DevRuntimeAssetMan
 export declare function buildLocalDevRuntimeAssetsUrl(appBaseUrl: string): string;
 export declare function buildLocalDevRuntimeAssetFileUrl(appBaseUrl: string, ownedAssetName: string, role: string): string;
 export declare function buildDevRuntimeAssetManifest(input: {
-    client?: Pick<ApiClient, 'resolveRuntimeAssets'>;
+    client?: Pick<ApiClient, "resolveRuntimeAssets">;
     apiBase: string;
     task: AppTask;
     creatorUsername: string;

package/dist/commands/devRuntimeAssets.js

@@ -12,10 +12,10 @@ function createEmptyDevRuntimeAssetManifest() {
     return {
         response: {
             appVersionId: 0,
-            appVersion: 'dev',
+            appVersion: "dev",
             assets: [],
             localAppMetadata: {
-                type: 'GAME',
+                type: "GAME",
                 surfaceTargets: Array.from(types_1.DEFAULT_APP_SURFACE_TARGETS),
                 authMode: types_1.DEFAULT_APP_AUTH_MODE,
                 controllerMode: types_1.DEFAULT_APP_CONTROLLER_MODE,
@@ -29,26 +29,26 @@ function createEmptyDevRuntimeAssetManifest() {
     };
 }
 const CONTENT_TYPE_BY_EXTENSION = {
-    '.html': 'text/html; charset=utf-8',
-    '.js': 'application/javascript; charset=utf-8',
-    '.mjs': 'application/javascript; charset=utf-8',
-    '.cjs': 'application/javascript; charset=utf-8',
-    '.css': 'text/css; charset=utf-8',
-    '.json': 'application/json; charset=utf-8',
-    '.png': 'image/png',
-    '.jpg': 'image/jpeg',
-    '.jpeg': 'image/jpeg',
-    '.gif': 'image/gif',
-    '.svg': 'image/svg+xml',
-    '.webp': 'image/webp',
-    '.glb': 'model/gltf-binary',
-    '.gltf': 'model/gltf+json',
-    '.wasm': 'application/wasm',
-    '.mp4': 'video/mp4',
-    '.webm': 'video/webm',
-    '.ogg': 'audio/ogg',
-    '.mp3': 'audio/mpeg',
-    '.wav': 'audio/wav',
+    ".html": "text/html; charset=utf-8",
+    ".js": "application/javascript; charset=utf-8",
+    ".mjs": "application/javascript; charset=utf-8",
+    ".cjs": "application/javascript; charset=utf-8",
+    ".css": "text/css; charset=utf-8",
+    ".json": "application/json; charset=utf-8",
+    ".png": "image/png",
+    ".jpg": "image/jpeg",
+    ".jpeg": "image/jpeg",
+    ".gif": "image/gif",
+    ".svg": "image/svg+xml",
+    ".webp": "image/webp",
+    ".glb": "model/gltf-binary",
+    ".gltf": "model/gltf+json",
+    ".wasm": "application/wasm",
+    ".mp4": "video/mp4",
+    ".webm": "video/webm",
+    ".ogg": "audio/ogg",
+    ".mp3": "audio/mpeg",
+    ".wav": "audio/wav",
 };
 function inferContentType(filePath) {
     const extension = (0, node_path_1.extname)(filePath).toLowerCase();
@@ -56,18 +56,18 @@ function inferContentType(filePath) {
 }
 function buildSyntheticLocalAssetRef(creatorUsername, appName, ownedAssetName) {
     return (0, types_1.formatContentVersionRef)({
-        kind: 'asset',
+        kind: "asset",
         creatorUsername: `${creatorUsername}-dev`,
         name: `${appName}-${ownedAssetName}`,
         revision: 1,
     });
 }
 function buildLocalDevRuntimeAssetsUrl(appBaseUrl) {
-    const base = appBaseUrl.endsWith('/') ? appBaseUrl.slice(0, -1) : appBaseUrl;
+    const base = appBaseUrl.endsWith("/") ? appBaseUrl.slice(0, -1) : appBaseUrl;
     return `${base}/_playdrop/runtime-assets`;
 }
 function buildLocalDevRuntimeAssetFileUrl(appBaseUrl, ownedAssetName, role) {
-    const base = appBaseUrl.endsWith('/') ? appBaseUrl.slice(0, -1) : appBaseUrl;
+    const base = appBaseUrl.endsWith("/") ? appBaseUrl.slice(0, -1) : appBaseUrl;
     return `${base}/_playdrop/runtime-assets/files/${encodeURIComponent(ownedAssetName)}?role=${encodeURIComponent(role)}`;
 }
 function createLocalOwnedAssetSummary(task, creatorUsername, appBaseUrl, ownedAsset) {
@@ -93,14 +93,14 @@ function createLocalOwnedAssetSummary(task, creatorUsername, appBaseUrl, ownedAs
         asset: {
             assetRef: buildSyntheticLocalAssetRef(creatorUsername, task.name, ownedAsset.name),
             runtimeKey: ownedAsset.runtimeKey?.trim() || null,
-            sourceType: 'OWNED',
+            sourceType: "OWNED",
             files: runtimeFiles,
         },
         files,
     };
 }
 function assertRuntimeKeyAvailable(seenRuntimeKeys, runtimeKey, context) {
-    const normalized = typeof runtimeKey === 'string' ? runtimeKey.trim() : '';
+    const normalized = typeof runtimeKey === "string" ? runtimeKey.trim() : "";
     if (!normalized) {
         return;
     }
@@ -125,14 +125,12 @@ function buildLocalAppMetadata(task) {
             versionRange: entry.versionRange,
             capabilities: Array.from(entry.capabilities),
         })),
-        version: typeof task.version === 'string' && task.version.trim().length > 0 ? task.version.trim() : null,
-        ...(task.tweaks && task.tweaks.removed !== true
-            ? { tweakValues: { ...task.tweaks.defaults } }
-            : {}),
+        version: typeof task.version === "string" && task.version.trim().length > 0 ? task.version.trim() : null,
+        ...(task.tweaks && task.tweaks.removed !== true ? { tweakValues: { ...task.tweaks.defaults } } : {}),
     };
 }
 function assertCustomAssetVersionSupported(task, assetRef, version) {
-    if (typeof version.assetSpecVersionRef !== 'string' || version.assetSpecVersionRef.trim().length === 0) {
+    if (typeof version.assetSpecVersionRef !== "string" || version.assetSpecVersionRef.trim().length === 0) {
         return;
     }
     const parsedAssetSpecVersion = (0, types_1.parseAssetSpecVersionRef)(version.assetSpecVersionRef);
@@ -140,13 +138,13 @@ function assertCustomAssetVersionSupported(task, assetRef, version) {
         throw new Error(`dev_runtime_asset_spec_invalid:${assetRef}:${version.assetSpecVersionRef}`);
     }
     const assetSpecFamilyRef = (0, types_1.formatAssetSpecFamilyRef)({
-        kind: 'asset-spec',
+        kind: "asset-spec",
         creatorUsername: parsedAssetSpecVersion.creatorUsername,
         name: parsedAssetSpecVersion.name,
     });
-    const supported = task.assetSpecSupport.some((entry) => (entry.assetSpec === assetSpecFamilyRef
-        && entry.capabilities.includes('READ')
-        && (0, semver_1.satisfies)(parsedAssetSpecVersion.version, entry.versionRange, { includePrerelease: false })));
+    const supported = task.assetSpecSupport.some((entry) => entry.assetSpec === assetSpecFamilyRef &&
+        entry.capabilities.includes("READ") &&
+        (0, semver_1.satisfies)(parsedAssetSpecVersion.version, entry.versionRange, { includePrerelease: false }));
     if (!supported) {
         throw new Error(`dev_runtime_asset_spec_unsupported:${assetRef}:${version.assetSpecVersionRef}`);
     }
@@ -170,7 +168,7 @@ async function buildDevRuntimeAssetManifest(input) {
     const directDependencies = input.task.uses.assets.map((dependency) => {
         assertRuntimeKeyAvailable(seenRuntimeKeys, dependency.runtimeKey, dependency.ref);
         const parsedDependencyRef = (0, types_1.parseContentVersionRef)(dependency.ref);
-        if (!parsedDependencyRef || parsedDependencyRef.kind !== 'asset') {
+        if (!parsedDependencyRef || parsedDependencyRef.kind !== "asset") {
             throw new Error(`dev_runtime_asset_ref_invalid:${dependency.ref}`);
         }
         return {
@@ -180,21 +178,21 @@ async function buildDevRuntimeAssetManifest(input) {
     });
     const packDependencies = input.task.uses.packs.map((packRef) => {
         const parsedPackRef = (0, types_1.parseContentVersionRef)(packRef);
-        if (!parsedPackRef || parsedPackRef.kind !== 'pack') {
+        if (!parsedPackRef || parsedPackRef.kind !== "pack") {
             throw new Error(`dev_runtime_pack_ref_invalid:${packRef}`);
         }
         return (0, types_1.formatContentVersionRef)(parsedPackRef);
     });
     if (directDependencies.length > 0 || packDependencies.length > 0) {
         if (!input.client) {
-            throw new Error('dev_runtime_asset_resolver_missing');
+            throw new Error("dev_runtime_asset_resolver_missing");
         }
         const resolved = await input.client.resolveRuntimeAssets({
             assets: directDependencies,
             packs: packDependencies,
         });
         for (const entry of resolved.assets) {
-            if (entry.sourceType !== 'DIRECT' && entry.sourceType !== 'PACK') {
+            if (entry.sourceType !== "DIRECT" && entry.sourceType !== "PACK") {
                 throw new Error(`dev_runtime_asset_source_type_invalid:${entry.assetRef}:${entry.sourceType}`);
             }
             assertCustomAssetVersionSupported(input.task, entry.assetRef, entry);

package/dist/commands/devServer.d.ts

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