@playdrop/playdrop-cli 0.16.5 → 0.16.11

package/dist/commands/devShared.d.ts

@@ -1,6 +1,6 @@
-import type { ApiClient } from '@playdrop/api-client';
-import type { AppResponse, UserResponse } from '@playdrop/types';
-import { type ParsedSurfaceTargets } from '../catalogue-utils';
+import type { ApiClient } from "@playdrop/api-client";
+import type { AppResponse, UserResponse } from "@playdrop/types";
+import { type ParsedSurfaceTargets } from "../catalogue-utils";
 export type ResolvedDevTarget = {
     appName: string;
     htmlPath: string;

package/dist/commands/devShared.js

@@ -25,55 +25,55 @@ function createDevError(code, message) {
     return error;
 }
 function isNetworkError(error) {
-    if (!error || typeof error !== 'object') {
+    if (!error || typeof error !== "object") {
         return false;
     }
     const candidate = error;
     if (candidate instanceof TypeError) {
         return true;
     }
-    const code = typeof candidate.code === 'string' ? candidate.code : undefined;
-    if (code === 'ECONNREFUSED' || code === 'ENOTFOUND') {
+    const code = typeof candidate.code === "string" ? candidate.code : undefined;
+    if (code === "ECONNREFUSED" || code === "ENOTFOUND") {
         return true;
     }
     const cause = candidate.cause;
-    if (cause && typeof cause === 'object' && typeof cause.code === 'string') {
+    if (cause && typeof cause === "object" && typeof cause.code === "string") {
         const nestedCode = cause.code;
-        return nestedCode === 'ECONNREFUSED' || nestedCode === 'ENOTFOUND';
+        return nestedCode === "ECONNREFUSED" || nestedCode === "ENOTFOUND";
     }
     return false;
 }
 async function fetchDevUser(client) {
     const response = await client.me();
     const user = response?.user;
-    if (user && typeof user.username === 'string' && user.username.trim().length > 0) {
+    if (user && typeof user.username === "string" && user.username.trim().length > 0) {
         return { ...user, username: user.username.trim() };
     }
-    throw new Error('DEV_USERNAME_EMPTY');
+    throw new Error("DEV_USERNAME_EMPTY");
 }
 async function fetchDevUsername(client) {
     const user = await fetchDevUser(client);
     return user.username;
 }
 async function resolveDevCreatorUsername(input) {
-    const workspaceOwnerUsername = input.workspaceOwnerUsername?.trim() ?? '';
+    const workspaceOwnerUsername = input.workspaceOwnerUsername?.trim() ?? "";
     if (workspaceOwnerUsername) {
         return workspaceOwnerUsername;
     }
-    const accountUsername = input.accountUsername?.trim() ?? '';
-    return accountUsername || await fetchDevUsername(input.client);
+    const accountUsername = input.accountUsername?.trim() ?? "";
+    return accountUsername || (await fetchDevUsername(input.client));
 }
 async function assertAppRegistered(client, creatorUsername, appName) {
     const response = await client.fetchAppBySlug(creatorUsername, appName);
     if (!response?.app) {
-        throw new Error('app_not_found');
+        throw new Error("app_not_found");
     }
     return response.app;
 }
 function findNearestCatalogue(startDir) {
     let current = (0, node_path_1.resolve)(startDir);
     while (true) {
-        const candidate = (0, node_path_1.join)(current, 'catalogue.json');
+        const candidate = (0, node_path_1.join)(current, "catalogue.json");
         if ((0, node_fs_1.existsSync)(candidate)) {
             return candidate;
         }
@@ -86,40 +86,40 @@ function findNearestCatalogue(startDir) {
 }
 function parseCatalogueApps(cataloguePath) {
     try {
-        const raw = (0, node_fs_1.readFileSync)(cataloguePath, 'utf8');
+        const raw = (0, node_fs_1.readFileSync)(cataloguePath, "utf8");
         const data = raw.trim() ? JSON.parse(raw) : {};
         if (Array.isArray(data)) {
             return data;
         }
-        if (data && typeof data === 'object' && Array.isArray(data.apps)) {
+        if (data && typeof data === "object" && Array.isArray(data.apps)) {
             return data.apps;
         }
         return [];
     }
     catch (error) {
-        throw createDevError('invalid_catalogue', `Failed to parse catalogue at ${cataloguePath}: ${error?.message || 'invalid JSON'}`);
+        throw createDevError("invalid_catalogue", `Failed to parse catalogue at ${cataloguePath}: ${error?.message || "invalid JSON"}`);
     }
 }
 function resolveAppFromCatalogue(cataloguePath, appName) {
-    const apps = parseCatalogueApps(cataloguePath).filter(entry => entry && typeof entry.name === 'string');
+    const apps = parseCatalogueApps(cataloguePath).filter((entry) => entry && typeof entry.name === "string");
     if (apps.length === 0) {
-        throw createDevError('empty_catalogue', `No apps found in ${cataloguePath}.`);
+        throw createDevError("empty_catalogue", `No apps found in ${cataloguePath}.`);
     }
     let selected;
     if (appName) {
-        selected = apps.find(entry => entry.name.trim() === appName.trim());
+        selected = apps.find((entry) => entry.name.trim() === appName.trim());
         if (!selected) {
-            throw createDevError('app_not_found', `App "${appName}" was not found in ${cataloguePath}.`);
+            throw createDevError("app_not_found", `App "${appName}" was not found in ${cataloguePath}.`);
         }
     }
     else if (apps.length === 1) {
         selected = apps[0];
     }
     else {
-        throw createDevError('app_required', `Multiple apps found in ${cataloguePath}. Use --app <name> to choose one.`);
+        throw createDevError("app_required", `Multiple apps found in ${cataloguePath}. Use --app <name> to choose one.`);
     }
     const entryName = selected.name.trim();
-    const relativeFile = typeof selected.file === 'string' && selected.file.trim().length > 0
+    const relativeFile = typeof selected.file === "string" && selected.file.trim().length > 0
         ? selected.file.trim()
         : `${entryName}.html`;
     const htmlPath = (0, node_path_1.resolve)((0, node_path_1.dirname)(cataloguePath), relativeFile);
@@ -135,7 +135,7 @@ function resolveDevTarget(targetArg, appOption) {
     if (!targetArg) {
         const cataloguePath = findNearestCatalogue(process.cwd());
         if (!cataloguePath) {
-            throw createDevError('catalogue_missing', 'Run "playdrop project dev" inside a workspace or provide a path to an app HTML file.');
+            throw createDevError("catalogue_missing", 'Run "playdrop project dev" inside a workspace or provide a path to an app HTML file.');
         }
         return resolveAppFromCatalogue(cataloguePath, appOption);
     }
@@ -143,20 +143,20 @@ function resolveDevTarget(targetArg, appOption) {
     if ((0, node_fs_1.existsSync)(absoluteTarget)) {
         const stats = (0, node_fs_1.statSync)(absoluteTarget);
         if (stats.isDirectory()) {
-            const cataloguePath = (0, node_path_1.join)(absoluteTarget, 'catalogue.json');
+            const cataloguePath = (0, node_path_1.join)(absoluteTarget, "catalogue.json");
             if (!(0, node_fs_1.existsSync)(cataloguePath)) {
-                throw createDevError('catalogue_missing', `Directory ${absoluteTarget} does not contain catalogue.json.`);
+                throw createDevError("catalogue_missing", `Directory ${absoluteTarget} does not contain catalogue.json.`);
             }
             return resolveAppFromCatalogue(cataloguePath, appOption);
         }
         if (!stats.isFile()) {
-            throw createDevError('invalid_target', `Target ${absoluteTarget} is not a file.`);
+            throw createDevError("invalid_target", `Target ${absoluteTarget} is not a file.`);
         }
-        if (!absoluteTarget.toLowerCase().endsWith('.html')) {
-            throw createDevError('invalid_target', 'Provide an HTML file when using a direct file path.');
+        if (!absoluteTarget.toLowerCase().endsWith(".html")) {
+            throw createDevError("invalid_target", "Provide an HTML file when using a direct file path.");
         }
         let surfaceTargets = cloneSurfaceTargets(DEFAULT_SURFACE_TARGETS);
-        let derivedName = (0, node_path_1.basename)(absoluteTarget, '.html');
+        let derivedName = (0, node_path_1.basename)(absoluteTarget, ".html");
         let derivedCataloguePath = null;
         try {
             const info = (0, catalogue_utils_1.findAppCatalogueInfo)(absoluteTarget);
@@ -182,7 +182,7 @@ function resolveDevTarget(targetArg, appOption) {
     }
     const cataloguePath = findNearestCatalogue(process.cwd());
     if (!cataloguePath) {
-        throw createDevError('catalogue_missing', `Could not find catalogue.json for app "${targetArg}". Run "playdrop project dev" from a workspace or provide a file path.`);
+        throw createDevError("catalogue_missing", `Could not find catalogue.json for app "${targetArg}". Run "playdrop project dev" from a workspace or provide a file path.`);
     }
     return resolveAppFromCatalogue(cataloguePath, targetArg);
 }
@@ -191,10 +191,10 @@ function findProjectInfo(htmlPath) {
     const visited = new Set();
     while (!visited.has(current)) {
         visited.add(current);
-        const candidate = (0, node_path_1.join)(current, 'package.json');
+        const candidate = (0, node_path_1.join)(current, "package.json");
         if ((0, node_fs_1.existsSync)(candidate) && (0, node_fs_1.statSync)(candidate).isFile()) {
             try {
-                const pkg = JSON.parse((0, node_fs_1.readFileSync)(candidate, 'utf8'));
+                const pkg = JSON.parse((0, node_fs_1.readFileSync)(candidate, "utf8"));
                 return { projectDir: current, packageJsonPath: candidate, packageJson: pkg };
             }
             catch {

package/dist/commands/doctor.d.ts

@@ -1,6 +1,6 @@
-import { type ClientStatus } from './clients';
-import { type AgentsStatus } from './agents';
-import { type WorkspaceCacheView } from './workspaces';
+import { type ClientStatus } from "./clients";
+import { type AgentsStatus } from "./agents";
+import { type WorkspaceCacheView } from "./workspaces";
 interface ToolHealth {
     installed: boolean;
     version?: string;
@@ -19,7 +19,7 @@ interface AccountHealth {
 interface CliHealth {
     version: string;
     latestVersion?: string;
-    updateStatus: 'current' | 'update-available' | 'unknown';
+    updateStatus: "current" | "update-available" | "unknown";
     updateAvailable?: boolean;
     nextAction?: string;
     command?: CliCommandHealth;
@@ -29,7 +29,7 @@ interface CliCommandHealth {
     path?: string;
     npmGlobalBin?: string;
     npmShimPath?: string;
-    issue?: 'not-on-path' | 'shim-missing';
+    issue?: "not-on-path" | "shim-missing";
 }
 export interface DoctorReport {
     cli: CliHealth;

package/dist/commands/doctor.js

@@ -19,16 +19,20 @@ async function showDoctor(options = {}) {
         return null;
     }
     const providers = options.providers ?? {};
-    const includeClients = !section || section === 'clients';
-    const includeAgents = !section || section === 'agents';
-    const includeWorkspaces = !section || section === 'workspaces';
+    const includeClients = !section || section === "clients";
+    const includeAgents = !section || section === "agents";
+    const includeWorkspaces = !section || section === "workspaces";
     const [cli, account, tools, clients, agents, workspaces] = await Promise.all([
         providers.cli ? providers.cli() : getCliHealth(),
         providers.account ? providers.account() : getAccountHealth(),
         providers.tools ? providers.tools() : getToolsHealth(),
         includeClients ? (providers.clients ? providers.clients() : (0, clients_1.getClientStatus)()) : Promise.resolve(undefined),
         includeAgents ? (providers.agents ? providers.agents() : (0, agents_1.getAgentsStatus)()) : Promise.resolve(undefined),
-        includeWorkspaces ? (providers.workspaces ? providers.workspaces() : Promise.resolve(buildWorkspaceDoctorStatus(options.cwd))) : Promise.resolve(undefined),
+        includeWorkspaces
+            ? providers.workspaces
+                ? providers.workspaces()
+                : Promise.resolve(buildWorkspaceDoctorStatus(options.cwd))
+            : Promise.resolve(undefined),
     ]);
     const report = {
         cli,
@@ -51,7 +55,7 @@ function normalizeSection(value) {
     if (!value) {
         return null;
     }
-    return value === 'clients' || value === 'agents' || value === 'workspaces' ? value : null;
+    return value === "clients" || value === "agents" || value === "workspaces" ? value : null;
 }
 async function getAccountHealth() {
     const session = (0, config_1.getCurrentAccountSession)((0, config_1.loadConfig)());
@@ -63,11 +67,11 @@ async function getAccountHealth() {
 async function getCliHealth() {
     const currentVersion = (0, clientInfo_1.getCliVersion)();
     const command = getCliCommandHealth();
-    const result = (0, shellProbe_1.runShell)('npm view @playdrop/playdrop-cli version --json');
+    const result = (0, shellProbe_1.runShell)("npm view @playdrop/playdrop-cli version --json");
     if (result.exitCode !== 0 || !result.output.trim()) {
         return {
             version: (0, clientInfo_1.getCliVersionLabel)(),
-            updateStatus: 'unknown',
+            updateStatus: "unknown",
             command,
         };
     }
@@ -75,7 +79,7 @@ async function getCliHealth() {
     if (!latestVersion) {
         return {
             version: (0, clientInfo_1.getCliVersionLabel)(),
-            updateStatus: 'unknown',
+            updateStatus: "unknown",
             command,
         };
     }
@@ -83,51 +87,51 @@ async function getCliHealth() {
     return {
         version: (0, clientInfo_1.getCliVersionLabel)(),
         latestVersion,
-        updateStatus: updateAvailable ? 'update-available' : 'current',
+        updateStatus: updateAvailable ? "update-available" : "current",
         updateAvailable,
-        nextAction: updateAvailable ? 'playdrop update' : undefined,
+        nextAction: updateAvailable ? "playdrop update" : undefined,
         command,
     };
 }
 function getCliCommandHealth(platform = process.platform) {
-    const pathProbe = (0, shellProbe_1.runShell)((0, shellProbe_1.buildCommandPathProbe)('playdrop', platform), platform);
+    const pathProbe = (0, shellProbe_1.runShell)((0, shellProbe_1.buildCommandPathProbe)("playdrop", platform), platform);
     if (pathProbe.exitCode === 0 && pathProbe.output.trim()) {
         return {
             available: true,
-            path: pathProbe.output.split('\n')[0]?.trim(),
+            path: pathProbe.output.split("\n")[0]?.trim(),
         };
     }
-    if (platform !== 'win32') {
-        return { available: false, issue: 'not-on-path' };
+    if (platform !== "win32") {
+        return { available: false, issue: "not-on-path" };
     }
     const npmGlobalBin = resolveNpmGlobalBin(platform);
-    const npmShimPath = npmGlobalBin ? (0, node_path_1.join)(npmGlobalBin, 'playdrop.cmd') : undefined;
+    const npmShimPath = npmGlobalBin ? (0, node_path_1.join)(npmGlobalBin, "playdrop.cmd") : undefined;
     const shimExists = npmShimPath ? (0, node_fs_1.existsSync)(npmShimPath) : false;
     return {
         available: false,
         npmGlobalBin,
         npmShimPath: shimExists ? npmShimPath : undefined,
-        issue: shimExists ? 'not-on-path' : 'shim-missing',
+        issue: shimExists ? "not-on-path" : "shim-missing",
     };
 }
 function resolveNpmGlobalBin(platform) {
-    const prefix = (0, shellProbe_1.runShell)('npm config get prefix', platform).output.split('\n')[0]?.trim();
+    const prefix = (0, shellProbe_1.runShell)("npm config get prefix", platform).output.split("\n")[0]?.trim();
     return prefix && prefix.length > 0 ? prefix : undefined;
 }
 function parseNpmVersion(output) {
     const trimmed = output.trim();
     try {
         const parsed = JSON.parse(trimmed);
-        return typeof parsed === 'string' && parsed.trim().length > 0 ? parsed.trim() : undefined;
+        return typeof parsed === "string" && parsed.trim().length > 0 ? parsed.trim() : undefined;
     }
     catch {
-        return trimmed.length > 0 ? trimmed.split('\n')[0]?.trim() : undefined;
+        return trimmed.length > 0 ? trimmed.split("\n")[0]?.trim() : undefined;
     }
 }
 async function getToolsHealth() {
     const [node, npm, git] = await Promise.all([
-        detectTool('node', ['--version']),
-        detectTool('npm', ['--version']),
+        detectTool("node", ["--version"]),
+        detectTool("npm", ["--version"]),
         detectGit(),
     ]);
     return { node, npm, git };
@@ -137,20 +141,20 @@ async function detectTool(command, versionArgs) {
     if (pathProbe.exitCode !== 0 || !pathProbe.output) {
         return { installed: false };
     }
-    const version = (0, shellProbe_1.runShell)([command, ...versionArgs].join(' '));
+    const version = (0, shellProbe_1.runShell)([command, ...versionArgs].join(" "));
     return {
         installed: true,
-        path: pathProbe.output.split('\n')[0]?.trim(),
-        version: version.exitCode === 0 ? version.output.split('\n')[0]?.trim() : undefined,
+        path: pathProbe.output.split("\n")[0]?.trim(),
+        version: version.exitCode === 0 ? version.output.split("\n")[0]?.trim() : undefined,
     };
 }
 async function detectGit() {
-    const status = await detectTool('git', ['--version']);
+    const status = await detectTool("git", ["--version"]);
     if (!status.installed) {
         return status;
     }
-    const email = (0, shellProbe_1.runShell)('git config --global --get user.email').output.trim();
-    const name = (0, shellProbe_1.runShell)('git config --global --get user.name').output.trim();
+    const email = (0, shellProbe_1.runShell)("git config --global --get user.email").output.trim();
+    const name = (0, shellProbe_1.runShell)("git config --global --get user.name").output.trim();
     const identity = email ? (name ? `${name} <${email}>` : email) : name || undefined;
     return { ...status, identity };
 }
@@ -180,7 +184,7 @@ function collectNextActions(cli, clients, agents, workspaces) {
     }
     if (workspaces && workspaces.workspaces.length === 0) {
         actions.push(recommendedWorkspaceRefreshCommand());
-        actions.push('playdrop workspaces init');
+        actions.push("playdrop workspaces init");
     }
     return [...new Set(actions)];
 }
@@ -188,17 +192,17 @@ function recommendedWorkspaceRefreshCommand() {
     return (0, workspaces_1.getWorkspaceRefreshExample)();
 }
 function printDoctorReport(report) {
-    const cliUpdate = report.cli.updateStatus === 'update-available'
+    const cliUpdate = report.cli.updateStatus === "update-available"
         ? `, update available: ${report.cli.latestVersion}`
-        : report.cli.updateStatus === 'current'
-            ? ', current'
-            : ', update status unknown';
+        : report.cli.updateStatus === "current"
+            ? ", current"
+            : ", update status unknown";
     console.log(`PlayDrop CLI: ${report.cli.version}${cliUpdate}`);
     printCliCommandDoctorStatus(report.cli.command);
-    console.log(`Account: ${report.account.loggedIn ? report.account.identity ?? 'logged in' : 'not logged in'}`);
-    console.log(`Node: ${report.tools.node.installed ? report.tools.node.version ?? 'installed' : 'missing'}`);
-    console.log(`npm: ${report.tools.npm.installed ? report.tools.npm.version ?? 'installed' : 'missing'}`);
-    console.log(`Git: ${report.tools.git.installed ? report.tools.git.identity ?? report.tools.git.version ?? 'installed' : 'missing'}`);
+    console.log(`Account: ${report.account.loggedIn ? (report.account.identity ?? "logged in") : "not logged in"}`);
+    console.log(`Node: ${report.tools.node.installed ? (report.tools.node.version ?? "installed") : "missing"}`);
+    console.log(`npm: ${report.tools.npm.installed ? (report.tools.npm.version ?? "installed") : "missing"}`);
+    console.log(`Git: ${report.tools.git.installed ? (report.tools.git.identity ?? report.tools.git.version ?? "installed") : "missing"}`);
     if (report.clients) {
         printNativeClientDoctorStatus(report.clients);
     }
@@ -217,7 +221,7 @@ function printDoctorReport(report) {
         }
     }
     if (report.nextActions.length > 0) {
-        console.log('Next actions:');
+        console.log("Next actions:");
         for (const action of report.nextActions) {
             console.log(`  Run: ${action}`);
         }
@@ -228,10 +232,10 @@ function printCliCommandDoctorStatus(command) {
         return;
     }
     if (command.available) {
-        console.log(`CLI command: ${command.path ?? 'available'}`);
+        console.log(`CLI command: ${command.path ?? "available"}`);
         return;
     }
-    console.log('CLI command: not on PATH');
+    console.log("CLI command: not on PATH");
     if (command.npmShimPath) {
         console.log(`  Direct npm shim: ${command.npmShimPath}`);
     }
@@ -245,13 +249,13 @@ function printNativeClientDoctorStatus(status) {
         return;
     }
     if (!status.installed) {
-        console.log('Native client: missing');
+        console.log("Native client: missing");
         if (status.reason) {
             console.log(`  ${status.reason}`);
         }
         return;
     }
-    const statusLabel = status.updateAvailable ? 'update available' : 'up to date';
+    const statusLabel = status.updateAvailable ? "update available" : "up to date";
     console.log(`Native client: ${statusLabel}`);
     console.log(`  Installed: ${formatVersionBuild(status.version, status.build)}`);
     if (status.latestVersion || status.latestBuild) {
@@ -262,14 +266,14 @@ function printNativeClientDoctorStatus(status) {
     }
 }
 function printAgentsDoctorStatus(status) {
-    console.log('Agents:');
+    console.log("Agents:");
     if (status.agents.length === 0) {
-        console.log('  none detected');
+        console.log("  none detected");
         return;
     }
     for (const agent of status.agents) {
         console.log(`  ${agent.name}`);
-        console.log(`    App: ${agent.app.installed ? agent.app.path ? `installed at ${agent.app.path}` : 'installed' : 'missing'}`);
+        console.log(`    App: ${agent.app.installed ? (agent.app.path ? `installed at ${agent.app.path}` : "installed") : "missing"}`);
         console.log(`    CLI: ${formatAgentCli(agent.cli)}`);
         console.log(`    Account: ${formatAgentAccount(agent.account)}`);
         console.log(`    Plugin: ${formatAgentPlugin(agent.plugin)}`);
@@ -279,13 +283,13 @@ function formatVersionBuild(version, build) {
     if (version && build) {
         return `${version} (build ${build})`;
     }
-    return version ?? build ?? 'unknown';
+    return version ?? build ?? "unknown";
 }
 function formatAgentCli(cli) {
     if (!cli.installed) {
-        return 'missing';
+        return "missing";
     }
-    const label = cli.version ?? 'installed';
+    const label = cli.version ?? "installed";
     return cli.path ? `${label} at ${cli.path}` : label;
 }
 function formatAgentAccount(account) {
@@ -293,24 +297,26 @@ function formatAgentAccount(account) {
         return account.subscription ? `${account.identity} (${account.subscription})` : account.identity;
     }
     if (account?.signedIn === false) {
-        return 'not signed in';
+        return "not signed in";
     }
-    return 'unknown';
+    return "unknown";
 }
 function formatAgentPlugin(plugin) {
-    if (plugin.status === 'manual-verification-required') {
-        return plugin.latestVersion ? `manual verification required, latest: ${plugin.latestVersion}` : 'manual verification required';
+    if (plugin.status === "manual-verification-required") {
+        return plugin.latestVersion
+            ? `manual verification required, latest: ${plugin.latestVersion}`
+            : "manual verification required";
     }
-    if (plugin.status === 'unknown') {
-        return plugin.message ? `unknown (${plugin.message})` : 'unknown';
+    if (plugin.status === "unknown") {
+        return plugin.message ? `unknown (${plugin.message})` : "unknown";
     }
     if (!plugin.installed) {
-        return plugin.latestVersion ? `missing, latest: ${plugin.latestVersion}` : 'missing';
+        return plugin.latestVersion ? `missing, latest: ${plugin.latestVersion}` : "missing";
     }
-    const installedVersion = plugin.version ?? 'installed';
-    const enabled = plugin.status === 'activation-required' || plugin.enabled === false ? ', activation required' : '';
+    const installedVersion = plugin.version ?? "installed";
+    const enabled = plugin.status === "activation-required" || plugin.enabled === false ? ", activation required" : "";
     if (plugin.updateAvailable) {
-        return `${installedVersion}${enabled}, update available: ${plugin.latestVersion ?? 'unknown'}`;
+        return `${installedVersion}${enabled}, update available: ${plugin.latestVersion ?? "unknown"}`;
     }
     return `${installedVersion}${enabled}, up to date`;
 }