particle-api-js 11.1.7 → 12.0.1

package/fs.d.ts

@@ -0,0 +1,2 @@
+import * as fs from 'fs';
+export = fs;

package/lib/fs.d.ts

@@ -0,0 +1,2 @@
+import * as fs from 'fs';
+export = fs;

package/lib/fs.js

@@ -0,0 +1,3 @@
+// In Node, exports the fs module. In the browser, exports undefined due to "./fs": false entry in package.json
+'use strict';
+module.exports = require('fs');

package/lib/package.json

@@ -0,0 +1,110 @@
+{
+    "name": "particle-api-js",
+    "version": "12.0.1",
+    "description": "Particle API Client",
+    "main": "lib/src/Particle.js",
+    "types": "lib/src/Particle.d.ts",
+    "exports": {
+        ".": {
+            "types": "./lib/src/Particle.d.ts",
+            "require": "./lib/src/Particle.js",
+            "default": "./lib/src/Particle.js"
+        }
+    },
+    "scripts": {
+        "compile": "tsc -p tsconfig.build.json && cp fs.js fs.d.ts lib/",
+        "prepare": "npm run compile && npm run build",
+        "test": "npm run lint && npm run typecheck && npm run test:unit",
+        "test:ci": "npm run test:unit -- --forbid-only && npm run coverage",
+        "test:unit": "mocha --require tsx 'test/**/*.spec.ts' 'test/**/*.integration.ts' 'test/**/*.test.ts' -R spec",
+        "test:unit:silent": "npm run test:unit > tmp/test-unit-log.txt 2>&1",
+        "test:browser": "npm run compile:test && karma start --single-run",
+        "test:watch": "mocha --require tsx 'test/**/*.spec.ts' --watch --watch-files 'src/**/*.ts,test/**/*.ts'",
+        "compile:test": "tsc -p tsconfig.test-browser.json",
+        "typecheck": "tsc",
+        "coverage": "nyc --reporter=text --temp-dir=./tmp/ --check-coverage --lines 91 npm run test:unit:silent",
+        "lint": "eslint",
+        "docs": "typedoc && node scripts/postprocess-docs.js",
+        "build": "npm run compile && webpack --env mode=production",
+        "build-nomin": "npm run compile && webpack --env mode=development",
+        "prepublishOnly": "npm run test && npm run compile && npm run build",
+        "preversion": "npm run test && npm run prepare",
+        "reinstall": "rm -rf ./node_modules && npm i",
+        "version": "npm run build && npm run docs && npm run update-changelog && git add dist/* docs/*",
+        "update-changelog": "VERSION=`node -p -e \"require('./package.json').version\"` bash -c 'read -p \"Update CHANGELOG.md for version $VERSION and press ENTER when done.\"' && git add CHANGELOG.md"
+    },
+    "repository": {
+        "type": "git",
+        "url": "https://github.com/particle-iot/particle-api-js"
+    },
+    "author": "Julien Vanier <julien@particle.io>",
+    "contributors": [
+        "Ido Kleinman",
+        "Bryce Kahle",
+        "Justin Debbink",
+        "Matthew McGowan",
+        "Julien Vanier",
+        "Wojtek Siudzinski",
+        "Emily Rose"
+    ],
+    "keywords": [
+        "particle",
+        "library",
+        "spark",
+        "api"
+    ],
+    "license": "Apache-2.0",
+    "dependencies": {
+        "form-data": "^4.0.0",
+        "node-fetch": "^2.7.0",
+        "qs": "^6.11.2",
+        "stream-http": "^3.2.0"
+    },
+    "devDependencies": {
+        "@types/chai-as-promised": "^8.0.2",
+        "@types/chai-subset": "^1.3.6",
+        "@types/mocha": "^10.0.10",
+        "@types/node": "^20.5.9",
+        "@types/node-fetch": "^2.6.13",
+        "@types/qs": "^6.14.0",
+        "@types/sinon": "^21.0.0",
+        "@types/sinon-chai": "^4.0.0",
+        "buffer": "^6.0.3",
+        "chai": "^4.3.6",
+        "chai-as-promised": "^7.1.1",
+        "chai-subset": "^1.6.0",
+        "eslint": "^9.36.0",
+        "eslint-config-particle": "^3.0.0",
+        "events": "^3.3.0",
+        "https-proxy-agent": "^8.0.0",
+        "karma": "^6.4.4",
+        "karma-chai": "^0.1.0",
+        "karma-cli": "^2.0.0",
+        "karma-coverage": "^2.2.1",
+        "karma-firefox-launcher": "^2.1.3",
+        "karma-mocha": "^2.0.1",
+        "karma-webpack": "^5.0.1",
+        "mocha": "^10.8.2",
+        "nyc": "^15.1.0",
+        "process": "^0.11.10",
+        "sinon": "^17.0.1",
+        "sinon-chai": "^3.7.0",
+        "terser-webpack-plugin": "^5.3.9",
+        "tsx": "^4.21.0",
+        "typedoc": "^0.28.17",
+        "typedoc-plugin-markdown": "^4.10.0",
+        "typescript": "^5.9.2",
+        "url": "^0.11.3",
+        "webpack": "^5.88.2",
+        "webpack-cli": "^5.1.4"
+    },
+    "browser": {
+        "./fs": false,
+        "http": "stream-http",
+        "https": "stream-http"
+    },
+    "engines": {
+        "node": ">=16.x",
+        "npm": ">=8.x"
+    }
+}

