impeditmaiores 1.0.0

package/packages/arcgis-rest-routing/test/solveRoute.test.ts

@@ -0,0 +1,509 @@
+/* Copyright (c) 2018 Environmental Systems Research Institute, Inc.
+ * Apache-2.0 */
+
+import { solveRoute } from "../src/solveRoute";
+
+import * as fetchMock from "fetch-mock";
+
+import { Solve } from "./mocks/responses";
+import { IPoint, ILocation } from "@esri/arcgis-rest-types";
+
+// -117.195677,34.056383;-117.918976,33.812092
+const stops: Array<[number, number]> = [
+  [-117.195677, 34.056383],
+  [-117.918976, 33.812092]
+];
+
+// -117.195677,34.056383,10.11;-117.918976,33.812092,8.43
+const stops3: Array<[number, number, number]> = [
+  [-117.195677, 34.056383, 10.11],
+  [-117.918976, 33.812092, 8.43]
+];
+
+const stopsObjectsLatLong: ILocation[] = [
+  {
+    lat: 34.056383,
+    long: -117.195677
+  },
+  {
+    lat: 33.812092,
+    long: -117.918976
+  }
+];
+
+const stopsObjectsLatLong3: ILocation[] = [
+  {
+    lat: 34.056383,
+    long: -117.195677,
+    z: 10.11
+  },
+  {
+    lat: 33.812092,
+    long: -117.918976,
+    z: 8.43
+  }
+];
+
+const stopsObjectsLatitudeLongitude: ILocation[] = [
+  {
+    latitude: 34.056383,
+    longitude: -117.195677
+  },
+  {
+    latitude: 33.812092,
+    longitude: -117.918976
+  }
+];
+
+const stopsObjectsLatitudeLongitude3: ILocation[] = [
+  {
+    latitude: 34.056383,
+    longitude: -117.195677,
+    z: 10.11
+  },
+  {
+    latitude: 33.812092,
+    longitude: -117.918976,
+    z: 8.43
+  }
+];
+
+const stopsObjectsPoint: IPoint[] = [
+  {
+    x: -117.195677,
+    y: 34.056383
+  },
+  {
+    x: -117.918976,
+    y: 33.812092
+  }
+];
+
+const stopsObjectsPoint3: IPoint[] = [
+  {
+    x: -117.195677,
+    y: 34.056383,
+    z: 10.11
+  },
+  {
+    x: -117.918976,
+    y: 33.812092,
+    z: 8.43
+  }
+];
+
+// const customRoutingUrl =
+//   "https://foo.com/ArcGIS/rest/services/Network/USA/NAServer/";
+
+describe("solveRoute", () => {
+  afterEach(fetchMock.restore);
+
+  it("should throw an error when a solveRoute request is made without a token", done => {
+    fetchMock.once("*", Solve);
+
+    solveRoute({
+      stops
+    })
+      // tslint:disable-next-line
+      .catch(e => {
+        expect(e).toEqual(
+          "Routing using the ArcGIS service requires authentication"
+        );
+        done();
+      });
+  });
+
+  it("should make a simple solveRoute request (array of stops)", done => {
+    fetchMock.once("*", Solve);
+
+    const MOCK_AUTH = {
+      getToken() {
+        return Promise.resolve("token");
+      },
+      portal: "https://mapsdev.arcgis.com"
+    };
+
+    solveRoute({ stops, authentication: MOCK_AUTH })
+      .then(response => {
+        expect(fetchMock.called()).toEqual(true);
+        const [url, options]: [string, RequestInit] = fetchMock.lastCall("*");
+        expect(url).toEqual(
+          "https://route.arcgis.com/arcgis/rest/services/World/Route/NAServer/Route_World/solve"
+        );
+        expect(options.method).toBe("POST");
+        expect(options.body).toContain("f=json");
+        // "stops=-117.195677,34.056383;-117.918976,33.812092"
+        expect(options.body).toContain(
+          `stops=${encodeURIComponent(
+            "-117.195677,34.056383;-117.918976,33.812092"
+          )}`
+        );
+        expect(options.body).toContain("token=token");
+        expect(response.routes.spatialReference.latestWkid).toEqual(4326);
+        expect(response.routes.features[0].attributes.Name).toEqual(
+          "Location 1 - Location 2"
+        );
+        done();
+      })
+      .catch(e => {
+        fail(e);
+      });
+  });
+
+  it("should make a simple solveRoute request (array of 3d stops)", done => {
+    fetchMock.once("*", Solve);
+
+    const MOCK_AUTH = {
+      getToken() {
+        return Promise.resolve("token");
+      },
+      portal: "https://mapsdev.arcgis.com"
+    };
+
+    solveRoute({ stops: stops3, authentication: MOCK_AUTH })
+      .then(response => {
+        expect(fetchMock.called()).toEqual(true);
+        const [url, options]: [string, RequestInit] = fetchMock.lastCall("*");
+        expect(url).toEqual(
+          "https://route.arcgis.com/arcgis/rest/services/World/Route/NAServer/Route_World/solve"
+        );
+        expect(options.method).toBe("POST");
+        expect(options.body).toContain("f=json");
+        // "stops=-117.195677,34.056383,10.11;-117.918976,33.812092,8.43"
+        expect(options.body).toContain(
+          `stops=${encodeURIComponent(
+            "-117.195677,34.056383,10.11;-117.918976,33.812092,8.43"
+          )}`
+        );
+        expect(options.body).toContain("token=token");
+        expect(response.routes.spatialReference.latestWkid).toEqual(4326);
+        expect(response.routes.features[0].attributes.Name).toEqual(
+          "Location 1 - Location 2"
+        );
+        done();
+      })
+      .catch(e => {
+        fail(e);
+      });
+  });
+
+  it("should make a simple solveRoute request (array of objects - lat/lon)", done => {
+    fetchMock.once("*", Solve);
+
+    const MOCK_AUTH = {
+      getToken() {
+        return Promise.resolve("token");
+      },
+      portal: "https://mapsdev.arcgis.com"
+    };
+
+    solveRoute({
+      stops: stopsObjectsLatLong,
+      authentication: MOCK_AUTH
+    })
+      .then(response => {
+        expect(fetchMock.called()).toEqual(true);
+        const [url, options]: [string, RequestInit] = fetchMock.lastCall("*");
+        expect(url).toEqual(
+          "https://route.arcgis.com/arcgis/rest/services/World/Route/NAServer/Route_World/solve"
+        );
+        expect(options.method).toBe("POST");
+        expect(options.body).toContain("f=json");
+        // "stops=-117.195677,34.056383;-117.918976,33.812092"
+        expect(options.body).toContain(
+          `stops=${encodeURIComponent(
+            "-117.195677,34.056383;-117.918976,33.812092"
+          )}`
+        );
+        expect(options.body).toContain("token=token");
+        expect(response.routes.spatialReference.latestWkid).toEqual(4326);
+        expect(response.routes.features[0].attributes.Name).toEqual(
+          "Location 1 - Location 2"
+        );
+        done();
+      })
+      .catch(e => {
+        fail(e);
+      });
+  });
+
+  it("should make a simple solveRoute request (array of objects - 3d lat/lon)", done => {
+    fetchMock.once("*", Solve);
+
+    const MOCK_AUTH = {
+      getToken() {
+        return Promise.resolve("token");
+      },
+      portal: "https://mapsdev.arcgis.com"
+    };
+
+    solveRoute({
+      stops: stopsObjectsLatLong3,
+      authentication: MOCK_AUTH
+    })
+      .then(response => {
+        expect(fetchMock.called()).toEqual(true);
+        const [url, options]: [string, RequestInit] = fetchMock.lastCall("*");
+        expect(url).toEqual(
+          "https://route.arcgis.com/arcgis/rest/services/World/Route/NAServer/Route_World/solve"
+        );
+        expect(options.method).toBe("POST");
+        expect(options.body).toContain("f=json");
+        // "stops=-117.195677,34.056383,10.11;-117.918976,33.812092,8.43"
+        expect(options.body).toContain(
+          `stops=${encodeURIComponent(
+            "-117.195677,34.056383,10.11;-117.918976,33.812092,8.43"
+          )}`
+        );
+        expect(options.body).toContain("token=token");
+        expect(response.routes.spatialReference.latestWkid).toEqual(4326);
+        expect(response.routes.features[0].attributes.Name).toEqual(
+          "Location 1 - Location 2"
+        );
+        done();
+      })
+      .catch(e => {
+        fail(e);
+      });
+  });
+
+  it("should make a simple solveRoute request (array of objects - latitude/longitude)", done => {
+    fetchMock.once("*", Solve);
+
+    const MOCK_AUTH = {
+      getToken() {
+        return Promise.resolve("token");
+      },
+      portal: "https://mapsdev.arcgis.com"
+    };
+
+    solveRoute({
+      stops: stopsObjectsLatitudeLongitude,
+      authentication: MOCK_AUTH
+    })
+      .then(response => {
+        expect(fetchMock.called()).toEqual(true);
+        const [url, options]: [string, RequestInit] = fetchMock.lastCall("*");
+        expect(url).toEqual(
+          "https://route.arcgis.com/arcgis/rest/services/World/Route/NAServer/Route_World/solve"
+        );
+        expect(options.method).toBe("POST");
+        expect(options.body).toContain("f=json");
+        // "stops=-117.195677,34.056383;-117.918976,33.812092"
+        expect(options.body).toContain(
+          `stops=${encodeURIComponent(
+            "-117.195677,34.056383;-117.918976,33.812092"
+          )}`
+        );
+        expect(options.body).toContain("token=token");
+        expect(response.routes.spatialReference.latestWkid).toEqual(4326);
+        expect(response.routes.features[0].attributes.Name).toEqual(
+          "Location 1 - Location 2"
+        );
+        done();
+      })
+      .catch(e => {
+        fail(e);
+      });
+  });
+
+  it("should make a simple solveRoute request (array of objects - 3d latitude/longitude)", done => {
+    fetchMock.once("*", Solve);
+
+    const MOCK_AUTH = {
+      getToken() {
+        return Promise.resolve("token");
+      },
+      portal: "https://mapsdev.arcgis.com"
+    };
+
+    solveRoute({
+      stops: stopsObjectsLatitudeLongitude3,
+      authentication: MOCK_AUTH
+    })
+      .then(response => {
+        expect(fetchMock.called()).toEqual(true);
+        const [url, options]: [string, RequestInit] = fetchMock.lastCall("*");
+        expect(url).toEqual(
+          "https://route.arcgis.com/arcgis/rest/services/World/Route/NAServer/Route_World/solve"
+        );
+        expect(options.method).toBe("POST");
+        expect(options.body).toContain("f=json");
+        // "stops=-117.195677,34.056383,10.11;-117.918976,33.812092,8.43"
+        expect(options.body).toContain(
+          `stops=${encodeURIComponent(
+            "-117.195677,34.056383,10.11;-117.918976,33.812092,8.43"
+          )}`
+        );
+        expect(options.body).toContain("token=token");
+        expect(response.routes.spatialReference.latestWkid).toEqual(4326);
+        expect(response.routes.features[0].attributes.Name).toEqual(
+          "Location 1 - Location 2"
+        );
+        done();
+      })
+      .catch(e => {
+        fail(e);
+      });
+  });
+
+  it("should make a simple solveRoute request (array of objects - latitude/longitude)", done => {
+    fetchMock.once("*", Solve);
+
+    const MOCK_AUTH = {
+      getToken() {
+        return Promise.resolve("token");
+      },
+      portal: "https://mapsdev.arcgis.com"
+    };
+
+    solveRoute({
+      stops: stopsObjectsLatitudeLongitude,
+      authentication: MOCK_AUTH
+    })
+      .then(response => {
+        expect(fetchMock.called()).toEqual(true);
+        const [url, options]: [string, RequestInit] = fetchMock.lastCall("*");
+        expect(url).toEqual(
+          "https://route.arcgis.com/arcgis/rest/services/World/Route/NAServer/Route_World/solve"
+        );
+        expect(options.method).toBe("POST");
+        expect(options.body).toContain("f=json");
+        // "stops=-117.195677,34.056383;-117.918976,33.812092"
+        expect(options.body).toContain(
+          `stops=${encodeURIComponent(
+            "-117.195677,34.056383;-117.918976,33.812092"
+          )}`
+        );
+        expect(options.body).toContain("token=token");
+        expect(response.routes.spatialReference.latestWkid).toEqual(4326);
+        expect(response.routes.features[0].attributes.Name).toEqual(
+          "Location 1 - Location 2"
+        );
+        done();
+      })
+      .catch(e => {
+        fail(e);
+      });
+  });
+
+  it("should make a simple solveRoute request (array of objects - 3d latitude/longitude)", done => {
+    fetchMock.once("*", Solve);
+
+    const MOCK_AUTH = {
+      getToken() {
+        return Promise.resolve("token");
+      },
+      portal: "https://mapsdev.arcgis.com"
+    };
+
+    solveRoute({
+      stops: stopsObjectsLatitudeLongitude3,
+      authentication: MOCK_AUTH
+    })
+      .then(response => {
+        expect(fetchMock.called()).toEqual(true);
+        const [url, options]: [string, RequestInit] = fetchMock.lastCall("*");
+        expect(url).toEqual(
+          "https://route.arcgis.com/arcgis/rest/services/World/Route/NAServer/Route_World/solve"
+        );
+        expect(options.method).toBe("POST");
+        expect(options.body).toContain("f=json");
+        // "stops=-117.195677,34.056383,10.11;-117.918976,33.812092,8.43"
+        expect(options.body).toContain(
+          `stops=${encodeURIComponent(
+            "-117.195677,34.056383,10.11;-117.918976,33.812092,8.43"
+          )}`
+        );
+        expect(options.body).toContain("token=token");
+        expect(response.routes.spatialReference.latestWkid).toEqual(4326);
+        expect(response.routes.features[0].attributes.Name).toEqual(
+          "Location 1 - Location 2"
+        );
+        done();
+      })
+      .catch(e => {
+        fail(e);
+      });
+  });
+
+  it("should make a simple solveRoute request (array of IPoint)", done => {
+    fetchMock.once("*", Solve);
+
+    const MOCK_AUTH = {
+      getToken() {
+        return Promise.resolve("token");
+      },
+      portal: "https://mapsdev.arcgis.com"
+    };
+
+    solveRoute({
+      stops: stopsObjectsPoint,
+      authentication: MOCK_AUTH
+    })
+      .then(response => {
+        expect(fetchMock.called()).toEqual(true);
+        const [url, options]: [string, RequestInit] = fetchMock.lastCall("*");
+        expect(url).toEqual(
+          "https://route.arcgis.com/arcgis/rest/services/World/Route/NAServer/Route_World/solve"
+        );
+        expect(options.method).toBe("POST");
+        expect(options.body).toContain("f=json");
+        // "stops=-117.195677,34.056383;-117.918976,33.812092"
+        expect(options.body).toContain(
+          `stops=${encodeURIComponent(
+            "-117.195677,34.056383;-117.918976,33.812092"
+          )}`
+        );
+        expect(options.body).toContain("token=token");
+        expect(response.routes.spatialReference.latestWkid).toEqual(4326);
+        expect(response.routes.features[0].attributes.Name).toEqual(
+          "Location 1 - Location 2"
+        );
+        done();
+      })
+      .catch(e => {
+        fail(e);
+      });
+  });
+
+  it("should make a simple solveRoute request (array of 3d  IPoint)", done => {
+    fetchMock.once("*", Solve);
+
+    const MOCK_AUTH = {
+      getToken() {
+        return Promise.resolve("token");
+      },
+      portal: "https://mapsdev.arcgis.com"
+    };
+
+    solveRoute({
+      stops: stopsObjectsPoint3,
+      authentication: MOCK_AUTH
+    })
+      .then(response => {
+        expect(fetchMock.called()).toEqual(true);
+        const [url, options]: [string, RequestInit] = fetchMock.lastCall("*");
+        expect(url).toEqual(
+          "https://route.arcgis.com/arcgis/rest/services/World/Route/NAServer/Route_World/solve"
+        );
+        expect(options.method).toBe("POST");
+        expect(options.body).toContain("f=json");
+        // "stops=-117.195677,34.056383,10.11;-117.918976,33.812092,8.43"
+        expect(options.body).toContain(
+          `stops=${encodeURIComponent(
+            "-117.195677,34.056383,10.11;-117.918976,33.812092,8.43"
+          )}`
+        );
+        expect(options.body).toContain("token=token");
+        expect(response.routes.spatialReference.latestWkid).toEqual(4326);
+        expect(response.routes.features[0].attributes.Name).toEqual(
+          "Location 1 - Location 2"
+        );
+        done();
+      })
+      .catch(e => {
+        fail(e);
+      });
+  });
+});

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

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

