@devicecloud.dev/dcd 5.0.0-beta.0 → 5.0.0-beta.2

package/dist/commands/list.d.ts

@@ -1,36 +1,36 @@
 export declare const listCommand: import("citty").CommandDef<{
-    from: {
-        type: "string";
-        description: string;
+    readonly from: {
+        readonly type: "string";
+        readonly description: "Filter uploads created on or after this date (ISO 8601 format, e.g., 2024-01-01)";
     };
-    json: {
-        type: "boolean";
-        description: string;
+    readonly json: {
+        readonly type: "boolean";
+        readonly description: "Output in JSON format";
     };
-    limit: {
-        type: "string";
-        default: string;
-        description: string;
+    readonly limit: {
+        readonly type: "string";
+        readonly default: "20";
+        readonly description: "Maximum number of uploads to return";
     };
-    name: {
-        type: "string";
-        description: string;
+    readonly name: {
+        readonly type: "string";
+        readonly description: "Filter by upload name (supports * wildcard, e.g., \"nightly-*\"). IMPORTANT: Always quote wildcards to prevent shell expansion!";
     };
-    offset: {
-        type: "string";
-        default: string;
-        description: string;
+    readonly offset: {
+        readonly type: "string";
+        readonly default: "0";
+        readonly description: "Number of uploads to skip (for pagination)";
     };
-    to: {
-        type: "string";
-        description: string;
+    readonly to: {
+        readonly type: "string";
+        readonly description: "Filter uploads created on or before this date (ISO 8601 format, e.g., 2024-01-31)";
     };
-    'api-key': {
+    readonly 'api-key': {
         readonly type: "string";
         readonly alias: ["apiKey"];
         readonly description: "API key for devicecloud.dev (find this in the console UI). You can also set the DEVICE_CLOUD_API_KEY environment variable.";
     };
-    'api-url': {
+    readonly 'api-url': {
         readonly type: "string";
         readonly alias: ["apiURL", "apiUrl"];
         readonly description: "API base URL (defaults to the URL stored by `dcd login`, else prod)";

package/dist/commands/list.js

@@ -1,13 +1,12 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.listCommand = void 0;
-const citty_1 = require("citty");
-const api_flags_1 = require("../config/flags/api.flags");
-const api_gateway_1 = require("../gateways/api-gateway");
-const auth_1 = require("../utils/auth");
-const cli_1 = require("../utils/cli");
-const config_store_1 = require("../utils/config-store");
-const styling_1 = require("../utils/styling");
+import { defineCommand } from 'citty';
+import { apiFlags } from '../config/flags/api.flags.js';
+import { resolveFrontendUrl } from '../config/environments.js';
+import { ApiGateway } from '../gateways/api-gateway.js';
+import { resolveAuth } from '../utils/auth.js';
+import { CliError, logger, parseIntFlag } from '../utils/cli.js';
+import { resolveApiUrl } from '../utils/config-store.js';
+import { colors, formatId, formatUrl } from '../utils/styling.js';
+import { ui } from '../utils/ui.js';
 function detectShellExpansion(name) {
     const indicators = [
         name.includes('/') || name.includes('\\'),
@@ -15,7 +14,7 @@ function detectShellExpansion(name) {
         name.includes(' ') && !name.includes('*') && !name.includes('?'),
     ];
     if (indicators.some(Boolean)) {
-        cli_1.logger.warn(`\nThe --name parameter appears to have been expanded by your shell: "${name}"\n` +
+        logger.warn(`\nThe --name parameter appears to have been expanded by your shell: "${name}"\n` +
             'Wildcards like * should be quoted to prevent shell expansion.\n' +
             'Examples:\n' +
             '  ✓ Correct:   dcd list --name "nightly-*"\n' +
@@ -23,18 +22,19 @@ function detectShellExpansion(name) {
             '  ✗ Incorrect: dcd list --name nightly-*\n');
     }
 }
-function displayResults(response) {
+function displayResults(response, apiUrl) {
     const { uploads, total, limit, offset } = response;
+    // Build console links from the env the CLI is pointed at, rather than the
+    // API-supplied consoleUrl (which is hardcoded to prod) — so dev/staging users
+    // get links that actually resolve.
+    const frontendUrl = resolveFrontendUrl(apiUrl);
     if (uploads.length === 0) {
-        cli_1.logger.log(`\n${styling_1.symbols.info} No uploads found matching your criteria.\n`);
+        logger.log(ui.info('No uploads found matching your criteria.'));
         return;
     }
-    cli_1.logger.log((0, styling_1.sectionHeader)('Recent Uploads'));
-    cli_1.logger.log(`   ${styling_1.colors.dim('Showing')} ${uploads.length} ${styling_1.colors.dim('of')} ${total} ${styling_1.colors.dim('uploads')}`);
-    if (offset > 0) {
-        cli_1.logger.log(`   ${styling_1.colors.dim('(offset:')} ${offset}${styling_1.colors.dim(')')}`);
-    }
-    cli_1.logger.log('');
+    const offsetNote = offset > 0 ? colors.dim(`, offset ${offset}`) : '';
+    logger.log(ui.section('Recent Uploads'));
+    logger.log(ui.note(`  showing ${uploads.length} of ${total}${offsetNote}`));
     for (const upload of uploads) {
         const date = new Date(upload.created_at);
         const formattedDate = date.toLocaleDateString('en-US', {
@@ -44,26 +44,29 @@ function displayResults(response) {
             month: 'short',
             year: 'numeric',
         });
-        const displayName = upload.name || styling_1.colors.dim('(unnamed)');
-        cli_1.logger.log(`   ${styling_1.colors.bold(displayName)}`);
-        cli_1.logger.log(`      ${styling_1.colors.dim('ID:')} ${(0, styling_1.formatId)(upload.id)}`);
-        cli_1.logger.log(`      ${styling_1.colors.dim('Created:')} ${formattedDate}`);
-        cli_1.logger.log(`      ${styling_1.colors.dim('Console:')} ${(0, styling_1.formatUrl)(upload.consoleUrl)}`);
-        cli_1.logger.log('');
+        const displayName = upload.name ? colors.bold(upload.name) : colors.dim('(unnamed)');
+        logger.log(ui.branch([
+            displayName,
+            ...ui.fields([
+                ['id', formatId(upload.id)],
+                ['created', formattedDate],
+                ['console', formatUrl(`${frontendUrl}/results?upload=${upload.id}`)],
+            ]),
+        ]));
     }
     if (total > offset + uploads.length) {
         const remaining = total - (offset + uploads.length);
-        cli_1.logger.log(`   ${styling_1.colors.dim('Use')} --offset ${offset + uploads.length} ${styling_1.colors.dim('to see the next')} ${Math.min(remaining, limit)} ${styling_1.colors.dim('uploads')}\n`);
+        logger.log(ui.note(`\nUse --offset ${offset + uploads.length} to see the next ${Math.min(remaining, limit)} uploads`));
     }
-    cli_1.logger.log(`   ${styling_1.symbols.info} ${styling_1.colors.dim('Use')} dcd status --upload-id <id> ${styling_1.colors.dim('for detailed test results')}\n`);
+    logger.log(ui.info(colors.dim('Use dcd status --upload-id <id> for detailed test results')));
 }
-exports.listCommand = (0, citty_1.defineCommand)({
+export const listCommand = defineCommand({
     meta: {
         name: 'list',
         description: 'List recent flow uploads for your organization',
     },
     args: {
-        ...api_flags_1.apiFlags,
+        ...apiFlags,
         from: {
             type: 'string',
             description: 'Filter uploads created on or after this date (ISO 8601 format, e.g., 2024-01-01)',
@@ -93,26 +96,26 @@ exports.listCommand = (0, citty_1.defineCommand)({
     },
     async run({ args }) {
         const apiKeyFlag = args['api-key'];
-        const apiUrl = (0, config_store_1.resolveApiUrl)(args['api-url']);
+        const apiUrl = resolveApiUrl(args['api-url']);
         const from = args.from;
         const to = args.to;
         const name = args.name;
         const json = Boolean(args.json);
-        const limit = (0, cli_1.parseIntFlag)(args.limit, 'limit') ?? 20;
-        const offset = (0, cli_1.parseIntFlag)(args.offset, 'offset') ?? 0;
+        const limit = parseIntFlag(args.limit, 'limit') ?? 20;
+        const offset = parseIntFlag(args.offset, 'offset') ?? 0;
         try {
-            const auth = await (0, auth_1.resolveAuth)({ apiKeyFlag });
+            const auth = await resolveAuth({ apiKeyFlag });
             if (from && Number.isNaN(Date.parse(from))) {
-                throw new cli_1.CliError('Invalid --from date format. Please use ISO 8601 format (e.g., 2024-01-01).');
+                throw new CliError('Invalid --from date format. Please use ISO 8601 format (e.g., 2024-01-01).');
             }
             if (to && Number.isNaN(Date.parse(to))) {
-                throw new cli_1.CliError('Invalid --to date format. Please use ISO 8601 format (e.g., 2024-01-31).');
+                throw new CliError('Invalid --to date format. Please use ISO 8601 format (e.g., 2024-01-31).');
             }
             if (name) {
                 detectShellExpansion(name);
             }
             try {
-                const response = (await api_gateway_1.ApiGateway.listUploads(apiUrl, auth, {
+                const response = (await ApiGateway.listUploads(apiUrl, auth, {
                     from,
                     limit,
                     name,
@@ -124,15 +127,15 @@ exports.listCommand = (0, citty_1.defineCommand)({
                     console.log(JSON.stringify(response, null, 2));
                     return;
                 }
-                displayResults(response);
+                displayResults(response, apiUrl);
             }
             catch (error) {
-                throw new cli_1.CliError(`Failed to list uploads: ${error.message}`);
+                throw new CliError(`Failed to list uploads: ${error.message}`);
             }
         }
         catch (error) {
-            cli_1.logger.error(error, { exit: 1, json });
+            logger.error(error, { exit: 1, json });
         }
     },
 });
-exports.default = exports.listCommand;
+export default listCommand;