autnam 1.0.0

package/docs/src/api/_layout.html

@@ -0,0 +1,204 @@
+{% extends "_layout" %} {% block scripts %}
+<script src="https://unpkg.com/vue@2.4.2/dist/vue.min.js"></script>
+<script src="https://unpkg.com/fuse.js@3.0.5/dist/fuse.min.js"></script>
+<script src="/arcgis-rest-js/js/index.js"></script>
+<script src="/arcgis-rest-js/js/api-search.js"></script>
+<script src="/arcgis-rest-js/js/nav-toggle.js"></script>
+<script>
+  new Vue({
+    el: "#page"
+  });
+</script>
+
+{% endblock %} {% block main %}
+<div class="grid-container trailer-1 leader-1">
+  <nav class="column-6">
+    <api-search base-url="/arcgis-rest-js/">
+      <h3 class="font-size--1 trailer-quarter">Packages</h3>
+      <hr class="leader-quarter trailer-quarter" />
+      <ul class="list-plain">
+        {% for package in data.typedoc.packages %}
+        <li class="{{ package.icon }} api-list-item">
+          <nav-toggle index="{{ loop.index }}" package-name="{{ package.pkg.name }}" ></nav-toggle>
+          <button id="trigger{{ loop.index }}" class="btn btn-transparent api-toggle-button" >
+            <svg xmlns="http://www.w3.org/2000/svg" width="32" height="32" viewBox="0 0 32 32" class="svg-icon">
+              <path d="M7 4h5l12 12-12 12H7l12-12L7 4z" />
+            </svg>
+          </button>
+          {% link package.pageUrl, package.pkg.name.replace("@esri/arcgis-rest-",""), class="tsd-kind-icon" %}
+          <ul id="list{{ loop.index }}" class="api-package-content-list">
+            {% for declaration in package.declarations %}
+            <li class="{{ declaration.icon }} padding-right-1 visually-hidden api-list-item">
+              {% link declaration.pageUrl, declaration.name, class="tsd-kind-icon padding-right-1" %}
+            </li>
+            {% endfor %}
+          </ul>
+        </li>
+        {% endfor %}
+      </ul>
+    </api-search>
+  </nav>
+
+  <div class="column-18">
+    <div class="panel panel-white padding-left-1 padding-right-1 padding-trailer-1 padding-leader-half">
+      {% block content %}{% endblock %}
+    </div>
+  </div>
+</div>
+{% endblock %} {% block footer %}
+<div class="panel panel-white">
+  <div class="grid-container">
+    <div class="column-24">
+      <h2>Legend</h2>
+      <div
+        class="block-group block-group-4-up tablet-block-group-2-up phone-block-group-1-up"
+      >
+        <div class="block">
+          <ul class="list-plain">
+            <li class="tsd-kind-module">
+              <span class="tsd-kind-icon">Module</span>
+            </li>
+            <li class="tsd-kind-object-literal">
+              <span class="tsd-kind-icon">Object literal</span>
+            </li>
+            <li class="tsd-kind-variable">
+              <span class="tsd-kind-icon">Variable</span>
+            </li>
+            <li class="tsd-kind-function">
+              <span class="tsd-kind-icon">Function</span>
+            </li>
+            <li class="tsd-kind-function tsd-has-type-parameter">
+              <span class="tsd-kind-icon">Function with type parameter</span>
+            </li>
+            <li class="tsd-kind-index-signature">
+              <span class="tsd-kind-icon">Index signature</span>
+            </li>
+            <li class="tsd-kind-type-alias">
+              <span class="tsd-kind-icon">Type alias</span>
+            </li>
+          </ul>
+        </div>
+        <div class="block">
+          <ul class="list-plain">
+            <li class="tsd-kind-enumeration">
+              <span class="tsd-kind-icon">Enumeration</span>
+            </li>
+            <li class="tsd-kind-enumeration-member">
+              <span class="tsd-kind-icon">Enumeration member</span>
+            </li>
+            <li class="tsd-kind-property tsd-parent-kind-enumeration">
+              <span class="tsd-kind-icon">Property</span>
+            </li>
+            <li class="tsd-kind-method tsd-parent-kind-enumeration">
+              <span class="tsd-kind-icon">Method</span>
+            </li>
+          </ul>
+        </div>
+        <div class="block">
+          <ul class="list-plain">
+            <li class="tsd-kind-interface">
+              <span class="tsd-kind-icon">Interface</span>
+            </li>
+            <li class="tsd-kind-interface tsd-has-type-parameter">
+              <span class="tsd-kind-icon">Interface with type parameter</span>
+            </li>
+            <li class="tsd-kind-constructor tsd-parent-kind-interface">
+              <span class="tsd-kind-icon">Constructor</span>
+            </li>
+            <li class="tsd-kind-property tsd-parent-kind-interface">
+              <span class="tsd-kind-icon">Property</span>
+            </li>
+            <li class="tsd-kind-method tsd-parent-kind-interface">
+              <span class="tsd-kind-icon">Method</span>
+            </li>
+            <li class="tsd-kind-index-signature tsd-parent-kind-interface">
+              <span class="tsd-kind-icon">Index signature</span>
+            </li>
+          </ul>
+        </div>
+        <div class="block">
+          <ul class="list-plain">
+            <li class="tsd-kind-class">
+              <span class="tsd-kind-icon">Class</span>
+            </li>
+            <li class="tsd-kind-class tsd-has-type-parameter">
+              <span class="tsd-kind-icon">Class with type parameter</span>
+            </li>
+            <li class="tsd-kind-constructor tsd-parent-kind-class">
+              <span class="tsd-kind-icon">Constructor</span>
+            </li>
+            <li class="tsd-kind-property tsd-parent-kind-class">
+              <span class="tsd-kind-icon">Property</span>
+            </li>
+            <li class="tsd-kind-method tsd-parent-kind-class">
+              <span class="tsd-kind-icon">Method</span>
+            </li>
+            <li class="tsd-kind-accessor tsd-parent-kind-class">
+              <span class="tsd-kind-icon">Accessor</span>
+            </li>
+            <li class="tsd-kind-index-signature tsd-parent-kind-class">
+              <span class="tsd-kind-icon">Index signature</span>
+            </li>
+          </ul>
+        </div>
+        <div class="block">
+          <ul class="list-plain">
+            <li
+              class="tsd-kind-constructor tsd-parent-kind-class tsd-is-inherited"
+            >
+              <span class="tsd-kind-icon">Inherited constructor</span>
+            </li>
+            <li class="tsd-kind-property tsd-parent-kind-class tsd-is-inherited">
+              <span class="tsd-kind-icon">Inherited property</span>
+            </li>
+            <li class="tsd-kind-method tsd-parent-kind-class tsd-is-inherited">
+              <span class="tsd-kind-icon">Inherited method</span>
+            </li>
+            <li class="tsd-kind-accessor tsd-parent-kind-class tsd-is-inherited">
+              <span class="tsd-kind-icon">Inherited accessor</span>
+            </li>
+          </ul>
+        </div>
+        <div class="block">
+          <ul class="list-plain">
+            <li class="tsd-kind-property tsd-parent-kind-class tsd-is-protected">
+              <span class="tsd-kind-icon">Protected property</span>
+            </li>
+            <li class="tsd-kind-method tsd-parent-kind-class tsd-is-protected">
+              <span class="tsd-kind-icon">Protected method</span>
+            </li>
+            <li class="tsd-kind-accessor tsd-parent-kind-class tsd-is-protected">
+              <span class="tsd-kind-icon">Protected accessor</span>
+            </li>
+          </ul>
+        </div>
+        <div class="block">
+          <ul class="list-plain">
+            <li class="tsd-kind-property tsd-parent-kind-class tsd-is-private">
+              <span class="tsd-kind-icon">Private property</span>
+            </li>
+            <li class="tsd-kind-method tsd-parent-kind-class tsd-is-private">
+              <span class="tsd-kind-icon">Private method</span>
+            </li>
+            <li class="tsd-kind-accessor tsd-parent-kind-class tsd-is-private">
+              <span class="tsd-kind-icon">Private accessor</span>
+            </li>
+          </ul>
+        </div>
+        <div class="block">
+          <ul class="list-plain">
+            <li class="tsd-kind-property tsd-parent-kind-class tsd-is-static">
+              <span class="tsd-kind-icon">Static property</span>
+            </li>
+            <li
+              class="tsd-kind-call-signature tsd-parent-kind-class tsd-is-static"
+            >
+              <span class="tsd-kind-icon">Static method</span>
+            </li>
+          </ul>
+        </div>
+      </div>
+    </div>
+  </div>
+</div>
+{% endblock %}

