ducimusipsa 1.0.0

package/packages/arcgis-rest-auth/README.md

@@ -0,0 +1,67 @@
+[![npm version][npm-img]][npm-url]
+[![build status][travis-img]][travis-url]
+[![Coverage Status][coverage-img]][coverage-url]
+[![apache licensed](https://img.shields.io/badge/license-Apache-green.svg?style=flat-square)](https://raw.githubusercontent.com/Esri/arcgis-rest-js/master/LICENSE)
+
+[npm-img]: https://img.shields.io/npm/v/@esri/arcgis-rest-auth.svg?style=flat-square
+[npm-url]: https://www.npmjs.com/package/@esri/arcgis-rest-auth
+[travis-img]: https://img.shields.io/travis/Esri/arcgis-rest-js/master.svg?style=flat-square
+[travis-url]: https://travis-ci.org/Esri/arcgis-rest-js
+[coverage-img]: https://coveralls.io/repos/github/Esri/arcgis-rest-js/badge.svg
+[coverage-url]: https://coveralls.io/github/Esri/arcgis-rest-js
+
+# @esri/arcgis-rest-auth
+
+> Authentication helpers for [`@esri/arcgis-rest-*`](https://github.com/Esri/arcgis-rest-js).
+
+### Example
+
+```bash
+npm install @esri/arcgis-rest-request
+npm install @esri/arcgis-rest-auth
+```
+
+```js
+import { UserSession } from '@esri/arcgis-rest-auth';
+
+const session = new UserSession({
+    username: "casey",
+    password: "123456"
+});
+```
+
+### [API Reference](https://esri.github.io/arcgis-rest-js/api/auth/)
+
+### Issues
+
+If something isn't working the way you expected, please take a look at [previously logged issues](https://github.com/Esri/arcgis-rest-js/issues) first.  Have you found a new bug?  Want to request a new feature?  We'd [**love**](https://github.com/Esri/arcgis-rest-js/issues/new) to hear from you.
+
+If you're looking for help you can also post issues on [GIS Stackexchange](http://gis.stackexchange.com/questions/ask?tags=esri-oss).
+
+### Versioning
+
+For transparency into the release cycle and in striving to maintain backward compatibility, @esri/arcgis-rest-js is maintained under Semantic Versioning guidelines and will adhere to these rules whenever possible.
+
+For more information on SemVer, please visit <http://semver.org/>.
+
+### Contributing
+
+Esri welcomes contributions from anyone and everyone. Please see our [guidelines for contributing](CONTRIBUTING.md).
+
+### License
+
+Copyright &copy; 2017-2018 Esri
+
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+
+> http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.
+
+A copy of the license is available in the repository's [LICENSE](../../LICENSE) file.

package/packages/arcgis-rest-auth/package-lock.json

@@ -0,0 +1,11 @@
+{
+	"requires": true,
+	"lockfileVersion": 1,
+	"dependencies": {
+		"tslib": {
+			"version": "1.7.1",
+			"resolved": "https://registry.npmjs.org/tslib/-/tslib-1.7.1.tgz",
+			"integrity": "sha1-vIAEFkaRkjp5/oN4u+s9ogF1OOw="
+		}
+	}
+}

package/packages/arcgis-rest-auth/package.json

@@ -0,0 +1,53 @@
+{
+  "name": "@esri/arcgis-rest-auth",
+  "version": "1.14.1",
+  "description": "Authentication helpers for @esri/arcgis-rest-*.",
+  "main": "dist/node/index.js",
+  "browser": "dist/umd/auth.umd.js",
+  "module": "dist/esm/index.js",
+  "js:next": "dist/esm/index.js",
+  "types": "dist/esm/index.d.ts",
+  "license": "Apache-2.0",
+  "files": [
+    "dist/**"
+  ],
+  "dependencies": {
+    "tslib": "^1.7.1"
+  },
+  "devDependencies": {
+    "@esri/arcgis-rest-common-types": "^1.14.1",
+    "@esri/arcgis-rest-request": "^1.14.1"
+  },
+  "peerDependencies": {
+    "@esri/arcgis-rest-common-types": "^1.14.1",
+    "@esri/arcgis-rest-request": "^1.14.1"
+  "scripts": {
+    "prepare": "npm run build",
+    "prebuild": "rimraf dist",
+    "build": "npm run build:node && npm run build:umd && npm run build:esm",
+    "build:esm": "tsc --module es2015 --outDir ./dist/esm --declaration",
+    "build:umd": "rollup -c ../../umd-base-profile.js && rollup -c ../../umd-production-profile.js",
+    "build:node": "tsc --module commonjs --outDir ./dist/node",
+    "dev:esm": "tsc -w --module es2015 --outDir ./dist/esm --declaration",
+    "dev:umd": "rollup -w -c ../../umd-base-profile.js",
+    "dev:node": "tsc -w --module commonjs --outDir ./dist/node"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Esri/arcgis-rest-js.git"
+  },
+  "contributors": [
+    {
+      "name": "Patrick Arlt",
+      "email": "parlt@esri.com",
+      "url": "http://patrickarlt.com/"
+    }
+  ],
+  "bugs": {
+    "url": "https://github.com/Esri/arcgis-rest-js/issues"
+  },
+  "homepage": "https://github.com/Esri/arcgis-rest-js#readme"
+}

package/packages/arcgis-rest-auth/src/ApplicationSession.ts

@@ -0,0 +1,108 @@
+/* Copyright (c) 2017 Environmental Systems Research Institute, Inc.
+ * Apache-2.0 */
+
+import {
+  IAuthenticationManager,
+  ITokenRequestOptions
+} from "@esri/arcgis-rest-request";
+import { fetchToken } from "./fetch-token";
+
+export interface IApplicationSessionOptions {
+  /**
+   * Client ID of your application. Can be obtained by registering an application
+   * on [ArcGIS for Developers](https://developers.arcgis.com/documentation/core-concepts/security-and-authentication/signing-in-arcgis-online-users/#registering-your-application),
+   * [ArcGIS Online](http://doc.arcgis.com/en/arcgis-online/share-maps/add-items.htm#ESRI_SECTION1_0D1B620254F745AE84F394289F8AF44B) or on your instance of ArcGIS Enterprise.
+   */
+  clientId: string;
+
+  /**
+   * A Client Secret is also obtained by registering an application
+   * on [ArcGIS for Developers](https://developers.arcgis.com/documentation/core-concepts/security-and-authentication/signing-in-arcgis-online-users/#registering-your-application),
+   * [ArcGIS Online](http://doc.arcgis.com/en/arcgis-online/share-maps/add-items.htm#ESRI_SECTION1_0D1B620254F745AE84F394289F8AF44B) or on your instance of ArcGIS Enterprise. Treat it like a password.
+   */
+  clientSecret: string;
+
+  /**
+   * OAuth 2.0 access token from a previous application session.
+   */
+  token?: string;
+
+  /**
+   * Expiration date for the `token`
+   */
+  expires?: Date;
+}
+
+/**
+ * ```js
+ * // visit https://developers.arcgis.com to generate your own clientid and secret
+ * const session = new ApplicationSession({
+ *   clientId: "abc123",
+ *   clientSecret: "sshhhhhh"
+ * })
+ * ```
+ * You can use [App Login](/arcgis-rest-/js/guides/node/) to access premium content and services in ArcGIS Online.
+ *
+ */
+export class ApplicationSession implements IAuthenticationManager {
+  public portal: string;
+  private clientId: string;
+  private clientSecret: string;
+  private token: string;
+  private expires: Date;
+
+  /**
+   * Internal object to keep track of pending token requests. Used to prevent
+   *  duplicate token requests.
+   */
+  private _pendingTokenRequest: Promise<string>;
+
+  constructor(options: IApplicationSessionOptions) {
+    this.clientId = options.clientId;
+    this.clientSecret = options.clientSecret;
+    this.token = options.token;
+    this.expires = options.expires;
+    this.portal = "https://www.arcgis.com/sharing/rest";
+  }
+
+  // url isnt actually read or passed through.
+  getToken(
+    url: string,
+    requestOptions?: ITokenRequestOptions
+  ): Promise<string> {
+    if (this.token && this.expires && this.expires.getTime() > Date.now()) {
+      return Promise.resolve(this.token);
+    }
+
+    if (this._pendingTokenRequest) {
+      return this._pendingTokenRequest;
+    }
+
+    this._pendingTokenRequest = this.refreshToken(requestOptions);
+
+    return this._pendingTokenRequest;
+  }
+
+  refreshToken(requestOptions?: ITokenRequestOptions): Promise<string> {
+    const options = {
+      params: {
+        client_id: this.clientId,
+        client_secret: this.clientSecret,
+        grant_type: "client_credentials"
+      },
+      ...requestOptions
+    };
+    return fetchToken(`${this.portal}/oauth2/token/`, options).then(
+      response => {
+        this._pendingTokenRequest = null;
+        this.token = response.token;
+        this.expires = response.expires;
+        return response.token;
+      }
+    );
+  }
+
+  refreshSession() {
+    return this.refreshToken().then(() => this);
+  }
+}