etincidunt 1.0.0

package/packages/arcgis-rest-feature-service/test/mocks/feature.ts

@@ -0,0 +1,220 @@
+import { IFeature } from "@esri/arcgis-rest-common-types";
+
+export const featureResponse = {
+  feature: {
+    attributes: {
+      FID: 42
+    },
+    geometry: {
+      x: -9177311.62541634,
+      y: 4247151.205222242
+    }
+  }
+};
+
+export const queryResponse = {
+  objectIdFieldName: "FID",
+  globalIdFieldName: "",
+  geometryType: "esriGeometryPoint",
+  spatialReference: {
+    wkid: 102100,
+    latestWkid: 3857
+  },
+  // fields: [],
+  features: [
+    {
+      attributes: {
+        FID: 1,
+        Tree_ID: 102,
+        Collected: 1349395200000,
+        Crew: "Linden+ Forrest+ Johnny",
+        Status: "P",
+        Spp_Code: "ULPU",
+        Land_Use: "I",
+        Ht_DBH_ft: 4.5,
+        DBH1: 41,
+        DBH2: 0,
+        DBH3: 0,
+        DBH4: 0,
+        DBH5: 0,
+        DBH6: " ",
+        Height: 74,
+        Live_Top: 74,
+        Crown_Base: 21,
+        Width_NS: 75,
+        Width_EW: 40,
+        Cn_Missing: 10,
+        Cn_DieBack: 15,
+        CLE: 2,
+        Tree_Site: "S",
+        Tree_Age: " ",
+        Notes: " ",
+        Cmn_Name: "Siberian elm",
+        Sci_Name: "Ulmus pumila",
+        GroundArea: 2596,
+        Condition: "Fair",
+        Leaf_Area: 10295,
+        Leaf_Bmass: 144,
+        LAI: 3.96,
+        C_Storage: 6771,
+        C_Seq: 95,
+        S_Value: "3,079.00",
+        Street: "YES",
+        Native: "NO",
+        CO_Rmvd: 5.06,
+        O3_Rmvd: 470.97,
+        NO2_Rmvd: 39.24,
+        PM10_Rmvd: 343.45,
+        SO2_Rmvd: 27.64,
+        PM2p5_Rmvd: 47.84,
+        CO_RVlu: 0.01,
+        O3_Rvlu: 0.42,
+        NO2_Rvlu: 0,
+        PM10_Rvlu: 3.73,
+        SO2_Rvlu: 0,
+        PM2p5_RVlu: 1.99,
+        Isoprene_E: 2.7,
+        Monoterp_E: 13.2,
+        Vocs_E: 15.9,
+        Dedication: " ",
+        Longitude: -82.441189,
+        Latitude: 35.610441,
+        Crown_Height: 53
+      }
+    },
+    {
+      attributes: {
+        FID: 2,
+        Tree_ID: 103,
+        Collected: 1349395200000,
+        Crew: "Linden+ Forrest+ Johnny",
+        Status: "P",
+        Spp_Code: "ULPU",
+        Land_Use: "I",
+        Ht_DBH_ft: 4.5,
+        DBH1: 55,
+        DBH2: 0,
+        DBH3: 0,
+        DBH4: 0,
+        DBH5: 0,
+        DBH6: " ",
+        Height: 70,
+        Live_Top: 70,
+        Crown_Base: 21,
+        Width_NS: 90,
+        Width_EW: 71,
+        Cn_Missing: 5,
+        Cn_DieBack: 15,
+        CLE: 3,
+        Tree_Site: "S",
+        Tree_Age: " ",
+        Notes: " ",
+        Cmn_Name: "Siberian elm",
+        Sci_Name: "Ulmus pumila",
+        GroundArea: 5089,
+        Condition: "Fair",
+        Leaf_Area: 17078,
+        Leaf_Bmass: 238,
+        LAI: 3.36,
+        C_Storage: 13228,
+        C_Seq: 22,
+        S_Value: "4,187.00",
+        Street: "YES",
+        Native: "NO",
+        CO_Rmvd: 8.4,
+        O3_Rmvd: 781.35,
+        NO2_Rmvd: 65.1,
+        PM10_Rmvd: 600.8,
+        SO2_Rmvd: 45.86,
+        PM2p5_Rmvd: 83.68,
+        CO_RVlu: 0.01,
+        O3_Rvlu: 0.69,
+        NO2_Rvlu: 0.01,
+        PM10_Rvlu: 6.53,
+        SO2_Rvlu: 0,
+        PM2p5_RVlu: 3.48,
+        Isoprene_E: 4.47,
+        Monoterp_E: 21.9,
+        Vocs_E: 26.38,
+        Dedication: " ",
+        Longitude: -82.441107,
+        Latitude: 35.610472,
+        Crown_Height: 49
+      }
+    }
+  ]
+};
+
+export const addFeaturesResponse = {
+  addResults: [
+    {
+      objectId: 1001,
+      success: true
+    }
+  ]
+};
+
+export const updateFeaturesResponse = {
+  updateResults: [
+    {
+      objectId: 1001,
+      success: true
+    }
+  ]
+};
+
+export const deleteFeaturesResponse = {
+  deleteResults: [
+    {
+      objectId: 1001,
+      success: true
+    }
+  ]
+};
+
+export const getAttachmentsResponse = {
+  attachmentInfos: [
+    {
+      id: 409,
+      contentType: "application/pdf",
+      size: 400633,
+      name: "Permit_Application_20180416"
+    },
+    {
+      id: 822,
+      contentType: "application/pdf",
+      size: 619543,
+      name: "Planning_Review_20180604"
+    }
+  ]
+};
+
+export const addAttachmentResponse = {
+  addAttachmentResult: {
+    objectId: 1001,
+    success: true
+  }
+};
+
+export const updateAttachmentResponse = {
+  updateAttachmentResult: {
+    objectId: 1001,
+    success: true
+  }
+};
+
+export const deleteAttachmentsResponse = {
+  deleteAttachmentResults: [
+    {
+      objectId: 1001,
+      success: true
+    }
+  ]
+};
+
+export const genericInvalidResponse = {
+  error: {
+    code: 400,
+    message: "Invalid or missing input parameters."
+  }
+};

