delectusnon 1.0.0

package/packages/arcgis-rest-request/src/utils/process-params.ts

@@ -0,0 +1,99 @@
+/* Copyright (c) 2017 Environmental Systems Research Institute, Inc.
+* Apache-2.0 */
+
+/**
+ * Checks parameters to see if we should use FormData to send the request
+ * @param params The object whose keys will be encoded.
+ * @return A boolean indicating if FormData will be required.
+ */
+export function requiresFormData(params: any) {
+  return Object.keys(params).some(key => {
+    const value = params[key];
+
+    if (!value) {
+      return false;
+    }
+
+    const type = value.constructor.name;
+
+    switch (type) {
+      case "Array":
+        return false;
+      case "Object":
+        return false;
+      case "Date":
+        return false;
+      case "Function":
+        return false;
+      case "Boolean":
+        return false;
+      case "String":
+        return false;
+      case "Number":
+        return false;
+      default:
+        return true;
+    }
+  });
+}
+
+/**
+ * Converts parameters to the proper representation to send to the ArcGIS REST API.
+ * @param params The object whose keys will be encoded.
+ * @return A new object with properly encoded values.
+ */
+export function processParams(params: any): any {
+  const newParams: any = {};
+
+  Object.keys(params).forEach(key => {
+    const param = params[key];
+    if (
+      !param &&
+      param !== 0 &&
+      typeof param !== "boolean" &&
+      typeof param !== "string"
+    ) {
+      return;
+    }
+    const type = param.constructor.name;
+
+    let value: any;
+
+    // properly encodes objects, arrays and dates for arcgis.com and other services.
+    // ported from https://github.com/Esri/esri-leaflet/blob/master/src/Request.js#L22-L30
+    // also see https://github.com/Esri/arcgis-rest-js/issues/18:
+    // null, undefined, function are excluded. If you want to send an empty key you need to send an empty string "".
+    switch (type) {
+      case "Array":
+        // Based on the first element of the array, classify array as an array of objects to be stringified
+        // or an array of non-objects to be comma-separated
+        value =
+          param[0] &&
+          param[0].constructor &&
+          param[0].constructor.name === "Object"
+            ? JSON.stringify(param)
+            : param.join(",");
+        break;
+      case "Object":
+        value = JSON.stringify(param);
+        break;
+      case "Date":
+        value = param.valueOf();
+        break;
+      case "Function":
+        value = null;
+        break;
+      case "Boolean":
+        value = param + "";
+        break;
+      default:
+        value = param;
+        break;
+    }
+    if (value || value === 0 || typeof value === "string") {
+      newParams[key] = value;
+    }
+  });
+
+  return newParams;
+}

package/packages/arcgis-rest-request/test/mocks/errors.ts

@@ -0,0 +1,68 @@
+/* Copyright (c) 2018 Environmental Systems Research Institute, Inc.
+ * Apache-2.0 */
+
+export const ArcGISOnlineError: any = {
+  error: {
+    code: 400,
+    message: "'type' and 'title' property required.",
+    details: []
+  }
+};
+
+export const ArcGISOnlineAuthError: any = {
+  error: {
+    code: 498,
+    message: "Invalid token.",
+    details: []
+  }
+};
+
+export const ArcGISOnlineErrorNoMessageCode: any = {
+  error: {
+    code: 403,
+    message:
+      "You do not have permissions to access this resource or perform this operation.",
+    details: []
+  }
+};
+
+export const ArcGISOnlineErrorNoCode: any = {
+  error: {
+    message:
+      "You do not have permissions to access this resource or perform this operation.",
+    details: []
+  }
+};
+
+export const ArcGISServerTokenRequired: any = {
+  error: {
+    code: 499,
+    message: "Token Required",
+    messageCode: "GWM_0003",
+    details: ["Token Required"]
+  }
+};
+
+export const BillingError: any = {
+  code: 500,
+  message: "Error getting subscription info",
+  status: "failure",
+  details: null as any
+};
+
+export const BillingErrorWithCode200: any = {
+  code: 200,
+  message: null,
+  status: "failure"
+};
+
+export const TaskErrorWithJSON: any = {
+  status: "failed",
+  statusMessage:
+    '{"code":400,"message":"Index was outside the bounds of the array."}'
+};
+
+export const TaskError: any = {
+  status: "failed",
+  statusMessage: "failed"
+};

