particle-api-js 11.1.7 → 12.0.1

package/{src/Particle.js → lib/src/Particle.d.ts}

@@ -1,9 +1,8 @@
-'use strict';
-const Defaults = require('./Defaults');
-const EventStream = require('./EventStream');
-const Agent = require('./Agent');
-const Client = require('./Client');
-
+import EventStream = require('./EventStream');
+import Agent = require('./Agent');
+import Client = require('./Client');
+import type * as T from './types';
+import { type Agent as HttpAgent } from 'http';
 /**
  * Particle Cloud API wrapper.
  *
@@ -13,12 +12,21 @@ const Client = require('./Client');
  * Most Particle methods take a single unnamed argument object documented as
  * `options` with key/value pairs for each option.
  *
- * @typedef {import('./Agent').RequestResponse} RequestResponse
- * @typedef {import('./Agent').RequestError} RequestError
  */
-// These typedef avoid importing the type on every @return statement
-class Particle {
-	/**
+declare class Particle {
+    baseUrl: string;
+    clientId: string;
+    clientSecret: string;
+    tokenDuration: number;
+    auth: string | undefined;
+    context: {
+        tool?: T.ToolContext;
+        project?: T.ProjectContext;
+    };
+    agent: Agent;
+    httpAgent: HttpAgent | undefined;
+    _defaultAuth?: string;
+    /**
      * Contructor for the Cloud API wrapper.
      *
      * Create a new Particle object and call methods below on it.
@@ -29,63 +37,24 @@ class Particle {
      * @param {string} [options.clientId]
      * @param {number} [options.tokenDuration]
      * @param {string} [options.auth]            The access token. If not specified here, will have to be added to every request
+     * @param {HttpAgent} [options.httpAgent]       The http.Agent to use for requests (e.g. an https-proxy-agent instance for corporate proxies)
      */
-	constructor(options = {}){
-		if (options.auth) {
-			this.setDefaultAuth(options.auth);
-		}
-
-		// todo - this seems a bit dangerous - would be better to put all options/context in a contained object
-		Object.assign(this, Defaults, options);
-		this.context = {};
-
-		this.agent = new Agent(this.baseUrl);
-	}
-
-	_isValidContext(name, context){
-		return (name === 'tool' || name === 'project') && context !== undefined;
-	}
-
-	/**
-     * @typedef {Object} ToolContext
+    constructor(options?: T.ParticleOptions);
+    private _isValidContext;
+    /**
+     * @typedef {Object} T.ToolContext
      * @property {string} name
      * @property {string | number} [version]
-     * @property {Omit<ToolContext, 'components'>[]} [components]
+     * @property {Omit<T.ToolContext, 'components'>[]} [components]
      */
-
-	/**
-     * @typedef {Record<string, string | number>} ProjectContext
+    /**
+     * @typedef {Record<string, string | number>} T.ProjectContext
      * @property {string} name
      */
-
-	/**
-     * Allows setting a tool or project context which will be sent as headers with every request.
-     * Tool- x-particle-tool
-     * Project- x-particle-project
-     * @param {'tool' | 'project'} name
-     * @param {ToolContext | ProjectContext | undefined} context
-     */
-	setContext(name, context){
-		if (context !== undefined){
-			if (this._isValidContext(name, context)){
-				this.context[name] = context;
-			} else {
-				throw Error('unknown context name or undefined context: ' + name);
-			}
-		}
-	}
-
-	/**
-     * Builds the final context from the context parameter and the context items in the api.
-     * @param   {Object} context  The invocation context, this takes precedence over the local context.
-     * @returns {Object} The context to use.
-     * @private
-     */
-	_buildContext(context){
-		return Object.assign(this.context, context);
-	}
-
-	/**
+    /** @internal */
+    setContext(name: 'tool' | 'project', context: T.ToolContext | T.ProjectContext | undefined): void;
+    private _buildContext;
+    /**
      * Login to Particle Cloud using an existing Particle acccount.
      * @param  {Object} options                Options for this API call
      * @param  {String} options.username       Username for the Particle account
@@ -93,68 +62,29 @@ class Particle {
      * @param  {Number} options.tokenDuration  How long the access token should last in seconds
      * @param  {Object} [options.headers]      Key/Value pairs like `{ 'X-FOO': 'foo', X-BAR: 'bar' }` to send as headers.
      * @param  {Number} [options.context]      Request context
-     * @returns {Promise} A promise
+     * @returns {Promise<T.JSONResponse<T.LoginResponse>>} A promise that resolves with the response data
      */
-	// @ts-ignore
-	login({ username, password, tokenDuration = this.tokenDuration, headers, context }){
-		return this.request({
-			uri: '/oauth/token',
-			method: 'post',
-			headers,
-			form: {
-				username,
-				password,
-				grant_type: 'password',
-				// @ts-ignore
-				client_id: this.clientId,
-				// @ts-ignore
-				client_secret: this.clientSecret,
-				expires_in: tokenDuration
-			},
-			context
-		});
-	}
-
-	/**
+    login({ username, password, tokenDuration, headers, context }: T.LoginOptions): Promise<T.JSONResponse<T.LoginResponse>>;
+    /**
      * If login failed with an 'mfa_required' error, this must be called with a valid OTP code to login
      * @param  {Object} options            Options for this API call
      * @param  {String} options.mfaToken   Given as 'mfa_token' in the error body of `.login()`.
      * @param  {String} options.otp        Current one-time-password generated from the authentication application
      * @param  {Object} [options.headers]  Key/Value pairs like `{ 'X-FOO': 'foo', X-BAR: 'bar' }` to send as headers.
      * @param  {Number} [options.context]  Request context
-     * @returns {Promise} A promise
+     * @returns {Promise<T.JSONResponse<T.LoginResponse>>} A promise that resolves with the response data
      */
-	sendOtp({ mfaToken, otp, headers, context }){
-		return this.request({
-			uri: '/oauth/token',
-			method: 'post',
-			headers,
-			form: {
-				grant_type: 'urn:custom:mfa-otp',
-				mfa_token: mfaToken,
-				otp,
-				// @ts-ignore
-				client_id: this.clientId,
-				// @ts-ignore
-				client_secret: this.clientSecret
-			},
-			context
-		});
-	}
-
-	/**
+    sendOtp({ mfaToken, otp, headers, context }: T.SendOtpOptions): Promise<T.JSONResponse<T.LoginResponse>>;
+    /**
      * Enable MFA on the currently logged in user
      * @param {Object} options            Options for this API call
      * @param {string} [options.auth]     The access token. Can be ignored if provided in constructor
      * @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
+     * @returns {Promise<T.JSONResponse<T.EnableMfaResponse>>} A promise that resolves with the response data
      */
-	enableMfa({ auth, headers, context }){
-		return this.get({ uri: '/v1/user/mfa-enable', auth, headers, context });
-	}
-
-	/**
+    enableMfa({ auth, headers, context }: T.EnableMfaOptions): Promise<T.JSONResponse<T.EnableMfaResponse>>;
+    /**
      * Confirm MFA for the user. This must be called with current TOTP code, determined from the results of enableMfa(). You will be prompted to enter an OTP code every time you login after enrollment is confirmed.
      * @param {Object} options                    Options for this API call
      * @param {string} [options.auth]               The access token. Can be ignored if provided in constructor
@@ -163,44 +93,20 @@ class Particle {
      * @param {Boolean} options.invalidateTokens  Should all tokens be invalidated
      * @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
+     * @returns {Promise<T.JSONResponse<T.ConfirmMfaResponse>>} A promise that resolves with the response data
      */
-	confirmMfa({ mfaToken, otp, invalidateTokens = false, auth, headers, context }){
-		const data = { mfa_token: mfaToken, otp };
-
-		if (invalidateTokens) {
-			data.invalidate_tokens = true;
-		}
-
-		return this.post({
-			uri: '/v1/user/mfa-enable',
-			auth,
-			headers,
-			data,
-			context
-		});
-	}
-
-	/**
+    confirmMfa({ mfaToken, otp, invalidateTokens, auth, headers, context }: T.ConfirmMfaOptions): Promise<T.JSONResponse<T.ConfirmMfaResponse>>;
+    /**
      * Disable MFA for the user.
      * @param {Object} options                  Options for this API call
      * @param {string} [options.auth]             The access token. Can be ignored if provided in constructor
      * @param {Object} options.currentPassword  User's current password
      * @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
+     * @returns {Promise<T.JSONResponse<T.OKResponse>>} A promise that resolves with the response data
      */
-	disableMfa({ currentPassword, auth, headers, context }){
-		return this.put({
-			uri: '/v1/user/mfa-disable',
-			auth,
-			headers,
-			data: { current_password: currentPassword },
-			context
-		});
-	}
-
-	/**
+    disableMfa({ currentPassword, auth, headers, context }: T.DisableMfaOptions): Promise<T.JSONResponse<T.OKResponse>>;
+    /**
      * Create Customer for Product.
      * @param {Object} options            Options for this API call
      * @param {String} options.email      Username for the Particle account
@@ -208,50 +114,18 @@ class Particle {
      * @param {String} options.product    Create the customer in this product ID or slug
      * @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
+     * @returns {Promise<T.JSONResponse<T.CreateCustomerResponse>>} A promise that resolves with the response data
      */
-	createCustomer({ email, password, product, headers, context }){
-		return this.request({
-			uri: `/v1/products/${product}/customers`,
-			method: 'post',
-			headers,
-			form: {
-				email,
-				password,
-				grant_type: 'client_credentials',
-				// @ts-ignore
-				client_id: this.clientId,
-				// @ts-ignore
-				client_secret: this.clientSecret
-			},
-			context
-		});
-	}
-
-	/**
+    createCustomer({ email, password, product, headers, context }: T.CreateCustomerOptions): Promise<T.JSONResponse<T.CreateCustomerResponse>>;
+    /**
      * Login to Particle Cloud using an OAuth client.
      * @param {Object} options            Options for this API call
      * @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
+     * @returns {Promise<T.JSONResponse<T.LoginResponse>>} A promise that resolves with the response data
      */
-	loginAsClientOwner({ headers, context }){
-		return this.request({
-			uri: '/oauth/token',
-			method: 'post',
-			headers,
-			form: {
-				grant_type: 'client_credentials',
-				// @ts-ignore
-				client_id: this.clientId,
-				// @ts-ignore
-				client_secret: this.clientSecret
-			},
-			context
-		});
-	}
-
-	/**
+    loginAsClientOwner({ headers, context }?: T.LoginAsClientOwnerOptions): Promise<T.JSONResponse<T.LoginResponse>>;
+    /**
      * Create a user account for the Particle Cloud
      * @param {Object} options              Options for this API call
      * @param {String} options.username     Email of the new user
@@ -260,126 +134,56 @@ class Particle {
      * @param {Object} [options.utm]        Object that contains info about the campaign that lead to this user creation
      * @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
+     * @returns {Promise<T.JSONResponse<T.OKResponse>>} A promise that resolves with the response data
      */
-	createUser({ username, password, accountInfo, utm, headers, context }){
-		return this.post({
-			uri: '/v1/users',
-			headers,
-			data: {
-				username,
-				password,
-				account_info: accountInfo,
-				utm
-			},
-			context
-		});
-	}
-
-	/**
-     * Verify new user account via verification email
-     * @param {Object} options            Options for this API call
-     * @param {String} options.token      The string token sent in the verification email
-     * @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
-     */
-	verifyUser({ token, headers, context }){
-		return this.post({
-			uri: '/v1/user/verify',
-			headers,
-			data: { token },
-			context
-		});
-	}
-
-	/**
+    createUser({ username, password, accountInfo, utm, headers, context }: T.CreateUserOptions): Promise<T.JSONResponse<T.OKResponse>>;
+    /**
      * Send reset password email for a Particle Cloud user account
      * @param {Object} options            Options for this API call
      * @param {String} options.username   Email of the user
      * @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
+     * @returns {Promise<T.JSONResponse<T.OKResponse>>} A promise that resolves with the response data
      */
-	resetPassword({ username, headers, context }){
-		return this.post({
-			uri: '/v1/user/password-reset',
-			headers,
-			data: { username },
-			context
-		});
-	}
-
-	/**
+    resetPassword({ username, headers, context }: T.ResetPasswordOptions): Promise<T.JSONResponse<T.OKResponse>>;
+    /**
      * Revoke an access token
      * @param {Object} options            Options for this API call
      * @param {String} options.token      Access token you wish to revoke
      * @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
+     * @returns {Promise<T.JSONResponse<T.OKResponse>>} A promise that resolves with the response data
      */
-	deleteAccessToken({ token, headers, context }){
-		return this.delete({
-			uri: `/v1/access_tokens/${token}`,
-			headers,
-			context
-		});
-	}
-
-	/**
+    deleteAccessToken({ token, headers, context }: T.DeleteAccessTokenOptions): Promise<T.JSONResponse<T.OKResponse>>;
+    /**
      * Revoke the current session access token
      * @param {Object} options            Options for this API call
      * @param {string} [options.auth]     The access token. Can be ignored if provided in constructor
      * @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
+     * @returns {Promise<T.JSONResponse<T.OKResponse>>} A promise that resolves with the response data
      */
-	deleteCurrentAccessToken({ auth, headers, context }){
-		return this.delete({
-			uri: '/v1/access_tokens/current',
-			auth,
-			headers,
-			context
-		});
-	}
-
-	/**
+    deleteCurrentAccessToken({ auth, headers, context }: T.DeleteCurrentAccessTokenOptions): Promise<T.JSONResponse<T.OKResponse>>;
+    /**
      * Revoke all active access tokens
      * @param {Object} options            Options for this API call
      * @param {string} [options.auth]     The access token. Can be ignored if provided in constructor
      * @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
+     * @returns {Promise<T.JSONResponse<T.OKResponse>>} A promise that resolves with the response data
      */
-	deleteActiveAccessTokens({ auth, headers, context }){
-		return this.delete({
-			uri: '/v1/access_tokens',
-			auth,
-			headers,
-			context
-		});
-	}
-
-	/**
+    deleteActiveAccessTokens({ auth, headers, context }: T.DeleteActiveAccessTokensOptions): Promise<T.JSONResponse<T.OKResponse>>;
+    /**
      * Delete the current user
      * @param {Object} options            Options for this API call
      * @param {string} [options.auth]     The access token. Can be ignored if provided in constructor
      * @param {String} options.password   Password
      * @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
+     * @returns {Promise<T.JSONResponse<T.OKResponse>>} A promise that resolves with the response data
      */
-	deleteUser({ auth, password, headers, context }){
-		return this.delete({
-			uri: '/v1/user',
-			data: { password },
-			auth,
-			headers,
-			context
-		});
-	}
-
-	/**
+    deleteUser({ auth, password, headers, context }: T.DeleteUserOptions): Promise<T.JSONResponse<T.OKResponse>>;
+    /**
      * Retrieves the information that is used to identify the current login for tracking.
      * @param {Object}  [options]          Options for this API call
      * @param {string}  [options.auth]     The access token. Can be ignored if provided in constructor
@@ -387,19 +191,10 @@ class Particle {
      *                                     retrieve only the unique tracking ID for the current login.
      * @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<Object>} Resolve the tracking identify of the current login
-     */
-	trackingIdentity({ full = false, auth, headers, context } = {}){
-		return this.get({
-			uri: '/v1/user/identify',
-			auth,
-			headers,
-			query: (full ? undefined : { tracking: 1 }),
-			context
-		});
-	}
-
-	/**
+     * @returns {Promise<T.JSONResponse<T.TrackingIdentityResponse>>} A promise that resolves with the response data
+     */
+    trackingIdentity({ full, auth, headers, context }?: T.TrackingIdentityOptions): Promise<T.JSONResponse<T.TrackingIdentityResponse>>;
+    /**
      * List devices claimed to the account or product
      * @param {Object}         options               Options for this API call
      * @param {String}         [options.deviceId]    (Product only) Filter results to devices with this ID (partial matching)
@@ -413,30 +208,10 @@ class Particle {
      * @param {string}         [options.auth]        The access token. Can be ignored if provided in constructor
      * @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
+     * @returns {Promise<T.JSONResponse<T.DeviceInfo[] | T.DeviceListResponse>>} A promise that resolves with the response data
      */
-	listDevices({ deviceId, deviceName, groups, sortAttr, sortDir, page, perPage, product, auth, headers, context }){
-		let uri, query;
-
-		if (product){
-			uri = `/v1/products/${product}/devices`;
-			query = {
-				deviceId,
-				deviceName,
-				groups: Array.isArray(groups) ? groups.join(',') : undefined,
-				sortAttr,
-				sortDir,
-				page,
-				per_page: perPage
-			};
-		} else {
-			uri = '/v1/devices';
-		}
-
-		return this.get({ uri, auth, headers, query, context });
-	}
-
-	/**
+    listDevices({ deviceId, deviceName, groups, sortAttr, sortDir, page, perPage, product, auth, headers, context }: T.ListDevicesOptions): Promise<T.JSONResponse<T.DeviceInfo[] | T.DeviceListResponse>>;
+    /**
      * Get detailed informationa about a device
      * @param {Object} options            Options for this API call
      * @param {String} options.deviceId   Device ID or Name
@@ -444,14 +219,10 @@ class Particle {
      * @param {string} [options.auth]     The access token. Can be ignored if provided in constructor
      * @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
+     * @returns {Promise<T.JSONResponse<T.DeviceInfo>>} A promise that resolves with the response data
      */
-	getDevice({ deviceId, product, auth, headers, context }){
-		const uri = this.deviceUri({ deviceId, product });
-		return this.get({ uri, auth, headers, context });
-	}
-
-	/**
+    getDevice({ deviceId, product, auth, headers, context }: T.GetDeviceOptions): Promise<T.JSONResponse<T.DeviceInfo>>;
+    /**
      * Claim a device to the account. The device must be online and unclaimed.
      * @param {Object}  options                  Options for this API call
      * @param {String}  options.deviceId         Device ID
@@ -459,22 +230,10 @@ class Particle {
      * @param {boolean} options.requestTransfer  True to request the device be transfered from another user
      * @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
+     * @returns {Promise<T.JSONResponse<T.ClaimResponse>>} A promise that resolves with the response data
      */
-	claimDevice({ deviceId, requestTransfer, auth, headers, context }){
-		return this.post({
-			uri: '/v1/devices',
-			auth,
-			headers,
-			data: {
-				id: deviceId,
-				request_transfer: !!requestTransfer
-			},
-			context
-		});
-	}
-
-	/**
+    claimDevice({ deviceId, requestTransfer, auth, headers, context }: T.ClaimDeviceOptions): Promise<T.JSONResponse<T.ClaimResponse>>;
+    /**
      * Add a device to a product or move device out of quarantine.
      * @param {Object} options            Options for this API call
      * @param {String} options.deviceId   Device ID
@@ -484,29 +243,10 @@ class Particle {
      * @param {string} [options.auth]     The access token. Can be ignored if provided in constructor
      * @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
+     * @returns {Promise<T.JSONResponse<T.OKResponse>>} A promise that resolves with the response data
      */
-	addDeviceToProduct({ deviceId, product, file, auth, headers, context }){
-		let files, data;
-
-		if (file){
-			files = { file };
-		} else if (deviceId){
-			data = { id: deviceId };
-		}
-
-		return this.request({
-			uri: `/v1/products/${product}/devices`,
-			method: 'post',
-			headers,
-			data,
-			files,
-			auth,
-			context
-		});
-	}
-
-	/**
+    addDeviceToProduct({ deviceId, product, file, auth, headers, context }: T.AddDeviceToProductOptions): Promise<T.JSONResponse<T.OKResponse>>;
+    /**
      * Unclaim / Remove a device from your account or product, or deny quarantine
      * @param {Object}  options            Options for this API call
      * @param {String}  options.deviceId   Device ID or Name
@@ -515,15 +255,10 @@ class Particle {
      * @param {string}  [options.auth]     The access token. Can be ignored if provided in constructor
      * @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
+     * @returns {Promise<T.JSONResponse<T.OKResponse>>} A promise that resolves with the response data
      */
-	removeDevice({ deviceId, deny, product, auth, headers, context }){
-		const uri = this.deviceUri({ deviceId, product });
-		const data = product ? { deny } : undefined;
-		return this.delete({ uri, data, auth, headers, context });
-	}
-
-	/**
+    removeDevice({ deviceId, deny, product, auth, headers, context }: T.RemoveDeviceOptions): Promise<T.JSONResponse<T.OKResponse>>;
+    /**
      * Unclaim a product device its the owner, but keep it in the product
      * @param {Object} options            Options for this API call
      * @param {String} options.deviceId   Device ID or Name
@@ -531,14 +266,10 @@ class Particle {
      * @param {string} [options.auth]     The access token. Can be ignored if provided in constructor
      * @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
+     * @returns {Promise<T.JSONResponse<T.OKResponse>>} A promise that resolves with the response data
      */
-	removeDeviceOwner({ deviceId, product, auth, headers, context }){
-		const uri = `/v1/products/${product}/devices/${deviceId}/owner`;
-		return this.delete({ uri, auth, headers, context });
-	}
-
-	/**
+    removeDeviceOwner({ deviceId, product, auth, headers, context }: T.RemoveDeviceOwnerOptions): Promise<T.JSONResponse<T.OKResponse>>;
+    /**
      * Rename a device
      * @param {Object} options            Options for this API call
      * @param {String} options.deviceId   Device ID or Name
@@ -547,13 +278,10 @@ class Particle {
      * @param {string} [options.auth]     The access token. Can be ignored if provided in constructor
      * @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
+     * @returns {Promise<T.JSONResponse<T.DeviceInfo>>} A promise that resolves with the response data
      */
-	renameDevice({ deviceId, name, product, auth, headers, context }){
-		return this.updateDevice({ deviceId, name, product, auth, headers, context });
-	}
-
-	/**
+    renameDevice({ deviceId, name, product, auth, headers, context }: T.RenameDeviceOptions): Promise<T.JSONResponse<T.DeviceInfo>>;
+    /**
      * Instruct the device to turn on/off the LED in a rainbow pattern
      * @param {Object} options            Options for this API call
      * @param {String} options.deviceId   Device ID or Name
@@ -562,13 +290,10 @@ class Particle {
      * @param {string} [options.auth]     The access token. Can be ignored if provided in constructor
      * @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
+     * @returns {Promise<T.JSONResponse<T.DeviceInfo>>} A promise that resolves with the response data
      */
-	signalDevice({ deviceId, signal, product, auth, headers, context }){
-		return this.updateDevice({ deviceId, signal, product, auth, headers, context });
-	}
-
-	/**
+    signalDevice({ deviceId, signal, product, auth, headers, context }: T.SignalDeviceOptions): Promise<T.JSONResponse<T.DeviceInfo>>;
+    /**
      * Store some notes about device
      * @param {Object} options            Options for this API call
      * @param {String} options.deviceId   Device ID or Name
@@ -577,13 +302,20 @@ class Particle {
      * @param {string} [options.auth]     The access token. Can be ignored if provided in constructor
      * @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
-     */
-	setDeviceNotes({ deviceId, notes, product, auth, headers, context }){
-		return this.updateDevice({ deviceId, notes, product, auth, headers, context });
-	}
-
-	/**
+     * @returns {Promise<T.JSONResponse<T.DeviceInfo>>} A promise that resolves with the response data
+     */
+    setDeviceNotes({ deviceId, notes, product, auth, headers, context }: {
+        deviceId: string;
+        notes: string;
+        product?: string | number;
+        auth?: string;
+        headers?: Record<string, string>;
+        context?: {
+            tool?: T.ToolContext;
+            project?: T.ProjectContext;
+        };
+    }): Promise<T.JSONResponse<T.DeviceInfo>>;
+    /**
      * Mark device as being used in development of a product so it opts out of automatic firmware updates
      * @param {Object} options               Options for this API call
      * @param {String} options.deviceId      Device ID or Name
@@ -592,13 +324,20 @@ class Particle {
      * @param {string} [options.auth]        The access token. Can be ignored if provided in constructor
      * @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
-     */
-	markAsDevelopmentDevice({ deviceId, development = true, product, auth, headers, context }){
-		return this.updateDevice({ deviceId, development, product, auth, headers, context });
-	}
-
-	/**
+     * @returns {Promise<T.JSONResponse<T.DeviceInfo>>} A promise that resolves with the response data
+     */
+    markAsDevelopmentDevice({ deviceId, development, product, auth, headers, context }: {
+        deviceId: string;
+        development?: boolean;
+        product: string | number;
+        auth?: string;
+        headers?: Record<string, string>;
+        context?: {
+            tool?: T.ToolContext;
+            project?: T.ProjectContext;
+        };
+    }): Promise<T.JSONResponse<T.DeviceInfo>>;
+    /**
      * Mark device as being used in development of a product, so it opts out of automatic firmware updates
      * @param {Object}  options                         Options for this API call
      * @param {String}  options.deviceId                Device ID or Name
@@ -608,13 +347,21 @@ class Particle {
      * @param {string}  [options.auth]                  The access token. Can be ignored if provided in constructor
      * @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
-     */
-	lockDeviceProductFirmware({ deviceId, desiredFirmwareVersion, flash, product, auth, headers, context }){
-		return this.updateDevice({ deviceId, desiredFirmwareVersion, flash, product, auth, headers, context });
-	}
-
-	/**
+     * @returns {Promise<T.JSONResponse<T.DeviceInfo>>} A promise that resolves with the response data
+     */
+    lockDeviceProductFirmware({ deviceId, desiredFirmwareVersion, flash, product, auth, headers, context }: {
+        deviceId: string;
+        desiredFirmwareVersion: number;
+        flash?: boolean;
+        product: string | number;
+        auth?: string;
+        headers?: Record<string, string>;
+        context?: {
+            tool?: T.ToolContext;
+            project?: T.ProjectContext;
+        };
+    }): Promise<T.JSONResponse<T.DeviceInfo>>;
+    /**
      * Mark device as receiving automatic firmware updates
      * @param {Object} options            Options for this API call
      * @param {String} options.deviceId   Device ID or Name
@@ -622,13 +369,19 @@ class Particle {
      * @param {string} [options.auth]     The access token. Can be ignored if provided in constructor
      * @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
+     * @returns {Promise<T.JSONResponse<T.DeviceInfo>>} A promise that resolves with the response data
      */
-	unlockDeviceProductFirmware({ deviceId, product, auth, headers, context }){
-		return this.updateDevice({ deviceId, desiredFirmwareVersion: null, product, auth, headers, context });
-	}
-
-	/**
+    unlockDeviceProductFirmware({ deviceId, product, auth, headers, context }: {
+        deviceId: string;
+        product: string | number;
+        auth?: string;
+        headers?: Record<string, string>;
+        context?: {
+            tool?: T.ToolContext;
+            project?: T.ProjectContext;
+        };
+    }): Promise<T.JSONResponse<T.DeviceInfo>>;
+    /**
      * Update multiple device attributes at the same time
      * @param {Object}        options                           Options for this API call
      * @param {String}        options.deviceId                  Device ID or Name
@@ -643,23 +396,10 @@ class Particle {
      * @param {string}        [options.auth]                    The access token. Can be ignored if provided in constructor
      * @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
+     * @returns {Promise<T.JSONResponse<T.DeviceInfo>>} A promise that resolves with the response data
      */
-	updateDevice({ deviceId, name, signal, notes, development, desiredFirmwareVersion, flash, product, auth, headers, context }){
-		let signalValue;
-		if (signal !== undefined){
-			signalValue = signal ? '1' : '0';
-		}
-
-		const uri = this.deviceUri({ deviceId, product });
-		const data = product ?
-			{ name, signal: signalValue, notes, development, desired_firmware_version: desiredFirmwareVersion, flash } :
-			{ name, signal: signalValue, notes };
-
-		return this.put({ uri, auth, headers, data, context });
-	}
-
-	/**
+    updateDevice({ deviceId, name, signal, notes, development, desiredFirmwareVersion, flash, product, auth, headers, context }: T.UpdateDeviceOptions): Promise<T.JSONResponse<T.DeviceInfo>>;
+    /**
      * Disable device protection.
      *
      * @param {Object} options                   Options for this API call.
@@ -675,46 +415,20 @@ class Particle {
      * @param {string} [options.auth]            The access token. Can be ignored if provided in constructor.
      * @param {Object} [options.headers]         Key/value pairs to send as headers.
      * @param {Object} [options.context]         Request context.
-     * @returns {Promise} A promise
+     * @returns {Promise<T.JSONResponse<T.OKResponse>>} A promise that resolves with the response data
      */
-	unprotectDevice({ deviceId, org, product, action, serverNonce, deviceNonce, deviceSignature, devicePublicKeyFingerprint, auth, headers, context }) {
-		const data = { action };
-		if (deviceNonce !== undefined) {
-			data.device_nonce = deviceNonce;
-		}
-		if (serverNonce !== undefined) {
-			data.server_nonce = serverNonce;
-		}
-		if (deviceSignature !== undefined) {
-			data.device_signature = deviceSignature;
-		}
-		if (devicePublicKeyFingerprint !== undefined) {
-			data.device_public_key_fingerprint = devicePublicKeyFingerprint;
-		}
-		const uri = this.deviceUri({ deviceId, product, org }) + '/unprotect';
-		return this.put({ uri, data, auth, headers, context });
-	}
-
-	/**
+    unprotectDevice({ deviceId, org, product, action, serverNonce, deviceNonce, deviceSignature, devicePublicKeyFingerprint, auth, headers, context }: T.UnprotectDeviceOptions): Promise<T.JSONResponse<T.OKResponse>>;
+    /**
      * Provision a new device for products that allow self-provisioning
      * @param {Object} options            Options for this API call
      * @param {String} options.productId  Product ID where to create this device
      * @param {string} [options.auth]     The access token. Can be ignored if provided in constructor
      * @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
+     * @returns {Promise<T.JSONResponse<T.DeviceInfo>>} A promise that resolves with the response data
      */
-	provisionDevice({ productId, auth, headers, context }){
-		return this.post({
-			uri: '/v1/devices',
-			auth,
-			headers,
-			data: { product_id: productId },
-			context
-		});
-	}
-
-	/**
+    provisionDevice({ productId, auth, headers, context }: T.ProvisionDeviceOptions): Promise<T.JSONResponse<T.DeviceInfo>>;
+    /**
      * Generate a claim code to use in the device claiming process.
      * To generate a claim code for a product, the access token MUST belong to a
      * customer of the product.
@@ -724,23 +438,10 @@ class Particle {
      * @param {string} [options.auth]     The access token. Can be ignored if provided in constructor
      * @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
+     * @returns {Promise<T.JSONResponse<T.ClaimCodeResponse>>} A promise that resolves with the response data
      */
-	getClaimCode({ iccid, product, auth, headers, context }){
-		const uri = product ? `/v1/products/${product}/device_claims` : '/v1/device_claims';
-		return this.post({ uri, auth, headers, data: { iccid }, context });
-	}
-
-	validatePromoCode({ promoCode, auth, headers, context }){
-		return this.get({
-			uri: `/v1/promo_code/${promoCode}`,
-			auth,
-			headers,
-			context
-		});
-	}
-
-	/**
+    getClaimCode({ iccid, product, auth, headers, context }: T.GetClaimCodeOptions): Promise<T.JSONResponse<T.ClaimCodeResponse>>;
+    /**
      * Get the value of a device variable
      * @param {Object} options            Options for this API call
      * @param {String} options.deviceId   Device ID or Name
@@ -749,17 +450,10 @@ class Particle {
      * @param {string} [options.auth]     The access token. Can be ignored if provided in constructor
      * @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
+     * @returns {Promise<T.JSONResponse<T.DeviceVariableResponse>>} A promise that resolves with the response data
      */
-	getVariable({ deviceId, name, product, auth, headers, context }){
-		const uri = product ?
-			`/v1/products/${product}/devices/${deviceId}/${name}` :
-			`/v1/devices/${deviceId}/${name}`;
-
-		return this.get({ uri, auth, headers, context });
-	}
-
-	/**
+    getVariable({ deviceId, name, product, auth, headers, context }: T.GetVariableOptions): Promise<T.JSONResponse<T.DeviceVariableResponse>>;
+    /**
      * Compile and flash application firmware to a device. Pass a pre-compiled binary to flash it directly to the device.
      * @param {Object} options                         Options for this API call
      * @param {String} options.deviceId                Device ID or Name
@@ -769,48 +463,10 @@ class Particle {
      * @param {string} [options.auth]                  The access token. Can be ignored if provided in constructor
      * @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
-     */
-	flashDevice({ deviceId, product, files, targetVersion, auth, headers, context }){
-		const uri = this.deviceUri({ deviceId, product });
-		const form = {};
-
-		if (targetVersion){
-			form.build_target_version = targetVersion;
-		} else {
-			form.latest = 'true';
-		}
-
-		return this.request({ uri, method: 'put', auth, headers, files, form, context });
-	}
-
-	/**
-     * DEPRECATED: Flash the Tinker application to a device. Instead compile and flash the Tinker source code.
-     * @param {Object} options            Options for this API call
-     * @param {String} options.deviceId   Device ID or Name
-     * @param {string} [options.auth]     The access token. Can be ignored if provided in constructor
-     * @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
+     * @returns {Promise<T.JSONResponse<T.OKResponse>>} A promise that resolves with the response data
      */
-	flashTinker({ deviceId, auth, headers, context }){
-		/* eslint-disable no-console */
-		/* @ts-ignore */
-		if (console && console.warning){
-			// @ts-ignore
-			console.warning('Particle.flashTinker is deprecated');
-		}
-		/* eslint-enable no-console */
-		return this.put({
-			uri: `/v1/devices/${deviceId}`,
-			headers,
-			data: { app: 'tinker' },
-			auth,
-			context
-		});
-	}
-
-	/**
+    flashDevice({ deviceId, product, files, targetVersion, auth, headers, context }: T.FlashDeviceOptions): Promise<T.JSONResponse<T.OKResponse>>;
+    /**
      * Compile firmware using the Particle Cloud
      * @param {Object} options                         Options for this API call
      * @param {Object} options.files                   Object containing files to be compiled. Keys should be the filenames, including relative path, and the values should be a path or Buffer of the file contents in Node, or a File or Blob in the browser.
@@ -819,49 +475,20 @@ class Particle {
      * @param {string} [options.auth]                  The access token. Can be ignored if provided in constructor
      * @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
+     * @returns {Promise<T.JSONResponse<T.CompileResponse>>} A promise that resolves with the response data
      */
-	compileCode({ files, platformId, targetVersion, auth, headers, context }){
-		const form = { platform_id: platformId };
-
-		if (targetVersion){
-			form.build_target_version = targetVersion;
-		} else {
-			form.latest = 'true';
-		}
-
-		return this.request({
-			uri: '/v1/binaries',
-			method: 'post',
-			auth,
-			headers,
-			files,
-			form,
-			context
-		});
-	}
-
-	/**
+    compileCode({ files, platformId, targetVersion, auth, headers, context }: T.CompileCodeOptions): Promise<T.JSONResponse<T.CompileResponse>>;
+    /**
      * Download a firmware binary
      * @param {Object} options            Options for this API call
      * @param {String} options.binaryId   Binary ID received from a successful compile call
      * @param {string} [options.auth]     The access token. Can be ignored if provided in constructor
      * @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<RequestResponse, RequestError>} A promise
-     */
-	downloadFirmwareBinary({ binaryId, auth, headers, context }){
-		return this.request({
-			uri: `/v1/binaries/${binaryId}`,
-			method: 'get',
-			auth,
-			headers,
-			context,
-			isBuffer: true
-		});
-	}
-
-	/**
+     * @returns {Promise<Buffer | ArrayBuffer>} A promise that resolves with the binary data
+     */
+    downloadFirmwareBinary({ binaryId, auth, headers, context }: T.DownloadFirmwareBinaryOptions): Promise<Buffer | ArrayBuffer>;
+    /**
      * Send a new device public key to the Particle Cloud
      * @param {Object}          options                  Options for this API call
      * @param {String}          options.deviceId         Device ID or Name
@@ -870,25 +497,10 @@ class Particle {
      * @param {string}          [options.auth]           The access token. Can be ignored if provided in constructor
      * @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
+     * @returns {Promise<T.JSONResponse<T.OKResponse>>} A promise that resolves with the response data
      */
-	sendPublicKey({ deviceId, key, algorithm, auth, headers, context }){
-		return this.post({
-			uri: `/v1/provisioning/${deviceId}`,
-			auth,
-			headers,
-			data: {
-				deviceID: deviceId,
-				publicKey: (typeof key === 'string' ? key : key.toString()),
-				filename: 'particle-api',
-				order: `manual_${ Date.now() }`,
-				algorithm: algorithm || 'rsa'
-			},
-			context
-		});
-	}
-
-	/**
+    sendPublicKey({ deviceId, key, algorithm, auth, headers, context }: T.SendPublicKeyOptions): Promise<T.JSONResponse<T.OKResponse>>;
+    /**
      * Call a device function
      * @param {Object} options            Options for this API call
      * @param {String} options.deviceId   Device ID or Name
@@ -898,16 +510,10 @@ class Particle {
      * @param {string} [options.auth]     The access token. Can be ignored if provided in constructor
      * @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
+     * @returns {Promise<T.JSONResponse<T.FunctionCallResponse>>} A promise that resolves with the response data
      */
-	callFunction({ deviceId, name, argument, product, auth, headers, context }){
-		const uri = product ?
-			`/v1/products/${product}/devices/${deviceId}/${name}` :
-			`/v1/devices/${deviceId}/${name}`;
-		return this.post({ uri, auth, headers, data: { args: argument }, context });
-	}
-
-	/**
+    callFunction({ deviceId, name, argument, product, auth, headers, context }: T.CallFunctionOptions): Promise<T.JSONResponse<T.FunctionCallResponse>>;
+    /**
      * Get a stream of events
      * @param {Object} options             Options for this API call
      * @param {String} [options.deviceId]  Device ID or Name, or `mine` to indicate only your devices.
@@ -915,37 +521,11 @@ class Particle {
      * @param {String} [options.org]       Organization Slug
      * @param {String} [options.product]   Events for this product ID or slug
      * @param {string} [options.auth]      The access token. Can be ignored if provided in constructor
-     * @returns {Promise} If the promise resolves, the resolution value will be an EventStream object that will
+     * @returns {Promise<EventStream>} A promise that resolves with the response data
      * emit 'event' events.
      */
-	getEventStream({ deviceId, name, org, product, auth }){
-		let uri = '/v1/';
-		if (org){
-			uri += `orgs/${org}/`;
-		}
-
-		if (product){
-			uri += `products/${product}/`;
-		}
-
-		if (deviceId){
-			uri += 'devices/';
-			if (!(deviceId.toLowerCase() === 'mine')){
-				uri += `${deviceId}/`;
-			}
-		}
-
-		uri += 'events';
-
-		if (name){
-			uri += `/${encodeURIComponent(name)}`;
-		}
-
-		auth = this._getActiveAuthToken(auth);
-		return new EventStream(`${this.baseUrl}${uri}`, auth).connect();
-	}
-
-	/**
+    getEventStream({ deviceId, name, org, product, auth }: T.GetEventStreamOptions): Promise<EventStream>;
+    /**
      * Publish a event to the Particle Cloud
      * @param {Object}  options            Options for this API call
      * @param {String}  options.name       Event name
@@ -955,15 +535,10 @@ class Particle {
      * @param {string}  [options.auth]     The access token. Can be ignored if provided in constructor
      * @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
+     * @returns {Promise<T.JSONResponse<T.OKResponse>>} A promise that resolves with the response data
      */
-	publishEvent({ name, data, isPrivate, product, auth, headers, context }){
-		const uri = product ? `/v1/products/${product}/events` : '/v1/devices/events';
-		const postData = { name, data, private: isPrivate };
-		return this.post({ uri, auth, headers, data: postData, context });
-	}
-
-	/**
+    publishEvent({ name, data, isPrivate, product, auth, headers, context }: T.PublishEventOptions): Promise<T.JSONResponse<T.OKResponse>>;
+    /**
      * @typedef  {Object}  Hook
      * @property {String}  [method=POST]         Type of web request triggered by the Webhook (GET, POST, PUT, or DELETE)
      * @property {Object}  [auth]                Auth data like `{ user: 'me', pass: '1234' }` for basic auth or `{ bearer: 'token' }` to send with the Webhook request
@@ -976,8 +551,7 @@ class Particle {
      * @property {Object}  [responseEvent]       The Webhook response event name that your devices can subscribe to
      * @property {Object}  [errorResponseEvent]  The Webhook error response event name that your devices can subscribe to
      */
-
-	/**
+    /**
      * Create a webhook
      * @param {Object}  options                       Options for this API call
      * @param {String}  options.event                 The name of the Particle event that should trigger the Webhook
@@ -990,33 +564,10 @@ class Particle {
      * @param {string}  [options.auth]                The access token. Can be ignored if provided in constructor
      * @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
+     * @returns {Promise<T.JSONResponse<T.CreateWebhookResponse>>} A promise that resolves with the response data
      */
-	createWebhook({ event, url, device, rejectUnauthorized, noDefaults, hook, product, auth, headers, context }){
-		const uri = product ? `/v1/products/${product}/webhooks` : '/v1/webhooks';
-		const data = { event, url, deviceId: device, rejectUnauthorized, noDefaults };
-
-		if (hook){
-			data.requestType = hook.method;
-			data.auth = hook.auth;
-			data.headers = hook.headers;
-			data.query = hook.query;
-			data.json = hook.json;
-			data.form = hook.form;
-			data.body = hook.body;
-			data.responseTemplate = hook.responseTemplate;
-			data.responseTopic = hook.responseEvent;
-			data.errorResponseTopic = hook.errorResponseEvent;
-		}
-
-		if (!data.requestType){
-			data.requestType = 'POST';
-		}
-
-		return this.post({ uri, auth, headers, data, context });
-	}
-
-	/**
+    createWebhook({ event, url, device, rejectUnauthorized, noDefaults, hook, product, auth, headers, context }: T.CreateWebhookOptions): Promise<T.JSONResponse<T.CreateWebhookResponse>>;
+    /**
      * Delete a webhook
      * @param {Object} options            Options for this API call
      * @param {String} options.hookId     Webhook ID
@@ -1024,28 +575,20 @@ class Particle {
      * @param {string} [options.auth] The access token. Can be ignored if provided in constructor
      * @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
+     * @returns {Promise<T.JSONResponse<T.OKResponse>>} A promise that resolves with the response data
      */
-	deleteWebhook({ hookId, product, auth, headers, context }){
-		const uri = product ? `/v1/products/${product}/webhooks/${hookId}` : `/v1/webhooks/${hookId}`;
-		return this.delete({ uri, auth, headers, context });
-	}
-
-	/**
+    deleteWebhook({ hookId, product, auth, headers, context }: T.DeleteWebhookOptions): Promise<T.JSONResponse<T.OKResponse>>;
+    /**
      * List all webhooks owned by the account or product
      * @param {Object} options            Options for this API call
      * @param {String} [options.product]  Webhooks for this product ID or slug
      * @param {string} [options.auth] The access token. Can be ignored if provided in constructor
      * @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
+     * @returns {Promise<T.JSONResponse<T.WebhookInfo[]>>} A promise that resolves with the response data
      */
-	listWebhooks({ product, auth, headers, context }){
-		const uri = product ? `/v1/products/${product}/webhooks` : '/v1/webhooks';
-		return this.get({ uri, auth, headers, context });
-	}
-
-	/**
+    listWebhooks({ product, auth, headers, context }: T.ListWebhooksOptions): Promise<T.JSONResponse<T.WebhookInfo[]>>;
+    /**
      * Create an integration to send events to an external service
      *
      * See the API docs for details https://docs.particle.io/reference/api/#integrations-webhooks-
@@ -1058,15 +601,10 @@ class Particle {
      * @param {string} [options.auth]      The access token. Can be ignored if provided in constructor
      * @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
+     * @returns {Promise<T.JSONResponse<T.IntegrationInfo>>} A promise that resolves with the response data
      */
-	createIntegration({ event, settings, deviceId, product, auth, headers, context }){
-		const uri = product ? `/v1/products/${product}/integrations` : '/v1/integrations';
-		const data = Object.assign({ event, deviceid: deviceId }, settings);
-		return this.post({ uri, data, auth, headers, context });
-	}
-
-	/**
+    createIntegration({ event, settings, deviceId, product, auth, headers, context }: T.CreateIntegrationOptions): Promise<T.JSONResponse<T.IntegrationInfo>>;
+    /**
      * Edit an integration to send events to an external service
      *
      * See the API docs for details https://docs.particle.io/reference/api/#integrations-webhooks-
@@ -1080,15 +618,10 @@ class Particle {
      * @param {string} [options.auth]         The access token. Can be ignored if provided in constructor
      * @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
+     * @returns {Promise<T.JSONResponse<T.IntegrationInfo>>} A promise that resolves with the response data
      */
-	editIntegration({ integrationId, event, settings, deviceId, product, auth, headers, context }){
-		const uri = product ? `/v1/products/${product}/integrations/${integrationId}` : `/v1/integrations/${integrationId}`;
-		const data = Object.assign({ event, deviceid: deviceId }, settings);
-		return this.put({ uri, auth, headers, data, context });
-	}
-
-	/**
+    editIntegration({ integrationId, event, settings, deviceId, product, auth, headers, context }: T.EditIntegrationOptions): Promise<T.JSONResponse<T.IntegrationInfo>>;
+    /**
      * Delete an integration to send events to an external service
      *
      * @param {Object} options                Options for this API call
@@ -1097,54 +630,46 @@ class Particle {
      * @param {string} [options.auth]         The access token. Can be ignored if provided in constructor
      * @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
+     * @returns {Promise<T.JSONResponse<T.OKResponse>>} A promise that resolves with the response data
      */
-	deleteIntegration({ integrationId, product, auth, headers, context }){
-		const uri = product ? `/v1/products/${product}/integrations/${integrationId}` : `/v1/integrations/${integrationId}`;
-		return this.delete({ uri, auth, headers, context });
-	}
-
-	/**
+    deleteIntegration({ integrationId, product, auth, headers, context }: T.DeleteIntegrationOptions): Promise<T.JSONResponse<T.OKResponse>>;
+    /**
      * List all integrations owned by the account or product
      * @param {Object} options            Options for this API call
      * @param {String} [options.product]  Integrations for this product ID or slug
      * @param {string} [options.auth]     The access token. Can be ignored if provided in constructor
      * @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
+     * @returns {Promise<T.JSONResponse<T.IntegrationInfo[]>>} A promise that resolves with the response data
      */
-	listIntegrations({ product, auth, headers, context }){
-		const uri = product ? `/v1/products/${product}/integrations` : '/v1/integrations';
-		return this.get({ uri, auth, headers, context });
-	}
-
-	/**
+    listIntegrations({ product, auth, headers, context }: T.ListIntegrationsOptions): Promise<T.JSONResponse<T.IntegrationInfo[]>>;
+    /**
      * Get details about the current user
      * @param {Object} options            Options for this API call
      * @param {string} [options.auth]     The access token. Can be ignored if provided in constructor
      * @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
+     * @returns {Promise<T.JSONResponse<T.UserInfo>>} A promise that resolves with the response data
      */
-	getUserInfo({ auth, headers, context }){
-		return this.get({ uri: '/v1/user', auth, headers, context });
-	}
-
-	/**
+    getUserInfo({ auth, headers, context }: {
+        auth?: string;
+        headers?: Record<string, string>;
+        context?: {
+            tool?: T.ToolContext;
+            project?: T.ProjectContext;
+        };
+    }): Promise<T.JSONResponse<T.UserInfo>>;
+    /**
      * Set details on the current user
      * @param {Object} options              Options for this API call
      * @param {string} [options.auth]       The access token. Can be ignored if provided in constructor
      * @param {String} options.accountInfo  Set user's extended info fields (name, business account, company name, etc)
      * @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
+     * @returns {Promise<T.JSONResponse<T.UserInfo>>} A promise that resolves with the response data
      */
-	setUserInfo({ accountInfo, auth, headers, context }){
-		const data = { account_info: accountInfo };
-		return this.put({ uri: '/v1/user', auth, headers, data, context });
-	}
-
-	/**
+    setUserInfo({ accountInfo, auth, headers, context }: T.SetUserInfoOptions): Promise<T.JSONResponse<T.UserInfo>>;
+    /**
      * Change username (i.e, email)
      * @param {Object}  options                   Options for this API call
      * @param {string}  [options.auth]            The access token. Can be ignored if provided in constructor
@@ -1153,19 +678,10 @@ class Particle {
      * @param {Boolean} options.invalidateTokens  Should all tokens be invalidated
      * @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
+     * @returns {Promise<T.JSONResponse<T.OKResponse>>} A promise that resolves with the response data
      */
-	changeUsername({ currentPassword, username, invalidateTokens = false, auth, headers, context }){
-		const data = { username, current_password: currentPassword };
-
-		if (invalidateTokens) {
-			data.invalidate_tokens = true;
-		}
-
-		return this.put({ uri: '/v1/user', auth, headers, data, context });
-	}
-
-	/**
+    changeUsername({ currentPassword, username, invalidateTokens, auth, headers, context }: T.ChangeUsernameOptions): Promise<T.JSONResponse<T.OKResponse>>;
+    /**
      * Change user's password
      * @param {Object}  options                   Options for this API call
      * @param {string}  [options.auth]            The access token. Can be ignored if provided in constructor
@@ -1174,19 +690,10 @@ class Particle {
      * @param {Boolean} options.invalidateTokens  Should all tokens be invalidated
      * @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
+     * @returns {Promise<T.JSONResponse<T.OKResponse>>} A promise that resolves with the response data
      */
-	changeUserPassword({ currentPassword, password, invalidateTokens = false, auth, headers, context }){
-		const data = { password, current_password: currentPassword };
-
-		if (invalidateTokens) {
-			data.invalidate_tokens = true;
-		}
-
-		return this.put({ uri: '/v1/user', auth, headers, data, context });
-	}
-
-	/**
+    changeUserPassword({ currentPassword, password, invalidateTokens, auth, headers, context }: T.ChangeUserPasswordOptions): Promise<T.JSONResponse<T.OKResponse>>;
+    /**
      * List SIM cards owned by a user or product
      * @param {Object} options               Options for this API call
      * @param {String} [options.iccid]       (Product only) Filter to SIM cards matching this ICCID
@@ -1198,15 +705,10 @@ class Particle {
      * @param {string} [options.auth]        The access token. Can be ignored if provided in constructor
      * @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
+     * @returns {Promise<T.JSONResponse<T.SimInfo[]>>} A promise that resolves with the response data
      */
-	listSIMs({ iccid, deviceId, deviceName, page, perPage, product, auth, headers, context }){
-		const uri = product ? `/v1/products/${product}/sims` : '/v1/sims';
-		const query = product ? { iccid, deviceId, deviceName, page, per_page: perPage } : undefined;
-		return this.get({ uri, auth, headers, query, context });
-	}
-
-	/**
+    listSIMs({ iccid, deviceId, deviceName, page, perPage, product, auth, headers, context }: T.ListSIMsOptions): Promise<T.JSONResponse<T.SimInfo[]>>;
+    /**
      * Get data usage for one SIM card for the current billing period
      * @param {Object} options            Options for this API call
      * @param {String} options.iccid      ICCID of the SIM card
@@ -1214,123 +716,30 @@ class Particle {
      * @param {string} [options.auth]     The access token. Can be ignored if provided in constructor
      * @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
+     * @returns {Promise<T.JSONResponse<T.SimDataUsage>>} A promise that resolves with the response data
      */
-	getSIMDataUsage({ iccid, product, auth, headers, context }){
-		const uri = product ?
-			`/v1/products/${product}/sims/${iccid}/data_usage` :
-			`/v1/sims/${iccid}/data_usage`;
-
-		return this.get({ uri, auth, headers, context });
-	}
-
-	/**
+    getSIMDataUsage({ iccid, product, auth, headers, context }: T.GetSIMDataUsageOptions): Promise<T.JSONResponse<T.SimDataUsage>>;
+    /**
      * Get data usage for all SIM cards in a product the current billing period
      * @param {Object} options            Options for this API call
      * @param {String} options.product    SIM cards for this product ID or slug
      * @param {string} [options.auth]     The access token. Can be ignored if provided in constructor
      * @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
+     * @returns {Promise<T.JSONResponse<T.SimDataUsage>>} A promise that resolves with the response data
      */
-	getFleetDataUsage({ product, auth, headers, context }){
-		return this.get({
-			uri: `/v1/products/${product}/sims/data_usage`,
-			auth,
-			headers,
-			context
-		});
-	}
-
-	/**
+    getFleetDataUsage({ product, auth, headers, context }: T.GetFleetDataUsageOptions): Promise<T.JSONResponse<T.SimDataUsage>>;
+    /**
      * Check SIM status
      * @param {Object} options            Options for this API call
      * @param {String} options.iccid      ICCID of the SIM card
      * @param {string} [options.auth]     The access token. Can be ignored if provided in constructor
      * @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
-     */
-	checkSIM({ iccid, auth, headers, context }){
-		return this.head({ uri: `/v1/sims/${iccid}`, auth, headers, context });
-	}
-
-	/**
-     * Activate and add SIM cards to an account or product
-     * @param {Object}        options              Options for this API call
-     * @param {String}        options.iccid        ICCID of the SIM card
-     * @param {Array<String>} options.iccids       (Product only) ICCID of multiple SIM cards to import
-     * @param {String}        options.country      The ISO country code for the SIM cards
-     * @param {String}        [options.product]    SIM cards for this product ID or slug
-     * @param {string}        [options.auth]       The access token. Can be ignored if provided in constructor
-     * @param {Object}        [options.headers]    Key/Value pairs like `{ 'X-FOO': 'foo', X-BAR: 'bar' }` to send as headers.
-     * @param {Object}        [options.context]    Request context
-     * @param {any}           [options.promoCode]
-     * @returns {Promise} A promise
-     */
-	activateSIM({ iccid, iccids, country, promoCode, product, auth, headers, context }){
-		// promoCode is deprecated
-		iccids = iccids || [iccid];
-		const uri = product ? `/v1/products/${product}/sims` : `/v1/sims/${iccid}`;
-		const data = product ?
-			{ sims: iccids, country } :
-			{ country, promoCode, action: 'activate' };
-		const method = product ? 'post' : 'put';
-
-		return this.request({ uri, method, headers, data, auth, context });
-	}
-
-	/**
-     * Deactivate a SIM card so it doesn't incur data usage in future months.
-     * @param {Object} options            Options for this API call
-     * @param {String} options.iccid      ICCID of the SIM card
-     * @param {String} [options.product]  SIM cards for this product ID or slug
-     * @param {string} [options.auth]     The access token. Can be ignored if provided in constructor
-     * @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
-     */
-	deactivateSIM({ iccid, product, auth, headers, context }){
-		const uri = product ? `/v1/products/${product}/sims/${iccid}` : `/v1/sims/${iccid}`;
-		const data = { action: 'deactivate' };
-		return this.put({ uri, auth, headers, data, context });
-	}
-
-	/**
-     * Reactivate a SIM card the was deactivated or unpause a SIM card that was automatically paused
-     * @param {Object} options            Options for this API call
-     * @param {String} options.iccid      ICCID of the SIM card
-     * @param {Number} [options.mbLimit]  New monthly data limit. Necessary if unpausing a SIM card
-     * @param {String} [options.product]  SIM cards for this product ID or slug
-     * @param {string} [options.auth]     The access token. Can be ignored if provided in constructor
-     * @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
-     */
-	reactivateSIM({ iccid, mbLimit, product, auth, headers, context }){
-		const uri = product ? `/v1/products/${product}/sims/${iccid}` : `/v1/sims/${iccid}`;
-		const data = { mb_limit: mbLimit, action: 'reactivate' };
-		return this.put({ uri, auth, headers, data, context });
-	}
-
-	/**
-     * Update SIM card data limit
-     * @param {Object} options            Options for this API call
-     * @param {String} options.iccid      ICCID of the SIM card
-     * @param {Array}  options.mbLimit    Data limit in megabyte for the SIM card
-     * @param {String} [options.product]  SIM cards for this product ID or slug
-     * @param {string} [options.auth]     The access token. Can be ignored if provided in constructor
-     * @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
+     * @returns {Promise<T.JSONResponse<T.SimInfo>>} A promise that resolves with the response data
      */
-	updateSIM({ iccid, mbLimit, product, auth, headers, context }){
-		const uri = product ? `/v1/products/${product}/sims/${iccid}` : `/v1/sims/${iccid}`;
-		const data = { mb_limit: mbLimit };
-		return this.put({ uri, auth, headers, data, context });
-	}
-
-	/**
+    checkSIM({ iccid, auth, headers, context }: T.CheckSIMOptions): Promise<T.JSONResponse<T.SimInfo>>;
+    /**
      * Remove a SIM card from an account so it can be activated by a different account
      * @param {Object} options            Options for this API call
      * @param {String} options.iccid      ICCID of the SIM card
@@ -1338,28 +747,20 @@ class Particle {
      * @param {string} [options.auth]     The access token. Can be ignored if provided in constructor
      * @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
+     * @returns {Promise<T.JSONResponse<T.OKResponse>>} A promise that resolves with the response data
      */
-	removeSIM({ iccid, product, auth, headers, context }){
-		const uri = product ? `/v1/products/${product}/sims/${iccid}` : `/v1/sims/${iccid}`;
-		return this.delete({ uri, auth, headers, context });
-	}
-
-	/**
+    removeSIM({ iccid, product, auth, headers, context }: T.RemoveSIMOptions): Promise<T.JSONResponse<T.OKResponse>>;
+    /**
      * List valid build targets to be used for compiling
      * @param {Object}  options                       Options for this API call
      * @param {Boolean} [options.onlyFeatured=false]  Only list featured build targets
      * @param {string}  [options.auth]                The access token. Can be ignored if provided in constructor
      * @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
+     * @returns {Promise<T.JSONResponse<T.BuildTargetsResponse>>} A promise that resolves with the response data
      */
-	listBuildTargets({ onlyFeatured, auth, headers, context }){
-		const query = onlyFeatured ? { featured: !!onlyFeatured } : undefined;
-		return this.get({ uri: '/v1/build_targets', auth, headers, query, context });
-	}
-
-	/**
+    listBuildTargets({ onlyFeatured, auth, headers, context }: T.ListBuildTargetsOptions): Promise<T.JSONResponse<T.BuildTargetsResponse>>;
+    /**
      * List firmware libraries
      * @param {Object}         options                Options for this API call
      * @param {Number}         options.page           Page index (default, first page)
@@ -1383,30 +784,11 @@ class Particle {
      * @param {Object}         [options.context]      Request context
      * @returns {Promise} A promise
      */
-	listLibraries({ page, limit, filter, sort, architectures, category, scope, excludeScopes, auth, headers, context }){
-		return this.get({
-			uri: '/v1/libraries',
-			auth,
-			headers,
-			query: {
-				page,
-				filter,
-				limit,
-				sort,
-				architectures: this._asList(architectures),
-				category,
-				scope,
-				excludeScopes: this._asList(excludeScopes)
-			},
-			context
-		});
-	}
-
-	_asList(value){
-		return (Array.isArray(value) ? value.join(',') : value);
-	}
-
-	/**
+    listLibraries({ page, limit, filter, sort, architectures, category, scope, excludeScopes, auth, headers, context }: T.ListLibrariesOptions): Promise<T.JSONResponse<{
+        data: T.LibraryInfo[];
+    }>>;
+    private _asList;
+    /**
      * Get firmware library details
      * @param {Object} options            Options for this API call
      * @param {String} options.name       Name of the library to fetch
@@ -1416,17 +798,10 @@ class Particle {
      * @param {Object} [options.context]  Request context
      * @returns {Promise} A promise
      */
-	getLibrary({ name, version, auth, headers, context }){
-		return this.get({
-			uri: `/v1/libraries/${name}`,
-			auth,
-			headers,
-			query: { version },
-			context
-		});
-	}
-
-	/**
+    getLibrary({ name, version, auth, headers, context }: T.GetLibraryOptions): Promise<T.JSONResponse<{
+        data: T.LibraryInfo;
+    }>>;
+    /**
      * Firmware library details for each version
      * @param {Object} options            Options for this API call
      * @param {String} options.name       Name of the library to fetch
@@ -1437,17 +812,10 @@ class Particle {
      * @param {Object} [options.context]  Request context
      * @returns {Promise} A promise
      */
-	getLibraryVersions({ name, page, limit, auth, headers, context }){
-		return this.get({
-			uri: `/v1/libraries/${name}/versions`,
-			auth,
-			headers,
-			query: { page, limit },
-			context
-		});
-	}
-
-	/**
+    getLibraryVersions({ name, page, limit, auth, headers, context }: T.GetLibraryVersionsOptions): Promise<T.JSONResponse<{
+        data: T.LibraryInfo[];
+    }>>;
+    /**
      * Contribute a new library version from a compressed archive
      * @param {Object}          options            Options for this API call
      * @param {String | Buffer} options.archive    Compressed archive file containing the library sources
@@ -1457,22 +825,10 @@ class Particle {
      * @param {Object}          [options.context]  Request context
      * @returns {Promise} A promise
      */
-	contributeLibrary({ archive, auth, headers, context }){
-		const files = {
-			'archive.tar.gz': archive
-		};
-
-		return this.request({
-			uri: '/v1/libraries',
-			method: 'post',
-			auth,
-			headers,
-			files,
-			context
-		});
-	}
-
-	/**
+    contributeLibrary({ archive, auth, headers, context }: T.ContributeLibraryOptions): Promise<T.JSONResponse<{
+        data: T.LibraryInfo;
+    }>>;
+    /**
      * Publish the latest version of a library to the public
      * @param {Object} options            Options for this API call
      * @param {String} options.name       Name of the library to publish
@@ -1481,18 +837,10 @@ class Particle {
      * @param {Object} [options.context]  Request context
      * @returns {Promise} A promise
      */
-	publishLibrary({ name, auth, headers, context }){
-		return this.request({
-			uri: `/v1/libraries/${name}`,
-			method: 'patch',
-			auth,
-			headers,
-			data: { visibility: 'public' },
-			context
-		});
-	}
-
-	/**
+    publishLibrary({ name, auth, headers, context }: T.PublishLibraryOptions): Promise<T.JSONResponse<{
+        data: T.LibraryInfo;
+    }>>;
+    /**
      * Delete one version of a library or an entire private library
      * @param {Object} options            Options for this API call
      * @param {String} options.name       Name of the library to remove
@@ -1500,31 +848,19 @@ class Particle {
      * @param {string} [options.auth]     The access token. Can be ignored if provided in constructor
      * @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
+     * @returns {Promise<T.JSONResponse<T.OKResponse>>} A promise that resolves with the response data
      */
-	deleteLibrary({ name, force, auth, headers, context }){
-		return this.delete({
-			uri: `/v1/libraries/${name}`,
-			auth,
-			headers,
-			data: { force },
-			context
-		});
-	}
-
-	/**
+    deleteLibrary({ name, force, auth, headers, context }: T.DeleteLibraryOptions): Promise<T.JSONResponse<T.OKResponse>>;
+    /**
      * Download an external file that may not be on the API
      * @param {Object} options            Options for this API call
      * @param {String} options.uri        URL of the file.
      * @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} Resolves to a buffer with the file data
+     * @returns {Promise<Buffer | ArrayBuffer>} A promise that resolves with the binary data
      */
-	downloadFile({ uri, headers, context }){
-		return this.request({ uri, method: 'get', headers, context, isBuffer: true });
-	}
-
-	/**
+    downloadFile({ uri, headers, context }: T.DownloadFileOptions): Promise<Buffer | ArrayBuffer>;
+    /**
      * List OAuth client created by the account
      * @param {Object} options            Options for this API call
      * @param {String} [options.product]  List clients for this product ID or slug
@@ -1533,12 +869,10 @@ class Particle {
      * @param {Object} [options.context]  Request context
      * @returns {Promise} A promise
      */
-	listOAuthClients({ product, auth, headers, context }){
-		const uri = product ? `/v1/products/${product}/clients` : '/v1/clients';
-		return this.get({ uri, auth, headers, context });
-	}
-
-	/**
+    listOAuthClients({ product, auth, headers, context }: T.ListOAuthClientsOptions): Promise<T.JSONResponse<{
+        clients: T.OAuthClientInfo[];
+    }>>;
+    /**
      * Create an OAuth client
      * @param {Object} options                 Options for this API call
      * @param {String} options.name            Name of the OAuth client
@@ -1549,15 +883,10 @@ class Particle {
      * @param {string} [options.auth]          The access token. Can be ignored if provided in constructor
      * @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
+     * @returns {Promise<T.JSONResponse<T.OAuthClientInfo>>} A promise that resolves with the response data
      */
-	createOAuthClient({ name, type, redirect_uri, scope, product, auth, headers, context }){
-		const uri = product ? `/v1/products/${product}/clients` : '/v1/clients';
-		const data = { name, type, redirect_uri, scope };
-		return this.post({ uri, auth, headers, data, context });
-	}
-
-	/**
+    createOAuthClient({ name, type, redirect_uri, scope, product, auth, headers, context }: T.CreateOAuthClientOptions): Promise<T.JSONResponse<T.OAuthClientInfo>>;
+    /**
      * Update an OAuth client
      * @param {Object} options            Options for this API call
      * @param {String} options.clientId   The OAuth client to update
@@ -1567,15 +896,10 @@ class Particle {
      * @param {string} [options.auth]     The access token. Can be ignored if provided in constructor
      * @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
+     * @returns {Promise<T.JSONResponse<T.OAuthClientInfo>>} A promise that resolves with the response data
      */
-	updateOAuthClient({ clientId, name, scope, product, auth, headers, context }){
-		const uri = product ? `/v1/products/${product}/clients/${clientId}` : `/v1/clients/${clientId}`;
-		const data = { name, scope };
-		return this.put({ uri, data, auth, headers, context });
-	}
-
-	/**
+    updateOAuthClient({ clientId, name, scope, product, auth, headers, context }: T.UpdateOAuthClientOptions): Promise<T.JSONResponse<T.OAuthClientInfo>>;
+    /**
      * Delete an OAuth client
      * @param {Object} options            Options for this API call
      * @param {String} options.clientId   The OAuth client to update
@@ -1583,14 +907,10 @@ class Particle {
      * @param {string} [options.auth]     The access token. Can be ignored if provided in constructor
      * @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
+     * @returns {Promise<T.JSONResponse<T.OKResponse>>} A promise that resolves with the response data
      */
-	deleteOAuthClient({ clientId, product, auth, headers, context }){
-		const uri = product ? `/v1/products/${product}/clients/${clientId}` : `/v1/clients/${clientId}`;
-		return this.delete({ uri, auth, headers, context });
-	}
-
-	/**
+    deleteOAuthClient({ clientId, product, auth, headers, context }: T.DeleteOAuthClientOptions): Promise<T.JSONResponse<T.OKResponse>>;
+    /**
      * List products the account has access to
      * @param {Object} options            Options for this API call
      * @param {string} [options.auth]     The access token. Can be ignored if provided in constructor
@@ -1598,11 +918,10 @@ class Particle {
      * @param {Object} [options.context]  Request context
      * @returns {Promise} A promise
      */
-	listProducts({ auth, headers, context }){
-		return this.get({ uri: '/v1/products', auth, headers, context });
-	}
-
-	/**
+    listProducts({ auth, headers, context }: T.ListProductsOptions): Promise<T.JSONResponse<{
+        products: T.ProductInfo[];
+    }>>;
+    /**
      * Get detailed information about a product
      * @param {Object} options            Options for this API call
      * @param {String} options.product    Product ID or slug
@@ -1611,24 +930,20 @@ class Particle {
      * @param {Object} [options.context]  Request context
      * @returns {Promise} A promise
      */
-	getProduct({ product, auth, headers, context }){
-		return this.get({ uri: `/v1/products/${product}`, auth, headers, context });
-	}
-
-	/**
+    getProduct({ product, auth, headers, context }: T.GetProductOptions): Promise<T.JSONResponse<{
+        product: T.ProductInfo;
+    }>>;
+    /**
      * List product firmware versions
      * @param {Object} options            Options for this API call
      * @param {String} options.product    Firmware for this product ID or slug
      * @param {string} [options.auth]     The access token. Can be ignored if provided in constructor
      * @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
+     * @returns {Promise<T.JSONResponse<T.ProductFirmwareInfo[]>>} A promise that resolves with the response data
      */
-	listProductFirmware({ product, auth, headers, context }){
-		return this.get({ uri: `/v1/products/${product}/firmware`, auth, headers, context });
-	}
-
-	/**
+    listProductFirmware({ product, auth, headers, context }: T.ListProductFirmwareOptions): Promise<T.JSONResponse<T.ProductFirmwareInfo[]>>;
+    /**
      * List product firmware versions
      * @param {Object} options                Options for this API call
      * @param {Object} options.file           Path or Buffer of the new firmware file
@@ -1640,27 +955,10 @@ class Particle {
      * @param {string} [options.auth]         The access token. Can be ignored if provided in constructor
      * @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
+     * @returns {Promise<T.JSONResponse<T.ProductFirmwareInfo>>} A promise that resolves with the response data
      */
-	uploadProductFirmware({ file, version, title, description, product, auth, headers, context }){
-		return this.request({
-			uri: `/v1/products/${product}/firmware`,
-			method: 'post',
-			auth,
-			headers,
-			form: {
-				version,
-				title,
-				description
-			},
-			files: {
-				'firmware.bin': file
-			},
-			context
-		});
-	}
-
-	/**
+    uploadProductFirmware({ file, version, title, description, product, auth, headers, context }: T.UploadProductFirmwareOptions): Promise<T.JSONResponse<T.ProductFirmwareInfo>>;
+    /**
      * Get information about a product firmware version
      * @param {Object} options            Options for this API call
      * @param {Number} options.version    Version number of firmware
@@ -1668,18 +966,10 @@ class Particle {
      * @param {string} [options.auth]     The access token. Can be ignored if provided in constructor
      * @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
+     * @returns {Promise<T.JSONResponse<T.ProductFirmwareInfo>>} A promise that resolves with the response data
      */
-	getProductFirmware({ version, product, auth, headers, context }){
-		return this.get({
-			uri: `/v1/products/${product}/firmware/${version}`,
-			auth,
-			headers,
-			context
-		});
-	}
-
-	/**
+    getProductFirmware({ version, product, auth, headers, context }: T.GetProductFirmwareOptions): Promise<T.JSONResponse<T.ProductFirmwareInfo>>;
+    /**
      * Update information for a product firmware version
      * @param {Object} options                Options for this API call
      * @param {Number} options.version        Version number of new firmware
@@ -1689,14 +979,10 @@ class Particle {
      * @param {string} [options.auth]         The access token. Can be ignored if provided in constructor
      * @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
+     * @returns {Promise<T.JSONResponse<T.ProductFirmwareInfo>>} A promise that resolves with the response data
      */
-	updateProductFirmware({ version, title, description, product, auth, headers, context }){
-		const uri = `/v1/products/${product}/firmware/${version}`;
-		return this.put({ uri, auth, headers, data: { title, description }, context });
-	}
-
-	/**
+    updateProductFirmware({ version, title, description, product, auth, headers, context }: T.UpdateProductFirmwareOptions): Promise<T.JSONResponse<T.ProductFirmwareInfo>>;
+    /**
      * Download a product firmware binary
      * @param {Object} options            Options for this API call
      * @param {Number} options.version    Version number of new firmware
@@ -1704,40 +990,20 @@ class Particle {
      * @param {string} [options.auth]     The access token. Can be ignored if provided in constructor
      * @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<RequestResponse, RequestError>} A promise that resolves with either the requested data or an error object
-     */
-	downloadProductFirmware({ version, product, auth, headers, context }){
-		return this.request({
-			uri: `/v1/products/${product}/firmware/${version}/binary`,
-			method: 'get',
-			auth,
-			headers,
-			context,
-			isBuffer: true
-		});
-	}
-
-	/**
+     * @returns {Promise<Buffer | ArrayBuffer>} A promise that resolves with the binary data
+     */
+    downloadProductFirmware({ version, product, auth, headers, context }: T.DownloadProductFirmwareOptions): Promise<Buffer | ArrayBuffer>;
+    /**
       * Download a tachyon manufacturing backup files
       * @param {Object} options                   Options for this API call
       * @param {Number} options.deviceId          Device ID
       * @param {String} [options.auth]            The access token. Can be ignored if provided in constructor
       * @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<RequestResponse, RequestError>} A promise with a zip file that contains all manufacturing backup files for the specific device.
+     * @returns {Promise<Buffer | ArrayBuffer>} A promise that resolves with the binary data
       */
-	downloadManufacturingBackup({ deviceId, auth, headers, context }) {
-		return this.request({
-			uri:`/v1/devices/${deviceId}/backup_files`,
-			method: 'put',
-			auth,
-			headers,
-			context,
-			isBuffer: true
-		});
-	}
-
-	/**
+    downloadManufacturingBackup({ deviceId, auth, headers, context }: T.DownloadManufacturingBackupOptions): Promise<Buffer | ArrayBuffer>;
+    /**
      * Release a product firmware version as the default version
      * @param {Object} options            Options for this API call
      * @param {Number} options.version    Version number of new firmware
@@ -1745,32 +1011,20 @@ class Particle {
      * @param {string} [options.auth]     The access token. Can be ignored if provided in constructor
      * @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
+     * @returns {Promise<T.JSONResponse<T.OKResponse>>} A promise that resolves with the response data
      */
-	releaseProductFirmware({ version, product, auth, headers, context }){
-		const uri = `/v1/products/${product}/firmware/release`;
-		return this.put({ uri, auth, headers, data: { version }, context });
-	}
-
-	/**
+    releaseProductFirmware({ version, product, product_default, groups, intelligent, auth, headers, context }: T.ReleaseFirmwareOptions): Promise<T.JSONResponse<T.OKResponse>>;
+    /**
      * List product team members
      * @param {Object} options            Options for this API call
      * @param {String} options.product    Team for this product ID or slug
      * @param {string} [options.auth]     The access token. Can be ignored if provided in constructor
      * @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
+     * @returns {Promise<T.JSONResponse<T.TeamMember[]>>} A promise that resolves with the response data
      */
-	listTeamMembers({ product, auth, headers, context }){
-		return this.get({
-			uri: `/v1/products/${product}/team`,
-			auth,
-			headers,
-			context
-		});
-	}
-
-	/**
+    listTeamMembers({ product, auth, headers, context }: T.ListTeamMembersOptions): Promise<T.JSONResponse<T.TeamMember[]>>;
+    /**
      * Invite Particle user to a product team
      * @param {Object} options            Options for this API call
      * @param {String} options.username   Username for the Particle account
@@ -1778,19 +1032,10 @@ class Particle {
      * @param {string} [options.auth]     The access token. Can be ignored if provided in constructor
      * @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
+     * @returns {Promise<T.JSONResponse<T.OKResponse>>} A promise that resolves with the response data
      */
-	inviteTeamMember({ username, product, auth, headers, context }){
-		return this.post({
-			uri: `/v1/products/${product}/team`,
-			auth,
-			headers,
-			data: { username },
-			context
-		});
-	}
-
-	/**
+    inviteTeamMember({ username, product, auth, headers, context }: T.InviteTeamMemberOptions): Promise<T.JSONResponse<T.OKResponse>>;
+    /**
      * Remove Particle user to a product team
      * @param {Object} options            Options for this API call
      * @param {String} options.username   Username for the Particle account
@@ -1798,228 +1043,40 @@ class Particle {
      * @param {string} [options.auth]     The access token. Can be ignored if provided in constructor
      * @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
+     * @returns {Promise<T.JSONResponse<T.OKResponse>>} A promise that resolves with the response data
      */
-	removeTeamMember({ username, product, auth, headers, context }){
-		return this.delete({
-			uri: `/v1/products/${product}/team/${username}`,
-			auth,
-			headers,
-			context
-		});
-	}
-
-	/**
+    removeTeamMember({ username, product, auth, headers, context }: T.RemoveTeamMemberOptions): Promise<T.JSONResponse<T.OKResponse>>;
+    /**
      * Fetch details about a serial number
      * @param {Object} options               Options for this API call
      * @param {String} options.serialNumber  The serial number printed on the barcode of the device packaging
      * @param {string} [options.auth]        The access token. Can be ignored if provided in constructor
      * @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
+     * @returns {Promise<T.JSONResponse<T.SerialNumberResponse>>} A promise that resolves with the response data
      */
-	lookupSerialNumber({ serialNumber, auth, headers, context }){
-		return this.get({
-			uri: `/v1/serial_numbers/${serialNumber}`,
-			auth,
-			headers,
-			context
-		});
-	}
-
-	/**
-     * Create a mesh network
-     * @param {Object} options            Options for this API call
-     * @param {String} options.name       Network name
-     * @param {String} options.deviceId   Gateway device ID
-     * @param {String} [options.iccid]    ICCID of the active SIM card (only for cellular gateway devices)
-     * @param {string} [options.auth]     The access token. Can be ignored if provided in constructor
-     * @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<Object>} A promise
-     */
-	createMeshNetwork({ name, deviceId, iccid, auth, headers, context }){
-		return this.post({
-			uri: '/v1/networks',
-			auth,
-			headers,
-			data: { name, device_id: deviceId, iccid },
-			context
-		});
-	}
-
-	/**
-     * Remove a mesh network.
-     * @param {Object} options            Options for this API call
-     * @param {String} options.networkId  Network ID or name
-     * @param {string} [options.auth]     The access token. Can be ignored if provided in constructor
-     * @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<Object>} A promise
-     */
-	removeMeshNetwork({ networkId, auth, headers, context }){
-		return this.delete({ uri: `/v1/networks/${networkId}`, auth, headers, context });
-	}
-
-	/**
-     * List all mesh networks
-     * @param {Object} options            Options for this API call
-     * @param {string} [options.auth]     The access token. Can be ignored if provided in constructor
-     * @param {Number} [options.page]     Current page of results
-     * @param {Number} [options.perPage]  Records per page
-     * @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<Object>} A promise
-     */
-	listMeshNetworks({ page, perPage, auth, headers, context }){
-		const query = page ? { page, per_page: perPage } : undefined;
-		return this.get({ uri: '/v1/networks', auth, headers, query, context });
-	}
-
-	/**
-     * Get information about a mesh network.
-     * @param {Object} options            Options for this API call
-     * @param {String} options.networkId  Network ID or name
-     * @param {string} [options.auth]     The access token. Can be ignored if provided in constructor
-     * @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<Object>} A promise
-     */
-	getMeshNetwork({ networkId, auth, headers, context }){
-		return this.get({ uri: `/v1/networks/${networkId}`, auth, headers, context });
-	}
-
-	/**
-     * Modify a mesh network.
-     * @param {Object} options            Options for this API call
-     * @param {String} options.networkId  Network ID or name
-     * @param {String} options.action     'add-device', 'remove-device', 'gateway-enable' or 'gateway-disable'
-     * @param {String} options.deviceId   Device ID
-     * @param {string} [options.auth]     The access token. Can be ignored if provided in constructor
-     * @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<Object>} A promise
-     */
-	updateMeshNetwork({ networkId, action, deviceId, auth, headers, context }){
-		return this.put({
-			uri: `/v1/networks/${networkId}`,
-			auth,
-			headers,
-			data: { action, device_id: deviceId },
-			context
-		});
-	}
-
-	/**
-     * Add a device to a mesh network.
-     * @param {Object} options            Options for this API call
-     * @param {String} options.networkId  Network ID or name
-     * @param {String} options.deviceId   Device ID
-     * @param {string} [options.auth]     The access token. Can be ignored if provided in constructor
-     * @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<Object>} A promise
-     */
-	addMeshNetworkDevice({ networkId, deviceId, auth, headers, context }){
-		return this.updateMeshNetwork({
-			action: 'add-device',
-			networkId,
-			deviceId,
-			auth,
-			headers,
-			context
-		});
-	}
-
-	/**
-     * Remove a device from a mesh network.
-     * @param {Object} options              Options for this API call
-     * @param {String} [options.networkId]  Network ID or name
-     * @param {String} options.deviceId     Device ID
-     * @param {string} [options.auth]       The access token. Can be ignored if provided in constructor
-     * @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<Object>} A promise
-     */
-	removeMeshNetworkDevice({ networkId, deviceId, auth, headers, context }){
-		if (!networkId){
-			return this.delete({
-				uri: `/v1/devices/${deviceId}/network`,
-				auth,
-				headers, context
-			});
-		}
-		return this.updateMeshNetwork({
-			action: 'remove-device',
-			networkId,
-			deviceId,
-			auth,
-			headers,
-			context
-		});
-	}
-
-	/**
-     * List all devices of a mesh network.
-     * @param {Object} options            Options for this API call
-     * @param {String} options.networkId  Network ID or name
-     * @param {string} [options.auth]     The access token. Can be ignored if provided in constructor
-     * @param {Number} [options.role]     Device role: 'gateway' or 'node'
-     * @param {Number} [options.page]     Current page of results
-     * @param {Number} [options.perPage]  Records per page
-     * @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<Object>} A promise
-     */
-	listMeshNetworkDevices({ networkId, role, page, perPage, auth, headers, context }){
-		const query = (role || page) ? { role, page, per_page: perPage } : undefined;
-		return this.get({
-			uri: `/v1/networks/${networkId}/devices`,
-			auth,
-			headers,
-			query,
-			context
-		});
-	}
-
-	/**
+    lookupSerialNumber({ serialNumber, auth, headers, context }: T.LookupSerialNumberOptions): Promise<T.JSONResponse<T.SerialNumberResponse>>;
+    /**
      * 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]     The access token. Can be ignored if provided in constructor
      * @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
+     * @returns {Promise<T.JSONResponse<T.ProductConfigurationResponse>>} A promise that resolves with the response data
      */
-	getProductConfiguration({ auth, product, headers, context }){
-		return this.get({
-			uri: `/v1/products/${product}/config`,
-			auth,
-			headers,
-			context
-		});
-	}
-
-	/**
+    getProductConfiguration({ auth, product, headers, context }: T.GetProductConfigurationOptions): Promise<T.JSONResponse<T.ProductConfigurationResponse>>;
+    /**
      * 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]     The access token. Can be ignored if provided in constructor
      * @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
+     * @returns {Promise<T.JSONResponse<object>>} A promise that resolves with the response data
      */
-	getProductConfigurationSchema({ auth, product, headers = {}, context }){
-		headers.accept = 'application/schema+json';
-		return this.get({
-			uri: `/v1/products/${product}/config`,
-			auth,
-			headers,
-			context
-		});
-	}
-
-	/**
+    getProductConfigurationSchema({ auth, product, headers, context }: T.GetProductConfigurationSchemaOptions): Promise<T.JSONResponse<object>>;
+    /**
      * Get product device's configuration
      * @param {Object} options            Options for this API call
      * @param {String} options.product    Config for this product ID or slug
@@ -2027,18 +1084,10 @@ class Particle {
      * @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
+     * @returns {Promise<T.JSONResponse<T.ProductConfigurationResponse>>} A promise that resolves with the response data
      */
-	getProductDeviceConfiguration({ auth, product, deviceId, headers, context }){
-		return this.get({
-			uri: `/v1/products/${product}/config/${deviceId}`,
-			auth,
-			headers,
-			context
-		});
-	}
-
-	/**
+    getProductDeviceConfiguration({ auth, product, deviceId, headers, context }: T.GetProductDeviceConfigurationOptions): Promise<T.JSONResponse<T.ProductConfigurationResponse>>;
+    /**
      * Get product device's configuration schema
      * @param {Object} options            Options for this API call
      * @param {String} options.product    Config for this product ID or slug
@@ -2046,19 +1095,10 @@ class Particle {
      * @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
+     * @returns {Promise<T.JSONResponse<object>>} A promise that resolves with the response data
      */
-	getProductDeviceConfigurationSchema({ auth, product, deviceId, headers, context }){
-		headers.accept = 'application/schema+json';
-		return this.get({
-			uri: `/v1/products/${product}/config/${deviceId}`,
-			auth,
-			headers,
-			context
-		});
-	}
-
-	/**
+    getProductDeviceConfigurationSchema({ auth, product, deviceId, headers, context }: T.GetProductDeviceConfigurationSchemaOptions): Promise<T.JSONResponse<object>>;
+    /**
      * Set product configuration
      * @param {Object} options            Options for this API call
      * @param {String} options.product    Config for this product ID or slug
@@ -2066,19 +1106,10 @@ class Particle {
      * @param {Object} options.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
+     * @returns {Promise<T.JSONResponse<T.ProductConfigurationResponse>>} A promise that resolves with the response data
      */
-	setProductConfiguration({ auth, product, config, headers, context }){
-		return this.put({
-			uri: `/v1/products/${product}/config`,
-			auth,
-			data: config,
-			headers,
-			context
-		});
-	}
-
-	/**
+    setProductConfiguration({ auth, product, config, headers, context }: T.SetProductConfigurationOptions): Promise<T.JSONResponse<T.ProductConfigurationResponse>>;
+    /**
      * 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
@@ -2087,19 +1118,10 @@ class Particle {
      * @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
+     * @returns {Promise<T.JSONResponse<T.ProductConfigurationResponse>>} A promise that resolves with the response data
      */
-	setProductDeviceConfiguration({ auth, product, deviceId, config, headers, context }){
-		return this.put({
-			uri: `/v1/products/${product}/config/${deviceId}`,
-			data: config,
-			auth,
-			headers,
-			context
-		});
-	}
-
-	/**
+    setProductDeviceConfiguration({ auth, product, deviceId, config, headers, context }: T.SetProductDeviceConfigurationOptions): Promise<T.JSONResponse<T.ProductConfigurationResponse>>;
+    /**
      * Query location for devices within a product
      * @param {Object} options             Options for this API call
      * @param {String} options.product     Locations for this product ID or slug
@@ -2114,28 +1136,10 @@ class Particle {
      * @param {String} options.perPage     Number of results per page. Defaults to 20. Maximum of 100
      * @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
+     * @returns {Promise<T.JSONResponse<T.LocationListResponse>>} A promise that resolves with the response data
      */
-	getProductLocations({ auth, product, dateRange, rectBl, rectTr, deviceId, deviceName, groups, page, perPage, headers, context }){
-		return this.get({
-			uri: `/v1/products/${product}/locations`,
-			query: {
-				date_range: dateRange,
-				rect_bl: rectBl,
-				rect_tr: rectTr,
-				device_id: deviceId,
-				device_name: deviceName,
-				groups,
-				page,
-				per_page: perPage
-			},
-			auth,
-			headers,
-			context
-		});
-	}
-
-	/**
+    getProductLocations({ auth, product, dateRange, rectBl, rectTr, deviceId, deviceName, groups, page, perPage, headers, context }: T.GetProductLocationsOptions): Promise<T.JSONResponse<T.LocationListResponse>>;
+    /**
      * Query location for one device within a product
      * @param {Object} options            Options for this API call
      * @param {String} options.product    Locations for this product ID or slug
@@ -2148,23 +1152,10 @@ class Particle {
      * @param {Object} [options.context]  Request context
      * @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
+     * @returns {Promise<T.JSONResponse<T.DeviceLocationInfo>>} A promise that resolves with the response data
      */
-	getProductDeviceLocations({ auth, product, dateRange, rectBl, rectTr, deviceId, headers, context }){
-		return this.get({
-			uri: `/v1/products/${product}/locations/${deviceId}`,
-			query: {
-				date_range: dateRange,
-				rect_bl: rectBl,
-				rect_tr: rectTr
-			},
-			auth,
-			headers,
-			context
-		});
-	}
-
-	/**
+    getProductDeviceLocations({ auth, product, dateRange, rectBl, rectTr, deviceId, headers, context }: T.GetProductDeviceLocationsOptions): Promise<T.JSONResponse<T.DeviceLocationInfo>>;
+    /**
      * Executes the provided logic function once and returns the result. No logs, runs, etc are saved
      *
      * NOTE: Any external interactions such as Particle.publish will actually occur when the logic is executed.
@@ -2176,19 +1167,10 @@ class Particle {
      * @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<RequestResponse>} A promise that resolves to the created logic function data.
-     */
-	executeLogic({ auth, org, logic, headers, context }) {
-		return this.post({
-			uri: this._namespacedPath(org, 'logic/execute'),
-			auth,
-			data: logic,
-			headers,
-			context
-		});
-	}
-
-	/**
+     * @returns {Promise<T.JSONResponse<T.ExecuteLogicResponse>>} A promise that resolves with the response data
+     */
+    executeLogic({ auth, org, logic, headers, context }: T.ExecuteLogicOptions): Promise<T.JSONResponse<T.ExecuteLogicResponse>>;
+    /**
      * Creates a new logic function in the specified organization or sandbox using the provided function data.
      *
      * When you create a logic function with Event logic triggers, events will immediately
@@ -2204,19 +1186,12 @@ class Particle {
      * @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<RequestResponse>} A promise that resolves to the created logic function data.
-     */
-	createLogicFunction({ auth, org, logicFunction, headers, context }) {
-		return this.post({
-			uri: this._namespacedPath(org, 'logic/functions'),
-			auth,
-			data: { logic_function: logicFunction },
-			headers,
-			context
-		});
-	}
-
-	/**
+     * @returns {Promise<T.RequestResponse>} A promise that resolves to the created logic function data.
+     */
+    createLogicFunction({ auth, org, logicFunction, headers, context }: T.CreateLogicFunctionOptions): Promise<T.JSONResponse<{
+        logic_function: T.LogicFunction;
+    }>>;
+    /**
      * Get a logic function in the specified organization or sandbox by logic function ID.
      *
      * @param {Object} options                 The options for the logic function.
@@ -2226,18 +1201,12 @@ class Particle {
      * @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<RequestResponse>} A promise that resolves to the specified logic function data.
-     */
-	getLogicFunction({ auth, org, logicFunctionId, headers, context }) {
-		return this.get({
-			uri: this._namespacedPath(org, `logic/functions/${logicFunctionId}`),
-			auth,
-			headers,
-			context
-		});
-	}
-
-	/**
+     * @returns {Promise<T.RequestResponse>} A promise that resolves to the specified logic function data.
+     */
+    getLogicFunction({ auth, org, logicFunctionId, headers, context }: T.GetLogicFunctionOptions): Promise<T.JSONResponse<{
+        logic_function: T.LogicFunction;
+    }>>;
+    /**
      * Updates an existing logic function in the specified organization or sandbox using the provided function data.
      *
      * If you include an id on a logic trigger, it will update the logic trigger in place.
@@ -2250,19 +1219,12 @@ class Particle {
      * @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<RequestResponse>} A promise that resolves to the updated logic function data.
-     */
-	updateLogicFunction({ auth, org, logicFunctionId, logicFunction, headers, context }) {
-		return this.put({
-			uri: this._namespacedPath(org, `logic/functions/${logicFunctionId}`),
-			auth,
-			data: { logic_function: logicFunction },
-			headers,
-			context
-		});
-	}
-
-	/**
+     * @returns {Promise<T.RequestResponse>} A promise that resolves to the updated logic function data.
+     */
+    updateLogicFunction({ auth, org, logicFunctionId, logicFunction, headers, context }: T.UpdateLogicFunctionOptions): Promise<T.JSONResponse<{
+        logic_function: T.LogicFunction;
+    }>>;
+    /**
      * Deletes a logic function in the specified organization or sandbox by logic function ID.
      *
      * @param {Object} options                  The options for deleting the logic function.
@@ -2272,18 +1234,10 @@ class Particle {
      * @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<RequestResponse>} A promise that resolves to an object containing the deleted logic function ID.
-     */
-	deleteLogicFunction({ auth, org, logicFunctionId, headers, context }) {
-		return this.delete({
-			uri: this._namespacedPath(org, `logic/functions/${logicFunctionId}`),
-			auth,
-			headers,
-			context
-		});
-	}
-
-	/**
+     * @returns {Promise<T.JSONResponse<T.OKResponse>>} A promise that resolves with the response data
+     */
+    deleteLogicFunction({ auth, org, logicFunctionId, headers, context }: T.DeleteLogicFunctionOptions): Promise<T.JSONResponse<T.OKResponse>>;
+    /**
      * Lists all logic functions in the specified organization or sandbox.
      *
      * @param {Object}  options               The options for listing logic functions.
@@ -2293,21 +1247,12 @@ class Particle {
      * @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<RequestResponse>} A promise that resolves to an array of logic functions data.
-     */
-	listLogicFunctions({ auth, org, todayStats, headers, context }) {
-		return this.get({
-			uri: this._namespacedPath(org, 'logic/functions'),
-			query: {
-				today_stats: todayStats
-			},
-			auth,
-			headers,
-			context
-		});
-	}
-
-	/**
+     * @returns {Promise<T.RequestResponse>} A promise that resolves to an array of logic functions data.
+     */
+    listLogicFunctions({ auth, org, todayStats, headers, context }: T.ListLogicFunctionsOptions): Promise<T.JSONResponse<{
+        logic_functions: T.LogicFunction[];
+    }>>;
+    /**
      * Lists all logic runs for the specified logic function in the specified organization or sandbox.
      *
      * @param {Object} options                  The options for the request.
@@ -2317,18 +1262,12 @@ class Particle {
      * @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<RequestResponse>} A promise that resolves to an array of logic run data.
-     */
-	listLogicRuns({ auth, org, logicFunctionId, headers, context }) {
-		return this.get({
-			uri: this._namespacedPath(org, `logic/functions/${logicFunctionId}/runs`),
-			auth,
-			headers,
-			context
-		});
-	}
-
-	/**
+     * @returns {Promise<T.RequestResponse>} A promise that resolves to an array of logic run data.
+     */
+    listLogicRuns({ auth, org, logicFunctionId, headers, context }: T.ListLogicRunsOptions): Promise<T.JSONResponse<{
+        logic_runs: T.LogicRun[];
+    }>>;
+    /**
      * Retrieves a logic run by its ID for the specified logic function in the specified organization or sandbox.
      *
      * @param {Object} options                  The options for the request.
@@ -2339,18 +1278,12 @@ class Particle {
      * @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<RequestResponse>} A promise that resolves to an array of logic run data for the specified logic run ID.
-     */
-	getLogicRun({ auth, org, logicFunctionId, logicRunId, headers, context }) {
-		return this.get({
-			uri: this._namespacedPath(org, `logic/functions/${logicFunctionId}/runs/${logicRunId}`),
-			auth,
-			headers,
-			context
-		});
-	}
-
-	/**
+     * @returns {Promise<T.RequestResponse>} A promise that resolves to an array of logic run data for the specified logic run ID.
+     */
+    getLogicRun({ auth, org, logicFunctionId, logicRunId, headers, context }: T.GetLogicRunOptions): Promise<T.JSONResponse<{
+        logic_run: T.LogicRun;
+    }>>;
+    /**
      * Retrieves the logs for a logic run by its ID for the specified logic function in the specified organization or sandbox.
      *
      * @param {Object} options                  The options for the request.
@@ -2361,18 +1294,12 @@ class Particle {
      * @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<RequestResponse>} A promise that resolves to the logs for the specified logic run ID.
-     */
-	getLogicRunLogs({ auth, org, logicFunctionId, logicRunId, headers, context }) {
-		return this.get({
-			uri: this._namespacedPath(org, `logic/functions/${logicFunctionId}/runs/${logicRunId}/logs`),
-			auth,
-			headers,
-			context
-		});
-	}
-
-	/**
+     * @returns {Promise<T.RequestResponse>} A promise that resolves to the logs for the specified logic run ID.
+     */
+    getLogicRunLogs({ auth, org, logicFunctionId, logicRunId, headers, context }: T.GetLogicRunLogsOptions): Promise<T.JSONResponse<{
+        logs: T.LogicRunLog[];
+    }>>;
+    /**
      * Creates a new ledger definition in the specified organization or sandbox.
      *
      * @param {Object} options              The options for creating the ledger definition.
@@ -2382,19 +1309,10 @@ class Particle {
      * @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<RequestResponse>} A promise that resolves to the created ledger definition data.
-     */
-	createLedger({ auth, org, ledger, headers, context }) {
-		return this.post({
-			uri: this._namespacedPath(org, 'ledgers'),
-			auth,
-			data: { ledger },
-			headers,
-			context
-		});
-	}
-
-	/**
+     * @returns {Promise<T.JSONResponse<T.LedgerDefinition>>} A promise that resolves with the response data
+     */
+    createLedger({ auth, org, ledger, headers, context }: T.CreateLedgerOptions): Promise<T.JSONResponse<T.LedgerDefinition>>;
+    /**
      * Get a ledger definition in the specified organization or sandbox by ledger name.
      *
      * @param {Object} options             The options for the ledger definition.
@@ -2404,18 +1322,10 @@ class Particle {
      * @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<RequestResponse>} A promise that resolves to the specified ledger definition data.
-     */
-	getLedger({ auth, org, ledgerName, headers, context }) {
-		return this.get({
-			uri: this._namespacedPath(org, `ledgers/${ledgerName}`),
-			auth,
-			headers,
-			context
-		});
-	}
-
-	/**
+     * @returns {Promise<T.JSONResponse<T.LedgerDefinition>>} A promise that resolves with the response data
+     */
+    getLedger({ auth, org, ledgerName, headers, context }: T.GetLedgerOptions): Promise<T.JSONResponse<T.LedgerDefinition>>;
+    /**
      * Updates an existing ledger definition in the specified organization or sandbox.
      *
      * @param {Object} options             The options for updating the ledger definition.
@@ -2426,19 +1336,10 @@ class Particle {
      * @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<RequestResponse>} A promise that resolves to the updated ledger definition data.
-     */
-	updateLedger({ auth, org, ledgerName, ledger, headers, context }) {
-		return this.put({
-			uri: this._namespacedPath(org, `ledgers/${ledgerName}`),
-			auth,
-			data: { ledger },
-			headers,
-			context
-		});
-	}
-
-	/**
+     * @returns {Promise<T.JSONResponse<T.LedgerDefinition>>} A promise that resolves with the response data
+     */
+    updateLedger({ auth, org, ledgerName, ledger, headers, context }: T.UpdateLedgerOptions): Promise<T.JSONResponse<T.LedgerDefinition>>;
+    /**
      * Archives a ledger definition in the specified organization or sandbox by ledger name.
      *
      * @param {Object} options             The options for archiving the ledger definition.
@@ -2448,22 +1349,13 @@ class Particle {
      * @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<RequestResponse>} A promise that resolves to an object confirming the ledger definition was archived.
-     */
-	archiveLedger({ auth, org, ledgerName, headers, context }) {
-		return this.delete({
-			uri: this._namespacedPath(org, `ledgers/${ledgerName}`),
-			auth,
-			headers,
-			context
-		});
-	}
-
-	/**
+     * @returns {Promise<T.JSONResponse<T.OKResponse>>} A promise that resolves with the response data
+     */
+    archiveLedger({ auth, org, ledgerName, headers, context }: T.ArchiveLedgerOptions): Promise<T.JSONResponse<T.OKResponse>>;
+    /**
      * @typedef {"Owner" | "Product" | "Device"} Scope
      */
-
-	/**
+    /**
      * Lists all ledger definitions in the specified organization or sandbox.
      *
      * @param {Object}  options             The options for listing ledger definitions.
@@ -2476,24 +1368,12 @@ class Particle {
      * @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<RequestResponse>} A promise that resolves to an array of ledger definition data.
-     */
-	listLedgers({ auth, org, scope, page, perPage, archived, headers, context }) {
-		return this.get({
-			uri: this._namespacedPath(org, 'ledgers'),
-			query: {
-				scope,
-				page,
-				per_page: perPage,
-				archived
-			},
-			auth,
-			headers,
-			context
-		});
-	}
-
-	/**
+     * @returns {Promise<T.RequestResponse>} A promise that resolves to an array of ledger definition data.
+     */
+    listLedgers({ auth, org, scope, page, perPage, archived, headers, context }: T.ListLedgersOptions): Promise<T.JSONResponse<{
+        ledger_definitions: T.LedgerDefinition[];
+    }>>;
+    /**
      * Get ledger instance data.
      *
      * @param {Object} options             The options for the ledger instance.
@@ -2504,22 +1384,13 @@ class Particle {
      * @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<RequestResponse>} A promise that resolves to the specified ledger instance data.
-     */
-	getLedgerInstance({ auth, org, ledgerName, scopeValue, headers, context }) {
-		return this.get({
-			uri: this._namespacedPath(org, `ledgers/${ledgerName}/instances/${scopeValue}`),
-			auth,
-			headers,
-			context
-		});
-	}
-
-	/**
+     * @returns {Promise<T.JSONResponse<T.LedgerInstance>>} A promise that resolves with the response data
+     */
+    getLedgerInstance({ auth, org, ledgerName, scopeValue, headers, context }: T.GetLedgerInstanceOptions): Promise<T.JSONResponse<T.LedgerInstance>>;
+    /**
      * @typedef {"Replace" | "Merge"} SetMode
      */
-
-	/**
+    /**
      * Set ledger instance data.
      *
      * @param {Object}  options             The options for updating the ledger instance.
@@ -2532,22 +1403,10 @@ class Particle {
      * @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<RequestResponse>} A promise that resolves to the updated ledger instance data.
-     */
-	setLedgerInstance({ auth, org, ledgerName, scopeValue, instance, setMode, headers, context }) {
-		return this.put({
-			uri: this._namespacedPath(org, `ledgers/${ledgerName}/instances/${scopeValue}`),
-			query: {
-				set_mode: setMode
-			},
-			auth,
-			data: { instance },
-			headers,
-			context
-		});
-	}
-
-	/**
+     * @returns {Promise<T.JSONResponse<T.LedgerInstance>>} A promise that resolves with the response data
+     */
+    setLedgerInstance({ auth, org, ledgerName, scopeValue, instance, setMode, headers, context }: T.SetLedgerInstanceOptions): Promise<T.JSONResponse<T.LedgerInstance>>;
+    /**
      * Delete a ledger instance in the specified organization or sandbox by ledger name.
      *
      * @param {Object} options             The options for archiving the ledger instance.
@@ -2558,18 +1417,10 @@ class Particle {
      * @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<RequestResponse>} A promise that resolves to an object confirming the ledger instance was deleted.
-     */
-	deleteLedgerInstance({ auth, org, ledgerName, scopeValue, headers, context }) {
-		return this.delete({
-			uri: this._namespacedPath(org, `ledgers/${ledgerName}/instances/${scopeValue}`),
-			auth,
-			headers,
-			context
-		});
-	}
-
-	/**
+     * @returns {Promise<T.JSONResponse<T.OKResponse>>} A promise that resolves with the response data
+     */
+    deleteLedgerInstance({ auth, org, ledgerName, scopeValue, headers, context }: T.DeleteLedgerInstanceOptions): Promise<T.JSONResponse<T.OKResponse>>;
+    /**
      * Lists ledger instances in the specified organization or sandbox.
      *
      * @param {Object} options             The options for listing ledger instances.
@@ -2581,22 +1432,10 @@ class Particle {
      * @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<RequestResponse>} A promise that resolves to an array of ledger instance data.
-     */
-	listLedgerInstances({ auth, org, ledgerName, page, perPage, headers, context }) {
-		return this.get({
-			uri: this._namespacedPath(org, `ledgers/${ledgerName}/instances`),
-			query: {
-				page,
-				per_page: perPage
-			},
-			auth,
-			headers,
-			context
-		});
-	}
-
-	/**
+     * @returns {Promise<T.JSONResponse<T.LedgerInstanceListResponse>>} A promise that resolves with the response data
+     */
+    listLedgerInstances({ auth, org, ledgerName, page, perPage, headers, context }: T.ListLedgerInstancesOptions): Promise<T.JSONResponse<T.LedgerInstanceListResponse>>;
+    /**
      * List ledger instance versions
      *
      * @param {Object} options                   The options for the ledger instance.
@@ -2609,22 +1448,10 @@ class Particle {
      * @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<RequestResponse>} A promise that resolves to an array of ledger instance data.
-     */
-	listLedgerInstanceVersions({ auth, org, ledgerName, scopeValue, replacedBefore, replacedAfter, headers, context }) {
-		return this.get({
-			uri: this._namespacedPath(org, `ledgers/${ledgerName}/instances/${scopeValue}/versions`),
-			query: {
-				replaced_before: replacedBefore,
-				replaced_after: replacedAfter
-			},
-			auth,
-			headers,
-			context
-		});
-	}
-
-	/**
+     * @returns {Promise<T.JSONResponse<T.LedgerVersionListResponse>>} A promise that resolves with the response data
+     */
+    listLedgerInstanceVersions({ auth, org, ledgerName, scopeValue, replacedBefore, replacedAfter, headers, context }: T.ListLedgerInstanceVersionsOptions): Promise<T.JSONResponse<T.LedgerVersionListResponse>>;
+    /**
      * Get specific ledger instance version
      *
      * @param {Object} options             The options for the ledger instance.
@@ -2636,18 +1463,10 @@ class Particle {
      * @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<RequestResponse>} A promise that resolves to the specified ledger instance data.
-     */
-	getLedgerInstanceVersion({ auth, org, ledgerName, scopeValue, version, headers, context }) {
-		return this.get({
-			uri: this._namespacedPath(org, `ledgers/${ledgerName}/instances/${scopeValue}/versions/${version}`),
-			auth,
-			headers,
-			context
-		});
-	}
-
-	/**
+     * @returns {Promise<T.JSONResponse<T.LedgerInstance>>} A promise that resolves with the response data
+     */
+    getLedgerInstanceVersion({ auth, org, ledgerName, scopeValue, version, headers, context }: T.GetLedgerInstanceVersionOptions): Promise<T.JSONResponse<T.LedgerInstance>>;
+    /**
      * List Device OS versions
      *
      * @param {Object} options                    Options for this API call
@@ -2659,26 +1478,10 @@ class Particle {
      * @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<RequestResponse>}        A promise that resolves to the list of Device OS versions.
-     */
-	listDeviceOsVersions({ platformId, internalVersion, page, perPage, auth, headers, context }) {
-		const query = {
-			platform_id: platformId,
-			internal_version: internalVersion,
-			page,
-			per_page: perPage
-		};
-
-		return this.get({
-			uri: '/v1/device-os/versions',
-			query,
-			auth,
-			headers,
-			context
-		});
-	}
-
-	/**
+     * @returns {Promise<T.JSONResponse<T.DeviceOsVersion[]>>} A promise that resolves with the response data
+     */
+    listDeviceOsVersions({ platformId, internalVersion, page, perPage, auth, headers, context }: T.ListDeviceOsVersionsOptions): Promise<T.JSONResponse<T.DeviceOsVersion[]>>;
+    /**
      * Get a specific Device OS version
      *
      * @param {Object} options               Options for this API call
@@ -2688,71 +1491,135 @@ class Particle {
      * @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<RequestResponse>}        A promise that resolves to the specified Device OS version data.
-     */
-	getDeviceOsVersion({ version, platformId, auth, headers, context }) {
-		const query = platformId ? { platform_id: platformId } : {};
-		return this.get({
-			uri: `/v1/device-os/versions/${version}`,
-			query,
-			auth,
-			headers,
-			context
-		});
-	}
-
-	/**
+     * @returns {Promise<T.JSONResponse<T.DeviceOsVersion>>} A promise that resolves with the response data
+     */
+    getDeviceOsVersion({ version, platformId, auth, headers, context }: T.GetDeviceOsVersionOptions): Promise<T.JSONResponse<T.DeviceOsVersion>>;
+    /**
+     * List environment variables for the given scope.
+     *
+     * @param {Object} options                          Options for this API call
+     * @param {string} [options.product]               Product ID or slug.
+     * @param {string} [options.org]                   Organization ID or slug.
+     * @param {string} [options.deviceId]              Device ID.
+     * @param {boolean} [options.sandbox]              Set to `true` to target the user sandbox scope.
+     * @param {string} [options.auth]                  The access token. Can be ignored if provided in constructor
+     * @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<T.JSONResponse<T.EnvVarsResponse>>} A promise that resolves with the env vars data
+     */
+    listEnvVars({ product, org, deviceId, sandbox, auth, headers, context }: T.ListEnvVarsOptions): Promise<T.JSONResponse<T.EnvVarsResponse>>;
+    /**
+     * Bulk update environment variables with set/unset operations.
+     *
+     * @param {Object} options                          Options for this API call
+     * @param {Array}  options.ops                     Array of operations. Each op: `{ op: "Set", key: "KEY", value: "val" }` or `{ op: "Unset", key: "KEY" }`. Max 50.
+     * @param {string} [options.product]               Product ID or slug.
+     * @param {string} [options.org]                   Organization ID or slug.
+     * @param {string} [options.deviceId]              Device ID.
+     * @param {boolean} [options.sandbox]              Set to `true` to target the user sandbox scope.
+     * @param {string} [options.auth]                  The access token. Can be ignored if provided in constructor
+     * @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<T.JSONResponse<T.EnvVarsResponse>>} A promise that resolves with the updated env vars data
+     */
+    updateEnvVars({ ops, product, org, deviceId, sandbox, auth, headers, context }: T.UpdateEnvVarsOptions): Promise<T.JSONResponse<T.EnvVarsResponse>>;
+    /**
+     * Set a single environment variable.
+     *
+     * @param {Object} options                          Options for this API call
+     * @param {string} options.key                     Environment variable name.
+     * @param {string} options.value                   Environment variable value.
+     * @param {string} [options.product]               Product ID or slug.
+     * @param {string} [options.org]                   Organization ID or slug.
+     * @param {string} [options.deviceId]              Device ID.
+     * @param {boolean} [options.sandbox]              Set to `true` to target the user sandbox scope.
+     * @param {string} [options.auth]                  The access token. Can be ignored if provided in constructor
+     * @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<T.JSONResponse<T.EnvVarsResponse>>} A promise that resolves with the updated env vars data
+     */
+    setEnvVar({ key, value, product, org, deviceId, sandbox, auth, headers, context }: T.SetEnvVarOptions): Promise<T.JSONResponse<T.EnvVarsResponse>>;
+    /**
+     * Delete a single environment variable.
+     *
+     * @param {Object} options                          Options for this API call
+     * @param {string} options.key                     Environment variable name to delete.
+     * @param {string} [options.product]               Product ID or slug.
+     * @param {string} [options.org]                   Organization ID or slug.
+     * @param {string} [options.deviceId]              Device ID.
+     * @param {boolean} [options.sandbox]              Set to `true` to target the user sandbox scope.
+     * @param {string} [options.auth]                  The access token. Can be ignored if provided in constructor
+     * @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<T.JSONResponse<T.EnvVarsResponse>>} A promise that resolves with the updated env vars data
+     */
+    deleteEnvVar({ key, product, org, deviceId, sandbox, auth, headers, context }: T.DeleteEnvVarOptions): Promise<T.JSONResponse<T.EnvVarsResponse>>;
+    /**
+     * Get the rendered (flattened) environment variables for the given scope.
+     *
+     * @param {Object} options                          Options for this API call
+     * @param {string} [options.product]               Product ID or slug.
+     * @param {string} [options.org]                   Organization ID or slug.
+     * @param {string} [options.deviceId]              Device ID.
+     * @param {boolean} [options.sandbox]              Set to `true` to target the user sandbox scope.
+     * @param {string} [options.auth]                  The access token. Can be ignored if provided in constructor
+     * @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<T.JSONResponse<T.EnvVarsRenderResponse>>} A promise that resolves with the rendered env vars
+     */
+    renderEnvVars({ product, org, deviceId, sandbox, auth, headers, context }: T.RenderEnvVarsOptions): Promise<T.JSONResponse<T.EnvVarsRenderResponse>>;
+    /**
+     * Review the pending environment variables rollout changes.
+     *
+     * @param {Object} options                          Options for this API call
+     * @param {string} [options.product]               Product ID or slug.
+     * @param {string} [options.org]                   Organization ID or slug.
+     * @param {string} [options.deviceId]              Device ID.
+     * @param {boolean} [options.sandbox]              Set to `true` to target the user sandbox scope.
+     * @param {string} [options.auth]                  The access token. Can be ignored if provided in constructor
+     * @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<T.JSONResponse<T.EnvVarsRolloutResponse>>} A promise that resolves with the rollout diff
+     */
+    reviewEnvVarsRollout({ product, org, deviceId, sandbox, auth, headers, context }: T.ReviewEnvVarsRolloutOptions): Promise<T.JSONResponse<T.EnvVarsRolloutResponse>>;
+    /**
+     * Start rolling out environment variables to devices.
+     *
+     * @param {Object} options                          Options for this API call
+     * @param {string} options.when                    When to apply: `"Immediate"` or `"Connect"`.
+     * @param {string} [options.product]               Product ID or slug.
+     * @param {string} [options.org]                   Organization ID or slug.
+     * @param {string} [options.deviceId]              Device ID.
+     * @param {boolean} [options.sandbox]              Set to `true` to target the user sandbox scope.
+     * @param {string} [options.auth]                  The access token. Can be ignored if provided in constructor
+     * @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<T.JSONResponse<T.EnvVarsRolloutStartResponse>>} A promise that resolves with success status
+     */
+    startEnvVarsRollout({ when, product, org, deviceId, sandbox, auth, headers, context }: T.StartEnvVarsRolloutOptions): Promise<T.JSONResponse<T.EnvVarsRolloutStartResponse>>;
+    /**
      * Set default auth token that will be used in each method if `auth` is not provided
      * @param {string} auth The access token
      * @throws {Error} When not auth string is provided
      */
-	setDefaultAuth(auth){
-		if (typeof auth === 'string' && auth.length !== 0) {
-			this._defaultAuth = auth;
-		} else {
-			throw new Error('Must pass a non-empty string representing an auth token!');
-		}
-	}
-	/**
-     * Return provided token if truthy else use default auth if truthy else undefined
-     * @param {any} auth Optional auth token or undefined
-     * @private
-     * @returns {String|undefined} a Particle auth token or undefined
-     */
-	_getActiveAuthToken(auth) {
-		return auth || this._defaultAuth;
-	}
-	/**
-     * API URI to access a device
-     * @param {Object} options           Options for this API call
-     * @param {String} options.deviceId  Device ID to access
-     * @param {String} [options.product] Device only in this product ID or slug
-     * @param {String} [options.org]     Device only in this organization ID or slug
-     * @private
-     * @returns {string} URI
-     */
-	deviceUri({ deviceId, product, org }){
-		if (org) {
-			return `/v1/orgs/${org}/devices/${deviceId}`;
-		}
-		if (product) {
-			return `/v1/products/${product}/devices/${deviceId}`;
-		}
-		return `/v1/devices/${deviceId}`;
-	}
-
-	/**
-     * Helper for building API paths that support sandbox and org prefixes based on org presence
-     * @param {string | undefined} org slug or ID
-     * @param {string}             path will be appended to the end of the org/sandbox prefix
-     * @returns {string} the full combined path
-     * @private
-     */
-	_namespacedPath(org, path) {
-		return org ? `/v1/orgs/${org}/${path}` : `/v1/${path}`;
-	}
-
-	/**
+    setDefaultAuth(auth: string): void;
+    private _getActiveAuthToken;
+    /** @internal */
+    deviceUri({ deviceId, product, org }: {
+        deviceId: string;
+        product?: string | number;
+        org?: string;
+    }): string;
+    private _namespacedPath;
+    private _envVarUri;
+    /**
      * Make a GET request
      * @param {object} params
      * @param {string} params.uri        The URI to request
@@ -2760,15 +1627,10 @@ class Particle {
      * @param {object} [params.headers]  Key/Value pairs like `{ 'X-FOO': 'foo', X-BAR: 'bar' }` to send as headers.
      * @param {object} [params.query]    Key/Value pairs of query params or a correctly formatted string
      * @param {object} [params.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
-     */
-	get({ uri, auth, headers, query, context }){
-		context = this._buildContext(context);
-		auth = this._getActiveAuthToken(auth);
-		return this.agent.get({ uri, auth, headers, query, context });
-	}
-
-	/**
+     * @returns {Promise<T.JSONResponse<T>>} A promise that resolves with the response data
+     */
+    get<T = object>({ uri, auth, headers, query, context }: T.GetHeadOptions): Promise<T.JSONResponse<T>>;
+    /**
      * Make a HEAD request
      * @param {object} params
      * @param {string} params.uri        The URI to request
@@ -2776,15 +1638,10 @@ class Particle {
      * @param {object} [params.headers]  Key/Value pairs like `{ 'X-FOO': 'foo', X-BAR: 'bar' }` to send as headers.
      * @param {object} [params.query]    Key/Value pairs of query params or a correctly formatted string
      * @param {object} [params.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
-     */
-	head({ uri, auth, headers, query, context }){
-		context = this._buildContext(context);
-		auth = this._getActiveAuthToken(auth);
-		return this.agent.head({ uri, auth, headers, query, context });
-	}
-
-	/**
+     * @returns {Promise<T.JSONResponse<T>>} A promise that resolves with the response data
+     */
+    head<T = object>({ uri, auth, headers, query, context }: T.GetHeadOptions): Promise<T.JSONResponse<T>>;
+    /**
      * Make a POST request
      * @param {object}          params
      * @param {string}          params.uri        The URI to request
@@ -2792,15 +1649,10 @@ class Particle {
      * @param {object}          [params.headers]  Key/Value pairs like `{ 'X-FOO': 'foo', X-BAR: 'bar' }` to send as headers.
      * @param {object}          [params.data]     Object to send as JSON data in the body.
      * @param {object}          [params.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
-     */
-	post({ uri, auth, headers, data, context }){
-		context = this._buildContext(context);
-		auth = this._getActiveAuthToken(auth);
-		return this.agent.post({ uri, auth, headers, data, context });
-	}
-
-	/**
+     * @returns {Promise<T.JSONResponse<T>>} A promise that resolves with the response data
+     */
+    post<T = object>({ uri, auth, headers, data, context }: T.MutateOptions): Promise<T.JSONResponse<T>>;
+    /**
      * Make a PUT request
      * @param {object}          params
      * @param {string}          params.uri        The URI to request
@@ -2809,15 +1661,21 @@ class Particle {
      * @param {object}          [params.data]     Object to send as JSON data in the body.
      * @param {object}          [params.query]    Key/Value pairs of query params or a correctly formatted string
      * @param {object}          [params.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
-     */
-	put({ uri, auth, headers, data, query, context }){
-		context = this._buildContext(context);
-		auth = this._getActiveAuthToken(auth);
-		return this.agent.put({ uri, auth, headers, data, query, context });
-	}
-
-	/**
+     * @returns {Promise<T.JSONResponse<T>>} A promise that resolves with the response data
+     */
+    put<T = object>({ uri, auth, headers, data, query, context }: T.MutateOptions): Promise<T.JSONResponse<T>>;
+    /**
+     * Make a PATCH request
+     * @param {object}          params
+     * @param {string}          params.uri        The URI to request
+     * @param {string}          [params.auth]     Authorization token to use
+     * @param {object}          [params.headers]  Key/Value pairs like `{ 'X-FOO': 'foo', X-BAR: 'bar' }` to send as headers.
+     * @param {object}          [params.data]     Object to send as JSON data in the body.
+     * @param {object}          [params.context]  The invocation context, describing the tool and project
+     * @returns {Promise<T.JSONResponse<T>>} A promise that resolves with the response data
+     */
+    patch<T = object>({ uri, auth, headers, data, context }: T.MutateOptions): Promise<T.JSONResponse<T>>;
+    /**
      * Make a DELETE request
      * @param {object}          params
      * @param {string}          params.uri        The URI to request
@@ -2825,15 +1683,10 @@ class Particle {
      * @param {object}          [params.headers]  Key/Value pairs like `{ 'X-FOO': 'foo', X-BAR: 'bar' }` to send as headers.
      * @param {object}          [params.data]     Object to send as JSON data in the body.
      * @param {object}          [params.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
+     * @returns {Promise<T.JSONResponse<T>>} A promise that resolves with the response data
      */
-	delete({ uri, auth, headers, data, context }){
-		context = this._buildContext(context);
-		auth = this._getActiveAuthToken(auth);
-		return this.agent.delete({ uri, auth, headers, data, context });
-	}
-
-	/**
+    delete<T = object>({ uri, auth, headers, data, context }: T.MutateOptions): Promise<T.JSONResponse<T>>;
+    /**
      *
      * @param {Object}  args             An obj with all the possible request configurations
      * @param {String}  args.uri         The URI to request
@@ -2846,24 +1699,15 @@ class Particle {
      * @param {Object}  [args.files]     Array of file names and file content
      * @param {Object}  [args.context]   The invocation context, describing the tool and project.
      * @param {boolean} [args.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
-     */
-	request(args){
-		args.context = this._buildContext(args.context);
-		args.auth = this._getActiveAuthToken(args.auth);
-		return this.agent.request(args);
-	}
-
-	client(options = {}){
-		// @ts-ignore
-		return new Client(Object.assign({ api: this }, options));
-	}
-
-	// Internal method used to target Particle's APIs other than the default
-	setBaseUrl(baseUrl){
-		this.baseUrl = baseUrl;
-		this.agent.setBaseUrl(baseUrl);
-	}
+     * @returns {Promise<T.RequestResponse>} A promise that resolves with the response data
+     */
+    request(args: T.AgentRequestOptions): Promise<T.RequestResponse>;
+    /** @internal */
+    client(options?: {
+        auth?: string;
+    }): Client;
+    /** @internal */
+    setBaseUrl(baseUrl: string): void;
 }
-
-module.exports = Particle;
+export = Particle;
+//# sourceMappingURL=Particle.d.ts.map