package/lib/src/Agent.d.ts

@@ -0,0 +1,40 @@
+import { type Response, type RequestInit } from 'node-fetch';
+import { type Agent as HttpAgent } from 'http';
+import FormData = require('form-data');
+import type { RequestResponse, AgentRequestOptions, AgentBuildRequestOptions, AgentSanitizedFiles, AgentFile, GetHeadOptions, MutateOptions, ToolContext, ProjectContext } from './types';
+declare class Agent {
+    baseUrl: string | undefined;
+    httpAgent: HttpAgent | undefined;
+    constructor(baseUrl?: string, httpAgent?: HttpAgent);
+    setBaseUrl(baseUrl?: string): void;
+    get(options: GetHeadOptions): Promise<RequestResponse>;
+    head(options: GetHeadOptions): Promise<RequestResponse>;
+    post(options: MutateOptions): Promise<RequestResponse>;
+    put(options: MutateOptions): Promise<RequestResponse>;
+    patch(options: MutateOptions): Promise<RequestResponse>;
+    delete(options: MutateOptions): Promise<RequestResponse>;
+    request({ uri, method, headers, data, auth, query, form, files, context, isBuffer }: AgentRequestOptions): Promise<RequestResponse>;
+    _promiseResponse(requestParams: [string, RequestInit], isBuffer: boolean, makerequest?: (url: string, init?: RequestInit) => Promise<Response>): Promise<RequestResponse>;
+    _buildRequest({ uri, method, headers, data, auth, query, form, files, context }: AgentBuildRequestOptions): [string, RequestInit];
+    isForBrowser(): boolean;
+    _getFromData(files: AgentSanitizedFiles, form?: Record<string, string | number | boolean | undefined>): FormData;
+    _getNodeFormData(file: AgentFile): {
+        file: AgentFile['data'];
+        path: {
+            filepath: string;
+        };
+    };
+    _getContextHeaders(context?: {
+        tool?: ToolContext;
+        project?: ProjectContext;
+    }): Record<string, string>;
+    _getToolContext(tool?: ToolContext): Record<string, string>;
+    _toolIdent(tool: Omit<ToolContext, 'components'>): string;
+    _nameAtVersion(name: string, version?: string | number): string;
+    _getProjectContext(project?: ProjectContext): Record<string, string>;
+    _buildSemicolonSeparatedProperties(obj: Record<string, string | number>, primaryProperty?: string): string;
+    _getAuthorizationHeader(auth?: string): Record<string, string>;
+    _sanitizeFiles(files?: AgentRequestOptions['files']): AgentSanitizedFiles | undefined;
+}
+export = Agent;
+//# sourceMappingURL=Agent.d.ts.map

package/lib/src/Agent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Agent.d.ts","sourceRoot":"","sources":["../../src/Agent.ts"],"names":[],"mappings":"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"}

package/lib/src/Agent.js

