particle-api-js 10.0.0 → 10.2.0

package/lib/Agent.js

@@ -1,615 +0,0 @@
-'use strict';
-
-Object.defineProperty(exports, "__esModule", {
-	value: true
-});
-
-var _keys = require('babel-runtime/core-js/object/keys');
-
-var _keys2 = _interopRequireDefault(_keys);
-
-var _slicedToArray2 = require('babel-runtime/helpers/slicedToArray');
-
-var _slicedToArray3 = _interopRequireDefault(_slicedToArray2);
-
-var _entries = require('babel-runtime/core-js/object/entries');
-
-var _entries2 = _interopRequireDefault(_entries);
-
-var _getIterator2 = require('babel-runtime/core-js/get-iterator');
-
-var _getIterator3 = _interopRequireDefault(_getIterator2);
-
-var _stringify = require('babel-runtime/core-js/json/stringify');
-
-var _stringify2 = _interopRequireDefault(_stringify);
-
-var _assign = require('babel-runtime/core-js/object/assign');
-
-var _assign2 = _interopRequireDefault(_assign);
-
-var _toConsumableArray2 = require('babel-runtime/helpers/toConsumableArray');
-
-var _toConsumableArray3 = _interopRequireDefault(_toConsumableArray2);
-
-var _classCallCheck2 = require('babel-runtime/helpers/classCallCheck');
-
-var _classCallCheck3 = _interopRequireDefault(_classCallCheck2);
-
-var _createClass2 = require('babel-runtime/helpers/createClass');
-
-var _createClass3 = _interopRequireDefault(_createClass2);
-
-var _nodeFetch = require('node-fetch');
-
-var _nodeFetch2 = _interopRequireDefault(_nodeFetch);
-
-var _formData = require('form-data');
-
-var _formData2 = _interopRequireDefault(_formData);
-
-var _qs = require('qs');
-
-var _qs2 = _interopRequireDefault(_qs);
-
-var _fs = require('../fs');
-
-var _fs2 = _interopRequireDefault(_fs);
-
-var _package = require('../package.json');
-
-var _package2 = _interopRequireDefault(_package);
-
-function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
-
-/**
- * The object returned for a basic request
- * @typedef {object} JSONResponse
- * @property {number} statusCode	The HTTP response status
- * @property {object} body		The endpoint's response parsed as a JSON
- */
-
-/**
- * The possible response from an API request
- * @typedef {JSONResponse|Buffer|arrayBuffer} RequestResponse	The type is based on
- * the request config and whether is on browser or node
- */
-
-/**
- * The error object generated in case of a failed request
- * @typedef {object} RequestError
- * @property {number} statusCode	The HTTP response status
- * @property {string} errorDescription	Details on what caused the failed request
- * @property {string} shortErrorDescription	Summarized version of the fail reason
- * @property {object} body		The response object from the request
- * @property {object} error		The error object from the request
- */
-
-var Agent = function () {
-	function Agent(baseUrl) {
-		(0, _classCallCheck3.default)(this, Agent);
-
-		this.setBaseUrl(baseUrl);
-	}
-
-	(0, _createClass3.default)(Agent, [{
-		key: 'setBaseUrl',
-		value: function setBaseUrl(baseUrl) {
-			this.baseUrl = baseUrl;
-		}
-
-		/**
-   * Make a GET request
-   * @param {string} uri		The URI to request
-   * @param {string} [auth]	Authorization token to use
-   * @param {object} [headers]	Key/Value pairs like `{ 'X-FOO': 'foo', X-BAR: 'bar' }` to send as headers.
-   * @param {object} [query] Key/Value pairs of query params
-   * @param {object} [context]	The invocation context, describing the tool and project
-   * @returns {Promise<RequestResponse, RequestError>} A promise that resolves with either the requested data or an error object
-   */
-
-	}, {
-		key: 'get',
-		value: function get(_ref) {
-			var uri = _ref.uri,
-			    auth = _ref.auth,
-			    headers = _ref.headers,
-			    query = _ref.query,
-			    context = _ref.context;
-
-			return this.request({ uri: uri, method: 'get', auth: auth, headers: headers, query: query, context: context });
-		}
-
-		/**
-   * Make a HEAD request
-   * @param {string} uri		The URI to request
-   * @param {string} [auth]	Authorization token to use
-   * @param {object} [headers]	Key/Value pairs like `{ 'X-FOO': 'foo', X-BAR: 'bar' }` to send as headers.
-   * @param {object} [query] Key/Value pairs of query params
-   * @param {object} [context]	The invocation context, describing the tool and project
-   * @returns {Promise<RequestResponse, RequestError>} A promise that resolves with either the requested data or an error object
-   */
-
-	}, {
-		key: 'head',
-		value: function head(_ref2) {
-			var uri = _ref2.uri,
-			    auth = _ref2.auth,
-			    headers = _ref2.headers,
-			    query = _ref2.query,
-			    context = _ref2.context;
-
-			return this.request({ uri: uri, method: 'head', auth: auth, headers: headers, query: query, context: context });
-		}
-
-		/**
-   * Make a POST request
-   * @param {string} uri		The URI to request
-   * @param {string} [auth]	Authorization token to use
-   * @param {object} [headers]	Key/Value pairs like `{ 'X-FOO': 'foo', X-BAR: 'bar' }` to send as headers.
-   * @param {object} [data] Payload to send in the request body in JSON format
-   * @param {object} [context]	The invocation context, describing the tool and project
-   * @returns {Promise<RequestResponse, RequestError>} A promise that resolves with either the requested data or an error object
-   */
-
-	}, {
-		key: 'post',
-		value: function post(_ref3) {
-			var uri = _ref3.uri,
-			    headers = _ref3.headers,
-			    data = _ref3.data,
-			    auth = _ref3.auth,
-			    context = _ref3.context;
-
-			return this.request({ uri: uri, method: 'post', auth: auth, headers: headers, data: data, context: context });
-		}
-
-		/**
-   * Make a PUT request
-   * @param {string} uri		The URI to request
-   * @param {string} [auth]	Authorization token to use
-   * @param {object} [headers]	Key/Value pairs like `{ 'X-FOO': 'foo', X-BAR: 'bar' }` to send as headers.
-   * @param {object} [data] Payload to send in the request body in JSON format
-   * @param {object} [context]	The invocation context, describing the tool and project
-   * @returns {Promise<RequestResponse, RequestError>} A promise that resolves with either the requested data or an error object
-   */
-
-	}, {
-		key: 'put',
-		value: function put(_ref4) {
-			var uri = _ref4.uri,
-			    auth = _ref4.auth,
-			    headers = _ref4.headers,
-			    data = _ref4.data,
-			    context = _ref4.context;
-
-			return this.request({ uri: uri, method: 'put', auth: auth, headers: headers, data: data, context: context });
-		}
-
-		/**
-   * Make a DELETE request
-   * @param {string} uri		The URI to request
-   * @param {string} [auth]	Authorization token to use
-   * @param {object} [headers]	Key/Value pairs like `{ 'X-FOO': 'foo', X-BAR: 'bar' }` to send as headers.
-   * @param {object} [data] Payload to send in the request body in JSON format
-   * @param {object} [context]	The invocation context, describing the tool and project
-   * @returns {Promise<RequestResponse, RequestError>} A promise that resolves with either the requested data or an error object
-   */
-
-	}, {
-		key: 'delete',
-		value: function _delete(_ref5) {
-			var uri = _ref5.uri,
-			    auth = _ref5.auth,
-			    headers = _ref5.headers,
-			    data = _ref5.data,
-			    context = _ref5.context;
-
-			return this.request({ uri: uri, method: 'delete', auth: auth, headers: headers, data: data, context: context });
-		}
-
-		/**
-   *
-   * @param {Object} config		An obj with all the possible request configurations
-   * @param {String} config.uri		The URI to request
-   * @param {String} config.method        The method used to request the URI, should be in uppercase.
-   * @param {Object} config.headers       Key/Value pairs like `{ 'X-FOO': 'foo', X-BAR: 'bar' }` to send as headers.
-   * @param {Object} config.data          Arbitrary data to send as the body.
-   * @param {Object} config.auth          Authorization
-   * @param {String} config.query         Query parameters
-   * @param {Object} config.form          Form fields
-   * @param {Object} config.files         array of file names and file content
-   * @param {Object} config.context       the invocation context, describing the tool and project.
-   * @param {boolean} config.isBuffer	Indicate if the response should be treated as Buffer instead of JSON
-   * @returns {Promise<RequestResponse, RequestError>} A promise that resolves with either the requested data or an error object
-   */
-
-	}, {
-		key: 'request',
-		value: function request(_ref6) {
-			var uri = _ref6.uri,
-			    method = _ref6.method,
-			    _ref6$headers = _ref6.headers,
-			    headers = _ref6$headers === undefined ? undefined : _ref6$headers,
-			    _ref6$data = _ref6.data,
-			    data = _ref6$data === undefined ? undefined : _ref6$data,
-			    auth = _ref6.auth,
-			    _ref6$query = _ref6.query,
-			    query = _ref6$query === undefined ? undefined : _ref6$query,
-			    _ref6$form = _ref6.form,
-			    form = _ref6$form === undefined ? undefined : _ref6$form,
-			    _ref6$files = _ref6.files,
-			    files = _ref6$files === undefined ? undefined : _ref6$files,
-			    _ref6$context = _ref6.context,
-			    context = _ref6$context === undefined ? undefined : _ref6$context,
-			    _ref6$isBuffer = _ref6.isBuffer,
-			    isBuffer = _ref6$isBuffer === undefined ? false : _ref6$isBuffer;
-
-			var requestFiles = this._sanitizeFiles(files);
-			var requestParams = this._buildRequest({ uri: uri, method: method, headers: headers, data: data, auth: auth, query: query, form: form, context: context, files: requestFiles });
-			return this._promiseResponse(requestParams, isBuffer);
-		}
-
-		/**
-   * Promises to send the request and retreive the response.
-   * @param {[string, object]} requestParams	First argument is the URI to request, the second one are the options.
-   * @param {boolean} isBuffer Indicate if the response body should be returned as a Buffer (Node) / ArrayBuffer (browser) instead of JSON
-   * @param {Fetch} [makerequest] The fetch function to use. Override for testing.
-   * @returns {Promise<RequestResponse, RequestError>} A promise that resolves with either the requested data or an error object
-   * @private
-   */
-
-	}, {
-		key: '_promiseResponse',
-		value: function _promiseResponse(requestParams, isBuffer) {
-			var _this = this;
-
-			var makerequest = arguments.length > 2 && arguments[2] !== undefined ? arguments[2] : _nodeFetch2.default;
-
-			var status = void 0;
-			return makerequest.apply(undefined, (0, _toConsumableArray3.default)(requestParams)).then(function (resp) {
-				status = resp.status;
-				if (!resp.ok) {
-					return resp.text().then(function (err) {
-						var objError = JSON.parse(err);
-						// particle-commnds/src/cmd/api expects response.text. to be a string
-						var response = (0, _assign2.default)(resp, { text: err });
-						throw (0, _assign2.default)(objError, { response: response });
-					});
-				}
-				if (status === 204) {
-					// Can't do resp.json() since there is no body to parse
-					return '';
-				}
-				if (isBuffer) {
-					return resp.blob();
-				}
-				return resp.json();
-			}).then(function (body) {
-				if (isBuffer) {
-					return body.arrayBuffer().then(function (arrayBuffer) {
-						if (!_this.isForBrowser()) {
-							return Buffer.from(arrayBuffer);
-						}
-						return arrayBuffer;
-					});
-				}
-				return {
-					body: body,
-					statusCode: status
-				};
-			}).catch(function (error) {
-				var errorType = status ? 'HTTP error ' + status : 'Network error';
-				var errorDescription = errorType + ' from ' + requestParams[0];
-				var shortErrorDescription = void 0;
-				if (error.error_description) {
-					// Fetch responded with ok false
-					errorDescription = errorDescription + ' - ' + error.error_description;
-					shortErrorDescription = error.error_description;
-				}
-				var reason = new Error(errorDescription);
-				(0, _assign2.default)(reason, {
-					statusCode: status,
-					errorDescription: errorDescription,
-					shortErrorDescription: shortErrorDescription,
-					error: error,
-					body: error
-				});
-				throw reason;
-			});
-		}
-	}, {
-		key: '_buildRequest',
-		value: function _buildRequest(_ref7) {
-			var uri = _ref7.uri,
-			    method = _ref7.method,
-			    headers = _ref7.headers,
-			    data = _ref7.data,
-			    auth = _ref7.auth,
-			    query = _ref7.query,
-			    form = _ref7.form,
-			    files = _ref7.files,
-			    context = _ref7.context;
-
-			var actualUri = uri;
-			if (this.baseUrl && uri[0] === '/') {
-				actualUri = '' + this.baseUrl + uri;
-			}
-			if (query) {
-				var queryParams = _qs2.default.stringify(query);
-				var hasParams = actualUri.includes('?');
-				actualUri = '' + actualUri + (hasParams ? '&' : '?') + queryParams;
-			}
-
-			var userAgentHeader = { 'User-Agent': _package2.default.name + '/' + _package2.default.version + ' (' + _package2.default.repository.url + ')' };
-			var body = void 0;
-			var contentTypeHeader = void 0;
-			if (files) {
-				contentTypeHeader = {}; // Needed to allow fetch create its own
-				body = this._getFromData(files, form);
-			} else if (form) {
-				contentTypeHeader = { 'Content-Type': 'application/x-www-form-urlencoded' };
-				body = _qs2.default.stringify(form);
-			} else if (data) {
-				contentTypeHeader = { 'Content-Type': 'application/json' };
-				body = (0, _stringify2.default)(data);
-			}
-			var finalHeaders = (0, _assign2.default)({}, userAgentHeader, contentTypeHeader, this._getAuthorizationHeader(auth), this._getContextHeaders(context), headers);
-
-			return [actualUri, { method: method, body: body, headers: finalHeaders }];
-		}
-	}, {
-		key: 'isForBrowser',
-		value: function isForBrowser() {
-			return typeof window !== 'undefined';
-		}
-	}, {
-		key: '_getFromData',
-		value: function _getFromData(files, form) {
-			var formData = new _formData2.default();
-			var _iteratorNormalCompletion = true;
-			var _didIteratorError = false;
-			var _iteratorError = undefined;
-
-			try {
-				for (var _iterator = (0, _getIterator3.default)((0, _entries2.default)(files)), _step; !(_iteratorNormalCompletion = (_step = _iterator.next()).done); _iteratorNormalCompletion = true) {
-					var _step$value = (0, _slicedToArray3.default)(_step.value, 2),
-					    name = _step$value[0],
-					    file = _step$value[1];
-
-					var path = file.path;
-					var fileData = file.data;
-					if (!this.isForBrowser()) {
-						var nodeFormData = this._getNodeFormData(file);
-						path = nodeFormData.path;
-						fileData = nodeFormData.file;
-					}
-					formData.append(name, fileData, path);
-				}
-			} catch (err) {
-				_didIteratorError = true;
-				_iteratorError = err;
-			} finally {
-				try {
-					if (!_iteratorNormalCompletion && _iterator.return) {
-						_iterator.return();
-					}
-				} finally {
-					if (_didIteratorError) {
-						throw _iteratorError;
-					}
-				}
-			}
-
-			if (form) {
-				var _iteratorNormalCompletion2 = true;
-				var _didIteratorError2 = false;
-				var _iteratorError2 = undefined;
-
-				try {
-					for (var _iterator2 = (0, _getIterator3.default)((0, _entries2.default)(form)), _step2; !(_iteratorNormalCompletion2 = (_step2 = _iterator2.next()).done); _iteratorNormalCompletion2 = true) {
-						var _step2$value = (0, _slicedToArray3.default)(_step2.value, 2),
-						    name = _step2$value[0],
-						    value = _step2$value[1];
-
-						formData.append(name, value);
-					}
-				} catch (err) {
-					_didIteratorError2 = true;
-					_iteratorError2 = err;
-				} finally {
-					try {
-						if (!_iteratorNormalCompletion2 && _iterator2.return) {
-							_iterator2.return();
-						}
-					} finally {
-						if (_didIteratorError2) {
-							throw _iteratorError2;
-						}
-					}
-				}
-			}
-			return formData;
-		}
-	}, {
-		key: '_getNodeFormData',
-		value: function _getNodeFormData(file) {
-			var fileData = file.data;
-			if (typeof file.data === 'string') {
-				fileData = _fs2.default.createReadStream(file.data);
-			}
-			return {
-				file: fileData,
-				path: { filepath: file.path // Different API for nodejs
-				} };
-		}
-	}, {
-		key: '_getContextHeaders',
-		value: function _getContextHeaders() {
-			var context = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : {};
-
-			return (0, _assign2.default)({}, this._getToolContext(context.tool), this._getProjectContext(context.project));
-		}
-	}, {
-		key: '_getToolContext',
-		value: function _getToolContext() {
-			var tool = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : {};
-
-			var value = '';
-			if (tool.name) {
-				value += this._toolIdent(tool);
-				if (tool.components) {
-					var _iteratorNormalCompletion3 = true;
-					var _didIteratorError3 = false;
-					var _iteratorError3 = undefined;
-
-					try {
-						for (var _iterator3 = (0, _getIterator3.default)(tool.components), _step3; !(_iteratorNormalCompletion3 = (_step3 = _iterator3.next()).done); _iteratorNormalCompletion3 = true) {
-							var component = _step3.value;
-
-							value += ', ' + this._toolIdent(component);
-						}
-					} catch (err) {
-						_didIteratorError3 = true;
-						_iteratorError3 = err;
-					} finally {
-						try {
-							if (!_iteratorNormalCompletion3 && _iterator3.return) {
-								_iterator3.return();
-							}
-						} finally {
-							if (_didIteratorError3) {
-								throw _iteratorError3;
-							}
-						}
-					}
-				}
-			}
-			if (value) {
-				return { 'X-Particle-Tool': value };
-			}
-			return {};
-		}
-	}, {
-		key: '_toolIdent',
-		value: function _toolIdent(tool) {
-			return this._nameAtVersion(tool.name, tool.version);
-		}
-	}, {
-		key: '_nameAtVersion',
-		value: function _nameAtVersion(name, version) {
-			var value = '';
-			if (name) {
-				value += name;
-				if (version) {
-					value += '@' + version;
-				}
-			}
-			return value;
-		}
-	}, {
-		key: '_getProjectContext',
-		value: function _getProjectContext() {
-			var project = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : {};
-
-			var value = this._buildSemicolonSeparatedProperties(project, 'name');
-			if (value) {
-				return { 'X-Particle-Project': value };
-			}
-			return {};
-		}
-
-		/**
-   * Creates a string like primaryPropertyValue; name=value; name1=value
-   * from the properties of an object.
-   * @param {object} obj               The object to create the string from
-   * @param {string} primaryProperty   The name of the primary property which is the default value and must be defined.
-   * @private
-   * @return {string} The formatted string representing the object properties and the default property.
-   */
-
-	}, {
-		key: '_buildSemicolonSeparatedProperties',
-		value: function _buildSemicolonSeparatedProperties(obj, primaryProperty) {
-			var value = '';
-			if (obj[primaryProperty]) {
-				value += obj[primaryProperty];
-				for (var prop in obj) {
-					if (prop !== primaryProperty && obj.hasOwnProperty(prop)) {
-						value += '; ' + prop + '=' + obj[prop];
-					}
-				}
-			}
-			return value;
-		}
-
-		/**
-   * Adds an authorization header.
-   * @param {string}  auth    The authorization bearer token.
-   * @returns {object} The original request.
-   */
-
-	}, {
-		key: '_getAuthorizationHeader',
-		value: function _getAuthorizationHeader(auth) {
-			if (!auth) {
-				return {};
-			}
-			if (typeof auth === 'string') {
-				return { Authorization: 'Bearer ' + auth };
-			}
-			var encoded = void 0;
-			if (this.isForBrowser()) {
-				encoded = btoa(auth.username + ':' + auth.password);
-			} else {
-				encoded = Buffer.from(auth.username + ':' + auth.password).toString('base64');
-			}
-			return { Authorization: 'Basic ' + encoded };
-		}
-
-		/**
-   *
-   * @param {Object} files converts the file names to file, file1, file2.
-   * @returns {object} the renamed files.
-   */
-
-	}, {
-		key: '_sanitizeFiles',
-		value: function _sanitizeFiles(files) {
-			var requestFiles = void 0;
-			if (files) {
-				requestFiles = {};
-				(0, _keys2.default)(files).forEach(function (k, i) {
-					var name = i ? 'file' + (i + 1) : 'file';
-					requestFiles[name] = {
-						data: files[k],
-						path: k
-					};
-				});
-			}
-			return requestFiles;
-		}
-	}]);
-	return Agent;
-}(); /*
-      ******************************************************************************
-      Copyright (c) 2016 Particle Industries, Inc.  All rights reserved.
-     
-      This program is free software; you can redistribute it and/or
-      modify it under the terms of the GNU Lesser General Public
-      License as published by the Free Software Foundation, either
-      version 3 of the License, or (at your option) any later version.
-     
-      This program is distributed in the hope that it will be useful,
-      but WITHOUT ANY WARRANTY; without even the implied warranty of
-      MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
-      Lesser General Public License for more details.
-     
-      You should have received a copy of the GNU Lesser General Public
-      License along with this program; if not, see <http://www.gnu.org/licenses/>.
-      ******************************************************************************
-      */
-
-exports.default = Agent;
-module.exports = exports['default'];
-//# sourceMappingURL=Agent.js.map

