@adobe/acc-js-sdk 1.1.3 → 1.1.6

package/.eslintrc.js

@@ -4,7 +4,8 @@ module.exports = {
         "commonjs": true,
         "es2021": true,
         "node": true,
-        "jest": true
+        "jest": true,
+        circus: true
     },
     "extends": "eslint:recommended",
     "parserOptions": {

package/CHANGELOG.md

@@ -5,6 +5,25 @@ This is a node.js SDK for Campaign API. It exposes the Campaign API exactly like
 
 # Changelog 
 
+## Version 1.1.6
+_2022_08_19_
+
+* New auto-refresh mechanism to keep schemas and option caches up-to-date. See `client.startRefreshCaches` and `client.stopRefreshCaches` functions.
+
+## Version 1.1.5
+_2022/07/07__
+
+* The SOAP method name was not showing up properly in the Chrome console
+
+## Version 1.1.4
+_2022/07/07__
+
+* Added `application.version` which returns the server version in the format major.minor.servicePack (ex: 8.2.10)
+* Added the ability to push down parameters to the SOAP and transport layers. See the pushDown section of the readme file.
+* The pushDown mechanism can be used to simply overwrite the request timeout, either globally or at the method level
+* Publicly export the HttpError class so that custom transports can be written more safely. A failure during transport should return an HttpError object
+* By default, the SOAP method name is now added in the URLs for better troubleshooting
+
 ## Version 1.1.3
 _2022/05/30_
 
@@ -15,6 +34,10 @@ _2022/05/30_
 * Document how to set the password of an external account
 * By default, SDK will send additional HTTP headers to help troubleshooting and usage tracking
 * Add the ability to pass extra HTTP headers to API calls, either globally (to all HTTP headers), or locally, i.e. for a specific method
+* Remove .vscode folder from the sources
+* Example for xtkBuilder.installPackage API
+* For APIs which have parameters of type DOMElement and which are called using XML, support passing either a DOMElement or a DOMDocument
+
 
 ## Version 1.1.2
 _2022/03/22_

package/README.md

@@ -133,6 +133,8 @@ charset|UTF-8|The charset encoding used for http requests. In version 1.1.1 and
 extraHttpHeaders|[string]:string|An optional dictionary (key/value pairs) of extra HTTP headers to pass to all API calls.
 clientApp|string|An optional string describing the name and version of the SDK client application. It will be passed to the server in the ACC-SDK-Client-App HTTP header
 noSDKHeaders|boolean|Can be set to disable passing ACC-SDK-* HTTP headers to the server
+noMethodInURL|boolean|Can be set to true to remove the method name from the URL
+timeout|number|Can be used to set the APIs call timeout (in ms)
 ```js
 const connectionParameters = sdk.ConnectionParameters.ofUserAndPassword(
                                     "https://myInstance.campaign.adobe.com", 
@@ -189,8 +191,8 @@ If you want to use the SDK client-side in a web page returned by Campaign, you c
 For this scenario, the `ofSecurityToken` function can be used. Pass it a security token (usually available as document.__securitytoken), and the SDK will let the browser handle the session token (cookie) for you.
 
 ```html
-    <script src="acc-sdk.js"></script>
-    <script>
+<script src="acc-sdk.js"></script>
+<script>
         (async () => {
             try {
                 const sdk = document.accSDK;
@@ -204,8 +206,8 @@ For this scenario, the `ofSecurityToken` function can be used. Pass it a securit
                 console.error(ex);
             }
         })();
-    </script>
-    </body>
+</script>
+</body>
 </html>
 ```
 
@@ -320,7 +322,8 @@ The Simple JSON format works like this:
 
 The XML root element tag is determined by the SDK as it's generating the XML, usually from the current schema name.
 
-* XML: `<root/>`
+* XML: `<root/>
+`
 * JSON: `{}`
 
 XML attributes are mapped to JSON attributes with the same name, whose litteral value can be a string, number, or boolean. There's no "@" sign in the JSON attribute name.
@@ -357,7 +360,9 @@ Text of a child element
 * Alternative JSON: `{ item: { $: "Hello" } }`
 
 If an element contains both text, and children, you need to use the alternative `$` syntax
-* XML: `<root><item>Hello<child id="1"/></item></root>`
+* XML: `<root><item>Hello<child id="1"/>
+</item>
+</root>`
 * JSON: `{ item: { $: "Hello", child: { id:1 } }`
 
 
@@ -510,8 +515,8 @@ const DomUtil = client.DomUtil;
 Create DOM from XML string:
 ```js
 const doc = DomUtil.parse(`<root>
-      <one/>
-    </root>`);
+<one/>
+</root>`);
 ```
 
 Writes a DOM document or element as a string:
@@ -582,12 +587,12 @@ const json = DomUtil.toJSON(documentOrElement, "BadgerFish");
 Many Campaign APIs take arguments which are DOM documents or DOM elements. For example, the nms:delivery#DeployTriggerMessages first argument is a DOMElement which is supposed to be a `<where>` clause used as a condition to select Message Center deliveries to publish.
 
 ```xml
-    <method name="DeployTriggerMessages" static="true">
-      <parameters>
-        <param inout="in" name="deliveries" type="DOMElement"/>
-        <param inout="in" name="localPublish" type="boolean"/>
-      </parameters>
-    </method>
+<method name="DeployTriggerMessages" static="true">
+<parameters>
+<param inout="in" name="deliveries" type="DOMElement"/>
+<param inout="in" name="localPublish" type="boolean"/>
+</parameters>
+</method>
 ```
 
 For example, one would want to use the following condition to republish a particular delivery
@@ -603,7 +608,7 @@ For example, one would want to use the following condition to republish a partic
 The JSON object corresponds to the following XML
 ```xml
 <where>
-    <condition expr="@internalName='DM23'"/>
+<condition expr="@internalName='DM23'"/>
 </where>
 ```
 
@@ -688,6 +693,30 @@ It's possible to disable persistent caches using the `noStorage` connection opti
 It is also possible to setup one's own persistent cache, by passing a `storage` object as a connection option. This object should implement 3 methods: `getItem`, `setItem`, and `removeItem` (synchronous)
 
 
+## Auto-refresh caches
+
+The SDK includes a mechnism to maintain the schemas and options caches up-to-date by polling the Campaign server on a regular basis (10 seconds by default). The server returns the list of entities (schemas or options) which have changed since they were cached, and the client removes them from the cache. When a schema changes, the corresponding methods are also removed from the method cache.
+
+This mechanism is not activate by default but can be activated or deactivated by the following functions
+
+```js
+client.startRefreshCaches(30000);   // activate cache auto-refresh mechanism every 30s
+client.stopRefreshCaches();         // de-activate cache auto-refresh
+```
+
+This mechanism is based on the `xtk:session#GetModifiedEntities` SOAP method which is only available in Campaign 8.4 and above only. For other builds of Campaign, the auto-refresh mechanism will not do anything. 
+
+The following changes are handled:
+* If the build number has changed, the whole cache is cleared
+* If more than 10 schemas or options have changed, the whole cache is cleared
+* if less than 10 schemas or options have changed, only those entities are removed from the cache
+
+
+The refresh mechanism includes the following guardrails
+* Both xtk:option and xtk:schema caches are refreshed every n seconds. To avoid issuing two API calls at the same time to the server, the schema cache refresh call is delayed by a few seconds. In the future this delay may change.
+* If the xtk:session#GetModifiedEntities API is not available, the auto refresh mechanism will silently stop automatically
+* If an error occurs while trying to refresh, a warning will be logged to the JavaScript console but the auto refresh will not be stopped. 
+
 ## Passwords
 
 External account passwords can be decrypted using a Cipher. This function is deprecated since version 1.0.0 since it's not guaranteed to work in future versions of Campaign (V8 and above)
@@ -757,6 +786,49 @@ const query = client.NLWS
 await query.executeQuery();
 ```
 
+## Timeouts
+
+By default, the SDK has a timeout of 5s when running in a node.js environment, and uses the browser defaults when run inside a browser (using the fetch API).
+
+It is possible to overwrite the transport layer (see `The Transport Protocol` and use your own code to make and configure HTTP requests) to tune the timeout value. It is a bit cumbersome though.
+
+Instead, you can use the `timeout` parameter, and set it either globally, as a connection parameter, or even at the API call level but using the `PushDown` mechanism described below.
+
+Sets a timeout of 10s gloally
+```js
+const connectionParameters = sdk.ConnectionParameters.ofUserAndPassword(
+                                    "https://myInstance.campaign.adobe.com", 
+                                    "admin", "admin",
+                                    { timeout: 10000 });
+```
+
+Override the timeout to 1 min for a particular API call
+```js
+NLWS.xml.pushDown({ timeout: 60000 }).xtkBuilder.installPackage(dom);
+```
+
+## Pushdown mechanism
+The Pushdown mechanism can be used to push down variables to the transport layer. A common use case it to pass a custom timeout value down to the transport layer.
+
+The pushed down parameters are passed as a second parameter to the transport function. This parameter will contain all the connection parameters as well as any parameter that you can push down at the API call level. API call pushdowns can override default pushdowns.
+
+Any key/value pairs can be pushed down. This example pushes down the timeout and foo variables to the transport layer.
+```js
+NLWS.xml.pushDown({ timeout: 60000, foo: 'bar' }).xtkBuilder.installPackage(dom);
+```
+
+## Troubleshooting
+In the version 1.1.5 of the SDK, we are automatically adding the SOAP method name in the URL in order to simplify troubleshooting. Normally, all SOAP method calls are make to the soaprouter.jsp endpoint, which makes it difficult to understand which actual API call is being made.
+In fact the SOAP call name is available via the SOAPAction HTTP header, but it's usually not immediatelly visible.
+
+The SOAP calls URLs are now formed like this: `http://acc-sdk:8080/nl/jsp/soaprouter.jsp?xtk:queryDef:ExecuteQuery` where the SOAP method name is added as a query parameter. Campaign server ignores this parameter.
+
+This can be disabled using the `noMethodInURL` connection parameter
+
+const connectionParameters = sdk.ConnectionParameters.ofUserAndPassword(
+                                    "https://myInstance.campaign.adobe.com", 
+                                    "admin", "admin",
+                                    { noMethodInURL: true });
 
 
 # Samples
@@ -982,12 +1054,16 @@ The transport protocol defines
 - What is the corresponding response
 - How errors are handled
 
-The transport protocol exports a single asynchronous function `request` which takes a `Request` literal object with the following attributes. Note that it matches axios requests.
+The transport protocol exports a single asynchronous function `request` which takes two parameters.
+
+The first parameter is the request object with the following attributes. Note that it matches axios requests.
 * `method` is the HTTP verb
 * `url` is the URL to call
 * `headers` is an object containing key value pairs with http headers and their values
 * `data` is the request payload
 
+The second parameter is an set of additional parameters that have been pushed down to the transport layer (see the `Pushdown` paragraph for more details). In particular, the `timeout` parameter should be honored by the transport layer.
+
 If the request is successful, a promise is returned with the result payload, as a string.
 
 If the request fails, the promise is rejected with an error object with class `HttpError`, a litteral with the following attributes:
@@ -995,7 +1071,7 @@ If the request fails, the promise is rejected with an error object with class `H
 * `statusText` is the HTTP status text coming with the error
 * `data` is the response data, if any
 
-For proper error handling by the ACC SDK, it's important that the actual class of returned objects is names "HttpError"
+For proper error handling by the ACC SDK, it's important that the actual class of returned objects is named "HttpError"
 
 The transport can be overriden by using the `client.setTransport` call and passing it a transport function, i.e. an async function which
 * Takes a `Request` object litteral as a parameter
@@ -1052,14 +1128,14 @@ xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
 xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"
 xmlns:ns="http://xml.apache.org/xml-soap">
 <SOAP-ENV:Header>
-    <Cookie>__sessiontoken=***</Cookie>
-    <X-Security-Token>***</X-Security-Token>
+<Cookie>__sessiontoken=***</Cookie>
+<X-Security-Token>***</X-Security-Token>
 </SOAP-ENV:Header>
 <SOAP-ENV:Body>
-    <m:GetOption xmlns:m="urn:xtk:session" SOAP-ENV:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/">
-        <sessiontoken xsi:type="xsd:string">***</sessiontoken>
-        <name xsi:type="xsd:string">XtkDatabaseId</name>
-    </m:GetOption>
+<m:GetOption xmlns:m="urn:xtk:session" SOAP-ENV:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/">
+<sessiontoken xsi:type="xsd:string">***</sessiontoken>
+<name xsi:type="xsd:string">XtkDatabaseId</name>
+</m:GetOption>
 </SOAP-ENV:Body>
 </SOAP-ENV:Envelope>
 
@@ -1069,10 +1145,10 @@ xmlns:xsi='http://www.w3.org/2001/XMLSchema-instance'
 xmlns:ns='urn:xtk:session'
 xmlns:SOAP-ENV='http://schemas.xmlsoap.org/soap/envelope/'>
 <SOAP-ENV:Body>
-    <GetOptionResponse xmlns='urn:xtk:session' SOAP-ENV:encodingStyle='http://schemas.xmlsoap.org/soap/encoding/'>
-        <pstrValue xsi:type='xsd:string'>uFE80000000000000F1FA913DD7CC7C4804BA419F</pstrValue>
-        <pbtType xsi:type='xsd:byte'>6</pbtType>
-    </GetOptionResponse>
+<GetOptionResponse xmlns='urn:xtk:session' SOAP-ENV:encodingStyle='http://schemas.xmlsoap.org/soap/encoding/'>
+<pstrValue xsi:type='xsd:string'>uFE80000000000000F1FA913DD7CC7C4804BA419F</pstrValue>
+<pbtType xsi:type='xsd:byte'>6</pbtType>
+</GetOptionResponse>
 </SOAP-ENV:Body>
 </SOAP-ENV:Envelope>
 `````
@@ -1461,6 +1537,7 @@ The `application` object can be obtained from a client, and will mimmic the Camp
 | Attribute/Method | Description |
 |---|---|
 | **buildNumber** | The server build number
+| **version** | In SDK version 1.1.4 and above, returns the server version formatted as major.minor.servicePack (ex: 8.2.10)
 | **instanceName** | The name of the Campaign instance
 | **operator** | Information about the current operator (i.e. logged user), of class `CurrentLogin`
 | **packages** | List of installed packages, as an array of strings

package/compile.js

@@ -36,10 +36,11 @@ var resources = [
     { name: "./xtkEntityCache.js" },
     { name: "./methodCache.js" },
     { name: "./optionCache.js" },
+    { name: "./cacheRefresher.js" },
     { name: "./soap.js" },
     { name: "./crypto.js" },
-    { name: "./testUtil.js" },
     { name: "./application.js" },
+    { name: "./testUtil.js" },
     { name: "./client.js" },
     { name: "./index.js" },
 ];

package/package-lock.json

@@ -1,12 +1,12 @@
 {
   "name": "@adobe/acc-js-sdk",
-  "version": "1.1.3",
+  "version": "1.1.6",
   "lockfileVersion": 2,
   "requires": true,
   "packages": {
     "": {
       "name": "@adobe/acc-js-sdk",
-      "version": "1.1.3",
+      "version": "1.1.6",
       "license": "ISC",
       "dependencies": {
         "axios": "^0.25.0",
@@ -1402,14 +1402,21 @@
       }
     },
     "node_modules/caniuse-lite": {
-      "version": "1.0.30001301",
-      "resolved": "https://registry.npmjs.org/caniuse-lite/-/caniuse-lite-1.0.30001301.tgz",
-      "integrity": "sha512-csfD/GpHMqgEL3V3uIgosvh+SVIQvCh43SNu9HRbP1lnxkKm1kjDG4f32PP571JplkLjfS+mg2p1gxR7MYrrIA==",
+      "version": "1.0.30001378",
+      "resolved": "https://artifactory.corp.adobe.com/artifactory/api/npm/npm-adobe-release/caniuse-lite/-/caniuse-lite-1.0.30001378.tgz",
+      "integrity": "sha512-JVQnfoO7FK7WvU4ZkBRbPjaot4+YqxogSDosHv0Hv5mWpUESmN+UubMU6L/hGz8QlQ2aY5U0vR6MOs6j/CXpNA==",
       "dev": true,
-      "funding": {
-        "type": "opencollective",
-        "url": "https://opencollective.com/browserslist"
-      }
+      "funding": [
+        {
+          "type": "opencollective",
+          "url": "https://opencollective.com/browserslist"
+        },
+        {
+          "type": "tidelift",
+          "url": "https://tidelift.com/funding/github/npm/caniuse-lite"
+        }
+      ],
+      "license": "CC-BY-4.0"
     },
     "node_modules/catharsis": {
       "version": "0.9.0",
@@ -6147,9 +6154,9 @@
       "dev": true
     },
     "caniuse-lite": {
-      "version": "1.0.30001301",
-      "resolved": "https://registry.npmjs.org/caniuse-lite/-/caniuse-lite-1.0.30001301.tgz",
-      "integrity": "sha512-csfD/GpHMqgEL3V3uIgosvh+SVIQvCh43SNu9HRbP1lnxkKm1kjDG4f32PP571JplkLjfS+mg2p1gxR7MYrrIA==",
+      "version": "1.0.30001378",
+      "resolved": "https://artifactory.corp.adobe.com/artifactory/api/npm/npm-adobe-release/caniuse-lite/-/caniuse-lite-1.0.30001378.tgz",
+      "integrity": "sha512-JVQnfoO7FK7WvU4ZkBRbPjaot4+YqxogSDosHv0Hv5mWpUESmN+UubMU6L/hGz8QlQ2aY5U0vR6MOs6j/CXpNA==",
       "dev": true
     },
     "catharsis": {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@adobe/acc-js-sdk",
-  "version": "1.1.3",
+  "version": "1.1.6",
   "description": "ACC Javascript SDK",
   "main": "src/index.js",
   "homepage": "https://github.com/adobe/acc-js-sdk#readme",

package/samples/011 - basics - packages.js

@@ -0,0 +1,60 @@
+/*
+Copyright 2020 Adobe. All rights reserved.
+This file is licensed to you under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License. You may obtain a copy
+of the License at http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software distributed under
+the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS
+OF ANY KIND, either express or implied. See the License for the specific language
+governing permissions and limitations under the License.
+*/
+const { DomUtil } = require('../src/domUtil.js');
+const sdk = require('../src/index.js');
+const utils = require("./utils.js");
+
+
+/**
+ * This sample illustrates how to generate and import packages
+ */
+
+( async () => {
+
+  await utils.sample({
+    title: "Testing generating and importing packages",
+    labels: [ "Basics", "Packages", "xtk:builder", "InstallPackage" ],
+    description: `The xtkBuilder.installPackage() can be used to import packages`,
+    code: async() => {
+      return await utils.logon(async (client, NLWS) => {
+        console.log(`Generating package with an option named AccJsSdk`);
+        const doc =  sdk.DomUtil.newDocument('pkgDesc');
+        const package = doc.createElement('package');
+        doc.documentElement.appendChild(package);
+        package.setAttribute('namespace', 'cus');
+        package.setAttribute('name', 'sdk');
+        package.setAttribute('buildNumber', '*');
+        package.setAttribute('buildVersion', '*');
+        package.setAttribute('label', 'Test package for ACC JS SDK');
+        package.setAttribute('vendor', 'acc-js-sdk');
+        
+        const entities = doc.createElement('entities');
+        package.appendChild(entities);
+        entities.setAttribute('schema', 'xtk:option');
+      
+        const option = doc.createElement('option');
+        option.setAttribute('name', 'AccJsSdk');
+        option.setAttribute('dataType', '6');
+        const version = client.application.version;
+        option.setAttribute('stringValue', JSON.stringify(version));
+        entities.appendChild(option);
+      
+        // Install package. The package is in XML format and we set the timeout to 5 mins to prevent any issues
+        console.log(`Installing package`, DomUtil.toXMLString(doc));
+        await NLWS.xml.pushDown({ timeout: 5*60*1000 }).xtkBuilder.installPackage(doc);      
+        console.log(`Package installed`);
+      });
+    }
+  });
+
+})();
+

package/src/application.js

@@ -65,20 +65,46 @@ function propagateImplicitValues(xtkDesc, labelOnly) {
 // ========================================================================================
 // Schema Cache
 // ========================================================================================
+
+/**
+ * A cache of schemas of type `XtkSchema` instead of plain XML or JSON objects
+ * 
+ * @private
+ * @class
+ * @constructor
+ * @memberof Campaign
+ */
+
 class SchemaCache {
     constructor(client) {
         this._client = client;
         this._schemas = {};
     }
+
+    /**
+      * Get a schema by id from schema cache of type `XtkSchema` 
+     * 
+     * @param {string} schemaId 
+     * @returns {Campaign.XtkSchema} the schema, or null if the schema was not found
+     */
     async getSchema(schemaId) {
         let schema = this._schemas[schemaId];
         if (schema === undefined) {
             schema = await this._client.application._getSchema(schemaId);
             if (!schema) schema = null; // null = not found
-        this._schemas[schemaId] = schema;
+            this._schemas[schemaId] = schema;
         }
         return schema;
     }
+
+    /**
+      * Remove a schema from schema cache. The callback function when refreshing cache in cacheRefresher 
+     * 
+     * @param {string} schemaId 
+     */
+    invalidateCacheItem(schemaId) {
+        this._schemas[schemaId] = undefined;
+    }
 }
 
 // ========================================================================================
@@ -1207,29 +1233,43 @@ class Application {
              * The server build number
              * @type {string}
              */
-        this.buildNumber = EntityAccessor.getAttributeAsString(serverInfo, "buildNumber");
+            this.buildNumber = EntityAccessor.getAttributeAsString(serverInfo, "buildNumber");
+            /**
+             * The server version, formatted as major.minor.servicePack (ex: 8.2.10)
+             * @type {string}
+             */
+            this.version = EntityAccessor.getAttributeAsString(serverInfo, "majNumber") + "." +
+                           EntityAccessor.getAttributeAsString(serverInfo, "minNumber") + "." +
+                           EntityAccessor.getAttributeAsString(serverInfo, "servicePack");
             /**
              * The Campaign instance name
              * @type {string}
              */
-        this.instanceName = EntityAccessor.getAttributeAsString(serverInfo, "instanceName");
+            this.instanceName = EntityAccessor.getAttributeAsString(serverInfo, "instanceName");
             const userInfo = EntityAccessor.getElement(info, "userInfo");
             /**
              * The logged operator
              * @type {Campaign.CurrentLogin}
              */
-        this.operator = new CurrentLogin(userInfo);
+            this.operator = new CurrentLogin(userInfo);
             /**
              * The list of installed packages
              * @type {string[]}
              */
-        this.packages = [];
+            this.packages = [];
             for (var p of EntityAccessor.getChildElements(userInfo, "installed-package")) {
             this.packages.push(`${EntityAccessor.getAttributeAsString(p, "namespace")}:${EntityAccessor.getAttributeAsString(p, "name")}`);
             }
         }
     }
 
+    _registerCacheChangeListener() {
+        this.client._registerCacheChangeListener(this._schemaCache);
+    }
+
+    _unregisterCacheChangeListener() {
+        this.client._unregisterCacheChangeListener(this._schemaCache);
+    }
     /**
      * Get a schema by id. This function returns an XtkSchema object or null if the schema is not found.
      * Using the `XtkSchema` API makes it easier to navigate schemas than using a plain XML or JSON object
@@ -1241,7 +1281,7 @@ class Application {
         return this._schemaCache.getSchema(schemaId);
     }
 
-    // Private function: get a schema without using the cache
+    // Private function: get a schema without using the SchemaCache
     async _getSchema(schemaId) {
         const xml = await this.client.getSchema(schemaId, "xml");
         if (!xml)

package/src/cache.js

@@ -123,6 +123,7 @@ class SafeStorage {
     } catch(ex) { /* Ignore errors in safe class */
     }
   }
+
 }
 
 /**
@@ -243,7 +244,7 @@ class Cache {
 
   /**
    * Put a value from the cache
-   * @param {*} key the key or keys of the value to retreive
+   * @param {*} key the key or keys of the value to retrieve
    * @param {*} value the value to cache
    * @returns {CachedObject} a cached object containing the cached value
    */
@@ -266,6 +267,15 @@ class Cache {
       this._cache = {};
       this._saveLastCleared();
   }
+
+  /**
+   * Remove a key from the cache
+   * @param {string} key the key to remove
+   */
+  remove(key) {
+      delete this._cache[key];
+      this._remove(key);
+  }
 }
 
 // Public expots