autnam 1.0.0

package/packages/arcgis-rest-geocoding/test/reverse.test.ts

@@ -0,0 +1,124 @@
+/* Copyright (c) 2018 Environmental Systems Research Institute, Inc.
+ * Apache-2.0 */
+
+import fetchMock from "fetch-mock";
+import { reverseGeocode } from "../src/reverse.js";
+import { ReverseGeocode } from "./mocks/responses.js";
+
+describe("geocode", () => {
+  afterEach(fetchMock.restore);
+
+  it("should make a reverse geocoding request", (done) => {
+    fetchMock.once("*", ReverseGeocode);
+
+    reverseGeocode({ x: -118.409, y: 33.9425 })
+      .then((response) => {
+        expect(fetchMock.called()).toEqual(true);
+        const [url, options]: [string, RequestInit] = fetchMock.lastCall("*");
+        expect(url).toEqual(
+          "https://geocode-api.arcgis.com/arcgis/rest/services/World/GeocodeServer/reverseGeocode"
+        );
+        expect(options.method).toBe("POST");
+        expect(options.body).toContain("f=json");
+        expect(options.body).toContain(
+          `location=${encodeURIComponent('{"x":-118.409,"y":33.9425}')}`
+        );
+        expect(response).toEqual(ReverseGeocode); // introspect the entire response
+        done();
+      })
+      .catch((e) => {
+        fail(e);
+      });
+  });
+
+  it("should make a reverse geocoding GET request and pass through a spatial reference", (done) => {
+    fetchMock.once("*", ReverseGeocode);
+
+    reverseGeocode(
+      { x: -118.409, y: 33.9425, spatialReference: { wkid: 4326 } },
+      { httpMethod: "GET" }
+    )
+      .then((response) => {
+        expect(fetchMock.called()).toEqual(true);
+        const [url, options]: [string, RequestInit] = fetchMock.lastCall("*");
+        expect(url).toEqual(
+          "https://geocode-api.arcgis.com/arcgis/rest/services/World/GeocodeServer/reverseGeocode?f=json&location=%7B%22x%22%3A-118.409%2C%22y%22%3A33.9425%2C%22spatialReference%22%3A%7B%22wkid%22%3A4326%7D%7D"
+        );
+        expect(options.method).toBe("GET");
+        expect(response).toEqual(ReverseGeocode); // this introspects the entire response
+        done();
+      })
+      .catch((e) => {
+        fail(e);
+      });
+  });
+
+  it("should make a reverse geocoding request and translate lat/long JSON objects", (done) => {
+    fetchMock.once("*", ReverseGeocode);
+
+    reverseGeocode({ longitude: -118.409, latitude: 33.9425 })
+      .then((response) => {
+        expect(fetchMock.called()).toEqual(true);
+        const [url, options]: [string, RequestInit] = fetchMock.lastCall("*");
+        expect(url).toEqual(
+          "https://geocode-api.arcgis.com/arcgis/rest/services/World/GeocodeServer/reverseGeocode"
+        );
+        expect(options.method).toBe("POST");
+        expect(options.body).toContain("f=json");
+        expect(options.body).toContain(
+          `location=${encodeURIComponent("-118.409,33.9425")}`
+        );
+        expect(response).toEqual(ReverseGeocode); // this introspects the entire response
+        done();
+      })
+      .catch((e) => {
+        fail(e);
+      });
+  });
+
+  it("should make a reverse geocoding request and translate lat/long JSON abbreviated objects", (done) => {
+    fetchMock.once("*", ReverseGeocode);
+
+    reverseGeocode({ lat: 33.9425, long: -118.409 })
+      .then((response) => {
+        expect(fetchMock.called()).toEqual(true);
+        const [url, options]: [string, RequestInit] = fetchMock.lastCall("*");
+        expect(url).toEqual(
+          "https://geocode-api.arcgis.com/arcgis/rest/services/World/GeocodeServer/reverseGeocode"
+        );
+        expect(options.method).toBe("POST");
+        expect(options.body).toContain("f=json");
+        expect(options.body).toContain(
+          `location=${encodeURIComponent("-118.409,33.9425")}`
+        );
+        expect(response).toEqual(ReverseGeocode); // this introspects the entire response
+        done();
+      })
+      .catch((e) => {
+        fail(e);
+      });
+  });
+
+  it("should make a reverse geocoding request and translate a raw long,lat array", (done) => {
+    fetchMock.once("*", ReverseGeocode);
+
+    reverseGeocode([-118, 34])
+      .then((response) => {
+        expect(fetchMock.called()).toEqual(true);
+        const [url, options]: [string, RequestInit] = fetchMock.lastCall("*");
+        expect(url).toEqual(
+          "https://geocode-api.arcgis.com/arcgis/rest/services/World/GeocodeServer/reverseGeocode"
+        );
+        expect(options.method).toBe("POST");
+        expect(options.body).toContain("f=json");
+        expect(options.body).toContain(
+          `location=${encodeURIComponent("-118,34")}`
+        );
+        expect(response).toEqual(ReverseGeocode); // this introspects the entire response
+        done();
+      })
+      .catch((e) => {
+        fail(e);
+      });
+  });
+});

