add configuration service endpoints

Author: busticated

src/Particle.js

@@ -1885,6 +1885,84 @@ class Particle {
 		});
 	}
 
+	/**
+	 * Get product configuration
+	 * @param  {Object} options          Options for this API call
+	 * @param  {String} options.product  Config for this product ID or slug
+	 * @param  {String} options.auth     Access Token
+	 * @param {Object} [options.headers] Key/Value pairs like `{ 'X-FOO': 'foo', X-BAR: 'bar' }` to send as headers.
+	 * @param {Object} [options.context] Request context
+	 * @returns {Promise} A promise
+	 */
+	getProductConfiguration({ auth, product, headers, context }){
+		return this.get({
+			uri: `/v1/products/${product}/config`,
+			auth,
+			headers,
+			context
+		});
+	}
+
+	/**
+	 * Get product configuration schema
+	 * @param  {Object} options          Options for this API call
+	 * @param  {String} options.product  Config for this product ID or slug
+	 * @param  {String} options.auth     Access Token
+	 * @param {Object} [options.headers] Key/Value pairs like `{ 'X-FOO': 'foo', X-BAR: 'bar' }` to send as headers.
+	 * @param {Object} [options.context] Request context
+	 * @returns {Promise} A promise
+	 */
+	getProductConfigurationSchema({ auth, product, headers = {}, context }){
+		headers.accept = 'application/schema+json';
+		return this.get({
+			uri: `/v1/products/${product}/config`,
+			auth,
+			headers,
+			context
+		});
+	}
+
+	/**
+	 * Set product configuration
+	 * @param  {Object} options          Options for this API call
+	 * @param  {String} options.product  Config for this product ID or slug
+	 * @param  {String} options.auth     Access Token
+	 * @param  {Object} opitons.config   Product configuration to update
+	 * @param {Object} [options.headers] Key/Value pairs like `{ 'X-FOO': 'foo', X-BAR: 'bar' }` to send as headers.
+	 * @param {Object} [options.context] Request context
+	 * @returns {Promise} A promise
+	 */
+	setProductConfiguration({ auth, product, config, headers, context }){
+		return this.put({
+			uri: `/v1/products/${product}/config`,
+			auth,
+			data: config,
+			headers,
+			context
+		});
+	}
+
+	/**
+	 * Set product configuration for a specific device within the product
+	 * @param  {Object} options          Options for this API call
+	 * @param  {String} options.product  Config for this product ID or slug
+	 * @param  {String} options.auth     Access Token
+	 * @param  {Object} opitons.config   Product configuration to update
+	 * @param  {String} options.deviceId Device ID to access
+	 * @param {Object} [options.headers] Key/Value pairs like `{ 'X-FOO': 'foo', X-BAR: 'bar' }` to send as headers.
+	 * @param {Object} [options.context] Request context
+	 * @returns {Promise} A promise
+	 */
+	setProductDeviceConfiguration({ auth, product, deviceId, config, headers, context }){
+		return this.put({
+			uri: `/v1/products/${product}/config/${deviceId}`,
+			data: config,
+			auth,
+			headers,
+			context
+		});
+	}
+
 	/**
 	 * API URI to access a device
 	 * @param  {Object} options Options for this API call

test/Particle.spec.js

@@ -2313,6 +2313,67 @@ describe('ParticleAPI', () => {
 			});
 		});
 
+		describe('.getProductConfiguration', () => {
+			it('generates request', () => {
+				return api.getProductConfiguration(propsWithProduct).then((results) => {
+					results.should.match({
+						method: 'get',
+						uri: `/v1/products/${product}/config`,
+						auth: props.auth
+					});
+				});
+			});
+		});
+
+		describe('.getProductConfigurationSchema', () => {
+			it('generates request', () => {
+				return api.getProductConfigurationSchema(propsWithProduct).then((results) => {
+					results.should.match({
+						method: 'get',
+						uri: `/v1/products/${product}/config`,
+						auth: props.auth,
+						headers: { 'accept': 'application/schema+json' }
+					});
+				});
+			});
+		});
+
+		describe('.setProductConfiguration', () => {
+			it('generates request', () => {
+				const p = Object.assign({ config: {
+					foo: 'bar'
+				} }, propsWithProduct);
+				return api.setProductConfiguration(p).then((results) => {
+					results.should.match({
+						method: 'put',
+						uri: `/v1/products/${product}/config`,
+						auth: props.auth,
+						data: {
+							foo: 'bar'
+						}
+					});
+				});
+			});
+		});
+
+		describe('.setProductDeviceConfiguration', () => {
+			it('generates request', () => {
+				const p = Object.assign({ config: {
+					foo: 'bar'
+				} }, propsWithProduct);
+				return api.setProductDeviceConfiguration(p).then((results) => {
+					results.should.match({
+						method: 'put',
+						uri: `/v1/products/${product}/config/${props.deviceId}`,
+						auth: props.auth,
+						data: {
+							foo: 'bar'
+						}
+					});
+				});
+			});
+		});
+
 		describe('.deleteUser', () => {
 			it('sends request to delete the current user', () => {
 				return api.deleteUser(props).then(result => {