para-cli 1.19.0 → 1.20.0

package/README.md

@@ -17,9 +17,9 @@ This is the command-line tool for interacting with a Para server.
 ## Installation
 
 ```sh
-$ npm install -g para-cli
-$ para-cli setup
-$ para-cli ping
+npm install -g para-cli
+para-cli setup
+para-cli ping
 ```
 
 ## Usage
@@ -41,6 +41,7 @@ $ para-cli ping
 	  setup                                  Initial setup, prompts you to enter your Para API keys and endpoint
 	  apps                                   Returns a list of all Para apps
 	  select <appid>                         Selects a Para app as a target for all subsequent read/write requests.
+	  endpoints [add|remove]                 List and select Para server endpoints, add new or remove an exiting one.
 	  create <file|glob> [--id] [--type]     Persists files as Para objects and makes them searchable
 	  read --id 123 [--id 345 ...]           Fetches objects with the given ids
 	  update <file.json|glob> ...            Updates Para objects with the data from a JSON file (must contain id field)
@@ -51,6 +52,7 @@ $ para-cli ping
 	  new-key                                Generates a new secret key and saves it to config.json
 	  new-jwt                                Generates a new JWT super token to be used for app authentication
 	  new-app <name> --name --shared         Creates a new Para app. Only works if you have the keys for the "root" app
+	  delete-app <id>                        Deletes an existing Para app. Only works for child apps, not the "root" app
 	  export                                 Exports all data from the app's table
 	  import <file>                          Imports data from a previously exported ZIP archive
 	  ping                                   Tests the connection to the Para server
@@ -83,6 +85,9 @@ $ para-cli ping
 	  $ para-cli search "*" --type article --page all
 	  $ para-cli new-key
 	  $ para-cli new-app "mynewapp" --name "Full app name"
+	  $ para-cli apps
+	  $ para-cli select scoold
+	  $ para-cli endpoints
 
 ```
 
@@ -95,7 +100,7 @@ The plan is to add more functionality in the near future.
 
 **Quick start:**
 ```
-$ para-cli setup
+para-cli setup
 ```
 
 The configuration file is located in `~/.config/para-cli-nodejs/config.json` and contains the keys used to authenticate
@@ -115,12 +120,32 @@ Here's an example `config.json` file:
 Once configured you can test your connection to the server:
 
 ```
-$ para-cli ping
+para-cli ping
 ```
 
 To get the currently authenticated app/user object run:
 ```