package/packages/arcgis-rest-geocoding/test/suggest.test.ts

@@ -0,0 +1,53 @@
+/* Copyright (c) 2018 Environmental Systems Research Institute, Inc.
+ * Apache-2.0 */
+
+import fetchMock from "fetch-mock";
+import { suggest } from "../src/suggest.js";
+import { Suggest } from "./mocks/responses.js";
+
+describe("geocode", () => {
+  afterEach(fetchMock.restore);
+
+  it("should make a request for suggestions", (done) => {
+    fetchMock.once("*", Suggest);
+
+    suggest("LAX")
+      .then((response) => {
+        expect(fetchMock.called()).toEqual(true);
+        const [url, options]: [string, RequestInit] = fetchMock.lastCall("*");
+        expect(url).toEqual(
+          "https://geocode-api.arcgis.com/arcgis/rest/services/World/GeocodeServer/suggest"
+        );
+        expect(options.method).toBe("POST");
+        expect(options.body).toContain("f=json");
+        expect(options.body).toContain("text=LAX");
+        expect(response).toEqual(Suggest); // this introspects the entire response
+        done();
+      })
+      .catch((e) => {
+        fail(e);
+      });
+  });
+
+  it("should make a request for suggestions with other parameters", (done) => {
+    fetchMock.once("*", Suggest);
+
+    suggest("LAX", { params: { category: "Address,Postal" } })
+      .then((response) => {
+        expect(fetchMock.called()).toEqual(true);
+        const [url, options]: [string, RequestInit] = fetchMock.lastCall("*");
+        expect(url).toEqual(
+          "https://geocode-api.arcgis.com/arcgis/rest/services/World/GeocodeServer/suggest"
+        );
+        expect(options.method).toBe("POST");
+        expect(options.body).toContain("f=json");
+        expect(options.body).toContain("text=LAX");
+        expect(options.body).toContain("category=Address%2CPostal");
+        expect(response).toEqual(Suggest); // this introspects the entire response
+        done();
+      })
+      .catch((e) => {
+        fail(e);
+      });
+  });
+});

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

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

package/packages/arcgis-rest-portal/CHANGELOG.md

