para-cli 1.19.0 → 1.19.1

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)
@@ -83,6 +84,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 +99,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 +119,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;
@@ -516,6 +517,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 +722,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.19.1",
   "license": "Apache-2.0",
   "description": "Command-line tool for Para backend servers",
   "homepage": "https://paraio.org",
@@ -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",