puter-cli 1.1.4 → 1.1.5

package/README.md

@@ -148,7 +148,7 @@ P.S. Please check the help command `help apps` for more details about any argume
 
 - **Create Application**: Create a new application.
 ```bash
-  puter app:create <name> [<remote_dir>] [--url=<url>]
+  puter app:create <name> [<directory>] [--description="My App Description"] [--url=<url>]
 ```
 P.S. By default a new `index.html` with basic content will be created, but you can set a directory when you create a new application as follows: `app:create nameOfApp ./appDir`, so all files will be copied to the `AppData` directoy, you can then update your app using `app:update <name> <remote_dir>`. This command will attempt to create a subdomain with a random `uid` prefixed with the name of the app.
 

package/bin/index.js

@@ -34,10 +34,32 @@ async function main() {
     .description('Start interactive shell')
     .action(startShell);
 
+
+  // App commands
+  program
+    .command('app:create <name>')
+    .description('Create a new Puter application')
+    .argument('<name>', 'Name of the application')
+    .argument('[directory]', 'Local directory path')
+    .option('-d, --description <description>', 'Application description')
+    .option('-u, --url <url>', 'Application URL', 'https://dev-center.puter.com/coming-soon.html')
+    .action(async (name, directory, options) => {
+      try {
+        await createApp({
+          name,
+          directory: directory || '',
+          description: options.description || '',
+          url: options.url
+        });
+      } catch (error) {
+        console.error(chalk.red(error.message));
+      }
+    });
+
   if (process.argv.length === 2) {
     startShell();
   } else {
-    program.parse();
+    program.parse(process.argv);
   }
 }
 

package/commands/apps.js

