aspernaturalias 1.0.0

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

@@ -0,0 +1,51 @@
+/* Copyright (c) 2018 Environmental Systems Research Institute, Inc.
+ * Apache-2.0 */
+
+import { ArcGISRequestError } from "../../src/index";
+import { ArcGISOnlineError } from "./../mocks/errors";
+
+describe("ArcGISRequestError", () => {
+  it("should be an instanceof Error", () => {
+    expect(new ArcGISRequestError() instanceof Error).toBe(true);
+  });
+
+  it("should expose basic error properties", () => {
+    const error = new ArcGISRequestError(
+      ArcGISOnlineError.error.message,
+      ArcGISOnlineError.error.code,
+      ArcGISOnlineError,
+      "https://example.com",
+      {
+        params: {
+          f: "json"
+        },
+        httpMethod: "POST"
+      }
+    );
+
+    expect(error.name).toBe("ArcGISRequestError");
+    expect(error.message).toBe("400: 'type' and 'title' property required.");
+    expect(error.code).toBe(400);
+    expect(error.originalMessage).toBe("'type' and 'title' property required.");
+    expect(error.response).toEqual(ArcGISOnlineError);
+    expect(error.url).toBe("https://example.com");
+    expect(error.options.params).toEqual({ f: "json" });
+    expect(error.options.httpMethod).toEqual("POST");
+  });
+
+  it("should still format without a message, code or response", () => {
+    const error = new ArcGISRequestError();
+    expect(error.message).toBe("UNKNOWN_ERROR");
+    expect(error.code).toEqual("UNKNOWN_ERROR_CODE");
+    expect(error.originalMessage).toBe("UNKNOWN_ERROR");
+    expect(error.response).toEqual(undefined);
+  });
+
+  it("should still format with a null or empty string message or code", () => {
+    const error = new ArcGISRequestError(null, "");
+    expect(error.message).toBe("UNKNOWN_ERROR");
+    expect(error.code).toEqual("UNKNOWN_ERROR_CODE");
+    expect(error.originalMessage).toBe("UNKNOWN_ERROR");
+    expect(error.response).toEqual(undefined);
+  });
+});

package/packages/arcgis-rest-request/test/utils/check-for-errors.test.ts