@@ -0,0 +1,233 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+const node_fetch_1 = __importDefault(require("node-fetch"));
+const FormData = require("form-data");
+const qs = require("qs");
+const fs = require("../fs");
+const packageJson = require("../package.json");
+class Agent {
+    constructor(baseUrl, httpAgent) {
+        this.setBaseUrl(baseUrl);
+        this.httpAgent = httpAgent;
+    }
+    setBaseUrl(baseUrl) {
+        this.baseUrl = baseUrl;
+    }
+    get(options) {
+        return this.request(Object.assign(Object.assign({}, options), { method: 'get' }));
+    }
+    head(options) {
+        return this.request(Object.assign(Object.assign({}, options), { method: 'head' }));
+    }
+    post(options) {
+        return this.request(Object.assign(Object.assign({}, options), { method: 'post' }));
+    }
+    put(options) {
+        return this.request(Object.assign(Object.assign({}, options), { method: 'put' }));
+    }
+    patch(options) {
+        return this.request(Object.assign(Object.assign({}, options), { method: 'patch' }));
+    }
+    delete(options) {
+        return this.request(Object.assign(Object.assign({}, options), { method: 'delete' }));
+    }
+    request({ uri, method, headers = undefined, data = undefined, auth, query = undefined, form = undefined, files = undefined, context = undefined, isBuffer = false }) {
+        const requestFiles = this._sanitizeFiles(files);
+        const requestParams = this._buildRequest({ uri, method, headers, data, auth, query, form, context, files: requestFiles });
+        return this._promiseResponse(requestParams, isBuffer);
+    }
+    _promiseResponse(requestParams, isBuffer, makerequest = node_fetch_1.default) {
+        let status;
+        return makerequest(requestParams[0], requestParams[1])
+            .then((resp) => {
+            status = resp.status;
+            if (!resp.ok) {
+                return resp.text().then((err) => {
+                    const objError = JSON.parse(err);
+                    const response = Object.assign(resp, { text: err });
+                    throw Object.assign(objError, { response });
+                });
+            }
+            if (status === 204) {
+                return { body: {}, statusCode: 204 };
+            }
+            if (isBuffer) {
+                return resp.blob().then((blob) => blob.arrayBuffer().then((arrayBuffer) => {
+                    if (!this.isForBrowser()) {
+                        return Buffer.from(arrayBuffer);
+                    }
+                    return arrayBuffer;
+                }));
+            }
+            return resp.json().then((body) => ({
+                body: body,
+                statusCode: status
+            }));
+        }).catch((error) => {
+            const errorType = status ? `HTTP error ${status}` : 'Network error';
+            let errorDescription = `${errorType} from ${requestParams[0]}`;
+            let shortErrorDescription;
+            if (error.error_description) {
+                errorDescription = `${errorDescription} - ${error.error_description}`;
+                shortErrorDescription = error.error_description;
+            }
+            const reason = new Error(errorDescription);
+            Object.assign(reason, {
+                statusCode: status,
+                errorDescription,
+                shortErrorDescription,
+                error,
+                body: error
+            });
+            throw reason;
+        });
+    }
+    _buildRequest({ uri, method, headers, data, auth, query, form, files, context }) {
+        let actualUri = uri;
+        if (this.baseUrl && uri[0] === '/') {
+            actualUri = `${this.baseUrl}${uri}`;
+        }
+        if (query) {
+            const queryParams = qs.stringify(query);
+            if (queryParams) {
+                const hasParams = actualUri.includes('?');
+                actualUri = `${actualUri}${hasParams ? '&' : '?'}${queryParams}`;
+            }
+        }
+        const pkg = packageJson;
+        const userAgentHeader = { 'User-Agent': `${pkg.name}/${pkg.version} (${pkg.repository.url})` };
+        let body;
+        let contentTypeHeader;
+        if (files) {
+            contentTypeHeader = {};
+            body = this._getFromData(files, form);
+        }
+        else if (form) {
+            contentTypeHeader = { 'Content-Type': 'application/x-www-form-urlencoded' };
+            body = qs.stringify(form);
+        }
+        else if (data) {
+            if (data instanceof FormData) {
+                body = data;
+            }
+            else {
+                contentTypeHeader = { 'Content-Type': 'application/json' };
+                body = JSON.stringify(data);
+            }
+        }
+        const finalHeaders = Object.assign({}, userAgentHeader, contentTypeHeader, this._getAuthorizationHeader(auth), this._getContextHeaders(context), headers);
+        const init = { method, body, headers: finalHeaders };
+        if (this.httpAgent) {
+            init.agent = this.httpAgent;
+        }
+        return [actualUri, init];
+    }
+    isForBrowser() {
+        return typeof window !== 'undefined';
+    }
+    _getFromData(files, form) {
+        const formData = new FormData();
+        for (const [name, file] of Object.entries(files)) {
+            let path = file.path;
+            let fileData = file.data;
+            if (!this.isForBrowser()) {
+                const nodeFormData = this._getNodeFormData(file);
+                path = nodeFormData.path;
+                fileData = nodeFormData.file;
+            }
+            formData.append(name, fileData, path);
+        }
+        if (form) {
+            for (const [name, value] of Object.entries(form)) {
+                if (value !== undefined) {
+                    formData.append(name, String(value));
+                }
+            }
+        }
+        return formData;
+    }
+    _getNodeFormData(file) {
+        let fileData = file.data;
+        if (typeof file.data === 'string') {
+            fileData = fs.createReadStream(file.data);
+        }
+        return {
+            file: fileData,
+            path: { filepath: file.path }
+        };
+    }
+    _getContextHeaders(context = {}) {
+        return Object.assign({}, this._getToolContext(context.tool), this._getProjectContext(context.project));
+    }
+    _getToolContext(tool = { name: '' }) {
+        let value = '';
+        if (tool.name) {
+            value += this._toolIdent(tool);
+            if (tool.components) {
+                for (const component of tool.components) {
+                    value += ', ' + this._toolIdent(component);
+                }
+            }
+        }
+        if (value) {
+            return { 'X-Particle-Tool': value };
+        }
+        return {};
+    }
+    _toolIdent(tool) {
+        return this._nameAtVersion(tool.name, tool.version);
+    }
+    _nameAtVersion(name, version) {
+        let value = '';
+        if (name) {
+            value += name;
+            if (version !== undefined) {
+                value += '@' + version;
+            }
+        }
+        return value;
+    }
+    _getProjectContext(project = { name: '' }) {
+        const value = this._buildSemicolonSeparatedProperties(project, 'name');
+        if (value) {
+            return { 'X-Particle-Project': value };
+        }
+        return {};
+    }
+    _buildSemicolonSeparatedProperties(obj, primaryProperty = '') {
+        let value = '';
+        if (obj[primaryProperty]) {
+            value += obj[primaryProperty];
+            for (const prop in obj) {
+                if (prop !== primaryProperty && Object.hasOwnProperty.call(obj, prop)) {
+                    value += '; ' + prop + '=' + obj[prop];
+                }
+            }
+        }
+        return value;
+    }
+    _getAuthorizationHeader(auth) {
+        if (typeof auth === 'string') {
+            return { Authorization: `Bearer ${auth}` };
+        }
+        return {};
+    }
+    _sanitizeFiles(files) {
+        let requestFiles;
+        if (files) {
+            requestFiles = {};
+            Object.keys(files).forEach((k, i) => {
+                const name = i ? `file${i + 1}` : 'file';
+                requestFiles[name] = {
+                    data: files[k],
+                    path: k
+                };
+            });
+        }
+        return requestFiles;
+    }
+}
+module.exports = Agent;
+//# sourceMappingURL=Agent.js.map