package/packages/arcgis-rest-service-admin/README.md

@@ -0,0 +1,73 @@
+[![npm version][npm-img]][npm-url]
+[![build status][travis-img]][travis-url]
+[![gzip bundle size][gzip-image]][npm-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-service-admin.svg?style=flat-square
+[npm-url]: https://www.npmjs.com/package/@esri/arcgis-rest-service-admin
+[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
+[gzip-image]: https://img.badgesize.io/https://unpkg.com/@esri/arcgis-rest-service-admin/dist/umd/feature-service-admin.umd.min.js?compression=gzip
+[coverage-img]: https://codecov.io/gh/Esri/arcgis-rest-js/branch/master/graph/badge.svg
+[coverage-url]: https://codecov.io/gh/Esri/arcgis-rest-js
+
+# @esri/arcgis-rest-service-admin
+
+> A module for administering ArcGIS feature services that runs in Node.js and modern browsers.
+
+### Example
+
+```bash
+npm install @esri/arcgis-rest-request
+npm install @esri/arcgis-rest-auth
+npm install @esri/arcgis-rest-portal
+npm install @esri/arcgis-rest-service-admin
+```
+
+```js
+import { createFeatureService } from '@esri/arcgis-rest-service-admin';
+
+createFeatureService({
+  authentication,
+  item: { name: "GreenField" }
+})
+```
+
+### [API Reference](https://esri.github.io/arcgis-rest-js/api/service-admin/)
+
+### 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).
+
+### [Changelog](https://github.com/Esri/arcgis-rest-js/blob/master/CHANGELOG.md)
+
+### License
+
+Copyright &copy; 2018-2019 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-service-admin/package-lock.json

@@ -0,0 +1,11 @@
+{
+	"requires": true,
+	"lockfileVersion": 1,
+	"dependencies": {
+		"tslib": {
+			"version": "1.13.0",
+			"resolved": "https://registry.npmjs.org/tslib/-/tslib-1.13.0.tgz",
+			"integrity": "sha512-i/6DQjL8Xf3be4K/E6Wgpekn5Qasl1usyw++dAA35Ue5orEn65VIxOA+YvNNl9HV3qv70T7CNwjODHZrLwvd1Q=="
+		}
+	}
+}

package/packages/arcgis-rest-service-admin/package.json

@@ -0,0 +1,65 @@
+{
+  "name": "@esri/arcgis-rest-service-admin",
+  "version": "2.22.0",
+  "description": "Service administration helpers for @esri/arcgis-rest-js",
+  "main": "dist/node/index.js",
+  "unpkg": "dist/umd/service-admin.umd.js",
+  "module": "dist/esm/index.js",
+  "js:next": "dist/esm/index.js",
+  "sideEffects": false,
+  "types": "dist/esm/index.d.ts",
+  "license": "Apache-2.0",
+  "files": [
+    "dist/**"
+  ],
+  "dependencies": {
+    "@esri/arcgis-rest-types": "^2.22.0",
+    "tslib": "^1.13.0"
+  },
+  "devDependencies": {
+    "@esri/arcgis-rest-auth": "^2.22.0",
+    "@esri/arcgis-rest-portal": "^2.22.0",
+    "@esri/arcgis-rest-request": "^2.22.0"
+  },
+  "peerDependencies": {
+    "@esri/arcgis-rest-auth": "^2.0.0",
+    "@esri/arcgis-rest-portal": "^2.0.0",
+    "@esri/arcgis-rest-request": "^2.0.0"
+  },
+  "scripts": {
+    "prepare": "npm run build",
+    "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",
+    "directory": "packages/arcgis-rest-service-admin"
+  },
+  "contributors": [
+    {
+      "name": "Mike Tschudi",
+      "email": "mtschudi@esri.com"
+    }
+  ],
+  "bugs": {
+    "url": "https://github.com/Esri/arcgis-rest-js/issues"
+  },
+  "homepage": "https://github.com/Esri/arcgis-rest-js#readme",
+  "keywords": [
+    "typescript",
+    "promise",
+    "fetch",
+    "arcgis",
+    "esri",
+    "ES6"
+  ]
+}