@@ -0,0 +1,111 @@
+/* Copyright (c) 2018 Environmental Systems Research Institute, Inc.
+ * Apache-2.0 */
+
+import {
+  checkForErrors,
+  warn,
+  ArcGISRequestError,
+  ArcGISAuthError
+} from "../../src/index";
+import { SharingRestInfo } from "./../mocks/sharing-rest-info";
+import {
+  ArcGISOnlineError,
+  BillingError,
+  TaskErrorWithJSON,
+  TaskError,
+  ArcGISOnlineErrorNoMessageCode,
+  ArcGISOnlineErrorNoCode,
+  ArcGISServerTokenRequired,
+  ArcGISOnlineAuthError,
+  BillingErrorWithCode200
+} from "./../mocks/errors";
+
+describe("checkForErrors", () => {
+  it("should pass if an error is not found", () => {
+    expect(checkForErrors(SharingRestInfo)).toBe(SharingRestInfo);
+  });
+
+  it("should throw an ArcGISRequestError for an error from the ArcGIS REST API", () => {
+    expect(() => {
+      checkForErrors(ArcGISOnlineError);
+    }).toThrowError(
+      ArcGISRequestError,
+      "400: 'type' and 'title' property required."
+    );
+  });
+
+  it("should throw an ArcGISOnlineAuthError for an error from the ArcGIS REST API", () => {
+    expect(() => {
+      checkForErrors(ArcGISOnlineAuthError);
+    }).toThrowError(ArcGISAuthError, "498: Invalid token.");
+  });
+
+  it("should throw an ArcGISRequestError for an error from the ArcGIS REST API that has no messageCode", () => {
+    expect(() => {
+      checkForErrors(ArcGISOnlineErrorNoMessageCode);
+    }).toThrowError(
+      ArcGISRequestError,
+      "403: You do not have permissions to access this resource or perform this operation."
+    );
+  });
+
+  it("should throw an ArcGISRequestError for an error from the ArcGIS REST API that has no code", () => {
+    expect(() => {
+      checkForErrors(ArcGISOnlineErrorNoCode);
+    }).toThrowError(
+      ArcGISRequestError,
+      "You do not have permissions to access this resource or perform this operation."
+    );
+  });
+
+  it("should throw an ArcGISRequestError for an error from the ArcGIS Online Billing Backend", () => {
+    expect(() => {
+      checkForErrors(BillingError);
+    }).toThrowError(ArcGISRequestError, "500: Error getting subscription info");
+  });
+
+  it("should throw an ArcGISRequestError for an error from the ArcGIS Online Billing Backend with a failure status", () => {
+    expect(() => {
+      checkForErrors(BillingErrorWithCode200);
+    }).toThrowError(ArcGISRequestError, "UNKNOWN_ERROR");
+  });
+
+  it("should throw an ArcGISRequestError for an error when checking long running tasks in ArcGIS REST API", () => {
+    expect(() => {
+      checkForErrors(TaskErrorWithJSON);
+    }).toThrowError(
+      ArcGISRequestError,
+      "400: Index was outside the bounds of the array."
+    );
+  });
+
+  it("should throw an ArcGISRequestError for an error when checking long running tasks in ArcGIS REST API without a JSON statusMessage", () => {
+    expect(() => {
+      checkForErrors(TaskError);
+    }).toThrowError(ArcGISRequestError, "failed");
+  });
+
+  it("should throw an ArcGISAuthError instead of ArcGISRequestError for messageCode=GWM_0003", () => {
+    expect(() => {
+      checkForErrors(ArcGISServerTokenRequired);
+    }).toThrowError(ArcGISAuthError, "GWM_0003: Token Required");
+  });
+});
+
+describe("warn", () => {
+  it("should bubble up deprecation warnings", () => {
+    console.warn = jasmine.createSpy("warning");
+    warn("Danger Will Robinson!");
+    expect(console.warn).toHaveBeenCalledWith("Danger Will Robinson!");
+  });
+});
+
+describe("warn", () => {
+  it("should carry on gracefully when no console is available", () => {
+    const realConsoleWarn = console.warn;
+    console.warn = undefined;
+    warn("Danger Will Robinson!");
+    expect(console.warn).toBe(undefined);
+    console.warn = realConsoleWarn;
+  });
+});

package/packages/arcgis-rest-request/test/utils/clean-url.test.ts

@@ -0,0 +1,47 @@
+/* Copyright (c) 2018 Environmental Systems Research Institute, Inc.
+ * Apache-2.0 */
+
+import { cleanUrl } from "../../src/utils/clean-url";
+
+const validUrl =
+  "https://server.com/arcgis/rest/services/Custom Space/MapServer";
+
+describe("cleanUrl", () => {
+  it("should not mangle a valid url", () => {
+    expect(
+      cleanUrl(
+        "https://server.com/arcgis/rest/services/Custom Space/MapServer/"
+      )
+    ).toEqual(validUrl);
+  });
+
+  it("should add a trailing slash", () => {
+    expect(
+      cleanUrl("https://server.com/arcgis/rest/services/Custom Space/MapServer")
+    ).toEqual(validUrl);
+  });
+
+  it("should remove leading whitespace", () => {
+    expect(
+      cleanUrl(
+        "  https://server.com/arcgis/rest/services/Custom Space/MapServer/"
+      )
+    ).toEqual(validUrl);
+  });
+
+  it("should remove trailing whitespace", () => {
+    expect(
+      cleanUrl(
+        "https://server.com/arcgis/rest/services/Custom Space/MapServer/   "
+      )
+    ).toEqual(validUrl);
+  });
+
+  it("should do it all at once", () => {
+    expect(
+      cleanUrl(
+        "  https://server.com/arcgis/rest/services/Custom Space/MapServer       "
+      )
+    ).toEqual(validUrl);
+  });
+});

package/packages/arcgis-rest-request/test/utils/encode-form-data.test.ts