package/packages/arcgis-rest-request/test/mocks/geojson-feature-collection.ts

@@ -0,0 +1,13 @@
+/* Copyright (c) 2018 Environmental Systems Research Institute, Inc.
+ * Apache-2.0 */
+
+export const GeoJSONFeatureCollection: any = {
+  type: "FeatureCollection",
+  crs: {
+    type: "name",
+    properties: {
+      name: "EPSG:4326"
+    }
+  },
+  features: []
+};

package/packages/arcgis-rest-request/test/mocks/portal.ts

@@ -0,0 +1,112 @@
+/* Copyright (c) 2018 Environmental Systems Research Institute, Inc.
+ * Apache-2.0 */
+
+import { IPortal } from "../../src/utils/get-portal";
+
+export const PortalResponse: IPortal = {
+  access: "public",
+  allSSL: false,
+  allowedRedirectUris: [],
+  analysisLayersGroupQuery:
+    'title:"Living Atlas Analysis Layers" AND owner:esri',
+  authorizedCrossOriginDomains: [],
+  availableCredits: 9584.193,
+  basemapGalleryGroupQuery: "id:06d589ea1fdb47768ee3870f497333c0",
+  canListApps: false,
+  canListData: false,
+  canListPreProvisionedItems: false,
+  canProvisionDirectPurchase: false,
+  canSearchPublic: true,
+  canShareBingPublic: false,
+  canSharePublic: true,
+  canSignInArcGIS: true,
+  canSignInIDP: true,
+  colorSetsGroupQuery: 'title:"Esri Colors" AND owner:esri_en',
+  commentsEnabled: true,
+  created: 1392336986000,
+  creditAssignments: "enabled",
+  culture: "en",
+  customBaseUrl: "mapsdevext.arcgis.com",
+  databaseQuota: -1,
+  databaseUsage: -1,
+  defaultBasemap: {},
+  defaultExtent: {
+    type: "extent",
+    xmin: -8589300.590116454,
+    ymin: 4692777.971239516,
+    xmax: -8562027.314872108,
+    ymax: 4722244.554454538,
+    spatialReference: {
+      wkid: 102100
+    }
+  },
+  defaultUserCreditAssignment: 100,
+  defaultVectorBasemap: {
+    baseMapLayers: [],
+    title: "Topographic"
+  },
+  description: "We're the DC R&D Center",
+  eueiEnabled: false,
+  featuredGroups: [],
+  featuredGroupsId: "",
+  featuredItemsGroupQuery: "",
+  galleryTemplatesGroupQuery: 'title:"Gallery Templates" AND owner:esri_en',
+  hasCategorySchema: false,
+  helpBase: "http://docdev.arcgis.com/en/arcgis-online/",
+  helpMap: {},
+  helperServices: {},
+  homePageFeaturedContent: "",
+  homePageFeaturedContentCount: 12,
+  id: "LjjARY1mkhxulWPq",
+  isPortal: false,
+  layerTemplatesGroupQuery: 'title:"Esri Layer Templates" AND owner:esri_en',
+  livingAtlasGroupQuery: 'title:"Featured Maps And Apps" AND owner:esri',
+  maxTokenExpirationMinutes: -1,
+  metadataEditable: true,
+  metadataFormats: ["iso19139"],
+  modified: 1511894763000,
+  name: "Washington, DC",
+  notificationsEnabled: false,
+  portalHostname: "devext.arcgis.com",
+  portalMode: "multitenant",
+  portalName: "ArcGIS Online",
+  portalProperties: {},
+  portalThumbnail: null,
+  region: "WO",
+  rotatorPanels: [
+    {
+      id: "banner-2",
+      innerHTML:
+        "<img src='images/banner-2.jpg' style='-webkit-border-radius:0 0 10px 10px; -moz-border-radius:0 0 10px 10px; -o-border-radius:0 0 10px 10px; border-radius:0 0 10px 10px; margin-top:0; width:960px; height:180px;'/><div style='position:absolute; bottom:80px; left:80px; max-height:65px; width:660px; margin:0;'><img src='http://dc.mapsdevext.arcgis.com/sharing/rest/portals/self/resources/thumbnail.png?token=SECURITY_TOKEN' alt='Washington, DC'  class='esriFloatLeading esriTrailingMargin025' style='margin-bottom:0; max-height:100px;'/><span style='position:absolute; bottom:0; margin-bottom:0; line-height:normal; font-family:HelveticaNeue,Verdana; font-weight:600; font-size:32px; color:#369;'>Washington, DC</span></div>"
+    }
+  ],
+  showHomePageDescription: false,
+  staticImagesUrl: "http://static.arcgis.com/images",
+  storageQuota: 2199023255552,
+  storageUsage: 17622609523,
+  stylesGroupQuery: 'title:"Esri Styles" AND owner:esri_en',
+  supportsHostedServices: true,
+  symbolSetsGroupQuery: 'title:"Esri Symbols" AND owner:esri_en',
+  templatesGroupQuery: "id:f233da8d297e4ff9ae992c21f8f4010f",
+  thumbnail: "thumbnail.png",
+  units: "english",
+  updateUserProfileDisabled: false,
+  urlKey: "dc",
+  useStandardizedQuery: true,
+  useVectorBasemaps: false,
+  vectorBasemapGalleryGroupQuery:
+    'title:"ArcGIS Online Vector Basemaps" AND owner:esri_en',
+  subscriptionInfo: {},
+  isHubEnabled: false,
+  ipCntryCode: "US",
+  httpPort: 80,
+  httpsPort: 443,
+  supportsOAuth: true,
+  currentVersion: "5.4",
+  allowedOrigins: [],
+  mfaAdmins: [],
+  contacts: ["dcadmin"],
+  mfaEnabled: false,
+  user: {},
+  appInfo: {}
+};