package/lib/src/Agent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Agent.js","sourceRoot":"","sources":["../../src/Agent.ts"],"names":[],"mappings":"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"}

package/lib/src/Client.d.ts

@@ -0,0 +1,80 @@
+import Library = require('./Library');
+import type { JSONResponse, BuildTargetsResponse, CompileResponse, DeviceInfo, LibraryInfo, OKResponse, TrackingIdentityResponse } from './types';
+interface ParticleApi {
+    listLibraries(options: Record<string, string | number | boolean | undefined>): Promise<JSONResponse<{
+        data: LibraryInfo[];
+    }>>;
+    getLibrary(options: Record<string, string | number | boolean | undefined>): Promise<JSONResponse<{
+        data: LibraryInfo;
+    }>>;
+    getLibraryVersions(options: Record<string, string | number | boolean | undefined>): Promise<JSONResponse<{
+        data: LibraryInfo[];
+    }>>;
+    contributeLibrary(options: Record<string, string | number | boolean | Buffer | undefined>): Promise<JSONResponse<{
+        data: LibraryInfo;
+    }>>;
+    publishLibrary(options: Record<string, string | number | boolean | undefined>): Promise<JSONResponse<{
+        data: LibraryInfo;
+    }>>;
+    deleteLibrary(options: Record<string, string | number | boolean | undefined>): Promise<JSONResponse<OKResponse>>;
+    downloadFile(options: {
+        uri: string;
+        headers?: Record<string, string>;
+    }): Promise<Buffer | ArrayBuffer>;
+    compileCode(options: Record<string, string | number | boolean | object | undefined>): Promise<JSONResponse<CompileResponse>>;
+    signalDevice(options: Record<string, string | number | boolean | undefined>): Promise<JSONResponse<DeviceInfo>>;
+    listDevices(options: Record<string, string | number | boolean | undefined>): Promise<JSONResponse<DeviceInfo[]>>;
+    listBuildTargets(options: Record<string, string | number | boolean | undefined>): Promise<JSONResponse<BuildTargetsResponse>>;
+    trackingIdentity(options: Record<string, string | number | boolean | object | undefined>): Promise<JSONResponse<TrackingIdentityResponse>>;
+}
+interface ClientOptions {
+    auth?: string;
+    api?: ParticleApi;
+}
+declare class Client {
+    auth: string | undefined;
+    api: ParticleApi;
+    constructor({ auth, api }: ClientOptions);
+    ready(): boolean;
+    libraries(query?: Record<string, string | number | boolean | undefined>): Promise<Library[]>;
+    library(name: string, query?: Record<string, string | number | boolean | undefined>): Promise<Library>;
+    libraryVersions(name?: string, query?: Record<string, string | number | boolean | undefined>): Promise<Library[]>;
+    contributeLibrary(archive: string | Buffer): Promise<Library | undefined>;
+    publishLibrary(name: string): Promise<Library | undefined>;
+    deleteLibrary({ name, force }: {
+        name: string;
+        force?: string;
+    }): Promise<boolean | undefined>;
+    _throwError(error: {
+        body?: {
+            errors?: Array<{
+                message: string;
+            }>;
+        };
+    }): never;
+    downloadFile(uri: string): Promise<Buffer>;
+    compileCode(files: Record<string, string | Buffer>, platformId: number, targetVersion: string): Promise<JSONResponse<CompileResponse>>;
+    signalDevice({ signal, deviceId }: {
+        signal: boolean;
+        deviceId: string;
+    }): Promise<JSONResponse<DeviceInfo>>;
+    listDevices(): Promise<JSONResponse<DeviceInfo[]>>;
+    listBuildTargets(): Promise<Array<{
+        version: string;
+        platform: number;
+        prerelease: boolean;
+        firmware_vendor: string;
+    }>>;
+    trackingIdentity({ full, context }?: {
+        full?: boolean;
+        context?: object;
+    }): Promise<{
+        id: string;
+        email: string;
+    }>;
+}
+declare namespace Client {
+    type Api = ParticleApi;
+}
+export = Client;
+//# sourceMappingURL=Client.d.ts.map