@@ -126,25 +126,28 @@ export async function appInfo(args = []) {
 /**
  * Create a new web application
  * @param {string} name The name of the App
+ * @param {string} directory Optional directory path
  * @param {string} description A description of the App
  * @param {string} url A default coming-soon URL
- * @returns Output JSON data
+ * @returns {Promise<Object>} Output JSON data
  */
-export async function createApp(args = []) {
-    if (args.length < 1 || !isValidAppName(args[0])) {
-        console.log(chalk.red('Usage: app:create <valid_name_app> [<remote_dir>] [--url=<url>]'));
-        console.log(chalk.yellow('Example: app:create myapp'));
-        console.log(chalk.yellow('Example: app:create myapp ./myapp'));
-        return;
+export async function createApp(args) {
+    const name = args.name; // App name (required)
+    console.log(args);
+    if (!isValidAppName(name)) {
+        throw new Error('Invalid application name');
     }
-    const name = args[0]; // App name (required)
     // Use the default home page if the root directory if none specified
-    const localDir = (args[1] && !args[1].startsWith('--'))? resolvePath(getCurrentDirectory(), args[1]):'';
-    // Optional description (disabled at the moment)
-    const description = ''; // (args.find(arg => arg.toLocaleLowerCase().startsWith('--description='))?.split('=')[1]) || '';
-    const url = (args.find(arg => arg.toLocaleLowerCase().startsWith('--url='))?.split('=')[1]) || 'https://dev-center.puter.com/coming-soon.html'; // Optional url
+    const localDir = args.directory ? resolvePath(getCurrentDirectory(), args.directory) : '';
+    // Optional description
+    const description = args.description || '';
+    const url = args.url || '';
+
+    console.log(chalk.green(`Creating app "${name}"...`));
+    console.log(chalk.dim(`Directory: ${localDir || '[default]'}`));
+    console.log(chalk.dim(`Description: ${description}`));
+    console.log(chalk.dim(`URL: ${url}`));
 
-    console.log(chalk.dim(`Creating app: ${chalk.green(name)}...\n`));
     try {
         // Step 1: Create the app
         const createAppResponse = await fetch(`${API_BASE}/drivers/call`, {

package/commands/executor.js

@@ -1,5 +1,4 @@
 import chalk from 'chalk';
-import ora from 'ora';
 import Conf from 'conf';
 import { listApps, appInfo, createApp, updateApp, deleteApp } from './apps.js';
 import { listSites, createSite, deleteSite, infoSite } from './sites.js';
@@ -11,6 +10,7 @@ import { getUserInfo, getUsageInfo } from './auth.js';
 import { PROJECT_NAME, API_BASE, getHeaders } from './commons.js';
 import inquirer from 'inquirer';
 import { exec } from 'node:child_process';
+import { parseArgs } from './utils.js';
 
 const config = new Conf({ projectName: PROJECT_NAME });
 
@@ -37,12 +37,28 @@ const commands = {
     });
   },
   app: appInfo,
-  'app:create': async (args) => {
-    if (args.length < 1) {
-        console.log(chalk.red('Usage: app:create <name> [<remote_dir>] [--description=<description>] [--url=<url>]'));
+  'app:create': async (rawArgs) => {
+    try {
+      const args = parseArgs(rawArgs.join(' '));
+      // Consider using explicit argument definition if necessary
+      // const args = parseArgs(rawArgs.join(' '), {string: ['description', 'url'],
+      //   alias: { d: 'description', u: 'url', },
+      // });
+
+      if (!args.length < 1) {
+        console.log(chalk.red('Usage: app:create <name> [directory] [--description="My App Description"] [--url=app-url]'));
         return;
+      }
+
+      await createApp({
+        name: args._[0],
+        directory: args._[1] || '',
+        description: args.description || '',
+        url: args.url || 'https://dev-center.puter.com/coming-soon.html'
+      });
+    } catch (error) {
+      console.error(chalk.red(error.message));
     }
-    await createApp(args);
   },
   'app:update': async (args) => {
     if (args.length < 1) {
@@ -51,13 +67,20 @@ const commands = {
     }
     await updateApp(args);
   },
-  'app:delete': async (args) => {
+  'app:delete': async (rawArgs) => {
+    const args = parseArgs(rawArgs.join(' '), {
+      string: ['_'],
+      boolean: ['f'],
+      configuration: {
+        'populate--': true
+      }
+    });
     if (args.length < 1) {
         console.log(chalk.red('Usage: app:delete <name>'));
         return;
     }
-    const name = args.find(arg => arg !=='-f')
-    const force = args.some(arg => arg =='-f')? true: false;
+    const name = args._[0];
+    const force = !!args.f;
 
     if (!force){
       const { confirm } = await inquirer.prompt([
@@ -144,6 +167,7 @@ export async function execCommand(input) {
  * @param {string} [command] - The command to display help for.
  */
 function showHelp(command) {
+  // Consider using `program.helpInformation()` function for global "help" command...
   const commandHelp = {
     help: `
       ${chalk.cyan('help [command]')}
@@ -187,9 +211,9 @@ function showHelp(command) {
       Example: app myapp
     `,
     'app:create': `
-      ${chalk.cyan('app:create <name> [<remote_dir>] [--url=<url>]')}
+      ${chalk.cyan('app:create <name> [<remote_dir>] [--description="<description>"] [--url=<url>]')}
       Create a new app.
-      Example: app:create myapp https://example.com
+      Example: app:create myapp https://myapp.puter.site
     `,
     'app:update': `
       ${chalk.cyan('app:update <name> [dir]')}

package/commands/utils.js

@@ -1,4 +1,5 @@
 import chalk from 'chalk';
+import yargsParser from 'yargs-parser';
 
 /**
  * Convert "2024-10-07T15:03:53.000Z" to "10/7/2024, 15:03:53"
@@ -89,4 +90,14 @@ export function displayNonNullValues(data) {
     });
     console.log(chalk.cyan('-'.repeat(maxKeyLength*3)));
     console.log(chalk.cyan(`You have ${chalk.green(tableData.length)} key/value pair(s).`));
-  }
+  }
+
+  /**
+ * Parse command line arguments including quoted strings
+ * @param {string} input Raw command line input
+ * @returns {Object} Parsed arguments
+ */
+export function parseArgs(input, options = {}) {
+  const result = yargsParser(input, options);
+  return result;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "puter-cli",
-  "version": "1.1.4",
+  "version": "1.1.5",
   "description": "Command line interface for Puter cloud platform",
   "main": "index.js",
   "bin": {
@@ -26,7 +26,7 @@
   "dependencies": {
     "chalk": "^5.3.0",
     "cli-table3": "^0.6.5",
-    "commander": "^11.1.0",
+    "commander": "^13.0.0",
     "conf": "^12.0.0",
     "cross-spawn": "^7.0.3",
     "glob": "^11.0.0",
@@ -34,7 +34,8 @@
     "minimatch": "^10.0.1",
     "node-fetch": "^3.3.2",
     "ora": "^8.0.1",
-    "uuid": "^11.0.5"
+    "uuid": "^11.0.5",
+    "yargs-parser": "^21.1.1"
   },
   "devDependencies": {
     "vitest": "^2.1.8"