Add node globals to context

CHANGELOG.md

@@ -1,3 +1,7 @@
+## 1.2.0 (Dec 12, 2019)
+* Add support for more node global objects
+* Update Sailor to version 2.5.1
+
 ## 1.0.1 (November 13, 2019)
 * Added snapshots support by passing 2 more arguments to `run` function: `cfg` and `snapshot`.
 * All log statements changed from `info` level to `debug`.

README.md

@@ -21,24 +21,20 @@ However, don't let the simple look fool you - it has a full-fledged interface wi
 
 ## Available Variables and Libraries
 Here are the available variables and libraries that can be used within the context of execution. The most up-to-date list
-can always be found in be used within the context of execution. The most up-to-date list can always be found in code.js
-of the component. Below is a sample for the reference:
-
- - `console` - more on [Node.js console](https://nodejs.org/dist/latest-v5.x/docs/api/console.html)
- - `process` - current Node.js process
- - `require` - module require
- - `setTimeout` - more on [setTimeout](https://nodejs.org/dist/latest-v5.x/docs/api/timers.html)
- - `clearTimeout` - more on [clearTimeout](https://nodejs.org/dist/latest-v5.x/docs/api/timers.html)
- - `setInterval` - more on setInterval
- - `clearInterval` - more on clearInterval
- - `msg` - incoming message containing the payload from the previous step
- - `cfg` - step's configuration. At the moment contains only one property: `code` (the code, being executed)
- - `snapshot` - step's snapshot
- - `exports` - just a plain object `{}`
- - `messages` - utility for convenient message creation
- - `request` - Http Client (wrapped in `co` - [this library](https://www.npmjs.com/package/co-request))
- - `wait` - wait
- - `emitter` user to emit messages and errors
+can always be found in be used within the context of execution or in `code.js` of the component. Below is a sample for the reference.
+Built-in Node.js global objects are also supported.
+
+### Elastic.io Specific Functionality
+- `msg` - incoming message containing the payload from the previous step
+- `cfg` - step's configuration. At the moment contains only one property: `code` (the code, being executed)
+- `snapshot` - step's snapshot
+- `messages` - utility for convenient message creation
+- `emitter` user to emit messages and errors
+
+### Other Libraries/functions
+- `wait(numberOfMilliscondsToSleep)` - Utility function for sleeping
+- [`request`](https://github.com/request/request) - Http Client (wrapped in `co` - [this library](https://www.npmjs.com/package/co-request) so that it is pre-promisified)
+- `_` - [LoDash](https://lodash.com/)
 
 ## Code component usage Examples
 

actions/code.js

@@ -18,20 +18,30 @@ function wait(timeout) {
 // eslint-disable-next-line consistent-return,func-names
 exports.process = async function (msg, conf, snapshot) {
   const ctx = vm.createContext({
-    _,
+    // Node Globals
+    Buffer,
+    clearInterval,
+    clearTimeout,
     console,
+    exports: {},
+    global: {},
+    module: { exports },
     process,
     require,
-    setTimeout,
-    clearTimeout,
     setInterval,
-    clearInterval,
-    msg,
-    exports: {},
+    setTimeout,
+    URL,
+    URLSearchParams,
+
+    // Elasticio Specific Functionality
+    emitter: this,
     messages,
+    msg,
+
+    // Other Libraries
+    _,
     request,
     wait: wait.bind(this),
-    emitter: this,
   });
   this.logger.debug('Running the code %s', conf.code);
   vm.runInContext(conf.code, ctx, {