@@ -0,0 +1,133 @@
+/* Copyright (c) 2018 Environmental Systems Research Institute, Inc.
+ * Apache-2.0 */
+
+import { encodeFormData } from "../../src/utils/encode-form-data";
+import {
+  requiresFormData,
+  processParams
+} from "../../src/utils/process-params";
+import { attachmentFile } from "../../../arcgis-rest-feature-layer/test/attachments.test";
+
+describe("encodeFormData", () => {
+  it("should encode in form data for multipart file requests", () => {
+    const binaryObj = attachmentFile();
+
+    const formData = encodeFormData({ binary: binaryObj });
+    expect(formData instanceof FormData).toBeTruthy();
+
+    const data = formData as FormData;
+    if (data.get) {
+      expect(data.get("binary") instanceof File).toBeTruthy();
+      expect((data.get("binary") as File).name).toBe("foo.txt");
+    }
+  });
+
+  it("should encode in form data for multipart blob requests", () => {
+    const binaryObj =
+      typeof Blob !== "undefined"
+        ? new Blob([], {
+            type: "text/plain"
+          })
+        : Buffer.from("");
+
+    const formData = encodeFormData({ binary: binaryObj });
+    expect(formData instanceof FormData).toBeTruthy();
+
+    const data = formData as FormData;
+    if (data.get) {
+      expect(data.get("binary") instanceof File).toBeTruthy();
+      expect((data.get("binary") as File).name).toBe("binary");
+    }
+  });
+
+  it("should encode as query string for basic types", () => {
+    const dateValue = 1471417200000;
+
+    // null, undefined, function are excluded. If you want to send an empty key you need to send an empty string "".
+    // See https://github.com/Esri/arcgis-rest-js/issues/18
+    const params = {
+      myArray1: new Array(8),
+      myArray2: [1, 2, 4, 16],
+      myArray3: [{ a: 1, b: 2 }, { c: "abc" }],
+      myDate: new Date(dateValue),
+      myFunction: () => {
+        return 3.1415;
+      },
+      myBoolean: true,
+      myString: "Hello, world!",
+      myEmptyString: "",
+      myNumber: 380
+    };
+
+    expect(requiresFormData(params)).toBeFalsy();
+
+    const formData = processParams(params);
+    expect(typeof formData).toBe("object");
+    expect(formData.myArray1).toBe(",,,,,,,");
+    expect(formData.myArray2).toBe("1,2,4,16");
+    expect(formData.myArray3).toBe('[{"a":1,"b":2},{"c":"abc"}]');
+    expect(formData.myDate).toBe(dateValue);
+    expect(formData.myBoolean).toBeTruthy();
+    expect(formData.myString).toBe("Hello, world!");
+    expect(formData.myEmptyString).toBe("");
+    expect(formData.myNumber).toBe(380);
+
+    const encodedFormData = encodeFormData(params);
+    expect(typeof encodedFormData).toBe("string");
+    expect(encodedFormData).toBe(
+      "myArray1=%2C%2C%2C%2C%2C%2C%2C&" +
+        "myArray2=1%2C2%2C4%2C16&" +
+        "myArray3=%5B%7B%22a%22%3A1%2C%22b%22%3A2%7D%2C%7B%22c%22%3A%22abc%22%7D%5D&" +
+        "myDate=1471417200000&" +
+        "myBoolean=true&" +
+        "myString=Hello%2C%20world!&" +
+        "myEmptyString=&" +
+        "myNumber=380"
+    );
+  });
+
+  it("should switch to form data if any item is not a basic type", () => {
+    const dateValue = 1471417200000;
+    const file = attachmentFile();
+    if (!file.name) {
+      // The file's name is used for adding files to a form, so supply a name when we're in a testing
+      // environment that doesn't support File (attachmentFile creates a File with the name "foo.txt"
+      // if File is supported and a file stream otherwise)
+      file.name = "foo.txt";
+    }
+
+    // null, undefined, function are excluded. If you want to send an empty key you need to send an empty string "".
+    // See https://github.com/Esri/arcgis-rest-js/issues/18
+    const params = {
+      myArray1: new Array(8),
+      myArray2: [1, 2, 4, 16],
+      myArray3: [{ a: 1, b: 2 }, { c: "abc" }],
+      myDate: new Date(dateValue),
+      myFunction: () => {
+        return 3.1415;
+      },
+      myBoolean: true,
+      myString: "Hello, world!",
+      myEmptyString: "",
+      myNumber: 380,
+      file
+    };
+
+    expect(requiresFormData(params)).toBeTruthy();
+
+    const formData = processParams(params);
+    expect(typeof formData).toBe("object");
+    expect(formData.myArray1).toBe(",,,,,,,");
+    expect(formData.myArray2).toBe("1,2,4,16");
+    expect(formData.myArray3).toBe('[{"a":1,"b":2},{"c":"abc"}]');
+    expect(formData.myDate).toBe(dateValue);
+    expect(formData.myBoolean).toBeTruthy();
+    expect(formData.myString).toBe("Hello, world!");
+    expect(formData.myEmptyString).toBe("");
+    expect(formData.myNumber).toBe(380);
+    expect(typeof formData.file).toBe("object");
+
+    const encodedFormData = encodeFormData(params);
+    expect(encodedFormData instanceof FormData).toBeTruthy();
+  });
+});

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