package/docs/src/api/_package.html

@@ -0,0 +1,38 @@
+<small class="label right">Version {{ pkg.version }}</small>
+<h1 class="{{ icon }} font-size-3 trailer-half code-face">
+  {% link url, pkg.name%}
+</h1>
+<p class="font-size--1 trailer-1 avenir-regular">{{ pkg.description }}</p>
+<h2 class="font-size-0 trailer-quarter">npm install:</h2>
+<pre><code>{% npmInstallCmd pkg %}</code></pre>
+<h2 class="font-size-0 trailer-quarter">Module Import:</h2>
+{% if pkg.esri.keyExports %}
+{% highlight "js" %}
+import {
+  {%- for name in pkg.esri.keyExports %}
+  {{name}}{{"," if not loop.last}}
+  {%- endfor %}
+} from "{{ pkg.name }}";
+{% endhighlight %}
+{% else %}
+{% highlight "js" %}
+import {
+  {%- for declaration in declarations -%}
+  {%- if declaration.kindString === "Function" or declaration.kindString === "Class" %}
+  {{declaration.name}}{{"," if not loop.last}}{%- endif -%}
+  {% endfor %}
+} from "{{ pkg.name }}";
+{% endhighlight %}
+{% endif %}
+<h2 class="font-size-0 trailer-quarter">CDN:</h2>
+{% scriptTag pkg %}
+<h2 class="font-size-0 trailer-quarter">CDN with SRI:</h2>
+{% scriptTagSRI pkg %}
+<hr class="leader-half trailer-quarter" />
+<ul class="list-plain package-contents">
+  {% for declaration in declarations %}
+  <li class="{{ declaration.icon }}">
+    {% link declaration.pageUrl, declaration.name, class="tsd-kind-icon" %}
+  </li>
+  {% endfor %}
+</ul>