package/packages/arcgis-rest-request/test/mocks/sharing-rest-info.ts

@@ -0,0 +1,41 @@
+/* Copyright (c) 2018 Environmental Systems Research Institute, Inc.
+ * Apache-2.0 */
+
+export const SharingRestInfo = {
+  owningSystemUrl: "http://www.arcgis.com",
+  authInfo: {
+    tokenServicesUrl: "https://www.arcgis.com/sharing/rest/generateToken",
+    isTokenBasedSecurity: true
+  }
+};
+
+export const SharingRestInfoHTML = `<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/strict.dtd">
+
+
+
+
+
+
+<html>
+<head>
+<title>ArcGIS Portal Directory</title>
+<link href="/sharing/rest/files/gw.css" rel="stylesheet" type="text/css"/>
+</head>
+<body>
+<br/>
+<div class="gwDiv">
+<table class="navTable" width="100%"><tr><td class="breadcrumbs">ArcGIS Portal Directory</td></tr></table>
+<tr valign="top">
+<br/><br/>
+<b>
+<a href="http://resources.arcgis.com/en/help/arcgis-rest-api/" >API Reference</a>
+</b>
+
+</tr>
+</table>
+
+</div>
+
+</body>
+
+</html>`;

package/packages/arcgis-rest-request/test/mocks/webmap.ts