package/lib/src/Client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Client.d.ts","sourceRoot":"","sources":["../../src/Client.ts"],"names":[],"mappings":"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"}

package/lib/src/Client.js

@@ -0,0 +1,104 @@
+"use strict";
+const Library = require("./Library");
+class Client {
+    constructor({ auth, api }) {
+        this.auth = auth;
+        if (api) {
+            this.api = api;
+        }
+        else {
+            const ParticleClass = require('./Particle');
+            this.api = new ParticleClass();
+        }
+    }
+    ready() {
+        return Boolean(this.auth);
+    }
+    libraries(query = {}) {
+        return this.api.listLibraries(Object.assign({}, query, { auth: this.auth }))
+            .then((payload) => {
+            const libraries = payload.body.data || [];
+            return libraries.map((l) => new Library(this, l));
+        });
+    }
+    library(name, query = {}) {
+        return this.api.getLibrary(Object.assign({}, query, { name, auth: this.auth }))
+            .then((payload) => {
+            const library = payload.body.data || {};
+            return new Library(this, library);
+        });
+    }
+    libraryVersions(name, query = {}) {
+        return this.api.getLibraryVersions(Object.assign({}, query, { name, auth: this.auth }))
+            .then((payload) => {
+            const libraries = payload.body.data || [];
+            return libraries.map((l) => new Library(this, l));
+        });
+    }
+    contributeLibrary(archive) {
+        return this.api.contributeLibrary({ archive, auth: this.auth })
+            .then((payload) => {
+            const library = payload.body.data || {};
+            return new Library(this, library);
+        }, (error) => {
+            this._throwError(error);
+        });
+    }
+    publishLibrary(name) {
+        return this.api.publishLibrary({ name, auth: this.auth })
+            .then((payload) => {
+            const library = payload.body.data || {};
+            return new Library(this, library);
+        }, (error) => {
+            this._throwError(error);
+        });
+    }
+    deleteLibrary({ name, force }) {
+        return this.api.deleteLibrary({ name, force, auth: this.auth })
+            .then(() => true, (error) => this._throwError(error));
+    }
+    _throwError(error) {
+        if (error.body && error.body.errors) {
+            const errorMessages = error.body.errors.map((e) => e.message).join('\n');
+            throw new Error(errorMessages);
+        }
+        throw error;
+    }
+    downloadFile(uri) {
+        return this.api.downloadFile({ uri });
+    }
+    compileCode(files, platformId, targetVersion) {
+        return this.api.compileCode({ files, platformId, targetVersion, auth: this.auth });
+    }
+    signalDevice({ signal, deviceId }) {
+        return this.api.signalDevice({ signal, deviceId, auth: this.auth });
+    }
+    listDevices() {
+        return this.api.listDevices({ auth: this.auth });
+    }
+    listBuildTargets() {
+        return this.api.listBuildTargets({ onlyFeatured: true, auth: this.auth })
+            .then((payload) => {
+            const targets = [];
+            for (const target of payload.body.targets) {
+                for (const platform of target.platforms) {
+                    targets.push({
+                        version: target.version,
+                        platform: platform,
+                        prerelease: target.prereleases.indexOf(platform) > -1,
+                        firmware_vendor: target.firmware_vendor
+                    });
+                }
+            }
+            return targets;
+        }, () => []);
+    }
+    trackingIdentity({ full = false, context } = {}) {
+        return this.api.trackingIdentity({ full, context, auth: this.auth })
+            .then((payload) => {
+            return payload.body;
+        });
+    }
+}
+module.exports = Client;
+//# sourceMappingURL=Client.js.map