package/docs/src/api/index.html

@@ -0,0 +1,16 @@
+---
+layout: "api/_layout:content"
+---
+
+<h1 class="font-size-4">Packages</h1>
+{% for package in data.typedoc.packages %}
+  {% if not loop.first %}
+  <hr>
+  {% endif %}
+  {% set pkg = package.pkg %}
+  {% set declarations = package.declarations %}
+  {% set url = package.pageUrl %}
+  {% include "api/_package.html" %}
+
+{% endfor %}
+</div>

package/docs/src/guides/_layout.html

@@ -0,0 +1,24 @@
+{% extends "_layout" %}
+
+{% block main %}
+  <div class="grid-container trailer-1 leader-1">
+    <div class="column-6">
+      <ul class="list-plain">
+        {% for section in queries.guides %}
+          <li>{{section.name}}</li>
+          <ul class="list-plain margin-left-1">
+            {% for item in section.items %}
+              <li>{% link item.url, item.title %}</li>
+            {% endfor %}
+          </ul>
+        {% endfor %}
+      </ul>
+    </div>
+
+    <div class="column-18">
+      <div class="panel">
+        {% block content %}{% endblock %}
+      </div>
+    </div>
+  </div>
+{% endblock %}

package/docs/src/guides/amd-requirejs-dojo.md