package/packages/arcgis-rest-feature-service/test/mocks/foo.txt

@@ -0,0 +1 @@
+Hello World!

package/packages/arcgis-rest-feature-service/tsconfig.json

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

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

@@ -0,0 +1,73 @@
+[![npm version][npm-img]][npm-url]
+[![build status][travis-img]][travis-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-geocoder.svg?style=flat-square
+[npm-url]: https://www.npmjs.com/package/@esri/arcgis-rest-geocoder
+[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
+
+# @esri/arcgis-rest-geocoder
+
+> Geocoding helpers for [`@esri/arcgis-rest-request`](https://github.com/Esri/arcgis-rest-js).
+
+### Example
+
+```bash
+npm install @esri/arcgis-rest-request
+npm install @esri/arcgis-rest-geocoder
+```
+
+```js
+import { geocode } from '@esri/arcgis-rest-geocoder';
+
+geocode("LAX")
+  .then((response) => {
+    response.candidates[0].location;
+    // => { x: -118.409, y: 33.943  }
+  });
+```
+
+### [API Reference](https://esri.github.io/arcgis-rest-js/api/geocoder/)
+
+* [`geocode("1 World Way Los Angeles 90045")`](https://esri.github.io/arcgis-rest-js/api/geocoder/geocode/)
+
+* [`suggest("Starb")`](https://esri.github.io/arcgis-rest-js/api/geocoder/suggest/)
+
+* [`reverseGeocode([-118.409,33.943 ])`](https://esri.github.io/arcgis-rest-js/api/geocoder/reverseGeocode/)
+
+* [`bulkGeocode()`](https://esri.github.io/arcgis-rest-js/api/geocoder/bulkGeocode/)
+
+### 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-geocoder/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-geocoder/package.json

@@ -0,0 +1,52 @@
+{
+  "name": "@esri/arcgis-rest-geocoder",
+  "version": "1.6.0",
+  "description": "Geocoding helpers for @esri/arcgis-rest-request",
+  "main": "dist/node/index.js",
+  "browser": "dist/umd/geocoder.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"
+  },
+  "peerDependencies": {
+    "@esri/arcgis-rest-auth": "^1.5.1",
+    "@esri/arcgis-rest-common-types": "^1.5.1",
+    "@esri/arcgis-rest-request": "^1.5.1"
+  },
+  "devDependencies": {
+    "@esri/arcgis-rest-auth": "^1.6.0",
+    "@esri/arcgis-rest-common-types": "^1.6.0",
+    "@esri/arcgis-rest-request": "^1.6.0"
+  },
+  "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"
+  },
+  "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-geocoder/src/bulk.ts

@@ -0,0 +1,102 @@
+/* Copyright (c) 2017 Environmental Systems Research Institute, Inc.
+ * Apache-2.0 */
+
+import { request } from "@esri/arcgis-rest-request";
+
+import { ISpatialReference, IPoint } from "@esri/arcgis-rest-common-types";
+
+import { worldGeocoder, IEndpointRequestOptions } from "./helpers";
+
+// it'd be better if doc didnt display these properties in alphabetical order
+export interface IAddressBulk {
+  /**
+   * A unique id must be passed along for each individual address.
+   */
+  OBJECTID: number;
+  address?: string;
+  address2?: string;
+  address3?: string;
+  neighborhood?: string;
+  city?: string;
+  subregion?: string;
+  /**
+   * The World Geocoding Service considers US states regions.
+   */
+  region?: string;
+  postal?: number;
+  postalExt?: number;
+  countryCode?: string;
+}
+
+export interface IBulkGeocodeRequestOptions extends IEndpointRequestOptions {
+  addresses: IAddressBulk[];
+}
+
+export interface IBulkGeocodeResponse {
+  spatialReference: ISpatialReference;
+  locations: Array<{
+    address: string;
+    location: IPoint;
+    score: number;
+    attributes: object;
+  }>;
+}
+
+/**
+ * Used to geocode a batch of addresses
+ *
+ * ```js
+ * import { bulkGeocode } from '@esri/arcgis-rest-geocoder';
+ * import { ApplicationSession } from '@esri/arcgis-rest-auth';
+ *
+ * const addresses = [
+ *   { "OBJECTID": 1, "SingleLine": "380 New York Street 92373" },
+ *   { "OBJECTID": 2, "SingleLine": "1 World Way Los Angeles 90045" }
+ * ];
+ *
+ * bulkGeocode({ addresses, authentication: session })
+ *   .then((response) => {
+ *     response.locations[0].location; // => { x: -117, y: 34, spatialReference: { wkid: 4326 } }
+ *   });
+ * ```
+ *
+ * @param requestOptions - Request options to pass to the geocoder, including an array of addresses and authentication session.
+ * @returns A Promise that will resolve with the data from the response.
+ */
+export function bulkGeocode(
+  requestOptions: IBulkGeocodeRequestOptions // must POST
+) {
+  const options: IBulkGeocodeRequestOptions = {
+    endpoint: worldGeocoder,
+    params: {
+      forStorage: true,
+      addresses: { records: [] }
+    },
+    ...requestOptions
+  };
+
+  requestOptions.addresses.forEach(address => {
+    options.params.addresses.records.push({ attributes: address });
+  });
+
+  // the SAS service doesnt support anonymous requests
+  if (!requestOptions.authentication && options.endpoint === worldGeocoder) {
+    return Promise.reject(
+      "bulk geocoding using the ArcGIS service requires authentication"
+    );
+  }
+
+  return request(options.endpoint + "geocodeAddresses", options).then(
+    response => {
+      const sr = response.spatialReference;
+      response.locations.forEach(function(address: { location: IPoint }) {
+        address.location.spatialReference = sr;
+      });
+      return response;
+    }
+  );
+}
+
+export default {
+  bulkGeocode
+};

package/packages/arcgis-rest-geocoder/src/geocode.ts

@@ -0,0 +1,117 @@
+/* Copyright (c) 2017 Environmental Systems Research Institute, Inc.
+ * Apache-2.0 */
+
+import { request, IParams } from "@esri/arcgis-rest-request";
+
+import {
+  IExtent,
+  ISpatialReference,
+  IPoint
+} from "@esri/arcgis-rest-common-types";
+
+import { worldGeocoder, IEndpointRequestOptions } from "./helpers";
+
+export interface IGeocodeParams extends IParams {
+  /**
+   * You can create an autocomplete experience by making a call to suggest with partial text and then passing through the magicKey and complete address that are returned to geocode.
+   * ```js
+   * import { suggest, geocode } from '@esri/arcgis-rest-geocoder';
+   * suggest("LAX")
+   *   .then((response) => {
+   *     response.suggestions[2].magicKey; // =>  "dHA9MCNsb2M9Mjk3ODc2MCNsbmc9MzMjcGw9ODkxNDg4I2xicz0xNDoxNDc4MTI1MA=="
+   *   });
+   * geocode("LAX, 1 World Way, Los Angeles, CA, 90045, USA", {magicKey: "dHA9MCN..."})
+   * ```
+   */
+  magicKey?: string;
+}
+
+export interface IGeocodeRequestOptions extends IEndpointRequestOptions {
+  address?: string;
+  address2?: string;
+  address3?: string;
+  neighborhood?: string;
+  city?: string;
+  subregion?: string;
+  /**
+   * The World Geocoding Service expects US states to be passed in as a 'region'.
+   */
+  region?: string;
+  postal?: number;
+  postalExt?: number;
+  countryCode?: string;
+}
+
+export interface IGeocodeResponse {
+  spatialReference: ISpatialReference;
+  candidates: Array<{
+    address: string;
+    location: IPoint;
+    extent: IExtent;
+    attributes: object;
+  }>;
+}
+
+/**
+ * Used to determine the location of a single address or point of interest
+ *
+ * ```js
+ * import { geocode } from '@esri/arcgis-rest-geocoder';
+ *
+ * geocode("LAX")
+ *   .then((response) => {
+ *     response.candidates[0].location; // => { x: -118.409, y: 33.943, spatialReference: { wkid: 4326 }  }
+ *   });
+ *
+ * geocode({
+ *   params: {
+ *     address: "1600 Pennsylvania Ave",
+ *     postal: 20500,
+ *     countryCode: "USA"
+ *   }
+ * })
+ *   .then((response) => {
+ *     response.candidates[0].location; // => { x: -77.036533, y: 38.898719, spatialReference: { wkid: 4326 } }
+ *   });
+ * ```
+ *
+ * @param address String representing the address or point of interest or RequestOptions to pass to the endpoint.
+ * @returns A Promise that will resolve with address candidates for the request.
+ */
+export function geocode(
+  address: string | IGeocodeRequestOptions
+): Promise<IGeocodeResponse> {
+  let options: IGeocodeRequestOptions = {
+    endpoint: worldGeocoder,
+    params: {}
+  };
+
+  if (typeof address === "string") {
+    options.params.singleLine = address;
+  } else {
+    options.endpoint = address.endpoint || worldGeocoder;
+    options = {
+      ...options,
+      ...address
+    };
+  }
+
+  // add spatialReference property to individual matches
+  return request(options.endpoint + "findAddressCandidates", options).then(
+    response => {
+      const sr = response.spatialReference;
+      response.candidates.forEach(function(candidate: {
+        location: IPoint;
+        extent: IExtent;
+      }) {
+        candidate.location.spatialReference = sr;
+        candidate.extent.spatialReference = sr;
+      });
+      return response;
+    }
+  );
+}
+
+export default {
+  geocode
+};

package/packages/arcgis-rest-geocoder/src/helpers.ts

@@ -0,0 +1,81 @@
+/* Copyright (c) 2017 Environmental Systems Research Institute, Inc.
+ * Apache-2.0 */
+
+import { request, IRequestOptions, warn } from "@esri/arcgis-rest-request";
+
+import { IPoint } from "@esri/arcgis-rest-common-types";
+
+// https always
+export const worldGeocoder =
+  "https://geocode.arcgis.com/arcgis/rest/services/World/GeocodeServer/";
+
+export interface ILocation {
+  latitude?: number;
+  longitude?: number;
+  lat?: number;
+  long?: number;
+}
+
+// nice to have: verify custom endpoints contain 'GeocodeServer' and end in a '/'
+export interface IEndpointRequestOptions extends IRequestOptions {
+  /**
+   * Any ArcGIS Geocoding service (example: http://sampleserver6.arcgisonline.com/arcgis/rest/services/Locators/SanDiego/GeocodeServer )
+   */
+  endpoint?: string;
+}
+
+export interface IGetGeocodeServiceResponse {
+  currentVersion: number;
+  serviceDescription: string;
+  addressFields: any[];
+  countries: string[];
+  capabilities: string;
+}
+
+/**
+ * Used to fetch metadata from a geocoding service.
+ *
+ * ```js
+ * import { getGeocoderServiceInfo } from '@esri/arcgis-rest-geocoder';
+ *
+ * getGeocoderServiceInfo()
+ *   .then((response) => {
+ *     response.serviceDescription; // => 'World Geocoder'
+ *   });
+ * ```
+ *
+ * @param requestOptions - Request options can contain a custom geocoding service to fetch metadata from.
+ * @returns A Promise that will resolve with the data from the response.
+ */
+export function getGeocodeService(
+  requestOptions?: IEndpointRequestOptions
+): Promise<IGetGeocodeServiceResponse> {
+  const url = (requestOptions && requestOptions.endpoint) || worldGeocoder;
+
+  const options: IEndpointRequestOptions = {
+    httpMethod: "GET",
+    maxUrlLength: 2000,
+    ...requestOptions
+  };
+
+  return request(url, options);
+}
+
+/**
+ * Deprecated. Please use [`getGeocodeService()`](../getGeocodeService/) instead.
+ *
+ * @param requestOptions - Request options can contain a custom geocoding service to fetch metadata from.
+ * @returns A Promise that will resolve with the data from the response.
+ */
+export function serviceInfo(
+  requestOptions?: IEndpointRequestOptions
+): Promise<IGetGeocodeServiceResponse> {
+  warn(
+    "serviceInfo() will be deprecated in the next major release. please use getGeocoderServiceInfo() instead."
+  );
+  return getGeocodeService(requestOptions);
+}
+
+export default {
+  getGeocodeService
+};

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

@@ -0,0 +1,4 @@
+export * from "./geocode";
+export * from "./suggest";
+export * from "./reverse";
+export * from "./bulk";