@devicecloud.dev/dcd 4.4.9 → 5.0.0-beta.1

package/dist/commands/list.d.ts

@@ -1,38 +1,39 @@
-import { Command } from '@oclif/core';
-type UploadListItem = {
-    consoleUrl: string;
-    created_at: string;
-    id: string;
-    name: null | string;
-};
-type ListResponse = {
-    limit: number;
-    offset: number;
-    total: number;
-    uploads: UploadListItem[];
-};
-export default class List extends Command {
-    static description: string;
-    static enableJsonFlag: boolean;
-    static examples: string[];
-    static flags: {
-        apiKey: import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
-        apiUrl: import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
-        from: import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
-        json: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
-        limit: import("@oclif/core/lib/interfaces").OptionFlag<number, import("@oclif/core/lib/interfaces").CustomOptions>;
-        name: import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
-        offset: import("@oclif/core/lib/interfaces").OptionFlag<number, import("@oclif/core/lib/interfaces").CustomOptions>;
-        to: import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
-    };
-    run(): Promise<ListResponse | void>;
-    /**
-     * Detects if the provided name parameter likely underwent shell expansion
-     * Warns the user if shell expansion is detected
-     * @param name - The name parameter to check for shell expansion
-     * @returns void
-     */
-    private detectShellExpansion;
-    private displayResults;
-}
-export {};
+export declare const listCommand: import("citty").CommandDef<{
+    readonly from: {
+        readonly type: "string";
+        readonly description: "Filter uploads created on or after this date (ISO 8601 format, e.g., 2024-01-01)";
+    };
+    readonly json: {
+        readonly type: "boolean";
+        readonly description: "Output in JSON format";
+    };
+    readonly limit: {
+        readonly type: "string";
+        readonly default: "20";
+        readonly description: "Maximum number of uploads to return";
+    };
+    readonly name: {
+        readonly type: "string";
+        readonly description: "Filter by upload name (supports * wildcard, e.g., \"nightly-*\"). IMPORTANT: Always quote wildcards to prevent shell expansion!";
+    };
+    readonly offset: {
+        readonly type: "string";
+        readonly default: "0";
+        readonly description: "Number of uploads to skip (for pagination)";
+    };
+    readonly to: {
+        readonly type: "string";
+        readonly description: "Filter uploads created on or before this date (ISO 8601 format, e.g., 2024-01-31)";
+    };
+    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.";
+    };
+    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)";
+    };
+}>;
+export default listCommand;

package/dist/commands/list.js