@@ -0,0 +1,40 @@
+---
+title: Using ArcGIS REST JS in AMD with Require.js or Dojo
+navTitle: AMD (Require.js or Dojo)
+description: Learn how to integrate the ArcGIS REST JS library into project using AMD with Require.js or Dojo.
+order: 40
+group: 1-get-started
+---
+
+# Get Started with ArcGIS REST JS and AMD
+
+```html
+<!DOCTYPE html>
+<html>
+<head>
+  <meta charset="utf-8">
+  <meta name="viewport" content="width=device-width">
+  <title>ArcGIS REST JS - AMD</title>
+</head>
+<body>
+  Open your console to see the demo.
+</body>
+  <!-- require polyfills for fetch and Promise from https://polyfill.io -->
+  <script src="https://polyfill.io/v3/polyfill.min.js?features=es5%2Cfetch%2CPromise"></script>
+  <script>
+    dojoConfig = {
+        paths: {
+          "@esri/arcgis-rest-request": "{% cdnUrl data.typedoc | findPackage('@esri/arcgis-rest-request') %}"
+        }
+    };
+  </script>
+  <script src="https:////ajax.googleapis.com/ajax/libs/dojo/1.10.4/dojo/dojo.js"></script>
+  <script>
+    require(["@esri/arcgis-rest-request"], function(arcgis) {
+      arcgis.request("https://www.arcgis.com/sharing/rest/info").then(response => {
+        console.log(response);
+      });
+    });
+  </script>
+</html>
+```

package/docs/src/guides/browser-authentication.md

