ducimusipsa 1.0.0

package/packages/arcgis-rest-auth/test/fetchToken.test.ts

@@ -0,0 +1,112 @@
+/* Copyright (c) 2018 Environmental Systems Research Institute, Inc.
+ * Apache-2.0 */
+
+import * as fetchMock from "fetch-mock";
+import { fetchToken } from "../src/index";
+
+const TOKEN_URL = "https://www.arcgis.com/sharing/rest/oauth2/token";
+
+describe("fetchToken()", () => {
+  afterEach(fetchMock.restore);
+
+  it("should request a token with `client_credentials`, `client_id` and `client_secret`", done => {
+    fetchMock.postOnce(TOKEN_URL, {
+      access_token: "token",
+      expires_in: 1800,
+      ssl: true
+    });
+
+    fetchToken(TOKEN_URL, {
+      params: {
+        client_id: "clientId",
+        client_secret: "clientSecret",
+        grant_type: "client_credentials"
+      }
+    })
+      .then(response => {
+        const [url, options]: [string, RequestInit] = fetchMock.lastCall(
+          TOKEN_URL
+        );
+        expect(url).toEqual(TOKEN_URL);
+        expect(options.body).toContain("f=json");
+        expect(options.body).toContain("client_id=clientId");
+        expect(options.body).toContain("client_secret=clientSecret");
+        expect(options.body).toContain("grant_type=client_credentials");
+        expect(response.token).toEqual("token");
+        expect(response.expires).toBeGreaterThan(Date.now());
+        expect(response.ssl).toEqual(true);
+        done();
+      })
+      .catch(e => {
+        fail(e);
+      });
+  });
+
+  it("should request a token with `authorization_code`, `client_id` and `redirect_uri`", done => {
+    fetchMock.postOnce(TOKEN_URL, {
+      access_token: "token",
+      expires_in: 1800,
+      refresh_token: "refreshToken",
+      username: "Casey",
+      ssl: true
+    });
+
+    fetchToken(TOKEN_URL, {
+      params: {
+        client_id: "clientId",
+        redirect_uri: "https://example-app.com/redirect-uri",
+        code: "authorizationCode",
+        grant_type: "authorization_code"
+      }
+    })
+      .then(response => {
+        const [url, options]: [string, RequestInit] = fetchMock.lastCall(
+          TOKEN_URL
+        );
+        expect(url).toEqual(TOKEN_URL);
+        expect(options.body).toContain("f=json");
+        expect(options.body).toContain("client_id=clientId");
+        expect(options.body).toContain(
+          `redirect_uri=${encodeURIComponent(
+            "https://example-app.com/redirect-uri"
+          )}`
+        );
+        expect(options.body).toContain("grant_type=authorization_code");
+        expect(options.body).toContain("code=authorizationCode");
+        expect(response.token).toEqual("token");
+        expect(response.refreshToken).toEqual("refreshToken");
+        expect(response.username).toEqual("Casey");
+        expect(response.expires).toBeGreaterThan(Date.now());
+        expect(response.ssl).toEqual(true);
+        done();
+      })
+      .catch(e => {
+        fail(e);
+      });
+  });
+
+  it("should return ssl: false when there is no ssl property returned from endpoint response", done => {
+    fetchMock.postOnce(TOKEN_URL, {
+      access_token: "token",
+      expires_in: 1800,
+      refresh_token: "refreshToken",
+      username: "Casey"
+    });
+
+    fetchToken(TOKEN_URL, {
+      params: {
+        client_id: "clientId",
+        redirect_uri: "https://example-app.com/redirect-uri",
+        code: "authorizationCode",
+        grant_type: "authorization_code"
+      }
+    })
+      .then(response => {
+        expect(response.ssl).toEqual(false);
+        done();
+      })
+      .catch(e => {
+        fail(e);
+      });
+  });
+});

package/packages/arcgis-rest-auth/test/generateToken.test.ts