package/lib/Agent.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/Agent.js"],"names":["Agent","baseUrl","setBaseUrl","uri","auth","headers","query","context","request","method","data","undefined","form","files","isBuffer","requestFiles","_sanitizeFiles","requestParams","_buildRequest","_promiseResponse","makerequest","status","then","resp","ok","text","err","objError","JSON","parse","response","blob","json","body","arrayBuffer","isForBrowser","Buffer","from","statusCode","catch","error","errorType","errorDescription","shortErrorDescription","error_description","reason","Error","actualUri","queryParams","stringify","hasParams","includes","userAgentHeader","name","version","repository","url","contentTypeHeader","_getFromData","finalHeaders","_getAuthorizationHeader","_getContextHeaders","window","formData","file","path","fileData","nodeFormData","_getNodeFormData","append","value","createReadStream","filepath","_getToolContext","tool","_getProjectContext","project","_toolIdent","components","component","_nameAtVersion","_buildSemicolonSeparatedProperties","obj","primaryProperty","prop","hasOwnProperty","Authorization","encoded","btoa","username","password","toString","forEach","k","i"],"mappings":"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","file":"Agent.js","sourcesContent":["/*\n ******************************************************************************\n Copyright (c) 2016 Particle Industries, Inc.  All rights reserved.\n\n This program is free software; you can redistribute it and/or\n modify it under the terms of the GNU Lesser General Public\n License as published by the Free Software Foundation, either\n version 3 of the License, or (at your option) any later version.\n\n This program is distributed in the hope that it will be useful,\n but WITHOUT ANY WARRANTY; without even the implied warranty of\n MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU\n Lesser General Public License for more details.\n\n You should have received a copy of the GNU Lesser General Public\n License along with this program; if not, see <http://www.gnu.org/licenses/>.\n ******************************************************************************\n */\n\nimport fetch from 'node-fetch';\nimport FormData from 'form-data';\nimport qs from 'qs';\nimport fs from '../fs';\nimport packageJson from '../package.json';\n\n/**\n * The object returned for a basic request\n * @typedef {object} JSONResponse\n * @property {number} statusCode\tThe HTTP response status\n * @property {object} body\t\tThe endpoint's response parsed as a JSON\n */\n\n/**\n * The possible response from an API request\n * @typedef {JSONResponse|Buffer|arrayBuffer} RequestResponse\tThe type is based on\n * the request config and whether is on browser or node\n */\n\n/**\n * The error object generated in case of a failed request\n * @typedef {object} RequestError\n * @property {number} statusCode\tThe HTTP response status\n * @property {string} errorDescription\tDetails on what caused the failed request\n * @property {string} shortErrorDescription\tSummarized version of the fail reason\n * @property {object} body\t\tThe response object from the request\n * @property {object} error\t\tThe error object from the request\n */\n\nexport default class Agent {\n\tconstructor(baseUrl){\n\t\tthis.setBaseUrl(baseUrl);\n\t}\n\n\tsetBaseUrl(baseUrl) {\n\t\tthis.baseUrl = baseUrl;\n\t}\n\n\t/**\n\t * Make a GET request\n\t * @param {string} uri\t\tThe URI to request\n\t * @param {string} [auth]\tAuthorization token to use\n\t * @param {object} [headers]\tKey/Value pairs like `{ 'X-FOO': 'foo', X-BAR: 'bar' }` to send as headers.\n\t * @param {object} [query] Key/Value pairs of query params\n\t * @param {object} [context]\tThe invocation context, describing the tool and project\n\t * @returns {Promise<RequestResponse, RequestError>} A promise that resolves with either the requested data or an error object\n\t */\n\tget({ uri, auth, headers, query, context }) {\n\t\treturn this.request({ uri, method: 'get', auth, headers, query, context });\n\t}\n\n\t/**\n\t * Make a HEAD request\n\t * @param {string} uri\t\tThe URI to request\n\t * @param {string} [auth]\tAuthorization token to use\n\t * @param {object} [headers]\tKey/Value pairs like `{ 'X-FOO': 'foo', X-BAR: 'bar' }` to send as headers.\n\t * @param {object} [query] Key/Value pairs of query params\n\t * @param {object} [context]\tThe invocation context, describing the tool and project\n\t * @returns {Promise<RequestResponse, RequestError>} A promise that resolves with either the requested data or an error object\n\t */\n\thead({ uri, auth, headers, query, context }) {\n\t\treturn this.request({ uri, method: 'head', auth, headers, query, context });\n\t}\n\n\t/**\n\t * Make a POST request\n\t * @param {string} uri\t\tThe URI to request\n\t * @param {string} [auth]\tAuthorization token to use\n\t * @param {object} [headers]\tKey/Value pairs like `{ 'X-FOO': 'foo', X-BAR: 'bar' }` to send as headers.\n\t * @param {object} [data] Payload to send in the request body in JSON format\n\t * @param {object} [context]\tThe invocation context, describing the tool and project\n\t * @returns {Promise<RequestResponse, RequestError>} A promise that resolves with either the requested data or an error object\n\t */\n\tpost({ uri, headers, data, auth, context }) {\n\t\treturn this.request({ uri, method: 'post', auth, headers, data, context });\n\t}\n\n\t/**\n\t * Make a PUT request\n\t * @param {string} uri\t\tThe URI to request\n\t * @param {string} [auth]\tAuthorization token to use\n\t * @param {object} [headers]\tKey/Value pairs like `{ 'X-FOO': 'foo', X-BAR: 'bar' }` to send as headers.\n\t * @param {object} [data] Payload to send in the request body in JSON format\n\t * @param {object} [context]\tThe invocation context, describing the tool and project\n\t * @returns {Promise<RequestResponse, RequestError>} A promise that resolves with either the requested data or an error object\n\t */\n\tput({ uri, auth, headers, data, context }) {\n\t\treturn this.request({ uri, method: 'put', auth, headers, data, context });\n\t}\n\n\t/**\n\t * Make a DELETE request\n\t * @param {string} uri\t\tThe URI to request\n\t * @param {string} [auth]\tAuthorization token to use\n\t * @param {object} [headers]\tKey/Value pairs like `{ 'X-FOO': 'foo', X-BAR: 'bar' }` to send as headers.\n\t * @param {object} [data] Payload to send in the request body in JSON format\n\t * @param {object} [context]\tThe invocation context, describing the tool and project\n\t * @returns {Promise<RequestResponse, RequestError>} A promise that resolves with either the requested data or an error object\n\t */\n\tdelete({ uri, auth, headers, data, context }) {\n\t\treturn this.request({ uri, method: 'delete', auth, headers, data, context });\n\t}\n\n\t/**\n\t *\n\t * @param {Object} config\t\tAn obj with all the possible request configurations\n\t * @param {String} config.uri\t\tThe URI to request\n\t * @param {String} config.method        The method used to request the URI, should be in uppercase.\n\t * @param {Object} config.headers       Key/Value pairs like `{ 'X-FOO': 'foo', X-BAR: 'bar' }` to send as headers.\n\t * @param {Object} config.data          Arbitrary data to send as the body.\n\t * @param {Object} config.auth          Authorization\n\t * @param {String} config.query         Query parameters\n\t * @param {Object} config.form          Form fields\n\t * @param {Object} config.files         array of file names and file content\n\t * @param {Object} config.context       the invocation context, describing the tool and project.\n\t * @param {boolean} config.isBuffer\tIndicate if the response should be treated as Buffer instead of JSON\n\t * @returns {Promise<RequestResponse, RequestError>} A promise that resolves with either the requested data or an error object\n\t */\n\trequest({\n\t\turi,\n\t\tmethod,\n\t\theaders = undefined,\n\t\tdata = undefined,\n\t\tauth,\n\t\tquery = undefined,\n\t\tform = undefined,\n\t\tfiles = undefined,\n\t\tcontext = undefined,\n\t\tisBuffer = false\n\t}){\n\t\tconst requestFiles = this._sanitizeFiles(files);\n\t\tconst requestParams = this._buildRequest({ uri, method, headers, data, auth, query, form, context, files: requestFiles });\n\t\treturn this._promiseResponse(requestParams, isBuffer);\n\t}\n\n\t/**\n\t * Promises to send the request and retreive the response.\n\t * @param {[string, object]} requestParams\tFirst argument is the URI to request, the second one are the options.\n\t * @param {boolean} isBuffer Indicate if the response body should be returned as a Buffer (Node) / ArrayBuffer (browser) instead of JSON\n\t * @param {Fetch} [makerequest] The fetch function to use. Override for testing.\n\t * @returns {Promise<RequestResponse, RequestError>} A promise that resolves with either the requested data or an error object\n\t * @private\n\t */\n\t_promiseResponse(requestParams, isBuffer, makerequest = fetch) {\n\t\tlet status;\n\t\treturn makerequest(...requestParams)\n\t\t\t.then((resp) => {\n\t\t\t\tstatus = resp.status;\n\t\t\t\tif (!resp.ok) {\n\t\t\t\t\treturn resp.text().then((err) => {\n\t\t\t\t\t\tconst objError = JSON.parse(err);\n\t\t\t\t\t\t// particle-commnds/src/cmd/api expects response.text. to be a string\n\t\t\t\t\t\tconst response = Object.assign(resp, { text: err });\n\t\t\t\t\t\tthrow Object.assign(objError, { response });\n\t\t\t\t\t});\n\t\t\t\t}\n\t\t\t\tif (status === 204) { // Can't do resp.json() since there is no body to parse\n\t\t\t\t\treturn '';\n\t\t\t\t}\n\t\t\t\tif (isBuffer) {\n\t\t\t\t\treturn resp.blob();\n\t\t\t\t}\n\t\t\t\treturn resp.json();\n\t\t\t}).then((body) => {\n\t\t\t\tif (isBuffer) {\n\t\t\t\t\treturn body.arrayBuffer().then((arrayBuffer) => {\n\t\t\t\t\t\tif (!this.isForBrowser()) {\n\t\t\t\t\t\t\treturn Buffer.from(arrayBuffer);\n\t\t\t\t\t\t}\n\t\t\t\t\t\treturn arrayBuffer;\n\t\t\t\t\t});\n\t\t\t\t}\n\t\t\t\treturn {\n\t\t\t\t\tbody,\n\t\t\t\t\tstatusCode: status\n\t\t\t\t};\n\t\t\t}).catch((error) => {\n\t\t\t\tconst errorType = status ? `HTTP error ${status}` : 'Network error';\n\t\t\t\tlet errorDescription = `${errorType} from ${requestParams[0]}`;\n\t\t\t\tlet shortErrorDescription;\n\t\t\t\tif (error.error_description) { // Fetch responded with ok false\n\t\t\t\t\terrorDescription = `${errorDescription} - ${error.error_description}`;\n\t\t\t\t\tshortErrorDescription = error.error_description;\n\t\t\t\t}\n\t\t\t\tconst reason = new Error(errorDescription);\n\t\t\t\tObject.assign(reason, {\n\t\t\t\t\tstatusCode: status,\n\t\t\t\t\terrorDescription,\n\t\t\t\t\tshortErrorDescription,\n\t\t\t\t\terror,\n\t\t\t\t\tbody: error\n\t\t\t\t});\n\t\t\t\tthrow reason;\n\t\t\t});\n\t}\n\n\t_buildRequest({ uri, method, headers, data, auth, query, form, files, context }){\n\t\tlet actualUri = uri;\n\t\tif (this.baseUrl && uri[0] === '/') {\n\t\t\tactualUri = `${this.baseUrl}${uri}`;\n\t\t}\n\t\tif (query) {\n\t\t\tconst queryParams = qs.stringify(query);\n\t\t\tconst hasParams = actualUri.includes('?');\n\t\t\tactualUri = `${actualUri}${hasParams ? '&' : '?'}${queryParams}`;\n\t\t}\n\n\t\tconst userAgentHeader = { 'User-Agent': `${packageJson.name}/${packageJson.version} (${packageJson.repository.url})` };\n\t\tlet body;\n\t\tlet contentTypeHeader;\n\t\tif (files){\n\t\t\tcontentTypeHeader = {}; // Needed to allow fetch create its own\n\t\t\tbody = this._getFromData(files, form);\n\t\t} else if (form){\n\t\t\tcontentTypeHeader = { 'Content-Type': 'application/x-www-form-urlencoded' };\n\t\t\tbody = qs.stringify(form);\n\t\t} else if (data){\n\t\t\tcontentTypeHeader = { 'Content-Type': 'application/json' };\n\t\t\tbody = JSON.stringify(data);\n\t\t}\n\t\tconst finalHeaders = Object.assign({},\n\t\t\tuserAgentHeader,\n\t\t\tcontentTypeHeader,\n\t\t\tthis._getAuthorizationHeader(auth),\n\t\t\tthis._getContextHeaders(context),\n\t\t\theaders\n\t\t);\n\n\t\treturn [actualUri, { method, body, headers: finalHeaders }];\n\t}\n\n\tisForBrowser() {\n\t\treturn typeof window !== 'undefined';\n\t}\n\n\t_getFromData(files, form) {\n\t\tconst formData = new FormData();\n\t\tfor (let [name, file] of Object.entries(files)){\n\t\t\tlet path = file.path;\n\t\t\tlet fileData = file.data;\n\t\t\tif (!this.isForBrowser()) {\n\t\t\t\tconst nodeFormData = this._getNodeFormData(file);\n\t\t\t\tpath = nodeFormData.path;\n\t\t\t\tfileData = nodeFormData.file;\n\t\t\t}\n\t\t\tformData.append(name, fileData, path);\n\t\t}\n\t\tif (form){\n\t\t\tfor (let [name, value] of Object.entries(form)){\n\t\t\t\tformData.append(name, value);\n\t\t\t}\n\t\t}\n\t\treturn formData;\n\t}\n\n\t_getNodeFormData(file) {\n\t\tlet fileData = file.data;\n\t\tif (typeof file.data === 'string') {\n\t\t\tfileData = fs.createReadStream(file.data);\n\t\t}\n\t\treturn {\n\t\t\tfile: fileData,\n\t\t\tpath: { filepath: file.path } // Different API for nodejs\n\t\t};\n\t}\n\n\t_getContextHeaders(context = {}) {\n\t\treturn Object.assign({},\n\t\t\tthis._getToolContext(context.tool),\n\t\t\tthis._getProjectContext(context.project)\n\t\t);\n\t}\n\n\t_getToolContext(tool = {}){\n\t\tlet value = '';\n\t\tif (tool.name){\n\t\t\tvalue += this._toolIdent(tool);\n\t\t\tif (tool.components){\n\t\t\t\tfor (let component of tool.components){\n\t\t\t\t\tvalue += ', '+this._toolIdent(component);\n\t\t\t\t}\n\t\t\t}\n\t\t}\n\t\tif (value){\n\t\t\treturn { 'X-Particle-Tool': value };\n\t\t}\n\t\treturn {};\n\t}\n\n\t_toolIdent(tool){\n\t\treturn this._nameAtVersion(tool.name, tool.version);\n\t}\n\n\t_nameAtVersion(name, version){\n\t\tlet value = '';\n\t\tif (name){\n\t\t\tvalue += name;\n\t\t\tif (version){\n\t\t\t\tvalue += '@'+version;\n\t\t\t}\n\t\t}\n\t\treturn value;\n\t}\n\n\t_getProjectContext(project = {}){\n\t\tlet value = this._buildSemicolonSeparatedProperties(project, 'name');\n\t\tif (value){\n\t\t\treturn { 'X-Particle-Project': value };\n\t\t}\n\t\treturn {};\n\t}\n\n\t/**\n\t * Creates a string like primaryPropertyValue; name=value; name1=value\n\t * from the properties of an object.\n\t * @param {object} obj               The object to create the string from\n\t * @param {string} primaryProperty   The name of the primary property which is the default value and must be defined.\n\t * @private\n\t * @return {string} The formatted string representing the object properties and the default property.\n\t */\n\t_buildSemicolonSeparatedProperties(obj, primaryProperty){\n\t\tlet value = '';\n\t\tif (obj[primaryProperty]){\n\t\t\tvalue += obj[primaryProperty];\n\t\t\tfor (let prop in obj){\n\t\t\t\tif (prop!==primaryProperty && obj.hasOwnProperty(prop)){\n\t\t\t\t\tvalue += '; '+prop+'='+obj[prop];\n\t\t\t\t}\n\t\t\t}\n\t\t}\n\t\treturn value;\n\t}\n\n\t/**\n\t * Adds an authorization header.\n\t * @param {string}  auth    The authorization bearer token.\n\t * @returns {object} The original request.\n\t */\n\t_getAuthorizationHeader(auth){\n\t\tif (!auth) {\n\t\t\treturn {};\n\t\t}\n\t\tif (typeof auth === 'string') {\n\t\t\treturn { Authorization: `Bearer ${auth}` };\n\t\t}\n\t\tlet encoded;\n\t\tif (this.isForBrowser()) {\n\t\t\tencoded = btoa(`${auth.username}:${auth.password}`);\n\t\t} else {\n\t\t\tencoded = Buffer.from(`${auth.username}:${auth.password}`)\n\t\t\t\t.toString('base64');\n\t\t}\n\t\treturn { Authorization: `Basic ${encoded}` };\n\t}\n\n\t/**\n\t *\n\t * @param {Object} files converts the file names to file, file1, file2.\n\t * @returns {object} the renamed files.\n\t */\n\t_sanitizeFiles(files){\n\t\tlet requestFiles;\n\t\tif (files){\n\t\t\trequestFiles = {};\n\t\t\tObject.keys(files).forEach((k, i) => {\n\t\t\t\tconst name = i ? `file${i + 1}` : 'file';\n\t\t\t\trequestFiles[name] = {\n\t\t\t\t\tdata: files[k],\n\t\t\t\t\tpath: k\n\t\t\t\t};\n\t\t\t});\n\t\t}\n\t\treturn requestFiles;\n\t}\n}\n\n"]}