@@ -0,0 +1,193 @@
+/* Copyright (c) 2018-2019 Environmental Systems Research Institute, Inc.
+ * Apache-2.0 */
+
+import { processParams, requiresFormData } from "../../src/index";
+
+describe("processParams", () => {
+  it("should pass non Date, Function, Array and Object params through", () => {
+    const params = {
+      foo: "foo",
+      bar: 1
+    };
+
+    const expected = {
+      foo: "foo",
+      bar: 1
+    };
+    expect(processParams(params)).toEqual(expected);
+  });
+
+  it("should encode Dates as timestamps", () => {
+    const date = new Date();
+
+    const params = {
+      foo: date
+    };
+
+    const expected = {
+      foo: date.getTime()
+    };
+    expect(processParams(params)).toEqual(expected);
+  });
+
+  it("should not encode a function", () => {
+    const params = {
+      foo() {} // tslint:disable-line no-empty
+    };
+
+    expect(processParams(params)).toEqual({});
+  });
+
+  it("should stringify objects", () => {
+    const params = {
+      foo: {
+        bar: "bar"
+      }
+    };
+
+    const expected = {
+      foo: '{"bar":"bar"}'
+    };
+
+    expect(processParams(params)).toEqual(expected);
+  });
+
+  it("should stringify arrays of objects", () => {
+    const params = {
+      foo: [
+        {
+          bar: "bar"
+        }
+      ]
+    };
+
+    const expected = {
+      foo: '[{"bar":"bar"}]'
+    };
+
+    expect(processParams(params)).toEqual(expected);
+  });
+
+  it("should comma seperate arrays of non objects", () => {
+    const params = {
+      foo: ["bar", "baz"]
+    };
+
+    const expected = {
+      foo: "bar,baz"
+    };
+
+    expect(processParams(params)).toEqual(expected);
+  });
+
+  it("should stringify booleans", () => {
+    const params = {
+      foo: true,
+      bar: false
+    };
+
+    const expected = {
+      foo: "true",
+      bar: "false"
+    };
+
+    expect(processParams(params)).toEqual(expected);
+  });
+
+  it("should exclude null and undefined, but not a zero", () => {
+    const params: any = {
+      foo: null,
+      bar: undefined,
+      baz: 0
+    };
+
+    const expected = {
+      baz: 0
+    };
+
+    expect(processParams(params)).toEqual(expected);
+  });
+
+  it("should not require form data for simple requests", () => {
+    expect(
+      requiresFormData({
+        string: "string"
+      })
+    ).toBeFalsy();
+
+    expect(
+      requiresFormData({
+        number: 123
+      })
+    ).toBeFalsy();
+
+    expect(
+      requiresFormData({
+        date: new Date()
+      })
+    ).toBeFalsy();
+
+    expect(
+      requiresFormData({
+        boolean: true
+      })
+    ).toBeFalsy();
+
+    expect(
+      requiresFormData({
+        array: []
+      })
+    ).toBeFalsy();
+
+    expect(
+      requiresFormData({
+        object: {}
+      })
+    ).toBeFalsy();
+
+    expect(
+      requiresFormData({
+        fn: () => {
+          return;
+        }
+      })
+    ).toBeFalsy();
+
+    expect(
+      requiresFormData({
+        falsy: null
+      })
+    ).toBeFalsy();
+  });
+
+  it("should require form data for multipart requests", () => {
+    const binaryObj =
+      typeof File !== "undefined"
+        ? new File(["foo"], "foo.txt", {
+            type: "text/plain"
+          })
+        : Buffer.from("");
+
+    expect(
+      requiresFormData({
+        binary: binaryObj
+      })
+    ).toBeTruthy();
+  });
+
+  it("should require form data for mixed multipart requests", () => {
+    const binaryObj =
+      typeof File !== "undefined"
+        ? new File(["foo"], "foo.txt", {
+            type: "text/plain"
+          })
+        : Buffer.from("");
+
+    expect(
+      requiresFormData({
+        string: "string",
+        binary: binaryObj
+      })
+    ).toBeTruthy();
+  });
+});

