@aws/lsp-codewhisperer 0.0.5 → 0.0.9

package/node_modules/@aws/lsp-fqn/node_modules/workerpool/src/WorkerHandler.js

@@ -0,0 +1,547 @@
+'use strict';
+
+var {Promise} = require('./Promise');
+var environment = require('./environment');
+const {validateOptions, forkOptsNames, workerThreadOptsNames, workerOptsNames} = require("./validateOptions");
+
+/**
+ * Special message sent by parent which causes a child process worker to terminate itself.
+ * Not a "message object"; this string is the entire message.
+ */
+var TERMINATE_METHOD_ID = '__workerpool-terminate__';
+
+function ensureWorkerThreads() {
+  var WorkerThreads = tryRequireWorkerThreads()
+  if (!WorkerThreads) {
+    throw new Error('WorkerPool: workerType = \'thread\' is not supported, Node >= 11.7.0 required')
+  }
+
+  return WorkerThreads;
+}
+
+// check whether Worker is supported by the browser
+function ensureWebWorker() {
+  // Workaround for a bug in PhantomJS (Or QtWebkit): https://github.com/ariya/phantomjs/issues/14534
+  if (typeof Worker !== 'function' && (typeof Worker !== 'object' || typeof Worker.prototype.constructor !== 'function')) {
+    throw new Error('WorkerPool: Web Workers not supported');
+  }
+}
+
+function tryRequireWorkerThreads() {
+  try {
+    return require('worker_threads');
+  } catch(error) {
+    if (typeof error === 'object' && error !== null && error.code === 'MODULE_NOT_FOUND') {
+      // no worker_threads available (old version of node.js)
+      return null;
+    } else {
+      throw error;
+    }
+  }
+}
+
+// get the default worker script
+function getDefaultWorker() {
+  if (environment.platform === 'browser') {
+    // test whether the browser supports all features that we need
+    if (typeof Blob === 'undefined') {
+      throw new Error('Blob not supported by the browser');
+    }
+    if (!window.URL || typeof window.URL.createObjectURL !== 'function') {
+      throw new Error('URL.createObjectURL not supported by the browser');
+    }
+
+    // use embedded worker.js
+    var blob = new Blob([require('./generated/embeddedWorker')], {type: 'text/javascript'});
+    return window.URL.createObjectURL(blob);
+  }
+  else {
+    // use external worker.js in current directory
+    return __dirname + '/worker.js';
+  }
+}
+
+function setupWorker(script, options) {
+  if (options.workerType === 'web') { // browser only
+    ensureWebWorker();
+    return setupBrowserWorker(script, options.workerOpts, Worker);
+  } else if (options.workerType === 'thread') { // node.js only
+    WorkerThreads = ensureWorkerThreads();
+    return setupWorkerThreadWorker(script, WorkerThreads, options);
+  } else if (options.workerType === 'process' || !options.workerType) { // node.js only
+    return setupProcessWorker(script, resolveForkOptions(options), require('child_process'));
+  } else { // options.workerType === 'auto' or undefined
+    if (environment.platform === 'browser') {
+      ensureWebWorker();
+      return setupBrowserWorker(script, options.workerOpts, Worker);
+    }
+    else { // environment.platform === 'node'
+      var WorkerThreads = tryRequireWorkerThreads();
+      if (WorkerThreads) {
+        return setupWorkerThreadWorker(script, WorkerThreads, options);
+      } else {
+        return setupProcessWorker(script, resolveForkOptions(options), require('child_process'));
+      }
+    }
+  }
+}
+
+function setupBrowserWorker(script, workerOpts, Worker) {
+  // validate the options right before creating the worker (not when creating the pool)
+  validateOptions(workerOpts, workerOptsNames, 'workerOpts')
+
+  // create the web worker
+  var worker = new Worker(script, workerOpts);
+
+  worker.isBrowserWorker = true;
+  // add node.js API to the web worker
+  worker.on = function (event, callback) {
+    this.addEventListener(event, function (message) {
+      callback(message.data);
+    });
+  };
+  worker.send = function (message, transfer) {
+    this.postMessage(message, transfer);
+  };
+  return worker;
+}
+
+function setupWorkerThreadWorker(script, WorkerThreads, options) {
+  // validate the options right before creating the worker thread (not when creating the pool)
+  validateOptions(options?.workerThreadOpts, workerThreadOptsNames, 'workerThreadOpts')
+
+  var worker = new WorkerThreads.Worker(script, {
+    stdout: options?.emitStdStreams ?? false, // pipe worker.STDOUT to process.STDOUT if not requested
+    stderr: options?.emitStdStreams ?? false,  // pipe worker.STDERR to process.STDERR if not requested
+    ...options?.workerThreadOpts
+  });
+  worker.isWorkerThread = true;
+  worker.send = function(message, transfer) {
+    this.postMessage(message, transfer);
+  };
+
+  worker.kill = function() {
+    this.terminate();
+    return true;
+  };
+
+  worker.disconnect = function() {
+    this.terminate();
+  };
+
+  if (options?.emitStdStreams) {
+    worker.stdout.on('data', (data) => worker.emit("stdout", data))
+    worker.stderr.on('data', (data) => worker.emit("stderr", data))
+  }
+
+  return worker;
+}
+
+function setupProcessWorker(script, options, child_process) {
+  // validate the options right before creating the child process (not when creating the pool)
+  validateOptions(options.forkOpts, forkOptsNames, 'forkOpts')
+
+  // no WorkerThreads, fallback to sub-process based workers
+  var worker = child_process.fork(
+    script,
+    options.forkArgs,
+    options.forkOpts
+  );
+
+  // ignore transfer argument since it is not supported by process
+  var send = worker.send;
+  worker.send = function (message) {
+    return send.call(worker, message);
+  };
+
+  if (options.emitStdStreams) {
+    worker.stdout.on('data', (data) => worker.emit("stdout", data))
+    worker.stderr.on('data', (data) => worker.emit("stderr", data))
+  }
+
+  worker.isChildProcess = true;
+  return worker;
+}
+
+// add debug flags to child processes if the node inspector is active
+function resolveForkOptions(opts) {
+  opts = opts || {};
+
+  var processExecArgv = process.execArgv.join(' ');
+  var inspectorActive = processExecArgv.indexOf('--inspect') !== -1;
+  var debugBrk = processExecArgv.indexOf('--debug-brk') !== -1;
+
+  var execArgv = [];
+  if (inspectorActive) {
+    execArgv.push('--inspect=' + opts.debugPort);
+
+    if (debugBrk) {
+      execArgv.push('--debug-brk');
+    }
+  }
+
+  process.execArgv.forEach(function(arg) {
+    if (arg.indexOf('--max-old-space-size') > -1) {
+      execArgv.push(arg)
+    }
+  })
+
+  return Object.assign({}, opts, {
+    forkArgs: opts.forkArgs,
+    forkOpts: Object.assign({}, opts.forkOpts, {
+      execArgv: (opts.forkOpts && opts.forkOpts.execArgv || [])
+      .concat(execArgv),
+      stdio: opts.emitStdStreams ? "pipe": undefined
+    })
+  });
+}
+
+/**
+ * Converts a serialized error to Error
+ * @param {Object} obj Error that has been serialized and parsed to object
+ * @return {Error} The equivalent Error.
+ */
+function objectToError (obj) {
+  var temp = new Error('')
+  var props = Object.keys(obj)
+
+  for (var i = 0; i < props.length; i++) {
+    temp[props[i]] = obj[props[i]]
+  }
+
+  return temp
+}
+
+function handleEmittedStdPayload(handler, payload) {
+  // TODO: refactor if parallel task execution gets added
+  if (Object.keys(handler.processing).length !== 1) {
+    return;
+  }
+  var task = Object.values(handler.processing)[0]
+  if (task.options && typeof task.options.on === 'function') {
+    task.options.on(payload);
+  }
+}
+
+/**
+ * A WorkerHandler controls a single worker. This worker can be a child process
+ * on node.js or a WebWorker in a browser environment.
+ * @param {String} [script] If no script is provided, a default worker with a
+ *                          function run will be created.
+ * @param {import('./types.js').WorkerPoolOptions} [_options] See docs
+ * @constructor
+ */
+function WorkerHandler(script, _options) {
+  var me = this;
+  var options = _options || {};
+
+  this.script = script || getDefaultWorker();
+  this.worker = setupWorker(this.script, options);
+  this.debugPort = options.debugPort;
+  this.forkOpts = options.forkOpts;
+  this.forkArgs = options.forkArgs;
+  this.workerOpts = options.workerOpts;
+  this.workerThreadOpts = options.workerThreadOpts
+  this.workerTerminateTimeout = options.workerTerminateTimeout;
+
+  // The ready message is only sent if the worker.add method is called (And the default script is not used)
+  if (!script) {
+    this.worker.ready = true;
+  }
+
+  // queue for requests that are received before the worker is ready
+  this.requestQueue = [];
+
+  this.worker.on("stdout", function (data) {
+    handleEmittedStdPayload(me, {"stdout": data.toString()})
+  })
+  this.worker.on("stderr", function (data) {
+    handleEmittedStdPayload(me, {"stderr": data.toString()})
+  })
+
+  this.worker.on('message', function (response) {
+    if (me.terminated) {
+      return;
+    }
+    if (typeof response === 'string' && response === 'ready') {
+      me.worker.ready = true;
+      dispatchQueuedRequests();
+    } else {
+      // find the task from the processing queue, and run the tasks callback
+      var id = response.id;
+      var task = me.processing[id];
+      if (task !== undefined) {
+        if (response.isEvent) {
+          if (task.options && typeof task.options.on === 'function') {
+            task.options.on(response.payload);
+          }
+        } else {
+          // remove the task from the queue
+          delete me.processing[id];
+
+          // test if we need to terminate
+          if (me.terminating === true) {
+            // complete worker termination if all tasks are finished
+            me.terminate();
+          }
+
+          // resolve the task's promise
+          if (response.error) {
+            task.resolver.reject(objectToError(response.error));
+          }
+          else {
+            task.resolver.resolve(response.result);
+          }
+        }
+      }
+    }
+  });
+
+  // reject all running tasks on worker error
+  function onError(error) {
+    me.terminated = true;
+
+    for (var id in me.processing) {
+      if (me.processing[id] !== undefined) {
+        me.processing[id].resolver.reject(error);
+      }
+    }
+    me.processing = Object.create(null);
+  }
+
+  // send all queued requests to worker
+  function dispatchQueuedRequests()
+  {
+    for(const request of me.requestQueue.splice(0)) {
+      me.worker.send(request.message, request.transfer);
+    }
+  }
+
+  var worker = this.worker;
+  // listen for worker messages error and exit
+  this.worker.on('error', onError);
+  this.worker.on('exit', function (exitCode, signalCode) {
+    var message = 'Workerpool Worker terminated Unexpectedly\n';
+
+    message += '    exitCode: `' + exitCode + '`\n';
+    message += '    signalCode: `' + signalCode + '`\n';
+
+    message += '    workerpool.script: `' +  me.script + '`\n';
+    message += '    spawnArgs: `' +  worker.spawnargs + '`\n';
+    message += '    spawnfile: `' + worker.spawnfile + '`\n'
+
+    message += '    stdout: `' + worker.stdout + '`\n'
+    message += '    stderr: `' + worker.stderr + '`\n'
+
+    onError(new Error(message));
+  });
+
+  this.processing = Object.create(null); // queue with tasks currently in progress
+
+  this.terminating = false;
+  this.terminated = false;
+  this.cleaning = false;
+  this.terminationHandler = null;
+  this.lastId = 0;
+}
+
+/**
+ * Get a list with methods available on the worker.
+ * @return {Promise.<String[], Error>} methods
+ */
+WorkerHandler.prototype.methods = function () {
+  return this.exec('methods');
+};
+
+/**
+ * Execute a method with given parameters on the worker
+ * @param {String} method
+ * @param {Array} [params]
+ * @param {{resolve: Function, reject: Function}} [resolver]
+ * @param {import('./types.js').ExecOptions}  [options]
+ * @return {Promise.<*, Error>} result
+ */
+WorkerHandler.prototype.exec = function(method, params, resolver, options) {
+  if (!resolver) {
+    resolver = Promise.defer();
+  }
+
+  // generate a unique id for the task
+  var id = ++this.lastId;
+
+  // register a new task as being in progress
+  this.processing[id] = {
+    id: id,
+    resolver: resolver,
+    options: options
+  };
+
+  // build a JSON-RPC request
+  var request = {
+    message: {
+      id: id,
+      method: method,
+      params: params
+    },
+    transfer: options && options.transfer
+  };
+
+  if (this.terminated) {
+    resolver.reject(new Error('Worker is terminated'));
+  } else if (this.worker.ready) {
+    // send the request to the worker
+    this.worker.send(request.message, request.transfer);
+  } else {
+    this.requestQueue.push(request);
+  }
+
+  // on cancellation, force the worker to terminate
+  var me = this;
+  return resolver.promise.catch(function (error) {
+    if (error instanceof Promise.CancellationError || error instanceof Promise.TimeoutError) {
+      // remove this task from the queue. It is already rejected (hence this
+      // catch event), and else it will be rejected again when terminating
+      delete me.processing[id];
+
+      // terminate worker
+      return me.terminateAndNotify(true)
+        .then(function() {
+          throw error;
+        }, function(err) {
+          throw err;
+        });
+    } else {
+      throw error;
+    }
+  })
+};
+
+/**
+ * Test whether the worker is processing any tasks or cleaning up before termination.
+ * @return {boolean} Returns true if the worker is busy
+ */
+WorkerHandler.prototype.busy = function () {
+  return this.cleaning || Object.keys(this.processing).length > 0;
+};
+
+/**
+ * Terminate the worker.
+ * @param {boolean} [force=false]   If false (default), the worker is terminated
+ *                                  after finishing all tasks currently in
+ *                                  progress. If true, the worker will be
+ *                                  terminated immediately.
+ * @param {function} [callback=null] If provided, will be called when process terminates.
+ */
+WorkerHandler.prototype.terminate = function (force, callback) {
+  var me = this;
+  if (force) {
+    // cancel all tasks in progress
+    for (var id in this.processing) {
+      if (this.processing[id] !== undefined) {
+        this.processing[id].resolver.reject(new Error('Worker terminated'));
+      }
+    }
+    this.processing = Object.create(null);
+  }
+
+  if (typeof callback === 'function') {
+    this.terminationHandler = callback;
+  }
+  if (!this.busy()) {
+    // all tasks are finished. kill the worker
+    var cleanup = function(err) {
+      me.terminated = true;
+      me.cleaning = false;
+      if (me.worker != null && me.worker.removeAllListeners) {
+        // removeAllListeners is only available for child_process
+        me.worker.removeAllListeners('message');
+      }
+      me.worker = null;
+      me.terminating = false;
+      if (me.terminationHandler) {
+        me.terminationHandler(err, me);
+      } else if (err) {
+        throw err;
+      }
+    }
+
+    if (this.worker) {
+      if (typeof this.worker.kill === 'function') {
+        if (this.worker.killed) {
+          cleanup(new Error('worker already killed!'));
+          return;
+        }
+
+        // child process and worker threads
+        var cleanExitTimeout = setTimeout(function() {
+          if (me.worker) {
+            me.worker.kill();
+          }
+        }, this.workerTerminateTimeout);
+
+        this.worker.once('exit', function() {
+          clearTimeout(cleanExitTimeout);
+          if (me.worker) {
+            me.worker.killed = true;
+          }
+          cleanup();
+        });
+
+        if (this.worker.ready) {
+          this.worker.send(TERMINATE_METHOD_ID);
+        } else {
+          this.requestQueue.push({ message: TERMINATE_METHOD_ID });
+        }
+
+        // mark that the worker is cleaning up resources
+        // to prevent new tasks from being executed
+        this.cleaning = true;
+        return;
+      }
+      else if (typeof this.worker.terminate === 'function') {
+        this.worker.terminate(); // web worker
+        this.worker.killed = true;
+      }
+      else {
+        throw new Error('Failed to terminate worker');
+      }
+    }
+    cleanup();
+  }
+  else {
+    // we can't terminate immediately, there are still tasks being executed
+    this.terminating = true;
+  }
+};
+
+/**
+ * Terminate the worker, returning a Promise that resolves when the termination has been done.
+ * @param {boolean} [force=false]   If false (default), the worker is terminated
+ *                                  after finishing all tasks currently in
+ *                                  progress. If true, the worker will be
+ *                                  terminated immediately.
+ * @param {number} [timeout]        If provided and non-zero, worker termination promise will be rejected
+ *                                  after timeout if worker process has not been terminated.
+ * @return {Promise.<WorkerHandler, Error>}
+ */
+WorkerHandler.prototype.terminateAndNotify = function (force, timeout) {
+  var resolver = Promise.defer();
+  if (timeout) {
+    resolver.promise.timeout(timeout);
+  }
+  this.terminate(force, function(err, worker) {
+    if (err) {
+      resolver.reject(err);
+    } else {
+      resolver.resolve(worker);
+    }
+  });
+  return resolver.promise;
+};
+
+module.exports = WorkerHandler;
+module.exports._tryRequireWorkerThreads = tryRequireWorkerThreads;
+module.exports._setupProcessWorker = setupProcessWorker;
+module.exports._setupBrowserWorker = setupBrowserWorker;
+module.exports._setupWorkerThreadWorker = setupWorkerThreadWorker;
+module.exports.ensureWorkerThreads = ensureWorkerThreads;