@@ -0,0 +1,130 @@
+/* Copyright (c) 2018 Environmental Systems Research Institute, Inc.
+ * Apache-2.0 */
+
+import * as fetchMock from "fetch-mock";
+import { generateToken } from "../src/index";
+import { TOMORROW } from "./utils";
+
+const TOKEN_URL = "https://www.arcgis.com/sharing/rest/generateToken";
+
+describe("generateToken()", () => {
+  afterEach(fetchMock.restore);
+
+  // to do: remove next time we have a breaking change
+  it("should generate a token for a username and password", done => {
+    fetchMock.postOnce(TOKEN_URL, {
+      token: "token",
+      expires: TOMORROW.getTime()
+    });
+
+    generateToken(TOKEN_URL, {
+      username: "Casey",
+      password: "Jones"
+    })
+      .then(response => {
+        const [url, options]: [string, RequestInit] = fetchMock.lastCall(
+          TOKEN_URL
+        );
+        expect(url).toEqual(TOKEN_URL);
+        expect(options.body).toContain("f=json");
+        expect(options.body).toContain("username=Casey");
+        expect(options.body).toContain("password=Jones");
+        expect(response.token).toEqual("token");
+        expect(response.expires).toEqual(TOMORROW.getTime());
+        done();
+      })
+      .catch(e => {
+        fail(e);
+      });
+  });
+
+  it("should generate a token for a username and password as params", done => {
+    fetchMock.postOnce(TOKEN_URL, {
+      token: "token",
+      expires: TOMORROW.getTime()
+    });
+
+    generateToken(TOKEN_URL, {
+      params: {
+        username: "Casey",
+        password: "Jones"
+      }
+    })
+      .then(response => {
+        const [url, options]: [string, RequestInit] = fetchMock.lastCall(
+          TOKEN_URL
+        );
+        expect(url).toEqual(TOKEN_URL);
+        expect(options.body).toContain("f=json");
+        expect(options.body).toContain("username=Casey");
+        expect(options.body).toContain("password=Jones");
+        expect(response.token).toEqual("token");
+        expect(response.expires).toEqual(TOMORROW.getTime());
+        done();
+      })
+      .catch(e => {
+        fail(e);
+      });
+  });
+});
+
+describe("generateToken() with custom fetch", () => {
+  const oldPromise = Promise;
+  const oldFetch = fetch;
+  const oldFormData = FormData;
+
+  beforeEach(() => {
+    Promise = undefined;
+    FormData = undefined;
+    Function("return this")().fetch = undefined;
+  });
+
+  afterEach(() => {
+    Promise = oldPromise;
+    FormData = oldFormData;
+    Function("return this")().fetch = oldFetch;
+  });
+
+  it("should generate a token for a username and password with custom fetch", done => {
+    Promise = oldPromise;
+    FormData = oldFormData;
+
+    const tokenResponse = {
+      token: "token",
+      expires: TOMORROW.getTime()
+    };
+
+    const MockFetchResponse = {
+      ok: true,
+      json() {
+        return Promise.resolve(tokenResponse);
+      },
+      blob() {
+        return Promise.resolve(new Blob([JSON.stringify(tokenResponse)]));
+      },
+      text() {
+        return Promise.resolve(JSON.stringify(tokenResponse));
+      }
+    };
+
+    const MockFetch = function() {
+      return Promise.resolve(MockFetchResponse);
+    };
+
+    generateToken(TOKEN_URL, {
+      params: {
+        username: "Casey",
+        password: "Jones"
+      },
+      fetch: MockFetch as any
+    })
+      .then(response => {
+        expect(response.token).toEqual(tokenResponse.token);
+        expect(response.expires).toEqual(tokenResponse.expires);
+        done();
+      })
+      .catch(e => {
+        fail(e);
+      });
+  });
+});

package/packages/arcgis-rest-auth/test/utils.ts

@@ -0,0 +1,14 @@
+/* Copyright (c) 2018 Environmental Systems Research Institute, Inc.
+ * Apache-2.0 */
+
+export const TOMORROW = (function() {
+  const now = new Date();
+  now.setDate(now.getDate() + 1);
+  return now;
+})();
+
+export const YESTERDAY = (function() {
+  const now = new Date();
+  now.setDate(now.getDate() - 1);
+  return now;
+})();

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

@@ -0,0 +1,6 @@
+{
+    "extends": "../../tsconfig.json",
+    "include": [
+        "src/**/*.ts"
+    ]
+}

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