-$ para-cli me
+para-cli me
+```
+
+## Switching between apps and endpoints
+
+Para CLI can be configured to work with multiple Para servers and apps. Here's how to add additional Para server endpoints:
+```
+para-cli endpoints add
+```
+To select a specific endpoint run:
+```
+para-cli endpoints
+```
+
+After selecting the Para server you wish to connect to, you can list and select apps within it:
+```
+para-cli apps
+```
+Select the 'scoold' app, for example:
+```
+para-cli select scoold
 ```
 
 ## Para Docs

package/index.js

@@ -38,6 +38,7 @@ import { globbySync } from 'globby';
 import chalk from 'chalk';
 import { Promise } from 'rsvp';
 import apiClient from 'superagent';
+import { URL } from 'url';
 import { ParaClient, ParaObject, Pager } from 'para-client-js';
 
 const { cyan, red, yellow, green } = chalk;
@@ -302,6 +303,36 @@ export function newApp(pc, input, flags) {
 	});
 }
 
+export function deleteApp(pc, input, flags) {
+	if (!input[1]) {
+		fail('App id not specified.');
+		return;
+	}
+	var appid = input[1];
+	if (appid.indexOf('app:') < 0) {
+		appid = 'app:' + appid;
+	}
+	var rl = createInterface({
+		input: process.stdin,
+		output: process.stdout
+	});
+	rl.question(red.bold('Are you sure you want to delete ' + appid +
+			'? ALL DATA FOR THAT APP WILL BE LOST! ') + 'yes/No ', function (confirm) {
+		if (confirm === "yes") {
+			pc.invokeDelete('apps/' + appid, {}).then(function (resp) {
+				if (resp && resp.ok) {
+					console.log(green('✔'), 'App ' + red.bold(appid) + ' was deleted!');
+				} else {
+					console.log(green('✔'), yellow('App "' + appid + '" could not be deleted.'));
+				}
+			}).catch(function (err) {
+				fail('Failed to delete app:', err);
+			});
+		}
+		rl.close();
+	});
+}
+
 export function ping(pc, config) {
 	pc.me().then(function (mee) {
 		pc.getServerVersion().then(function (ver) {
@@ -516,6 +547,11 @@ export function addEndpoint(config) {
 		output: process.stdout
 	});
 	rl.question(cyan.bold('Para Endpoint: '), function (endpoint) {
+		if (!isValidUrl(endpoint)) {
+			fail('Endpoint must be a valid URL.');
+			rl.close();
+			return;
+		}
 		rl.question(cyan.bold('Para Secret Key (for root app app:para): '), function (secretKey) {
 			var pc = new ParaClient("app:para", secretKey, {endpoint: endpoint});
 			var endpoints = config.get('endpoints') || [];
@@ -716,6 +752,15 @@ function parseHTML(file) {
 	};
 }
 
+function isValidUrl(url) {
+	try {
+		new URL(url);
+		return true;
+	} catch (err) {
+		return false;
+	}
+}
+
 function readFile(filePath) {
 	return readFileSync(filePath, { encoding: 'utf8' });
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "para-cli",
-  "version": "1.19.0",
+  "version": "1.20.0",
   "license": "Apache-2.0",
   "description": "Command-line tool for Para backend servers",
   "homepage": "https://paraio.org",
@@ -24,7 +24,7 @@
     "api"
   ],
   "devDependencies": {
-    "eslint": "^8.28.0"
+    "eslint": "^8.29.0"
   },
   "repository": "Erudika/para-cli",
   "dependencies": {
@@ -39,7 +39,7 @@
     "jsonwebtoken": "^8.5.1",
     "meow": "^11.0.0",
     "mime-types": "^2.1.35",
-    "para-client-js": "^1.37.14",
+    "para-client-js": "^1.38.0",
     "resolve": "^1.22.1",
     "striptags": "^3.2.0",
     "update-notifier": "^6.0.2",

package/para-cli.js

@@ -29,7 +29,7 @@ import chalk from 'chalk';
 import meow from 'meow';
 import {
 	defaultConfig, setup, listApps, selectEndpoint, addEndpoint, removeEndpoint, selectApp, createAll, readAll,
-	updateAll, deleteAll, search, newKeys, newJWT, newApp, ping, me, appSettings, rebuildIndex, exportData, importData
+	updateAll, deleteAll, search, newKeys, newJWT, newApp, deleteApp, ping, me, appSettings, rebuildIndex, exportData, importData
 } from './index.js';
 
 const { red, green, blue } = chalk;
@@ -54,6 +54,7 @@ var cli = meow(`
 	  new-key                                Generates a new secret key and saves it to config.json
 	  new-jwt                                Generates a new JWT super token to be used for app authentication
 	  new-app <name> --name --shared         Creates a new Para app. Only works if you have the keys for the "root" app
+	  delete-app <id>                        Deletes an existing Para app. Only works for child apps, not the "root" app
 	  export                                 Exports all data from the app's table
 	  import <file>                          Imports data from a previously exported ZIP archive
 	  ping                                   Tests the connection to the Para server
@@ -184,6 +185,10 @@ if (!input[0]) {
 		newApp(pc, input, flags);
 	}
 
+	if (input[0] === 'delete-app') {
+		deleteApp(pc, input, flags);
+	}
+
 	if (input[0] === 'ping') {
 		ping(pc, config);
 	}