package/node_modules/@aws/lsp-fqn/node_modules/workerpool/src/debug-port-allocator.js

@@ -0,0 +1,28 @@
+'use strict';
+
+var MAX_PORTS = 65535;
+module.exports = DebugPortAllocator;
+function DebugPortAllocator() {
+  this.ports = Object.create(null);
+  this.length = 0;
+}
+
+DebugPortAllocator.prototype.nextAvailableStartingAt = function(starting) {
+  while (this.ports[starting] === true) {
+    starting++;
+  }
+
+  if (starting >= MAX_PORTS) {
+    throw new Error('WorkerPool debug port limit reached: ' + starting + '>= ' + MAX_PORTS );
+  }
+
+  this.ports[starting] = true;
+  this.length++;
+  return starting;
+};
+
+DebugPortAllocator.prototype.releasePort = function(port) {
+  delete this.ports[port];
+  this.length--;
+};
+

package/node_modules/@aws/lsp-fqn/node_modules/workerpool/src/environment.js

@@ -0,0 +1,30 @@
+
+// source: https://github.com/flexdinesh/browser-or-node
+// source: https://github.com/mozilla/pdf.js/blob/7ea0e40e588864cd938d1836ec61f1928d3877d3/src/shared/util.js#L24
+var isNode = function (nodeProcess) {
+  return (
+    typeof nodeProcess !== 'undefined' &&
+    nodeProcess.versions != null &&
+    nodeProcess.versions.node != null &&
+    nodeProcess + '' === '[object process]'
+  );
+}
+module.exports.isNode = isNode
+
+// determines the JavaScript platform: browser or node
+module.exports.platform = typeof process !== 'undefined' && isNode(process)
+  ? 'node'
+  : 'browser';
+
+// determines whether the code is running in main thread or not
+// note that in node.js we have to check both worker_thread and child_process
+var worker_threads = module.exports.platform === 'node' && require('worker_threads');
+module.exports.isMainThread = module.exports.platform === 'node'
+  ? ((!worker_threads || worker_threads.isMainThread) && !process.connected)
+  : typeof Window !== 'undefined';
+
+// determines the number of cpus available
+module.exports.cpus = module.exports.platform === 'browser'
+  ? self.navigator.hardwareConcurrency
+  : require('os').cpus().length;
+

