libves 1.9.9 → 2.0.0

package/README.md

@@ -1,15 +1,34 @@
 ## libVES
-A JavaScript interface to VESvault REST API (beta).
-libVES user WebCrypto end-to-end encryption.
+
+
+Simple, safe and secure e2e encryption for data at-rest.
+
 
 https://VESvault.com
 https://VES.host
 
-- Deposit and retrieve encrypted items into VESvault repository using end-to-end encryption
-- Manage asymmetric encryption keys in the VESvault repository using end-to-end encryption
-- [VESrecovery](https://www.vesvault.com/#vault)™ operations: set VESrecovery friends, assist in VESrecovery
 
-Run Makefile.pl to generate a consolidated js file, and a minified version of it.
+; Instantiate libVES
+var VES = new libVES({domain: 'x-myapp'});
+
+; Authorize with VES in the same browser window
+VES.flow(true).then(....)
+
+; Or, authorize in a popup window
+VES.delegate().then(....)
+
+; Store an e2e encrypted value
+VES.putValue('item-id', 'value')
+
+; Store a value and e2e share with other VES accounts
+VES.putValue('item-id', 'value', [{externalId: 'me@acme.com'}, {externalId: 'user1@acme.com'}, {externalId: 'user2@acme.com'}])
+
+; Retrieve a previously stored value
+VES.getValue('item-id').then(function(value) { .... })
+
+
+See https://demo.ves.world
+
 
-API Documentation:
+Full API Docs:
 https://ves.host/docs/libVES

package/libVES.node.js

@@ -14,7 +14,7 @@
  *         \___/              - VESrecovery (TM)
  *
  *
- * (c) 2017 - 2020 VESvault Corp
+ * (c) 2017 - 2022 VESvault Corp
  * Jim Zubov <jz@vesvault.com>
  *
  * GNU General Public License v3
@@ -27,7 +27,7 @@
  *
  * @title libVES
  * @dev A JavaScript end-to-end encryption interface to VESvault REST API
- * @version 1.99
+ * @version 2.00
  *
  * @dev Official source code: https://github.com/vesvault/libVES
  *
@@ -349,7 +349,9 @@ libVES.prototype = {
 			});
 		    },
 		    vaultRefToUser: function(ext) {
-			return new libVES.User({email: ext.externalId}, self);
+			var email = ext.externalId ? ext.externalId.replace(/\!.*/, '') : '';
+			if (!email.match(/\@/)) throw {code: 'NotFound', message: 'externalId is not an email for non-existing vault'};
+			return new libVES.User({email: email}, self);
 		    }
 		};
 	    });
@@ -361,7 +363,7 @@ libVES.prototype = {
 		return self.prepareExternals([ex]);
 	    });
 	}).catch(function(e) {
-	    throw new libVES.Error('NotFound','Cannot match externalId for domain:' + ext.domain + ', user:' + user + '. Define libVES.Domain.' + ext.domain + '.userToVaultRef(user) to return a valid reference.',{error: e});
+	    throw new libVES.Error('NotFound', 'Cannot match externalId for domain:' + ext.domain + ', user:' + user + '. Define libVES.Domain.' + ext.domain + '.userToVaultRef(user) to return a valid reference.',{error: e});
 	})).then(function(exts) {
 	    var vkey = new libVES.VaultKey({externals: exts, creator: self.me()},self);
 	    return vkey.getId().then(function() {
@@ -371,7 +373,7 @@ libVES.prototype = {
 		return Promise.resolve(user || m().then(function(dom) {
 		    return dom.vaultRefToUser(exts[0]);
 		})).catch(function(e) {
-		    throw new libVES.Error('NotFound','No matching secondary key (domain:' + ext.domain + ', externalId:' + ext.externalId + '). Supply "user" to create the temp key, or define libVES.Domain.' + ext.domain + '.vaultRefToUser(vaultRef) to return matching libVES.User',{error: e});
+		    throw new libVES.Error('NotFound', 'No matching secondary vault key',{error: e});
 		}).then(function(u) {
 		    return self.me().then(function(me) {
 			return Promise.all([me.getId(),u.getId()]).then(function(ids) {
@@ -551,6 +553,23 @@ libVES.prototype = {
 	    });
 	});
     },
+    setAnonymousKey: function(veskey, optns) {
+	var self = this;
+	return this.prepareExternals({externalId: self.externalId}).then(function(ext) {
+	    if (!veskey) throw new libVES.Error('InvalidValue','VESkey cannot be empty');
+	    return (new libVES.VaultKey({type: 'secondary', algo: (optns && optns.algo ? optns.algo : self.keyAlgo), externals: ext},self)).generate(veskey, optns).then(function(k) {
+		return k.post(undefined, ['encSessionToken'], optns).then(function(post) {
+		    return k.setField('id', post.id, false).then(function() {
+			k.fieldUpdate = {id: true};
+		    });
+		}).catch(function(e) {
+		    if (!e || e.code != 'Unauthorized') throw e;
+		}).then(function() {
+		    return self.unlock(veskey);
+		});
+	    });
+	});
+    },
     setShadow: function(usrs,optns) {
 	var self = this;
 	if (!(usrs instanceof Array)) return Promise.reject(new libVES.Error('InvalidValue', 'usrs must be an array'));
@@ -2084,7 +2103,7 @@ libVES.VaultItem.prototype = new libVES.Object({
     apiUri: 'vaultItems',
     fieldList: {id: true},
     fieldClass: {vaultKey: libVES.VaultKey, file: libVES.File},
-    fieldSets: [{type: true, meta: true},{vaultEntries: {id: true, encData: true, vaultKey: {id: true, type: true, user: {id: true}, algo: true}}},{vaultKey: true, file: true}],
+    fieldSets: [{type: true, meta: true},{vaultEntries: {id: true, encData: true, vaultKey: {id: true, type: true, user: {id: true}, algo: true, externals: {id: true}}}},{vaultKey: true, file: true}],
     defaultCipher: 'AES256GCM',
     getRaw: function() {
 	var self = this;
@@ -3222,13 +3241,13 @@ libVES.Delegate = {
 	return this.popupWindow = window.open(url,this.name,"width=600,height=600,top=100,left=100");
     },
     retryPopup: function(url,href) {
-	var f = this.retryPopupCalled;
 	this.retryPopupCalled++;
-	if (href && f > 1) href.target = '_blank';
-	else if (this.popupWindow) try {
+	if (this.popupWindow) try {
 	    this.popupWindow.focus();
+	    return true;
 	} catch(e) {}
-	return !f && this.openPopup(url);
+	this.openPopup(url);
+	return true;
     },
     listener: function(evnt) {
 	if (this.popup && evnt.origin == this.matchOrigin) try {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "libves",
-  "version": "1.9.9",
+  "version": "2.0.0",
   "description": "VESvault end-to-end encryption API",
   "main": "libVES.node.js",
   "scripts": {
@@ -13,7 +13,10 @@
   "keywords": [
     "encryption",
     "VESvault",
-    "VES"
+    "VES",
+    "e2e",
+    "at-rest",
+    "end-to-end"
   ],
   "author": "jz@vesvault.com",
   "license": "GPL-3.0",