@playdrop/playdrop-cli 0.3.4-build.1 → 0.3.5-build.1

package/dist/commands/dev.js

@@ -17,19 +17,19 @@ const DEFAULT_ROOM_BASE = 'http://localhost:3001';
 async function dev(targetArg, _port, appOption) {
     const cfg = (0, config_1.loadConfig)();
     if (!cfg.env) {
-        (0, messages_1.printConfigEnvironmentMissing)('dev');
+        (0, messages_1.printConfigEnvironmentMissing)('project dev');
         process.exitCode = 1;
         return;
     }
     if (!cfg.token) {
-        (0, messages_1.printLoginRequired)('Starting the dev server', 'dev');
+        (0, messages_1.printLoginRequired)('Starting the dev server', 'project dev');
         process.exitCode = 1;
         return;
     }
     const envConfig = (0, environment_1.resolveEnvironmentConfig)(cfg.env);
     if (!envConfig) {
         const choices = (0, environment_1.formatEnvironmentList)();
-        (0, messages_1.printUnknownEnvironment)(cfg.env, choices, 'dev');
+        (0, messages_1.printUnknownEnvironment)(cfg.env, choices, 'project dev');
         process.exitCode = 1;
         return;
     }
@@ -51,25 +51,25 @@ async function dev(targetArg, _port, appOption) {
                 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-cli create" to register a new app.'];
+                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-cli dev" from a workspace with catalogue.json or provide the path to an HTML file.'];
+                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.'];
                 break;
             case 'empty_catalogue':
-                suggestions = ['Add apps to catalogue.json before running "playdrop-cli dev".'];
+                suggestions = ['Add apps to catalogue.json before running "playdrop project dev".'];
                 break;
             case 'invalid_catalogue':
-                suggestions = ['Fix the catalogue.json file and rerun "playdrop-cli dev".'];
+                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.'];
                 break;
         }
-        (0, messages_1.printErrorWithHelp)(message, suggestions, { command: 'dev' });
+        (0, messages_1.printErrorWithHelp)(message, suggestions, { command: 'project dev' });
         process.exitCode = 1;
         return;
     }
@@ -78,7 +78,7 @@ async function dev(targetArg, _port, appOption) {
     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: 'dev' });
+        ], { command: 'project dev' });
         process.exitCode = 1;
         return;
     }
@@ -99,8 +99,8 @@ async function dev(targetArg, _port, appOption) {
         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.',
-                'Run "playdrop-cli create <name>" to scaffold a new entry if needed.',
-            ], { command: 'dev' });
+                'Run "playdrop project create app <name>" to scaffold a new entry if needed.',
+            ], { command: 'project dev' });
             process.exitCode = 1;
             return;
         }
@@ -120,22 +120,22 @@ async function dev(targetArg, _port, appOption) {
         }
         if (error instanceof types_1.ApiError) {
             (0, messages_1.printErrorWithHelp)(`Could not fetch your account (status ${error.status}).`, [
-                'Run "playdrop-cli login" to refresh your session and ensure the API is reachable.',
-                'Use "playdrop-cli whoami" afterwards to confirm your status.'
-            ], { command: 'dev' });
+                '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' });
             process.exitCode = 1;
             return;
         }
         if ((0, devShared_1.isNetworkError)(error)) {
-            (0, messages_1.printNetworkIssue)('Could not reach the Playdrop API to resolve your account.', 'dev');
+            (0, messages_1.printNetworkIssue)('Could not reach the Playdrop API to resolve your account.', 'project dev');
             process.exitCode = 1;
             return;
         }
         if (error instanceof Error && error.message === 'DEV_USERNAME_EMPTY') {
             (0, messages_1.printErrorWithHelp)('Could not determine your Playdrop creator username.', [
-                'Retry "playdrop-cli dev" in a moment.',
+                'Retry "playdrop project dev" in a moment.',
                 'If the problem persists, contact the Playdrop team.'
-            ], { command: 'dev' });
+            ], { command: 'project dev' });
             process.exitCode = 1;
             return;
         }