@@ -0,0 +1,39 @@
+---
+title: Browser-based authentication with ArcGIS REST JS
+navTitle: Browser-based OAuth 2.0
+description: Learn how to authenticate users with ArcGIS REST JS and OAuth 2.0 in a browser.
+order: 1
+group: 2-authentication
+---
+
+# Authentication in Browser-based Apps
+
+In the [Node.js](/arcgis-rest-js/guides/node/) guide we explained how to instantiate an [`ApplicationSession`](/arcgis-rest-js/api/auth/ApplicationSession/) with hardcoded credentials. In the browser, you need to use [OAuth 2.0](https://developers.arcgis.com/documentation/core-concepts/security-and-authentication/signing-in-arcgis-online-users/) and have users sign directly into [ArcGIS Online](https://www.arcgis.com) or ArcGIS Enterprise.
+
+![browser based login](../../img/oauth-browser.png)
+
+### Resources
+
+- [Implementing Named User Login](https://developers.arcgis.com/documentation/core-concepts/security-and-authentication/signing-in-arcgis-online-users/)
+- [Browser-based Named User Login](https://developers.arcgis.com/documentation/core-concepts/security-and-authentication/browser-based-user-logins/)
+
+```js
+// register your own app to create a unique clientId
+const clientId = "abc123";
+
+UserSession.beginOAuth2({
+  clientId,
+  redirectUri: "https://yourapp.com/authenticate.html",
+}).then(session);
+```
+
+After the user has logged in, the `session` will keep track of individual `federatedServers` that are known to be federated and pass a token through when making requests.
+
+```js
+request(url, { authentication: session });
+```
+
+### Demos
+
+- [OAuth 2.0 Browser](https://github.com/Esri/arcgis-rest-js/tree/master/demos/oauth2-browser)
+- [Retrying Requests](https://github.com/Esri/arcgis-rest-js/tree/master/demos/oauth2-browser-retry)

package/docs/src/guides/bundlers.md

@@ -0,0 +1,52 @@
+---
+title: Using ArcGIS REST JS with Bundlers
+navTitle: Bundlers
+description: Learn how to integrate the ArcGIS REST JS library with Babel and modern bundlers like webpack, Rollup and Parcel.
+order: 30
+group: 1-get-started
+---
+
+# Get Started with webpack, Rollup or Parcel
+
+ArcGIS REST JS works well with popular module bundlers like [webpack](https://webpack.js.org/), [Rollup](https://rollupjs.org/) and [Parcel](https://parceljs.org/).
+
+If you need to support environments where [`fetch`](https://github.com/lquixada/cross-fetch) and [`Promise`](https://github.com/stefanpenner/es6-promise) aren't already present, you can install polyfills for them.
+
+```bash
+npm install @esri/arcgis-rest-request
+```
+You can find `npm install` commands for all packages in the [API reference](../../api).
+```js
+import 'cross-fetch/polyfill';
+import { request } from "@esri/arcgis-rest-request";
+
+request("https://www.arcgis.com/sharing/rest/info")
+  .then(response => {
+    console.log(response);
+  });
+```
+
+# Tree Shaking
+
+Bundlers like webpack and Rollup can statically analyze the code inside ArcGIS REST JS and exclude anything that isn't used. This is called [dead-code elimination](https://rollupjs.org/guide/en#tree-shaking) and it means `rest-js` won't bloat your bundle.
+
+Its worth noting, to activate tree-shaking in webpack, [production](https://webpack.js.org/configuration/mode/#mode-production) mode and [usedExports](https://webpack.js.org/configuration/optimization/#optimizationusedexports) optimization need to be enabled.
+
+```js
+// webpack.config.js
+module.exports = {
+  // ...
+  mode: 'production',
+  optimization: {
+    usedExports: true
+  },
+  // ...
+}
+```
+
+### Tree Shaking Demos
+
+* [webpack](https://github.com/Esri/arcgis-rest-js/tree/master/demos/tree-shaking-webpack)
+* [Rollup](https://github.com/Esri/arcgis-rest-js/tree/master/demos/tree-shaking-rollup)
+
+**Note**: many libraries and tools (such as [Babel](https://babeljs.io/docs/usage/polyfill/)) require an ES6 `Promise` polyfill. Any `Promise` polyfill will work with ArcGIS REST JS, `es6-promise` is simply a lightweight standalone version.

package/docs/src/guides/cli-authentication.md

@@ -0,0 +1,9 @@
+---
+title: Authentication in CLI Applications
+navTitle: Authentication for CLI Apps
+description: Learn how to authenticate requests in Node.js based CLI applications.
+order: 40
+group: 2-authentication
+---
+
+# Authenticate Requests in a CLI Application

package/docs/src/guides/client-server-authentication.md

@@ -0,0 +1,9 @@
+---
+title: Server-client authentication with ArcGIS REST JS
+navTitle: Shared client server authentication
+description: Learn how to authenticate users and share authentication details between the client and server.
+order: 30
+group: 2-authentication
+---
+
+# Sharing Authentication Between Clients and Servers

package/docs/src/guides/embedded-apps.md

@@ -0,0 +1,106 @@
+---
+title: Passing Authentication to iFramed apps
+navTitle: Embedded Authentication
+description: Learn how to pass authentication into iframe embedded applications.
+order: 50
+group: 2-authentication
+---
+
+**Note** This is a new api feature, and currently there are _no_ platform applications that support the authentication flows discussed in this guide. However, this guide exists to help other platform app teams add this functionality to their apps.
+
+# Authentication with Embedded Applications
+
+Sometimes an application will need to embed another application using an `<iframe>`. If both applications are backed by items that are publicly accessible, things will "just work".
+
+However, if the embedded application is not public and the user has already logged into the "Host" application, we then run into the question of how to pass authentication from the "Host" to the embedded application.
+
+# Message Types and Objects
+
+Although this is internalized within the functions, the message types and the objects are documented in the repo in the [postMessage Auth Spec document](https://github.com/Esri/arcgis-rest-js/tree/master/packages/arcgis-rest-auth/post-message-auth-spec.md)
+
+### Cross Origin Embedding
+
+Cross-Origin embedding occurs when the "host" app and the "embedded" application are served from different locations. This is only supported for ArcGIS Platform apps that support embedding.
+
+For example, you can build a custom app, hosted at `http://myapp.com` and iframe in a "platform app" that supports embedding. However, you can not embed your custom app into a StoryMap, and expect the StoryMap to pass authentication to your app. This is done for security reasons.
+
+## Using `postMessage`
+
+The browser's `postMessage` api is designed to allow communication between various "frames" in a page, and it is how this works internally. You can read more about [postMessage](https://developer.mozilla.org/en-US/docs/Web/API/Window/postMessage) at the Mozilla Developer Network.
+
+# Authentication Flow
+
+We will walk through the flows at a high-level
+
+## 1 Host App uses oAuth
+
+The application acting as the host, should use oAuth to authenticate the user, and _before_ rendering the iframe with the embedded application it must call `session.enablePostMessageAuth(validOrigins)`. This sets up a listener that will process the requests from the embedded application(s).
+
+The `validOrigins` argument is an array of "origins" your app expects to get auth requests from. **NOTE** This should be a constrained list of just the domains this particular application will actually be embedding.
+
+```js
+// register your own app to create a unique clientId
+const clientId = "abc123";
+
+UserSession.beginOAuth2({
+  clientId,
+  redirectUri: "https://yourapp.com/authenticate.html",
+}).then((session) => {
+  // for this example we will only send auth to embeds hosted on storymaps.arcgis.com
+  const validOrigins = ["https://storymaps.arcgis.com"];
+  session.enablePostMessageAuth(validOrigins);
+});
+```
+
+#### 2 Host App adds params to embed url
+
+Let's suppose the host app is embedding `https://storymaps.arcgis.com/stories/15a9b9991fff47ad84f4618a28b01afd`. To tell the embedded app that it should request authentication from the parent, we need to add two url parameters:
+
+- `arcgis-auth-origin=https://myapp.com` - This tells the app it's embedded in an iframe and should request auth from the parent, and what 'origin' to expect messages from, what origin to post messages to, and also to ignore other origins.
+- `arcgis-auth-portal=https://www.arcgis.com/sharing/rest` - This tells the embedded app the ArcGIS Portal that the parent will provide authentication for.
+  - **note** the uri must encoded via `encodeURIComponent()` as shown below
+
+```js
+const originalUrl =
+  "https://storymaps.arcgis.com/stories/15a9b9991fff47ad84f4618a28b01afd";
+const embedUrl = `${originalUrl}
+    ?arcgis-auth-origin=${encodeURIComponent(window.location.origin)}
+    &arcgis-auth-portal=${encodeURIComponent(session.portal)}`;
+// then use embedUrl in your component that renders the <iframe>
+```
+
+#### 3 Embed App boots and Requests Auth
+
+In the embedded application, early in its boot sequence it should read the query string parameters and make the determination that it is running inside an iframe, and that it can request authentication information from the parent.
+
+```js
+// Parse up any url params
+let params = new URLSearchParams(document.location.search.substring(1));
+const arcgisAuthOrigin = params.get("arcgis-auth-origin");
+// const arcgisAuthPortal = params.get("arcgis-auth-portal"); // can optionally check this value too
+if (arcgisAuthOrigin) {
+  UserSession.fromParent(arcgisAuthOrigin)
+    .then((session) => {
+      // session is a UserSession instance, populated from the parent app
+      // the embedded app should exchange this token for one specific to the application
+    })
+    .catch((ex) => {
+      // The only case it will reject is if the parent is unable to return a credential
+      // if the parent does not see the child as a valid origin, the parent will never respond.
+    });
+}
+```
+
+#### Clean up
+
+While rest-js will attempt to clean up the listeners automatically, if the host application is no longer going to render the iframe before the embedded app has had a chance to request the authentication, then the app should manually clean up the listener by calling `session.disablePostMessageAuth()`
+
+Typically you would make this call in the life-cycle hooks of your application framework (i.e. an Angular, Ember, React etc app with a router). The example below uses the `disconnectedCallback` that is part of the Stencil.js component life-cycle.
+
+```js
+  // Use your framework's hooks...
+  disconnectedCallback () {
+    // stop listening for requests from children
+    state.session.disablePostMessageAuth();
+  }
+```

package/docs/src/guides/from-a-cdn.md

@@ -0,0 +1,38 @@
+---
+title: Using ArcGIS REST JS from a CDN
+navTitle: From a CDN
+description: Learn how to use ArcGIS REST JS from a CDN.
+order: 20
+group: 1-get-started
+---
+
+# Get Started using a CDN
+
+ArcGIS REST JS is hosted on [unpkg](https://unpkg.com/). You can find URLs for individual packages in the [API reference](../../api).
+
+```html
+<!DOCTYPE html>
+<html>
+<head>
+  <meta charset="utf-8">
+  <meta name="viewport" content="width=device-width">
+  <title>ArcGIS REST JS</title>
+</head>
+<body>
+  Open your console to see the demo.
+</body>
+  <!-- require polyfills for fetch and Promise from https://polyfill.io -->
+  <script src="https://polyfill.io/v3/polyfill.min.js?features=es5%2Cfetch%2CPromise"></script>
+
+  <!-- require ArcGIS REST JS libraries from https://unpkg.com -->
+  <script src="{% cdnUrl data.typedoc | findPackage('@esri/arcgis-rest-request') %}.js"></script>
+
+  <script>
+    /* when including ArcGIS REST JS all exports are available
+    from the same arcgisRest global */
+    arcgisRest.request("https://www.arcgis.com/sharing/rest/info")
+      .then(response => {
+        console.log(response);
+      });
+  </script>
+</html>

package/docs/src/guides/index.md

@@ -0,0 +1,59 @@
+---
+title: Get Started
+description: Get started with ArcGIS REST JS.
+---
+
+# Get Started
+
+ArcGIS REST JS can be deployed with a variety of build tools, including:
+
+* [From a CDN](./from-a-cdn/)
+* [webpack, Rollup and Parcel](./bundlers/)
+* [AMD (Require.js or Dojo)](./amd-requirejs-dojo/)
+* [Node.js](./node/)
+* [What's New in `v2.0.0`?](./whats-new-v2-0/)
+## Requirements
+
+ArcGIS REST JS takes advantage of web standards that are supported in all modern desktop browsers and most mobile browsers.
+
+* [`Fetch` Support](https://caniuse.com/#feat=fetch)
+* [`Promises` Support](https://caniuse.com/#feat=promises)
+* [`FormData` Support](https://caniuse.com/#feat=xhr2)
+* [`ECMAScript 5` Support](https://caniuse.com/#feat=es5)
+
+## Browser Support
+
+ArcGIS REST JS is supported in the same browsers as the [ArcGIS API for JavaScript](https://developers.arcgis.com/javascript/latest/guide/system-requirements/index.html#supported-browsers).
+
+* Chrome
+* Edge
+* Firefox
+* Safari 9 and later
+* iOS Safari
+* IE11
+
+IE11 and older mobile browsers require polyfills.
+
+* [`Promise` polyfill](https://github.com/stefanpenner/es6-promise)
+* [`Fetch` polyfill](https://github.com/bitinn/node-fetch)
+
+## Node.js Support
+
+ArcGIS REST JS is supported in Node.js 8.x and above. It requires additional packages to polyfill `Fetch` and `FormData`.
+
+We recommend the ones below:
+
+* [`node-fetch`](https://github.com/bitinn/node-fetch) - to polyfill `Fetch`
+* [`isomorphic-form-data`](https://github.com/form-data/isomorphic-form-data) - to polyfill `FormData`
+
+```js
+const fetch = require('node-fetch');
+const { setDefaultRequestOptions, request } = require('@esri/arcgis-rest-request');
+
+// use node-fetch for each request instead of relying on a global
+setDefaultRequestOptions({ fetch })
+
+request(url)
+  .then(response)
+```
+Other versions of Node.js may also work with appropriate polyfills but we cannot guarantee support.