package/node_modules/@aws/lsp-fqn/node_modules/workerpool/src/generated/embeddedWorker.js

@@ -0,0 +1,6 @@
+/**
+ * embeddedWorker.js contains an embedded version of worker.js.
+ * This file is automatically generated,
+ * changes made in this file will be overwritten.
+ */
+module.exports = "!function(e,n){\"object\"==typeof exports&&\"undefined\"!=typeof module?module.exports=n():\"function\"==typeof define&&define.amd?define(n):(e=\"undefined\"!=typeof globalThis?globalThis:e||self).worker=n()}(this,(function(){\"use strict\";function e(e){return e&&e.__esModule&&Object.prototype.hasOwnProperty.call(e,\"default\")?e.default:e}var n={};var t=function(e,n){this.message=e,this.transfer=n};return function(e){var n=t,r={exit:function(){}};if(\"undefined\"!=typeof self&&\"function\"==typeof postMessage&&\"function\"==typeof addEventListener)r.on=function(e,n){addEventListener(e,(function(e){n(e.data)}))},r.send=function(e){postMessage(e)};else{if(\"undefined\"==typeof process)throw new Error(\"Script must be executed as a worker\");var o;try{o=require(\"worker_threads\")}catch(e){if(\"object\"!=typeof e||null===e||\"MODULE_NOT_FOUND\"!==e.code)throw e}if(o&&null!==o.parentPort){var i=o.parentPort;r.send=i.postMessage.bind(i),r.on=i.on.bind(i),r.exit=process.exit.bind(process)}else r.on=process.on.bind(process),r.send=function(e){process.send(e)},r.on(\"disconnect\",(function(){process.exit(1)})),r.exit=process.exit.bind(process)}function s(e){return Object.getOwnPropertyNames(e).reduce((function(n,t){return Object.defineProperty(n,t,{value:e[t],enumerable:!0})}),{})}function d(e){return e&&\"function\"==typeof e.then&&\"function\"==typeof e.catch}r.methods={},r.methods.run=function(e,n){var t=new Function(\"return (\"+e+\").apply(null, arguments);\");return t.apply(t,n)},r.methods.methods=function(){return Object.keys(r.methods)},r.terminationHandler=void 0,r.cleanupAndExit=function(e){var n=function(){r.exit(e)};if(!r.terminationHandler)return n();var t=r.terminationHandler(e);d(t)?t.then(n,n):n()};var u=null;r.on(\"message\",(function(e){if(\"__workerpool-terminate__\"===e)return r.cleanupAndExit(0);try{var t=r.methods[e.method];if(!t)throw new Error('Unknown method \"'+e.method+'\"');u=e.id;var o=t.apply(t,e.params);d(o)?o.then((function(t){t instanceof n?r.send({id:e.id,result:t.message,error:null},t.transfer):r.send({id:e.id,result:t,error:null}),u=null})).catch((function(n){r.send({id:e.id,result:null,error:s(n)}),u=null})):(o instanceof n?r.send({id:e.id,result:o.message,error:null},o.transfer):r.send({id:e.id,result:o,error:null}),u=null)}catch(n){r.send({id:e.id,result:null,error:s(n)})}})),r.register=function(e,n){if(e)for(var t in e)e.hasOwnProperty(t)&&(r.methods[t]=e[t]);n&&(r.terminationHandler=n.onTerminate),r.send(\"ready\")},r.emit=function(e){if(u){if(e instanceof n)return void r.send({id:u,isEvent:!0,payload:e.message},e.transfer);r.send({id:u,isEvent:!0,payload:e})}},e.add=r.register,e.emit=r.emit}(n),e(n)}));\n//# sourceMappingURL=worker.min.js.map\n";