@@ -158,21 +158,21 @@ async function dev(targetArg, _port, appOption) {
             if (error instanceof types_1.ApiError) {
                 if (error.status === 404) {
                     (0, messages_1.printErrorWithHelp)(`App ${currentUsername}/${appName} is not registered on ${cfg.env}.`, [
-                        `Run "playdrop-cli create ${appName}" to register the app before starting the dev server.`,
+                        `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: 'dev' });
+                    ], { 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: '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 verify the app registration.', 'dev');
+                (0, messages_1.printNetworkIssue)('Could not reach the Playdrop API to verify the app registration.', 'project dev');
                 process.exitCode = 1;
                 return;
             }
@@ -219,7 +219,7 @@ async function dev(targetArg, _port, appOption) {
             (0, messages_1.printErrorWithHelp)(error?.message || 'Failed to upload dev ECS config to engine-server.', [
                 'Ensure catalogue entry includes valid "ecs" and "server" paths.',
                 'Check PLAYDROP_ROOM_BASE or the default http://localhost:3001 is reachable.',
-            ], { command: 'dev' });
+            ], { command: 'project dev' });
             process.exitCode = 1;
             return;
         }
@@ -237,7 +237,7 @@ async function dev(targetArg, _port, appOption) {
         (0, messages_1.printErrorWithHelp)(error?.message || `Failed to start dev server on port ${portToUse}.`, [
             'Check if another process is already using the port.',
             'Ensure the HTML file exists and is readable.',
-        ], { command: 'dev' });
+        ], { command: 'project dev' });
         process.exitCode = 1;
         return;
     }
@@ -275,7 +275,7 @@ async function dev(targetArg, _port, appOption) {
         console.log(`\n🎮 Test your app at:`);
         console.log(`   ${iframeUrl}`);
         console.log('\nMake something fun then share it with');
-        console.log(`playdrop-cli upload ${appName}`);
+        console.log(`playdrop project publish ${appName}`);
     }
     else {
         console.log(`\nOpen ${handle.appUrl} in your browser to test locally.`);

package/dist/commands/devShared.js

@@ -128,7 +128,7 @@ function resolveDevTarget(targetArg, appOption) {
     if (!targetArg) {
         const cataloguePath = findNearestCatalogue(process.cwd());
         if (!cataloguePath) {
-            throw createDevError('catalogue_missing', 'Run "playdrop-cli 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);
     }
@@ -179,7 +179,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-cli 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);
 }

package/dist/commands/documentation.d.ts

@@ -1 +1,4 @@
-export declare function documentation(pathArg?: string): Promise<void>;
+export declare function browseDocumentation(options?: {
+    json?: boolean;
+}): Promise<void>;
+export declare function readDocumentation(pathArg: string | undefined): Promise<void>;

package/dist/commands/documentation.js

@@ -1,9 +1,10 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.documentation = documentation;
-const config_1 = require("../config");
-const environment_1 = require("../environment");
+exports.browseDocumentation = browseDocumentation;
+exports.readDocumentation = readDocumentation;
+const commandContext_1 = require("../commandContext");
 const messages_1 = require("../messages");
+const output_1 = require("../output");
 const DOCUMENTATION_ROOT = 'documentation';
 const DOCUMENTATION_INDEX_FILE = 'documentation.json';
 function normalizeDocPath(value) {
@@ -22,131 +23,105 @@ function normalizeDocPath(value) {
     return segments.join('/');
 }
 function encodePathSegments(pathValue) {
-    const segments = pathValue.split('/');
-    const encodedSegments = segments.map((segment) => encodeURIComponent(segment));
-    return encodedSegments.join('/');
+    return pathValue
+        .split('/')
+        .map((segment) => encodeURIComponent(segment))
+        .join('/');
 }
 function buildDocumentationIndexUrl(base) {
-    const normalizedBase = base.replace(/\/$/, '');
-    return `${normalizedBase}/${DOCUMENTATION_ROOT}/${encodeURIComponent(DOCUMENTATION_INDEX_FILE)}`;
+    return `${base.replace(/\/$/, '')}/${DOCUMENTATION_ROOT}/${encodeURIComponent(DOCUMENTATION_INDEX_FILE)}`;
 }
 function buildDocumentationFileUrl(base, relativePath) {
-    const normalizedBase = base.replace(/\/$/, '');
-    return `${normalizedBase}/${DOCUMENTATION_ROOT}/${encodePathSegments(relativePath)}`;
+    return `${base.replace(/\/$/, '')}/${DOCUMENTATION_ROOT}/${encodePathSegments(relativePath)}`;
 }
-async function fetchDocumentationIndex(indexUrl) {
+async function fetchDocumentationIndex(indexUrl, command) {
     let response;
     try {
         response = await fetch(indexUrl);
     }
-    catch {
-        (0, messages_1.printNetworkIssue)('Fetching documentation index failed.', 'documentation');
+    catch (error) {
+        (0, messages_1.printErrorWithHelp)('Fetching documentation failed.', [error instanceof Error ? error.message : String(error)], { command });
         process.exitCode = 1;
         return null;
     }
     if (!response.ok) {
-        (0, messages_1.printErrorWithHelp)(`Failed to fetch documentation index from ${indexUrl}.`, [`HTTP ${response.status} ${response.statusText}`], { command: 'documentation' });
+        (0, messages_1.printErrorWithHelp)(`Failed to fetch documentation from ${indexUrl}.`, [`HTTP ${response.status} ${response.statusText}`], { command });
         process.exitCode = 1;
         return null;
     }
-    try {
-        const payload = await response.json();
-        if (!Array.isArray(payload) || payload.some((entry) => typeof entry !== 'string')) {
-            throw new Error('invalid payload');
-        }
-        return payload;
-    }
-    catch {
-        (0, messages_1.printErrorWithHelp)(`Documentation index at ${indexUrl} is not valid JSON.`, ['Contact the platform team to refresh the documentation assets.'], { command: 'documentation' });
-        process.exitCode = 1;
-        return null;
-    }
-}
-async function fetchDocumentationFile(fileUrl) {
-    let response;
-    try {
-        response = await fetch(fileUrl);
-    }
-    catch {
-        (0, messages_1.printNetworkIssue)('Fetching documentation content failed.', 'documentation');
-        process.exitCode = 1;
-        return null;
-    }
-    if (!response.ok) {
-        (0, messages_1.printErrorWithHelp)(`Failed to fetch documentation content from ${fileUrl}.`, [`HTTP ${response.status} ${response.statusText}`], { command: 'documentation' });
-        process.exitCode = 1;
-        return null;
-    }
-    try {
-        return await response.text();
-    }
-    catch {
-        (0, messages_1.printErrorWithHelp)('The documentation response could not be read.', ['Retry in a moment or contact the platform team if the issue persists.'], { command: 'documentation' });
+    const payload = await response.json().catch(() => null);
+    if (!Array.isArray(payload) || payload.some((entry) => typeof entry !== 'string')) {
+        (0, messages_1.printErrorWithHelp)('Documentation index is invalid.', ['Retry in a moment or contact the platform team.'], { command });
         process.exitCode = 1;
         return null;
     }
+    return payload;
 }
-async function documentation(pathArg) {
-    const cfg = (0, config_1.loadConfig)();
-    const configuredEnv = cfg.env;
-    if (!configuredEnv) {
-        (0, messages_1.printConfigEnvironmentMissing)('documentation');
-        process.exitCode = 1;
-        return;
-    }
-    const envConfig = (0, environment_1.resolveEnvironmentConfig)(configuredEnv);
-    if (!envConfig) {
-        const choices = (0, environment_1.formatEnvironmentList)();
-        (0, messages_1.printUnknownEnvironment)(configuredEnv, choices, 'documentation');
-        process.exitCode = 1;
-        return;
-    }
-    if (!envConfig.cdnBase) {
-        (0, messages_1.printErrorWithHelp)(`Environment "${envConfig.name}" does not include a CDN base URL.`, [
-            'Set PLAYDROP_CDN_BASE (or the environment-specific override) before retrying.',
-            'Run "playdrop-cli login --env <env>" after updating environment overrides to refresh the CLI configuration.'
-        ], { command: 'documentation' });
-        process.exitCode = 1;
-        return;
-    }
-    if (envConfig.allowInsecureRequests) {
-        process.env.NODE_TLS_REJECT_UNAUTHORIZED = '0';
-    }
-    const indexUrl = buildDocumentationIndexUrl(envConfig.cdnBase);
-    const rawEntries = await fetchDocumentationIndex(indexUrl);
-    if (!rawEntries) {
-        return;
-    }
-    const normalizedEntries = rawEntries
-        .map((entry) => normalizeDocPath(entry))
-        .filter((entry) => Boolean(entry));
-    if (normalizedEntries.length === 0) {
-        (0, messages_1.printErrorWithHelp)('Documentation index is empty.', ['Verify the staging pipeline published documentation.json with entries.'], { command: 'documentation' });
-        process.exitCode = 1;
-        return;
-    }
-    const sortedEntries = [...new Set(normalizedEntries)].sort((a, b) => a.localeCompare(b));
-    if (!pathArg) {
-        for (const entry of sortedEntries) {
-            console.log(entry);
+async function browseDocumentation(options = {}) {
+    await (0, commandContext_1.withPublicEnvironment)('documentation browse', async ({ envConfig }) => {
+        if (!envConfig.cdnBase) {
+            (0, messages_1.printErrorWithHelp)(`Environment "${envConfig.name}" does not include a documentation base URL.`, ['Set PLAYDROP_CDN_BASE or use an environment that publishes documentation assets.'], { command: 'documentation browse' });
+            process.exitCode = 1;
+            return;
         }
-        return;
-    }
+        const entries = await fetchDocumentationIndex(buildDocumentationIndexUrl(envConfig.cdnBase), 'documentation browse');
+        if (!entries) {
+            return;
+        }
+        const items = [...new Set(entries.map((entry) => normalizeDocPath(entry)).filter((entry) => Boolean(entry)))].sort((a, b) => a.localeCompare(b));
+        if (options.json) {
+            (0, output_1.printJson)({ items });
+            return;
+        }
+        if (items.length === 0) {
+            console.log('No documentation entries were returned.');
+            return;
+        }
+        console.log('Documentation:\n');
+        for (const item of items) {
+            console.log(item);
+        }
+        console.log('\nNext: run "playdrop documentation read <path>" to open one entry.');
+    });
+}
+async function readDocumentation(pathArg) {
     const normalizedTarget = normalizeDocPath(pathArg);
     if (!normalizedTarget) {
-        (0, messages_1.printErrorWithHelp)(`Path "${pathArg}" is not a valid documentation entry.`, ['Use POSIX-style relative paths, for example "sdk/getting-started.md".'], { command: 'documentation' });
+        (0, messages_1.printErrorWithHelp)('A documentation path is required.', ['Use a relative path such as sdk/getting-started.md.', 'Run "playdrop documentation browse" to list available entries.'], { command: 'documentation read' });
         process.exitCode = 1;
         return;
     }
-    if (!sortedEntries.includes(normalizedTarget)) {
-        (0, messages_1.printErrorWithHelp)(`Documentation entry "${normalizedTarget}" was not found.`, ['Run "playdrop-cli documentation" to list available entries.'], { command: 'documentation' });
-        process.exitCode = 1;
-        return;
-    }
-    const fileUrl = buildDocumentationFileUrl(envConfig.cdnBase, normalizedTarget);
-    const content = await fetchDocumentationFile(fileUrl);
-    if (content === null) {
-        return;
-    }
-    process.stdout.write(content);
+    await (0, commandContext_1.withPublicEnvironment)('documentation read', async ({ envConfig }) => {
+        if (!envConfig.cdnBase) {
+            (0, messages_1.printErrorWithHelp)(`Environment "${envConfig.name}" does not include a documentation base URL.`, ['Set PLAYDROP_CDN_BASE or use an environment that publishes documentation assets.'], { command: 'documentation read' });
+            process.exitCode = 1;
+            return;
+        }
+        const entries = await fetchDocumentationIndex(buildDocumentationIndexUrl(envConfig.cdnBase), 'documentation read');
+        if (!entries) {
+            return;
+        }
+        const normalizedEntries = [...new Set(entries.map((entry) => normalizeDocPath(entry)).filter((entry) => Boolean(entry)))];
+        if (!normalizedEntries.includes(normalizedTarget)) {
+            (0, messages_1.printErrorWithHelp)(`Documentation entry "${normalizedTarget}" was not found.`, ['Run "playdrop documentation browse" to list available entries.'], { command: 'documentation read' });
+            process.exitCode = 1;
+            return;
+        }
+        const fileUrl = buildDocumentationFileUrl(envConfig.cdnBase, normalizedTarget);
+        let response;
+        try {
+            response = await fetch(fileUrl);
+        }
+        catch (error) {
+            (0, messages_1.printErrorWithHelp)(`Fetching documentation entry "${normalizedTarget}" failed.`, [error instanceof Error ? error.message : String(error)], { command: 'documentation read' });
+            process.exitCode = 1;
+            return;
+        }
+        if (!response.ok) {
+            (0, messages_1.printErrorWithHelp)(`Failed to fetch "${normalizedTarget}".`, [`HTTP ${response.status} ${response.statusText}`], { command: 'documentation read' });
+            process.exitCode = 1;
+            return;
+        }
+        process.stdout.write(await response.text());
+    });
 }

package/dist/commands/feedback.d.ts

@@ -1,16 +1,19 @@
-type SubmitFeedbackOptions = {
+type FeedbackSendOptions = {
     title?: string;
     comment?: string;
     file?: string;
+    json?: boolean;
 };
-type FeedbackListOptions = {
-    limit?: string;
-    offset?: string;
+type FeedbackBrowseOptions = {
+    limit?: string | number;
+    offset?: string | number;
     source?: string;
-    userId?: string;
-    format?: string;
+    userId?: string | number;
+    json?: boolean;
 };
-export declare function submitFeedback(options?: SubmitFeedbackOptions): Promise<void>;
-export declare function listFeedback(options?: FeedbackListOptions): Promise<void>;
-export declare function deleteFeedback(id: string): Promise<void>;
+export declare function sendFeedback(options?: FeedbackSendOptions): Promise<void>;
+export declare function browseFeedback(options?: FeedbackBrowseOptions): Promise<void>;
+export declare function deleteFeedbackEntry(rawId: string | undefined, options?: {
+    json?: boolean;
+}): Promise<void>;
 export {};