feat: getByIdOrSearch

Allows to search a cipher by its id.
If the id is null or the cipher doesn't exist, then search an
existing cipher by other criterias, and get the first one
found based on a specific order

src/WebVaultClient.js

@@ -1,6 +1,8 @@
 import MicroEE from 'microee'
 
 import eq from 'lodash/eq'
+import get from 'lodash/get'
+import orderBy from 'lodash/orderBy'
 
 import { Utils } from './@bitwarden/jslib/misc/utils'
 
@@ -392,6 +394,32 @@ class WebVaultClient {
     })
   }
 
+  /**
+   * Search a cipher, first by id
+   * otherwise by a search forwarded to `getAllDecryptedFor`
+   * and get the first one in the order asked
+   * @param {integer} id - uuid of a cipher
+   * @param {object} search - as described in `getAllDecryptedFor`
+   * @param {Array|function|string} sort - given to lodash.sortBy 
+   * @return {Cipher} encrypted cipher
+   */
+  async getByIdOrSearch(id, search, sort) {
+    if (id) {
+      const cipher = await this.get(id)
+      if (cipher) return cipher
+    }
+    if (search) {
+      const all = await this.getAllDecryptedFor(search)
+      const first = orderBy(all, sort)[0]
+      const id = get(first, 'id')
+      if (id) {
+        const searchedCipher = await this.get(id)
+        if (searchedCipher) return searchedCipher
+      }
+    }
+    return null
+  }
+
   /**
    * @private
    * test if two parameters match