package/packages/arcgis-rest-request/test/utils/with-options.test.ts

@@ -0,0 +1,133 @@
+/* Copyright (c) 2018 Environmental Systems Research Institute, Inc.
+ * Apache-2.0 */
+
+import { request } from "../../src/request";
+import { IRequestOptions } from "../../src/utils/IRequestOptions";
+import { withOptions } from "../../src/utils/with-options";
+
+import * as fetchMock from "fetch-mock";
+
+const SharingRestInfo = {
+  owningSystemUrl: "http://www.arcgis.com",
+  authInfo: {
+    tokenServicesUrl: "https://www.arcgis.com/sharing/rest/generateToken",
+    isTokenBasedSecurity: true
+  }
+};
+
+describe("withOptions()", () => {
+  afterEach(fetchMock.restore);
+
+  it("should wrap a basic request with default options", done => {
+    fetchMock.once("*", SharingRestInfo);
+    const requestWithOptions = withOptions(
+      {
+        headers: {
+          "Test-Header": "Test"
+        }
+      },
+      request
+    );
+
+    requestWithOptions("https://www.arcgis.com/sharing/rest/info")
+      .then(() => {
+        const [url, options]: [string, RequestInit] = fetchMock.lastCall("*");
+        expect(url).toEqual("https://www.arcgis.com/sharing/rest/info");
+        expect((options.headers as any)["Test-Header"]).toBe("Test");
+        done();
+      })
+      .catch((e: any) => {
+        fail(e);
+      });
+  });
+
+  it("should wrap a custom request implementation with default options", done => {
+    const MockResponse = {
+      test: "bar"
+    };
+
+    fetchMock.once("*", MockResponse);
+
+    interface ICustomOptions extends IRequestOptions {
+      id: string;
+    }
+
+    interface ICustomResponse {
+      test: string;
+    }
+
+    function customRequest(options: ICustomOptions): Promise<ICustomResponse> {
+      options.params = {
+        id: options.id
+      };
+      return request("https://www.arcgis.com/sharing/rest/info", options);
+    }
+
+    const requestWithOptions = withOptions(
+      {
+        headers: {
+          "Test-Header": "Test"
+        }
+      },
+      customRequest
+    );
+
+    requestWithOptions({
+      id: "foo"
+    })
+      .then(() => {
+        const [url, options]: [string, RequestInit] = fetchMock.lastCall("*");
+        expect(url).toEqual("https://www.arcgis.com/sharing/rest/info");
+        expect(options.body).toContain("id=foo");
+        expect((options.headers as any)["Test-Header"]).toBe("Test");
+        done();
+      })
+      .catch((e: any) => {
+        fail(e);
+      });
+  });
+
+  it("should wrap a custom request implementation with multiple parameters with a default URL", done => {
+    const MockResponse = {
+      test: "bar"
+    };
+
+    fetchMock.once("*", MockResponse);
+
+    interface ICustomResponse {
+      test: string;
+    }
+
+    function customRequest(
+      id: string,
+      options: IRequestOptions = {}
+    ): Promise<ICustomResponse> {
+      options = {
+        ...options,
+        ...{ params: { ...options.params, ...{ id } } }
+      };
+      return request("https://www.arcgis.com/sharing/rest/info", options);
+    }
+
+    const requestWithOptions = withOptions(
+      {
+        headers: {
+          "Test-Header": "Test"
+        }
+      },
+      customRequest
+    );
+
+    requestWithOptions("foo")
+      .then(() => {
+        const [url, options]: [string, RequestInit] = fetchMock.lastCall("*");
+        expect(url).toEqual("https://www.arcgis.com/sharing/rest/info");
+        expect(options.body).toContain("id=foo");
+        expect((options.headers as any)["Test-Header"]).toBe("Test");
+        done();
+      })
+      .catch((e: any) => {
+        fail(e);
+      });
+  });
+});

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

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