package/node_modules/@aws/lsp-fqn/node_modules/workerpool/src/header.js

@@ -0,0 +1,24 @@
+/**
+ * workerpool.js
+ * https://github.com/josdejong/workerpool
+ *
+ * Offload tasks to a pool of workers on node.js and in the browser.
+ *
+ * @version @@version
+ * @date    @@date
+ *
+ * @license
+ * Copyright (C) 2014-2022 Jos de Jong <wjosdejong@gmail.com>
+ *
+ * Licensed 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 CONDITIONS OF ANY KIND, either express or implied. See the
+ * License for the specific language governing permissions and limitations under
+ * the License.
+ */

package/node_modules/@aws/lsp-fqn/node_modules/workerpool/src/index.js

@@ -0,0 +1,60 @@
+const {platform, isMainThread, cpus} = require('./environment');
+
+/** @typedef {import("./Pool")} Pool */
+/** @typedef {import("./types.js").WorkerPoolOptions} WorkerPoolOptions */
+/** @typedef {import("./types.js").WorkerRegisterOptions} WorkerRegisterOptions */
+
+/**
+ * @template { { [k: string]: (...args: any[]) => any } } T
+ * @typedef {import('./types.js').Proxy<T>} Proxy<T>
+ */
+
+/**
+ * @overload
+ * Create a new worker pool
+ * @param {WorkerPoolOptions} [script]
+ * @returns {Pool} pool
+ */
+/**
+ * @overload
+ * Create a new worker pool
+ * @param {string} [script]
+ * @param {WorkerPoolOptions} [options]
+ * @returns {Pool} pool
+ */
+function pool(script, options) {
+  var Pool = require('./Pool');
+
+  return new Pool(script, options);
+};
+exports.pool = pool;
+
+/**
+ * Create a worker and optionally register a set of methods to the worker.
+ * @param {{ [k: string]: (...args: any[]) => any }} [methods]
+ * @param {WorkerRegisterOptions} [options]
+ */
+function worker(methods, options) {
+  var worker = require('./worker');
+  worker.add(methods, options);
+};
+exports.worker = worker;
+
+/**
+ * Sends an event to the parent worker pool.
+ * @param {any} payload 
+ */
+function workerEmit(payload) {
+  var worker = require('./worker');
+  worker.emit(payload);
+};
+exports.workerEmit = workerEmit;
+
+const {Promise} = require('./Promise');
+exports.Promise = Promise;
+
+exports.Transfer = require('./transfer');
+
+exports.platform = platform;
+exports.isMainThread = isMainThread;
+exports.cpus = cpus;