package/lib/src/Client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Client.js","sourceRoot":"","sources":["../../src/Client.ts"],"names":[],"mappings":"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"}

package/lib/src/Defaults.d.ts

@@ -0,0 +1,6 @@
+import type { ParticleOptions } from './types';
+declare const Defaults: Required<Pick<ParticleOptions, 'baseUrl' | 'clientId' | 'clientSecret' | 'tokenDuration'>> & {
+    auth: undefined;
+};
+export default Defaults;
+//# sourceMappingURL=Defaults.d.ts.map

package/lib/src/Defaults.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Defaults.d.ts","sourceRoot":"","sources":["../../src/Defaults.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAE/C,QAAA,MAAM,QAAQ,EAAE,QAAQ,CAAC,IAAI,CAAC,eAAe,EAAE,SAAS,GAAG,UAAU,GAAG,cAAc,GAAG,eAAe,CAAC,CAAC,GAAG;IAAE,IAAI,EAAE,SAAS,CAAA;CAM7H,CAAC;AAEF,eAAe,QAAQ,CAAC"}

package/lib/src/Defaults.js

@@ -0,0 +1,12 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const Defaults = {
+    baseUrl: 'https://api.particle.io',
+    clientSecret: 'particle-api',
+    clientId: 'particle-api',
+    tokenDuration: 7776000,
+    auth: undefined
+};
+exports.default = Defaults;
+module.exports = Defaults;
+//# sourceMappingURL=Defaults.js.map

package/lib/src/Defaults.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Defaults.js","sourceRoot":"","sources":["../../src/Defaults.ts"],"names":[],"mappings":";;AAEA,MAAM,QAAQ,GAAqH;IAClI,OAAO,EAAE,yBAAyB;IAClC,YAAY,EAAE,cAAc;IAC5B,QAAQ,EAAE,cAAc;IACxB,aAAa,EAAE,OAAO;IACtB,IAAI,EAAE,SAAS;CACf,CAAC;AAEF,kBAAe,QAAQ,CAAC;AACxB,MAAM,CAAC,OAAO,GAAG,QAAQ,CAAC"}