infinispan 0.9.0 → 0.11.0

package/.eslintrc

@@ -0,0 +1,25 @@
+{
+  "root":true,
+  "env": {
+    "es6": true,
+    "node": true
+  },
+  "parserOptions": {
+    "ecmaVersion": 2022,
+    "sourceType": "module"
+  },
+  "rules": {
+    "standard/no-callback-literal": "off",
+    "arrow-spacing": "error",
+    "arrow-parens": ["error", "as-needed"],
+    "arrow-body-style": ["error", "as-needed"],
+    "prefer-template": "error",
+    "no-unused-vars": ["warn", {
+      "argsIgnorePattern": "^_$|^e$|^reject$|^resolve$"
+    }],
+    "valid-jsdoc": "error",
+    "require-jsdoc": "warn",
+    "semi": ["error", "always"],
+    "quotes": ["error", "single", { "allowTemplateLiterals": true }]
+  }
+}

package/Jenkinsfile-release

@@ -24,7 +24,7 @@ pipeline {
 
         stage('Install release package') {
             steps {
-                nodejs(nodeJSInstallationName: 'Node 14') {
+                nodejs(nodeJSInstallationName: 'Node 18') {
                     sh 'rm -drf node_modules/'
                     sh 'npm config ls'
                     sh 'npm install'
@@ -35,10 +35,12 @@ pipeline {
 
         stage('Release') {
             steps {
-                nodejs(nodeJSInstallationName: 'Node 14') {
+                nodejs(nodeJSInstallationName: 'Node 18') {
                     withCredentials([string(credentialsId: 'npmauthtoken', variable: 'NPM_AUTH_TOKEN')]) {
                         sh './set-npm-auth-token.sh'
                     }
+                    sh "git status"
+                    sh "git diff"
                     sh "npm-release ${version}"
                 }
             }
@@ -46,7 +48,7 @@ pipeline {
 
         stage('Generate JS API docs and upload') {
             steps {
-                nodejs(nodeJSInstallationName: 'Node 14') {
+                nodejs(nodeJSInstallationName: 'Node 18') {
                     sh './node_modules/.bin/jsdoc lib/*.js'
                     sh 'mv out apidocs'
                     sh 'mkdir 1.0'

package/documentation/asciidoc/stories/assembly_client_usage_examples.adoc

@@ -1,15 +1,9 @@
 [id='client-usage-examples']
 :context: client-usage-examples
 = Using {hr_js} clients
-This section provides code examples that show you how to use {hr_js} clients to perform various operations.
+Take a look at some examples for using the {hr_js} client with {brandname}.
 
-include::{topics}/proc_working_single_entries_statistics.adoc[leveloffset=+1]
-include::{topics}/proc_using_conditional_operations.adoc[leveloffset=+1]
-include::{topics}/proc_working_multiple_entries.adoc[leveloffset=+1]
-include::{topics}/proc_working_ephemeral_data.adoc[leveloffset=+1]
-include::{topics}/proc_registering_event_listeners.adoc[leveloffset=+1]
-include::{topics}/proc_executing_scripts.adoc[leveloffset=+1]
-include::{topics}/proc_using_async_await.adoc[leveloffset=+1]
+include::{topics}/ref_client_usage.adoc[leveloffset=+1]
 
 // Restore the parent context.
 ifdef::parent-context[:context: {parent-context}]

package/documentation/asciidoc/stories/{assembly_configuration.adoc → assembly_installation_configuration.adoc}

@@ -1,8 +1,10 @@
-[id='client-configuration']
-:context: client-configuration
-= Configuring {hr_js} clients
-Configure {hr_js} clients to connect to {brandname} Server, use different media types for keys and values, and adjust levels for log messages.
+[id='install-configure']
+:context: install-configure
+= Installing and configuring {hr_js} clients
+Ensure your system meets requirements before installing the {hr_js} client.
+You can then configure {hr_js} clients to connect to {brandname} Server, use different media types for keys and values, and customize logging.
 
+include::{topics}/proc_installing_clients.adoc[leveloffset=+1]
 include::{topics}/proc_configuring_connections.adoc[leveloffset=+1]
 include::{topics}/proc_configuring_connections_xsite.adoc[leveloffset=+2]
 include::{topics}/proc_switching_clusters.adoc[leveloffset=+2]

package/documentation/asciidoc/titles/js_client.asciidoc

@@ -9,6 +9,7 @@ include::{topics}/attributes/community-attributes.adoc[]
 //Downstream
 //include::{topics}/attributes/downstream-attributes.adoc[]
 //:downstream:
+//:rhdg-install-npmrepo:
 
 //Title attributes
 :toc2:

package/documentation/asciidoc/titles/stories.adoc

@@ -1,6 +1,5 @@
 //Reference user stories or topics.
 //Please review authoring guidelines in the Contributors Guide.
 
-include::{stories}/assembly_getting_started.adoc[leveloffset=+1]
-include::{stories}/assembly_configuration.adoc[leveloffset=+1]
+include::{stories}/assembly_installation_configuration.adoc[leveloffset=+1]
 include::{stories}/assembly_client_usage_examples.adoc[leveloffset=+1]

package/documentation/asciidoc/topics/attributes/community-attributes.adoc

@@ -3,6 +3,7 @@
 
 :doc_home: https://infinispan.org/documentation/
 :download_url: https://infinispan.org/hotrod-clients
-:js_api_docs: https://docs.jboss.org/infinispan/hotrod-clients/javascript/1.0/apidocs/
+:node_docs: https://docs.jboss.org/infinispan/hotrod-clients/javascript/1.0/apidocs/
 :server_docs: https://infinispan.org/docs/stable/titles/server/server.html
 :code_tutorials: https://github.com/infinispan/infinispan-simple-tutorials/
+:query_docs: https://infinispan.org/docs/stable/titles/query/query.html

package/documentation/asciidoc/topics/attributes/downstream-attributes.adoc

@@ -1,4 +1,2 @@
 :brandname: Data Grid
 :hr_js: Hot Rod JS
-
-:js_api_docs: https://access.redhat.com/webassets/avalon/d/red-hat-data-grid/8.2/node/

package/documentation/asciidoc/topics/code_examples/authentication-digest.js

@@ -1,5 +1,6 @@
-var connected = infinispan.client({port: 11222, host: '127.0.0.1'},
-{
+var connected = infinispan.client(
+  {port: 11222, host: '127.0.0.1'},
+  {
     authentication: {
       enabled: true,
       saslMechanism: 'DIGEST-MD5',

package/documentation/asciidoc/topics/code_examples/authentication-external.js

@@ -1,5 +1,6 @@
-var connected = infinispan.client({port: 11222, host: '127.0.0.1'},
-{
+var connected = infinispan.client(
+  {port: 11222, host: '127.0.0.1'},
+  {
     authentication: {
       enabled: true,
       saslMechanism: 'EXTERNAL'

package/documentation/asciidoc/topics/code_examples/authentication-oauthbearer.js

@@ -1,5 +1,6 @@
-var connected = infinispan.client({port: 11222, host: '127.0.0.1'},
-{
+var connected = infinispan.client(
+  {port: 11222, host: '127.0.0.1'},
+  {
     authentication: {
       enabled: true,
       saslMechanism: 'OAUTHBEARER',

package/documentation/asciidoc/topics/code_examples/authentication-plain.js

@@ -1,5 +1,6 @@
-var connected = infinispan.client({port: 11222, host: '127.0.0.1'},
-{
+var connected = infinispan.client(
+  {port: 11222, host: '127.0.0.1'},
+  {
     authentication: {
       enabled: true,
       saslMechanism: 'PLAIN',

package/documentation/asciidoc/topics/code_examples/authentication-scram.js

@@ -1,5 +1,6 @@
-var connected = infinispan.client({port: 11222, host: '127.0.0.1'},
-{
+var connected = infinispan.client(
+  {port: 11222, host: '127.0.0.1'},
+  {
     authentication: {
       enabled: true,
       saslMechanism: 'SCRAM-SHA-1',

package/documentation/asciidoc/topics/code_examples/await-single-entries.js

@@ -21,7 +21,7 @@ async function test() {
   let stats = await client.stats();
   console.log('Number of stores: ' + stats.stores);
   console.log('Number of cache hits: ' + stats.hits);
-  console.log('All stats: ' + JSON.stringify(stats, null, " "));
+  console.log('All statistics: ' + JSON.stringify(stats, null, " "));
 
   await client.disconnect();
 }

package/documentation/asciidoc/topics/code_examples/conditional-operations.js

@@ -1,6 +1,11 @@
 var infinispan = require('infinispan');
 
-var connected = infinispan.client({port: 11222, host: '127.0.0.1'});
+var connected = infinispan.client(
+  {port: 11222, host: '127.0.0.1'}
+  {
+    // Configure client connections with authentication and encryption here.
+  }
+);
 
 connected.then(function (client) {
 
@@ -18,6 +23,7 @@ connected.then(function (client) {
   var clientGetMetaForReplace = showReplace.then(
       function() { return client.getWithMetadata('cond'); });
 
+  // Call the getWithMetadata method to retrieve the value and its metadata.
   var clientReplaceWithVersion = clientGetMetaForReplace.then(
       function(entry) {
         console.log('getWithMetadata(cond)=' + JSON.stringify(entry));

package/documentation/asciidoc/topics/code_examples/connection-multiple-servers.js

@@ -1,7 +1,11 @@
 var infinispan = require('infinispan');
 
 var connected = infinispan.client(
-  [{port: 11322, host: '127.0.0.1'}, {port: 11222, host: '127.0.0.1'}]);
+  [{port: 11322, host: '127.0.0.1'}, {port: 11222, host: '127.0.0.1'}]
+  {
+    // Configure client connections with authentication and encryption here.
+  }
+);
 
 connected.then(function (client) {
 

package/documentation/asciidoc/topics/code_examples/data-types.js

@@ -1,8 +1,8 @@
 var infinispan = require('infinispan');
 
 var connected = infinispan.client(
-    {port: 11222, host: '127.0.0.1'}
-    , {
+    {port: 11222, host: '127.0.0.1'},
+    {
         dataFormat : {
             keyType: 'application/json',
             valueType: 'application/json'

package/documentation/asciidoc/topics/code_examples/ephemeral-data.js

@@ -1,6 +1,11 @@
 var infinispan = require('infinispan');
 
-var connected = infinispan.client({port: 11222, host: '127.0.0.1'});
+var connected = infinispan.client(
+  {port: 11222, host: '127.0.0.1'}
+  {
+    // Configure client connections with authentication and encryption here.
+  }
+);
 
 connected.then(function (client) {
 
@@ -8,26 +13,26 @@ connected.then(function (client) {
 
   var clientGetMetaAndSize = clientPutExpiry.then(
     function() {
-      // Compute getWithMetadata and size in parallel
+      // Compute getWithMetadata and size in parallel.
       return Promise.all([client.getWithMetadata('expiry'), client.size()]);
     });
 
   var showGetMetaAndSize = clientGetMetaAndSize.then(
     function(values) {
-      console.log('before expiration:');
+      console.log('Before expiration:');
       console.log('getWithMetadata(expiry)=' + JSON.stringify(values[0]));
       console.log('size=' + values[1]);
     });
 
   var clientContainsAndSize = showGetMetaAndSize.then(
     function() {
-      sleepFor(1100); // Sleep to force expiration
+      sleepFor(1100); // Sleep to force expiration.
       return Promise.all([client.containsKey('expiry'), client.size()]);
     });
 
   var showContainsAndSize = clientContainsAndSize.then(
     function(values) {
-      console.log('after expiration:');
+      console.log('After expiration:');
       console.log('containsKey(expiry)=' + values[0]);
       console.log('size=' + values[1]);
     });
@@ -43,5 +48,5 @@ connected.then(function (client) {
 
 function sleepFor(sleepDuration){
   var now = new Date().getTime();
-  while(new Date().getTime() < now + sleepDuration){ /* do nothing */ }
+  while(new Date().getTime() < now + sleepDuration){ /* Do nothing. */ }
 }

package/documentation/asciidoc/topics/code_examples/hello-world.js

@@ -1,8 +1,20 @@
 var infinispan = require('infinispan');
 
 // Connect to {brandname} Server.
+// Use an existing cache named "myCache".
 var connected = infinispan.client(
-  {port: 11222, host: '127.0.0.1'}, {cacheName: 'myCache'});
+  {port: 11222, host: '127.0.0.1'},
+  {
+    cacheName: 'myCache',
+    clientIntelligence: 'BASIC',
+    authentication: {
+      enabled: true,
+      saslMechanism: 'DIGEST-MD5',
+      userName: 'username',
+      password: 'changeme'
+    }
+  }
+);
 
 connected.then(function (client) {
 

package/documentation/asciidoc/topics/code_examples/key-value-converter.js

@@ -11,7 +11,7 @@ var connected = infinispan.client(
 );
 
 connected.then(function (client) {
-
+    // Include the remote event converter to avoid unnecessary roundtrips.
     var opts = {
         converterFactory : {
             name: "key-value-with-previous-converter-factory"
@@ -22,9 +22,8 @@ connected.then(function (client) {
 
     var clientAddListeners = clientAddListenerCreate.then(
         function(listenerId) {
-            // Multiple callbacks can be associated with a single client-side listener.
-            // This is achieved by registering listeners with the same listener id
-            // as shown in the example below.
+            // Associate multiple callbacks with a single client-side listener.
+            // To do this, register listeners with the same listener ID.
             var clientAddListenerModify =
                 client.addListener('modify', logEvent("Modified"), {opts, listenerId: listenerId});
 

package/documentation/asciidoc/topics/code_examples/multiple-entries.js

@@ -1,6 +1,17 @@
 var infinispan = require('infinispan');
 
-var connected = infinispan.client({port: 11222, host: '127.0.0.1'});
+var connected = infinispan.client(
+  {port: 11222, host: '127.0.0.1'},
+  {
+    cacheName: 'myCache',
+    authentication: {
+        enabled: true,
+        saslMechanism: 'DIGEST-MD5',
+        userName: 'username',
+        password: 'changeme'
+    }
+  }
+);
 
 connected.then(function (client) {
   var data = [
@@ -25,7 +36,7 @@ connected.then(function (client) {
   var showIterated = clientIterator.then(
     function(it) {
       function loop(promise, fn) {
-        // Simple recursive loop over iterator's next() call
+        // Simple recursive loop over the iterator's next() call.
         return promise.then(fn).then(function (entry) {
           return entry.done
             ? it.close().then(function () { return entry.value; })

package/documentation/asciidoc/topics/code_examples/queries.js

@@ -0,0 +1,92 @@
+const infinispan = require('infinispan');
+const protobuf = require('protobufjs');
+// This example uses async/await paradigma
+(async function () {
+  // User data protobuf definition
+  const cacheValueProtoDef = `package awesomepackage;
+  /**
+   * @TypeId(1000044)
+   */
+  message AwesomeUser {
+      required string name = 1;
+      required int64 age = 2;
+      required bool isVerified =3;
+  }`
+  try {
+    // Creating clients for two caches:
+    // - ___protobuf_metadata for registering .proto file
+    // - queryCache for user data
+    const connectProp = { port: 11222, host: '127.0.0.1' };
+    const commonOpts = {
+      version: '3.0',
+      authentication: {
+        enabled: true,
+        saslMechanism: 'DIGEST-MD5',
+        userName: 'admin',
+        password: 'pass'
+      }
+    };
+    const protoMetaClientOps = {
+      cacheName: '___protobuf_metadata',
+      dataFormat: { keyType: "text/plain", valueType: "text/plain" }
+    }
+    const clientOps = {
+      dataFormat: { keyType: "text/plain", valueType: "application/x-protostream" },
+      cacheName: 'queryCache'
+    }
+    var protoMetaClient = await infinispan.client(connectProp, Object.assign(commonOpts, protoMetaClientOps));
+    var client = await infinispan.client(connectProp, Object.assign(commonOpts, clientOps));
+
+    // Registering protobuf definition on server
+    await protoMetaClient.put("awesomepackage/AwesomeUser.proto", cacheValueProtoDef);
+
+    // Registering protobuf definition on protobufjs
+    const root = protobuf.parse(cacheValueProtoDef).root;
+    const AwesomeUser = root.lookupType(".awesomepackage.AwesomeUser");
+    client.registerProtostreamRoot(root);
+    client.registerProtostreamType(".awesomepackage.AwesomeUser", 1000044);
+
+    // Cleanup and populating the cache
+    await client.clear();
+    for (let i = 0; i < 10; i++) {
+      const payload = { name: "AwesomeName" + i, age: i, isVerified: (Math.random() < 0.5) };
+      const message = AwesomeUser.create(payload);
+      console.log("Creating entry:", message);
+      await client.put(i.toString(), message)
+    }
+    // Run the query
+    const queryStr = `select u.name,u.age from awesomepackage.AwesomeUser u where u.age<20 order by u.name asc`;
+    console.log("Running query:", queryStr);
+    const query = await client.query({ queryString: queryStr });
+    console.log("Query result:");
+    console.log(query);
+  } catch (err) {
+    handleError(err);
+  } finally {
+    if (client) {
+      await client.disconnect();
+    }
+    if (protoMetaClient) {
+      await protoMetaClient.disconnect();
+    }
+  }
+})();
+
+function handleError(err) {
+  if (err.message.includes("'queryCache' not found")) {
+    console.log('*** ERROR ***');
+    console.log(`*** This example needs a cache 'queryCache' with the following config:
+    {
+      "local-cache": {
+        "statistics": true,
+        "encoding": {
+        "key": {
+          "media-type": "text/plain"
+        },
+        "value": {
+          "media-type": "application/x-protostream"
+}}}}`)
+  } else {
+    console.log(err);
+  }
+}

package/documentation/asciidoc/topics/code_examples/register-event-listener.js

@@ -1,6 +1,11 @@
 var infinispan = require('infinispan');
 
-var connected = infinispan.client({port: 11222, host: '127.0.0.1'});
+var connected = infinispan.client(
+  {port: 11222, host: '127.0.0.1'}
+  {
+    // Configure client connections with authentication and encryption here.
+  }
+);
 
 connected.then(function (client) {
 
@@ -8,9 +13,8 @@ connected.then(function (client) {
 
     var clientAddListeners = clientAddListenerCreate.then(
         function(listenerId) {
-            // Multiple callbacks can be associated with a single client-side listener.
-            // This is achieved by registering listeners with the same listener id
-            // as shown in the example below.
+            // Associate multiple callbacks with a single client-side listener.
+            // To do this, register listeners with the same listener ID.
             var clientAddListenerModify =
                 client.addListener('modify', onModify, {listenerId: listenerId});
 

package/documentation/asciidoc/topics/code_examples/sample-script-execute.js

@@ -1,7 +1,12 @@
 var infinispan = require('infinispan');
 var readFile = Promise.denodeify(require('fs').readFile);
 
-var connected = infinispan.client({port: 11222, host: '127.0.0.1'});
+var connected = infinispan.client(
+  {port: 11222, host: '127.0.0.1'}
+  {
+    // Configure client connections with authentication and encryption here.
+  }
+);
 
 connected.then(function (client) {
 

package/documentation/asciidoc/topics/code_examples/single-entries.js

@@ -1,6 +1,17 @@
 var infinispan = require('infinispan');
 
-var connected = infinispan.client({port: 11222, host: '127.0.0.1'});
+var connected = infinispan.client(
+  {port: 11222, host: '127.0.0.1'},
+  {
+    cacheName: 'myCache',
+    authentication: {
+        enabled: true,
+        saslMechanism: 'DIGEST-MD5',
+        userName: 'username',
+        password: 'changeme'
+    }
+  }
+);
 
 connected.then(function (client) {
 
@@ -25,7 +36,7 @@ connected.then(function (client) {
     function(stats) {
       console.log('Number of stores: ' + stats.stores);
       console.log('Number of cache hits: ' + stats.hits);
-      console.log('All stats: ' + JSON.stringify(stats, null, " "));
+      console.log('All statistics: ' + JSON.stringify(stats, null, " "));
     });
 
   return showStats.finally(

package/documentation/asciidoc/topics/proc_configuring_connections.adoc

@@ -2,6 +2,14 @@
 = Configuring {brandname} connections
 Configure {hr_js} clients to connect to {brandname} Server.
 
+If you add multiple server addresses to the configuration, the {hr_js} client loops through them until it finds a node to which it can connect.
+
+However, you only need to add one {brandname} Server address for the client to receive the entire cluster topology.
+If the {hr_js} client connects to a single server instance that is a member of a cluster, the client gets the address information for all nodes.
+
+Because {hr_js} clients are topology aware, if a connection to one {brandname} Server breaks, the client retries any incomplete operations on other nodes in the cluster.
+Likewise, if client listener that is registered on one {brandname} Server fails or leaves the cluster, the client transparently migrates the listener registration to another node in the cluster so that it can continue receiving events.
+
 .Prerequisites
 
 * Install the {hr_js} client.
@@ -15,12 +23,3 @@ Configure {hr_js} clients to connect to {brandname} Server.
 ----
 include::code_examples/connection-multiple-servers.js[]
 ----
-
-The preceding configuration example includes connection details for two servers.
-When you add multiple server addresses to the configuration, the {hr_js} client loops through them until it finds a node to which it can connect.
-
-However, you only need to add one {brandname} Server address for the client to receive the entire cluster topology.
-If the {hr_js} client connects to a single server instance that is a member of a cluster, the client gets the address information for all nodes.
-
-Because {hr_js} clients are topology aware, if a connection to one {brandname} Server breaks, the client retries any incomplete operations on other nodes in the cluster.
-Likewise, if client listener that is registered on one {brandname} Server fails or leaves the cluster, the client transparently migrates the listener registration to another node in the cluster so that it can continue receiving events.

package/documentation/asciidoc/topics/proc_installing_clients.adoc

@@ -22,19 +22,37 @@ endif::downstream[]
 ifdef::community[]
 * Install the `infinispan` client as follows:
 +
-[source,bash,options="nowrap",subs=attributes+]
+[source,options="nowrap",subs=attributes+]
 ----
-$ npm i infinispan
+npm install infinispan
 ----
 endif::community[]
 
 //Downstream content
-ifdef::downstream[]
+ifdef::rhdg-install-npmrepo[]
+. Add the Red Hat repository to your NPM configuration.
++
+You can use the `npm config` command or add the following to an `.npmrc` file in your project:
++
+[source,options="nowrap",subs=attributes+]
+----
+@redhat:registry=https://npm.registry.redhat.com
+registry=https://registry.npmjs.org/
+----
+
+. Install the {hr_js} client as follows:
++
+[source,options="nowrap",subs=attributes+]
+----
+npm install @redhat/infinispan
+----
+endif::rhdg-install-npmrepo[]
+ifdef::rhdg-install-package[]
 . Download and extract the `redhat-datagrid-<version>-nodejs-client.zip` from the {portal}.
 . Install the `tgz` package from the extracted directory as in the following example:
 +
 [source,bash,options="nowrap",subs=attributes+]
 ----
-$ npm install /path/to/redhat-datagrid-<version>-nodejs-client/infinispan-<version>.tgz
+npm install /path/to/redhat-datagrid-<version>-nodejs-client/infinispan-<version>.tgz
 ----
-endif::downstream[]
+endif::rhdg-install-package[]