@@ -0,0 +1,41 @@
+/* Copyright (c) 2018 Environmental Systems Research Institute, Inc.
+ * Apache-2.0 */
+
+export const WebMapAsText =
+  '{"operationalLayers":[{"id":"Alternative_Fueling_Stations_3694","layerType":"ArcGISFeatureLayer","url":"http://services.arcgis.com/rOo16HdIMeOBI4Mb/arcgis/rest/services/Alternative_Fueling_Stations/FeatureServer/0","visibility":true,"opacity":1,"title":"Alternative Fueling Stations","itemId":"44612e6217d34f40b1ce2a48f367e90a","layerDefinition":{"minScale":2896791,"maxScale":0}}],"baseMap":{"baseMapLayers":[{"id":"VectorTile_4047","type":"VectorTileLayer","layerType":"VectorTileLayer","title":"Dark Gray Canvas","styleUrl":"http://www.arcgis.com/sharing/rest/content/items/5ad3948260a147a993ef4865e3fad476/resources/styles/root.json","itemId":"5ad3948260a147a993ef4865e3fad476","visibility":true,"opacity":1}],"title":"Basemap"},"spatialReference":{"wkid":102100,"latestWkid":3857},"authoringApp":"WebMapViewer","authoringAppVersion":"5.1","version":"2.8"}';
+
+export const WebMapAsJSON = {
+  operationalLayers: [
+    {
+      id: "Alternative_Fueling_Stations_3694",
+      layerType: "ArcGISFeatureLayer",
+      url:
+        "http://services.arcgis.com/rOo16HdIMeOBI4Mb/arcgis/rest/services/Alternative_Fueling_Stations/FeatureServer/0",
+      visibility: true,
+      opacity: 1,
+      title: "Alternative Fueling Stations",
+      itemId: "44612e6217d34f40b1ce2a48f367e90a",
+      layerDefinition: { minScale: 2896791, maxScale: 0 }
+    }
+  ],
+  baseMap: {
+    baseMapLayers: [
+      {
+        id: "VectorTile_4047",
+        type: "VectorTileLayer",
+        layerType: "VectorTileLayer",
+        title: "Dark Gray Canvas",
+        styleUrl:
+          "http://www.arcgis.com/sharing/rest/content/items/5ad3948260a147a993ef4865e3fad476/resources/styles/root.json",
+        itemId: "5ad3948260a147a993ef4865e3fad476",
+        visibility: true,
+        opacity: 1
+      }
+    ],
+    title: "Basemap"
+  },
+  spatialReference: { wkid: 102100, latestWkid: 3857 },
+  authoringApp: "WebMapViewer",
+  authoringAppVersion: "5.1",
+  version: "2.8"
+};

package/packages/arcgis-rest-request/test/request.test.ts

