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

package/dist/commands/generation.js

@@ -1,12 +1,16 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.generate = generate;
+exports.browseGenerationJobs = browseGenerationJobs;
+exports.showGenerationJob = showGenerationJob;
 exports.generations = generations;
 const types_1 = require("@playdrop/types");
 const node_fs_1 = require("node:fs");
 const node_path_1 = require("node:path");
 const commandContext_1 = require("../commandContext");
+const errors_1 = require("../errors");
 const messages_1 = require("../messages");
+const output_1 = require("../output");
 const IMAGE_ASPECT_RATIO_SET = new Set(['1:1', '3:4', '9:16', '4:3', '16:9']);
 const VIDEO_ASPECT_RATIO_SET = new Set(['16:9', '9:16']);
 const DEFAULT_SUBCATEGORY_BY_MODALITY = {
@@ -434,8 +438,7 @@ function printGenerateResult(modality, payload) {
         if (subcategory) {
             console.log(`Generated Subcategory: ${subcategory}`);
         }
-        console.log(`Download File Command: playdrop-cli assets download-file ${ref}`);
-        console.log(`Download Source Command: playdrop-cli assets download-source ${ref}`);
+        console.log(`Next: run "playdrop detail ${ref}" to inspect the generated asset.`);
     }
     else {
         console.log('Generated Asset: none');
@@ -458,71 +461,71 @@ async function generate(typeInput, promptInput, options = {}) {
     catch (error) {
         const message = typeof error?.message === 'string' ? error.message : 'invalid_input';
         if (message === 'missing_type') {
-            (0, messages_1.printErrorWithHelp)('A generation type is required.', ['Use one of: image, music, sfx, video, model_3d.'], { command: 'generate' });
+            (0, messages_1.printErrorWithHelp)('A generation type is required.', ['Use one of: image, music, sfx, video, model_3d.'], { command: 'ai create' });
             process.exitCode = 1;
             return;
         }
         if (message === 'missing_prompt') {
-            (0, messages_1.printErrorWithHelp)('A prompt is required.', ['Example: playdrop-cli generate image "A pixel art hero portrait"'], { command: 'generate' });
+            (0, messages_1.printErrorWithHelp)('A prompt is required.', ['Example: playdrop ai create image "A pixel art hero portrait"'], { command: 'ai create' });
             process.exitCode = 1;
             return;
         }
         if (message === 'invalid_type') {
-            (0, messages_1.printErrorWithHelp)('The generation type is invalid.', ['Use one of: image, music, sfx, video, model_3d.'], { command: 'generate' });
+            (0, messages_1.printErrorWithHelp)('The generation type is invalid.', ['Use one of: image, music, sfx, video, model_3d.'], { command: 'ai create' });
             process.exitCode = 1;
             return;
         }
         if (message === 'invalid_duration') {
-            (0, messages_1.printErrorWithHelp)('The --duration value is invalid.', ['Use a positive value like 20000, 20s, or 20000ms.'], { command: 'generate' });
+            (0, messages_1.printErrorWithHelp)('The --duration value is invalid.', ['Use a positive value like 20000, 20s, or 20000ms.'], { command: 'ai create' });
             process.exitCode = 1;
             return;
         }
         if (message === 'invalid_video_duration') {
-            (0, messages_1.printErrorWithHelp)('The --duration value for video is invalid.', ['Use 4s or 8s for video generation.'], { command: 'generate' });
+            (0, messages_1.printErrorWithHelp)('The --duration value for video is invalid.', ['Use 4s or 8s for video generation.'], { command: 'ai create' });
             process.exitCode = 1;
             return;
         }
         if (message === 'invalid_aspect_ratio') {
-            (0, messages_1.printErrorWithHelp)('The --ratio value is invalid.', ['Image: 1:1, 3:4, 9:16, 4:3, 16:9. Video: 16:9, 9:16.'], { command: 'generate' });
+            (0, messages_1.printErrorWithHelp)('The --ratio value is invalid.', ['Image: 1:1, 3:4, 9:16, 4:3, 16:9. Video: 16:9, 9:16.'], { command: 'ai create' });
             process.exitCode = 1;
             return;
         }
         if (message === 'missing_model3d_images') {
-            (0, messages_1.printErrorWithHelp)('Model 3D IMAGE source mode requires at least one reference image.', ['Provide --image1 <url> or --image2 <url>, or switch to --source-mode TEXT.'], { command: 'generate' });
+            (0, messages_1.printErrorWithHelp)('Model 3D IMAGE source mode requires at least one reference image.', ['Provide --image1 <url> or --image2 <url>, or switch to --source-mode TEXT.'], { command: 'ai create' });
             process.exitCode = 1;
             return;
         }
         if (message === 'model3d_text_mode_disallows_images') {
-            (0, messages_1.printErrorWithHelp)('Model 3D TEXT source mode cannot include reference images.', ['Remove --image1/--image2 or switch to --source-mode IMAGE.'], { command: 'generate' });
+            (0, messages_1.printErrorWithHelp)('Model 3D TEXT source mode cannot include reference images.', ['Remove --image1/--image2 or switch to --source-mode IMAGE.'], { command: 'ai create' });
             process.exitCode = 1;
             return;
         }
         if (message === 'invalid_asset_subcategory') {
-            (0, messages_1.printErrorWithHelp)('The --subcategory value is invalid.', ['Use a lowercase slug such as generic, music, sfx, or avatar.'], { command: 'generate' });
+            (0, messages_1.printErrorWithHelp)('The --subcategory value is invalid.', ['Use a lowercase slug such as generic, music, sfx, or avatar.'], { command: 'ai create' });
             process.exitCode = 1;
             return;
         }
         if (message.startsWith('image_ref_not_found:')) {
             const [, optionName, path] = message.split(':');
-            (0, messages_1.printErrorWithHelp)(`The ${optionName || 'image'} reference file was not found.`, [path ? `Missing file: ${path}` : 'Provide a valid local file path or HTTPS URL.'], { command: 'generate' });
+            (0, messages_1.printErrorWithHelp)(`The ${optionName || 'image'} reference file was not found.`, [path ? `Missing file: ${path}` : 'Provide a valid local file path or HTTPS URL.'], { command: 'ai create' });
             process.exitCode = 1;
             return;
         }
         if (message.startsWith('image_ref_not_file:')) {
             const [, optionName, path] = message.split(':');
-            (0, messages_1.printErrorWithHelp)(`The ${optionName || 'image'} reference is not a file.`, [path ? `Path must point to a file: ${path}` : 'Provide a valid local file path.'], { command: 'generate' });
+            (0, messages_1.printErrorWithHelp)(`The ${optionName || 'image'} reference is not a file.`, [path ? `Path must point to a file: ${path}` : 'Provide a valid local file path.'], { command: 'ai create' });
             process.exitCode = 1;
             return;
         }
         if (message.startsWith('image_ref_invalid_scheme:')) {
             const [, optionName, scheme] = message.split(':');
-            (0, messages_1.printErrorWithHelp)(`The ${optionName || 'image'} reference URL uses an unsupported scheme.`, [`Use an HTTPS URL or a local file path. Received: ${scheme || 'unknown'}`], { command: 'generate' });
+            (0, messages_1.printErrorWithHelp)(`The ${optionName || 'image'} reference URL uses an unsupported scheme.`, [`Use an HTTPS URL or a local file path. Received: ${scheme || 'unknown'}`], { command: 'ai create' });
             process.exitCode = 1;
             return;
         }
         if (message.startsWith('image_ref_signature_mismatch:')) {
             const [, optionName, path] = message.split(':');
-            (0, messages_1.printErrorWithHelp)(`The ${optionName || 'image'} reference file extension does not match its image signature.`, [path ? `Fix file type mismatch for: ${path}` : 'Ensure extension and file signature match (.png, .jpg, .jpeg, .webp).'], { command: 'generate' });
+            (0, messages_1.printErrorWithHelp)(`The ${optionName || 'image'} reference file extension does not match its image signature.`, [path ? `Fix file type mismatch for: ${path}` : 'Ensure extension and file signature match (.png, .jpg, .jpeg, .webp).'], { command: 'ai create' });
             process.exitCode = 1;
             return;
         }
@@ -531,44 +534,203 @@ async function generate(typeInput, promptInput, options = {}) {
             (0, messages_1.printErrorWithHelp)(`The ${optionName || 'image'} reference file type is unsupported.`, [
                 path ? `Unsupported file: ${path}` : 'Provide a supported local file.',
                 'Supported local image types: .png, .jpg, .jpeg, .webp.',
-            ], { command: 'generate' });
+            ], { command: 'ai create' });
             process.exitCode = 1;
             return;
         }
-        (0, messages_1.printErrorWithHelp)(`Invalid generate input: ${message}.`, ['Run "playdrop-cli generate --help" for valid options.'], {
-            command: 'generate',
+        (0, messages_1.printErrorWithHelp)(`Invalid AI create input: ${message}.`, ['Run "playdrop help ai create" for valid options.'], {
+            command: 'ai create',
         });
         process.exitCode = 1;
         return;
     }
-    await (0, commandContext_1.withEnvironment)('generate', 'Generating AI assets', async ({ aiClient }) => {
-        const created = await aiClient.createGenerationJob(parsed.request);
-        let job = created.job;
-        const jobId = String(job.id || '').trim();
-        if (!jobId) {
-            throw new Error('ai_generation_job_missing_id');
-        }
-        console.log(`Job ID: ${jobId}`);
-        console.log(`Status: ${formatJobStatus(job)}`);
-        const deadlineMs = Date.now() + parsed.timeoutSeconds * 1000;
-        while (job.status === 'PENDING' || job.status === 'RUNNING') {
-            if (Date.now() >= deadlineMs) {
-                throw new Error(`ai_generation_job_timeout: Timed out waiting for job ${jobId}`);
+    await (0, commandContext_1.withEnvironment)('ai create', 'Generating AI assets', async ({ aiClient }) => {
+        try {
+            const created = await aiClient.createGenerationJob(parsed.request);
+            let job = created.job;
+            const jobId = String(job.id || '').trim();
+            if (!jobId) {
+                throw new Error('ai_generation_job_missing_id');
             }
-            await sleep(parsed.pollIntervalMs);
-            const latest = await aiClient.getGenerationJob(jobId);
-            job = latest.job;
+            if (!options.json) {
+                console.log(`Job ID: ${jobId}`);
+                console.log(`Status: ${formatJobStatus(job)}`);
+            }
+            const deadlineMs = Date.now() + parsed.timeoutSeconds * 1000;
+            while (job.status === 'PENDING' || job.status === 'RUNNING') {
+                if (Date.now() >= deadlineMs) {
+                    throw new Error(`ai_generation_job_timeout: Timed out waiting for job ${jobId}`);
+                }
+                await sleep(parsed.pollIntervalMs);
+                const latest = await aiClient.getGenerationJob(jobId);
+                job = latest.job;
+                if (!options.json) {
+                    console.log(`Status: ${formatJobStatus(job)}`);
+                }
+            }
+            if (job.status !== 'SUCCESS') {
+                const errorCode = typeof job.errorCode === 'string' && job.errorCode.length > 0 ? job.errorCode : 'ai_generation_failed';
+                const errorMessage = typeof job.errorMessage === 'string' && job.errorMessage.length > 0
+                    ? job.errorMessage
+                    : 'Generation failed.';
+                throw new Error(`${errorCode}: ${errorMessage}`);
+            }
+            const payload = (job.resultData && typeof job.resultData === 'object') ? job.resultData : {};
+            if (options.json) {
+                (0, output_1.printJson)({ job, result: payload });
+                return;
+            }
+            printGenerateResult(parsed.modality, payload);
+        }
+        catch (error) {
+            if (!handleAiFailure(error, 'ai create', 'AI create')) {
+                throw error;
+            }
+        }
+    });
+}
+function parseJobModality(raw) {
+    if (!raw || raw.trim().length === 0 || raw.trim().toLowerCase() === 'all') {
+        return undefined;
+    }
+    return normalizeModality(raw);
+}
+function handleAiFailure(error, command, context) {
+    const handled = (0, errors_1.handleCommandFailure)(error, command, context, {
+        networkMessage: 'Could not reach the Playdrop AI API.',
+        apiMessage: (apiError) => {
+            if (apiError.status === 401 || apiError.status === 403) {
+                return {
+                    problem: `${context} requires you to be logged in.`,
+                    suggestions: ['Run "playdrop auth login" and retry.'],
+                };
+            }
+            return {
+                problem: `${context} failed with status ${apiError.status}.`,
+                suggestions: ['Retry in a moment.'],
+            };
+        },
+    });
+    if (handled) {
+        return true;
+    }
+    const status = typeof error?.status === 'number' ? Number(error.status) : null;
+    if (status !== null) {
+        if (status === 401 || status === 403) {
+            (0, messages_1.printErrorWithHelp)(`${context} requires you to be logged in.`, ['Run "playdrop auth login" and retry.'], { command });
+        }
+        else {
+            (0, messages_1.printErrorWithHelp)(`${context} failed with status ${status}.`, ['Retry in a moment.'], { command });
+        }
+        process.exitCode = 1;
+        return true;
+    }
+    const message = error instanceof Error ? error.message : String(error);
+    if (message === 'ai_generation_job_missing_id') {
+        (0, messages_1.printErrorWithHelp)('AI create failed because the server did not return a job id.', ['Retry the command. If the problem persists, contact Playdrop support.'], { command });
+        process.exitCode = 1;
+        return true;
+    }
+    if (message.startsWith('ai_generation_job_timeout:')) {
+        const detail = message.split(':').slice(1).join(':').trim();
+        (0, messages_1.printErrorWithHelp)(detail || 'AI create timed out while waiting for the job to finish.', ['Retry the command with a higher --timeout value if the job normally takes longer.'], { command });
+        process.exitCode = 1;
+        return true;
+    }
+    if (message.includes(':')) {
+        const [errorCode, ...rest] = message.split(':');
+        const detail = rest.join(':').trim();
+        if (errorCode && detail) {
+            (0, messages_1.printErrorWithHelp)(`AI create failed: ${detail}`, [`Error code: ${errorCode.trim()}`], { command });
+            process.exitCode = 1;
+            return true;
+        }
+    }
+    return false;
+}
+async function browseGenerationJobs(options = {}) {
+    const modality = parseJobModality(options.type);
+    if (options.type !== undefined && modality === null) {
+        (0, messages_1.printErrorWithHelp)('The --type value is invalid.', ['Use one of: image, music, sfx, video, model_3d, all.'], { command: 'ai jobs browse' });
+        process.exitCode = 1;
+        return;
+    }
+    let limit;
+    let offset;
+    try {
+        limit = parseOptionalPositiveInt(options.limit, 'limit');
+        offset = parseOptionalNonNegativeInt(options.offset, 'offset');
+    }
+    catch (error) {
+        const message = typeof error?.message === 'string' ? error.message : 'invalid_pagination';
+        (0, messages_1.printErrorWithHelp)(`Invalid ai jobs input: ${message}.`, ['Use positive integers for --limit and --offset.'], {
+            command: 'ai jobs browse',
+        });
+        process.exitCode = 1;
+        return;
+    }
+    await (0, commandContext_1.withEnvironment)('ai jobs browse', 'Browsing AI jobs', async ({ aiClient }) => {
+        try {
+            const response = await aiClient.listGenerationJobs({
+                modality: modality ?? undefined,
+                limit,
+                offset,
+            });
+            if (options.json) {
+                (0, output_1.printJson)({ items: response.jobs, pagination: response.pagination });
+                return;
+            }
+            if (!Array.isArray(response.jobs) || response.jobs.length === 0) {
+                console.log('No AI jobs found.');
+                console.log('Next: run "playdrop ai create <type> <prompt>" to start a new job.');
+                return;
+            }
+            console.log('AI jobs:\n');
+            for (const job of response.jobs) {
+                console.log(`${job.id} | ${job.modality.toLowerCase()} | ${formatJobStatus(job)} | ${job.createdAt}`);
+            }
+            console.log('\nNext: run "playdrop ai jobs detail <id>" to inspect one job.');
+        }
+        catch (error) {
+            if (!handleAiFailure(error, 'ai jobs browse', 'AI job lookup')) {
+                throw error;
+            }
+        }
+    });
+}
+async function showGenerationJob(id, options = {}) {
+    const jobId = typeof id === 'string' ? id.trim() : '';
+    if (!jobId) {
+        (0, messages_1.printErrorWithHelp)('A job id is required.', ['Example: playdrop ai jobs detail job_123'], { command: 'ai jobs detail' });
+        process.exitCode = 1;
+        return;
+    }
+    await (0, commandContext_1.withEnvironment)('ai jobs detail', 'Inspecting an AI job', async ({ aiClient }) => {
+        try {
+            const response = await aiClient.getGenerationJob(jobId);
+            if (options.json) {
+                (0, output_1.printJson)({ job: response.job });
+                return;
+            }
+            const job = response.job;
+            console.log(`Job: ${job.id}`);
+            console.log(`Type: ${job.modality.toLowerCase()}`);
             console.log(`Status: ${formatJobStatus(job)}`);
+            console.log(`Created: ${job.createdAt}`);
+            console.log(`Updated: ${job.updatedAt}`);
+            if (job.errorMessage) {
+                console.log(`Error: ${job.errorMessage}`);
+            }
+            if (job.linkedGenerationId) {
+                console.log(`Linked generation: ${job.linkedGenerationId}`);
+            }
+            console.log('\nNext: run "playdrop ai jobs browse" to review other jobs.');
         }
-        if (job.status !== 'SUCCESS') {
-            const errorCode = typeof job.errorCode === 'string' && job.errorCode.length > 0 ? job.errorCode : 'ai_generation_failed';
-            const errorMessage = typeof job.errorMessage === 'string' && job.errorMessage.length > 0
-                ? job.errorMessage
-                : 'Generation failed.';
-            throw new Error(`${errorCode}: ${errorMessage}`);
+        catch (error) {
+            if (!handleAiFailure(error, 'ai jobs detail', 'AI job detail lookup')) {
+                throw error;
+            }
         }
-        const payload = (job.resultData && typeof job.resultData === 'object') ? job.resultData : {};
-        printGenerateResult(parsed.modality, payload);
     });
 }
 async function generations(options = {}) {

package/dist/commands/gettingStarted.d.ts

@@ -0,0 +1 @@
+export declare function printGettingStarted(): void;

package/dist/commands/gettingStarted.js

@@ -0,0 +1,26 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.printGettingStarted = printGettingStarted;
+function printGettingStarted() {
+    console.log('Start here:\n');
+    console.log('1. Log in');
+    console.log('   playdrop auth login');
+    console.log('');
+    console.log('2. Initialize a workspace');
+    console.log('   playdrop project init .');
+    console.log('');
+    console.log('3. Create an app');
+    console.log('   playdrop project create app my-app --template playdrop/template/html_template');
+    console.log('');
+    console.log('4. Preview locally');
+    console.log('   playdrop project dev my-app');
+    console.log('');
+    console.log('5. Publish');
+    console.log('   playdrop project publish .');
+    console.log('');
+    console.log('Documentation:');
+    console.log('  playdrop documentation browse');
+    console.log('  playdrop documentation read getting-started.md');
+    console.log('');
+    console.log('Next: run "playdrop help" for the full command tree.');
+}

package/dist/commands/init.js

@@ -35,9 +35,9 @@ async function resolveUsername(apiBase, token) {
         const username = data.user?.username?.trim();
         if (!username) {
             (0, messages_1.printErrorWithHelp)('The Playdrop API returned an unexpected response.', [
-                'Retry "playdrop-cli init" in a moment.',
+                'Retry "playdrop project init" in a moment.',
                 'If the problem continues, contact the Playdrop team.'
-            ], { command: 'init' });
+            ], { command: 'project init' });
             process.exitCode = 1;
             return null;
         }
@@ -53,14 +53,14 @@ async function resolveUsername(apiBase, token) {
         }
         if (unknownError instanceof types_1.ApiError) {
             (0, messages_1.printErrorWithHelp)(`Request failed with status ${unknownError.status}.`, [
-                'Run "playdrop-cli login" to refresh your credentials.',
-                'Use "playdrop-cli init" again after logging in.'
-            ], { command: 'init' });
+                'Run "playdrop auth login" to refresh your credentials.',
+                'Use "playdrop project init" again after logging in.'
+            ], { command: 'project init' });
             process.exitCode = 1;
             return null;
         }
         const message = unknownError instanceof Error ? unknownError.message : String(unknownError);
-        (0, messages_1.printErrorWithHelp)('Could not reach the Playdrop API to resolve your account information.', [message], { command: 'init' });
+        (0, messages_1.printErrorWithHelp)('Could not reach the Playdrop API to resolve your account information.', [message], { command: 'project init' });
         process.exitCode = 1;
         return null;
     }
@@ -87,13 +87,13 @@ function normalizeBootstrapPayload(payload) {
     }
     const readmeUri = typeof payload.readmeUri === 'string' ? payload.readmeUri.trim() : '';
     if (!readmeUri) {
-        (0, messages_1.printErrorWithHelp)('Bootstrap payload is missing a README URI.', ['Contact the platform team or try again shortly.'], { command: 'init' });
+        (0, messages_1.printErrorWithHelp)('Bootstrap payload is missing a README URI.', ['Contact the platform team or try again shortly.'], { command: 'project init' });
         process.exitCode = 1;
         return null;
     }
     const agentsUri = typeof payload.agentsUri === 'string' ? payload.agentsUri.trim() : '';
     if (!agentsUri) {
-        (0, messages_1.printErrorWithHelp)('Bootstrap payload is missing an AGENTS URI.', ['Contact the platform team or try again shortly.'], { command: 'init' });
+        (0, messages_1.printErrorWithHelp)('Bootstrap payload is missing an AGENTS URI.', ['Contact the platform team or try again shortly.'], { command: 'project init' });
         process.exitCode = 1;
         return null;
     }
@@ -106,8 +106,8 @@ function normalizeBootstrapPayload(payload) {
 async function downloadBootstrapAsset(webBase, uri, label) {
     if (!webBase) {
         (0, messages_1.printErrorWithHelp)(`Cannot download ${label} because the current environment is missing a web base URL.`, [
-            'Set PLAYDROP_WEB_BASE, PLAYDROP_WEB_BASE_DEV, or the appropriate environment override before running "playdrop-cli init".'
-        ], { command: 'init' });
+            'Set PLAYDROP_WEB_BASE, PLAYDROP_WEB_BASE_DEV, or the appropriate environment override before running "playdrop project init".'
+        ], { command: 'project init' });
         process.exitCode = 1;
         return null;
     }
@@ -118,12 +118,12 @@ async function downloadBootstrapAsset(webBase, uri, label) {
     }
     catch (error) {
         const message = error instanceof Error ? error.message : String(error);
-        (0, messages_1.printErrorWithHelp)(`Failed to download ${label} from ${url}.`, [message], { command: 'init' });
+        (0, messages_1.printErrorWithHelp)(`Failed to download ${label} from ${url}.`, [message], { command: 'project init' });
         process.exitCode = 1;
         return null;
     }
     if (!response.ok) {
-        (0, messages_1.printErrorWithHelp)(`Failed to download ${label} from ${url}.`, [`HTTP ${response.status} ${response.statusText}`], { command: 'init' });
+        (0, messages_1.printErrorWithHelp)(`Failed to download ${label} from ${url}.`, [`HTTP ${response.status} ${response.statusText}`], { command: 'project init' });
         process.exitCode = 1;
         return null;
     }
@@ -133,7 +133,7 @@ async function downloadBootstrapAsset(webBase, uri, label) {
 async function fetchBootstrap(base) {
     const client = (0, apiClient_1.createCliApiClient)({ baseUrl: base });
     try {
-        const payload = await client.fetchCreatorBootstrap();
+        const payload = await client.fetchBootstrap();
         return payload;
     }
     catch (unknownError) {
@@ -161,8 +161,8 @@ async function init(targetPath, options = {}) {
     }
     if (stats && !stats.isDirectory()) {
         (0, messages_1.printErrorWithHelp)(`Cannot initialize a Playdrop project because ${resolved} is not a directory.`, [
-            'Choose a directory path (use "." for the current folder) or create the directory before running "playdrop-cli init".'
-        ], { command: 'init' });
+            'Choose a directory path (use "." for the current folder) or create the directory before running "playdrop project init".'
+        ], { command: 'project init' });
         process.exitCode = 1;
         return null;
     }
@@ -171,18 +171,20 @@ async function init(targetPath, options = {}) {
     const catalogueExisted = (0, node_fs_1.existsSync)(cataloguePath);
     const cfg = (0, config_1.loadConfig)();
     if (!cfg.token) {
-        (0, messages_1.printLoginRequired)('Bootstrapping a Playdrop project', 'init');
+        (0, messages_1.printLoginRequired)('Bootstrapping a Playdrop project', 'project init');
         process.exitCode = 1;
         return null;
     }
-    const preferredEnv = cfg.env ?? 'prod';
-    let envConfig = (0, environment_1.resolveEnvironmentConfig)(preferredEnv);
-    if (!envConfig && preferredEnv !== 'prod') {
-        envConfig = (0, environment_1.resolveEnvironmentConfig)('prod');
+    if (!cfg.env) {
+        (0, messages_1.printConfigEnvironmentMissing)('project init');
+        process.exitCode = 1;
+        return null;
     }
+    const preferredEnv = cfg.env;
+    const envConfig = (0, environment_1.resolveEnvironmentConfig)(preferredEnv);
     if (!envConfig) {
         const choices = (0, environment_1.formatEnvironmentList)();
-        (0, messages_1.printUnknownEnvironment)(preferredEnv, choices, 'init');
+        (0, messages_1.printUnknownEnvironment)(preferredEnv || '', choices, 'project init');
         process.exitCode = 1;
         return null;
     }
@@ -292,9 +294,9 @@ async function init(targetPath, options = {}) {
             console.log(` - ${action}`);
         }
         console.log('\nNext steps:');
-        console.log(' - Run "playdrop-cli create <app-name>" to scaffold your first app.');
-        console.log(' - Use "playdrop-cli dev <app-name>" to preview locally.');
-        console.log(' - Upload with "playdrop-cli upload ." when ready to share.');
+        console.log(' - Run "playdrop project create app <app-name>" to scaffold your first app.');
+        console.log(' - Use "playdrop project dev <app-name>" to preview locally.');
+        console.log(' - Publish with "playdrop project publish ." when ready to share.');
     }
     return summary;
 }

package/dist/commands/login.js

@@ -64,8 +64,8 @@ async function login(env, usernameArg, passwordArg) {
     }
     if (!username || !password) {
         (0, messages_1.printErrorWithHelp)('Username and password are required to log in.', [
-            'Provide both credentials when prompted, then rerun "playdrop-cli login".',
-        ], { command: 'login' });
+            'Provide both credentials when prompted, then rerun "playdrop auth login".',
+        ], { command: 'auth login' });
         process.exitCode = 1;
         return;
     }
@@ -80,9 +80,9 @@ async function login(env, usernameArg, passwordArg) {
             }
             if (unknownError instanceof types_1.ApiError) {
                 (0, messages_1.printErrorWithHelp)(`Login failed with status ${unknownError.status}.`, [
-                    'Verify your username and password, then rerun "playdrop-cli login".',
-                    'Use "playdrop-cli whoami" after logging in to confirm your status.'
-                ], { command: 'login' });
+                    'Verify your username and password, then rerun "playdrop auth login".',
+                    'Use "playdrop auth whoami" after logging in to confirm your status.'
+                ], { command: 'auth login' });
                 process.exitCode = 1;
                 return null;
             }
@@ -97,7 +97,7 @@ async function login(env, usernameArg, passwordArg) {
         if (e instanceof http_1.CLIUnsupportedClientError) {
             return;
         }
-        (0, messages_1.printNetworkIssue)('Could not reach the Playdrop API to log in.', 'login');
+        (0, messages_1.printNetworkIssue)('Could not reach the Playdrop API to log in.', 'auth login');
         process.exitCode = 1;
         return;
     }
@@ -108,10 +108,11 @@ async function login(env, usernameArg, passwordArg) {
         (0, messages_1.printErrorWithHelp)('Login succeeded but no access token was returned.', [
             'Please try again in a moment.',
             'If the issue persists, contact the Playdrop team.'
-        ], { command: 'login' });
+        ], { command: 'auth login' });
         process.exitCode = 1;
         return;
     }
     (0, config_1.saveConfig)({ token, env });
-    console.log(`Logged in as ${username} (${env})`);
+    console.log(`Logged in as ${username} on ${env}.`);
+    console.log('Next: run "playdrop auth whoami" to confirm your session.');
 }

package/dist/commands/logout.js

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

package/dist/commands/notifications.d.ts

@@ -0,0 +1,14 @@
+type BrowseNotificationsOptions = {
+    status?: string;
+    limit?: string | number;
+    offset?: string | number;
+    json?: boolean;
+};
+export declare function browseNotifications(options?: BrowseNotificationsOptions): Promise<void>;
+export declare function readNotification(rawId: string | undefined, options?: {
+    json?: boolean;
+}): Promise<void>;
+export declare function readAllNotifications(options?: {
+    json?: boolean;
+}): Promise<void>;
+export {};