@@ -0,0 +1,57 @@
+[![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-common.svg?style=flat-square
+[npm-url]: https://www.npmjs.com/package/@esri/arcgis-rest-common
+[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-common
+
+> Shared utility methods and types for [`@esri/arcgis-rest-js`](https://github.com/Esri/arcgis-rest-js).
+
+### Example
+
+```bash
+npm install @esri/arcgis-rest-common
+```
+
+### [API Reference](https://esri.github.io/arcgis-rest-js/api/common/)
+
+### 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; 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-common/package-lock.json

@@ -0,0 +1,11 @@
+{
+	"requires": true,
+	"lockfileVersion": 1,
+	"dependencies": {
+		"tslib": {
+			"version": "1.9.3",
+			"resolved": "https://registry.npmjs.org/tslib/-/tslib-1.9.3.tgz",
+			"integrity": "sha512-4krF8scpejhaOgqzBEcGM7yDIEfi0/8+8zDRZhNZZ2kjmHJ4hv3zCbQWxoJGz1iw5U0Jl0nma13xzHXcncMavQ=="
+		}
+	}
+}

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

@@ -0,0 +1,41 @@
+{
+  "name": "@esri/arcgis-rest-common",
+  "version": "1.14.1",
+  "description": "Shared utility methods and types for @esri/arcgis-rest-js",
+  "main": "dist/node/index.js",
+  "browser": "dist/umd/common.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.9.3"
+  },
+  "scripts": {
+    "prepare": "npm run build",
+    "build": "npm run build:node && npm run build:umd && npm run build:esm",
+    "build:esm": "tsc -p ./tsconfig.json --module es2015 --outDir ./dist/esm --declaration",
+    "build:umd": "rollup -c ../../umd-base-profile.js && rollup -c ../../umd-production-profile.js",
+    "build:node": "tsc -p ./tsconfig.json --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": [
+    "John Gravois <john@esri.com>"
+  ],
+  "bugs": {
+    "url": "https://github.com/Esri/arcgis-rest-js/issues"
+  },
+  "homepage": "https://github.com/Esri/arcgis-rest-js#readme"
+}

package/packages/arcgis-rest-common/src/index.ts

@@ -0,0 +1,10 @@
+/* Copyright (c) 2018 Environmental Systems Research Institute, Inc.
+ * Apache-2.0 */
+
+// utility methods
+export * from "./util/location";
+
+// types
+export * from "./types/feature";
+export * from "./types/geometry";
+export * from "./types/symbol";

package/packages/arcgis-rest-common/src/types/feature.ts

@@ -0,0 +1,14 @@
+/* Copyright (c) 2018 Environmental Systems Research Institute, Inc.
+ * Apache-2.0 */
+
+import { IGeometry } from "./geometry";
+import { ISymbol } from "./symbol";
+
+/**
+ * a spatial entity and its corresponding properties
+ */
+export interface IFeature {
+  geometry?: IGeometry;
+  attributes: { [key: string]: any };
+  symbol?: ISymbol;
+}

package/packages/arcgis-rest-common/src/types/geometry.ts

@@ -0,0 +1,47 @@
+/* Copyright (c) 2018 Environmental Systems Research Institute, Inc.
+ * Apache-2.0 */
+
+/**
+ *
+ */
+export interface IHasZM {
+  hasZ?: boolean;
+  hasM?: boolean;
+}
+
+/**
+ * Spatial reference systems define mathematical transformations and coordinate systems for displaying spatial information in 2D and 3D.
+ */
+export interface ISpatialReference {
+  wkid?: number;
+  latestWkid?: number;
+  vcsWkid?: number;
+  latestVcsWkid?: number;
+  wkt?: string;
+  latestWkt?: string;
+}
+
+/**
+ * a building block for discrete geometries
+ */
+export interface IGeometry {
+  spatialReference?: ISpatialReference;
+}
+
+/**
+ * A simple point geometry, with spatial reference defined.
+ */
+export interface IPoint extends IHasZM, IGeometry {
+  x: number;
+  y: number;
+}
+
+/**
+ *
+ */
+export interface ILocation {
+  latitude?: number;
+  longitude?: number;
+  lat?: number;
+  long?: number;
+}

package/packages/arcgis-rest-common/src/types/symbol.ts

@@ -0,0 +1,21 @@
+/* Copyright (c) 2018 Environmental Systems Research Institute, Inc.
+ * Apache-2.0 */
+
+/**
+ *
+ */
+export type SymbolType =
+  | "esriSLS"
+  | "esriSMS"
+  | "esriSFS"
+  | "esriPMS"
+  | "esriPFS"
+  | "esriTS";
+
+/**
+ *
+ */
+export interface ISymbol {
+  type: SymbolType;
+  style?: string;
+}

package/packages/arcgis-rest-common/src/util/location.ts

@@ -0,0 +1,19 @@
+/* Copyright (c) 2018 Environmental Systems Research Institute, Inc.
+ * Apache-2.0 */
+
+import { IPoint, ILocation } from "../types/geometry";
+
+export function isLocationArray(
+  coords: ILocation | IPoint | [number, number]
+): coords is [number, number] {
+  return (coords as [number, number]).length === 2;
+}
+
+export function isLocation(
+  coords: ILocation | IPoint | [number, number]
+): coords is ILocation {
+  return (
+    (coords as ILocation).latitude !== undefined ||
+    (coords as ILocation).lat !== undefined
+  );
+}

package/packages/arcgis-rest-common/test/location.test.ts

@@ -0,0 +1,73 @@
+/* Copyright (c) 2018 Environmental Systems Research Institute, Inc.
+ * Apache-2.0 */
+
+import { IPoint } from "../../arcgis-rest-common-types/src";
+import { ILocation } from "../src/types/geometry";
+import { isLocation, isLocationArray } from "../src/util/location";
+
+// -117.195677,34.056383;-117.918976,33.812092
+const stops: Array<[number, number]> = [
+  [-117.195677, 34.056383],
+  [-117.918976, 33.812092]
+];
+
+const stopsObjectsLatLong: ILocation[] = [
+  {
+    lat: 34.056383,
+    long: -117.195677
+  },
+  {
+    lat: 33.812092,
+    long: -117.918976
+  }
+];
+
+const stopsObjectsLatitudeLongitude: ILocation[] = [
+  {
+    latitude: 34.056383,
+    longitude: -117.195677
+  },
+  {
+    latitude: 33.812092,
+    longitude: -117.918976
+  }
+];
+
+const stopsObjectsPoint: IPoint[] = [
+  {
+    x: 34.056383,
+    y: -117.195677
+  },
+  {
+    x: 33.812092,
+    y: -117.918976
+  }
+];
+
+describe("location helpers", () => {
+  it("should recognize a shorthand location", done => {
+    expect(isLocation(stopsObjectsLatLong[0])).toEqual(true);
+    done();
+  });
+
+  it("should recognize a spelled out location", done => {
+    expect(isLocation(stopsObjectsLatitudeLongitude[0])).toEqual(true);
+    done();
+  });
+
+  it("should recognize that a point is not a location", done => {
+    expect(isLocation(stopsObjectsPoint[0])).toEqual(false);
+    done();
+  });
+
+  it("should recognize that raw coordinates are not a location", done => {
+    expect(isLocation(stops[0])).toEqual(false);
+    done();
+  });
+
+  it("should recognize a location array", done => {
+    expect(isLocationArray(stops[0])).toEqual(true);
+    expect(isLocationArray(stops[1])).toEqual(true);
+    done();
+  });
+});

package/packages/arcgis-rest-common/tsconfig.json

@@ -0,0 +1,6 @@
+{
+  "extends": "../../tsconfig.json",
+  "include": [
+      "src/**/*.ts"
+  ]
+}

package/packages/arcgis-rest-common-types/README.md

@@ -0,0 +1,64 @@
+[![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-common-types.svg?style=flat-square
+[npm-url]: https://www.npmjs.com/package/@esri/arcgis-rest-common-types
+[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-common-types
+
+> Common TypeScript types for [`@esri/arcgis-rest-*`](https://github.com/Esri/arcgis-rest-js) packages.
+
+### Example
+
+```bash
+npm install @esri/arcgis-rest-common-types
+```
+
+```ts
+import { IPoint } from '@esri/arcgis-rest-common-types';
+
+const myPoint = { x: -118.409, y: 33.943 } as IPoint
+
+```
+
+### [API Reference](https://esri.github.io/arcgis-rest-js/api/common-types/)
+
+### 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 2017 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-common-types/package.json

@@ -0,0 +1,40 @@
+{
+  "name": "@esri/arcgis-rest-common-types",
+  "version": "1.14.1",
+  "description": "Common TypeScript types for @esri/arcgis-rest-* packages.",
+  "types": "dist/types/index.d.ts",
+  "author": "",
+  "license": "Apache-2.0",
+  "files": [
+    "dist/types/*.d.ts",
+    "src/**/*.ts"
+  ],
+  "scripts": {
+    "prepare": "npm run build",
+    "build": "npm run build:esm",
+    "build:esm": "tsc",
+    "dev:esm": "tsc -w"
+  },
+  "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/"
+    },
+    {
+      "name": "Jeff Jacobson",
+      "url": "http://github.com/jeffjacobson"
+    }
+  ],
+  "bugs": {
+    "url": "https://github.com/Esri/arcgis-rest-js/issues"
+  },
+  "homepage": "https://github.com/Esri/arcgis-rest-js#readme"
+}