@@ -0,0 +1,299 @@
+/* Copyright (c) 2018 Environmental Systems Research Institute, Inc.
+ * Apache-2.0 */
+
+import { request, ErrorTypes } from "../src/index";
+import * as fetchMock from "fetch-mock";
+import {
+  SharingRestInfo,
+  SharingRestInfoHTML
+} from "./mocks/sharing-rest-info";
+import { ArcGISOnlineError } from "./mocks/errors";
+import { WebMapAsText, WebMapAsJSON } from "./mocks/webmap";
+import { GeoJSONFeatureCollection } from "./mocks/geojson-feature-collection";
+
+describe("request()", () => {
+  afterEach(fetchMock.restore);
+
+  it("should make a basic POST request", done => {
+    fetchMock.once("*", SharingRestInfo);
+
+    request("https://www.arcgis.com/sharing/rest/info")
+      .then(response => {
+        const [url, options]: [string, RequestInit] = fetchMock.lastCall("*");
+        expect(url).toEqual("https://www.arcgis.com/sharing/rest/info");
+        expect(options.method).toBe("POST");
+        expect(response).toEqual(SharingRestInfo);
+        expect(options.body).toContain("f=json");
+        done();
+      })
+      .catch(e => {
+        fail(e);
+      });
+  });
+
+  it("should make a basic GET request", done => {
+    fetchMock.once("*", SharingRestInfo);
+
+    request("https://www.arcgis.com/sharing/rest/info", {
+      httpMethod: "GET"
+    })
+      .then(response => {
+        const [url, options]: [string, RequestInit] = fetchMock.lastCall("*");
+        expect(url).toEqual("https://www.arcgis.com/sharing/rest/info?f=json");
+        expect(options.method).toBe("GET");
+        expect(response).toEqual(SharingRestInfo);
+        done();
+      })
+      .catch(e => {
+        fail(e);
+      });
+  });
+
+  it("should make a basic GET request for text", done => {
+    fetchMock.once("*", WebMapAsText);
+
+    request(
+      "https://www.arcgis.com/sharing/rest/content/items/43a8e51789044d9480a20089a84129ad/data",
+      {
+        httpMethod: "GET",
+        params: { f: "text" }
+      }
+    )
+      .then(response => {
+        const [url, options]: [string, RequestInit] = fetchMock.lastCall("*");
+        expect(url).toEqual(
+          "https://www.arcgis.com/sharing/rest/content/items/43a8e51789044d9480a20089a84129ad/data?f=text"
+        );
+        expect(options.method).toBe("GET");
+        expect(response).toEqual(WebMapAsText);
+        done();
+      })
+      .catch(e => {
+        fail(e);
+      });
+  });
+
+  it("should make a basic GET request for html", done => {
+    fetchMock.once("*", SharingRestInfoHTML);
+
+    request("https://www.arcgis.com/sharing/rest/info", {
+      httpMethod: "GET",
+      params: { f: "html" }
+    })
+      .then(response => {
+        const [url, options]: [string, RequestInit] = fetchMock.lastCall("*");
+        expect(url).toEqual("https://www.arcgis.com/sharing/rest/info?f=html");
+        expect(options.method).toBe("GET");
+        expect(response).toEqual(SharingRestInfoHTML);
+        done();
+      })
+      .catch(e => {
+        fail(e);
+      });
+  });
+
+  it("should make a basic GET request for geojson", done => {
+    fetchMock.once("*", GeoJSONFeatureCollection);
+
+    request(
+      "https://services1.arcgis.com/ORG/arcgis/rest/services/FEATURE_SERVICE/FeatureServer/0/query",
+      {
+        httpMethod: "GET",
+        params: { where: "1=1", f: "geojson" }
+      }
+    )
+      .then(response => {
+        const [url, options]: [string, RequestInit] = fetchMock.lastCall("*");
+        expect(url).toEqual(
+          "https://services1.arcgis.com/ORG/arcgis/rest/services/FEATURE_SERVICE/FeatureServer/0/query?f=geojson&where=1%3D1"
+        );
+        expect(options.method).toBe("GET");
+        expect(response).toEqual(GeoJSONFeatureCollection);
+        done();
+      })
+      .catch(e => {
+        fail(e);
+      });
+  });
+
+  it("should switch from GET to POST when url is longer than specified", done => {
+    fetchMock.once("*", SharingRestInfo);
+    const restInfoUrl = "https://www.arcgis.com/sharing/rest/info";
+
+    request(restInfoUrl, {
+      httpMethod: "GET",
+      // typically consumers would base maxUrlLength on browser/server limits
+      // but for testing, we use an artificially low limit
+      // like this one that assumes no parameters will be added
+      maxUrlLength: restInfoUrl.length
+    })
+      .then(response => {
+        const [url, options]: [string, RequestInit] = fetchMock.lastCall("*");
+        expect(url).toEqual("https://www.arcgis.com/sharing/rest/info");
+        expect(options.method).toBe("POST");
+        expect(options.body).toContain("f=json");
+        expect(response).toEqual(SharingRestInfo);
+        done();
+      })
+      .catch(e => {
+        fail(e);
+      });
+  });
+
+  it("should use the `authentication` option to authenticate a request", done => {
+    fetchMock.once("*", WebMapAsText);
+
+    const MOCK_AUTH = {
+      portal: "https://www.arcgis.com/sharing/rest",
+      getToken() {
+        return Promise.resolve("token");
+      }
+    };
+
+    request(
+      "https://www.arcgis.com/sharing/rest/content/items/43a8e51789044d9480a20089a84129ad/data",
+      {
+        authentication: MOCK_AUTH
+      }
+    )
+      .then(response => {
+        const [url, options]: [string, RequestInit] = fetchMock.lastCall("*");
+        expect(url).toEqual(
+          "https://www.arcgis.com/sharing/rest/content/items/43a8e51789044d9480a20089a84129ad/data"
+        );
+        expect(options.body).toContain("token=token");
+        expect(response).toEqual(WebMapAsJSON);
+        done();
+      })
+      .catch(e => {
+        fail(e);
+      });
+  });
+
+  it("should re-throw HTTP errors (404, 500, etc)", done => {
+    fetchMock.once("*", 404);
+
+    request(
+      "https://www.arcgis.com/sharing/rest/content/items/43a8e51789044d9480a20089a84129ad/data"
+    ).catch(error => {
+      expect(error.name).toBe(ErrorTypes.ArcGISRequestError);
+      expect(error.message).toBe("HTTP 404: Not Found");
+      expect(error instanceof Error).toBeTruthy();
+      expect(error.url).toBe(
+        "https://www.arcgis.com/sharing/rest/content/items/43a8e51789044d9480a20089a84129ad/data"
+      );
+      expect(error.options.params).toEqual({ f: "json" });
+      expect(error.options.httpMethod).toEqual("POST");
+      expect(typeof error.options.fetch).toEqual("function");
+      expect(error.options.fetch.length).toEqual(2);
+      done();
+    });
+  });
+
+  it("should throw errors with information about the request", done => {
+    fetchMock.once("*", ArcGISOnlineError);
+
+    request(
+      "https://www.arcgis.com/sharing/rest/content/items/43a8e51789044d9480a20089a84129ad/data"
+    ).catch(error => {
+      expect(error.name).toBe(ErrorTypes.ArcGISRequestError);
+      expect(error.message).toBe("400: 'type' and 'title' property required.");
+      expect(error instanceof Error).toBeTruthy();
+      expect(error.url).toBe(
+        "https://www.arcgis.com/sharing/rest/content/items/43a8e51789044d9480a20089a84129ad/data"
+      );
+      expect(error.options.params).toEqual({ f: "json" });
+      expect(error.options.httpMethod).toEqual("POST");
+      expect(typeof error.options.fetch).toEqual("function");
+      expect(error.options.fetch.length).toEqual(2);
+      done();
+    });
+  });
+
+  it("should allow you to use custom implementations of `fetch`", done => {
+    const MockFetchResponse = {
+      ok: true,
+      json() {
+        return Promise.resolve(SharingRestInfo);
+      },
+      blob() {
+        return Promise.resolve(new Blob([JSON.stringify(SharingRestInfo)]));
+      },
+      text() {
+        return Promise.resolve(JSON.stringify(SharingRestInfo));
+      }
+    };
+
+    const MockFetch = function() {
+      return Promise.resolve(MockFetchResponse);
+    };
+
+    request("https://www.arcgis.com/sharing/rest/info", {
+      fetch: MockFetch as any
+    })
+      .then(response => {
+        expect(response).toEqual(SharingRestInfo);
+        done();
+      })
+      .catch(e => {
+        fail(e);
+      });
+  });
+
+  describe("should throw errors when required dependencies are missing", () => {
+    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 throw for missing dependencies", () => {
+      expect(() => {
+        request("https://www.arcgis.com/sharing/rest/info").catch();
+      }).toThrowError(
+        "`arcgis-rest-request` requires global variables for `fetch`, `Promise` and `FormData` to be present in the global scope. You are missing `fetch`, `Promise`, `FormData`. We recommend installing the `isomorphic-fetch`, `es6-promise`, `isomorphic-form-data` modules at the root of your application to add these to the global scope. See https://bit.ly/2KNwWaJ for more info."
+      );
+    });
+
+    it("should not throw if fetch is not present but a custom fetch is defined", done => {
+      Promise = oldPromise;
+      FormData = oldFormData;
+
+      const MockFetchResponse = {
+        ok: true,
+        json() {
+          return Promise.resolve(SharingRestInfo);
+        },
+        blob() {
+          return Promise.resolve(new Blob([JSON.stringify(SharingRestInfo)]));
+        },
+        text() {
+          return Promise.resolve(JSON.stringify(SharingRestInfo));
+        }
+      };
+
+      const MockFetch = function() {
+        return Promise.resolve(MockFetchResponse);
+      };
+
+      request("https://www.arcgis.com/sharing/rest/info", {
+        fetch: MockFetch as any
+      })
+        .then(response => {
+          expect(response).toEqual(SharingRestInfo);
+          done();
+        })
+        .catch(e => {
+          fail(e);
+        });
+    });
+  });
+});