@@ -0,0 +1,73 @@
+# @esri/arcgis-rest-portal 1.0.0-beta.1 (2022-02-17)
+
+
+### Bug Fixes
+
+* switch to eslint, fix minor issues, disable other rules ([ab47412](https://github.com/Esri/arcgis-rest-js/commit/ab474123d3a056dcd52a8898f39f287893626f35))
+* **aggs counts should be array:** aggs counts should be array ([72b3bf7](https://github.com/Esri/arcgis-rest-js/commit/72b3bf74a33d16d89b357556a80eb32d5e70b25b))
+* **arcgis-rest-portal:** add fetchMock setup for intermittent failing tests ([5384984](https://github.com/Esri/arcgis-rest-js/commit/53849842f8a0c6192faa36f5634c171721a45903))
+* **arcgis-rest-portal:** do not do any membership adjustments if the group is the user's favorites g ([6fc8ada](https://github.com/Esri/arcgis-rest-js/commit/6fc8ada666e2ac6388418d3416db13a40c299757))
+* **arcgis-rest-portal:** make \`layers\` parameter of \`IExportParameters\` optional ([0b584e6](https://github.com/Esri/arcgis-rest-js/commit/0b584e66396a9559248e597ec44b256f95fc58e7))
+* **arcgis-rest-portal:** share as admin uses content/users/:ownername/items/:id/share end-point ([fd1a960](https://github.com/Esri/arcgis-rest-js/commit/fd1a960cab22e3c1810dc4760a007d409b7f59f1))
+* **arcgis-rest-portal:** use deleteRelationship not removeRelationship ([890e485](https://github.com/Esri/arcgis-rest-js/commit/890e4859dc45ce1588b5ba3573c881c227267bf9)), closes [#739](https://github.com/Esri/arcgis-rest-js/issues/739)
+* **arcgis-rest-portal:** wrong parameters for file upload APIs ([#761](https://github.com/Esri/arcgis-rest-js/issues/761)) ([cbfef7d](https://github.com/Esri/arcgis-rest-js/commit/cbfef7d6bd669d323dab5299966217a956fc5cfb)), closes [#693](https://github.com/Esri/arcgis-rest-js/issues/693) [#694](https://github.com/Esri/arcgis-rest-js/issues/694) [#700](https://github.com/Esri/arcgis-rest-js/issues/700)
+* **getItemResources:** allow user to override paging ([97cbec0](https://github.com/Esri/arcgis-rest-js/commit/97cbec0b918e0ec914beb60abdb36d1265ce5645))
+* **getItemResources:** do not mutate requestOptions in getItemResources ([cac63e8](https://github.com/Esri/arcgis-rest-js/commit/cac63e8090b81a6fe2258529060bc6f3f0611fb0))
+* **portal:** searchGroupUsers will now respect joined and memberType parameters ([79b15b5](https://github.com/Esri/arcgis-rest-js/commit/79b15b5a00ec3efed2193d3d16f61417bfcc933d))
+* **portal:** setting item access to public shares correctly ([6a2b115](https://github.com/Esri/arcgis-rest-js/commit/6a2b11593643a1c760052d844e6346c4f7345149))
+* **removeItemResource:** support correct parameters ([#835](https://github.com/Esri/arcgis-rest-js/issues/835)) ([96798fe](https://github.com/Esri/arcgis-rest-js/commit/96798fe01a890514eacd268ef8e2f429fda1be4a))
+* **search:** add support for untyped, grouped search strings ([39fc213](https://github.com/Esri/arcgis-rest-js/commit/39fc21379a3e78a27636d62cf46d86e23ad666a0)), closes [#544](https://github.com/Esri/arcgis-rest-js/issues/544)
+* **search:** allow NOT as a standalone modifier ([36a6bca](https://github.com/Esri/arcgis-rest-js/commit/36a6bca771dd4282af71dcf454828f58047b525b)), closes [#542](https://github.com/Esri/arcgis-rest-js/issues/542)
+* **search:** ensure no space is inserted between search fields and terms ([ff90f51](https://github.com/Esri/arcgis-rest-js/commit/ff90f5132b0cfa7bf9f083ee54996dda5412be4e)), closes [#545](https://github.com/Esri/arcgis-rest-js/issues/545)
+* **search:** sortOrder is a valid search param, searchDir is not ([9caeafd](https://github.com/Esri/arcgis-rest-js/commit/9caeafdea4568252b792606dcd485486c4e1f5c8)), closes [#540](https://github.com/Esri/arcgis-rest-js/issues/540)
+* **searchGroupUsers func:** searchOptions is now an optional parameter ([d54bddb](https://github.com/Esri/arcgis-rest-js/commit/d54bddb69f003109aac7a3b27be420b465e4f59f)), closes [#615](https://github.com/Esri/arcgis-rest-js/issues/615)
+* **sharing:** correct the item sharing logic to reflect what the api actually allows ([48b67e5](https://github.com/Esri/arcgis-rest-js/commit/48b67e542ed41dda798ebfd51321d51729af2b5b))
+* **sharing:** only item owner, group owner or group admin can unshare ([d264137](https://github.com/Esri/arcgis-rest-js/commit/d264137cbc51955320c48bad0bd868116832de79))
+* **updateItemResources:** support item resource prefix ([98be7a7](https://github.com/Esri/arcgis-rest-js/commit/98be7a74b8362cb20170c3f62d4a61c842a1f8d5)), closes [#824](https://github.com/Esri/arcgis-rest-js/issues/824)
+* ensure JSON and binary data are both handled consistently ([9f85087](https://github.com/Esri/arcgis-rest-js/commit/9f8508720cf17e94d26a9516a02e761931408043))
+
+
+### Code Refactoring
+
+* **portal interfaces:** renames portal request/response interfaces to match their functions ([faa5b3d](https://github.com/Esri/arcgis-rest-js/commit/faa5b3dd5b51800db4931735f05a367c8fcd42e2))
+* replace items, groups, sharing and user packages with single portal package ([64a3fd9](https://github.com/Esri/arcgis-rest-js/commit/64a3fd9a8a6824d388acb773ca0ffe8900e476f8))
+
+
+### Features
+
+* **search:** allows use of the newly added but undocumented searchUserAccess and searchUserName par ([279ef9e](https://github.com/Esri/arcgis-rest-js/commit/279ef9e2dbee9ada0bb2d319aec027c85886cd0e))
+* service name and service info fns ([bb5f90d](https://github.com/Esri/arcgis-rest-js/commit/bb5f90d3fd0cbe594a687fa4ddcb59863756a8ce))
+* **arcgis-rest-portal:** add getPortalSettings function ([e956dc5](https://github.com/Esri/arcgis-rest-js/commit/e956dc56e2fb925478767d989e4cf42cb8ac1a1c))
+* **arcgis-rest-portal:** add searchUsers function ([235766c](https://github.com/Esri/arcgis-rest-js/commit/235766c7eb7a55276f89e107cee8c4b4f8b64a84))
+* **getItemBaseUrl:** add function to get the base REST API URL for an item ([d6ec9fc](https://github.com/Esri/arcgis-rest-js/commit/d6ec9fcafbdeafc2a33d38787baa3a1d7fb1ec69))
+* **getItemInfo:** add a function to fetch an info file for an item ([a9dd7d6](https://github.com/Esri/arcgis-rest-js/commit/a9dd7d64834424ca348fb92818d616bb74e29a6e)), closes [#738](https://github.com/Esri/arcgis-rest-js/issues/738)
+* **getItemMetadata:** add a function to fetch the metadata XML for an item ([c263e1b](https://github.com/Esri/arcgis-rest-js/commit/c263e1bd7c13cb1ee65e5c23f994650820c023a6))
+* **getJsonResource and scrubControlChars:** add getJsonResource and scrubControlChars ([6bb9215](https://github.com/Esri/arcgis-rest-js/commit/6bb921512eeed9374ab35c03577fd3bfb8ea1e11))
+* add resourcesPrefix parameter to addItemResource ([c368232](https://github.com/Esri/arcgis-rest-js/commit/c3682322f7aca69c0dd3907a603304d232d8b43c))
+* **group:** refactor searchGroups to make use of SearchQueryBuilder ([72f2898](https://github.com/Esri/arcgis-rest-js/commit/72f28985bde12b44cca0180dd52e33f660f2ad9a)), closes [#104](https://github.com/Esri/arcgis-rest-js/issues/104)
+* **portal:** a new function to add members to a given group ([998d3a7](https://github.com/Esri/arcgis-rest-js/commit/998d3a705aac0ebdd59bacdbae2f48924cad86ff)), closes [#584](https://github.com/Esri/arcgis-rest-js/issues/584)
+* **portal:** add reassignItem ([1756cc4](https://github.com/Esri/arcgis-rest-js/commit/1756cc48f43436f3041e44ed14827f415b106a90))
+* **portal:** add the function to get user tags ([#614](https://github.com/Esri/arcgis-rest-js/issues/614)) ([d49159f](https://github.com/Esri/arcgis-rest-js/commit/d49159f91b3236feaf6dfb5df202672faae82797))
+* **portal:** add updateGroupMembership, isItemSharedWithGroup ([14848db](https://github.com/Esri/arcgis-rest-js/commit/14848dbd6034362628ef99c8d57d445c8ed37776))
+* **portal:** searchGroupUsers searches the users in the given group ([d9151a1](https://github.com/Esri/arcgis-rest-js/commit/d9151a15fb34ae0ddc551f350e877ff7dd10405e))
+
+
+### Reverts
+
+* Revert "aggs counts should be an array" ([55a1e27](https://github.com/Esri/arcgis-rest-js/commit/55a1e27c3d84383bceac86442987806249f4a6b3))
+
+
+### BREAKING CHANGES
+
+* deprecated addItemJsonData
+* **portal interfaces:** removes "Request" from portal option interfaces & renames response interfaces
+* **group:** searchGroups signature change
+* replace items, groups, sharing and user packages with single portal package
+
+
+
+
+
+### Dependencies
+
+* **@esri/arcgis-rest-request:** upgraded to 1.0.0-beta.1

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

@@ -0,0 +1,72 @@
+[![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-portal.svg?style=flat-square
+[npm-url]: https://www.npmjs.com/package/@esri/arcgis-rest-portal
+[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-portal/dist/bundled/portal.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-portal
+
+> A module for working with ArcGIS Online and Enterprise content via the REST API that runs in Node.js and modern browsers.
+
+### Example
+
+```bash
+npm install @esri/arcgis-rest-request
+npm install @esri/arcgis-rest-portal
+```
+
+```js
+import { getItem } from "@esri/arcgis-rest-portal";
+
+const itemId = "30e5fe3149c34df1ba922e6f5bbf808f";
+
+getItem(itemId).then((response) => {
+  console.log(response.title); // World Topographic Map
+});
+```
+
+### [API Reference](https://esri.github.io/arcgis-rest-js/api/portal/)
+
+### 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; 2017-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-portal/package.json

@@ -0,0 +1,68 @@
+{
+  "name": "@esri/arcgis-rest-portal",
+  "version": "1.0.0-beta.1",
+  "description": "ArcGIS Online and Enterprise content and user helpers for @esri/arcgis-rest-request",
+  "license": "Apache-2.0",
+  "keywords": [
+    "ES6",
+    "arcgis",
+    "esri",
+    "fetch",
+    "promise",
+    "typescript"
+  ],
+  "type": "module",
+  "main": "dist/cjs/index.js",
+  "module": "dist/esm/index.js",
+  "unpkg": "dist/bundled/request.umd.min.js",
+  "exports": {
+    ".": {
+      "import": "./dist/esm/index.js",
+      "require": "./dist/cjs/index.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "types": "dist/esm/index.d.ts",
+  "sideEffects": false,
+  "files": [
+    "dist/**"
+  ],
+  "scripts": {
+    "build": "npm-run-all --parallel build:*",
+    "postbuild": "node ../../scripts/create-dist-package-jsons.js",
+    "build:bundled": "rollup -c ../../rollup.js",
+    "build:cjs": "tsc --outDir ./dist/cjs -m commonjs",
+    "build:esm": "tsc --outDir ./dist/esm --declaration",
+    "dev": "npm-run-all --parallel dev:*",
+    "dev:bundled": "rollup -w -c ../../rollup.js",
+    "dev:cjs": "tsc -w --outDir ./dist/cjs -m commonjs",
+    "dev:esm": "tsc -w --outDir ./dist/esm --declaration"
+  },
+  "engines": {
+    "node": ">=12.20.0"
+  },
+  "dependencies": {
+    "tslib": "^2.3.0"
+  },
+  "peerDependencies": {
+    "@esri/arcgis-rest-request": "1.0.0-beta.1"
+  },
+  "devDependencies": {
+    "@esri/arcgis-rest-request": "1.0.0-beta.1"
+  },
+  "contributors": [
+    "Dave Bouwman <dbouwman@esri.com> (http://blog.davebouwman.com/)"
+  ],
+  "homepage": "https://github.com/Esri/arcgis-rest-js#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Esri/arcgis-rest-js.git",
+    "directory": "packages/arcgis-rest-portal"
+  },
+  "bugs": {
+    "url": "https://github.com/Esri/arcgis-rest-js/issues"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}

package/packages/arcgis-rest-portal/src/groups/add-users.ts

@@ -0,0 +1,140 @@
+/* Copyright (c) 2017-2018 Environmental Systems Research Institute, Inc.
+ * Apache-2.0 */
+
+import {
+  request,
+  IRequestOptions,
+  ArcGISRequestError
+} from "@esri/arcgis-rest-request";
+
+import { getPortalUrl } from "../util/get-portal-url.js";
+import { chunk } from "../util/array.js";
+
+export interface IAddGroupUsersOptions extends IRequestOptions {
+  /**
+   * Group ID
+   */
+  id: string;
+  /**
+   * An array of usernames to be added to the group as group members
+   */
+  users?: string[];
+  /**
+   * An array of usernames to be added to the group as group admins
+   */
+  admins?: string[];
+}
+
+export interface IAddGroupUsersResult {
+  /**
+   * An array of usernames that were not added
+   */
+  notAdded?: string[];
+  /**
+   * An array of request errors
+   */
+  errors?: ArcGISRequestError[];
+}
+
+/**
+ * ```js
+ * import { addGroupUsers } from "@esri/arcgis-rest-portal";
+ * //
+ * addGroupUsers({
+ *   id: groupId,
+ *   users: ["username1", "username2"],
+ *   admins: ["username3"],
+ *   authentication
+ * })
+ * .then(response);
+ * ```
+ * Add users to a group. See the [REST Documentation](https://developers.arcgis.com/rest/users-groups-and-items/add-users-to-group.htm) for more information.
+ *
+ * @param requestOptions  - Options for the request
+ * @returns A Promise
+ */
+export function addGroupUsers(
+  requestOptions: IAddGroupUsersOptions
+): Promise<IAddGroupUsersResult> {
+  const id = requestOptions.id;
+  const url = `${getPortalUrl(requestOptions)}/community/groups/${id}/addUsers`;
+  const baseOptions = Object.assign({}, requestOptions, {
+    admins: undefined,
+    users: undefined
+  });
+
+  const batchRequestOptions = [
+    ..._prepareRequests("users", requestOptions.users, baseOptions),
+    ..._prepareRequests("admins", requestOptions.admins, baseOptions)
+  ];
+
+  const promises = batchRequestOptions.map((options) =>
+    _sendSafeRequest(url, options)
+  );
+
+  return Promise.all(promises).then(_consolidateRequestResults);
+}
+
+function _prepareRequests(
+  type: "admins" | "users",
+  usernames: string[],
+  baseOptions: IAddGroupUsersOptions
+): IAddGroupUsersOptions[] {
+  if (!usernames || usernames.length < 1) {
+    return [];
+  }
+
+  // the ArcGIS REST API only allows to add no more than 25 users per request,
+  // see https://developers.arcgis.com/rest/users-groups-and-items/add-users-to-group.htm
+  const userChunks: string[][] = chunk<string>(usernames, 25);
+
+  return userChunks.map((users) =>
+    _generateRequestOptions(type, users, baseOptions)
+  );
+}
+
+function _generateRequestOptions(
+  type: "admins" | "users",
+  usernames: string[],
+  baseOptions: IAddGroupUsersOptions
+) {
+  return Object.assign({}, baseOptions, {
+    [type]: usernames,
+    params: {
+      ...baseOptions.params,
+      [type]: usernames
+    }
+  });
+}
+
+// this request is safe since the request error will be handled
+function _sendSafeRequest(
+  url: string,
+  requestOptions: IAddGroupUsersOptions
+): Promise<IAddGroupUsersResult> {
+  return request(url, requestOptions).catch((error) => {
+    return {
+      errors: [error]
+    };
+  });
+}
+
+function _consolidateRequestResults(
+  results: IAddGroupUsersResult[]
+): IAddGroupUsersResult {
+  const notAdded = results
+    .filter((result) => result.notAdded)
+    .reduce((collection, result) => collection.concat(result.notAdded), []);
+
+  const errors = results
+    .filter((result) => result.errors)
+    .reduce((collection, result) => collection.concat(result.errors), []);
+
+  const consolidated: IAddGroupUsersResult = { notAdded };
+
+  if (errors.length > 0) {
+    consolidated.errors = errors;
+  }
+
+  return consolidated;
+}

package/packages/arcgis-rest-portal/src/groups/create.ts

@@ -0,0 +1,42 @@
+/* Copyright (c) 2017-2018 Environmental Systems Research Institute, Inc.
+ * Apache-2.0 */
+
+import { request, IRequestOptions, IGroupAdd, IGroup } from "@esri/arcgis-rest-request";
+
+import { getPortalUrl } from "../util/get-portal-url.js";
+
+export interface ICreateGroupOptions extends IRequestOptions {
+  group: IGroupAdd;
+}
+
+/**
+ * ```js
+ * import { createGroup } from "@esri/arcgis-rest-portal";
+ * //
+ * createGroup({
+ *   group: {
+ *     title: "No Homers",
+ *     access: "public"
+ *   },
+ *   authentication
+ * })
+ *   .then(response)
+ * ```
+ * Create a new Group. See the [REST Documentation](https://developers.arcgis.com/rest/users-groups-and-items/create-group.htm) for more information.
+ *
+ * Note: The group name must be unique within the user's organization.
+ * @param requestOptions  - Options for the request, including a group object
+ * @returns A Promise that will resolve with the success/failure status of the request
+ */
+export function createGroup(
+  requestOptions: ICreateGroupOptions
+): Promise<{ success: boolean; group: IGroup }> {
+  const url = `${getPortalUrl(requestOptions)}/community/createGroup`;
+
+  requestOptions.params = {
+    ...requestOptions.params,
+    ...requestOptions.group
+  };
+
+  return request(url, requestOptions);
+}