particle-api-js 9.1.1 → 9.1.2
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +3 -0
- package/dist/particle.min.js +1 -1
- package/dist/particle.min.js.map +1 -1
- package/docs/api.md +102 -102
- package/lib/Client.js +2 -2
- package/lib/Client.js.map +1 -1
- package/package.json +1 -1
- package/test/Client.spec.js +2 -2
package/CHANGELOG.md
CHANGED
package/dist/particle.min.js
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
(function(f){if(typeof exports==="object"&&typeof module!=="undefined"){module.exports=f()}else if(typeof define==="function"&&define.amd){define([],f)}else{var g;if(typeof window!=="undefined"){g=window}else if(typeof global!=="undefined"){g=global}else if(typeof self!=="undefined"){g=self}else{g=this}g.Particle = f()}})(function(){var define,module,exports;return (function e(t,n,r){function s(o,u){if(!n[o]){if(!t[o]){var a=typeof require=="function"&&require;if(!u&&a)return a(o,!0);if(i)return i(o,!0);var f=new Error("Cannot find module '"+o+"'");throw f.code="MODULE_NOT_FOUND",f}var l=n[o]={exports:{}};t[o][0].call(l.exports,function(e){var n=t[o][1][e];return s(n?n:e)},l,l.exports,e,t,n,r)}return n[o].exports}var i=typeof require=="function"&&require;for(var o=0;o<r.length;o++)s(r[o]);return s})({1:[function(require,module,exports){
|
|
2
2
|
"use strict";function _interopRequireDefault(e){return e&&e.__esModule?e:{default:e}}Object.defineProperty(exports,"__esModule",{value:!0});var _keys=require("babel-runtime/core-js/object/keys"),_keys2=_interopRequireDefault(_keys),_slicedToArray2=require("babel-runtime/helpers/slicedToArray"),_slicedToArray3=_interopRequireDefault(_slicedToArray2),_entries=require("babel-runtime/core-js/object/entries"),_entries2=_interopRequireDefault(_entries),_getIterator2=require("babel-runtime/core-js/get-iterator"),_getIterator3=_interopRequireDefault(_getIterator2),_assign=require("babel-runtime/core-js/object/assign"),_assign2=_interopRequireDefault(_assign),_promise=require("babel-runtime/core-js/promise"),_promise2=_interopRequireDefault(_promise),_classCallCheck2=require("babel-runtime/helpers/classCallCheck"),_classCallCheck3=_interopRequireDefault(_classCallCheck2),_createClass2=require("babel-runtime/helpers/createClass"),_createClass3=_interopRequireDefault(_createClass2),_superagent=require("superagent"),_superagent2=_interopRequireDefault(_superagent),_superagentPrefix=require("superagent-prefix"),_superagentPrefix2=_interopRequireDefault(_superagentPrefix),Agent=function(){function e(t){(0,_classCallCheck3.default)(this,e),this.prefix=(0,_superagentPrefix2.default)(t)}return(0,_createClass3.default)(e,[{key:"get",value:function(e){var t=e.uri,r=e.auth,a=e.headers,i=e.query,u=e.context;return this.request({uri:t,method:"get",auth:r,headers:a,query:i,context:u})}},{key:"head",value:function(e){var t=e.uri,r=e.auth,a=e.headers,i=e.query,u=e.context;return this.request({uri:t,method:"head",auth:r,headers:a,query:i,context:u})}},{key:"post",value:function(e){var t=e.uri,r=e.headers,a=e.data,i=e.auth,u=e.context;return this.request({uri:t,method:"post",auth:i,headers:r,data:a,context:u})}},{key:"put",value:function(e){var t=e.uri,r=e.auth,a=e.headers,i=e.data,u=e.context;return this.request({uri:t,method:"put",auth:r,headers:a,data:i,context:u})}},{key:"delete",value:function(e){var t=e.uri,r=e.auth,a=e.headers,i=e.data,u=e.context;return this.request({uri:t,method:"delete",auth:r,headers:a,data:i,context:u})}},{key:"request",value:function(e){var t=e.uri,r=e.method,a=e.headers,i=void 0===a?void 0:a,u=e.data,o=void 0===u?void 0:u,n=e.auth,s=e.query,l=void 0===s?void 0:s,d=e.form,f=void 0===d?void 0:d,c=e.files,h=void 0===c?void 0:c,_=e.context,v=void 0===_?void 0:_,p=e.raw,y=void 0!==p&&p,m=this._sanitizeFiles(h);return this._request({uri:t,method:r,headers:i,data:o,auth:n,query:l,form:f,context:v,files:m,raw:y})}},{key:"_request",value:function(e){var t=e.uri,r=e.method,a=e.headers,i=e.data,u=e.auth,o=e.query,n=e.form,s=e.files,l=e.context,d=e.raw,f=this._buildRequest({uri:t,method:r,headers:a,data:i,auth:u,query:o,form:n,context:l,files:s});return d?f:this._promiseResponse(f)}},{key:"_promiseResponse",value:function(e){var t=this;return new _promise2.default(function(r,a){return t._sendRequest(e,r,a)})}},{key:"_sendRequest",value:function(e,t,r){e.end(function(a,i){var u=i&&i.body;if(a){var o=e.url,n=a.status,s=(n?"HTTP error "+n:"Network error")+" from "+o,l=void 0;u&&u.error_description&&(s+=" - "+u.error_description,l=u.error_description);var d=new Error(s);(0,_assign2.default)(d,{statusCode:n,errorDescription:s,shortErrorDescription:l,error:a,body:u}),r(d)}else t({body:u,statusCode:i.statusCode})})}},{key:"_buildRequest",value:function(e){var t=e.uri,r=e.method,a=e.headers,i=e.data,u=e.auth,o=e.query,n=e.form,s=e.files,l=e.context,d=e.makerequest,f=void 0===d?_superagent2.default:d,c=f(r,t);if(this.prefix&&c.use(this.prefix),this._authorizationHeader(c,u),l&&this._applyContext(c,l),o&&c.query(o),a&&c.set(a),s){var h=!0,_=!1,v=void 0;try{for(var p,y=(0,_getIterator3.default)((0,_entries2.default)(s));!(h=(p=y.next()).done);h=!0){var m=(0,_slicedToArray3.default)(p.value,2),q=m[0],x=m[1],k={filepath:x.path};this.isForBrowser(f)&&(k=x.path),c.attach(q,x.data,k)}}catch(e){_=!0,v=e}finally{try{!h&&y.return&&y.return()}finally{if(_)throw v}}if(n){var g=!0,b=!1,C=void 0;try{for(var R,j=(0,_getIterator3.default)((0,_entries2.default)(n));!(g=(R=j.next()).done);g=!0){var P=(0,_slicedToArray3.default)(R.value,2),q=P[0],w=P[1];c.field(q,w)}}catch(e){b=!0,C=e}finally{try{!g&&j.return&&j.return()}finally{if(b)throw C}}}}else n?(c.type("form"),c.send(n)):i&&c.send(i);return c}},{key:"isForBrowser",value:function(){return!!(arguments.length>0&&void 0!==arguments[0]?arguments[0]:_superagent2.default).getXHR}},{key:"_applyContext",value:function(e,t){t.tool&&this._addToolContext(e,t.tool),t.project&&this._addProjectContext(e,t.project)}},{key:"_addToolContext",value:function(e,t){var r="";if(t.name&&(r+=this._toolIdent(t),t.components)){var a=!0,i=!1,u=void 0;try{for(var o,n=(0,_getIterator3.default)(t.components);!(a=(o=n.next()).done);a=!0){var s=o.value;r+=", "+this._toolIdent(s)}}catch(e){i=!0,u=e}finally{try{!a&&n.return&&n.return()}finally{if(i)throw u}}}r&&e.set("X-Particle-Tool",r)}},{key:"_toolIdent",value:function(e){return this._nameAtVersion(e.name,e.version)}},{key:"_nameAtVersion",value:function(e,t){var r="";return e&&(r+=e,t&&(r+="@"+t)),r}},{key:"_addProjectContext",value:function(e,t){var r=this._buildSemicolonSeparatedProperties(t,"name");r&&e.set("X-Particle-Project",r)}},{key:"_buildSemicolonSeparatedProperties",value:function(e,t){var r="";if(e[t]){r+=e[t];for(var a in e)a!==t&&e.hasOwnProperty(a)&&(r+="; "+a+"="+e[a])}return r}},{key:"_authorizationHeader",value:function(e,t){return t&&(void 0!==t.username?e.auth(t.username,t.password):e.set({Authorization:"Bearer "+t})),e}},{key:"_sanitizeFiles",value:function(e){var t=void 0;return e&&(t={},(0,_keys2.default)(e).forEach(function(r,a){t[a?"file"+(a+1):"file"]={data:e[r],path:r}})),t}}]),e}();exports.default=Agent,module.exports=exports.default;
|
|
3
3
|
},{"babel-runtime/core-js/get-iterator":8,"babel-runtime/core-js/object/assign":10,"babel-runtime/core-js/object/entries":13,"babel-runtime/core-js/object/keys":15,"babel-runtime/core-js/promise":17,"babel-runtime/helpers/classCallCheck":20,"babel-runtime/helpers/createClass":21,"babel-runtime/helpers/slicedToArray":24,"superagent":170,"superagent-prefix":168}],2:[function(require,module,exports){
|
|
4
|
-
"use strict";function _interopRequireDefault(e){return e&&e.__esModule?e:{default:e}}Object.defineProperty(exports,"__esModule",{value:!0});var _getIterator2=require("babel-runtime/core-js/get-iterator"),_getIterator3=_interopRequireDefault(_getIterator2),_assign=require("babel-runtime/core-js/object/assign"),_assign2=_interopRequireDefault(_assign),_classCallCheck2=require("babel-runtime/helpers/classCallCheck"),_classCallCheck3=_interopRequireDefault(_classCallCheck2),_createClass2=require("babel-runtime/helpers/createClass"),_createClass3=_interopRequireDefault(_createClass2),_Particle=require("./Particle"),_Particle2=_interopRequireDefault(_Particle),_Library=require("./Library"),_Library2=_interopRequireDefault(_Library),Client=function(){function e(t){var r=t.auth,a=t.api,i=void 0===a?new _Particle2.default:a;(0,_classCallCheck3.default)(this,e),(0,_assign2.default)(this,{auth:r,api:i})}return(0,_createClass3.default)(e,[{key:"ready",value:function(){return Boolean(this.auth)}},{key:"libraries",value:function(){var e=this,t=arguments.length>0&&void 0!==arguments[0]?arguments[0]:{};return this.api.listLibraries((0,_assign2.default)({},t,{auth:this.auth})).then(function(t){return(t.body.data||[]).map(function(t){return new _Library2.default(e,t)})})}},{key:"library",value:function(e){var t=this,r=arguments.length>1&&void 0!==arguments[1]?arguments[1]:{};return this.api.getLibrary((0,_assign2.default)({},r,{name:e,auth:this.auth})).then(function(e){var r=e.body.data||{};return new _Library2.default(t,r)})}},{key:"libraryVersions",value:function(e){var t=this,r=arguments.length>1&&void 0!==arguments[1]?arguments[1]:{};return this.api.getLibraryVersions((0,_assign2.default)({},r,{name:e,auth:this.auth})).then(function(e){return(e.body.data||[]).map(function(e){return new _Library2.default(t,e)})})}},{key:"contributeLibrary",value:function(e){var t=this;return this.api.contributeLibrary({archive:e,auth:this.auth}).then(function(e){var r=e.body.data||{};return new _Library2.default(t,r)},function(e){t._throwError(e)})}},{key:"publishLibrary",value:function(e){var t=this;return this.api.publishLibrary({name:e,auth:this.auth}).then(function(e){var r=e.body.data||{};return new _Library2.default(t,r)},function(e){t._throwError(e)})}},{key:"deleteLibrary",value:function(e){var t=this,r=e.name,a=e.force;return this.api.deleteLibrary({name:r,force:a,auth:this.auth}).then(function(){return!0},function(e){return t._throwError(e)})}},{key:"_throwError",value:function(e){if(e.body&&e.body.errors){var t=e.body.errors.map(function(e){return e.message}).join("\n");throw new Error(t)}throw e}},{key:"downloadFile",value:function(e){return this.api.downloadFile({
|
|
4
|
+
"use strict";function _interopRequireDefault(e){return e&&e.__esModule?e:{default:e}}Object.defineProperty(exports,"__esModule",{value:!0});var _getIterator2=require("babel-runtime/core-js/get-iterator"),_getIterator3=_interopRequireDefault(_getIterator2),_assign=require("babel-runtime/core-js/object/assign"),_assign2=_interopRequireDefault(_assign),_classCallCheck2=require("babel-runtime/helpers/classCallCheck"),_classCallCheck3=_interopRequireDefault(_classCallCheck2),_createClass2=require("babel-runtime/helpers/createClass"),_createClass3=_interopRequireDefault(_createClass2),_Particle=require("./Particle"),_Particle2=_interopRequireDefault(_Particle),_Library=require("./Library"),_Library2=_interopRequireDefault(_Library),Client=function(){function e(t){var r=t.auth,a=t.api,i=void 0===a?new _Particle2.default:a;(0,_classCallCheck3.default)(this,e),(0,_assign2.default)(this,{auth:r,api:i})}return(0,_createClass3.default)(e,[{key:"ready",value:function(){return Boolean(this.auth)}},{key:"libraries",value:function(){var e=this,t=arguments.length>0&&void 0!==arguments[0]?arguments[0]:{};return this.api.listLibraries((0,_assign2.default)({},t,{auth:this.auth})).then(function(t){return(t.body.data||[]).map(function(t){return new _Library2.default(e,t)})})}},{key:"library",value:function(e){var t=this,r=arguments.length>1&&void 0!==arguments[1]?arguments[1]:{};return this.api.getLibrary((0,_assign2.default)({},r,{name:e,auth:this.auth})).then(function(e){var r=e.body.data||{};return new _Library2.default(t,r)})}},{key:"libraryVersions",value:function(e){var t=this,r=arguments.length>1&&void 0!==arguments[1]?arguments[1]:{};return this.api.getLibraryVersions((0,_assign2.default)({},r,{name:e,auth:this.auth})).then(function(e){return(e.body.data||[]).map(function(e){return new _Library2.default(t,e)})})}},{key:"contributeLibrary",value:function(e){var t=this;return this.api.contributeLibrary({archive:e,auth:this.auth}).then(function(e){var r=e.body.data||{};return new _Library2.default(t,r)},function(e){t._throwError(e)})}},{key:"publishLibrary",value:function(e){var t=this;return this.api.publishLibrary({name:e,auth:this.auth}).then(function(e){var r=e.body.data||{};return new _Library2.default(t,r)},function(e){t._throwError(e)})}},{key:"deleteLibrary",value:function(e){var t=this,r=e.name,a=e.force;return this.api.deleteLibrary({name:r,force:a,auth:this.auth}).then(function(){return!0},function(e){return t._throwError(e)})}},{key:"_throwError",value:function(e){if(e.body&&e.body.errors){var t=e.body.errors.map(function(e){return e.message}).join("\n");throw new Error(t)}throw e}},{key:"downloadFile",value:function(e){return this.api.downloadFile({uri:e})}},{key:"compileCode",value:function(e,t,r){return this.api.compileCode({files:e,platformId:t,targetVersion:r,auth:this.auth})}},{key:"signalDevice",value:function(e){var t=e.signal,r=e.deviceId;return this.api.signalDevice({signal:t,deviceId:r,auth:this.auth})}},{key:"listDevices",value:function(){return this.api.listDevices({auth:this.auth})}},{key:"listBuildTargets",value:function(){return this.api.listBuildTargets({onlyFeatured:!0,auth:this.auth}).then(function(e){var t=[],r=!0,a=!1,i=void 0;try{for(var n,u=(0,_getIterator3.default)(e.body.targets);!(r=(n=u.next()).done);r=!0){var l=n.value,o=!0,s=!1,h=void 0;try{for(var c,f=(0,_getIterator3.default)(l.platforms);!(o=(c=f.next()).done);o=!0){var d=c.value;t.push({version:l.version,platform:d,prerelease:l.prereleases.indexOf(d)>-1,firmware_vendor:l.firmware_vendor})}}catch(e){s=!0,h=e}finally{try{!o&&f.return&&f.return()}finally{if(s)throw h}}}}catch(e){a=!0,i=e}finally{try{!r&&u.return&&u.return()}finally{if(a)throw i}}return t},function(){})}},{key:"trackingIdentity",value:function(){var e=arguments.length>0&&void 0!==arguments[0]?arguments[0]:{},t=e.full,r=void 0!==t&&t,a=e.context;return this.api.trackingIdentity({full:r,context:a,auth:this.auth}).then(function(e){return e.body})}}]),e}();exports.default=Client,module.exports=exports.default;
|
|
5
5
|
},{"./Library":5,"./Particle":6,"babel-runtime/core-js/get-iterator":8,"babel-runtime/core-js/object/assign":10,"babel-runtime/helpers/classCallCheck":20,"babel-runtime/helpers/createClass":21}],3:[function(require,module,exports){
|
|
6
6
|
"use strict";Object.defineProperty(exports,"__esModule",{value:!0}),exports.default={baseUrl:"https://api.particle.io",clientSecret:"particle-api",clientId:"particle-api",tokenDuration:7776e3},module.exports=exports.default;
|
|
7
7
|
},{}],4:[function(require,module,exports){
|