@@ -1,143 +1,136 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-const core_1 = require("@oclif/core");
-const constants_1 = require("../constants");
-const api_gateway_1 = require("../gateways/api-gateway");
-const styling_1 = require("../utils/styling");
-class List extends core_1.Command {
-    static description = 'List recent flow uploads for your organization';
-    static enableJsonFlag = true;
-    static examples = [
-        '<%= config.bin %> <%= command.id %>',
-        '<%= config.bin %> <%= command.id %> --limit 10',
-        '<%= config.bin %> <%= command.id %> --name "nightly-*"  # Quote wildcards to prevent shell expansion!',
-        '<%= config.bin %> <%= command.id %> --from 2024-01-01 --to 2024-01-31',
-        '<%= config.bin %> <%= command.id %> --json',
+import { defineCommand } from 'citty';
+import { apiFlags } from '../config/flags/api.flags.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('\\'),
+        /\.(yaml|yml|json|txt|md|ts|js|py|sh)$/i.test(name),
+        name.includes(' ') && !name.includes('*') && !name.includes('?'),
     ];
-    static flags = {
-        apiKey: constants_1.flags.apiKey,
-        apiUrl: constants_1.flags.apiUrl,
-        from: core_1.Flags.string({
+    if (indicators.some(Boolean)) {
+        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' +
+            "  ✓ Correct:   dcd list --name 'nightly-*'\n" +
+            '  ✗ Incorrect: dcd list --name nightly-*\n');
+    }
+}
+function displayResults(response) {
+    const { uploads, total, limit, offset } = response;
+    if (uploads.length === 0) {
+        logger.log(ui.info('No uploads found matching your criteria.'));
+        return;
+    }
+    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', {
+            day: 'numeric',
+            hour: '2-digit',
+            minute: '2-digit',
+            month: 'short',
+            year: 'numeric',
+        });
+        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(upload.consoleUrl)],
+            ]),
+        ]));
+    }
+    if (total > offset + uploads.length) {
+        const remaining = total - (offset + uploads.length);
+        logger.log(ui.note(`\nUse --offset ${offset + uploads.length} to see the next ${Math.min(remaining, limit)} uploads`));
+    }
+    logger.log(ui.info(colors.dim('Use dcd status --upload-id <id> for detailed test results')));
+}
+export const listCommand = defineCommand({
+    meta: {
+        name: 'list',
+        description: 'List recent flow uploads for your organization',
+    },
+    args: {
+        ...apiFlags,
+        from: {
+            type: 'string',
             description: 'Filter uploads created on or after this date (ISO 8601 format, e.g., 2024-01-01)',
-        }),
-        json: core_1.Flags.boolean({
+        },
+        json: {
+            type: 'boolean',
             description: 'Output in JSON format',
-        }),
-        limit: core_1.Flags.integer({
-            default: 20,
+        },
+        limit: {
+            type: 'string',
+            default: '20',
             description: 'Maximum number of uploads to return',
-        }),
-        name: core_1.Flags.string({
+        },
+        name: {
+            type: 'string',
             description: 'Filter by upload name (supports * wildcard, e.g., "nightly-*"). IMPORTANT: Always quote wildcards to prevent shell expansion!',
-        }),
-        offset: core_1.Flags.integer({
-            default: 0,
+        },
+        offset: {
+            type: 'string',
+            default: '0',
             description: 'Number of uploads to skip (for pagination)',
-        }),
-        to: core_1.Flags.string({
+        },
+        to: {
+            type: 'string',
             description: 'Filter uploads created on or before this date (ISO 8601 format, e.g., 2024-01-31)',
-        }),
-    };
-    async run() {
-        const { flags } = await this.parse(List);
-        const { apiKey: apiKeyFlag, apiUrl, from, json, limit, name, offset, to, } = flags;
-        const apiKey = apiKeyFlag || process.env.DEVICE_CLOUD_API_KEY;
-        if (!apiKey) {
-            this.error('API key is required. Please provide it via --api-key flag or DEVICE_CLOUD_API_KEY environment variable.');
-            return;
-        }
-        // Validate date formats if provided
-        if (from && Number.isNaN(Date.parse(from))) {
-            this.error('Invalid --from date format. Please use ISO 8601 format (e.g., 2024-01-01).');
-            return;
-        }
-        if (to && Number.isNaN(Date.parse(to))) {
-            this.error('Invalid --to date format. Please use ISO 8601 format (e.g., 2024-01-31).');
-            return;
-        }
-        // Detect potential shell expansion of wildcards
-        if (name) {
-            this.detectShellExpansion(name);
-        }
+        },
+    },
+    async run({ args }) {
+        const apiKeyFlag = args['api-key'];
+        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 = parseIntFlag(args.limit, 'limit') ?? 20;
+        const offset = parseIntFlag(args.offset, 'offset') ?? 0;
         try {
-            const response = await api_gateway_1.ApiGateway.listUploads(apiUrl, apiKey, {
-                from,
-                limit,
-                name,
-                offset,
-                to,
-            });
-            if (json) {
-                return response;
+            const auth = await resolveAuth({ apiKeyFlag });
+            if (from && Number.isNaN(Date.parse(from))) {
+                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 CliError('Invalid --to date format. Please use ISO 8601 format (e.g., 2024-01-31).');
+            }
+            if (name) {
+                detectShellExpansion(name);
+            }
+            try {
+                const response = (await ApiGateway.listUploads(apiUrl, auth, {
+                    from,
+                    limit,
+                    name,
+                    offset,
+                    to,
+                }));
+                if (json) {
+                    // eslint-disable-next-line no-console
+                    console.log(JSON.stringify(response, null, 2));
+                    return;
+                }
+                displayResults(response);
+            }
+            catch (error) {
+                throw new CliError(`Failed to list uploads: ${error.message}`);
             }
-            this.displayResults(response);
         }
         catch (error) {
-            this.error(`Failed to list uploads: ${error.message}`);
-        }
-    }
-    /**
-     * Detects if the provided name parameter likely underwent shell expansion
-     * Warns the user if shell expansion is detected
-     * @param name - The name parameter to check for shell expansion
-     * @returns void
-     */
-    detectShellExpansion(name) {
-        const shellExpansionIndicators = [
-            // Contains file path separators (likely expanded to file paths)
-            name.includes('/') || name.includes('\\'),
-            // Contains file extensions (likely expanded to filenames)
-            /\.(yaml|yml|json|txt|md|ts|js|py|sh)$/i.test(name),
-            // Looks like multiple space-separated filenames (shell expanded glob to multiple files)
-            name.includes(' ') && !name.includes('*') && !name.includes('?'),
-        ];
-        if (shellExpansionIndicators.some(Boolean)) {
-            this.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' +
-                '  ✓ Correct:   dcd list --name \'nightly-*\'\n' +
-                '  ✗ Incorrect: dcd list --name nightly-*\n');
-        }
-    }
-    displayResults(response) {
-        const { uploads, total, limit, offset } = response;
-        if (uploads.length === 0) {
-            this.log('\nNo uploads found matching your criteria.\n');
-            return;
+            logger.error(error, { exit: 1, json });
         }
-        this.log((0, styling_1.sectionHeader)('Recent Uploads'));
-        this.log(`   ${styling_1.colors.dim('Showing')} ${uploads.length} ${styling_1.colors.dim('of')} ${total} ${styling_1.colors.dim('uploads')}`);
-        if (offset > 0) {
-            this.log(`   ${styling_1.colors.dim('(offset:')} ${offset}${styling_1.colors.dim(')')}`);
-        }
-        this.log('');
-        for (const upload of uploads) {
-            const date = new Date(upload.created_at);
-            const formattedDate = date.toLocaleDateString('en-US', {
-                day: 'numeric',
-                hour: '2-digit',
-                minute: '2-digit',
-                month: 'short',
-                year: 'numeric',
-            });
-            // Upload name
-            const displayName = upload.name || styling_1.colors.dim('(unnamed)');
-            this.log(`   ${styling_1.colors.bold(displayName)}`);
-            // Upload ID and date
-            this.log(`      ${styling_1.colors.dim('ID:')} ${(0, styling_1.formatId)(upload.id)}`);
-            this.log(`      ${styling_1.colors.dim('Created:')} ${formattedDate}`);
-            // Console URL
-            this.log(`      ${styling_1.colors.dim('Console:')} ${(0, styling_1.formatUrl)(upload.consoleUrl)}`);
-            this.log('');
-        }
-        // Pagination hint
-        if (total > offset + uploads.length) {
-            const remaining = total - (offset + uploads.length);
-            this.log(`   ${styling_1.colors.dim('Use')} --offset ${offset + limit} ${styling_1.colors.dim('to see the next')} ${Math.min(remaining, limit)} ${styling_1.colors.dim('uploads')}\n`);
-        }
-        // Hint about getting detailed status
-        this.log(`   ${styling_1.colors.dim('Tip: Use')} dcd status --upload-id <id> ${styling_1.colors.dim('for detailed test results')}\n`);
-    }
-}
-exports.default = List;
+    },
+});
+export default listCommand;

package/dist/commands/live.d.ts

@@ -0,0 +1,2 @@
+export declare const liveCommand: import("citty").CommandDef<import("citty").ArgsDef>;
+export default liveCommand;